LogexManual de integración · Shopify

Conectar Shopify con Logex

En 20 minutos tus pedidos de Shopify entran solos a Logex para confirmarlos y despacharlos contra entrega, y Shopify se entera cuando el pedido salió, se entregó o se canceló.

Qué vas a lograr
  • Parte A (obligatoria, 10 min): cada pedido nuevo de Shopify aparece en Logex como "Nuevo", con nombre, teléfono, dirección y producto ya vinculado. Si lo cancelas en Shopify, se cancela en Logex.
  • Parte B (opcional, 10 min): cuando Logex despacha, entrega, rechaza o cancela, Shopify marca el pedido igual (enviado con enlace de seguimiento, entregado, intento fallido, cancelado).
0RequisitosParte APedidos de Shopify → LogexClaveVincular productos por SKUParte BEstado de Logex → ShopifyVerificarPedido de pruebaAyudaProblemas frecuentes

Antes de empezarRequisitos

Parte A · obligatoriaPedidos de Shopify → Logex

Shopify avisa a Logex cada vez que entra un pedido mediante un webhook (un aviso automático a una dirección web). Solo hay que decirle a Shopify a qué dirección avisar y darle a Logex la clave para comprobar que el aviso es legítimo.

1

Abre tu tienda en Logex y escribe tu dominio de Shopify

En Logex ve a Tiendas, toca la tienda (o "Nueva tienda") y baja hasta Integración Shopify. Escribe tu dominio .myshopify.com. Lo encuentras en Shopify en Configuración → Dominios; tiene la forma tu-tienda.myshopify.com. Si tu tienda usa dominio propio (por ejemplo mitienda.com), ese también sirve.

logexpress.app/stores
Editar tienda · Integración Shopify (opcional)
mi-tienda.myshopify.com
•••••••••••••••••••••••••••••
https://www.logexpress.app/api/shopify/webhookCopiar
Estado de la conexión: todavía no ha llegado ningún pedido desde Shopify.
Captura 1 · Logex → Tiendas → Editar tienda → Integración Shopify. Aquí también verás la URL del webhook lista para copiar.
2

Copia la URL del webhook de Logex

Es la misma para todas las tiendas. Cópiala tal cual:

https://www.logexpress.app/api/shopify/webhook
3

En Shopify, crea el webhook de creación de pedido

En el panel de Shopify ve a Configuración → Notificaciones → Webhooks (en algunas cuentas el menú dice "Notificaciones" y abajo "Webhooks"). Toca Crear webhook y rellena:

  • Evento: Creación de pedido (Order creation)
  • Formato: JSON
  • URL: la de Logex del paso 2
  • Versión de la API: deja la que Shopify marque como "Latest" o "Más reciente"
admin.shopify.com/store/mi-tienda/settings/notifications
Configuración › Notificaciones › Webhooks
Crear webhook
Creación de pedido
JSON
https://www.logexpress.app/api/shopify/webhook
2026-01 (Más reciente)
CancelarGuardar
Captura 2 · Shopify → Configuración → Notificaciones → Webhooks → Crear webhook. Los nombres exactos pueden variar un poco según el idioma del panel.
4

Crea el segundo webhook: cancelación de pedido

Repite el paso 3 pero con el evento Cancelación de pedido (Order cancellation), formato JSON y la misma URL. Así, si cancelas un pedido en Shopify antes de que salga a ruta, Logex lo cancela también.

admin.shopify.com/store/mi-tienda/settings/notifications
Configuración › Notificaciones › Webhooks
Creación de pedido
https://www.logexpress.app/api/shopify/webhook · JSON
Editar
Cancelación de pedido
https://www.logexpress.app/api/shopify/webhook · JSON
Editar
Todos tus webhooks se firmarán con a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2 para que puedas verificar su integridad.
Captura 3 · Así queda la lista de webhooks al terminar. Abajo, el texto con el secreto de firma que copiarás en el paso 5.
5

Pega el secreto de firma en Logex y guarda

Al final de la página de Webhooks de Shopify hay una frase parecida a "Todos tus webhooks se firmarán con …" seguida de un código largo. Copia solo el código y pégalo en Logex en el campo Secreto de firma del webhook. Toca Guardar cambios.

¿Para qué sirve?Con el secreto, Logex comprueba que cada pedido viene de tu Shopify y no de otro sitio. Sin secreto los pedidos entran igual, pero sin esa comprobación. Recomendado ponerlo.
6

