Webhooks
Os webhooks do cadastro são enviados a todos os agentes com acesso ao cadastro do cedente (gestora, consultoria e cedente) que tenham webhook configurado. Cadastros originados por carga da Fromtis (fromtis_load) não disparam webhook. Assinatura, reenvio e configuração: veja Autenticação de Webhooks.
Webhooks de Análise
webhook_type: assignor_registry.analysis_status_change
Derivação para Compliance
{
"data":{
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"analysis_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"analysis_status": "in_manual_analysis",
"reproval_reason": null,
"reproval_details": null
},
"webhook_type":"assignor_registry.analysis_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}
Em análise de Documentos
{
"data":{
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"analysis_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"analysis_status": "pending_internal_validation",
"reproval_reason": null,
"reproval_details": null
},
"webhook_type":"assignor_registry.analysis_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}
Aprovado
{
"data":{
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"analysis_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"analysis_status": "approved",
"reproval_reason": null,
"reproval_details": null
},
"webhook_type":"assignor_registry.analysis_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}
Reprovado
{
"data":{
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"analysis_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"analysis_status": "reproved",
"reproval_reason": "insuficient_documents",
"reproval_details": "Anexar procuração do sócio XXX.XXX.XXX-XX."
},
"webhook_type":"assignor_registry.analysis_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}
Cancelado
Disparado quando uma análise é cancelada. O caso mais comum é o cancelamento automático por inatividade: uma análise que fica 1 mês sem movimentação — tipicamente parada em pending_documents, sem documentos anexados ou sem o disparo da análise — é cancelada pela QI Tech.
O status é terminal. Para retomar o cadastro, gere uma nova análise por meio da Atualização de Cadastro.
{
"data":{
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"analysis_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"analysis_status": "canceled",
"reproval_reason": null,
"reproval_details": null
},
"webhook_type":"assignor_registry.analysis_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}
Webhooks de Apontamento
webhook_type: assignor_registry.annotation_status_change
Disparados sempre que um Apontamento de Compliance tem seu status alterado. São enviados quando o apontamento é aberto (open) e quando é respondido (closed).
Apontamentos originados por carga da Fromtis (fromtis_load) não disparam webhook.
Apontamento aberto
{
"data":{
"annotation_key": "1f2e3d4c-5b6a-4c8d-9e0f-1a2b3c4d5e6f",
"analysis_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"annotation_status": "open",
"message": "Anexar procuração do sócio XXX.XXX.XXX-XX."
},
"webhook_type":"assignor_registry.annotation_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}
Apontamento respondido
{
"data":{
"annotation_key": "1f2e3d4c-5b6a-4c8d-9e0f-1a2b3c4d5e6f",
"analysis_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"annotation_status": "closed",
"message": "Anexar procuração do sócio XXX.XXX.XXX-XX."
},
"webhook_type":"assignor_registry.annotation_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}
Webhooks de Cadastro
webhook_type: assignor_registry.assignor_registry_status_change. Enviado uma única vez, quando o cedente é efetivado (registered).
Cedente ativado
{
"data":{
"assignor_registry_key": "35ff6e5c-a3e7-4b04-a8be-6e49a3a906e4",
"status": "registered"
},
"webhook_type":"assignor_registry.assignor_registry_status_change",
"webhook_datetime":"2025-01-22T20:30:23Z"
}