get https://sandbox.auth.flowfinance.com.br/v1/postings
Esse endpoint é responsável por retornar uma lista paginada de solicitações realizadas. É possível realizar uma série de filtros, ordenações e navegar entre as páginas de resultados.
Parâmetros da Requisição
status
(string): Status do processamento da solicitação. Possíveis valores aceitos: PENDING_APPROVAL, EXECUTING, REJECTED, EXPIRED, SCHEDULED, CANCELED, ERROR, SUCCESS.
dateFrom
(datetime): Data de início da criação das solicitações.
dateTo
(datetime): Data de fim da criação das solicitações.
taxpayerId
(string): Nº do CPF ou CNPJ do pagador.
account
(string): ID da conta para consulta das solicitações
name
(string): Nome do participante.
sort
(string): Campo para ordenação dos resultados. Possíveis valores: id, createdAt, scheduledDate, type, amount, status.
Resposta
Se a requisição for processada com sucesso será retornado um código 200 e um JSON no seguinte formato:
content
(object list): Objeto contendo a lista com o resultado do filtro realizado.
- hasNext (boolean): Campo para indicar se tem uma próxima página.
- totalElements (int): Quantidade total de registros retornados para a busca realizada.
- totalPages (int): Quantidade total de páginas retornadas para a busca realizada.
Objeto 'content'
id
(string): ID para identificação da solicitação.
status
(string): Status do processamento da solicitação. Possíveis valores: PENDING_APPROVAL, EXECUTING, REJECTED, EXPIRED, SCHEDULED, CANCELED, ERROR, SUCCESS.
account
(object): Objeto contendo os dados da conta bancária.
account -> id
(string): ID da conta bancária.
account -> branch
(string): Número da agência.
account -> account
(string): Número da conta.
account -> person
(object): Objeto contendo os dados da pessoa, titular da conta.
account -> person -> name
(string): Nome da pessoa.
account -> person -> taxpayerId
(string): Número do CPF da pessoa.
amount
(float): Valor da transação.
type
(string): Tipo da transação.
scheduledDate
(datetime): Data do agendamento para a solicitação.
createdAt
(datetime): Data da criação da solicitação.
review
(object): Objeto contendo os dados referente a parte de revisão da solicitação.
review -> reviewBy
(object): Objeto contendo os detalhes do usuário revisor.
review -> reviewBy -> id
(string, uuid v4): ID do usuário que fez a revisão da solicitação.
review -> reviewBy -> fullName
(string): Nome completo do usuário que fez a revisão da solicitação.
review -> reviewAt
(datetime): Data que foi feita a revisão.
cancel
(object): Objeto contendo os dados referente a parte de cancelamento da solicitação.
cancel -> cancelBy
(object): Objeto contendo os detalhes do usuário que cancelou.
cancel -> cancelBy -> id
(string, uuid v4): ID do usuário que fez o cancelamento da solicitação.
cancel -> cancelBy -> fullName
(string): Nome completo do usuário que fez o cancelamento da solicitação.
cancel -> cancelBy
(datetime): Data que foi feita o cancelamento.
accountDestination
(object): Objeto contendo os dados da conta de destino, se aplicável.
accountDestination -> id
(string): ID da conta bancária.
accountDestination -> branch
(string): Número da agência.
accountDestination -> account
(string): Número da conta.
accountDestination -> name
(string): Nome do beneficiário.
accountDestination -> bank
(string): Código do banco.
accountDestination -> type
(string): Tipo da conta.
accountDestination -> taxpayerId
(string): Número do CPF do beneficiário.
billpaymentBeneficiary
(string): Nome do beneficiário.
billpaymentPayer
(string): Nome do pagador.
barCode
(string): Código de barras no caso de uma solicitação de Boleto.
error
(string): Retorno em caso de algum erro no processamento da solicitação.
Exemplo de JSON:
{
"content": [
{
"id": "<string>",
"status": "EXPIRED",
"account": {
"id": "<string>",
"branch": "<string>",
"account": "<string>",
"person": {
"name": "<string>",
"taxpayerId": "<string>"
}
},
"amount": "<number>",
"type": "TED",
"scheduledDate": "<string>",
"createdAt": "<dateTime>",
"error": "<string>",
"review": {
"reviewedBy": {
"id": "<uuid>",
"fullName": "<string>"
},
"reviewedAt": "<string>"
},
"accountDestination": {
"id": "<string>",
"name": "<string>",
"bank": "<string>",
"branch": "<string>",
"account": "<string>",
"type": "<string>",
"taxpayerId": "<string>"
},
"billpaymentBeneficiary": "<string>",
"billpaymentPayer": "<string>",
"barCode": "<string>"
}
],
"hasNext": "<boolean>",
"totalElements": "<number>",
"totalPages": "<number>"
}