> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# receivables.synced

> Evento emitido após sincronização de recebíveis

`receivables.synced` é emitido depois que [Receivable](/data-modelling/billing/receivable) é sincronizado.

Handlers usam este evento para executar efeitos assíncronos fora do fluxo síncrono.

## Detalhes do Evento

| Propriedade    | Valor                                        |
| -------------- | -------------------------------------------- |
| **Tipo**       | `receivables.synced`                         |
| **Origem**     | Webhook ou scheduler de billing              |
| **Publicação** | Após commit do Receivable                    |
| **Quando**     | Recebíveis são sincronizados com o provider. |

## Handlers

| Handler                            | Responsabilidade                | Dados usados | Execução    |
| ---------------------------------- | ------------------------------- | ------------ | ----------- |
| `run-receivable-sync-side-effects` | Atualiza projeções financeiras. | `data`       | Assíncrona. |

## Payload

| Campo  | Tipo         | Descrição                        |
| ------ | ------------ | -------------------------------- |
| `data` | `Receivable` | Entidade Receivable sincronizada |

## Regras dos handlers

* Handlers não rodam na transação que publicou o Receivable.
* Falha em handler não desfaz o Receivable.
* Cada handler deve ser idempotente.
* Novos handlers podem ser adicionados sem mudar o fluxo síncrono.

## Exemplo

```json theme={null}
{
  "type": "receivables.synced",
  "data": {
    "receivableId": "0197a817-5fb6-7ed8-a75e-27cc15afd0ac",
    "paymentId": "0197a816-281b-72e7-8f50-286fbfc5c08d",
    "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
    "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
    "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"
  }
}
```
