Receivable

​

Campos

​

Relacionamentos

• Relaciona-se com Payment.
• Relaciona-se com Organization.
• Relaciona-se com Cooperative.

​

Regras de Negócio

• O paymentId é obrigatório — todo recebível é rastreável ao pagamento que o originou.
• organizationId e cooperativeId identificam a cooperativa beneficiária do recebível.
• O gatewayFeeRate e gatewayFee são dinâmicos — reportados pelo provedor de pagamento na sincronização, não pré-configurados.
• O valor (amount) é o valor líquido reportado para o recebível em centavos.
• O par externalProvider + externalProviderId evita duplicidade na sincronização com o provedor.
• O saldo disponível para saque é consultado diretamente no provedor; recebíveis e transferências não possuem vínculo individual.
• Crédito corporativo usado em ticket não muda o beneficiário operacional do recebível: o ticket continua vinculado à cooperativa.

​

Sincronização de Recebíveis

​

Enums

​

ReceivableStatus

​

Example

{
  "receivableId": "0197a817-5fb6-7ed8-a75e-27cc15afd0ac",
  "paymentId": "0197a816-281b-72e7-8f50-286fbfc5c08d",
  "organizationId": "0197a7f7-7291-7a43-96db-2c8580b80c5d",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "externalProvider": "billing_interface",
  "externalProviderId": "recvb_9fa13571",
  "amount": 11001,
  "gatewayFeeRate": 350,
  "gatewayFee": 399,
  "status": "WAITING_FUNDS",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T16:02:30.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T16:02:30.000Z"
}