> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API de documentos KYB: verificação corporativa > A Didit coleta, lê via OCR e cruza documentos KYB (contrato social, balanços) com o registro de empresas. Cobrança separada da consulta ao registro. A verificação de empresas inclui a coleta estruturada de documentos para validar informações da empresa além do que está disponível nos registros. ## Preços A coleta de documentos de KYB custa **\$0.20 por etapa do fluxo de verificação (workflow)**, independentemente de quantos documentos forem enviados nessa etapa. Reenviar um documento na mesma etapa não gera outra cobrança; uma etapa de coleta de documentos separada tem sua própria cobrança. ## Grupos de documentos Os documentos são organizados em quatro grupos estruturados, cada um representando uma categoria de evidência necessária para a verificação de empresas, além de um grupo genérico para tudo o que a Didit não consegue classificar: | Grupo (`document_group`) | Descrição | Subtipos de documento reconhecidos | | - | - | - | | **Presença legal** (`LEGAL_PRESENCE`) | Documentos que comprovam que a empresa existe legalmente | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` | | **Detalhes da empresa** (`COMPANY_DETAILS`) | Documentos que descrevem os dados atuais da empresa | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` | | **Estrutura de propriedade** (`OWNERSHIP_STRUCTURE`) | Documentos que comprovam a cadeia de propriedade | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` | | **Autorização de representantes** (`REPRESENTATIVES_AUTHORIZATION`) | Documentos que comprovam a autoridade para agir em nome da empresa | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` | | **Outro** (`OTHER`) | Tudo o que a Didit não consegue classificar com segurança | `UNKNOWN` | Cada grupo acompanha o próprio progresso com contadores por grupo: `total`, `approved`, `pending`, `declined`, `in_review`, `other` e `missing`. O status geral de documentos da sessão empresarial agrega os dados de todos os grupos. ## Tipos de documento | Categoria | Exemplos | | - | - | | **Documentos de constituição** | Certidão de constituição, estatuto social, memorando de associação | | **Documentos de propriedade** | Livro de registro de acionistas, certificados de ações, declarações de UBO | | **Documentos de endereço** | Contas de serviços públicos, extratos bancários ou contratos de locação do endereço registrado | | **Documentos financeiros** | Contas anuais, relatórios de auditoria, demonstrações financeiras | | **Documentos fiscais** | Certificados de inscrição fiscal, certidões de regularidade fiscal | | **Documentos regulatórios** | Licenças, alvarás, autorizações regulatórias | | **Documentos personalizados** | Quaisquer documentos adicionais exigidos pelo seu processo de conformidade | ## Fluxo de documentos **1. Solicitações automáticas** Com base na configuração do seu fluxo, a Didit identifica automaticamente quais documentos são necessários para a verificação da empresa. Os tipos de documento obrigatórios são apresentados à empresa para envio. **2. Envio** Os documentos são enviados pelo fluxo de verificação hospedado, pelo Business Console ou pelo seu próprio front-end com o endpoint de [envio de documentos](https://docs.didit.me/pt-br/sessions-api/kyb-upload-documents.md). Os formatos aceitos são PDF, JPG, JPEG, PNG, TIFF e WebP, ou um arquivo ZIP contendo arquivos nesses formatos. PDFs podem ter até 50 MB e fotos até 6 MB antes da compressão. Para um PDF protegido por senha, envie a senha em `document_passwords` ao fazer o envio pela API. **3. Extração por OCR** A Didit extrai dados estruturados dos documentos enviados usando OCR: * Nome da empresa e número de registro a partir de certidões * Dados de endereço a partir de contas de serviços públicos * Valores financeiros a partir de demonstrações * Nomes e funções a partir de registros de acionistas **4. Comparação cruzada** Os dados extraídos são comparados com: * Dados de registro obtidos na consulta da empresa * Informações fornecidas na criação da sessão * Dados de outros documentos enviados As inconsistências são sinalizadas para revisão por um analista. **5. Revisão** Os analistas revisam os documentos enviados no console, verificam sua autenticidade e aprovam ou rejeitam cada documento individualmente. ## Solicitações de documentos por analistas Durante o processo de revisão, os analistas podem solicitar documentos adicionais: 1. Acesse a sessão da empresa no console 2. Clique em **Request document** e especifique o tipo e a descrição do documento 3. A empresa é notificada e pode enviar o documento solicitado 4. O documento aparece na sessão com o status **Solicitado** até ser enviado Isso permite que os analistas reúnam evidências adicionais sem rejeitar toda a sessão da empresa. ## Status dos documentos Cada documento e a verificação agregada `document_verifications[]` usam o conjunto padrão de status dos recursos de KYB: | Status | Descrição | | - | - | | `"Not Finished"` | O documento ainda está sendo processado (envio em andamento, OCR em execução ou comparação cruzada pendente). | | `"Approved"` | O documento foi revisado e aceito. | | `"Declined"` | O documento foi revisado e rejeitado. | | `"In Review"` | O documento requer análise manual por um analista. | | `"Resub Requested"` | O analista solicitou um reenvio: a empresa deve enviar este documento novamente antes que a sessão possa avançar. | ## Resultados da verificação cruzada Quando um documento é processado, a Didit cruza os dados extraídos por OCR com os **dados informados pelo usuário** no fluxo de pessoas-chave (e com quaisquer dados confirmados durante a revisão do registro), além de outros documentos enviados. A verificação cruzada gera resultados estruturados: | Categoria | Descrição | | - | - | | **Campos críticos** | Campos em que os dados do documento e os dados informados pelo usuário não coincidem e que exigem revisão de um analista. Cada campo mostra o valor do documento, o valor informado pelo usuário e uma pontuação de confiança. | | **Campos não críticos** | Campos com pequenas divergências ou diferenças de formatação que podem não exigir ação (por exemplo, diferenças de abreviação no nome da empresa). | | **Sobreposição de pessoas** | Análise das pessoas mencionadas no documento em comparação com as pessoas informadas pelo usuário, destacando indivíduos ausentes ou adicionais. | Os resultados da verificação cruzada são exibidos no [Business Console](https://docs.didit.me/pt-br/business-verification/console.md) ao lado da pré-visualização do documento, oferecendo aos analistas uma visão clara do que coincide e do que precisa de atenção. ## Como obter documentos via API Os documentos ficam vinculados à sessão de Verificação de empresas (KYB). Obtenha-os por meio da decisão da sessão: ```bash theme={null} curl https://verification.didit.me/v3/session/{session_id}/decision/ \ -H "x-api-key: YOUR_API_KEY" ``` A resposta inclui um array `document_verifications[]`, e cada item contém `status`, `node_id`, `items[]` (cada um com uma `file_url` assinada, um `document_group`, um `document_subtype` e um trecho extraído por OCR), `groups` e `required_groups`. Consulte o [esquema de resposta](https://docs.didit.me/pt-br/business-verification/response-schema.md#document_verifications) para ver a estrutura completa. ## Próximos passos > [card] [Esquema de resposta](https://docs.didit.me/pt-br/business-verification/response-schema.md) > > Onde os documentos aparecem no payload. > [card] [Business Console](https://docs.didit.me/pt-br/business-verification/console.md) > > Revisão de documentos como analista. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.