Consulta de boletos

Consulte boletos gerados de acordo com a data de vencimento

154
Importante para Integração Direta Para você conseguir efetuar essa integração é obrigatória a leitura sobre "Utilização das APIs" e recomendada a leitura sobre "Instruções Iniciais" e "Client Credentials e Client ID"

Quais são os requisitos para a utilização desta API?

  • Token: possuir um token de acesso válido é essencial. Caso ainda não tenha gerado um, temos um guia detalhado disponível no tópico Fluxos de Autorização e Autenticação.
  • Boleto: para que a resposta da API seja preenchida, é recomendável que um boleto tenha sido gerado anteriormente.

Bora pro código?

383

Parâmetros da requisição

ParâmetroTipoDescrição
start
opcional
StringData início, no formato YYYY-MM-DD

Atenção
O intervalo de tempo da consulta estará relacionado à data de vencimento da fatura
end
opcional
StringData final, no formato YYYY-MM-DD
state
opcional
StringDescrição dos possíveis estados do boleto
search
opcional
StringCPF/CNPJ do destinatário
page
opcional
IntNúmero da página. Possui valor padrão 1
perPage
opcional
IntNúmero de itens por página. Possui o valor padrão 20

Estados dos boletos

ParâmetroDescrição
CANCELLEDBoletos cancelados
DRAFTBoletos em rascunho, um estado intermediário entre criação e registro
IN_PAYMENTBoletos em processo de pagamento
INITIATEDBoletos iniciados, aguardando a atualização dos próximos passos do fluxo
LATEBoletos com pagamento em atraso, ou seja, após a data de vencimento
OPENBoletos registrados, mas ainda não pagos
PAIDBoletos que foram pagos com sucesso
RECURRENCE_DRAFTBoletos criados com recorrência que nos quais o usuário não deu andamento à criação da cobrança

Parâmetros da resposta

ParâmetroTipoDescrição
totalItems
obrigatório
IntTotal de items retornados na lista
items
obrigatório
Lista de StringsLista de objetos Invoice

Dicas de implementação

188

Premissas

O parâmetro start e o parâmetro end são usados para especificar o intervalo de tempo desejado na consulta. É importante notar que as datas inseridas no parâmetro end devem ser maiores que as datas informadas no parâmetro start

Erros Comuns

Código de erroDescrição
401 (Unauthorized)O token de acesso está inválido ou expirado. Erro comum no momento de trocas de ambientes (Stage/Production)
400 (Bad Request)Requisição mal formatada. Alguns exemplos comuns:

- State que não está entre os estados descritos em estados do boleto

- O Start e/ou End está com o formato errado. Para garantir que as informações sejam interpretadas e processadas corretamente pelo sistema, é essencial inseri-las no formato YYYY-MM-DD. Um exemplo prático pode ajudar a entender melhor: suponha que você deseja consultar os boletos a partir do dia 15 de janeiro de 2023. Neste caso, a data deve ser informada como 2023-01-15

Integração Direta e Testes

Esta plataforma de documentação, atualmente, não permite o upload de informações importantes como certificados e private keys. Por isso, não recomendamos o uso dela para testes da modalidade de Integração Direta.

Para fazer os testes que incluam essas informações sensíveis pedimos que use um sistema de sua escolha.
Caneca na cor rosa com a logo da Cora e com forma geométrica
Agora é hora do Café! Sim, aprendemos a consultar boletos
Language
Authorization
OAuth2
Click Try It! to start a request and see the response here!