Começar
Integrar / SDKs
Verificação de utilizadores
Verificação de empresas
Monitorização de transações
Registo de alteraçõesPesquisa no registo
A Didit liga-se a registos de empresas dos países suportados para obter dados oficiais. No fluxo alojado, o utilizador seleciona o país de constituição e preenche o nome da empresa, o número de registo ou ambos, sendo obrigatório pelo menos um. Os números de registo são normalizados quando os registos o exigem (por exemplo, os números de empresas do Reino Unido são completados com zeros à esquerda até oito dígitos), e quando são fornecidos os dois identificadores, a pesquisa no registo combina-os.Pré-preenchimento da pesquisa com expected_details
Se já conhece a empresa, passe expected_details (company_name, registry_country, registration_number) ao criar a sessão. O fluxo alojado pré-seleciona e bloqueia o país (e o estado, para registos ao nível estadual como US-CA), pré-preenche os campos de pesquisa correspondentes e executa automaticamente a pesquisa com os dados indicados, de modo que o utilizador chega diretamente ao resultado da sua empresa. Ambos os campos continuam editáveis para que o utilizador possa corrigir uma indicação errada. É apenas um pré-preenchimento: selecionar uma empresa diferente da indicada não gera qualquer aviso.
Tipos de pesquisa
As pesquisas no registo suportam dois modos:Fluxo de pesquisa
A pesquisa no registo segue um fluxo assíncrono:Pesquisa
A Didit consulta o registo com o país selecionado e os identificadores fornecidos: nome da empresa, número de registo ou ambos combinados. O campo
searched_by da resposta indica como os resultados foram correspondidos (name, registration_number ou registration_number_and_name), e a interface alojada oferece, com um toque, a opção «Pesquisar como nome da empresa», nos resultados obtidos por número de registo. A pesquisa é executada de forma assíncrona.Consultar resultados
Consulte o estado da pesquisa até os resultados estarem resolvidos. Registos de grande dimensão podem demorar alguns segundos a devolver resultados.
Selecionar empresa
Reveja as empresas devolvidas e selecione a correspondência correta. A Didit associa a empresa selecionada à verificação KYB e preenche todos os dados disponíveis.
Confirmar e continuar
Confirme ou corrija os dados da empresa e continue para o passo configurado seguinte.
Alguns registos devolvem o perfil da empresa antes de o relatório de propriedade estar pronto; esse relatório continua em segundo plano enquanto o requerente completa passos independentes, como o envio de documentos.
O pré-preenchimento pelo registo não bloqueia o formulário de Pessoas-chave: o requerente pode introduzir pessoas manualmente, e as pessoas disponíveis no registo aparecem antes da submissão à medida que o relatório chega.
As decisões configuradas que dependem do relatório continuam a aguardar pelo relatório, em vez de adivinhar o seu resultado.
As suas correções são preservadas quando o relatório chega.
Um relatório pendente não conta como verificação de registo concluída nem como aprovação automática, e a faturação do registo usa o nível efetivamente entregue.
Submissão manual
Se a empresa não for encontrada no registo, submeta os dados da empresa manualmente. A sessão continua com os dados fornecidos, e
is_from_registry fica definido como false.Dados obtidos
Estados da empresa
Indicador de origem dos dados
Cada registo de empresa inclui uma flagis_from_registry:
true: os dados foram obtidos de um registo oficial de empresasfalse: os dados foram introduzidos manualmente porque a empresa não foi encontrada no registo
fetch_status indica se a consulta ao registo foi concluída, falhou ou ainda está em curso.
Níveis de dados e preços
No fluxo alojado, a seleção de uma empresa implica o custo da consulta ao registo, mesmo que o candidato saia antes de confirmar os dados ou de concluir a verificação. Se o relatório estiver pronto no momento da seleção, o nível entregue é cobrado de imediato. Se a propriedade ainda estiver pendente, o Lite é cobrado na seleção e só a diferença de preço é cobrada quando um nível superior for entregue. Se a propriedade não estiver disponível, não se aplica qualquer sobretaxa de propriedade. O total usa os preços cotados na seleção e nunca excede a cotação do nível pedido. A seleção e qualquer ajuste posterior de propriedade contam como uma única consulta ao registo; a leitura do relatório adquirido ou a confirmação dos seus dados não volta a cobrar essa consulta. Os contratos de tarifa fixa existentes contabilizam uma consulta ao registo na seleção, sem uma segunda unidade contratual para a entrega posterior da propriedade. As pesquisas em fluxos alojados não têm taxa de pesquisa separada. As pesquisas feitas diretamente pela API podem implicar uma taxa de $0.50 por pedido bem-sucedido; consulte faturação de pesquisas. Consulte preços do registo KYB para a tabela completa por país.
Um fluxo alojado escolhe o nível por país em Workflows → KYB Registry Check → Countries. Quando o registo não tem nenhum registo de propriedade para uma empresa, um pedido de Shareholders ou UBOs é entregue e cobrado ao nível mais alto que os registos do país conseguem fornecer, normalmente Lite.
Uma empresa não encontrada e introduzida manualmente (
is_from_registry: false) é cobrada um valor fixo de $0.75: a pesquisa foi executada, mesmo que não tenha sido devolvido nenhum registo.
Exemplo: resposta do nível Lite
Exemplo: resposta do nível Lite
O Lite devolve apenas o perfil da empresa, sem acionistas, UBOs nem estrutura de propriedade:O nível Shareholders acrescenta
ownership_structure e as entradas de acionistas, bem como os administradores e diretores. O nível UBOs resolve ainda os beneficiários efetivos com as respetivas percentagens de propriedade. Consulte Propriedade e Administradores e diretores.Dados do registo vs dados fornecidos pelo utilizador
A Didit mantém os dados devolvidos pelo registo e os dados confirmados pelo utilizador como registos de auditoria separados, com uma vista canónica unificada usada pelas verificações posteriores. Cada empresa tem três blocos relacionados:
O carimbo temporal
confirmed_by_user_at marca o momento em que o utilizador final confirmou ou editou os dados do registo. Enquanto esse carimbo estiver nulo e is_editable for true, o utilizador final pode continuar a alterar os campos dentro do fluxo alojado.
Para as empresas introduzidas manualmente (is_from_registry: false), user_provided_data é a única fonte e is_editable passa a false depois de o utilizador submeter os dados.
Os analistas podem ver as duas fontes lado a lado na revisão da sessão na Business Console e comparar o que o registo indicou com o que o utilizador confirmou.
Campos configuráveis do formulário de registo
Controla quais os campos de dados da empresa que o fluxo de verificação alojado pede durante o passo de confirmação do registo. Configure-os no Business Console: abra o editor de fluxos, selecione o nó KYB Registry check e mude para o separador Campos. Cada campo tem um dos três estados:
Três campos são sempre apresentados e são sempre obrigatórios, porque identificam a empresa e não podem ser configurados:
company_name, country_code e region (estado/região, quando o registo é regional).
Os 16 campos configuráveis:
registration_number, incorporation_date, legal_address, vat_number, alternative_names, tax_number, company_type, legal_entity_identifier, location_of_registration, nature_of_business, registered_capital_amount, registered_capital_currency, website, email, phone, control_scheme
Por predefinição, e para todos os fluxos existentes, apenas incorporation_date é Obrigatório; todos os outros campos configuráveis são Opcionais, pelo que o formulário se comporta exatamente como se comportava antes desta definição existir.
A obrigatoriedade é aplicada no servidor: se o formulário de registo for submetido com um campo obrigatório vazio, a resposta é 400 com mensagens de erro por campo, e a interface alojada apresenta apenas os campos ativados. Na API de fluxos, a definição é o objeto kyb_registry_fields_config no nó KYB Registry; consulte configurações de funcionalidades para a estrutura.
O
vat_number marcado como Obrigatório só é exigido para empresas constituídas num país da UE com IVA (ver abaixo). Para todos os outros países, o campo é tratado como opcional, mesmo quando está marcado como obrigatório, porque não há número de IVA da UE a recolher. O tax_number continua a ser validado quando for fornecido.Validação de IVA e número de identificação fiscal
Quando o passo do registo é submetido, a Didit valida ovat_number da empresa na fonte oficial do respetivo país.
Uma empresa sem vat_number tem o tax_number validado em vez disso.
O número pode ser submetido com ou sem o prefixo do país e com quaisquer separadores (DE 123 456 789, DE123456789 e 123456789 são equivalentes para uma empresa alemã).
Registos oficiais. Nestes países, o número é verificado em tempo real no registo governamental ou oficial de empresas, que também devolve o nome registado (e, na maioria dos casos, a morada):
Um SIREN ou SIRET francês, um RSIN neerlandês ou um número fiscal húngaro completo, submetido como número de IVA, é convertido no número de IVA correspondente antes de ser verificado.
Os números de IVA gregos são verificados automaticamente com o prefixo
EL.
Regras de dígito de controlo. Nestes países não é possível consultar nenhum registo, pelo que o número é verificado segundo o formato oficial e as regras de dígito de controlo do país: Albânia, Andorra, Argentina, Austrália, Azerbaijão, Bielorrússia, Canadá, Chile, China, República Dominicana, Egito, El Salvador, Gana, Guatemala, Islândia, Índia, Indonésia, Israel, Japão, Quénia, Listenstaine, México, Moldávia, Mónaco, Montenegro, Marrocos, Moçambique, Nova Zelândia, Macedónia do Norte, Peru, Rússia, São Marinho, Sérvia, Singapura, África do Sul, Coreia do Sul, Taiwan, Tailândia, Tunísia, Türkiye, Ucrânia, Reino Unido, Estados Unidos, Uruguai, Venezuela e Vietname.
Estas regras aplicam-se também na UE quando um tax_number é um número de identificação fiscal nacional sem número de IVA a verificar, como um Steuernummer alemão.
Um tax_number identifica apenas um número fiscal, não um registo de IVA. Assim, quando o VIES não o listar, o resultado recorre a estas regras em vez de invalid.
As empresas de qualquer outro país recebem vat_validation_status: "not_applicable".
O mesmo acontece com as sessões de sandbox, que nunca contactam um registo fiscal.
O resultado fica guardado na empresa e é exposto no payload de decisão KYB:
vat_validation_source é um dos seguintes valores: eu_vies, pl_vat_white_list, no_brreg, ch_uid_register, br_receita_federal, co_rues, cr_hacienda, ec_sri, py_dnit ou format_rules.
Quando um número está valid, invalid, format_valid ou invalid_format, o resultado é mantido durante o resto da sessão e o registo não é consultado novamente, a menos que o número mude.
Validação cruzada do nome. Quando o número está valid e a fonte divulga o nome registado, a Didit compara-o de forma aproximada com o nome da empresa submetido.
Uma divergência significativa gera o aviso KYB_COMPANY_VAT_NAME_MISMATCH sem alterar o estado da sessão: trata-se de um sinal indicativo para os revisores.
O respetivo additional_data inclui registry_name, registry_source e submitted_name, além de vies_name quando a fonte é o VIES.
Alguns Estados-Membros da UE não divulgam o nome nem a morada. Nesses casos, os campos vêm vazios e não é feita nenhuma comparação.
Ações configuráveis. Duas definições do nó de verificação do registo KYB controlam o que uma verificação sem êxito faz à sessão (valores REVIEW, DECLINE, NO_ACTION):
Um
tax_number com invalid_format é reportado no payload sem acionar nenhuma ação, porque o campo fiscal de texto livre muitas vezes contém outro identificador da empresa.
Cada resultado também gera o aviso correspondente (KYB_COMPANY_VAT_INVALID, KYB_COMPANY_VAT_COULD_NOT_VALIDATE) na verificação do registo. Consulte avisos de verificação de empresas.
Cruzamento de dados
A Didit compara automaticamente os dados fornecidos pelo utilizador ou canónicos com os devolvidos pelo registo e com os dados OCR extraídos dos documentos carregados:- Nome da empresa: correspondência aproximada, para ter em conta abreviaturas e diferenças de formatação
- Número de registo: validação de correspondência exata
- País: verificação de consistência entre o país fornecido e o país do registo
- Morada: geocodificação e normalização para comparação
Resumo financeiro
Quando disponível, a Didit obtém do registo dados financeiros resumidos:- Receita ou volume de negócios
- Número de colaboradores
- Códigos de atividade SIC/NACE
- Datas de entrega de documentos e estado de conformidade
Campos adicionais do registo
Consoante a cobertura da jurisdição, a resposta do registo pode incluir também:alternative_names: nomes comerciais, dbas, antigas denominações jurídicaslegal_entity_identifier(LEI): para instituições financeiras e entidades cotadaswebsite,email,phone: dados de contacto constantes do registonature_of_business: breve descrição (no idioma do registo)registered_capital: capital autorizado ou emitido, como objeto{amount, currency}
business da decisão KYB.
Confiança e estado de verificação
Cada resposta do registo inclui umverification_status:
Combine com
is_from_registry para orientar a sua própria lógica a jusante:
Resultados do cruzamento de dados
Cada cruzamento é executado campo a campo e devolve um dos seguintes valores:MATCH: os dados fornecidos coincidem com o registo.MISMATCH: divergência significativa. Assinalada como aviso.NO_DATA: um dos lados estava vazio; não é possível fazer a comparação.
O que determina o resultado
O estado da empresa, o país de constituição, os resultados AML e a correspondência com os dados declarados alimentam a decisão como etiquetas de aviso na verificação do registo e na triagem AML. O seu fluxo decide se cada aviso conduz à aprovação, à revisão ou à recusa. Consulte a avaliação de risco para ver os sinais e as chaves do fluxo que os controlam.Países suportados
A cobertura varia consoante o país: consulte países suportados para ver a distribuição de níveis por região.Próximos passos
Propriedade
Identificação de UBO e cadeias de propriedade.
Esquema da resposta
Onde cada campo aparece no payload.
Países suportados
Cobertura por região.