Códigos de Erro

Atenção

Enquanto sua aplicação estiver em desenvolvimento, use somente o endpoint Sandbox, em https://sandbox.boletocloud.com. Isso evita problemas como bloqueio de chamadas, inconsistência de dados e até o bloqueio total da conta na plataforma. Quando os testes terminarem, siga o roteiro Do Sandbox para a Produção.

O campo erro.causas[].codigo é o identificador estável do erro. A integração deve tratar pelo código, não pelo texto da mensagem.

As mensagens podem conter marcadores. {0} a {4} são trocados por valores da requisição. Nas mensagens de campos aparecem também {property-path} (o campo), ${validatedValue} (o valor enviado) e os limites da validação, como {min}, {max}, {value}, {integer}, {fraction}, {regexp}, ${size}, ${element} e ${index}. Na resposta da API, os marcadores vêm preenchidos.

Autenticação e acesso

O que fazer. Confira a API key, o header Authorization (HTTP Basic) e o token da conta. O código 8D1C5814 indica uma rota do plano Personalizado sem o plano ativo. Veja Planos & API.

Código	HTTP	Tipo	Mensagem
3A012814	400	requisicao	Token de acesso via API da conta bancária não informado.
ECA19BFB	400	requisicao	O token de acesso fornecido via API da conta bancária ({0}) está incorreto ou inválido.
2CD228EA	401	autenticacao	O token de acesso fornecido ({0}) está incorreto ou inválido.
546E09FC	401	autenticacao	Token de acesso não informado.
92F6105E	401	autenticacao	Requisição falha, header (Authorization) sem valor definido.
95AA0A56	401	autenticacao	Requisição falha, header (Authorization: {0}), informado diferente do formato (HTTP Basic Auth).
D9308608	401	autenticacao	Falha ao autenticar utilizando método de autenticação (HTTP Basic Auth).
8D1C5814	403	requisicao_nao_permitida	O usuário com token de acesso via API ({0}) não tem permissão para utilizar este recurso do plano personalizado.

Formato da requisição

O que fazer. Confira o caminho da URL, Accept, Content-Type, o método HTTP, o JSON e os nomes dos campos. O código C1E304DC (404) indica uma rota inexistente, como caminho ou versão da API digitados errados.

Código	HTTP	Tipo	Mensagem
4D4AAFB5	400	requisicao	Dados do boleto não informados.
5A1E17EF	400	requisicao	Campo ({0}) - Deve ter um único valor, mas está sendo informado com múltiplos valores: ({1}).
7A05691E	400	requisicao	Os seguintes nomes de campos não são reconhecidos como campos do boleto: ({0}).
842EF62A	400	requisicao	Campo ({0}) - O valor informado ({1}) não corresponde com o formato válido para este campo ({2}).
BF4D885C	400	requisicao	Dados informados, mas em formato inválido. Verifique se sua requisição de envio está correta, desde os headers Accept, Content-Type, etc e sem duplicação dos mesmos, desde os parâmetros aos dados do boleto.
E5E899DA	400	requisicao	JSON informado (Content-Type: {0}), com erro.
C1E304DC	404	requisicao_para_recurso_nao_encontrado	Recurso não encontrado. Confira o caminho da URL.
BD7FDA34	405	requisicao_com_metodo_nao_suportado	Este recurso não está disponível utilizando este método.
EB9F9A4F	406	requisicao_nao_aceitavel	Requisição recusada, header (Accept: {0}) informado incompatível com esperado para este recurso ({1}).
2278DFA6	415	requisicao_com_media_type_nao_suportado	Requisição recusada, header (Content-Type: {0}) informado inválido, formatos válidos são definidos como (type/subtype ;parameter), para este recurso, os media types suportados são ({1}).
4BE9AE0D	415	requisicao_com_media_type_nao_suportado	Requisição recusada, header (Content-Type) sem valor definido.
B3ACDACF	415	requisicao_com_media_type_nao_suportado	Requisição recusada, header (Content-Type: {0}) informado incompatível com esperado para este recurso ({1}).

Erro inesperado

O que fazer. No 179E01F3 (500), tente de novo mais tarde. Antes de criar outro boleto para o mesmo pedido, reenvie o POST com o mesmo boleto.tokenControleUsuario: se o boleto já existir, a resposta é 409, como em Idempotência. No 97E0D35F (400), leia o motivo na mensagem.

