Los postbacks son notificaciones automáticas que GelatoConnect envía a sistemas externos cada vez que cambia el estado de un pedido. Son clave para que los Proveedores de Servicios de Impresión (PSP) y los clientes estén al tanto de sus pedidos en tiempo real, sin necesidad de actualizaciones manuales.
Los postbacks te permiten:
Avisa automáticamente a tus clientes cuando cambie el estado de su pedido (por ejemplo, recibido, enviado o entregado).
Avisa a tu equipo sobre los pedidos que necesitan atención (pedidos fallidos).
Actualiza tus sistemas de gestión de inventario cuando los pedidos estén completados.
Sigue el progreso de tu pedido en cada paso de tu flujo de Procesamiento.
Estas notificaciones pueden enviarse mediante Webhook (URL) o por correo electrónico, según las necesidades de tu integración.
Requisitos previos para configurar postbacks
Antes de crear postbacks, asegúrate de tener lo siguiente:
Las personas que recibirán notificaciones se configuran en la sección de clientes de GelatoConnect.
Los puntos finales de URL están listos para recibir datos de Webhook (si usas el método de entrega por URL).
Una idea clara de cómo funcionan las plantillas y los desencadenantes.
Conoce el flujo de estados de pedido en GelatoConnect.
Guía paso a paso para configurar postbacks
1. Crea una plantilla de postback
Las plantillas definen la estructura y el contenido de tus notificaciones de postback. Puedes crearlas de dos maneras:
Opción A: Desde la sección de plantillas
Ve a Flujo de trabajo > Recepción de pedidos > Plantillas
Haz clic en Añadir plantilla
Selecciona el tipo de plantilla:
Disparador: Webhook - Para enviar datos JSON o XML a sistemas externos
Disparador: correo electrónico - Para enviar notificaciones por correo electrónico
Elige el formato adecuado (JSON o XML)
Opción B: Desde el perfil del cliente
Ve al perfil de tu cliente
Ve a la pestaña de Triggers y haz clic en Añadir Trigger
Podrás crear la plantilla directamente al configurar el disparador
Para obtener una guía detallada sobre cómo crear plantillas, consulta Cómo crear plantillas para la recepción de pedidos.
2. Configura un disparador
Los desencadenantes deciden cuándo se envían los postbacks y a dónde llegan:
Ponle un nombre descriptivo a tu trigger (por ejemplo, "Notificación de pedido enviado")
Selecciona el evento que pondrá en marcha el disparador:
Pedido recibido
Pedido fallido
Pedido cancelado
Pedido devuelto
Pedido listo
pedido entregado
Orden enviada
Orden en el tránsito
Elige tu método de entrega:
URL (Webhook): Envía datos a un punto de destino específico
Email: Envía notificaciones por correo electrónico
Para la entrega por URL, configura lo siguiente:
La URL de destino a la que se enviarán las notificaciones
Configura el método en POST (recomendado)
Puedes elegir entre JSON o XML como formato de datos
Activa "Reintentar en caso de fallo" para mayor fiabilidad
Para la entrega por correo electrónico, configura la dirección de correo del destinatario.
3. Añade una plantilla
Tu plantilla convierte los datos internos de GelatoConnect en un formato útil tanto para ti como para los sistemas de tus clientes.
Si ya tienes una plantilla creada, puedes seleccionarla al configurar el disparador. Si no, tendrás que crear una nueva.
Ponle un nombre claro a tu plantilla (por ejemplo, "OrderShippedNotification")
Utiliza los ejemplos de payload que te ofrecemos para el tipo de evento que hayas seleccionado
Asocia los campos de datos de entrada al formato de salida que prefieras usando el Template Mapper
Ejemplo de plantilla para el evento "Pedido enviado":
{ "event": "Pedido enviado", "orderId": "##{{ orderId }}", "orderReferenceId": "##{{ orderReferenceId }}", "timestamp": "##{{ created }}", "status": "##{{ fulfillmentStatus }}", "trackingInfo": { {% for item in items %} {% for fulfillment in item.fulfillments %} "trackingCode": "##{{ fulfillment.trackingCode }}", "trackingUrl": "##{{ fulfillment.trackingUrl }}", "carrier": "##{{ fulfillment.carrierName }}" {% endfor %} {% endfor %} }}Usa el botón "Render" para ver una vista previa de cómo se mostrará tu resultado
Pon a prueba la plantilla para asegurarte de que genera el resultado que esperas.
Para ver más ejemplos de plantillas, consulta Ejemplos de Template Mapper.
4. Prueba y activa
Antes de lanzar tu postback, haz algunas pruebas para asegurarte de que todo funciona como esperas. Después, puedes cambiar el estado de tu disparador y plantilla a activo.
Después de completar estos pasos, el sistema enviará una notificación a la URL o dirección de correo electrónico indicada con la información relevante del pedido cada vez que ocurra el evento de pedido especificado.
Técnicas avanzadas de postback
Cómo usar búsquedas en tus plantillas
Las búsquedas son útiles para convertir valores internos en formatos fáciles de entender para tus clientes:
{% set carrier = lookups({"shipmentMethodUid": fulfillment.carrierUid}, strict=False, default="") %}"carrier": "##{{ carrier }}"Esto convierte los códigos internos de GelatoConnect en valores más comprensibles para tus clientes. Más información en Cómo configurar búsquedas.
Campos de datos específicos del evento
Cada evento ofrece distintos campos de datos. Estos son los campos clave que puedes encontrar en los eventos más habituales:
Pedido enviado/entregado: códigos de seguimiento, información del transportista, fechas de entrega
Pedido fallido o cancelado: motivos del error, fechas y horas
Pedido recibido: detalles del pedido, información del artículo
Para comprender a fondo estos campos, consulta la introducción a los Template Mappers en GelatoConnect.
Solución de problemas con postbacks
Si tus postbacks no funcionan como esperabas:
Comprueba que la URL de destino sea correcta y esté disponible
Revisa si la plantilla tiene errores de sintaxis
Confirma que el disparador esté bien configurado para el evento correcto
Busca si hay datos que no encajan o campos que faltan
Prueba la plantilla con datos de ejemplo antes de activarla
En el caso concreto de las notificaciones por correo electrónico:
Comprueba que los datos de tu servidor SMTP sean correctos (si lo tienes configurado)
Comprueba que la dirección de correo electrónico del remitente esté bien escrita
Asegúrate de que tu servidor SMTP permita la conexión desde GelatoConnect
Comprueba que los datos de acceso (usuario y contraseña) sean correctos
Para obtener consejos más completos sobre cómo resolver problemas, consulta la sección "Solución de problemas" en Crear plantillas para la recepción de pedidos.
Configura tu servidor de correo electrónico para recibir notificaciones
Como proveedor de servicios de impresión, puedes configurar GelatoConnect para enviar notificaciones por correo electrónico usando tu propio servidor. Así, quienes reciban los correos verán que llegan desde tu dominio y no desde GelatoConnect, lo que ayuda a mantener la coherencia de tu marca.
Para configurar los ajustes de tu servidor de correo electrónico:
Ve a la sección Workflow en la barra lateral izquierda
Busca la sección de Configuración y selecciona Ajustes de trabajo
Busca la sección de Configuración del servidor de correo saliente
Introduce los siguientes datos:
Dirección de correo electrónico del remitente: La dirección de correo electrónico que aparecerá en el campo "De"
Nombre del remitente: El nombre que aparecerá junto a la dirección de correo electrónico
Servidor SMTP: La dirección de tu servidor de correo electrónico (por ejemplo, smtp.tuempresa.com)
Puerto SMTP: El puerto que utiliza tu servidor de correo electrónico (normalmente 587 o 465)
Nombre de usuario SMTP: El nombre de usuario que necesitas para autenticarte con tu servidor SMTP
Contraseña SMTP: La contraseña de tu servidor SMTP
Usar TLS: Activa esta opción si tu servidor SMTP necesita cifrado TLS (recomendado)
Guarda tu configuración
Una vez configurado, todos los envíos de correos electrónicos se realizarán a través de tu servidor de correo, lo que garantiza una imagen de marca coherente y mejora la entrega a tus clientes.
Próximos pasos
Después de configurar tus postbacks:
Supervisa si las entregas llegan a buen puerto en la página de Solicitudes dentro de la recepción de pedidos.
Asegúrate con tus clientes de que están recibiendo las notificaciones correctamente
Al poner en marcha un sistema de postback sólido, mejorarás la experiencia de tus clientes con actualizaciones de pedidos en tiempo real y reducirás la necesidad de comunicarte manualmente.