Introducción
Esta guía explica la terminología y los conceptos esenciales que encontrarás al trabajar con los sistemas de recepción de pedidos de GelatoConnect. Entender estos términos te ayudará a moverte por la plataforma con más soltura y a comunicarte con mayor claridad sobre los procesos de gestión de pedidos.
Conceptos clave de los pedidos
Pedido
Una solicitud para que uno o más productos se fabriquen y se envíen a una dirección específica. Un pedido es la base sobre la que se organiza el trabajo en GelatoConnect.
ID de referencia del pedido
Tu identificador único para un pedido. Debe coincidir con el ID de pedido en tu sistema y te permite seguir la relación entre los pedidos de GelatoConnect y tus sistemas internos.
ID de referencia del cliente
Tu identificador único para el cliente que realiza el pedido. Esto te ayuda a vincular los pedidos con clientes concretos en tu sistema.
Tipo de pedido
Define cómo se debe procesar un pedido. Los dos tipos principales son:
Pedido: Un pedido estándar que se procesará de inmediato
Borrador: Un pedido guardado para que puedas editarlo y enviarlo más adelante
Estado del pedido
Indica la etapa actual de un pedido en el proceso de Procesamiento. Los estados clave incluyen:
Borrador: Pedido creado pero aún no enviado para su procesamiento
Recibido: Pedido enviado y en proceso de validación inicial
Aprobado: El pedido ha superado las comprobaciones de validación
Error: El pedido no ha pasado las comprobaciones de validación
Creado: Pedido validado y listo para producción
En producción: El pedido está en marcha
Impreso: La producción está lista
Empaquetado: El pedido está listo para salir volando hacia su destino
Enviado: El pedido ya está en manos de la empresa de transporte
Entregado: El pedido ha llegado a su destinatario
Cancelado: El pedido se ha cancelado por solicitud o por el sistema
Artículo del pedido
Un producto individual dentro de un pedido. Cada artículo tiene sus propias especificaciones, cantidades y archivos. Puedes incluir varios artículos en un solo pedido.
ID de referencia del artículo
Tu identificador único para un artículo específico dentro de un pedido. Esto te ayuda a seguir cada producto dentro de un pedido más grande.
Métodos para identificar productos
UID del producto
Un identificador único para una configuración específica de producto en el sistema GelatoConnect. Los UID de producto siguen un formato estructurado que incluye los atributos del producto.
Ejemplo:flat_product_pf_a4_pt_200-gsm-no estucado_cl_4-0_ct_none_prt_none_sft_none_set_none_hor
Este identificador guarda información codificada sobre lo siguiente:
Tipo de producto (
flat_product)Formato de papel (
pf_a4)Tipo de papel (
pt_200-gsm-no estucado)Configuración de color (
cl_4-0significa 4 colores en la parte delantera y sin color en la parte trasera)Otras especificaciones (corte, impresión, etc.)
Orientación (
horpara horizontal)
Producto del cliente
Una forma sencilla de identificar productos usando el nombre del producto y su variante. Este método es más fácil de entender y gestionar, especialmente cuando tienes un catálogo de productos complejo.
Ejemplo:
{"productName": "Tarjeta de visita","productVariant": {"Tamaño": "Estándar","Papel": "Mate premium","Color": "A todo color por ambos lados"}}Gestión de archivos
Imprimir archivo
El archivo original que contiene la creación artística que se va a imprimir. Normalmente es un archivo PDF, PNG o JPEG, según los requisitos del producto.
URL del archivo
El lugar donde se puede acceder al archivo de impresión. Debe ser una URL pública desde la que GelatoConnect pueda descargarlo.
Tipo de archivo
Define el papel del archivo en el producto. Los tipos más habituales son:
predeterminado: El archivo principal de impresión para el producto
frontal: El archivo para la parte frontal de un producto
parte trasera: El archivo para la parte trasera de un producto
cubierta: El archivo para la portada de un libro
interior: El archivo para las páginas interiores de un libro
Archivo procesado
La versión lista para producción del archivo de impresión después de que GelatoConnect haya realizado las transformaciones necesarias.
Vista previa
Una imagen que muestra cómo quedará el producto final según los archivos de impresión que has proporcionado.
Información de envío
Dirección de envío
La dirección de destino donde se debe entregar el pedido, incluyendo los datos de la persona que lo recibirá.
UID del método de envío
Un identificador para el método de envío que se usará en el pedido. Puede ser específico (fed_ex_2_day) o general (express).
Dirección de devolución
La dirección que se usará como remitente en el paquete y para cualquier devolución.
Código de seguimiento
Un identificador único que proporciona la empresa de mensajería para seguir el progreso de entrega del paquete.
URL de seguimiento
Una dirección web donde el cliente puede consultar el estado actual de su envío.
Conceptos de integración
API
Interfaz de programación de aplicaciones: la forma de interactuar con GelatoConnect de manera programática. Utiliza métodos HTTP estándar (GET, POST, PUT, etc.) para gestionar pedidos.
Clave y secreto de la API
Credenciales de seguridad que se utilizan para autenticar las solicitudes a la API de GelatoConnect. Se componen de una clave y un secreto que debes incluir en la cabecera X-API-KEY con el formato "clave:secreto".
Webhook
Un callback HTTP que te avisa al instante sobre los eventos de GelatoConnect en tu sistema.
Postback
Una notificación que GelatoConnect envía a tu sistema (o a tus clientes) cuando cambia el estado de un pedido.
Mapeador de plantillas
Una herramienta para transformar datos entre tu formato y el formato de GelatoConnect, utilizando el lenguaje de plantillas Jinja2.
Buscar
Una tabla de correspondencias que transforma los valores de tu sistema (como los SKU de productos) en valores de GelatoConnect (como los identificadores únicos de productos).
Escaparate
Una plataforma de comercio electrónico (como Shopify, Etsy o WooCommerce) que puedes conectar con GelatoConnect para importar pedidos automáticamente.
FTP
Protocolo de transferencia de archivos: una forma de subir archivos de pedidos a GelatoConnect para procesarlos en lote.
Términos financieros y de facturación
Moneda
La unidad monetaria en la que se cobrarán los pedidos. Debe especificarse para cada pedido usando los códigos de moneda ISO (por ejemplo, USD, EUR, GBP).
Precio de venta
El precio que paga el cliente final por un producto, normalmente utilizado para las declaraciones de aduana en envíos internacionales.
Conceptos avanzados
Solicitud de pedido
La presentación inicial de un pedido antes de que haya sido completamente procesado y validado.
Metadatos
Información adicional que se añade a un pedido en forma de pares clave-valor, y que sirve para hacer seguimiento, análisis o integraciones. Los metadatos pueden aplicarse a artículos individuales del pedido o al pedido completo.
Comprobación previa
Validación automática de archivos de impresión para asegurarte de que cumplen con los requisitos de producción.
Creador de flujos de trabajo
Una herramienta para definir los pasos de producción de cada tipo de producto.
Glosario de abreviaturas
Abreviatura | Definición |
PSP | Proveedor de servicios de impresión |
API | Interfaz de programación de aplicaciones |
FTP | Protocolo de transferencia de archivos |
UID | Identificador único |
Interfaz | Interfaz de usuario |
SLA (Acuerdo de Nivel de Servicio) | Acuerdo de nivel de servicio |
EDI | Intercambio Electrónico de Datos |
B2B | De empresa a empresa |
B2C | De empresa a consumidor |
CSV | Valores separados por comas |
JSON | Notación de objetos de JavaScript |
XML | Lenguaje de marcado extensible |
¿Deseas saber más?
Ahora que ya conoces los términos y conceptos más habituales en los sistemas de gestión de pedidos de GelatoConnect, estás listo para:
Entiende la documentación y los mensajes de error
Muévete por la plataforma con más seguridad
Para obtener información más detallada sobre aspectos concretos de la recepción de pedidos, consulta las secciones correspondientes en nuestro Centro de ayuda.