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

Cada sessão de Verificação de empresas (KYB) que uma empresa realizou permanece vinculada permanentemente à entidade da empresa. Você pode recuperar o histórico completo, inspecionar os dados do registro de empresas e as correspondências de AML de cada sessão, acionar uma reverificação e gerar relatórios em PDF para auditorias.

Como 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 status.

Entendendo os recursos de KYB

Uma sessão de KYB executa os recursos abaixo, e cada um tem seu próprio status na decisão da sessão:

Recurso	O que cobre
`KYB_REGISTRY`	Consulta ao registro de empresas: existência, status e verificação cruzada de identidade
`AML`	Análise AML no nível da empresa (sanções, mídia adversa, listas de monitoramento)
`KYB_DOCUMENTS`	Coleta de documentos e cruzamento de dados por OCR
`KYB_KEY_PEOPLE`	Administradores, UBOs e beneficiários finais: identificação e KYC opcional

O mapa features na entidade empresarial contém apenas o status mais recente da verificação da empresa:

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

Consulte Status dos recursos de KYB para a referência completa.

Como inspecionar uma única sessão 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 de KYB inclui:

Dados do registro de empresas (razão social, registro, status, data de constituição, endereços)
Administradores e UBOs extraídos do registro
Estrutura societária (cap table, percentuais de propriedade dos beneficiários finais)
Resultados de AML da empresa (ocorrências, pontuações)
Resultados de AML individuais para cada UBO e administrador
Resultados de documentos com os dados extraídos por OCR
Códigos de motivo da decisão

Consulte o Esquema de resposta de KYB para o payload completo.

Acionamento de reverificação

Re-KYB anual, reverificações baseadas em gatilhos ou fluxos de remediação começam sempre 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 é anexada à entidade Business existente e atualiza o mapa features ao ser concluída.

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

Cenário	Uso
A consulta ao registro precisa de um nome de empresa corrigido	Reenvio: o analista edita os dados e executa a consulta ao registro novamente
Um documento adicional é solicitado à empresa	Reenvio: a empresa envia o documento que falta
Re-KYB anual ou baseado em gatilhos	Crie uma nova sessão

Como exportar um relatório de KYB

Gere um PDF completo de qualquer sessão de Verificação de Empresa (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 dados do registro de empresas, estrutura societária, ocorrências de AML, imagens dos documentos, status de KYC dos administradores e uma página de capa com o motivo da decisão.

Como compartilhar uma sessão de Verificação de Empresas (KYB)

Para fluxos de consórcio ou de parceiros:

POST /v3/session/{session_id}/share/: gera um token compartilhável.
POST /v3/session/import-shared/: importa a sessão no lado receptor.

Monitoramento contínuo

Entidades empresariais em modo de monitoramento contínuo passam por novas varreduras de AML periódicas. Quando uma nova ocorrência de sanções ou de mídia adversa é detectada, a análise AML da empresa é atualizada; consulte-a em aml_screenings[] na decisão da sessão. Configure o monitoramento contínuo no console em Workflows → [fluxo de KYB] → AML → Ongoing monitoring.

Próximos passos

Visão geral de KYB

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

Resposta de KYB

Referência completa do payload da decisão.

Pessoas-chave

Administradores, UBOs e usuários vinculados.

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

Visão geral

Preços

Fluxos e verificação

Revisão e operações

Entidades (usuários e empresas)

Configurações e personalização

Segurança e conformidade

Didit Academy

Recursos

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

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

Entendendo os recursos de KYB

Como inspecionar uma única sessão de Verificação de empresas (KYB)

Acionamento de reverificação

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

Como exportar um relatório de KYB

Como compartilhar uma sessão de Verificação de Empresas (KYB)

Monitoramento contínuo

Próximos passos

Visão geral de KYB

Resposta de KYB

Pessoas-chave

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

​Entendendo os recursos de KYB

​Como inspecionar uma única sessão de Verificação de empresas (KYB)

​Acionamento de reverificação

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

​Como exportar um relatório de KYB

​Como compartilhar uma sessão de Verificação de Empresas (KYB)

​Monitoramento contínuo

​Próximos passos

Visão geral de KYB

Resposta de KYB

Pessoas-chave

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

Entendendo os recursos de KYB

Como inspecionar uma única sessão de Verificação de empresas (KYB)

Acionamento de reverificação

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

Como exportar um relatório de KYB

Como compartilhar uma sessão de Verificação de Empresas (KYB)

Monitoramento contínuo

Próximos passos