Campos
| Campo | Tipo | Descrição |
|---|---|---|
receivableId | UUID | Identificador único |
paymentId | UUID | Pagamento que originou o recebível |
organizationId | UUID | Organização da empresa beneficiária |
companyId | UUID | Empresa beneficiária |
externalProvider | string | Provedor de pagamento |
externalProviderId | string | ID do recebível no provedor |
amount | integer | Valor líquido do recebível em centavos |
gatewayFeeRate | integer | Rate do gateway inferido (bps) |
gatewayFee | integer | Valor do gateway reportado pelo provedor (centavos) |
status | ReceivableStatus | Status do recebível |
createdBy | UUID? | Usuário que criou o registro, quando aplicável |
createdAt | datetime | Data de criação |
updatedBy | UUID? | Usuário que fez a última atualização, quando aplicável |
updatedAt | datetime | Data de última atualização |
O saque consulta o saldo diretamente no provedor; recebíveis e transferências não possuem vínculo individual.
ReceivableStatus
O status é copiado do provedor a cada sincronização (defaultWAITING_FUNDS):
| Status | Descrição |
|---|---|
WAITING_FUNDS | Aguardando liquidação no provedor |
PREPAID | Antecipado |
PAID | Liquidado/pago |
CANCELLED | Cancelado |
Sincronização de Recebíveis
O DEVMOB sincroniza recebíveis em dois momentos:- Quando uma cobrança é confirmada pelo provider de billing.
- Pela rotina periódica de Receivables Backfill, para evitar drift entre DEVMOB e provider.
externalProvider + externalProviderId. Se o provider reenviar o mesmo recebível com status ou valores atualizados, o registro é atualizado.
Gateway fee
O provider reporta o valor do gateway fee junto dos recebíveis. O DEVMOB armazena:gatewayFee— valor absoluto em centavos.gatewayFeeRate— rate derivado a partir do valor reportado e do amount do recebível.
Ciclo de Vida
O status efetivo de cada recebível é copiado do provedor a cada sincronização.