Extrato de Recebíveis

O Extrato de Recebíveis é o endpoint responsável por exibir o detalhamento das movimentações que ocorrem dentro do módulo de recebíveis (subadquirência), como recebimentos de cartão de crédito e débito, tarifas, descontos, estornos e chargebacks.

Esse extrato não deve ser confundido com o extrato da conta BaaS. São dois recursos com finalidades distintas:

Em outras palavras, o extrato da conta BaaS mostra o resultado (o saldo que chegou na conta), enquanto o Extrato de Recebíveis mostra a origem desse resultado (o que gerou aquele saldo).

Regra de Negócio

Ao longo do dia, a Celcoin realiza operações de consolidação do saldo disponível na conta de recebíveis do cliente, transferindo esse saldo para a conta BaaS correspondente.

Alguns pontos importantes sobre esse fluxo:

• Essas movimentações chegam na conta BaaS com o movement type Transferência Interna. É assim que o valor aparecerá no extrato da conta BaaS.
• Esse comportamento é o mesmo independentemente de a transação de origem ser uma transação de split ou não.
• A transferência do saldo consolidado para a conta BaaS é realizada às 12h e às 19h.

Para entender o que compôs esse valor consolidado, o cliente consulta o Extrato de Recebíveis, que traz o detalhamento de cada movimentação individual através do campo friendlyDescriptor.

Exemplo de Request

Modelo de requisição:

curl --request GET \
     --url 'https://sandbox.openfinance.celcoin.dev/baas/v1/cash/companies/numberAccount/receivables-statement?startDate=2026-07-01&endDate=2026-07-13&page=1&perPage=20' \
     --header 'accept: application/json'

Campos do Request

Exemplo de Response

Sucesso (200):

{
  "version": "1.0.0",
  "status": 200,
  "body": {
    "totalPages": 1,
    "totalItems": 3,
    "page": 1,
    "perPage": 20,
    "movements": [
      {
        "idTransaction": 5501,
        "movementType": "CREDITO",
        "amount": 1500.00,
        "dateInclusion": "2026-07-09T10:32:00Z",
        "friendlyDescriptor": "Recebimento Cartão de Crédito - Transação 5501",
        "companyId": null
      },
      {
        "idTransaction": 5501,
        "movementType": "DEBITO",
        "amount": 45.00,
        "dateInclusion": "2026-07-09T10:32:00Z",
        "friendlyDescriptor": "Tarifa Cartão de Crédito - Transação 5501",
        "companyId": null
      },
      {
        "idTransaction": 5502,
        "movementType": "CREDITO",
        "amount": 980.00,
        "dateInclusion": "2026-07-09T11:05:00Z",
        "friendlyDescriptor": "Recebimento Cartão de Crédito - Split - Transação 5502 - Conta 123456",
        "companyId": "123456"
      }
    ]
  }
}

Campos do Response

Possíveis Responses

Erro status code 400:

{ "version": "1.0.0", "status": 400, "error": { "errorCode": "BSPREC0400", "message": "Parâmetros de data inválidos ou período não informado." } }

Erro status code 404:

{ "version": "1.0.0", "status": 404, "error": { "errorCode": "BSPREC0404", "message": "Nenhuma movimentação encontrada para o período informado." } }

Erro status code 422:

{ "version": "1.0.0", "status": 422, "error": { "errorCode": "BSPREC0422", "message": "Conta informada inválida ou não habilitada para consulta de recebíveis." } }

Significado de Cada Possível friendlyDescriptor

O campo friendlyDescriptor indica a natureza da movimentação retornada no extrato de recebíveis. Abaixo estão os padrões possíveis e o que cada um representa.

Cartão (subadquirência, sem split)

Split (master ou subconta)

Nesses casos, {meio} representa o meio de pagamento utilizado, por exemplo Cartão de Crédito, e {companyId} identifica a subconta envolvida na movimentação.

Transferência interna (crédito consolidado na conta BaaS)

Esses descritores aparecem no extrato da conta BaaS, referentes ao crédito do saldo consolidado de recebíveis na conta do cliente.