Tempo aproximado para leitura: 00:03:06 min
Ocorrência
|---------- Registro Online de Boletos -----------------------------------------------------------
| Dados do processo:
| Erro na tentativa de registrar online o boleto xxx:
Erro retornado pelo serviço de registro do Banco Itaú:
BadRequest-{"codigo":"400","mensagem":"Erro na validação de Campos","campos":[{"campo":"data.dado_boleto.juros.percentual_juros","mensagem":"Para título com juros o percentual de juros deve ser maior que zero","valor":"0"},{"campo":"data.dado_boleto.multa.valor_multa","mensagem":"Para título com multa o valor de multa deve ser maior que zero","valor":""}]}
Ambiente
Cross Segmentos - Backoffice Linha RM - TOTVS Gestão Financeira - Todas as versões de mercado.
Causa
O incidente ocorre porque as informações de juros e multa não estão sendo enviadas corretamente no XML de envio ou a associação de dados no Layout de Registro Online apresenta divergências em relação às regras e nomenclaturas da API V2 do Banco Itaú:
As tags de tipo de juros e multa (codigo_tipo_juros ou codigo_tipo_multa) foram informadas indicando a incidência dos valores, porém os campos percentuais (percentual_juros ou percentual_multa) foram enviados zerados ou em branco.
A nomenclatura das tags no layout de Registro Online não está idêntica ao manual bancário, contendo espaços adicionais, caracteres divergentes ou diferenças na escrita dos campos.
Solução
Para solucionar essa ocorrência, realize os seguintes passos:
Acesse a rotina de Layout do Registro Online de Boletos no RM Gestão Financeira.
-
Revise as associações das tags do layout e confirme se a nomenclatura está cadastrada exatamente igual à especificada no manual da API V2 do Banco Itaú:
- data.dado_boleto.juros.codigo_tipo_juros
- data.dado_boleto.juros.percentual_juros
- data.dado_boleto.multa.codigo_tipo_multa
-
data.dado_boleto.multa.percentual_multa
Certifique-se de que não existam espaços adicionais, caracteres especiais ou divergências de caixa (letras maiúsculas/minúsculas) nas tags do layout, pois isso impede o carregamento das informações no XML.
Crie ou utilize uma fórmula ou valor fixo associada à tag para garantir que o percentual correto seja repassado para a estrutura do XML no momento do envio.
Gere novamente o processo de Registro Online do boleto e valide a emissão.
Importante
Se os valores/percentuais estiverem preenchidos, as tags configuradas exatamente conforme o manual do Banco Itaú e, mesmo assim, se a mensagem persistir, será necessário acionar o suporte do Banco Itaú para validação técnica dos dados do contrato/beneficiário junto à API do banco.
Acesse a documentação completa para detalhes sobre Registro Online de Boletos para o Banco Itaú.
0 Comentários