API da VTEX: o que dá para fazer e como usar com agentes de IA
A VTEX expõe APIs REST para quase todos os módulos da plataforma de e-commerce: catálogo, pedidos, logística, preços e clientes. É usada por varejistas e indústrias de médio e grande porte e por seus integradores. O acesso é por chave e token de aplicação gerados na conta.
Os grandes recursos da API, em português claro.
Produtos, SKUs, categorias, marcas e especificações.
Consulta, acompanhamento e mudança de status de pedidos, incluindo cancelamento.
Saldos por armazém, docas e configurações de entrega.
Tabelas e regras de preço por SKU e política comercial.
Criação e consulta de promoções e cupons.
Dados de clientes e entidades personalizadas da loja.
Como se acessa a API do VTEX.
- Com credencial da sua empresaUsa um par App Key e App Token criado no admin da VTEX, associado a perfis de acesso que definem o que a chave pode fazer.
- Documentação oficialdevelopers.vtex.com
- Algumas APIs têm limites de requisição; integrações em lote devem respeitá-los.
- Perfis de acesso amplos dão poder demais à chave: crie um perfil próprio para o agente.
- Dados de clientes no Master Data estão sujeitos à LGPD.
- api vtex
- vtex api documentação
- vtex api pedidos
- vtex api catálogo
- integração api vtex
- vtex app key app token
- vtex master data api
O que um agente do iTeam faz com a API do VTEX.
O agente consulta o pedido no OMS e o rastreio, responde o cliente e abre a tratativa no time quando há extravio ou atraso.
O agente cruza vendas e saldo por armazém e avisa compras sobre SKUs que vão zerar nos próximos dias.
Pedidos presos em um status por tempo demais são listados com o motivo provável para o time de operações.
Antes de uma campanha, o agente confere promoções ativas e aponta conflitos de desconto ou SKUs sem preço.
Da credencial ao agente trabalhando, com aprovação.
Crie a chave de aplicação
No admin da VTEX, gere App Key e App Token e associe a um perfil de acesso com as permissões mínimas.
Cadastre no cofre do iTeam
As credenciais ficam no cofre e cada agente recebe só as ações que precisa, como leitura de pedidos ou ajuste de estoque.
Valide em homologação
Teste em um ambiente de desenvolvimento ou workspace da VTEX e mantenha aprovação para cancelamentos e preços.
Dúvidas sobre a API do VTEX.
A API da VTEX é gratuita?
O uso das APIs faz parte do contrato da plataforma VTEX; não há, de forma geral, cobrança separada por chamada para a própria loja.
Preciso programar para usar a API da VTEX com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam aprende os endpoints pela documentação da VTEX e o time de implantação configura os fluxos.
O agente pode cancelar pedidos?
Pode, se o perfil de acesso permitir, mas o recomendado é que cancelamentos passem por aprovação humana.