Avisos de Verificação de Empresas e Códigos de Erro KYB

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

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

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

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

{
  "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 funcionalidades KYB.

Estados

Perceba como a gravidade do aviso é mapeada para o estado da verificação.

Documentos

Reveja os grupos de documentos, o OCR e o comportamento de validação cruzada.

Pessoas-chave

Fluxo de verificação de administradores, beneficiários efetivos e partes submetidas.

Relatório AML

Estrutura ao nível das correspondências para triagens AML de empresas e pessoas.

Modelos de dados de referência

Estruturas canónicas para avisos e arrays de funcionalidades.

Primeiros passos

Funcionalidades

Perfis de empresas

Referência

Consola

Avisos de Verificação de Empresas e Códigos de Erro KYB

Visão geral

Avisos do registo KYB

Avisos de documentos KYB

Avisos de pessoas-chave KYB

Avisos de funcionalidades partilhadas

AML

Telefone

E-mail

Questionário

Análise de dispositivo e IP

Exemplos

Registo: empresa inativa

Documentos: suspeita de manipulação de sobreposição

Pessoas-chave: pessoa singular recusada anteriormente

Relacionados

Esquema de resposta

Estados

Documentos

Pessoas-chave

Relatório AML

Modelos de dados de referência

​Visão geral

​Avisos do registo KYB

​Avisos de documentos KYB

​Avisos de pessoas-chave KYB

​Avisos de funcionalidades partilhadas

​AML

​Telefone

​E-mail

​Questionário

​Análise de dispositivo e IP

​Exemplos

​Registo: empresa inativa

​Documentos: suspeita de manipulação de sobreposição

​Pessoas-chave: pessoa singular recusada anteriormente

​Relacionados

Esquema de resposta

Estados

Documentos

Pessoas-chave

Relatório AML

Modelos de dados de referência

Visão geral

Avisos do registo KYB

Avisos de documentos KYB

Avisos de pessoas-chave KYB

Avisos de funcionalidades partilhadas

AML

Telefone

E-mail

Questionário

Análise de dispositivo e IP

Exemplos

Registo: empresa inativa

Documentos: suspeita de manipulação de sobreposição

Pessoas-chave: pessoa singular recusada anteriormente

Relacionados