Integración Logística VTEX

Andesmar Cargas · Guía de configuración e integración

Esta documentación detalla los requisitos y procedimientos para la integración automatizada entre los servicios de logística de Andesmar y la plataforma VTEX, cubriendo la actualización de tarifas y el seguimiento de estados de pedidos.

Actualización de tarifas Tracking automático Requiere credenciales AppKey / AppToken

Actualización Automática de Tarifas

Configuración de Política de Envío en VTEX

Para automatizar los cuadros tarifarios (fletes), se requiere configurar una Política de Envío en VTEX y proporcionar los siguientes datos a Andesmar Cargas:

Datos Requeridos

Parámetro	Descripción	Dónde encontrarlo
Account Name	Nombre identificador de la tienda.	Visible en la URL del panel admin de VTEX.
ID de Política de Envío	Código alfanumérico de la transportadora asignado al configurar el carrier.	Estrategias de envío → Políticas de envío → Columna ID
AppKey	Credenciales de acceso para la API de VTEX. Se generan por separado y deben tener el rol Logistics Admin.	Configuración de la cuenta → Application Keys
AppToken		Configuración de la cuenta → Application Keys

Nota importante

Las credenciales AppKey y AppToken deben tener asignado el rol de Logistics Admin para que la actualización automática de tarifas funcione correctamente.

Actualización de Estados y Tracking

Notificaciones automáticas al cliente final

Esta funcionalidad permite informar a VTEX sobre el progreso del envío para que el cliente final reciba notificaciones automáticas. Los estados cubiertos son: Despachado, En camino y Entregado.

Requisitos Adicionales

Permisos de Pedidos

Las credenciales (AppKey y AppToken) deben incluir además el rol de OMS Admin (Orders Manager) para poder actualizar el estado de los pedidos.

Flujo de Estados

Despachado

Envío en preparación

En camino

Tránsito activo

Entregado

Pedido finalizado

El sistema enviará automáticamente el número de seguimiento y actualizará el estado del pedido en el panel de VTEX en cada transición.

Checklist de Implementación

Datos a enviar a Andesmar Cargas para iniciar la integración

Para iniciar la integración, el cliente debe completar y enviar el siguiente formulario a nuestro equipo técnico.

Account Name Nombre visible en la URL del panel admin de VTEX.

ID de Política de Envío Código alfanumérico en Estrategias de envío → Políticas de envío → Columna ID.

AppKey Requiere roles: Logistics Admin + OMS Admin.

AppToken

Una vez que tengas estos datos, enviálos a nuestro equipo de integraciones: