> ## 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. # Avisos de Verificação de Empresas e Códigos de Erro KYB > Códigos de aviso da Verificação de empresas na Didit, por funcionalidade: KYB, pessoas-chave, AML, telefone, e-mail, questionários e dispositivo/IP. ## Visão geral A Verificação de empresas (KYB) apresenta avisos no item de funcionalidade que os gerou. Cada aviso tem a estrutura padronizada usada em toda a plataforma, com `feature`, `risk`, `log_type`, `short_description`, `long_description`, `additional_data` (opcional) e `node_id`, para que possa encaminhar o trabalho de revisão para a equipa operacional certa. As sessões KYB emitem avisos em três etiquetas de funcionalidade principais, que correspondem a matrizes próprias na resposta de decisão V3: | Etiqueta da funcionalidade | Chave da resposta de decisão | O que abrange | | - | - | - | | `KYB_REGISTRY` | `registry_checks[].warnings[]` | Consultas oficiais ao registo de empresas. Estado ativo, restrições por país, propriedade derivável e registos de dirigentes ou UBO em falta. | | `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | Documentos de constituição, de propriedade, de morada e de acionistas carregados pelo utilizador. Consistência entre documentos, OCR, metadados, manipulação, idade e regras de subtipo. | | `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | Sinais relativos a administradores, dirigentes, UBO ou partes submetidas pelo utilizador, incluindo resultados de PEP e sanções propagados da AML, bem como resultados da reutilização de recusas anteriores. | O mesmo fluxo KYB pode incluir também as funcionalidades partilhadas abaixo, que emitem avisos nas suas próprias matrizes: | Etiqueta da funcionalidade | Chave da resposta de decisão | | - | - | | `AML` | `aml_screenings[].warnings[]` | | `PHONE` | `phone_verifications[].warnings[]` | | `EMAIL` | `email_verifications[].warnings[]` | | `QUESTIONNAIRE` | `questionnaire_responses` (os avisos ficam no registo da sessão) | | `LOCATION` | `ip_analyses[].warnings[]` | ## Avisos do registo KYB Os avisos do registo usam `feature: "KYB_REGISTRY"` e aparecem em `registry_checks[].warnings[]`. | Etiqueta | Descrição | | - | - | | `KYB_COUNTRY_RESTRICTED` | O país da empresa está fora dos países permitidos configurados para o fluxo. | | `KYB_OFFICERS_DATA_NOT_FOUND` | Os dados dos dirigentes não estão disponíveis no registo. | | `KYB_OWNERSHIP_DATA_NOT_FOUND` | Os dados de propriedade não estão disponíveis no registo. | | `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | Não foi possível determinar a propriedade efetiva em última instância a partir dos dados do registo. | | `KYB_COMPANY_NOT_ACTIVE` | De acordo com o registo, a empresa não está ativa. | | `KYB_COMPANY_NOT_FROM_REGISTRY` | A empresa foi introduzida manualmente e não pôde ser verificada num registo de empresas. | | `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | O número de registo da empresa obtido no registo não corresponde ao `expected_details.registration_number` que enviou ao criar a sessão. | | `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | O número de registo obtido no registo coincide apenas parcialmente com o esperado, por exemplo devido a um sufixo de ramificação ou de subsidiária. | | `KYB_COMPANY_VAT_INVALID` | O registo fiscal oficial não tem nenhum registo ativo para o número de IVA ou número de identificação fiscal da empresa, ou o número de IVA não cumpre as regras de formato e de dígito de controlo do respetivo país. Aplica-se a ação `kyb_vat_invalid_action` configurada (predefinição: Em análise). | | `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | Não foi possível validar o número de IVA ou o número de identificação fiscal porque o registo oficial está temporariamente indisponível. Aplica-se a ação `kyb_vat_unverified_action` configurada (predefinição: sem efeito). | | `KYB_COMPANY_VAT_NAME_MISMATCH` | O nome registado no registo oficial para este número é diferente do nome da empresa submetido. Informativo - inclui `registry_name`, `registry_source` e `submitted_name` em `additional_data`, bem como `vies_name` quando o registo é o VIES. | Os avisos de IVA aplicam-se sempre que o número de IVA ou o número de identificação fiscal da empresa puder ser validado. Consulte [Validação de IVA e de número de identificação fiscal](https://docs.didit.me/pt/business-verification/company-data.md#validação-de-iva-e-número-de-identificação-fiscal) para ver os países e as fontes. ## Avisos de documentos KYB Os avisos de documentos usam `feature: "KYB_DOCUMENTS"` e aparecem em `document_verifications[].warnings[]`. | Tag | Descrição | | - | - | | `KYB_DOCUMENT_MISSING_REQUIRED_FIELD` | Um campo obrigatório da empresa, como o nome da empresa ou o número de registo, não foi encontrado no documento. | | `KYB_DOCUMENT_NAME_MISMATCH` | O nome da empresa no documento não corresponde ao registo de empresas. | | `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | O número de registo no documento não corresponde ao registo de empresas. | | `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | A data de constituição no documento não corresponde ao registo de empresas. | | `KYB_DOCUMENT_ADDRESS_MISMATCH` | A morada registada no documento não corresponde ao registo de empresas. | | `KYB_CROSS_DOCUMENT_MISMATCH` | Os dados da empresa diferem entre os documentos societários carregados. | | `KYB_DOCUMENT_METADATA_MISMATCH` | A assinatura, os metadados ou a estrutura do ficheiro do documento indicam um possível problema. | | `KYB_ASSOCIATED_PARTY_MISMATCH` | Os administradores ou acionistas no documento não correspondem ao registo de empresas. | | `KYB_DOCUMENT_GRAPHIC_EDITOR` | O documento parece ter sido processado por software de edição gráfica. | | `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | O sistema detetou sinais de possível manipulação do documento societário. | | `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` | Um campo de texto do documento societário foi apagado e reescrito noutro tipo de letra, e o ficheiro não contém prova de se o conteúdo foi alterado. Este aviso também é gerado quando um ficheiro não pôde ser verificado na totalidade, com `additional_data.detection_method` definido como `analysis_incomplete`, porque a parte não verificada pode conter esse campo. Regido por `kyb_document_unproven_text_replacement_action` (predefinição Revisão; um fluxo que nunca envia para revisão usa o seu próprio `kyb_document_tampering_action` quando este está definido como Recusar, caso contrário usa Sem ação). | | `KYB_ADDITIONAL_DATA_NOT_FOUND` | Um campo do documento não pôde ser verificado porque os dados correspondentes do registo não estão disponíveis. | | `KYB_DOCUMENT_EXPIRED` | O documento societário excede a idade máxima configurada. | | `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | O subtipo de documento carregado está desativado para o fluxo. | | `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | Foi excedido o número máximo de tentativas de carregamento de documentos societários. | Para a manipulação de texto sobreposto em PDF, `KYB_DOCUMENT_SUSPECTED_MANIPULATION` pode incluir `additional_data.manipulated_regions`. Um campo de texto apagado e reescrito noutro tipo de letra gera `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` com a mesma estrutura de `manipulated_regions`, e nunca gera `KYB_DOCUMENT_SUSPECTED_MANIPULATION` isoladamente: os editores online também reescrevem texto que não foi alterado, por isso este aviso não indica que o conteúdo mudou. Se outro sinal gerar `KYB_DOCUMENT_SUSPECTED_MANIPULATION` no mesmo documento, decide a ação mais restritiva das duas. Estes são retângulos em coordenadas da página que identificam as áreas suspeitas de edição e correspondem aos retângulos devolvidos em `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions`. ## Avisos de pessoas-chave KYB Os avisos de pessoas-chave usam `feature: "KYB_KEY_PEOPLE"` e aparecem em `key_people_checks[].warnings[]`. Assinalam problemas ao nível individual relativos a administradores, responsáveis, UBOs e partes indicadas pelo utilizador. | Etiqueta | Descrição | | - | - | | `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | Uma pessoa associada à empresa foi anteriormente recusada noutra verificação de empresa para a mesma aplicação. | | `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | Os administradores ou acionistas declarados no ecrã Pessoas-chave não correspondem às pessoas nomeadas nos documentos societários carregados: uma pessoa nomeada nos documentos nunca foi declarada, um nome quase coincide, um acionista documentado foi declarado sem função de propriedade, ou uma percentagem de propriedade declarada contradiz os documentos. Aplica-se o `kyb_key_people_document_mismatch_action` configurado (predefinição: Em análise). | > [!NOTE] > > **As correspondências de PEP e de sanções em pessoas-chave** são comunicadas como correspondências AML padrão no item correspondente de `aml_screenings[]`, e não como aviso KYB de pessoas-chave. A verificação de pessoas-chave propaga o estado resultante, `Declined` ou `In Review`, para cada parte afetada, para que o veredito global de pessoas-chave reflita o resultado AML. ## Avisos de funcionalidades partilhadas As funcionalidades abaixo podem ser executadas num fluxo KYB. Usam o mesmo catálogo de avisos da Verificação de utilizadores. Consulte a referência completa na página de avisos de cada funcionalidade. ### AML `feature: "AML"` em `aml_screenings[].warnings[]`. | Tag | Descrição | | - | - | | `POSSIBLE_MATCH_FOUND` | A triagem AML encontrou uma possível correspondência que requer revisão. | | `COULD_NOT_PERFORM_AML_SCREENING` | A Didit não conseguiu realizar a triagem AML porque os dados necessários para a triagem estavam em falta ou indisponíveis. | ### Telefone `feature: "PHONE"` em `phone_verifications[].warnings[]`. | Tag | Descrição | | - | - | | `DISPOSABLE_NUMBER_DETECTED` | O número de telefone é descartável. | | `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | Foi excedido o número máximo de tentativas de introdução do código de verificação. | | `VOIP_NUMBER_DETECTED` | O número de telefone é um número VoIP. | | `DUPLICATED_PHONE_NUMBER` | O número de telefone foi utilizado noutro processo de verificação. | | `HIGH_RISK_PHONE_NUMBER` | O número de telefone é de alto risco. | | `PHONE_NUMBER_IN_BLOCKLIST` | O número de telefone corresponde a uma entrada da sua lista de bloqueio. | ### E-mail `feature: "EMAIL"` em `email_verifications[].warnings[]`. | Tag | Descrição | | - | - | | `BREACHED_EMAIL_DETECTED` | O endereço de e-mail aparece em fugas de dados conhecidas. | | `DISPOSABLE_EMAIL_DETECTED` | O endereço de e-mail é descartável. | | `UNDELIVERABLE_EMAIL_DETECTED` | O endereço de e-mail não é entregável. | | `DUPLICATED_EMAIL` | O endereço de e-mail foi utilizado noutro processo de verificação. | | `EMAIL_IN_BLOCKLIST` | O endereço de e-mail corresponde a uma entrada da sua lista de bloqueio. | | `EMAIL_CODE_ATTEMPTS_EXCEEDED` | Foi excedido o número máximo de tentativas de introdução do código de verificação por e-mail. | ### Questionário `feature: "QUESTIONNAIRE"`. | Tag | Descrição | | - | - | | `CUSTOM_STATUS_RULE_TRIGGERED` | Uma regra de estado do fluxo avaliou uma resposta do questionário e alterou o estado da funcionalidade. | ### Análise de dispositivo e IP `feature: "LOCATION"` em `ip_analyses[].warnings[]`. | Tag | Descrição | | - | - | | `COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP` | O país do documento não corresponde ao país do IP. | | `PRIVATE_NETWORK_DETECTED` | Foi detetado um sinal de rede privada, VPN, proxy ou Tor. | | `EXPECTED_IP_ADDRESS_MISMATCH` | O endereço IP não corresponde ao endereço IP esperado fornecido para a sessão. | | `IP_ADDRESS_IN_BLOCKLIST` | O endereço IP corresponde a uma entrada da sua lista de bloqueio. | | `DEVICE_FINGERPRINT_IN_BLOCKLIST` | A impressão digital do dispositivo corresponde a uma entrada da sua lista de bloqueio. | | `DUPLICATED_IP_ADDRESS` | O mesmo endereço IP foi utilizado noutra verificação com `vendor_data` diferente. | | `DUPLICATED_DEVICE_FINGERPRINT` | A mesma impressão digital do dispositivo foi utilizada noutra verificação com `vendor_data` diferente. | ## Exemplos ### Registo: empresa inativa ```json theme={null} { "registry_checks": [ { "node_id": "feature_kyb_registry", "status": "Declined", "warnings": [ { "feature": "KYB_REGISTRY", "risk": "KYB_COMPANY_NOT_ACTIVE", "log_type": "error", "short_description": "Company is not active", "long_description": "The company is not active according to the registry.", "additional_data": null, "node_id": "feature_kyb_registry" } ] } ] } ``` ### Documentos: suspeita de manipulação de sobreposição ```json theme={null} { "document_verifications": [ { "node_id": "feature_kyb_documents", "status": "In Review", "warnings": [ { "feature": "KYB_DOCUMENTS", "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION", "log_type": "warning", "short_description": "Possible document manipulation", "long_description": "The system detected signs of possible corporate-document manipulation.", "additional_data": { "manipulated_regions": [ { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 } ] }, "node_id": "feature_kyb_documents" } ] } ] } ``` ### Pessoas-chave: pessoa singular recusada anteriormente ```json theme={null} { "key_people_checks": [ { "node_id": "feature_kyb_key_people", "status": "In Review", "warnings": [ { "feature": "KYB_KEY_PEOPLE", "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL", "log_type": "warning", "short_description": "Previously declined individual", "long_description": "A person associated with the company was previously declined in another business verification for the same application.", "additional_data": null, "node_id": "feature_kyb_key_people" } ] } ] } ``` ## Relacionados > [card] [Esquema de resposta](https://docs.didit.me/pt/business-verification/response-schema.md) > > Veja onde os avisos aparecem em cada array de funcionalidades KYB. > [card] [Estados](https://docs.didit.me/pt/business-verification/statuses.md) > > Perceba como a gravidade do aviso é mapeada para o estado da verificação. > [card] [Documentos](https://docs.didit.me/pt/business-verification/documents.md) > > Reveja os grupos de documentos, o OCR e o comportamento de validação cruzada. > [card] [Pessoas-chave](https://docs.didit.me/pt/business-verification/key-people.md) > > Fluxo de verificação de administradores, beneficiários efetivos e partes submetidas. > [card] [Relatório AML](https://docs.didit.me/pt/core-technology/aml-screening/report-aml-screening.md) > > Estrutura ao nível das correspondências para triagens AML de empresas e pessoas. > [card] [Modelos de dados de referência](https://docs.didit.me/pt/reference/data-models.md) > > Estruturas canónicas para avisos e arrays de funcionalidades. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.