Solução de Problemas

Página dedicada a anotação dos problemas encontrados com integrações e outros aplicativos e como roteiro para solucionar o problema.

MySQL

Erro / Problema	Causas / Solução
Error Code: 1215. Cannot add foreign key constraint	Causa 1: Verifique se ambas as tabelas estão utilizando o mesmo engine (InnoDB, MyISAM, etc.). Pode ser verificado utilizando o comando: SHOW CREATE TABLE <table_name>
	Causa 2: Nome da tabela ou da coluna digitada errada ou não existente.
	Causa 3: A associação está sendo feita com uma coluna que não tenha um índice. Tenha a certeza que a coluna à qual está tentando associar tenha um índice em que ela é marcada como primeira coluna ou que seja uma chave primária ou chave única.
	Causa 4: Os tipos e tamanhos da coluna não são os mesmos. Há diferença inclusive se o campo for marcado como UNSIGNED .

PDV

Problemas relacionados a aplicação do PDV do BIS

Erro / Problema	Causas / Solução
Falha ao carregar o DarumaFrameWork	Causa 1: Diferença entre arquiteturas (x32 ou x64) da JVM e da DLL. Solução: Verifique se a versão do java em que a aplicação está rodando é 32 bits e se as DLL na pasta da aplicação também são compatíveis com 32 bits. Por padrão as DLLs de 64 bits (não todas) tem o valor "64" no nome delas. Desde a versão 7.2.4, começo da implementação do SAT, o PDV passou a rodar só em versão 32 bits já que a DLL do SAT não é disponibilizada em 64 bits.
	Causa 2: Falta da biblioteca "DarumaFrameworkJNA.jar" na pasta lib/. Esta biblioteca é necessária para que o Java encontre a DLL. Mas como ele não é obtida através do Maven, algumas vezes o BIS falha em exporta-la junto com o BISPDV.jar durante o processo de release. Solução: Verifique se o JAR encontra-se dentro da pasta lib/ dentro da pasta da aplicação. Caso não se encontre, providencie o JAR adequado para a versão e o coloque na pasta.

SAT

Problemas relacionados ao SAT

Erro / Problema	Causas / Solução
Erro Desconhecido	Causa: Ocorreu algum erro provavelmente com a comunicação do WebService da Receita. Nestes casos é comum o SAT não remapear o erro, registrando apenas a resposta do WebService no log do equipamento. Solução: Sempre que obter um erro desses verifique o log do equipamento para verificar os problemas que foram registrados.
Falha ao Associar Assinatura (Código de Vinculação) no Equipamento	Causa: Obtemos o erro 540 - Rejeição: CNPJ da Software House + CNPJ do emitente assinado no campo “signAC” difere do informado no campo “CNPJvalue” ao tentar gerar associar a assinatura no equipamento do SAT. Solução: Esse erro pode ocorrer quando algumas informações estão erradas, neste caso verifique todos os itens abaixo: O equipamento já está associado ao CNPJ do contribuinte corretamente. Verifique o status da associação do equipamento no SGRSAT na conta do contribuinte; O CNPJ do contribuinte ou da Software House estão incorretos nos parâmetros sendo passados; O certificado usado no cadastro da SoftwareHouse é diferente do que foi usado para a geração da assinatura (código de vinculação). Ou o certificado está vencido. Neste caso é necessário exportar as chaves públicas do certificado (no formato "X.509 codificado na base 64") e incluir ele no cadastro da empresa no SGRSAT da Software House.

Pay&Go

Problemas relacionados a aplicação do Pay&Go.

Erro / Problema	Causas / Solução
CHECKOUT DUPLICADO	Este erro pode ocorrer durante re-instalação ou após alguma instalação mal sucedida. Solução: Vá no menu Manutenção > Liberar Terminais Virtuais.

REDE

Problemas relacionados diretamente com a adquirente REDE.

