Falha na Geração da CCB

Categoria: CCB
Evento: Falha na Geração da CCB

Nome do Evento

CCB_GENERATION_FAILED

Disparado quando POST /credit-operations/{externalContractId}/ccb não consegue concluir a geração da CCB (transição CCB_REQUESTED → CCB_GENERATION_FAILED).

Estrutura do Payload

{
  "eventType": "string",
  "entityId": "uuid",
  "occurredAt": "date-time",
  "data": {
    "id": "uuid",
    "externalContractId": "string",
    "status": "CCB_GENERATION_FAILED",
    "ccbDocumentId": null,
    "ccbGeneratedAt": null,
    "updatedAt": "date-time"
  }
}

Tabela de Descrição dos Campos

Campo	Tipo	Descrição
`eventType`	string	Sempre `"CCB_GENERATION_FAILED"`.
`entityId`	uuid	ID interno da operação de crédito.
`occurredAt`	datetime	Momento em que a falha ocorreu (UTC).
`data.status`	enum	`CCB_GENERATION_FAILED`.
`data.ccbDocumentId`	null	Permanece nulo — nenhum documento foi gerado.
`data.ccbGeneratedAt`	null	Permanece nulo.

Exemplo de Payload

{
  "eventType": "CCB_GENERATION_FAILED",
  "entityId": "8f14e45f-ceea-467e-95b7-1c9f4e6d4a6b",
  "occurredAt": "2026-08-06T14:05:33Z",
  "data": {
    "id": "8f14e45f-ceea-467e-95b7-1c9f4e6d4a6b",
    "externalContractId": "ctr-98421",
    "status": "CCB_GENERATION_FAILED",
    "ccbDocumentId": null,
    "ccbGeneratedAt": null,
    "updatedAt": "2026-08-06T14:05:33Z"
  }
}

Próximos passos

Uma operação em CCB_GENERATION_FAILED não avança automaticamente — trate como um estado a ser investigado (dados do tomador, disponibilidade do serviço de geração de documentos) antes de tentar novamente ou cancelar a operação via POST /credit-operations/{externalContractId}/cancel.