Venda com CNPJ Instabuy não integra sobe para o PDV

1. Contexto

Este erro ocorre quando uma venda originada no Instabuy não sobe corretamente com o CNPJ do cliente para a pré-venda do PDV.
O operador precisa digitar o CNPJ manualmente, o que causa divergência entre o pedido original (Instabuy) e o registro fiscal (Lumi PDV).

2. Causa Raiz

A falha ocorre em versões antigas do LDI (Lumi Data Integration) configuradas para a API Instabuy V2.
Nessas versões:

• O campo CNPJ não é enviado na estrutura de integração;

• O meio de pagamento Wynk é tratado incorretamente como desconto;

• O token de autenticação usado é incompatível com o novo formato da API.

A partir da versão 1.6.0.17, o LDI passou a integrar com a API Instabuy V3, corrigindo todos esses pontos.

3. Solução Definitiva

3.1. Atualizar o LDI

1. Baixe e instale a versão mais recente disponível:
   👉 Release mínima recomendada: 1.6.0.17 ou superior.

2. Confirme a versão instalada

   1. Retorno esperado: LDI v1.6.0.17

3.2. Configurar a integração para a API Instabuy V3

1. Acesse o configurador do LDI → aba Merca Fácil / E-commerce.

2. Localize o bloco Instabuy e ajuste os parâmetros

   Configuração obrigatória:

   • Versão API: V3

   • Token: inserir novo token fornecido pela Instabuy

   • Ambiente: Produção

   • Enviar apenas produtos ativos: habilitado

   • Venda assistida: desabilitada

    

3.3. Solicitar novo Token Instabuy

• Ao migrar para a versão 3 da API, o token anterior deixa de ser válido.

• Solicite o novo token V3 diretamente com o suporte Instabuy.

• Insira o token no campo correspondente no LDI (conforme passo anterior).

3.4. Reiniciar o serviço do LDI

Após atualizar e configurar o serviço

4. Validação

4.1. Teste de pedido Instabuy

1. Realize uma venda de teste no Instabuy (V3) com um cliente CNPJ.
   Exemplo:

   Pedido JB53-BADV Cliente: Maria Empresa de compras da Silva - 36.406.270/0896-44

2. No PDV Lumi, verifique se o CNPJ foi integrado automaticamente na pré-venda.
   ✅ Resultado esperado:
   O PDV mostra o CNPJ correto do cliente sem necessidade de digitação manual.

4.2. Verificação no Auditor de Cupons

No Auditor de Cupons Lumi, confirme se o campo Cliente foi preenchido automaticamente.
No exemplo analisado:

4.3. Validação cruzada

Na listagem de pré-vendas, o cliente aparece com o nome e CNPJ corretos:

5. Checklist de Verificação

6. Alterações Técnicas da Versão 1.6.0.17 (Instabuy V3)

Open

7. Conclusão

Após a atualização do LDI para a release 1.6.0.17 e a configuração da integração Instabuy V3, o problema é resolvido de forma definitiva:

• O CNPJ do cliente passa a ser integrado corretamente;

• O meio de pagamento Wynk é tratado como forma válida;

• Nenhuma ação manual é necessária no PDV.

FAQs — Integração de CNPJ Instabuy no PDV (LDI)

1. Por que o CNPJ não aparece automaticamente no PDV ao integrar pedidos do Instabuy?

Esse problema ocorre quando o Lumi Data Integration (LDI) está configurado com a API Instabuy V2.
Na versão V2, o campo de CNPJ não é transmitido corretamente na estrutura JSON.
A partir da versão 1.6.0.17, o LDI passou a suportar a API Instabuy V3, corrigindo a integração do CNPJ.

2. Qual versão do LDI corrige o problema de CNPJ ausente e pagamento incorreto?

A correção está disponível a partir da versão 1.6.0.17 (ou superior).
Essa release integra com a API Instabuy V3 e trata corretamente o envio de CNPJ, pagamentos Wynk, Dinheiro e POS.

3. Como atualizar o LDI para a versão correta?

1. Baixe o instalador da versão 1.6.0.17 (ou superior) no portal da Lumi.

2. Execute a instalação como administrador.

3. Verifique a versão nas opções do Lumi Data Integration

   1. Resultado esperado: LDI v1.6.0.17

4. Onde configurar a API Instabuy V3 no LDI?

No Configurador → Merca Fácil / E-commerce → Instabuy:

• Versão API: selecione V3

• Token: insira o novo token fornecido pela Instabuy

• Ambiente: “Produção”

• Enviar apenas produtos ativos: habilitado

• Venda assistida: desabilitada

5. É necessário solicitar um novo token após a atualização?

Sim. O token da API V2 não é compatível com a API V3.
Solicite o novo token ao suporte Instabuy e insira-o no campo “Token” dentro da configuração do LDI.

6. Como confirmar que o CNPJ está sendo integrado corretamente?

Após atualização e configuração:

1. Gere uma venda teste no Instabuy (cliente com CNPJ).

2. No PDV, abra a pré-venda.

3. O campo “Cliente” deve aparecer preenchido automaticamente com o CNPJ.

4. No Auditor de Cupons Lumi, o CNPJ deve constar na coluna “Cliente” da venda.

7. O problema do pagamento Wynk como desconto também é resolvido nessa versão?

Sim. A partir da versão 1.6.0.17, o meio de pagamento Wynk é integrado corretamente conforme informado no aplicativo, sem ser tratado como desconto.