Qualificação de Operações

Visão Geral

A qualificação é uma etapa opcional do fluxo de crédito direto, configurada no produto para que o originador aprove manualmente o desembolso após a assinatura da CCB pelo tomador.

Quando ativa, a operação avança para o status PENDING_QUALIFICATION após a assinatura e aguarda a aprovação do originador antes de seguir para PENDING_DISBURSEMENT.

Fluxo com qualificação

PENDING_SIGNATURE → PENDING_QUALIFICATION → PENDING_DISBURSEMENT → ISSUED

Endpoints

1. Listar operações pendentes de qualificação

Retorna todas as operações do produto que estão aguardando aprovação.

GET /banking/originator/products/{product_id}/qualification-requests

Query parameters

Parâmetro	Tipo	Obrigatório	Descrição
`application_id`	`string (uuid)`	Não	Filtra por uma operação específica

Exemplo de request

curl --request GET \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/products/{product_id}/qualification-requests' \
  --header 'Authorization: Bearer {token}'

Exemplo de response

{
  "content": [
    {
      "id": "95164dd2-0920-4c70-b24b-269aef115426",
      "status": "pending_approval",
      "role": "APPLICATION",
      "borrower": {
        "id": "d43cb69e-aaad-4392-9781-ac441196175b",
        "name": "Srta. Alexia Cavalcante"
      },
      "application": {
        "id": "8abede41-69f2-4da3-a61d-592a110d4d00",
        "status": "PENDING_QUALIFICATION",
        "requested_amount": 200,
        "num_payments": 12,
        "first_payment_date": "2026-05-24"
      },
      "product": {
        "id": "820ad764-9de9-4997-851b-8dc23b0d8a87",
        "name": "[O teste final do felps] Crédito Pessoal"
      },
      "created_at": "2026-04-24T19:25:59.503447Z"
    }
  ],
  "page": 0,
  "size": 25,
  "total_pages": 1,
  "total_elements": 1,
  "has_next": false
}

O campo id retornado em cada item do array é o qualification_id, utilizado para aprovar a operação.

2. Aprovar qualificação

Aprova uma operação pendente de qualificação. Após a aprovação, a operação avança para PENDING_DISBURSEMENT.

PUT /banking/originator/products/{product_id}/qualification-requests/{qualification_id}/qualify

Path parameters

Parâmetro	Tipo	Descrição
`product_id`	`string (uuid)`	ID do produto
`qualification_id`	`string (uuid)`	ID retornado na listagem de qualification-requests

Body

{
  "status": "QUALIFIED"
}

Campo	Tipo	Valores aceitos
`status`	`string`	`QUALIFIED`, `REJECTED`

Exemplo de request

curl --request PUT \
  'https://sandbox.platform.flowfinance.com.br/banking/originator/products/{product_id}/qualification-requests/{qualification_id}/qualify' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{"status": "QUALIFIED"}'

Observações

A aprovação é sempre individual — não existe endpoint de aprovação em lote.
Para aprovar múltiplas operações, é necessário iterar sobre o array content da listagem e disparar o PUT para cada qualification_id.
O campo status aceita REJECTED para rejeitar a operação, impedindo o desembolso.