Integración con VTEX · Beta

Las órdenes de VTEX salen a ruta, y el rastreo vuelve a la factura

Cada tienda VTEX queda conectada con una llave propia. Las órdenes listas para despachar entran solas, cotizadas con la tarifa del comercio, y Waygo informa en la factura la guía, el enlace de rastreo y cada estado hasta la entrega.

Orden 1374120502351-01

Nicolás BeltránCl. 116 # 45-80, Bogotá

  • 1× Café de origen 500 g
  • 1× Filtros de papel x100

Total$69.900

Lista para despachar

WaygoEnvío creado

TMS-20261030-00286

Cliente
Mercado Nativo
Destinatario
Nicolás Beltrán
Lista de precios
Tarifa Bogotá
Pago
Prepago

Cotizado con la tarifa del comercio, como un envío creado a mano.

Orden 1374120502351-01
  1. Factura con rastreoguía, enlace, transportadora y fecha de despacho
  2. En repartoevento de rastreo en la factura
  3. Entregadoy la orden queda entregada en VTEX
Para conectar
Llave de API
exclusiva para Waygo, probada antes de guardarla
Qué entra
Lista para despachar
o facturada, con las reglas de cada tienda
Qué vuelve
En la factura
guía, enlace de rastreo y cada estado
Si algo no cuadra
En revisión
nunca un envío mal cotizado

Una orden de la demo de Waygo con datos ficticios: la tienda es de Mercado Nativo, un comercio de prueba, y la guía es la del envío que se creó.

Conectar

Conectar VTEX toma un par de minutos

La tienda queda atada al comercio dueño, a la bodega desde donde salen sus envíos y a si hay que recogerlos donde el comercio. Después ajustas qué órdenes entran y qué se le informa a VTEX.

  • Desde tu oficina o el comercio desde su portal, con una llave de API que la tienda crea para Waygo.
  • Una llave exclusiva: VTEX admite un solo hook de órdenes por llave, y Waygo nunca pisa el de otra integración.
  • El token se guarda cifrado y no se vuelve a mostrar.

Conectar VTEX

Cliente dueño de la tiendaMercado Nativo
BodegaBodega Puente Aranda
¿Los envíos requieren recolección?Sí, hay que recogerlos donde el comercio
Nombre de la cuentamercadonativoLo que va antes de .myvtex.com en la dirección del admin de la tienda.
App keyvtexappkey-mercadonativo-WAYGO
App token••••••••••••••••VTEX lo muestra una sola vez, al crear la llave.

Waygo prueba la llave antes de guardarla y te dice qué campo revisar: la cuenta, la llave, el permiso de órdenes o el del hook.

CancelarConectar

Qué entra

Entra lo que debe salir a la calle, y nada más

Waygo escucha los eventos de VTEX y vuelve a leer cada orden en la tienda antes de usarla. Las que no pasan tus reglas quedan registradas con el motivo y pueden entrar después, si cambian.

  • Siempre la orden fresca: el aviso solo dice que algo cambió; la orden se lee de nuevo.
  • Respaldo cada 15 minutos para lo que el aviso no trajo.
  • Nunca entran: ítems para recoger en tienda, ítems de otro vendedor del marketplace, órdenes sin dirección de entrega.

Eventos de VTEX

  • Lista para despacharCrear envío
  • FacturadaCrear envío
  • CanceladaCancelar envío
  • Pago aprobadoDesactivado
  • Preparando entregaDesactivado

Qué órdenes se convierten en envío

Aceptar contra entrega
Sí: “Pago contra entrega”, “Contraentrega” y “Contra entrega”
Políticas de envío
Todas, solo las que indiques o todas menos esas
Solo órdenes de esta política comercial
Opcional
Bodegas de VTEX
Las que atiende esta conexión

De vuelta en VTEX

El comercio y su comprador ven la entrega sin preguntarte

La guía viaja dentro de la factura de VTEX: número, enlace a tu página de rastreo, transportadora y fecha de despacho. Si la tienda aún no factura, el aviso espera y sale solo cuando llega la factura.

  • Cuándo se informa la guía: cuando sale a ruta por defecto, o al crear el envío, o nunca.
  • Facturar la orden en VTEX si la tienda no lo hizo: opción apagada por defecto.
  • Cada cambio se informa una vez, y un envío cancelado nunca sale como entregado.

