Importar e Exportar Utilizadores: Operações em Massa CSV

A Business Console permite à sua equipa gerir em massa entidades de Utilizador sem escrever código. Há dois fluxos suportados: importação CSV (criar ou atualizar utilizadores em grande escala) e exportação CSV (extrair a tabela de utilizadores para ferramentas externas).

A importação e exportação em massa aqui criam ou atualizam apenas perfis de Utilizador. Não recriam sessões KYC históricas, avisos de documentos, provas de vida nem decisões do fornecedor. Para uma migração completa a partir de Sumsub, MetaMap, Veriff, Onfido, Persona ou outro fornecedor, consulte Importar dados de outro fornecedor.

Importar utilizadores a partir de CSV

Quando usar

Migração no primeiro dia a partir de outro fornecedor de KYC: trazer a lista de utilizadores existente.
Migração de imagens faciais de fornecedor: anexar imagens faciais fidedignas aos perfis de Utilizador importados, depois de as linhas serem criadas.
Onboarding em massa da lista de clientes de um parceiro.
Preenchimento retroativo de metadados: atualizar etiquetas, nível ou identificadores internos de muitos utilizadores de uma só vez.

Colunas do modelo

Transfira o modelo em Utilizadores → Importar → Transferir modelo. Colunas:

Coluna	Obrigatório	Descrição
`vendor_data`	Sim	O seu identificador para o utilizador. Tem de ser único por aplicação.
`display_name`	Não	Nome legível apresentado na consola.
`full_name`	Não	Nome legal. Será substituído pelos dados da sessão verificada.
`email`	Não	Endereço de e-mail de contacto conhecido.
`phone`	Não	Número de telefone de contacto conhecido (formato E.164).
`country`	Não	Código de país ISO 3166-1 alfa-3.
`status`	Não	`ACTIVE`, `FLAGGED` ou `BLOCKED`. Predefinido: `ACTIVE`.
`tags`	Não	Etiquetas separadas por vírgulas.
`metadata_json`	Não	JSON serializado como texto para metadados personalizados.

Executar a importação

Carregar o CSV

Aceda a Utilizadores → Importar → Carregar CSV e selecione o seu ficheiro.

Rever a pré-visualização

A consola valida cada linha. As linhas inválidas são realçadas com os motivos do erro (por exemplo, vendor_data duplicado ou código de país inválido).

Iniciar a importação

A Didit processa as linhas de forma assíncrona. Pode fechar o separador: o progresso é acompanhado em Utilizadores → Histórico de importações.

Rever os resultados

Quando a importação terminar, o histórico mostra o número de linhas criadas, atualizadas e ignoradas, além de um relatório de erros para transferir.

Atualizar ou criar

Se um vendor_data não existir, é criado um novo Utilizador.
Se um vendor_data já existir, a linha atualiza o Utilizador existente (campos de perfil e metadados).
Os contadores agregados e os campos verificados (full_name, date_of_birth das sessões aprovadas) nunca são substituídos por importações.

Importar imagens faciais depois de criar o utilizador

A importação CSV cria ou atualiza a linha do Utilizador. Não inclui imagens faciais no CSV. Para trazer dados biométricos faciais de outro fornecedor, carregue cada face depois de o Utilizador de destino existir:

Criar ou importar o Utilizador

Use a importação CSV da consola ou chame POST /v3/users/create/ num ciclo.

Ler o didit_internal_id

Obtenha o Utilizador com GET /v3/users/{vendor_data}/. A resposta inclui didit_internal_id.

Carregar a face

Chame

POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/

com uma imagem facial em base64 não processada.

curl -X POST https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/$DIDIT_INTERNAL_ID/faces/upload/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<base64-encoded-jpg-or-png>",
    "comment": "Imported from previous KYC provider"
  }'

A face tem de ser uma imagem válida, com no máximo 2 MB após descodificação, e tem de conter um rosto detetável. A Didit guarda-a no perfil e indexa-a para deteção de duplicados e pesquisa facial. Não é adicionada a uma lista de bloqueio de faces, a menos que utilize separadamente o endpoint Carregar face para lista.

Exportar utilizadores para CSV

Quando usar

Auditorias de conformidade: entregar a tabela completa de utilizadores aos auditores.
Sincronização com um armazém de dados: exportação periódica para as suas ferramentas de BI.
Pedidos de SAR ou de reguladores: extrair subconjuntos filtrados de utilizadores.

Executar uma exportação

Aceda a Utilizadores → Exportar.
Aplique filtros (estado, país, intervalo de datas, pesquisa).
Escolha as colunas (por predefinição, estão incluídos todos os campos; pode remover as colunas de que não precisa).
Submeta. A Didit gera a exportação de forma assíncrona e envia por e-mail uma ligação de transferência assinada ao operador que a pediu.

As exportações incluem apenas os dados que a sua função tem permissão para ler. As funções COMPLIANCE_OFFICER e superiores podem exportar a tabela completa; as funções DEVELOPER e READER têm exportações restritas.

Características de desempenho

Operação	Escala típica	Notas
Importação	Até 100.000 linhas	Os ficheiros maiores são divididos em blocos do lado do servidor; o progresso é consultado pela interface
Exportação	Até 1.000.000 de linhas	As exportações maiores são transmitidas para o S3 e entregues através de um URL assinado

Registo de auditoria

Cada importação e exportação fica registada no registo de auditoria:

O operador que a iniciou.
Número de linhas (importações) / instantâneo dos filtros (exportações).
Data e hora e estado de sucesso ou falha.

Próximos passos

API para criar utilizadores

Criação programática para importações por script.

Carregar face do utilizador

Anexe imagens faciais importadas aos perfis de Utilizador.

Conservação de dados

Durante quanto tempo os dados importados são mantidos.

Registos de auditoria

Consulte o histórico de importações e exportações.

Visão geral

Preços

Fluxos e verificação

Revisão e operações

Entidades (utilizadores e empresas)

Definições e personalização

Segurança e conformidade

Didit Academy

Recursos

Importar e Exportar Utilizadores: Operações em Massa CSV

Importar utilizadores a partir de CSV

Quando usar

Colunas do modelo

Executar a importação

Atualizar ou criar

Importar imagens faciais depois de criar o utilizador

Exportar utilizadores para CSV

Quando usar

Executar uma exportação

Características de desempenho

Registo de auditoria

Próximos passos

API para criar utilizadores

Carregar face do utilizador

Conservação de dados

Registos de auditoria

​Importar utilizadores a partir de CSV

​Quando usar

​Colunas do modelo

​Executar a importação

​Atualizar ou criar

​Importar imagens faciais depois de criar o utilizador

​Exportar utilizadores para CSV

​Quando usar

​Executar uma exportação

​Características de desempenho

​Registo de auditoria

​Próximos passos

API para criar utilizadores

Carregar face do utilizador

Conservação de dados

Registos de auditoria

Importar utilizadores a partir de CSV

Quando usar

Colunas do modelo

Executar a importação

Atualizar ou criar

Importar imagens faciais depois de criar o utilizador

Exportar utilizadores para CSV

Quando usar

Executar uma exportação

Características de desempenho

Registo de auditoria

Próximos passos