API de VTEX: qué puedes hacer y cómo usarla con agentes de IA
VTEX expone API REST para casi todos los módulos de la plataforma de e-commerce: catálogo, pedidos, logística, precios y clientes. La usan minoristas e industrias medianas y grandes, y sus integradores. El acceso se hace con una clave y un token de aplicación generados en la cuenta.
Qué ofrece la API de VTEX
Catálogo
Productos, SKU, categorías, marcas y especificaciones.
Pedidos (OMS)
Consulta, seguimiento y cambio de estado de los pedidos, incluida la cancelación.
Logística e inventario
Saldos por almacén, muelles y configuración de entregas.
Precios
Tablas y reglas de precio por SKU y política comercial.
Promociones
Creación y consulta de promociones y cupones.
Master Data
Datos de clientes y entidades personalizadas de la tienda.
Cómo acceder a la API de VTEX
- Con las credenciales de tu empresaUsa un par App Key y App Token creado en el admin de VTEX, asociado a perfiles de acceso que definen lo que puede hacer la clave.
- Algunas API tienen límites de solicitudes: las integraciones por lotes deben respetarlos.
- Los perfiles de acceso amplios dan demasiado poder a la clave: crea un perfil propio para el agente.
- Los datos de clientes en Master Data están sujetos a la normativa de protección de datos (como el RGPD).
Documentación oficial: developers.vtex.com
Qué hace un agente de iTeam con la API de VTEX
Atención al cliente con el pedido a la vista
El agente consulta el pedido en el OMS y el seguimiento, responde al cliente y abre el caso en el equipo cuando hay extravío o retraso.
Quiebre de stock
El agente cruza ventas y saldo por almacén y avisa a compras de los SKU que se agotarán en los próximos días.
Pedidos detenidos
Los pedidos atascados demasiado tiempo en un estado se listan con el motivo probable para el equipo de operaciones.
Revisión de promociones
Antes de una campaña, el agente revisa las promociones activas y señala conflictos de descuento o SKU sin precio.
De la credencial al agente trabajando, con aprobación
Crea la clave de aplicación
En el admin de VTEX, genera App Key y App Token y asócialos a un perfil de acceso con los permisos mínimos.
Regístrala en la bóveda de iTeam
Las credenciales quedan en la bóveda y cada agente recibe solo las acciones que necesita, como leer pedidos o ajustar inventario.
Valida en un entorno de pruebas
Prueba en un entorno de desarrollo o workspace de VTEX y mantén la aprobación para cancelaciones y precios.
Equipos de IA listos que usan VTEX
Preguntas sobre la API de VTEX
¿La API de VTEX es gratuita?
El uso de las API forma parte del contrato de la plataforma VTEX. En general no hay un cobro aparte por llamada para la propia tienda.
¿Necesito programar para usar la API de VTEX con iTeam?
No necesariamente. La herramienta HTTP de iTeam aprende los endpoints a partir de la documentación de VTEX y el equipo de implantación configura los flujos.
¿El agente puede cancelar pedidos?
Puede, si el perfil de acceso lo permite, pero lo recomendado es que las cancelaciones pasen por aprobación humana.