Código	HTTP	Tipo	Mensagem
97E0D35F	400	requisicao	{0}
179E01F3	500	inesperado	Erro não identificado, caso o problema persista entre em contato conosco.

Boleto: identificação, estado e operações

O que fazer. A mensagem indica o que ajustar na identificação, no estado ou na operação do boleto. O código 96660E9E significa que o token do boleto é inválido.

Código	HTTP	Tipo	Mensagem
0DE60B80	400	requisicao	Campo ({0}) - {1}
0F729186	400	requisicao	Campo ({0}) - Refere-se a um código de banco ({1}) ainda não suportado. Os bancos atualmente suportados pela API são: ({2}).
0FD58F6A	400	requisicao	O vencimento informado ({0}) não corresponde a uma data válida.
14DEBB97	400	requisicao	Campo ({0}) - O código do banco está ausente, mas é obrigatório.
1B70BC54	400	requisicao	O vencimento ({0}) informado deve ser igual ou maior que a data atual ({1}).
32B7CFE4	400	requisicao	Baixa não permitida para boleto que já consta como pago.
3686DAA7	400	requisicao	Operação não permitida para boletos excluídos.
46FCF838	400	requisicao	Número Identificador Bancário ambíguo. Para determinar o número identificador bancário defina apenas um dos campos: ({0}) ou ({1}), mas não os dois ao mesmo tempo.
4BDC5CF6	400	requisicao	Número Identificador Bancário não definido. Defina o número identificador do boleto (nosso número) no campo ({0}) ou defina um valor sequencial no campo ({1}) para que o número identificador do boleto seja gerado.
51BFC07A	400	requisicao	O vencimento não foi informado.
5B967715	400	requisicao	Campo ({0}) - O código do banco deve conter 3 dígitos, ex: 001, 237, mas o informado foi ({1}).
6EEAFAD1	400	requisicao	Campo ({0}) - O token de acesso a conta bancária está ausente, mas é obrigatório.
922C051E	400	requisicao	Campo ({0}) - Número Identificador Bancário Inconsistente. {1}
96660E9E	400	requisicao	O token identificador do boleto fornecido ({0}) está incorreto ou inválido.
9BD1BD89	400	requisicao	Operação não permitida para boletos sem o registro confirmado.
9FBF0DDB	400	requisicao	O vencimento informado ({0}) não corresponde a um formato numérico válido de data ({1}).
A8FADA81	400	requisicao	Operação não permitida para boletos pagos.
B14DD6FE	400	requisicao	Conta bancária com token ({0}) não utiliza cobrança com registro.
B65C51DF	400	requisicao	Operação não permitida para o banco ({0}).
C17A417F	400	requisicao	Campo ({0}) - Conta bancária não encontrada para token de api ({1}) e usuário com token de api ({2}).
C21A7ED8	400	requisicao	Token identificador do boleto não informado.
D7B5852D	400	requisicao	Boleto sem campo (boleto.cobrancaBancaria.registrar) informado, por favor, envie o json com a seguinte estrutura de objetos boleto/cobrancaBancaria/registrar:opcao, onde opcao é um boolean true ou false, mas não null.
DB8F6A02	400	requisicao	Operação não permitida para boletos baixados da cobrança.
EF04F894	400	requisicao	Campo ({0}) - Conflito de dados: já existe um abatimento para este boleto realizado na data ({1}) e com o valor ({2}).
FD944C29	400	requisicao	Campos ({0}) - Estes campos não devem ser informandos quando o campo ({1}) estiver sendo informado.
202D4AA8	404	requisicao_para_recurso_nao_encontrado	Boleto com token ({0}) não encontrado.

Campos do boleto

O que fazer. Corrija o campo indicado na mensagem. A referência dos campos está em Campos do boleto.

