Integração Vizzo | Lumi
Objetivo
A integração dos extratos de vendas de cartão da Vizzo com o Lumi Gerencial tem como objetivo garantir uma conferência mais precisa dos recebimentos de cartão. Essa integração otimiza o tempo do lojista, que anteriormente precisava realizar essas conferências manualmente.
Premissas
Procedimento de Fechamento de Cartão:
Todo o processo de fechamento de cartão no Lumi Gerencial deixará de ser utilizado, o contas a receber será gerado baseado nos dados dos arquivos enviados pela Vizzo.
Após gravar a importação do arquivo o sistema vai gerar o contas a receber já liquidado na conta corrente ficando o cliente a cargo apenas de realizar a confirmação do lançamento na conciliação bancaria.
Só será integrado os dados que estiverem no arquivo como conciliado, para o layout NEXXERA o campo 44 (Status da Conciliação) deve ser igual a 01.
O batimento de PDV deve estar concluido para iniciar a transação de conciliação de cartão.
No layout NEXXERA, a identificação das transações no sistema é realizada utilizando os campos 22 – NSU, 7 – Autorização e 6 – Comprovante, seguindo essa ordem de precedência.
Além disso, são considerados os 6 primeiros dígitos do cartão (campo 28) e o valor da transação (campo 17) para compor a chave de busca e garantir a correspondência correta no sistema.No layout FISERV, a identificação das transações no sistema é realizada utilizando os campos 7– NSU, 7 – Autorização e 6 – Comprovante, seguindo essa ordem de precedência.
Passos para Integração
1. Pré-requisitos
Versão Necessária:
Certifique-se de estar utilizando a versão 3.0.00 ou superior do Lumi Gerencial.
2. Selecionar o layout do conciliador
Parametrização Geral do Sistema:
Vá para a opção (6) e selecione o layout VIZZO NEXXERA ou VIZZO FISERV, selecione de acordo com o layout que estiver habilitado no portal Vizzo, recomendamos utilizar o layout VIZZO NEXXERA e caso não seja este o habilitado no seu portal, solicitar alteração para a Vizzo.
Aplicação da Flag “Aplicar Conta do Contrato”
A opção "Não Validar Dados da Conta" foi substituída na versão 3.2.02 pela flag "Aplicar Conta do Contrato", devido a problemas identificados no processo de conciliação.
Ao ativar a flag "Aplicar Conta do Contrato", o sistema liquidará o cartão na conta corrente vinculada ao contrato do cartão, ignorando as informações de conta corrente presentes no arquivo.
Se for necessário utilizar as contas correntes informadas no arquivo, a flag não deve estar ativada. Nesse caso, todas as contas correntes presentes no arquivo precisam estar previamente cadastradas no sistema para que a conciliação ocorra corretamente.
3. Habilitar no produto cartão os cartões que serão conciliados de forma automática
Cadastro de bancos e contas correntes
Devem estar cadastrado todos os bancos e contas correntes que serão responsáveis pelo recebimento dos cartões.
Financeiro - Administradoras de Cartão - Produto de Cartão:
Os produtos e contratos de cartão devem estar devidamente criados no sistema, para que seja possível consolidar o lançamento a receber que será gerado de forma automática após conciliação do arquivo. Configuração Produto e Contrato de Cartão
Selecione o produto e marque a flag “Conciliador SITEF”
Configuração da Flag “Conciliador SITEF”
Ao ativar a flag "Conciliador SITEF", o produto Cartão não será mais exibido no Batimento de PDV na opção Venda Cartão para transações TEF. Nesse caso, o Contas a Receber será gerado exclusivamente via importação do arquivo na tela Conciliação TEF.
Na versão 3.2.02 do Lumi Gerencial, foi adicionada uma nova regra para otimizar o batimento. Agora, ao ativar a flag "Conciliador SITEF", o produto Cartão continuará indisponível para transações TEF, mas poderá ser utilizado para lançamentos em transações POS. Isso ocorre porque um mesmo produto Cartão pode ser processado tanto via TEF quanto via POS.
Configuração da Flag “Venda POS”
A flag "Venda POS" deve ser ativada apenas se o estabelecimento realizar recebimentos de cartão que não foram transacionados no PDV.
Quando ativada, o produto Cartão poderá ser lançado na tela Venda POS, acessível em Menu Financeiro → Tesouraria → Venda POS.
⚠️ Importante: Esse tipo de lançamento somente deve ser utilizado para recebimentos fora do PDV. Para vendas processadas no PDV, o correto é utilizar a tela de Batimento.
4. Processo de conciliação TEF
Para iniciar a conciliação acesse a tela Financeiro - Tesouraria - Conciliação TEF
1 - Selecione o estabelecimento e data que será conciliada
2 - Clique em arquivo e selecione o arquivo que será conciliado, o arquivo selecionado deve ser correspondente ao extrato de venda no conciliador que para o layout Nexxera será venda_AAAA_MM_DD.
3 - O sistema irá processar as informações do arquivo
4 - Na aba divergência será apresentado as divergências encontradas no arquivo, que devem ser resolvidas para concluir a integração do arquivo, as linhas sem divergências serão integradas.
O Erro de Status da Conciliação - Significa que o cartão não está conciliado na Vizzo, e por este motivo não será integrado, o cliente deve realizar os procedimentos de conciliação na Vizzo e exportar o arquivo novamente.
O Erro Dados Bancário - Significa que a conta corrente ou banco não esta cadastrado no Lumi, o cliente deve acessar a linha indicada no arquivo para identificar o banco e em seguida prosseguir com o cadastro no sistema, realizado o cadastro da conta ou banco, o arquivo poderá ser importado novamente, ou optar por não trabalhar com esta validação.
5 - Na aba Lançamento, o sistema vai exibir as inconsistências.
Na janela ERP em verde, o sistema exibe os lançamentos que estão no ERP mas não estão no arquivo
Na janela Arquivo em amarelo, o sistema exibe os lançamentos que estão no arquivo mas não estão no ERP ou não foram encontrados pelo NSU.
6 - Na aba conciliado, vai exibir os cartões que foram conciliados, constam no ERP e no Arquivo. são estes valores que vão ser confirmados no contas a receber como liquidado, o campo chave utilizado para conciliar o cartão é o NSU.
7 - Na aba arquivo o sistema registra o histórico dos arquivos conciliados.
8 - Após Salvar, os cartões que foram conciliados serão agrupados por rede, bandeira e vencimento e serão liquidados, sendo possível visualizar nos extratos de recebimento de cartao e na conciliação bancária.
Na versão 3.2.02 foi adicionado melhoria no relatorio extrato de recebimento de cartão, agora é possível visualizar neste relatorio a conta corrente em que o cartão foi liquidado.
O relatorio Extrato de recebimento de cartão está presente no Menu Financeiro → Contas a Receber → Extrato de Recebimento de Cartão.
FAQ – Integração Vizzo | Lumi (Conciliação TEF/POS)
1. O que significa a mensagem “Transação Não Conciliada” exibida no SAC?
Significa que, no arquivo importado da Vizzo, o campo 44 – Status de Conciliação está com valor 02 (Não conciliada). Apenas transações com status 01 (Conciliada) são integradas ao Lumi.
2. Qual é a diferença entre 01 – Conciliada e 02 – Não conciliada?
01: a transação foi conciliada pela adquirente e pode ser integrada.
02: a transação não foi conciliada e o SAC Lumi rejeita a linha automaticamente.
3. Esse erro ocorre por problema no Lumi?
Não. O erro está no arquivo gerado pela Vizzo, que traz a informação de não conciliado. O Lumi apenas interpreta e bloqueia a integração.
4. Como posso verificar o status de conciliação?
No arquivo CSV ou relatório da Vizzo, consulte o campo 44 (Status da Conciliação). Valores diferentes de 01 geram a rejeição.
5. O que devo fazer quando encontro “Transação Não Conciliada”?
É necessário realizar a conciliação diretamente no portal da adquirente ou no sistema da Vizzo. Após isso, deve-se exportar novamente o arquivo e reimportar no Lumi.
6. O que significa o erro “Dados da conta de crédito inválida”?
Significa que a conta bancária informada no arquivo não está cadastrada no Lumi. É preciso incluir a conta em Financeiro → Tabelas Auxiliares → Bancos e Contas Correntes.
7. Qual é o impacto de ignorar transações não conciliadas?
Elas não serão lançadas no Contas a Receber do Lumi, gerando divergência entre extratos de adquirente e ERP.
8. É possível forçar a integração mesmo não conciliado?
Não. O Lumi, por padrão, só importa status 01 (Conciliado) para garantir consistência contábil.
9. Quais são os pré-requisitos para a integração Vizzo funcionar?
Versão do Lumi Gerencial 3.0 ou superior.
Produtos e contratos de cartão devidamente configurados.
Contas bancárias cadastradas no sistema.
10. Onde configuro a flag “Conciliador SITEF”?
Em Financeiro → Administradoras de Cartão → Produto de Cartão. Essa flag define que o produto será conciliado exclusivamente via arquivo Vizzo e não mais pelo batimento manual no PDV.
11. Quando usar a flag “Venda POS”?
Somente quando houver recebimentos de cartão que não passaram pelo PDV. Para vendas TEF normais, não deve ser usada.
12. O que significa Identificador de Conciliação (Tabela V)?
É o tipo de comparação realizada:
T – TEF x Venda
V – Venda x TEF
F – Financeiro x Venda
13. Qual a diferença entre extrato de venda e extrato financeiro?
Venda: traz as transações capturadas.
Financeiro: traz os valores efetivamente liquidados.
14. Qual CFOP é usado nessa integração?
O CFOP não é tratado nesse processo; a integração lida apenas com dados de cartões (NSU, bandeira, adquirente, status).
15. Quais são as principais tabelas de referência do layout?
Tabela VI: Bandeiras.
Tabela VII: Tipos de captura.
Tabela VIII: Status de conciliação.
Tabela XIII: Status de pagamento.
16. Por que aparecem lançamentos no ERP que não estão no arquivo?
Isso ocorre quando o lançamento foi registrado manualmente no ERP mas não veio conciliado no arquivo da Vizzo.
17. Por que aparecem lançamentos no arquivo que não estão no ERP?
São vendas reconhecidas pela adquirente mas não registradas no PDV/Lumi, geralmente por falha de transmissão.
18. O que é o NSU (Número Sequencial Único)?
É a chave usada para identificar e conciliar transações entre ERP, adquirente e conciliador.
19. Como visualizar somente as linhas divergentes?
Na tela Financeiro → Tesouraria → Conciliação TEF, acesse a aba Divergências.
20. O que significa o campo Origem da Informação (Tabela IX)?
01 – Log de vendas
02 – Extrato da adquirente
21. Preciso cadastrar todos os bancos e contas antes de importar?
Sim. Caso contrário, o Lumi apresentará erro “Dados Bancário Inválido”.
22. Como saber se uma divergência é de conta ou conciliação?
Status da Conciliação = 02 → problema na adquirente/Vizzo.
Dados bancários inválidos → problema no cadastro do Lumi.
23. O que acontece após salvar a conciliação?
As transações conciliadas são agrupadas por rede, bandeira e vencimento e liquidadas no Contas a Receber.
24. Existe relatório consolidado para acompanhar?
Sim. O relatório Extrato de Recebimento de Cartão mostra os valores conciliados e a conta bancária de liquidação.
25. Quem devo acionar quando houver divergência contínua?
Se o problema for status 02 (não conciliado) → Vizzo ou adquirente.
Se for conta inválida → ajuste no Lumi.
Se persistirem dúvidas → suporte Lumi.
26. Por que o Lumi mostra a mensagem de “Transação não conciliada” na primeira aba?
Essa aba foi desenhada propositalmente para listar rejeições. Ou seja, tudo que aparece nela não atende às regras mínimas de conciliação (conta válida, NSU existente, status 01 conciliado).
27. Quais são as regras mínimas para que uma transação seja conciliada no Lumi?
Conta corrente configurada corretamente.
NSU válido.
Status de conciliação = 01 (Conciliada).
Transações fora dessa regra são rejeitadas automaticamente.
28. Por que não integramos transações com status “Não Conciliada”?
Porque nesses casos o NSU pode não estar correto e as taxas financeiras ainda não são definitivas. Para evitar inconsistências, o Lumi só aceita transações já confirmadas pela adquirente.
29. Qual a lógica da aplicação em relação à conciliação?
A aplicação só integra o que já foi conciliado na Vizzo. O objetivo é garantir confiabilidade: não faz sentido importar algo que ainda está pendente de validação.
30. Quais tipos de registros o Lumi integra hoje?
Atualmente, apenas o registro tipo 11 (Arquivo de Vendas) é integrado. Ele contém os dados necessários para a conciliação e geração do contas a receber.
31. Quantos campos do registro tipo 11 são utilizados?
O layout oficial traz 54 campos, mas o Lumi consome apenas os que são estritamente necessários para integração (NSU, data, valor, status, conta, entre outros).
32. O que ainda não está suportado na integração?
Ainda não integramos os arquivos de ajuste (correções posteriores enviadas pela adquirente) nem os arquivos de antecipação (operações financeiras de adiantamento de recebíveis).
33. Existe previsão para integrar ajustes e antecipações?
Sim. Esse desenvolvimento já está em fase de especificação na Lumi.
34. Qual será o benefício da integração de ajustes e antecipações?
Vai permitir que além das vendas conciliadas, o cliente tenha também eventuais correções e operações de antecipação refletidas automaticamente no ERP, sem necessidade de lançamentos manuais.