Qué se le informa a VTEX

Cuando el envíoVTEX muestra
Salió a rutaEn reparto
Tuvo una novedadIntento de entrega sin éxito
Es devoluciónNo entregado: en devolución al remitente
TerminóEntregado

Las reglas son tuyas: puedes cambiar qué estado se informa y cuál no. Un aviso fallido se reintenta hasta 8 veces.

Cuando algo no cuadra

Ninguna orden se crea mal: espera en revisión

Si la orden no trae una ciudad que se pueda identificar, si el comercio no tiene lista de precios activa o si el número de orden ya existe, la orden no se convierte en un envío mal cotizado. Queda en Necesitan revisión con el motivo, y desde ahí se reintenta o se descarta.

  • Sin tarifa, no sale: la orden espera hasta que el comercio tenga su lista de precios.
  • Cancelaciones: Si la tienda cancela la orden, Waygo cancela el envío mientras siga creado o en bodega. Si ya avanzó, queda en revisión: “El envío ya avanzó y no se puede cancelar solo”.
  • El comercio también lo ve en su portal, con sus pedidos y su estado.

Pedidos · Necesitan revisión

  • No se pudo identificar la ciudad de entrega
  • El cliente no tiene lista de precios activa
  • Ya existe un envío con ese número de orden: configura un prefijo en la conexión y reintenta
  • El envío ya avanzó y no se puede cancelar solo
ReintentarDescartar

Además

Hecha para operar muchas tiendas a la vez

  • Sin envíos repetidos

    Avisos repetidos o al mismo tiempo de la misma orden terminan en un solo envío.

  • Sincronización de respaldo

    Cada 15 minutos revisa la tienda y recupera las órdenes cuyo aviso no llegó; la primera vez mira 72 horas atrás.

  • Pausar sin perder nada

    Mientras está pausada no se crean envíos. Al desconectar se borran las credenciales y los envíos creados se conservan.

  • Varias tiendas por comercio

    Con un prefijo en el número de orden, las órdenes de varias tiendas no chocan.

Conecta VTEX en
la demo

Te mostramos cómo entra una orden de VTEX, sale a ruta y vuelve a la tienda con su rastreo.

Lo que suelen preguntarnos

¿Qué necesito para conectar una tienda VTEX?

El nombre de la cuenta y una llave de API (app key y app token) creada para Waygo, con permiso sobre las órdenes. La conecta tu oficina eligiendo el comercio dueño, o el comercio desde su portal en Integraciones.

¿Por qué una llave exclusiva para Waygo?

VTEX admite un solo aviso de órdenes por llave. Con una llave propia, Waygo nunca reemplaza el de otra integración de la tienda.

¿Qué órdenes entran?

Las que quedan listas para despachar o facturadas. Puedes limitarlas por política de envío, por política comercial o por bodega de VTEX, y los ítems para recoger en tienda o de otro vendedor del marketplace nunca entran.

¿Funciona con contra entrega?

Sí. Por defecto cuentan los medios de pago “Pago contra entrega”, “Contraentrega” y “Contra entrega”, y puedes agregar otros. El envío se crea con el valor a cobrar.

¿Dónde ve el comercio el rastreo?

En la factura de la orden en VTEX, con el número de guía, el enlace a tu página de rastreo, la transportadora y la fecha de despacho. Cada estado llega como un evento de rastreo, y al entregar la orden queda entregada.

¿Y si la tienda todavía no factura?

El aviso queda en espera y sale solo cuando llega la factura. Si prefieres que Waygo facture la orden, hay una opción para hacerlo, apagada por defecto.

¿Qué pasa si la orden se cancela o se edita?

Si la tienda la cancela, Waygo cancela el envío mientras siga creado o en bodega; si ya avanzó, queda en revisión para operaciones. Las ediciones de una orden que ya tiene envío no cambian el envío.

¿Está disponible para todos?

Las integraciones con tiendas están en beta. Escríbenos y revisamos tu caso en la demo.