Código	HTTP	Tipo	Mensagem
04EEFB10	400	requisicao	Campo ({property-path}) - O bairro informado (${validatedValue}) do endereço deve conter no mínimo ({min}) caracteres e no máximo ({max}) caracteres.
0717D686	400	requisicao	Campo ({property-path}) - Apenas {max} linhas de instruções são suportadas.
0B7CDC9D	400	requisicao	Campo ({property-path}) - Apenas {max} linhas de informações são suportadas.
0C1275BD	400	requisicao	Campo ({property-path}) - O nome está ausente, mas é obrigatório.
0D7F634E	400	requisicao	Campo ({property-path}) - O nosso número (número bancário) deve conter no máximo ({max}) caracteres.
1192EDEF	400	requisicao	Campo ({property-path}) - O número (${validatedValue}) da NF-e deve conter no máximo ({max}) caracteres.
12ADC40F	400	requisicao	Campo ({property-path}) - O TXID PIX informado (${validatedValue}) não é válido, O TXID PIX deve ter no mínimo ({min}) e no máximo ({max}) caracteres.
1DA6DB10	400	requisicao	Campo ({property-path}) - O valor da NF-e deve ser um número de no máximo ({integer}) dígitos inteiros e ({fraction}) fracionários, mas o informado foi (${validatedValue}).
252E87B1	400	requisicao	Campo ({property-path}) - O bairro do endereço está ausente, mas é obrigatório.
2711F821	400	requisicao	Campo ({property-path}) - A localidade (cidade/município) informada (${validatedValue}) do endereço deve conter no mínimo ({min}) caracteres e no máximo ({max}) caracteres.
27E66DC4	400	requisicao	Campo ({property-path}) - A URL deve ter um tamanho mínimo de ({min}) caracteres e no máximo ({max}) caracteres.
29A6380B	400	requisicao	Campo ({property-path}) - O valor da NF-e deve ser menor que ou igual a ({value}), mas o informado foi (${validatedValue}).
29E52CCD	400	requisicao	Campo ({property-path}) - O número do documento está ausente, mas é obrigatório.
2A470DED	400	requisicao	Campo ({property-path}) - A UF (Unidade Federativa) do endereço está ausente, mas é obrigatória.
2B48ECC8	400	requisicao	Campo ({property-path}) - A data de vencimento do boleto está ausente, mas é obrigatória.
38CE9BEE	400	requisicao	Campo ({property-path}) - O valor do abatimento está ausente, mas é obrigatório.
3B8657BB	400	requisicao	Campo ({property-path}) - O número do endereço deve conter no máximo ({max}) caracteres.
3D53016D	400	requisicao	Campo ({property-path}) - A URL informada (${validatedValue}) não é válida, um exemplo de URL válida é https://pt.wikipedia.org/wiki/URL.
3E0817D2	400	requisicao	Campo ({property-path}) - O valor do boleto está ausente, mas é obrigatório.
407DB9DC	400	requisicao	Campo ({property-path}) - A data de emissão (${validatedValue}) da NF-e não pode ser definida como posterior a data atual.
41C18EDF	400	requisicao	Campo ({property-path}) - O valor do abatimento deve ser um número de no máximo ({integer}) dígitos inteiros e ({fraction}) fracionários, mas o informado foi (${validatedValue}).
4205B984	400	requisicao	Campo ({property-path}) - A localidade (cidade/município) do endereço está ausente, mas é obrigatória.
4DFB9CAA	400	requisicao	Campo ({property-path}) - O percentual mínimo para a desconto do boleto é ({value}), mas o informado foi (${validatedValue}).
53788FE0	400	requisicao	Campo ({property-path}) - O valor da NF-e deve ser maior que ou igual a ({value}), mas o informado foi (${validatedValue}).
5412D14F	400	requisicao	Campo ({property-path}) - O número do endereço está ausente, mas é obrigatório.
597B71D7	400	requisicao	Campo ({property-path}) - posição[${index}] - Apenas {max} caracteres são permitidos por linha, porém a linha informada possui ${size} caracteres, linha:(${element}).
5BA66980	400	requisicao	Campo ({property-path}) - O token de identificação da conta bancária via api está sem valor definido, mas quando este campo é informado o token é obrigatório.
5CE37CD3	400	requisicao	Campo ({property-path}) - O logradouro do endereço está ausente, mas é obrigatório.
5F13D9B2	400	requisicao	Campo ({property-path}) - O CEP do endereço está ausente, mas é obrigatório.
624B14E9	400	requisicao	Campo ({property-path}) - O email informado é inválido, deve ser informado um ou mais emails válidos separados por ; (ponto e vírgula), mas o informado foi (${validatedValue}).
62D17C78	400	requisicao	Campo ({property-path}) - O CPRF está ausente, mas é obrigatório.
638E2C96	400	requisicao	Campo ({property-path}) - O valor do boleto deve ser maior que ou igual a ({value}), mas o informado foi (${validatedValue}).
63CB20D7	400	requisicao	Campo ({property-path}) - O complemento do endereço deve conter no máximo ({max}) caracteres.
64C84BCE	400	requisicao	Campo ({property-path}) - O número do documento deve conter no máximo ({max}) caracteres.
6858440C	400	requisicao	Campo ({property-path}) - O valor do abatimento deve ser maior que ou igual a ({value}), mas o informado foi (${validatedValue}).
6BA16026	400	requisicao	Campo ({property-path}) - O email informado (${validatedValue}) deve conter no máximo ({max}) caracteres.
6DCD9CED	400	requisicao	Campo ({property-path}) - A conta bancária está ausente, mas é obrigatória.
6F48F71E	400	requisicao	Campo ({property-path}) - O valor do abatimento deve ser menor que ou igual a ({value}), mas o informado foi (${validatedValue}).
71D3C5D2	400	requisicao	Campo ({property-path}) - A Chave de Acesso NF-e informada (${validatedValue}) não é válida, a chave deve ter 44 dígitos numéricos e seguir as regras defindias no manual de integração do contribuinte da NF-e.
738D7930	400	requisicao	Campo ({property-path}) - O token de controle do usuário é um campo alphanumérico de até 44 posições sem caracteres especiais, com exceção de: - (hífen), _ (underline) e = (sinal de igual).
75F8AF22	400	requisicao	Campo ({property-path}) - O número/código da conta está ausente, mas é obrigatório.
78F27F8E	400	requisicao	Campo ({property-path}) - O token de identificação da conta bancária via api (${validatedValue}) está incorreto ou inválido.
7A7DC4D5	400	requisicao	Campo ({property-path}) - A parcela deve ser um número de 1 a 999, mas o informado foi (${validatedValue}).
7F67E9DB	400	requisicao	Campo ({property-path}) - posição[${index}] - Apenas {max} caracteres são permitidos por linha, porém a linha informada possui ${size} caracteres, linha:(${element}).
803BF30B	400	requisicao	Campo ({property-path}) - A URL PIX informada (${validatedValue}) não é válida, a URL PIX deve ter no mínimo ({min}) e no máximo ({max}) caracteres.
81BF0CF5	400	requisicao	Campo ({property-path}) - A UF (Unidade Federativa) (${validatedValue}) do endereço não é uma das UF válidas ({regexp}).
86AE5F00	400	requisicao	Campo ({property-path}) - O código do banco deve conter 3 dígitos, ex: 001, 237, mas o informado foi (${validatedValue}).
8AF5873C	400	requisicao	Campo ({property-path}) - O número/código da agência está ausente, mas é obrigatório.
8CA3647B	400	requisicao	Campo ({property-path}) - O pagador do boleto está ausente, mas é obrigatório.
933560DF	400	requisicao	Campo ({property-path}) - A URL PIX informada (${validatedValue}) não é válida, a URL PIX deve ter de 67 a 77 caracteres alfanuméricos e ter como base um dos seguintes caminhos [qrcodepix.bb.com.br/pix/v2/cobv/] ou [qrpix.bradesco.com.br/qr/v2/cobv/].
97D2874C	400	requisicao	Campo ({property-path}) - O CEP do endereço deve ser informado no formato padrão (00000-000) e maior que zero, mas o informado foi (${validatedValue}).
9AE9DAB1	400	requisicao	Campo ({property-path}) - O logradouro informado (${validatedValue}) do endereço deve conter no mínimo ({min}) caracteres e no máximo ({max}) caracteres.
9B3115ED	400	requisicao	Campo ({property-path}) - O número/código do convênio .
A1039F2B	400	requisicao	Campo ({property-path}) - O percentual mínimo para a multa do boleto é ({value}), mas o informado foi (${validatedValue}).
A754E48E	400	requisicao	Campo ({property-path}) - O tipo do título (espécie do documento) do boleto está ausente, mas é obrigatório.
ABEBFC1B	400	requisicao	Campo ({property-path}) - O percentual máximo para a multa do boleto é ({value}), mas o informado foi (${validatedValue}).
B88B126D	400	requisicao	Campo ({property-path}) - O percentual de desconto do boleto deve ser um número de no máximo ({integer}) dígitos inteiros e ({fraction}) fracionários, mas o informado foi (${validatedValue}).
BB3EE9EA	400	requisicao	Campo ({property-path}) - O percentual máximo para os juros do boleto é ({value}), mas o informado foi (${validatedValue}).
BC33448F	400	requisicao	Campo ({property-path}) - O percentual mínimo para os juros do boleto é ({value}), mas o informado foi (${validatedValue}).
BD65233A	400	requisicao	Campo ({property-path}) - O código do banco está ausente, mas é obrigatório.
C817B194	400	requisicao	Campo ({property-path}) - O CPRF informado (${validatedValue}) é inválido, verifique se número informado está correto e obedecendo o padrão para CPF (000.000.000-00) ou CNPJ (00.000.000/0000-00).
C81E8E77	400	requisicao	Campo ({property-path}) - O número/código da carteira está ausente, mas é obrigatório.
CEBDAF6F	400	requisicao	Campo ({property-path}) - O beneficiário do boleto está ausente, mas é obrigatório.
CF0C0FD5	400	requisicao	Campo ({property-path}) - O nome informado (${validatedValue}) deve conter no mínimo ({min}) caracteres e no máximo ({max}) caracteres.
D2B166FA	400	requisicao	Campo ({property-path}) - O percentual máximo para a desconto do boleto é ({value}), mas o informado foi (${validatedValue}).
D8A41E72	400	requisicao	Campo ({property-path}) - O número da parcela está ausente, mas é obrigatório.
DB2DC467	400	requisicao	Campo ({property-path}) - O valor do boleto deve ser um número de no máximo ({integer}) dígitos inteiros e ({fraction}) fracionários, mas o informado foi (${validatedValue}).
DD5C4690	400	requisicao	Campo ({property-path}) - O tipo do título (espécie do documento) informado (${validatedValue}) não corresponde a um dos valores permitidos para este campo ({regexp}).
DDBFF313	400	requisicao	Campo ({property-path}) - A parcela deve ser um número de 1 a 999, mas o informado foi (${validatedValue}).
E159028D	400	requisicao	Campo ({property-path}) - O percentual de multa do boleto deve ser um número de no máximo ({integer}) dígitos inteiros e ({fraction}) fracionários, mas o informado foi (${validatedValue}).
EC3BA340	400	requisicao	Campo ({property-path}) - O endereço está ausente, mas é obrigatório.
ECC7C2E2	400	requisicao	Campo ({property-path}) - O TXID PIX informado (${validatedValue}) não é válido, O TXID PIX deve ter exatamente 35 caracteres alfanuméricos.
ED6418A7	400	requisicao	Campo ({property-path}) - Este campo não deve ser informando quando o campo (boleto.conta.token) estiver sendo informado.
ED87A360	400	requisicao	Campo ({property-path}) - O percentual de juros do boleto deve ser um número de no máximo ({integer}) dígitos inteiros e ({fraction}) fracionários, mas o informado foi (${validatedValue}).
EDBFA093	400	requisicao	Campo ({property-path}) - O valor do boleto deve ser menor que ou igual a ({value}), mas o informado foi (${validatedValue}).
FDE34BE7	400	requisicao	Campo ({property-path}) - A data de emissão do documento (${validatedValue}) não pode ser definida além da data atual.
FFABA163	400	requisicao	Campo ({property-path}) - A data de emissão do documento está ausente, mas é obrigatória.

