Avisos de verificação de empresas e códigos de erro KYB

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 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).

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

{
  "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

{
  "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

{
  "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

Esquema de resposta

Veja onde os avisos aparecem em cada array de recursos do KYB.

Status

Entenda como a gravidade dos avisos se reflete no status da verificação.

Documentos

Conheça os grupos de documentos, o OCR e o funcionamento das verificações cruzadas.

Pessoas-chave

Fluxo de verificação de executivos, UBOs e partes submetidas.

Relatório AML

Estrutura de cada ocorrência nas análises AML de empresas e pessoas.

Modelos de dados de referência

Formatos canônicos de avisos e arrays de recursos.

Primeiros passos

Recursos

Perfis de empresas

Referência

Console

Avisos de verificação de empresas e códigos de erro KYB

Visão geral

Avisos do registro KYB

Avisos de documentos KYB

Avisos de pessoas-chave do KYB

Avisos de recursos compartilhados

AML

Telefone

E-mail

Questionário

Análise de dispositivo e IP

Exemplos

Registro de empresas — empresa inativa

Documentos — suspeita de manipulação por sobreposição

Pessoas-chave — pessoa recusada anteriormente

Relacionados

Esquema de resposta

Status

Documentos

Pessoas-chave

Relatório AML

Modelos de dados de referência

​Visão geral

​Avisos do registro KYB

​Avisos de documentos KYB

​Avisos de pessoas-chave do KYB

​Avisos de recursos compartilhados

​AML

​Telefone

​E-mail

​Questionário

​Análise de dispositivo e IP

​Exemplos

​Registro de empresas — empresa inativa

​Documentos — suspeita de manipulação por sobreposição

​Pessoas-chave — pessoa recusada anteriormente

​Relacionados

Esquema de resposta

Status

Documentos

Pessoas-chave

Relatório AML

Modelos de dados de referência

Visão geral

Avisos do registro KYB

Avisos de documentos KYB

Avisos de pessoas-chave do KYB

Avisos de recursos compartilhados

AML

Telefone

E-mail

Questionário

Análise de dispositivo e IP

Exemplos

Registro de empresas — empresa inativa

Documentos — suspeita de manipulação por sobreposição

Pessoas-chave — pessoa recusada anteriormente

Relacionados