Erro / Problema	Causas / Solução
TENTE NOVAMENTE - LC	Segundo acontecimento em 17/05/2017 este erro é um problema de conexão entre o Pay&Go e a REDE, a orientação foi de aguardar eles reestabelecerem a conexão.
ERRO EMV	Pode ocorrer em duas situações: Com PIN pad PPC900/PPC910 – o Erro ocorre devido ao PIN pad não ter espaço suficiente para carregar as tabelas das adquirentes. Com PIN pad Ingenico: erro EMV pode ocorrer devido a problemas como: cartão não responde, erro interno do PIN pad, parâmetro inválido retornado do PIN pad, etc. Solução: Verifique em "Conexões CGR": - se o Cliente utiliza PIN pad Gertec PPC900/PPC910 com Versão PP inferior a 001.42... - Verifique se a versão do Pay&Go está atualizada (a partir da versão PG_160426 este erro é corrigido automaticamente); - Caso a versão do Pay&Go esteja desatualizada, encaminhe o chamado para N2 realizar a atualização e dar sequência ao atendimento; Realize uma transação de teste pela REDE, (o erro EMV será apresentado e o Pay&Go fará a limpeza de tabelas automaticamente); Refaça a transação novamente pela REDE. Observação Importante a primeira transação após o ERRO EMV deve ser feita sempre com um cartão com CHIP pela REDE, porque a carga de tabelas no PIN pad é realizada quando é inserido o primeiro cartão após a inicialização, e a carga de tabelas da REDE é maior, requerendo um espaço temporário no dispositivo maior para manipulação das tabelas durante a carga. Caso não for possível atualizar a versão ou o erro não foi corrigido após a atualização, realize os procedimentos manualmente: Apague as Tabelas do PIN pad: Solicite que o cliente desconecte o PIN pad da máquina; Assim que o cliente conectar o PIN pad novamente, no momento que aparecer "..." no visor do PIN pad. Solicite que o cliente aperte as teclas "Anula" (Vermelha), "0" (Zero) e "Entra" (Verde); OBS: Caso não consiga, faça novamente os passos 2 e 3. Abrirá o SETUP de configurações técnicas do equipamento; Escolha a opção "1" (Apagar Arquivos), feito isso, as tabelas baixadas anteriormente serão apagadas do PIN pad; Pressione "Anula" para retornar; Realize um teste de venda na REDE (veja acima Observação Importante); Se mesmo assim o erro ainda persistir, solicite a troca do equipamento. Em caso de PIN pad próprio, informe ao Cliente que recomendamos a troca por PIN pad Ingenico IPP 320 ou GERTEC PPC 920. Se o cliente possuir um PPC910, ele pode enviar o equipamento para a Gertec atualizar. A atualização deve ser tratada diretamente com a Gertec. Para o PPC900 não há atualização disponível. Fonte

CIELO

Problemas relacionados diretamente com a adquirente CIELO.

Erro / Problema	Causas / Solução
PROBLEMA PINPAD OPERAÇÃO CANCELADA	Causa 1: PIN pad GERTEC PPC900/PPC910 – Este problema ocorre devido ao tamanho do arquivo de atualização de tabelas das Adquirentes CIELO e REDE, o PIN pad Gertec PPC900/PPC910 não comporta a atualização devido ao espaço de memória interna ser menor que o volume das duas tabelas juntas. Solução: Solicite a troca do PIN pad nas situações abaixo: Verifique em "Conexões CGR": Se o Cliente utiliza PIN pad Gertec PPC900/PPC910 com Versão PP inferior a 001.42... (caso não utilize um destes PIN pads, siga o procedimento para solução da CAUSA 2). Solicite a troca do Equipamento conforme Script de troca de PIN pad). Em caso de PIN pad próprio, informe ao Cliente que recomendamos a troca por PIN pad: Ingenico IPP 320 GERTEC PPC 920 Se o cliente possuir um PPC910, ele pode enviar o equipamento para a Gertec atualizar. A atualização deve ser tratada diretamente com a Gertec. Para o PPC900 não há atualização disponível. Verifique se a versão do Pay&Go está atualizada, caso não esteja, encaminhe um chamado para N2 atualizar a versão do Pay&Go. Fonte: Script de Atendimento NTK - v11
	Causa 2: PIN pad carregado somente com a chave "3DES (3 DUKPT)", porém na base Cielo o cadastro do Cliente está com o método de criptografia como "DES (1 DUKPT)", causando o erro. Abertura de Chamado: (Motivo: PINPAD - PROBLEMA PINPAD OPERAÇÃO CANCELADA) Solução: Entrar em contato com a Cielo no telefone 4002-8031 (Capital) ou 0800 570 1031 (Outras Localidades), selecione opção “9 - outros”; Informar “ERRO PINPAD - OPERAÇÃO CANCELADA” ou “PROBLEMA PINPAD - OPERAÇÃO CANCELADA"; Solicitar a alteração no método de criptografia; Liberar carga de Tabelas e inicializar o Terminal novamente. Se mesmo assim o erro ainda persistir, solicite a troca do equipamento. Fonte: Script de Atendimento NTK - v11