Regras por banco

O que fazer. A conta está sujeita às regras do banco dela. Veja Conta bancária.

Código	HTTP	Tipo	Mensagem
0278AD6C	400	requisicao	Banco Caixa Econômica Federal - Campo ({property-path}) - A carteira deve ser um número de 1 a 82, mas o informado foi (${validatedValue}).
0759CBFF	400	requisicao	Banco Itaú - Carteira Especial {0} - Campo ({1}) - O Convênio (Código do Cliente Beneficiário) está ausente, mas é obrigatório.
1AF707C0	400	requisicao	Banco Itaú - Campo ({0}) - Deve ser um número de até 2 dígitos (1 a 99), mas o informado foi ({1}).
1F3AD714	400	requisicao	Banco Caixa Econômica Federal - Convênio Não Suportado - Os Campos ({0}={1} , {2}={3}) São referentes a um convênio não suportado, os convênios atualmente suportados para este banco são: ({4}).
1F520126	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - A carteira deve ser um número de 1 a 9, mas o informado foi (${validatedValue}).
2894E6A5	400	requisicao	Banco Sisprime - Campo ({0}) - Não suportado pelo banco.
34699E1A	400	requisicao	Banco do Nordeste - Campo ({0}) - Não suportado pelo banco.
36104574	400	requisicao	Banco Banestes - Campo ({0}) - Deve ser um número de até 3 dígitos (1 a 999), mas o informado foi ({1}).
38389B94	400	requisicao	Banco Itaú - Campo ({property-path}) - O formato do número da conta de 6 dígitos (5 dígitos + dígito verificador) deve ser (ddddd-d), onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
39D98443	400	requisicao	Banco Itaú - Campo ({property-path}) - O formato do convênio deve ser (ddddd), mínimo 1 dígito e máximo 5 dígitos, onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
40D4CE06	400	requisicao	Banco Bradesco - Campo ({property-path}) - A carteira deve ser um número de 1 a 99, mas o informado foi (${validatedValue}).
4210BC95	400	requisicao	Banco Caixa Econômica Federal - Campo ({property-path}) - O formato do convênio é de até 7 dígitos (6 dígitos + dígito verificador) e deve ser (dddddd-d), onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
42DCC66F	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - O formato do convênio é de até 7 dígitos (6 dígitos + dígito verificador) e deve ser (dddddd-d), onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
46C1E586	400	requisicao	Banco Caixa Econômica Federal - {0}, (carteira {1}) - Campo ({2}) - O formato do convênio é de até 7 dígitos (6 dígitos + dígito verificador) e deve ser (dddddd-d), onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi ({3}).
48B837BE	400	requisicao	Banco CREDISIS - Campo ({0}) - Deve ser um número de até 3 dígitos (1 a 999), mas o informado foi ({1}).
48BE9442	400	requisicao	Banco Cresol - Campo ({0}) - Não suportado pelo banco.
4B27CCAE	400	requisicao	Banco Caixa Econômica Federal - Campo ({property-path}) - A carteira deve ser um número de 1 a 82, mas o informado foi (${validatedValue}).
576E8251	400	requisicao	Banco Inter - Campo ({0}) - Deve ser informado 30 ou 60, mas o informado foi ({1}).
5EF9A2FF	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - A carteira deve ser um número de 1 a 9, mas o informado foi (${validatedValue}).
66BE2C3C	400	requisicao	Banco Bradesco - Campo ({0}) - Deve ser um número de até 2 dígitos (1 a 99), mas o informado foi ({1}).
70CB1A2E	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - O formato do número da conta é de até 13 dígitos (12 dígitos + dígito verificador) e deve ser (dddddddddddd-d), onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
7D2B52D8	400	requisicao	Banco ABC Brasil - Campo ({0}) - Não suportado pelo banco.
7EF72CBF	400	requisicao	Banco Safra - Campo ({0}) - Deve ser um número de 1 a 90, mas o informado foi ({1}).
7FFA819B	400	requisicao	Banco Sofisa - Campo ({0}) - Não suportado pelo banco.
821B8397	400	requisicao	Banco do Brasil - Campo ({0}) - Suportado apenas no layout CNAB 400 ou para contas com registro online.
8491BB67	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - A modalidade deve ser um número de 1 a 99, mas o informado foi (${validatedValue}).
8C9C6E3D	400	requisicao	Banco Arbi - Campo ({0}) - Não suportado pelo banco.
8CE3D858	400	requisicao	Banco Daycoval - Campo ({0}) - Não suportado pelo banco.
90A5B851	400	requisicao	Banco Bradesco - Campo ({property-path}) - O formato do número da conta de 8 dígitos (7 dígitos + dígito verificador) deve ser (ddddddd-D), onde (d) = numérico, representa um dígito numérico de zero a nove e (D) = alfanumérico, representa um dígito numérico de zero a nove ou a letra (P), mas o informado foi (${validatedValue}).
9334A51F	400	requisicao	Banco Bradesco - Campo ({property-path}) - O formato da agência de 5 dígitos (4 dígitos + dígito verificador) deve ser (dddd-D), onde (d) = numérico, representa um dígito numérico de zero a nove e (D) = alfanumérico, representa um dígito numérico de zero a nove ou a letra (P), mas o informado foi (${validatedValue}).
96BB050C	400	requisicao	Banco Itaú - Campo ({property-path}) - A carteira deve ser um número de 1 a 999, mas o informado foi (${validatedValue}).
970B4782	400	requisicao	Banco Bradesco - Campo ({property-path}) - A carteira deve ser um número de 1 a 99, mas o informado foi (${validatedValue}).
980D273F	400	requisicao	Banco Caixa Econômica Federal - Campo ({property-path}) - O formato da agência de 4 dígitos deve ser (dddd), mínimo 1 dígito e máximo 4 dígitos, onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
9A155609	400	requisicao	Banco Itaú - Carteira Especial {0} - Campo ({1}) - O Número do Documento (Seu Número) deve ser um número de 1 a 9.999.999, mas o informado foi ({2}).
A2201A5A	400	requisicao	Banco Cecred - Campo ({0}) - Deve ser um número de até 3 dígitos (1 a 999), mas o informado foi ({1}).
A4A2909A	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - O formato da agência de 5 dígitos (4 dígitos + dígito verificador) e deve ser (dddd-d), onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
ABB6DF37	400	requisicao	Banco BANCOOB/SICOOB - Campo ({0}) - Não suportado pelo banco.
ABFEAFC3	400	requisicao	Banco Itaú - Campo ({property-path}) - O formato da agência de 4 dígitos deve ser (dddd), mínimo 1 dígito e máximo 4 dígitos, onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi (${validatedValue}).
ADB75BA0	400	requisicao	Banco do Brasil - Campo ({0}) - Deve ser um número de até 3 dígitos (1 a 999), mas o informado foi ({1}).
AF9D9DC7	400	requisicao	Banco Caixa Econômica Federal - Campo ({property-path}) - O número/código da operação deve ser um número de 0 a 999, mas o informado foi (${validatedValue}).
C065FB41	400	requisicao	Banco Caixa Econômica Federal - {0}, (carteira {1}) - Campo ({2}) - O formato do convênio é de até 6 dígitos (5 dígitos + dígito verificador) e deve ser (ddddd-d), onde (d) = numérico, representa um dígito numérico de zero a nove, mas o informado foi ({3}).
C2CAFAF5	400	requisicao	Banco Santander - Campo ({0}) - Deve ser um número de até 2 dígitos (1 a 99), mas o informado foi ({1}).
C5DF4625	400	requisicao	Banco Itaú - Campo ({property-path}) - A carteira deve ser um número de 1 a 999, mas o informado foi (${validatedValue}).
C8BD3219	400	requisicao	Banco de Brasília - Campo ({0}) - Deve ser um número de até 3 dígitos (1 a 999), mas o informado foi ({1}).
CA753126	400	requisicao	Banco Caixa Econômica Federal - Campo ({0}) - Refere-se a uma carteira ({1}) não suportado. As carteiras atualmente suportadas para este banco são: ({2}).
CB301301	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - A modalidade deve ser um número de 1 a 99, mas o informado foi (${validatedValue}).
CCEEF6C0	400	requisicao	Banco Caixa Econômica Federal - Campo ({property-path}) - O número/código da operação deve ser um número de 0 a 999, mas o informado foi (${validatedValue}).
CD89E306	400	requisicao	Banco Inter - Campo ({0}) - Deve ser um número de 1 a 60, mas o informado foi ({1}).
D285ADDA	400	requisicao	Banco Bradesco - Campo ({0}) - Não suportado para contas com registro online.
D8018697	400	requisicao	Banco CREDISAN - Campo ({0}) - Deve ser informado 15 ou 30 dias, mas o informado foi ({1}).
E7EC8677	400	requisicao	Banco Caixa Econômica Federal - {0}, (carteira {1}) - Campo ({2}) - O número/código da operação deve ser um número de 1 a 999, mas o informado foi ({3}).
EFC7ECAC	400	requisicao	Banco Caixa Econômica Federal - Campo ({0}) - Deve ser um número entre 5 e 120, mas o informado foi ({1}).
EFCEC907	400	requisicao	Banco Sicredi - Campo ({0}) - Não suportado pelo banco.
EFFF4970	400	requisicao	Banco Unicred - Campo ({0}) - Não suportado pelo banco.
F704EADF	400	requisicao	Banco Banrisul - Campo ({0}) - Deve ser um número de até 2 dígitos (1 a 99), mas o informado foi ({1}).
FEC7D579	400	requisicao	Banco BANCOOB/SICOOB - Campo ({property-path}) - O código da modalidae está ausente, mas é obrigatório.

