Manual de Implantação – Integração ILLI + VTEX
Visão Geral
A integração entre o sistema ILLI e a plataforma VTEX conecta o ERP com funcionalidades de e-commerce para gestão de vendas, estoque e imagens de produtos. O objetivo é garantir que as operações entre loja física, centro de distribuição e e-commerce estejam alinhadas, integradas e sincronizadas, promovendo uma melhor experiência para o cliente final e otimizando a operação logística.
Objetivo da Integração
-
Permitir vendas omnichannel (como a “venda vitrine”) diretamente do PDV
-
Consumir e comparar o estoque VTEX com o operador logístico
-
Integrar o catálogo de imagens dos produtos para padronizar a apresentação visual
-
Minimizar erros de disponibilidade, divergências de estoque e falhas operacionais
Público-Alvo
-
Gerentes de e-commerce e logística
-
Analistas de operação e suporte técnico
-
Equipes de TI e implantação de sistema
-
Usuários do PDV com acesso à função “venda vitrine”
Pré-Requisitos para Implantação
-
Acesso à API da VTEX, com:
-
AppKey e AppToken
-
Nome do account VTEX
-
-
Chaves de integração no sistema ILLI (via ambiente de configuração técnica)
-
Ambiente de homologação da VTEX (para testes de pedidos e estoques)
-
Acesso ao operador logístico para confronto de estoques
-
Código SKU padrão e estruturado no catálogo
Estrutura da Integração
[PDV ILLI] → Venda Vitrine → [VTEX API]
↓ ↓
Consulta estoque Emissão do pedido
Seleção de entrega ↓
Geração de pedido → [Nota fiscal + atualização de status]
[ILLI] ← Consome estoque VTEX para comparar com operador logístico
[CTD / Suporte] ← Catálogo de imagens via código de produto
Funcionalidades Ativas
1. Venda Vitrine
-
O usuário consulta o produto no PDV
-
A integração com a VTEX retorna as opções de estoque (CD, lojas)
-
Cliente escolhe entrega ou retirada
-
O pedido entra automaticamente como pago
-
A nota fiscal é emitida no fluxo padrão da loja virtual
2. Consumo de Estoque da VTEX
-
A API da VTEX fornece o estoque por SKU
-
O sistema consome esses dados e compara com o estoque do operador logístico
-
Divergências são alertadas para evitar a venda de itens indisponíveis
3. Catálogo de Imagens
-
A partir do código do produto, a VTEX fornece o link da imagem tratada
-
Esse recurso é utilizado principalmente pela equipe de suporte técnico e qualidade, através da plataforma CTD
Etapas para Implantação
-
Solicite as credenciais de API VTEX
-
Configure as chaves no Ilimitar (ILLI)
-
AppKey, AppToken, AccountName
-
-
Habilite a funcionalidade “Venda Vitrine” no PDV
-
Valide permissões de usuários
-
-
Configure a rotina de consumo de estoque
-
Estabeleça horários de atualização e lógica de comparação com o operador logístico
-
-
Integre o catálogo de imagens com CTD
-
Habilite a chamada de imagens no código de produtos
-
-
Execute testes em ambiente de homologação VTEX
-
Valide pedidos, estoque e imagens
-
-
Libere a operação em produção
Boas Práticas
-
Alinhe com a logística a periodicidade da sincronização de estoque
-
Oriente o time de vendas quanto ao uso da “venda vitrine”
-
Utilize códigos SKU padronizados para garantir sucesso nas requisições
-
Mantenha os produtos na VTEX com imagens e descrições completas
-
Valide o uso do catálogo em múltiplos canais (PDV, CTD, suporte)
Observações
-
As integrações são desenvolvidas sob demanda, ou seja, nem todos os recursos da VTEX estão implementados automaticamente.
-
A documentação oficial da VTEX é extensa; por isso, recomenda-se que os técnicos consultem links diretos, tutoriais e documentações específicas conforme cada integração.
-
Para produtos com constante atualização de versões ou SKUs, é indicado o uso de rotinas de normalização e mapeamento interno.
Ambiente de Testes
-
Ambiente de homologação VTEX deve estar disponível para:
-
Testar a “venda vitrine”
-
Validar o fluxo completo de estoque e pedidos
-
Evitar disparo de pedidos reais durante testes
-
Nenhum comentário