Forum

Olá pessoal,

O intuito deste tópico é contribuir com os usuários Mk-Auth que utilizam a Gerencianet a conhecerem uma maneira de identificarem o por quê e como resolver quando o Mk-Auth apresenta a mensagem "Alguns títulos Invalidos, consulte log" ou outra mensagem relacionada a títulos processados com erro quando se tenta emitir uma cobrança.

Estas explicações foram baseadas em um sistema Mk-Auth 18.01 que está utilizando a API Gerencianet (ou seja, está usando "Client_Id" e "Client_Secret").

Primeiramente, efetue login em sua conta Gerencianet, acesse a opção "API" no menu, depois vá em "Minhas Aplicações" selecione a sua aplicação. Agora, clique na aba "Produção", desça a barra de rolagem e acesse a sub-aba "Histórico de Requisições". Repare as transações que estão com o status "Falha" (veja nesta imagem).

Vamos acessar agora os detalhes de algumas dessas requisições que estão com falha: clique no ícone de um "olho" presente na última coluna e veja o que é exibido em "Dados de Saída". Vejamos 3 situações encontradas:

1) Limite de emissões mensais excedido (veja esta imagem): relacionado ao limite de emissões excedido para um mesmo cliente. Atualmente, o limite de emissões para um mesmo cliente é 13 (treze) diárias e/ou 30 (trinta) mensais. É importante certificar de informar sempre dados válidos e corretos do cliente final. Também possuímos uma FAQ explicando (vide link).

2) Transação não processada por conter incoerência nos dados cadastrais (veja esta imagem): esta mensagem indica que algum dado fornecido na cobrança está incorreto, no sentido de não pertencer ao cliente informado. Neste caso, foi observado o CPF fornecido não pertence ao cliente informado. Para solucionar, corrija a informação e tente emitir novamente.

3) /customer/phone_number - A string não corresponde ao modelo (veja esta imagem): indica que o telefone do cliente final foi fornecido de maneira incorreta. Neste caso, observa-se a ausência do DDD (sem o "0"), ou seja, se o telefone é 2526-1234, deve ser informado 1125261234 (caso o DDD deste exemplo fosse 11). Para solucionar, corrija a informação e tente emitir novamente. (obs: este telefone 1125261234 é apenas de exemplo, é fictício).

Em suma, o recurso "Histórico de Requisições" da API Gerencianet pode (e deve) ser utilizado caso queira visualizar como a Gerencianet recebeu os dados enviados por seu sistema Mk-Auth. O "Histórico de Requisições" é tão importante e extremamente útil que a Gerencianet disponibiliza uma página dedicada a ele (vide link), explicando como interpretar os retornos da API e, claro, corrigir possíveis erros de validação de dados ou outros similares.

A Gerencianet espera que com este tutorial possa contribuir, de alguma forma, com a melhoria na experiência de uso entre sistema Mk-Auth e API Gerencianet.