Integraciones y API
Los pedidos de tus comercios entran solos
Conectas la tienda del comercio y cada orden que cumple sus reglas se vuelve un envío, con la guía y el enlace de rastreo de vuelta en el pedido. Si tiene sistema propio, usa la API con su propia llave.
- Tiendas
- 5 plataformas Shopify, VTEX, WooCommerce, Tiendanube y Mercado Libre
- Respaldo
- cada 15 min recupera los pedidos cuyo evento no llegó
- API
- 1 llave por comercio y solo ve sus envíos
- Webhooks
- 8 intentos firmados, a lo largo de unas 5 horas
Capturas reales de Waygo con datos de demostración: empresa, comercio y tiendas ficticias.
Reglas por tienda
Entra solo lo que tú quieres despachar
Cada tienda conectada tiene su configuración: qué órdenes se vuelven envío, con qué datos y qué se le informa de vuelta. Se ajusta sin programar.
- Qué entra. Estados de pago aceptados, métodos de envío, una etiqueta o un canal, y las ubicaciones o bodegas de la tienda que atiende la conexión.
- Contra entrega. Las pasarelas o medios de pago que son contra entrega: el envío se crea con el valor a recaudar.
- Datos del envío. La bodega, si hay que ir a recoger, el valor declarado, el peso por defecto, un prefijo para el número de orden y las notas para el mensajero.
- Precio y servicio. Se cotiza con la lista de precios del comercio, y queda Same Day o Next Day según tu hora de corte.
Plataformas
Cada plataforma, con lo que de verdad hace
No todas las tiendas permiten lo mismo. Esto es lo que hace Waygo con cada una, tal como está hoy. Elige una.
- Cómo se conecta
- Autorizas la app desde la tienda, o el comercio la instala desde la Shopify App Store y la reclama en su portal.
- Qué hace entrar la orden
- Orden pagada, creada, actualizada o cancelada, y la sincronización de respaldo.
- Contra entrega
- Sí, por la pasarela de pago de la orden (por ejemplo, "Contra entrega").
- Lo que vuelve a la tienda
- El fulfillment con la guía y el enlace de rastreo: al crear el envío, cuando sale a ruta o nunca. Puede dejar que Shopify le avise al comprador.
- Estados que informa
- En reparto, Intento de entrega, Entregado y No entregado.
- Si la cancelan en la tienda
- Se cancela el envío. Si ya salió a reparto, el pedido queda en revisión.
- Cómo se conecta
- Con el nombre de la cuenta, la app key y el app token.
- Qué hace entrar la orden
- Lista para despachar, Facturada o Cancelada, y la sincronización de respaldo.
- Contra entrega
- Sí, por el medio de pago.
- Lo que vuelve a la tienda
- La guía con el enlace de rastreo en la factura de la orden. Si la tienda no facturó, puede facturarla.
- Estados que informa
- Cada estado de la entrega como evento de rastreo.
- Si la cancelan en la tienda
- Se cancela el envío. Si ya salió a reparto, el pedido queda en revisión.
- Cómo se conecta
- Con la dirección de la tienda, el consumer key y el consumer secret (WooCommerce 5.8 o superior). Sin plugin: los webhooks se crean solos.
- Qué hace entrar la orden
- Orden creada, actualizada o cancelada, y la sincronización de respaldo.
- Contra entrega
- Sí, por el método de pago.
- Lo que vuelve a la tienda
- Una nota en la orden con la guía y el enlace de rastreo, o la extensión Shipment Tracking.
- Estados que informa
- El avance de la entrega en la orden, que queda completada al entregar.
- Si la cancelan en la tienda
- Se cancela el envío. Si ya salió a reparto, el pedido queda en revisión.
- Cómo se conecta
- Autorizas la app desde la tienda. También funciona con Nuvemshop (Brasil).
- Qué hace entrar la orden
- Orden pagada, creada, actualizada o cancelada, y la sincronización de respaldo. Si la tienda se suspende, la conexión se pausa sola.
- Contra entrega
- Sí, por el medio de pago.
- Lo que vuelve a la tienda
- La guía con el enlace de rastreo en la orden.
- Estados que informa
- Cada estado como evento de rastreo; una devolución llega como "Devuelto a la tienda".
- Si la cancelan en la tienda
- Se cancela el envío. Si ya salió a reparto, el pedido queda en revisión.
- Cómo se conecta
- Autorizas la cuenta del vendedor en su país: Colombia, México, Argentina, Brasil, Chile, Uruguay, Perú o Venezuela.
- Qué hace entrar la orden
- Las órdenes pagadas (o los estados que elijas), con filtro por etiqueta, y la sincronización de respaldo.
- Contra entrega
- No se detecta.
- Lo que vuelve a la tienda
- El número de guía, solo en los envíos que despacha el vendedor, como Flex. Sin enlace de rastreo.
- Estados que informa
- Despachado, Entregado y No entregado.
- Si la cancelan en la tienda
- El envío no se cancela solo: lo decide la operación.
Las cinco están en beta. Un comercio puede conectar varias tiendas, cada una con sus reglas.
Pedidos
Cada pedido de la tienda, con su envío o con su razón
En la conexión ves los pedidos que llegaron y qué pasó con cada uno. Lo que no se volvió envío dice por qué, en palabras de la operación.
- Con envío. El número de guía y si la tienda ya quedó informada.
- Necesitan revisión. Por ejemplo, la ciudad no se pudo identificar o el comercio no tiene lista de precios. Se corrige y se reintenta.
- Omitidos. Los que no pasan las reglas: el pago no está aceptado, no tiene la etiqueta o la tienda ya lo despachó por su cuenta.
- Sin informar a la tienda. Si la tienda rechazó la guía, se informa de nuevo con un clic.
Sincronización de respaldo
Si un evento se pierde, el pedido igual entra
Las tiendas avisan cada orden al instante, pero a veces un aviso no llega. Por eso Waygo revisa la tienda cada 15 minutos y recupera lo que faltó.
- Cada cuánto. Cada 15 minutos por defecto, entre 5 minutos y un día.
- Al conectar. Mira 72 horas hacia atrás, o hasta 30 días, para traer lo pendiente.
- Visible. Cada sincronización queda con cuántos pedidos revisó y cuántos eran nuevos, y el pedido recuperado lo dice.
- A mano. "Sincronizar ahora" y "Probar conexión" cuando lo necesites.
API para socios
Si el comercio tiene su propio sistema, lo conecta por API
Una API REST con su documentación publicada y un entorno de pruebas. Esta es una llamada real: crea el envío y devuelve la guía, el enlace de rastreo y el PDF.
- Una llave por comercio. Cada API key es de un comercio y solo ve y crea sus envíos. Se revoca cuando quieras.
- Sin guías duplicadas. Con
Idempotency-Key, un reintento devuelve la misma guía durante 24 horas. El número de orden tampoco se repite. - Todo lo del envío. Cotizar, crear, consultar por guía, ver el historial, descargar la guía de 4×6" y cancelar mientras no haya salido.
- Catálogos. Bodegas, ciudades, estados, tipos de servicio, medios de pago, causales de novedad y de cancelación.
POST https://api.waygo.pro/partner/v1/shipments
Authorization: Bearer tms_c_660e91…
Idempotency-Key: 7b1d3c2e-5f4a-4e8b-9c1d-2a3b4c5d6e7f
{
"warehouse_id": "d83f761b-7f07-4f52-9918-2a42b42ec2c2",
"is_pickup": false,
"order_number": "MN-48377",
"recipient_name": "Camila Ortiz",
"recipient_phone": "3005550142",
"recipient_address": "Cl. 93 # 13-24",
"recipient_address_line2": "Apto 502",
"recipient_city_id": "2eee539c-f7df-4478-b47a-8ce6b44a7c37",
"payment_type": "cod",
"cod_amount": 89900,
"weight": 1.2,
"notes": "Llamar antes de llegar"
}200 OK
{
"id": "ca532f1a-f599-4b83-bddf-033f443dcdee",
"tracking_number": "TMS-20261029-00156",
"order_number": "MN-48377",
"current_state": "in_warehouse",
"is_cod": true,
"cod_amount": 89900,
"shipping_price": 12047.5,
"tracking_url": "https://app.waygo.pro/t/2a73dfcc-6064-44c2-85e7-afe407f5b56f",
"label_url": "https://api.waygo.pro/public/labels/2a73dfcc-6064-44c2-85e7-afe407f5b56f.pdf"
}POST https://api.waygo.pro/partner/v1/shipments
(la misma llave y el mismo cuerpo)
200 OK
Idempotent-Replayed: true
{
"tracking_number": "TMS-20261029-00156",
"order_number": "MN-48377"
}
// La misma guía: no se crea un segundo envío.Llamada real a la API con datos de demostración. Pruebas en dev-tms-api.waygo.pro/partner.
Webhooks
Su sistema se entera de cada cambio, aunque esté caído un rato
El comercio se suscribe a los eventos que le sirven. Cada aviso va firmado y, si su sistema no responde en 10 segundos, Waygo lo vuelve a intentar.
Reintentos de un eventoEjemplo: el sistema del comercio vuelve en el cuarto intento
- Intento 1al instante503
- Intento 230 s503
- Intento 31 mintimeout
- Intento 45 min200
- 5Intento 515 min
- 6Intento 630 min
- 7Intento 71 h
- 8Intento 83 h
8 intentos en unas 5 horas. La espera crece: 30 s, 1 min, 5 min, 15 min, 30 min, 1 h y 3 h.
Lo que recibe su sistema
X-Webhook-Event: shipment.delivered
X-Webhook-Attempt: 4
X-Webhook-Signature: t=1761853328,v1=5f0c9a…
{
"event": "shipment.delivered",
"tracking_number": "TMS-20261029-00156",
"order_number": "MN-48377",
"from_state": "in_progress",
"to_state": "delivered",
"timestamp": "2026-10-30T19:42:08Z",
"data": {
"recipient_name": "Camila Ortiz",
"photo_url": "https://…/evidencia.jpg",
"signature_url": "https://…/firma.png"
}
}shipment.createdEnvío creadoshipment.state_changedCambio de estadoshipment.deliveredEntregadoshipment.cancelledCanceladotemperature.excursionExcursión de temperaturaform.run.submittedFormulario enviado
- Firmado. HMAC-SHA256 con su secreto en
X-Webhook-Signature, y la documentación trae cómo verificarlo en Node y Python. - Con la evidencia. La entrega llega con la foto, la firma y el intento; una novedad, con su causal.
- Seguro. Solo a direcciones HTTPS públicas. El secreto se muestra una vez y se regenera cuando quieras.
Otras puertas
Y para los que no tienen tienda ni sistema
Excel o CSV
Plantilla con hoja de ciudades y una vista previa que valida todo sin crear nada. No importan tildes ni mayúsculas, y las ubicaciones dudosas se corrigen con un pin que queda aprendido.
Desde el portal del comercio
El comercio conecta su propia tienda, crea sus API keys y sus webhooks, y ve sus pedidos sin pedírselo a tu equipo.
Cotizar antes de crear
POST /v1/quotes calcula el precio con la lista del comercio y el peso cobrable, sin crear el envío.
Formularios y temperatura
La misma API asigna formularios y avisa cuando se envían, se aprueban o hay una excursión de temperatura.
Se conecta con
Conectado con
- 01Portal de comerciosCada comercio crea, importa y sigue sus envíos, resuelve sus novedades y pide sus recogidas en un portal con tu marca.
- 02Tarifas por clienteLa lista de precios de cada comercio, versionada, y un precio que se calcula igual en la oficina, el portal y la API.
- 03Experiencia del destinatarioRastreo con tu marca, hora estimada y mensajero en el mapa, enlace para cambiar dirección o fecha, evidencia y calificación.
Conecta la tienda de un comercio
en la demo
Te mostramos cómo entra una orden, qué reglas la filtran y cómo vuelve la guía a la tienda. Y si tu equipo técnico quiere, revisamos la API juntos.
Sobre integraciones y API
¿Qué tiendas se conectan?
Shopify, VTEX, WooCommerce, Tiendanube (también Nuvemshop) y Mercado Libre. Shopify, Tiendanube y Mercado Libre se autorizan desde la tienda; VTEX se conecta con su app key y app token, y WooCommerce con su consumer key y consumer secret, sin instalar un plugin.
¿Puedo elegir qué órdenes se vuelven envíos?
Sí. Cada tienda tiene sus reglas: los estados de pago aceptados, los métodos de envío, una etiqueta o un canal, y las ubicaciones o bodegas de la tienda que atiende la conexión. Cada orden que no entra queda con su razón: por ejemplo, que el pago no está en los estados aceptados.
¿Qué pasa si un evento de la tienda no llega?
Una sincronización de respaldo revisa la tienda cada 15 minutos (se puede cambiar entre 5 minutos y un día) y recupera los pedidos que no entraron. Al conectar, mira hasta 72 horas hacia atrás, o hasta 30 días si lo configuras.
¿Qué vuelve a la tienda?
En Shopify, VTEX, WooCommerce y Tiendanube, el número de guía con el enlace de rastreo y los estados de la entrega. En Mercado Libre se informan el número de guía y los estados, solo en los envíos que despacha el vendedor, y sin el enlace de rastreo.
¿Se detecta el contra entrega?
En Shopify, VTEX, WooCommerce y Tiendanube, sí, por el medio de pago o la pasarela de la orden, y el envío se crea con el valor a recaudar. En Mercado Libre no.
¿Un comercio puede conectar varias tiendas?
Sí, cada una con sus reglas, su bodega y su prefijo de número de orden. Las conecta tu equipo a nombre del comercio, o el comercio desde su portal.
¿Cómo funciona la API?
Cada comercio tiene su propia API key y solo ve y crea sus envíos. Crea envíos con la llave de idempotencia, cotiza con su lista de precios, descarga la guía en PDF, consulta el historial y cancela mientras el envío no haya salido. La documentación está publicada en api.waygo.pro/partner/docs, con un entorno de pruebas.
¿Qué eventos llegan por webhook?
Envío creado, cambio de estado, entregado y cancelado, además de los de temperatura y formularios si usas esos add-ons. Cada evento va firmado con HMAC-SHA256 y, si tu sistema no responde, se reintenta 8 veces en unas 5 horas.