> ## 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 KYB da Didit por recurso: registro, documentos, pessoas-chave, AML, telefone, e-mail, questionário e dispositivo/IP. A Verificação de empresas (KYB) exibe os avisos no item de recurso que os gerou. Cada aviso segue o mesmo formato estruturado usado em toda a plataforma (`feature`, `risk`, `log_type`, `short_description`, `long_description`, `additional_data` opcional e `node_id`), para que você possa direcionar o trabalho de revisão para a equipe operacional certa. ## Visão geral As sessões de KYB emitem avisos em três tags de recurso principais, que correspondem a arrays de recursos dedicados na resposta de decisão V3: | Tag do recurso | Chave na resposta de decisão | O que abrange | | - | - | - | | `KYB_REGISTRY` | `registry_checks[].warnings[]` | Consultas aos registros oficiais de empresas. Status ativo, restrições de país, propriedade que pode ser determinada e registros ausentes de administradores ou UBOs. | | `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | Documentos de constituição, propriedade, endereço e acionistas enviados pelo usuário. Consistência entre documentos, OCR, metadados, manipulação, idade e regras de subtipo. | | `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | Sinais individuais sobre diretores, administradores, UBOs ou partes informadas pelo usuário, incluindo resultados de PEP e sanções propagados da análise AML e a reutilização de recusas anteriores. | O mesmo fluxo de verificação (workflow) de KYB também pode incluir os recursos compartilhados abaixo, que emitem avisos em seus próprios arrays: | Tag do recurso | Chave na resposta de decisão | | - | - | | `AML` | `aml_screenings[].warnings[]` | | `PHONE` | `phone_verifications[].warnings[]` | | `EMAIL` | `email_verifications[].warnings[]` | | `QUESTIONNAIRE` | `questionnaire_responses` (os avisos ficam no log da sessão) | | `LOCATION` | `ip_analyses[].warnings[]` | ## Avisos do registro KYB Os avisos de registro usam `feature: "KYB_REGISTRY"` e aparecem em `registry_checks[].warnings[]`. | Tag | Descrição | | - | - | | `KYB_COUNTRY_RESTRICTED` | O país da empresa está fora dos países permitidos configurados no fluxo. | | `KYB_OFFICERS_DATA_NOT_FOUND` | Os dados dos administradores não estão disponíveis no registro. | | `KYB_OWNERSHIP_DATA_NOT_FOUND` | Os dados de propriedade não estão disponíveis no registro. | | `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | Não foi possível determinar a propriedade dos beneficiários finais a partir dos dados do registro. | | `KYB_COMPANY_NOT_ACTIVE` | A empresa não está ativa de acordo com o registro. | | `KYB_COMPANY_NOT_FROM_REGISTRY` | A empresa foi inserida manualmente e não pôde ser verificada em um registro de empresas. | | `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | O número de registro da empresa obtido no registro não corresponde ao `expected_details.registration_number` que você enviou ao criar a sessão. | | `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | O número de registro obtido no registro coincide apenas parcialmente com o esperado, por exemplo, por um sufixo de filial ou subsidiária. | | `KYB_COMPANY_VAT_INVALID` | O registro fiscal oficial não tem um cadastro ativo para o número de VAT ou a identificação fiscal da empresa, ou o número de VAT não atende às regras de formato e dígito verificador do seu país. A `kyb_vat_invalid_action` configurada é aplicada (padrão: Em revisão). | | `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | Não foi possível validar o número de VAT ou a identificação fiscal porque o registro oficial estava temporariamente indisponível. A `kyb_vat_unverified_action` configurada é aplicada (padrão: sem efeito). | | `KYB_COMPANY_VAT_NAME_MISMATCH` | O nome cadastrado no registro oficial para esse número é diferente do nome da empresa informado. Informativo: inclui `registry_name`, `registry_source` e `submitted_name` em `additional_data`, além de `vies_name` quando o registro é o VIES. | Os avisos de VAT se aplicam sempre que for possível validar o número de VAT ou a identificação fiscal da empresa. Consulte [Validação de VAT e identificação fiscal](https://docs.didit.me/pt-br/business-verification/company-data.md#validação-de-vat-e-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 registro, não foi encontrado no documento. | | `KYB_DOCUMENT_NAME_MISMATCH` | O nome da empresa no documento não corresponde ao registro. | | `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | O número de registro no documento não corresponde ao registro. | | `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | A data de constituição no documento não corresponde ao registro. | | `KYB_DOCUMENT_ADDRESS_MISMATCH` | O endereço registrado no documento não corresponde ao registro. | | `KYB_CROSS_DOCUMENT_MISMATCH` | Os dados da empresa diferem entre os documentos societários enviados. | | `KYB_DOCUMENT_METADATA_MISMATCH` | A assinatura, os metadados ou a estrutura do arquivo do documento indicam um possível problema. | | `KYB_ASSOCIATED_PARTY_MISMATCH` | Os diretores ou acionistas no documento não correspondem ao registro. | | `KYB_DOCUMENT_GRAPHIC_EDITOR` | O documento parece ter sido processado por um software de edição gráfica. | | `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | O sistema detectou sinais de possível manipulação do documento societário. | | `KYB_ADDITIONAL_DATA_NOT_FOUND` | Não foi possível verificar um campo do documento porque os dados correspondentes do registro não estão disponíveis. | | `KYB_DOCUMENT_EXPIRED` | O documento societário ultrapassa a idade máxima configurada. | | `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | O subtipo do documento enviado está desativado no fluxo. | | `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | O número máximo de tentativas de envio de documentos societários foi excedido. | Em caso de manipulação por texto sobreposto em PDF, `KYB_DOCUMENT_SUSPECTED_MANIPULATION` pode incluir `additional_data.manipulated_regions`. São retângulos em coordenadas da página que identificam as áreas suspeitas de edição e correspondem aos retângulos retornados em `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions`. ## Avisos de pessoas-chave do KYB Os avisos de pessoas-chave usam `feature: "KYB_KEY_PEOPLE"` e aparecem em `key_people_checks[].warnings[]`. Eles apontam problemas individuais de diretores, executivos, UBOs e partes enviadas pelo usuário. | Tag | Descrição | | - | - | | `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | Uma pessoa associada à empresa foi recusada anteriormente em outra verificação de empresa da mesma aplicação. | | `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | Os diretores ou acionistas declarados na tela de pessoas-chave não correspondem às pessoas citadas nos documentos societários enviados. Isso ocorre quando uma pessoa citada nos documentos nunca foi declarada, quando um nome corresponde apenas parcialmente, quando um acionista que consta nos documentos foi declarado sem indicar que tem participação societária ou quando um percentual de propriedade declarado contradiz os documentos. A ação configurada em `kyb_key_people_document_mismatch_action` é aplicada (padrão: Em revisão). | > [!NOTE] > > **Ocorrências de PEP / sanções em pessoas-chave** são reportadas como ocorrências AML padrão no item correspondente de `aml_screenings[]`, e não como um aviso de pessoas-chave do KYB. A verificação de pessoas-chave propaga o status resultante, `Declined` ou `In Review`, para cada parte afetada, de modo que o resultado geral de pessoas-chave reflita o resultado da análise AML. ## Avisos de recursos compartilhados Os recursos abaixo podem ser executados dentro de um fluxo de verificação (workflow) de KYB. Eles usam o mesmo catálogo de avisos da Verificação de usuários. A referência completa está na página de avisos de cada recurso. ### AML `feature: "AML"` em `aml_screenings[].warnings[]`. | Tag | Descrição | | - | - | | `POSSIBLE_MATCH_FOUND` | A análise AML encontrou uma possível correspondência que exige revisão. | | `COULD_NOT_PERFORM_AML_SCREENING` | A Didit não conseguiu realizar a análise AML porque os dados necessários para a triagem estavam ausentes 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` | O número máximo de tentativas do código de verificação foi excedido. | | `VOIP_NUMBER_DETECTED` | O número de telefone é um número VoIP. | | `DUPLICATED_PHONE_NUMBER` | O número de telefone foi usado em outro 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 vazamentos de dados conhecidos. | | `DISPOSABLE_EMAIL_DETECTED` | O endereço de e-mail é descartável. | | `UNDELIVERABLE_EMAIL_DETECTED` | O endereço de e-mail não pode receber mensagens. | | `DUPLICATED_EMAIL` | O endereço de e-mail foi usado em outro 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` | O número máximo de tentativas do código de verificação por e-mail foi excedido. | ### Questionário `feature: "QUESTIONNAIRE"`. | Tag | Descrição | | - | - | | `CUSTOM_STATUS_RULE_TRIGGERED` | Uma regra de status do fluxo avaliou uma resposta do questionário e alterou o status do recurso. | ### 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 detectado um sinal de rede privada, VPN, proxy ou Tor. | | `EXPECTED_IP_ADDRESS_MISMATCH` | O endereço não corresponde ao endereço esperado informado para a sessão. | | `IP_ADDRESS_IN_BLOCKLIST` | O endereço 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 foi usado em outra verificação com um `vendor_data` diferente. | | `DUPLICATED_DEVICE_FINGERPRINT` | A mesma impressão digital do dispositivo foi usada em outra verificação com um `vendor_data` diferente. | ## Exemplos ### Registro de empresas — 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 por 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 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-br/business-verification/response-schema.md) > > Veja onde os avisos aparecem em cada array de recursos do KYB. > [card] [Status](https://docs.didit.me/pt-br/business-verification/statuses.md) > > Entenda como a gravidade dos avisos se reflete no status da verificação. > [card] [Documentos](https://docs.didit.me/pt-br/business-verification/documents.md) > > Conheça os grupos de documentos, o OCR e o funcionamento das verificações cruzadas. > [card] [Pessoas-chave](https://docs.didit.me/pt-br/business-verification/key-people.md) > > Fluxo de verificação de executivos, UBOs e partes submetidas. > [card] [Relatório AML](https://docs.didit.me/pt-br/core-technology/aml-screening/report-aml-screening.md) > > Estrutura de cada ocorrência nas análises AML de empresas e pessoas. > [card] [Modelos de dados de referência](https://docs.didit.me/pt-br/reference/data-models.md) > > Formatos canônicos de avisos e arrays de recursos. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.