Cenários práticos
Nesta página
Proposta com os dados que você já temLink perdido antes de o cliente terminarPedido de dados depois do envioVeja o que muda nos três casos que mais geram dúvida na integração.
Proposta com os dados que você já tem
O cliente já tem cadastro na sua aplicação, e você não quer que ele digite tudo de novo. Mande o que você tem em prefill, e a jornada abre com esses dados.
| O que muda | Valor | Por quê |
|---|---|---|
prefill.personalData | Nome, nascimento, nome da mãe, e-mail e celular | Os cinco são obrigatórios quando o bloco vai. |
prefill.address | CEP só com dígitos e UF | complement é opcional; os demais campos são obrigatórios. |
prefill.terms | accepted em true | Só se o cliente já aceitou os termos na sua aplicação. |
{
"clientCode": "crm-8813",
"type": "PERSON",
"taxId": "12345678909",
"contact": "5573991699000",
"prefill": {
"personalData": {
"name": "Maria Silva",
"birthDate": "1990-02-02",
"motherName": "Ana Silva",
"email": "maria@exemplo.com.br",
"phone": "5573991699000"
},
"address": {
"postalCode": "06455030",
"street": "Alameda Xingu",
"number": "350",
"neighborhood": "Alphaville Industrial",
"city": "Barueri",
"state": "SP"
}
}
}Campo que veio do cadastro oficial fica travado na jornada.
A jornada confere os dados do titular no cadastro oficial, e o valor de lá vence o do prefill.
Link perdido antes de o cliente terminar
O cliente começou a jornada, parou e não acha mais o link. A proposta ainda está em IN_PROGRESS.
| O que muda | Valor | Por quê |
|---|---|---|
| Rota | Gerar um link da jornada | Nenhuma consulta retorna o link guardado. |
| Link anterior | Para de abrir | Só o link novo vale. |
| Etapas | Não mudam | O cliente volta de onde parou. |
Depois do prazo, o caminho é outra proposta, com outro clientCode.
A emissão é recusada com proposal_expired depois de expiresAt. Na jornada por link, ela também é recusada em análise, com proposal_not_editable, e na proposta encerrada, com proposal_not_open.
Pedido de dados depois do envio
A proposta estava em IN_ANALYSIS e chegou proposal.waiting_data pedindo a foto do verso do documento.
| O que muda | Valor | Por quê |
|---|---|---|
status | WAITING_DATA | A proposta volta ao cliente, com o prazo renovado. |
data.steps[] | ["DOCUMENTS"] | Só as etapas reabertas aceitam correção. |
data.reasons[] | 62, "Envio sem foto necessária (verso)" | Mostre a description ao cliente. |
| Link | O mesmo, ou um novo | Gere outro se o cliente não tiver mais o link. |
- O cliente corrige na jornada e envia de novo; chega outro
proposal.submitted, comdata.resubmittedemtrue. - O reenvio segue na mesma análise, e a decisão chega em
proposal.decided. - O que cada motivo quer dizer está em Envio e análise.