Ir para o conteúdo

8.4. Eventos de Proposta e Formalização

Especificação — em construção

Os serviços descritos nesta área ainda não estão disponíveis.

Eventos do trecho final da jornada: envio à bancarizadora, registro, formalização e cancelamento.

O envelope, os headers, a assinatura HMAC e a política de retry estão em 8.1. Visão Geral.

Sequência

credito.proposta.enviada

A proposta entrou em envio. Status 14 — Enviando proposta.

{
  "idWebhook": "019e0896-7a8b-7a45-b037-8c014d24a6e9",
  "tipoEvento": "credito.proposta.enviada",
  "dataHora": "2026-08-20T14:01:11.204Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idEsteira": 12,
    "produto": "ep"
  },
  "etiquetas": null
}

credito.proposta.registrada

A proposta foi registrada na bancarizadora e a CCB foi numerada.

{
  "idWebhook": "019e0897-9c0d-7b56-c148-9d125e35b7fa",
  "tipoEvento": "credito.proposta.registrada",
  "dataHora": "2026-08-20T14:01:48.771Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idContrato": 5001,
    "idEsteira": 12,
    "produto": "ep",
    "numeroCcb": "PROP-2026-004821",
    "dataGeracaoProposta": "2026-08-20T14:01:48Z"
  },
  "etiquetas": null
}
Campo Tipo Descrição
idContrato integer Primeiro momento em que o idContrato existe. Guarde-o: é ele que endereça os serviços de carteira
numeroCcb string Número da Cédula de Crédito Bancário
dataGeracaoProposta string Momento do registro, em UTC

A partir daqui a proposta é imutável

Depois deste evento, simulação, tomador, desembolso, avalistas e garantias não aceitam mais alteração, e a reabertura deixa de ser possível.

credito.proposta.falhou

O registro foi recusado. Status 9 — Falha na inclusão da proposta.

{
  "idWebhook": "019e0898-be1f-7c67-d259-ae236f46c80b",
  "tipoEvento": "credito.proposta.falhou",
  "dataHora": "2026-08-20T14:01:48.771Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idEsteira": 12,
    "produto": "ep",
    "erros": "Valor da operação acima do limite aprovado para o cliente."
  },
  "etiquetas": null
}

🧭 O que fazer ao receber

Leia erros, chame a reabertura, corrija e envie de novo. Como não há CCB gerada, a reabertura é permitida.

credito.assinatura.aguardando

A formalização começou. Os assinantes foram notificados por e-mail pela bancarizadora. Status 5 — Aguardando assinaturas.

{
  "idWebhook": "019e0899-d030-7d78-e36a-bf347057d91c",
  "tipoEvento": "credito.assinatura.aguardando",
  "dataHora": "2026-08-20T14:02:15.008Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idContrato": 5001,
    "produto": "ep",
    "numeroCcb": "PROP-2026-004821",
    "assinantes": [
      { "nome": "João da Silva", "documento": "12345678900", "statusAssinatura": "Pendente" }
    ]
  },
  "etiquetas": null
}

Não há link de assinatura no payload. A jornada de assinatura é conduzida pela bancarizadora — ver 6.9. Assinantes e CCB.

credito.contrato.formalizado

A formalização se concluiu. O contrato está ativo, as parcelas estão geradas e a CCB está disponível para download. Status 6 — Finalizado.

{
  "idWebhook": "019e089a-f141-7e89-f47b-c0455168ea2d",
  "tipoEvento": "credito.contrato.formalizado",
  "dataHora": "2026-08-21T10:14:02.331Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idContrato": 5001,
    "idEsteira": 12,
    "produto": "ep",
    "numeroCcb": "PROP-2026-004821",
    "valorLiquido": 18000.00,
    "valorBruto": 20400.00,
    "quantidadeParcelas": 24,
    "dataPrimeiraParcela": "2026-10-13",
    "dataUltimaParcela": "2028-09-13"
  },
  "etiquetas": null
}

🧭 O que fazer ao receber

  1. GET /credito/propostas/{idProposta}/ccb — agora o PDF está disponível.
  2. GET /credito/contratos/{idContrato}/parcelas — carregue o fluxo para a sua carteira.
  3. Se a esteira tem cobrança interna, avalie gerar as cobranças em 7.4. Cobrança.

credito.contrato.cancelado

A operação foi cancelada. Status 7 — Cancelado.

{
  "idWebhook": "019e089b-1252-7f9a-058c-d1566279fb3e",
  "tipoEvento": "credito.contrato.cancelado",
  "dataHora": "2026-08-22T09:30:44.612Z",
  "grupoEconomico": "MeuGrupo",
  "dados": {
    "idProposta": 1001,
    "idContrato": 5001,
    "produto": "ep",
    "numeroCcb": "PROP-2026-004821",
    "motivo": "Cancelamento solicitado pelo cliente"
  },
  "etiquetas": null
}

O cancelamento pode vir de uma ação sua (proposta em digitação), de um operador na plataforma, ou da própria bancarizadora. Consulte o histórico para saber a origem.

⚠️ Observações

  • A ordem de entrega não é garantida. credito.assinatura.aguardando pode chegar antes de credito.proposta.registrada. Use o evento como gatilho e o GET do recurso como fonte da verdade.
  • idContrato só existe a partir de credito.proposta.registrada. Antes disso, endereço a operação por idProposta.
  • Se você assina apenas um evento desta página, assine credito.contrato.formalizado: é o que marca a operação como receita e libera a carteira.