Listo: haz un pedido de prueba

Ve a Verificar con un pedido de prueba. Antes, revisa la sección de SKU que sigue: es lo que hace que el pedido entre ya vinculado al producto y se pueda despachar.

ClaveVincular productos por SKU

Logex despacha un producto por pedido y necesita saber cuál es para descontar inventario y armar la etiqueta. Lo reconoce por el SKU: un código corto que tú eliges y que debe ser idéntico en Shopify y en el Catálogo de Logex. Si no coincide, Logex también prueba con el nombre exacto del producto.

admin.shopify.com/store/mi-tienda/products/…
Productos › Colágeno Hidrolizado 500 g
Inventario
COLA-500
Captura 4 · En Shopify, el SKU está en la ficha del producto, sección Inventario (o en cada variante si el producto tiene tallas o colores).
logexpress.app/catalog
Catálogo · Editar producto
Colágeno Hidrolizado 500 g
COLA-500
25.00
Captura 5 · En Logex, el mismo SKU en Catálogo → producto. Mayúsculas y espacios no importan; el resto sí.
Si el SKU no coincideEl pedido entra igual a Logex con la nota "sin producto vinculado". Ábrelo en Pedidos, toca editar y elige el producto. Hasta que no esté vinculado, no se puede despachar.
Pedidos con varios artículosUn pedido de Shopify con 2 artículos entra como 2 pedidos de Logex, con el mismo cliente y la misma referencia (por ejemplo #1065). El flete que cobró Shopify se suma al primero. Si el cliente pidió 3 unidades del mismo artículo, entra un solo pedido con cantidad 3.

Parte B · opcionalEstado de Logex → Shopify

Para que Logex pueda escribir en tu Shopify (marcar enviado, entregado o cancelado) necesita una app privada de tu tienda con permisos de pedidos y envíos. La creas tú, en 5 minutos, y solo le das a Logex dos códigos: el Client ID y el Client secret. Ningún tercero tiene acceso a tu tienda.

1

Entra al panel de desarrolladores de Shopify y crea una app

Abre dev.shopify.com/dashboard con la misma cuenta de tu tienda (o desde Shopify: Configuración → Apps y canales de ventas → Desarrollar aplicaciones, que te lleva al mismo sitio). Toca Crear app y ponle de nombre Logex.

2

Dale los permisos (scopes) que necesita

Dentro de la app busca la sección de permisos de la Admin API (puede llamarse "Access scopes", "Configuración" o estar dentro de una "versión" de la app). Marca exactamente estos:

  • read_orders y write_orders — leer pedidos y cancelarlos
  • read_fulfillments y write_fulfillments — marcar enviado y entregado
  • read_merchant_managed_fulfillment_orders y write_merchant_managed_fulfillment_orders — preparar los envíos de tu ubicación

Guarda (o "publica la versión", según lo que muestre tu panel).

dev.shopify.com/dashboard/…/apps/logex
Apps › Logex › Permisos de la Admin API
read_orders
✓ activo
write_orders
✓ activo
read_fulfillments
✓ activo
write_fulfillments
✓ activo
read_merchant_managed_fulfillment_orders
✓ activo
write_merchant_managed_fulfillment_orders
✓ activo
Guardar
Captura 6 · Permisos de la Admin API marcados para la app Logex.
3

Instala la app en tu tienda

En la misma pantalla de la app toca Instalar (o "Install app") y elige tu tienda. Shopify te pedirá confirmar los permisos. Acepta.

4

Copia el Client ID y el Client secret

En la app, entra a Configuración o Credenciales ("Client credentials"). Verás el Client ID y, con un botón para mostrar, el Client secret. Cópialos.

dev.shopify.com/dashboard/…/apps/logex/settings
Apps › Logex › Configuración
Client credentials
3f1c9a2b7e8d4c5f6a1b2c3d4e5f6a7b
shpss_••••••••••••••••••••••••••••
Guarda el secret como una contraseña. Si se filtra, genera uno nuevo aquí y actualízalo en Logex.
Captura 7 · Credenciales de la app. El secret solo se muestra al tocar el ojo o «Mostrar».
¿Tienes una app "personalizada" antigua con token que empieza por shpat_?También sirve. En Logex pégalo en el campo Token fijo en vez del Client ID y secret. Esas apps se crean en Shopify → Configuración → Apps y canales de ventas → Desarrollar aplicaciones → Crear aplicación → Configurar permisos de la Admin API (los mismos de arriba) → Instalar → "Token de acceso de la Admin API" (se muestra una sola vez).
5

Pégalos en Logex y guarda

En Logex, en la misma tienda, dentro de Integración Shopify → Estado de vuelta a Shopify, pega el Client ID y el Client secret. Guarda cambios. Desde el próximo cambio de estado de un pedido de Shopify, Logex se conecta y empieza a actualizar.

logexpress.app/stores
Editar tienda · Estado de vuelta a Shopify (opcional)
3f1c9a2b7e8d4c5f6a1b2c3d4e5f6a7b
••••••••••••••••••••••••••••
● Conectado con Shopify: los estados se están enviando.
Captura 8 · Logex → Tiendas → Editar tienda → Estado de vuelta a Shopify.

Qué verá tu Shopify a partir de ahora

Cuando en Logex el pedido pasa aEn Shopify aparece
En ruta (o asignado a repartidor)El artículo queda Enviado, con transportista "Logex" y tu enlace de seguimiento logexpress.app/t/ORD-0042. Evento "En reparto".
EntregadoEvento Entregado en el envío.
NovedadEvento Intento de entrega.
Rechazado / DevueltoEvento Entrega fallida.
Envío MRW / Despachado MRWEnviado con transportista MRW y el número de guía. Evento "En tránsito".
CanceladoPedido cancelado en Shopify, sin reembolso y devolviendo el inventario. Solo si todos los artículos de ese pedido están cancelados en Logex.
admin.shopify.com/store/mi-tienda/orders/…
Pedidos › #1065 · Enviado
  • Entregado — Entregado y cobrado contra entrega (Logex) · hoy 3:42 p. m.
  • En reparto — En ruta con repartidor (Logex) · hoy 9:10 a. m.
  • Envío creado — Logex · ORD-0042 · Seguimiento: logexpress.app/t/ORD-0042
  • Pedido realizado por el cliente · ayer 8:03 p. m.
Captura 9 · Cronología del pedido en Shopify después de que Logex lo despachó y entregó. Shopify no manda correos al cliente por estos cambios.

Los cambios llegan a Shopify en segundos. Si Shopify no responde en ese momento, Logex lo reintenta solo cada 10 minutos.

VerificarPedido de prueba

  1. En tu tienda Shopify, haz un pedido real de prueba con tu propio teléfono en formato venezolano (0412 1234567 o +58 412 1234567) y el SKU de un producto que exista en Logex. Elige contra entrega o el método manual que uses.
  2. En Logex → Pedidos, en menos de un minuto aparece como "Nuevo" con la nota "Shopify #10xx". Ábrelo y confirma que el producto salió vinculado.
  3. En Logex → Tiendas → tu tienda, la sección Estado de la conexión ya muestra "1 pedido recibido".
  4. Si activaste la Parte B: pasa el pedido a En ruta y luego a Entregado. En Shopify el pedido debe quedar "Enviado" y luego con el evento "Entregado".
  5. Cancela el pedido de prueba (en Logex o en Shopify) para que no se despache.

AyudaProblemas frecuentes

El pedido no aparece en Logex

"Firma inválida" en Estado de la conexión

El secreto pegado no es el de esa tienda. Vuelve a Shopify → Notificaciones → Webhooks, copia de nuevo solo el código de la frase "Todos tus webhooks se firmarán con…" y pégalo. Si dudas, borra el campo y guarda: los pedidos entran sin comprobar la firma.

El pedido entra "sin producto vinculado"

El SKU de Shopify no existe en tu Catálogo de Logex. Corrige el SKU en cualquiera de los dos lados y, para ese pedido, vincúlalo a mano desde Pedidos → editar.

Shopify no se actualiza cuando despacho (Parte B)

Seguridad

El secreto del webhook y las credenciales de la app se guardan cifradas en tránsito y solo las ven los usuarios administradores de tu cuenta de Logex. Logex nunca usa las credenciales para leer clientes ni productos: solo para leer el pedido que va a actualizar, crear su envío y registrar eventos.

¿Te trabaste en algún paso?

Escríbenos por WhatsApp con una captura de la pantalla y te lo dejamos conectado.

Ayuda por WhatsApp