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.
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
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).
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.
Configura tu direccion de origen
En Dashboard > Configuracion > Direcciones, agrega o selecciona tu direccion de almacen/bodega como direccion de recoleccion predeterminada.
En Dashboard > Integraciones > Shopify, verifica que el estado muestre "Conectado" y que los webhooks esten registrados en la seccion "Webhooks activos".
Piloto automatico vs. aprobacion manual
Puedes elegir como quieres que Fletea maneje los pedidos de Shopify.
Piloto automatico
Cada pedido pagado se convierte en envio al instante, sin que tengas que hacer nada. Ideal si ya tienes todo estandarizado.
Aprobacion manual
Los pedidos llegan a una cola de pendientes. Tu decides cuales enviar, cuales rechazar y cuando. Ideal si necesitas revisar peso o medidas caso a caso.
Activar el piloto automatico
Ve a Dashboard > Configuracion > Integraciones > Shopify y activa el interruptor de "Piloto automatico". Cuando lo enciendas, configuras tres cosas:
- Direccion de recoleccion predeterminada — de donde se recogeran todos los paquetes
- Peso predeterminado — el peso en kg que se usara si Shopify no manda el peso del producto
- Tipo de envio predeterminado — si es paquete, sobre, etc.
Activa el piloto automatico solo si todos tus productos tienen un peso y tamano similar. Si vendes cosas muy distintas entre si, la aprobacion manual te da mas control.
Cola de pedidos pendientes
Cuando el piloto automatico esta apagado, cada pedido pagado en Shopify llega a tu cola de pendientes en Dashboard > Integraciones > Shopify > Pendientes.
Desde ahi puedes:
- Aprobar un pedido — Fletea crea el envio, genera la guia y sincroniza el tracking a Shopify
- Rechazar un pedido — puedes escribir un motivo opcional (solo para tu referencia interna)
- Aprobar varios a la vez — selecciona los pedidos que quieras y usa "Aprobar seleccionados" para procesarlos en bloque
Puedes seleccionar y aprobar hasta 5 pedidos al mismo tiempo. Fletea los procesa en paralelo y te muestra cuales se completaron y cuales tuvieron algun problema.
Como funciona el flujo
Cuando un cliente paga un pedido en tu tienda:
- Shopify envia un webhook
orders/paida Fletea - Fletea extrae las direcciones de envio del pedido
- Se crea una orden y se genera la guia automaticamente (o pasa a la cola si tienes aprobacion manual)
- El numero de guia se sincroniza de vuelta a Shopify como fulfillment
Datos que se importan
| Campo de Shopify | Campo en Fletea |
|---|---|
| Nombre del cliente | receiver_name |
| Telefono | receiver_phone |
| Direccion de envio | delivery_address |
| Numero de pedido | internal_reference |
| Email del cliente | receiver_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.
Si tienes whitelabel habilitado, la pagina de rastreo mostrara tu marca en lugar de Fletea.
Sincronizacion de entrega
Cuando el paquete es entregado, Fletea actualiza automaticamente el pedido en Shopify como "Cumplido" (Fulfilled). Tu cliente puede ver el numero de rastreo y el link de seguimiento directamente en la pagina de su pedido, sin que tengas que hacer nada manualmente.
No necesitas entrar a Shopify a marcar pedidos como entregados. Fletea lo hace solo cuando el transportista confirma la entrega.
Cancelaciones automaticas
Si un cliente cancela su pedido en Shopify antes de que salga el paquete, Fletea recibe la notificacion y cancela el envio asociado automaticamente. Asi no tienes guias activas de pedidos que ya no existen.
Si el paquete ya fue recolectado y esta en camino, la cancelacion no es posible desde Shopify. En ese caso tendras que contactar a soporte para gestionarlo manualmente.
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/paideste activo en Shopify (Settings > Notifications > Webhooks) - Si tienes aprobacion manual activa, los pedidos no se crean solos — ve a la cola de pendientes y aprueba los que quieras procesar
Los pedidos estan en "Pendientes" y no se envian
Esto es normal si tienes el piloto automatico apagado. Ve a Dashboard > Integraciones > Shopify > Pendientes, selecciona los pedidos y haz clic en "Aprobar". Si quieres que todo sea automatico, activa el piloto automatico en Configuracion > Integraciones > Shopify.
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
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
- La aprobacion en bloque procesa hasta 5 pedidos a la vez