Mudança de Status da Operação de Crédito

Categoria: Operação de Crédito
Evento: Mudança de Status da Operação de Crédito

Nome do Evento

CREDIT_OPERATION_STATUS_CHANGED

Disparado sempre que o campo status de uma CreditOperation muda — veja a máquina de estados completa em Máquina de Estados. Este é o evento mais frequente do ciclo de vida: uma mesma operação pode gerar várias notificações deste tipo até chegar a DISBURSED.

Estrutura do Payload

{
  "eventType": "string",
  "entityId": "uuid",
  "occurredAt": "date-time",
  "data": {
    "id": "uuid",
    "externalContractId": "string",
    "status": "CreditOperationStatus",
    "approvedAt": "date-time | null",
    "ccbGeneratedAt": "date-time | null",
    "signedCcbReceivedAt": "date-time | null",
    "disbursementRequestedAt": "date-time | null",
    "...": "demais campos de CreditOperation (ver evento CREDIT_OPERATION_CREATED)",
    "updatedAt": "date-time"
  }
}

Tabela de Descrição dos Campos

Campo	Tipo	Descrição
`eventType`	string	Sempre `"CREDIT_OPERATION_STATUS_CHANGED"`.
`entityId`	uuid	ID interno da operação de crédito.
`occurredAt`	datetime	Momento em que a transição ocorreu (UTC).
`data.status`	enum	Novo status da operação após a transição.
`data.updatedAt`	datetime	Igual a `occurredAt` — timestamp da última atualização do registro.
`data.*`	—	Os demais campos seguem exatamente a estrutura de `CreditOperation` (idêntica à resposta de `GET /credit-operations/{externalContractId}`); apenas os campos relevantes à transição (ex: `approvedAt`, `ccbGeneratedAt`) vêm preenchidos.

Exemplo de Payload

Exemplo de transição RECEIVED → APPROVED:

{
  "eventType": "CREDIT_OPERATION_STATUS_CHANGED",
  "entityId": "8f14e45f-ceea-467e-95b7-1c9f4e6d4a6b",
  "occurredAt": "2026-08-06T13:10:47Z",
  "data": {
    "id": "8f14e45f-ceea-467e-95b7-1c9f4e6d4a6b",
    "externalContractId": "ctr-98421",
    "status": "APPROVED",
    "approvedAt": "2026-08-06T13:10:47Z",
    "ccbDocumentId": null,
    "ccbGeneratedAt": null,
    "signedCcbDocumentId": null,
    "signedCcbReceivedAt": null,
    "disbursementRequestedAt": null,
    "kycStatus": null,
    "updatedAt": "2026-08-06T13:10:47Z"
  }
}