Sujeto a configuración P2

Entender el fulfillment de Gelato v2 para Shopify

Entiende cuándo un pedido pagado de Shopify se vuelve trabajo de ArtDrop, borrador Gelato o envío real.

Disponibilidad
Sujeto a configuración
Última verificación
Versión del runtime
ab084f79c5ed3fc6a28f07c64b29920944a0e5db
Versión de certificación
db23559179dc3c67be8a1ab16a0f07323b9820f7
Nota de evidencia
Se verificaron webhook/trabajos, idempotencia, reintentos, dead letter y borrador por defecto. No se colocó un pedido pagado real; el envío sigue sujeto a configuración.

Qué hace

Entiende cuándo un pedido pagado de Shopify se vuelve trabajo de ArtDrop, borrador Gelato o envío real.

Antes de comenzar

  • El producto Shopify debe llevar la atribución ArtDrop/Gelato v2 y corresponder a la cuenta y tienda exactas.
  • Deben estar disponibles el webhook de pedido pagado, los trabajos PostgreSQL, las credenciales Gelato, los datos de envío y el mapeo de tienda.

Qué cambia fuera de ArtDrop

Un webhook verificado puede encolar un trabajo con datos de pedido y envío. Por defecto crea un borrador Gelato. La producción real requiere GELATO_V2_LIVE_ORDERS para la cuenta y tienda exactas y puede crear un pedido real.

Pasos

  1. Confirma la procedencia

    Verifica que la variante vendida se creó mediante Gelato v2 y aún mapea a producto/variante válidos.

  2. Confirma la ruta de tienda

    Cada destino Shopify necesita mapeo Gelato explícito, clave actual y webhook funcionando. Nunca uses la tienda raíz como fallback.

  3. Interpreta borrador y real

    A menos que esté habilitado el envío real para tenant/tienda, espera un borrador Gelato, no un pedido de producción.

  4. Sigue reintentos seguros

    Los trabajos son idempotentes y usan reintentos limitados y una cola de fallos definitivos. Ante un resultado desconocido, revisa Gelato antes de repetir.

Resultado esperado

El pedido tiene un trabajo único para la cuenta y tienda, además de un ID Gelato conocido, o un estado de fallo duradero para soporte.

Límites y lo que no hace

  • El fulfillment de Printful y Printify no usa este puente Gelato.
  • Desinstalar/deshabilitar la app o faltar webhooks/claves puede detener pedidos; un producto comprable no prueba preparación.
  • Se procesan datos de envío para fulfillment; no son solo datos de producto.

Solución de problemas

  • Si falta un pedido pagado, verifica webhook, atribución, mapeo, clave y estado antes de crear manualmente.
  • Ante resultado Gelato desconocido, no envíes un segundo pedido hasta conciliar el primero.

Cómo deshacer o limpiar

Cancela o administra el borrador/pedido en Gelato según su estado. Quitar el producto Shopify o cuenta ArtDrop no cancela automáticamente.