Conflitos

O que fazer. Veja Idempotência, Idempotência no lote e Processar retorno. O GET indicado nas mensagens 7A31E5C2 e D2691CCA é a rota Obter retorno, do plano Personalizado; no plano Grátis, essa chamada responde 403 com o código 8D1C5814.

Código	HTTP	Tipo	Mensagem
2B257710	409	conflito	Campo ({0}) - Conflito de dados, já existe um boleto com o mesmo conteúdo ({1}) para este campo, localizado em ({2}).
2B258820	409	conflito	Campo({0}):Conteúdo({1})
5090FAB2	409	conflito	Campo ({0}) - Conflito de dados, já existe uma baixa para este boleto realizada na data ({1}) e com motivo definido ({2}).
5C1D9F04	409	conflito	Campo ({0}) - Conflito de dados, já existe um lote de boletos com a mesma chave de controle ({1}), localizado em ({2}).
5C1DA015	409	conflito	Campo({0}):Conteúdo({1})
7A31E5C2	409	conflito	Conflito de dados, este arquivo retorno, com token ({0}), já está em processamento por uma chamada anterior ainda em andamento; aguarde a conclusão e, se necessário, obtenha o resultado com o método GET no endpoint /api/v1/arquivos/cnab/retornos/{0}
D2691CCA	409	conflito	Conflito de dados, este arquivo retorno, com token ({0}), já foi processado em ({1}), com o nome ({2}); caso deseje obter o resultado do processamento deste arquivo, realize uma nova chamada com método GET para o endpoint /api/v1/arquivos/cnab/retornos/{0}

