Saltar al contenido principal

Shopify + Fletea

Conecta tu tienda Shopify y olvida el trabajo manual. Cada pedido pagado se convierte automaticamente en un envio con guia, y el tracking se sincroniza de vuelta para que tu cliente reciba su numero de rastreo sin que toques nada.

app.fletea.mx
Integraciones de Fletea
Conecta Shopify desde la seccion de Integraciones
🛒

Importacion automatica

Pedidos pagados se convierten en envios al instante

📍

Tracking sincronizado

El numero de guia y link de rastreo llegan a Shopify automaticamente

📧

Notificacion al cliente

Shopify notifica a tu cliente con el tracking sin que hagas nada

3 clics y listo

1

Conecta tu tienda

Ve a Dashboard > Integraciones > Shopify, haz clic en "Conectar Shopify" e ingresa el dominio de tu tienda (ej: mi-tienda.myshopify.com).

2

Autoriza la app

Seras redirigido a Shopify para aceptar los permisos. Fletea solicita lo minimo necesario: lectura de pedidos, escritura de fulfillments y gestion de webhooks.

3

Configura tu direccion de origen

En Dashboard > Configuracion > Direcciones, agrega o selecciona tu direccion de almacen/bodega como direccion de recoleccion predeterminada.

Verificacion rapida

En Dashboard > Integraciones > Shopify, verifica que el estado muestre "Conectado" y que los webhooks esten registrados en la seccion "Webhooks activos".

Como funciona el flujo

💳Cliente paga en Shopify
📦Fletea crea el envio + guia
🔄Tracking se sincroniza a Shopify
📧Cliente recibe email con rastreo

Cuando un cliente paga un pedido en tu tienda:

  1. Shopify envia un webhook orders/paid a Fletea
  2. Fletea extrae las direcciones de envio del pedido
  3. Se crea una orden y se genera la guia automaticamente
  4. El numero de guia se sincroniza de vuelta a Shopify como fulfillment

Datos que se importan

Campo de ShopifyCampo en Fletea
Nombre del clientereceiver_name
Telefonoreceiver_phone
Direccion de enviodelivery_address
Numero de pedidointernal_reference
Email del clientereceiver_email

Datos que se sincronizan a Shopify

Cuando Fletea genera la guia, automaticamente crea un fulfillment en Shopify con:

{
"tracking_number": "HEX-123456789",
"tracking_company": "Fletea",
"tracking_url": "https://app.fletea.mx/track/mi-tienda/orden-uuid",
"notify_customer": true
}

Esto hace que Shopify envie un correo a tu cliente con el numero de rastreo.

🚀
Whitelabel

Si tienes whitelabel habilitado, la pagina de rastreo mostrara tu marca en lugar de Fletea.

Seguridad

Fletea verifica la autenticidad de cada webhook de Shopify usando la firma HMAC-SHA256 que Shopify incluye en el header X-Shopify-Hmac-SHA256. Esto garantiza que los webhooks provienen realmente de Shopify.

Solucionar problemas

Los pedidos no se importan

  • Verifica que la integracion muestre estado "Conectado"
  • Confirma que tienes una direccion de recoleccion configurada
  • Revisa que el webhook orders/paid este activo en Shopify (Settings > Notifications > Webhooks)

El tracking no aparece en Shopify

  • El fulfillment se crea despues de que Fletea genera la guia con el proveedor
  • Si la orden se creo manualmente en Fletea (no desde Shopify), no se sincroniza automaticamente

Error de autorizacion

  • Desconecta y vuelve a conectar la tienda desde Dashboard > Integraciones > Shopify
  • Asegurate de aceptar todos los permisos durante el proceso de OAuth
⚠️
Cambio de dominio

Si cambias el dominio de tu tienda Shopify, necesitaras reconectar la integracion. El access token esta asociado al dominio original.

Limitaciones actuales

  • Solo se procesan pedidos con evento orders/paid (pedidos pagados)
  • No se importan pedidos existentes al conectar, solo pedidos nuevos a partir de la conexion
  • Los pedidos con multiples envios se crean como una sola orden en Fletea