> ## 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 de empresas > A Didit recolhe, faz OCR e cruza documentos de empresas: certificados, estatutos, contas anuais. Validação em registos e preços separados. Verificação de empresas inclui a recolha estruturada de documentos para validar informações da empresa para além do que está disponível nos registos de empresas. ## Preços A recolha de documentos para KYB custa **\$0.20 por passo do fluxo**, independentemente do número de documentos carregados nesse passo. Carregar novamente um documento no mesmo passo não gera outra cobrança; um passo de recolha de documentos separado tem a sua própria cobrança. ## Grupos de documentos Os documentos estão organizados em quatro grupos estruturados, cada um correspondendo a uma categoria de prova necessária para a verificação de empresas, mais um grupo residual para qualquer documento que a Didit não consiga classificar: | Grupo (`document_group`) | Descrição | Subtipos de documentos reconhecidos | | - | - | - | | **Presença legal** (`LEGAL_PRESENCE`) | Documentos que comprovam a existência legal da empresa | `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 dos representantes** (`REPRESENTATIVES_AUTHORIZATION`) | Documentos que comprovam a autoridade para agir em nome da empresa | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` | | **Outro** (`OTHER`) | Qualquer documento que a Didit não consiga classificar com confiança | `UNKNOWN` | Cada grupo acompanha o seu próprio progresso através de contadores por grupo: `total`, `approved`, `pending`, `declined`, `in_review`, `other` e `missing`. O estado geral dos documentos da sessão de empresa agrega todos os grupos. ## Tipos de documentos | Categoria | Exemplos | | - | - | | **Documentos de constituição** | Certificado de constituição, estatutos, memorando de constituição | | **Documentos de propriedade** | Registo de acionistas, títulos de ações, declarações de UBO | | **Documentos de morada** | Faturas de serviços públicos, extratos bancários ou contratos de arrendamento da morada registada | | **Documentos financeiros** | Contas anuais, relatórios de auditoria, demonstrações financeiras | | **Documentos fiscais** | Certificados de inscrição fiscal, certificados de regularidade fiscal | | **Documentos regulamentares** | Licenças, autorizações, aprovações regulamentares | | **Documentos personalizados** | Quaisquer documentos adicionais exigidos pelo seu processo de conformidade | ## Fluxo de documentos **1. Pedidos automáticos** Com base na configuração do seu fluxo, a Didit identifica automaticamente os documentos necessários para a verificação de empresas. Os tipos de documentos exigidos são apresentados à empresa para carregamento. **2. Carregamento** Os documentos são carregados através da página de verificação alojada, pela Business Console ou a partir da sua própria interface com o endpoint [carregar documentos](https://docs.didit.me/pt/sessions-api/kyb-upload-documents.md). Os formatos aceites são PDF, JPG, JPEG, PNG, TIFF e WebP, ou um ficheiro ZIP com esses ficheiros. Os PDFs podem ter até 50 MB e as fotografias até 6 MB antes da compressão. Para um PDF protegido por palavra-passe, envie a palavra-passe em `document_passwords` ao carregar através da API. **3. Extração OCR** A Didit extrai dados estruturados dos documentos carregados através de OCR: * Nome da empresa e número de registo a partir de certificados * Dados de morada a partir de faturas de serviços públicos * Valores financeiros a partir de demonstrações financeiras * Nomes e funções a partir de registos de acionistas **4. Cruzamento de dados** Os dados extraídos são cruzados com: * Dados do registo de empresas obtidos através da pesquisa de empresas * Informações fornecidas na criação da sessão * Dados de outros documentos carregados As inconsistências são assinaladas para revisão pelo analista. **5. Revisão** Os analistas reveem os documentos carregados na consola, verificam a sua autenticidade e aprovam ou rejeitam cada documento individualmente. ## Pedidos de documentos pelos analistas Durante o processo de revisão, os analistas podem pedir documentos adicionais: 1. Aceda à sessão da empresa na consola 2. Clique em **Pedir documento** e indique o tipo de documento e a descrição 3. A empresa é notificada e pode carregar o documento pedido 4. O documento aparece na sessão com o estado **Solicitado** até ser carregado Isto permite aos analistas reunir provas adicionais sem rejeitar toda a sessão da empresa. ## Estados dos documentos Cada documento e a verificação agregada `document_verifications[]` usam o conjunto padrão de estados da funcionalidade KYB: | Estado | Descrição | | - | - | | `"Not Finished"` | O documento ainda está a ser processado (carregamento em curso, OCR em execução ou cruzamento de dados pendente). | | `"Approved"` | O documento foi revisto e aceite. | | `"Declined"` | O documento foi revisto e rejeitado. | | `"In Review"` | O documento requer atenção manual do analista. | | `"Resub Requested"` | O analista pediu a reapresentação; a empresa tem de voltar a carregar este documento antes de a sessão poder avançar. | ## Resultados da validação cruzada Quando um documento é processado, a Didit cruza os dados extraídos por OCR com os **dados fornecidos pelo utilizador** submetidos no fluxo de pessoas-chave (e com quaisquer dados confirmados durante a revisão do registo de empresas), bem como com outros documentos carregados. A validação produz resultados estruturados: | Categoria | Descrição | | - | - | | **Campos críticos** | Campos em que os dados do documento e os dados fornecidos pelo utilizador não coincidem. Estes exigem revisão por parte de um analista. Cada campo mostra o valor do documento, o valor fornecido pelo utilizador e uma pontuação de confiança. | | **Campos não críticos** | Campos com discrepâncias menores ou diferenças de formatação que podem não exigir ação (por exemplo, diferenças de abreviatura no nome da empresa). | | **Sobreposição de pessoas** | Análise das pessoas mencionadas no documento em comparação com as pessoas indicadas pelo utilizador, destacando indivíduos em falta ou adicionais. | Os resultados da validação cruzada são apresentados na [Business Console](https://docs.didit.me/pt/business-verification/console.md), junto à pré-visualização do documento, dando aos analistas uma visão clara do que coincide e do que requer atenção. ## Obter documentos através da API Os documentos ficam anexados à sessão de Verificação de empresas (KYB). Obtenha-os através 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[]`: cada item tem um `status`, um `node_id`, `items[]` (cada um com um `file_url` assinado, um `document_group`, um `document_subtype` e uma extração OCR), `groups` e `required_groups`. Consulte o [esquema de resposta](https://docs.didit.me/pt/business-verification/response-schema.md#document_verifications) para ver a estrutura completa. ## Próximos passos > [card] [Esquema de resposta](https://docs.didit.me/pt/business-verification/response-schema.md) > > Onde os documentos aparecem no payload. > [card] [Business Console](https://docs.didit.me/pt/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.