MK-AUTH

[Tutorial] Como resolver "Alguns títulos Invalidos, consulte log"

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.

Exibições: 1062

Responder agora

Respostas a este tópico

boa noite. não conserguindo gera os carne do m-auth para gerencianet. os boleto estão gerando so os carne que não.

@tiago freitas lima

Para emitir carnês para seus clientes, você precisará definir em seu Mk-Auth os clientes que deseja que os títulos sejam carnês, e não boletos avulsos. Isso será realizado em seu Mk-Auth, dentro do financeiro do cliente.

Na documentação de uso da integração Mk-Auth/Gerencianet há um item explicando passo a passo como fazer. Para acessar, veja no tópico "3. Criar carnês no Mk-Auth utilizando a API Gerencianet", no link https://dev.gerencianet.com.br/docs/mk-auth

Mais um problema

  1. {
  2. "code": 3500034,
  3. "error": "validation_error",
  4. "error_description": {
  5. "property": "/payment/credit_card/customer/birth",
  6. "message": "A string não corresponde ao modelo: ^[12][0-9]{3}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$."
  7. }
  8. }

escolhi como pagamento cartão

@Pedro Alves de Almeida Junior

Este erro está indicando que o formato da data de nascimento está incorreta. Ou seja:

- Ao invés de: 11031989

- Deve ser: 1989-03-11

O formato correto deste atributo é YYYY-MM-DD.

Ademais, agradecemos o envio da imagem, pois através desta evidência foi possível entender e trazer a solução para você.

Tenho uma infinidade de clientes que seguem esse modelo ddmmyyyy e tenho certeza que muitos provedores também seguem esse padrão. terei que fazer essa mudança com todos?

Consultoria Gerencianet disse:

@Pedro Alves de Almeida Junior

Este erro está indicando que o formato da data de nascimento está incorreta. Ou seja:

- Ao invés de: 11031989

- Deve ser: 1989-03-11

O formato correto deste atributo é YYYY-MM-DD.

Ademais, agradecemos o envio da imagem, pois através desta evidência foi possível entender e trazer a solução para você.

@Pedro Alves de Almeida Junior

A API sempre seguiu este padrão de validação. Ou seja, todos os clientes que você permitirá pagamento por cartão de crédito, o atributo "birth" deverá ser fornecido no formato YYYY-MM-DD.

Não consigo mais emitir boletos usando MKAUTH 18.02 e GerenciaNET, informa que "Alguns titulos processaram com erros....".

aqui também, não esta emitindo boletos, e não ta dando erro no log, ta dificil trabalhar com gerencianet

Anexos

Responder à discussão

RSS

TheLinuxF

© 2019   Criado por Pedro Filho.   Ativado por

Badges - Divulgar  |  Relatar erro no site  |  Termos de serviço