Resumen del proceso de pedido
No importa cómo se envíen los pedidos, todos siguen el mismo proceso principal dentro de GelatoConnect:
1. Envío del pedido
Los pedidos pueden llegar al sistema por diferentes vías:
Envío por API: Los pedidos se envían mediante solicitudes POST. El sistema comprueba que el formato de la solicitud sea correcto y devuelve un ID de pedido.
Envío desde tu tienda online: Los pedidos realizados a través de plataformas de comercio electrónico conectadas se importan automáticamente.
Envío por FTP: Los archivos de los pedidos se suben y se revisan cada cierto tiempo, luego se convierten en pedidos.
Envío directo desde la plataforma: Las integraciones (por ejemplo, Cloudprinter, Redbubble) envían los pedidos ya formateados directamente a GelatoConnect.
2. Validación y procesamiento inicial
Una vez recibidos, los pedidos pasan por:
Validación de datos: Revisa que todo esté completo, bien formateado, con referencias de clientes y los identificadores únicos de producto.
Validación de archivos de impresión: Se verifican las URL de los archivos y se comprueba que sean compatibles, que tengan la resolución y dimensiones adecuadas, y que las fuentes estén incrustadas.
Validación de reglas de negocio: Incluye comprobaciones sobre restricciones de envío, disponibilidad, cantidades y requisitos para envíos internacionales.
Cambios en el estado del pedido
Los pedidos en GelatoConnect pasan por varios estados a lo largo de su ciclo de vida:
Estados iniciales
Borrador: El pedido se ha guardado, pero aún no se ha enviado.
Recibido: El pedido se ha enviado a GelatoConnect.
Completado: El pedido ha superado todas las comprobaciones.
Error: El pedido no pasó la validación.
Creado: El pedido ha pasado la validación y está listo para producción.
Estados de producción
En producción: Tu pedido está en marcha.
Impreso: Tu pedido ya está listo.
Empaquetado: El pedido está listo para salir hacia su destino.
Estados de envío
Enviado: El pedido ya ha salido de nuestras instalaciones.
En camino: Tu pedido va de viaje.
Entregado: El pedido ha llegado a manos del cliente.
Devuelto: El pedido fue devuelto.
Estados de error
Error: No se pudo validar o procesar la información.
Cancelado: El pedido fue cancelado.
Eventos y notificaciones
Eventos del sistema: Todos los cambios de estado se registran internamente.
Notificaciones externas: Los clientes reciben avisos a través de postbacks, correos electrónicos y eventos de Webhook.
Actualizaciones de estado de la API: Puedes consultar el estado usando las APIs Get Order y Search Orders.
Motivos habituales de fallo en pedidos y cómo solucionarlos
GelatoConnect te da motivos concretos cuando algo falla para que puedas solucionarlo fácilmente.
"Sin conexión"
Qué significa: El producto en Storefronts no está vinculado a una especificación de GelatoConnect.
Solución:
Ve a Storefronts, busca el producto y haz clic en Conectar producto.
Sube los archivos de diseño si los necesitas.
Completa la conexión y vuelve a enviar el pedido.
"Envío no disponible"
Qué significa: El transportista no puede entregar en la dirección indicada.
Solución:
Valida la dirección y el país admitido.
Piensa en otras formas de envío.
En los pedidos de la API, utiliza métodos de envío separados por comas en
shipmentMethodUid
.
Descargas de archivos fallidas
Qué significa: No se puede acceder a las URLs de los archivos de impresión.
Solución:
Asegúrate de que las URLs sean públicas y válidas.
Asegúrate de que las URLs estén bien formateadas para servicios como Dropbox, Google Drive u OneDrive.
Problemas de formato de archivo y calidad
Qué significa: Los archivos no cumplen con las especificaciones de producción.
Solución:
Utiliza la resolución adecuada (normalmente 300 DPI).
Incluye sangrado (normalmente 3 mm).
Utiliza el color CMYK e incrusta todas las fuentes.
Identificación de producto no válida
¿Qué significa?: El UID del producto o el producto personalizado del cliente no es válido o no se reconoce.
Solución:
Verifica que el
productUid
, elproductName
y elproductVariant
sean exactamente correctos.Utiliza búsquedas para encontrar los códigos de producto que coincidan.
Precios de venta al público no disponibles (pedidos internacionales)
Qué significa: Faltan los datos de precios de aduanas.
Solución:
Incluye
retailCurrency
,retailShippingPriceInclVat
yitems[i].retailPriceInclVat
en la solicitud de la API.
Fallos de autenticación de la API
Qué significa: Las credenciales de la API no son válidas.
Solución:
Verifica tu clave y tu secreto.
Asegúrate de que los encabezados tengan el formato correcto.
Usa HTTPS.
Cómo solucionar problemas cuando un pedido falla
Consulta el estado y el motivo del fallo
Ve a Workflow > Order Intake > Manage Orders, abre el pedido que ha fallado y consulta el motivo del fallo.Revisa las solicitudes de la API (si corresponde)
En Workflow > Order Intake > Requests, revisa los detalles de solicitud y respuesta del pedido.Aplica la solución adecuada
Sigue las indicaciones de arriba para solucionar el problema.Vuelve a enviar el pedido
Una vez corregido, vuelve a enviarlo o crea un nuevo pedido.Supervisa con Postbacks
Configura postbacks para recibir actualizaciones de estado en tiempo real y reducir el tiempo de resolución de incidencias.
Supervisa y gestiona tus pedidos
GelatoConnect te ofrece varias herramientas para que gestiones tus pedidos de forma eficaz:
Página de solicitudes: Consulta los pedidos que llegan y filtra por estado.
Gestión de pedidos: Busca tus pedidos y realiza acciones como cancelar o volver a procesar.
Análisis de pedidos: Controla el volumen de pedidos, las tasas de error y las tendencias.
¿Deseas saber más?
Para que lo tengas aún más claro y todo funcione sobre ruedas:
Consulta la documentación del flujo de pedidos para descubrir en detalle cada paso.
Descubre los puntos finales de la API de pedidos para integraciones basadas en API.
Utiliza los Template Mappers si necesitas transformar tus datos.