Histórico KYB de empresas: sessões e relatórios

Cada sessão de Verificação de empresas (KYB) executada por uma entidade Business fica permanentemente associada à entidade Business. Pode obter o histórico completo, consultar os dados do registo e as correspondências AML de cada sessão, acionar uma reverificação e gerar relatórios em PDF para auditorias.

Listar todas as sessões de Verificação de empresas (KYB) de uma empresa

Filtre a lista de sessões por vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"

A resposta inclui todas as sessões de Verificação de empresas (KYB), independentemente do estado.

Compreender as funcionalidades KYB

Uma sessão KYB executa estas funcionalidades, e cada uma tem o seu próprio estado na decisão da sessão:

Funcionalidade	O que abrange
`KYB_REGISTRY`	Consulta ao registo de empresas: existência, estado, validação cruzada da identidade
`AML`	Triagem AML ao nível da empresa (sanções, notícias adversas, listas de vigilância)
`KYB_DOCUMENTS`	Recolha de documentos e validação cruzada por OCR
`KYB_KEY_PEOPLE`	Dirigentes, UBOs e beneficiários efetivos: identificação e KYC opcional

O mapa features da entidade Business contém apenas o estado mais recente da verificação da empresa:

"features": {
  "KYB": "Approved"
}

Consulte Estados das funcionalidades KYB para a referência completa.

Inspecionar uma sessão individual de Verificação de empresas (KYB)

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

A decisão KYB inclui:

Dados do registo da empresa (denominação legal, número de registo, estado, data de constituição, moradas)
Dirigentes e UBO extraídos do registo
Estrutura de propriedade (tabela de capital, percentagens de propriedade efetiva)
Resultados AML da empresa (correspondências, pontuações)
Resultados AML por pessoa para cada UBO e dirigente
Resultados dos documentos com extratos OCR
Códigos de motivo da decisão

Consulte o Esquema da resposta KYB para o payload completo.

Acionar a reverificação

A reverificação KYB anual, as reverificações acionadas por eventos e os fluxos de correção começam todos com uma nova sessão:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyb_annual",
    "vendor_data": "biz-acme"
  }'

A nova sessão fica associada à entidade Business existente e atualiza o mapa features quando for concluída.

Reenvio ou nova sessão de Verificação de empresas (KYB)

Cenário	Utilizar
A consulta ao registo precisa de um nome de empresa corrigido	Reenviar: o analista edita os dados e repete a consulta ao registo
É solicitado um documento adicional à empresa	Reenviar: a empresa carrega o documento em falta
KYB anual ou acionado por eventos	Criar uma nova sessão

Exportar um relatório KYB

Gere um PDF completo para qualquer sessão de Verificação de empresas (KYB):

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o kyb-report.pdf

O PDF inclui os dados do registo, a estrutura de propriedade, as correspondências AML, as imagens dos documentos, o estado KYC dos dirigentes e uma capa com o motivo da decisão.

Partilhar uma sessão de Verificação de empresas (KYB)

Para fluxos de trabalho de consórcios ou parceiros:

POST /v3/session/{session_id}/share/: gera um token partilhável.
POST /v3/session/import-shared/: importa a sessão do lado do destinatário.

Monitorização contínua

As entidades Business em modo de monitorização contínua recebem reanálises AML periódicas. Quando é detetada uma nova correspondência em listas de sanções ou em notícias adversas, a triagem AML da empresa é atualizada; leia-a em aml_screenings[] na decisão da sessão. Configure a monitorização contínua na consola em Workflows → [KYB workflow] → AML → Ongoing monitoring.

Próximos passos

Visão geral do KYB

Como funcionam as sessões de Verificação de empresas (KYB) de ponta a ponta.

Resposta KYB

Referência completa do payload da decisão.

Pessoas-chave

Dirigentes, UBOs e utilizadores associados.

Última modificação em 7 de novembro de 2026

Visão geral

Preços

Fluxos e verificação

Revisão e operações

Entidades (utilizadores e empresas)

Definições e personalização

Segurança e conformidade

Didit Academy

Recursos

Histórico KYB de empresas: sessões e relatórios

Listar todas as sessões de Verificação de empresas (KYB) de uma empresa

Compreender as funcionalidades KYB

Inspecionar uma sessão individual de Verificação de empresas (KYB)

Acionar a reverificação

Reenvio ou nova sessão de Verificação de empresas (KYB)

Exportar um relatório KYB

Partilhar uma sessão de Verificação de empresas (KYB)

Monitorização contínua

Próximos passos

Visão geral do KYB

Resposta KYB

Pessoas-chave

​Listar todas as sessões de Verificação de empresas (KYB) de uma empresa

​Compreender as funcionalidades KYB

​Inspecionar uma sessão individual de Verificação de empresas (KYB)

​Acionar a reverificação

​Reenvio ou nova sessão de Verificação de empresas (KYB)

​Exportar um relatório KYB

​Partilhar uma sessão de Verificação de empresas (KYB)

​Monitorização contínua

​Próximos passos

Visão geral do KYB

Resposta KYB

Pessoas-chave

Listar todas as sessões de Verificação de empresas (KYB) de uma empresa

Compreender as funcionalidades KYB

Inspecionar uma sessão individual de Verificação de empresas (KYB)

Acionar a reverificação

Reenvio ou nova sessão de Verificação de empresas (KYB)

Exportar um relatório KYB

Partilhar uma sessão de Verificação de empresas (KYB)

Monitorização contínua

Próximos passos