Lote e carnê

O que fazer. Ajuste a requisição de lote ou carnê conforme a mensagem. Veja Boletos em lote.

Código	HTTP	Tipo	Mensagem
4494F0A2	400	requisicao	Requisição recusada, o limite máximo de boletos permitido para um batch é ({0}), porém o batch enviado contém ({1}).
A7C4B21E	400	requisicao	Campo (batch.tokenControleUsuario) - A chave de controle do lote é um campo alphanumérico de até 44 posições sem caracteres especiais, com exceção de: - (hífen), _ (underline) e = (sinal de igual); o conteúdo fornecido ({0}) não é válido.
3F8A5D16	404	requisicao_para_recurso_nao_encontrado	Carnê com token ({0}) não encontrado.
7B41C2E9	404	requisicao_para_recurso_nao_encontrado	Lote de boletos com token ({0}) não encontrado.

CNAB

O que fazer. Confira o arquivo, o token ou o parâmetro indicados na mensagem. Veja Arquivos CNAB.

Código	HTTP	Tipo	Mensagem
0A48FC17	400	requisicao	Arquivo retorno processado com erro ({0}).
1E038C5C	400	requisicao	Arquivo retorno não informado.
42D6B8F7	400	requisicao	Token identificador da remessa não informado.
61BAFF28	400	requisicao	Upload inválido. Certifique-se de que o arquivo foi informado corretamente, a requisição deve ser um UPLOAD do tipo "Content-Type: multipart/form-data" em que o arquivo é informado com o parâmetro de nome "arquivo".
7D2D0FC0	400	requisicao	Token identificador do retorno não informado.
ABF66CAD	400	requisicao	O token identificador da remessa fornecido ({0}) está incorreto ou inválido.
B9E2562C	400	requisicao	Arquivo ausente. Certifique-se de que o arquivo foi informado corretamente, a requisição deve ser um UPLOAD do tipo "Content-Type: multipart/form-data" em que o arquivo é informado com o parâmetro de nome "arquivo".
E41B5069	400	requisicao	O token identificador do retorno fornecido ({0}) está incorreto ou inválido.

Veja Também

Status e ErrosCódigos HTTP da API e o formato do corpo de erro

Planos & APIO que os planos Grátis e Personalizado cobrem nas rotas

IdempotênciaComo o token de controle evita boleto duplicado

Campos do boletoReferência dos campos enviados na criação do boleto