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

1. Acesso à API da VTEX, com:

   • AppKey e AppToken

   • Nome do account VTEX

2. Chaves de integração no sistema ILLI (via ambiente de configuração técnica)

3. Ambiente de homologação da VTEX (para testes de pedidos e estoques)

4. Acesso ao operador logístico para confronto de estoques

5. 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