Oriun
Clientes e Fornecedores Clientes

Publicado em 15/03/2026 · 8 min

Importar clientes por CSV

Use este guia para migrar clientes em massa para o Oriun com o wizard de importacao CSV, incluindo template, mapeamento, validacao, preview e resultado final.

Antes de comecar

  • Entre na empresa correcta antes de importar.
  • Prepare o ficheiro CSV com os campos suportados pelo cadastro actual de clientes.
  • Se tiver duvidas, baixe primeiro o template oficial da propria tela.

1. Abrir a tela e baixar o template

No menu Cadastros, abra Clientes e clique em Importar CSV. Na etapa inicial pode carregar o ficheiro e baixar o template oficial para confirmar a estrutura esperada.

Tela inicial do wizard de importacao de clientes com upload e botao de template

Figura 1. Etapa de upload do wizard de importacao de clientes.

2. Configurar a leitura do ficheiro

Depois de carregar o CSV, confirme a codificacao, o delimitador, o separador decimal e se a primeira linha deve ser tratada como cabecalho.

Etapa de configuracao do ficheiro CSV de clientes com encoding delimitador e cabecalho

Figura 2. Configuracao do ficheiro CSV antes do mapeamento.

3. Mapear as colunas do CSV

Associe cada coluna do ficheiro aos campos de destino no Oriun, como codigo, nome, NUIT, email e contactos. Nesta etapa tambem escolhe a estrategia para duplicados.

Etapa de mapeamento de colunas do CSV para os campos de clientes do Oriun

Figura 3. Mapeamento das colunas CSV para os campos do cadastro de clientes.

4. Validar e rever o preview

Clique em Validar e gerar preview para ver o estado de cada linha. O Oriun classifica as linhas como valid, warning ou error, e mostra a accao prevista para cada registo.

Preview validado da importacao de clientes com resumo de prontas avisos e erros

Figura 4. Preview com o resumo da validacao antes da importacao final.

Se houver erros, use Baixar relatorio de erros, corrija o ficheiro e repita o processo. Linhas invalidas nao bloqueiam a importacao das linhas validas.

5. Confirmar a importacao

Quando o preview estiver correcto, avance para a etapa de confirmacao. O resumo mostra quantas linhas vao ser importadas, actualizadas ou ignoradas.

Etapa de confirmacao da importacao de clientes com resumo final antes de executar

Figura 5. Confirmacao final antes de importar clientes.

6. Rever o resultado final

Depois de executar a importacao, o Oriun apresenta o resultado final com totais, linhas prontas, avisos, erros, actualizacoes e ignoradas. Se existirem ocorrencias, pode baixar o relatorio de erros a partir desta tela.

Resultado final da importacao de clientes com resumo dos totais processados

Figura 6. Resultado final do wizard de importacao de clientes.

Validacoes e cuidados

  • O campo nome e obrigatorio.
  • Quando preenchidos, NUIT e email precisam de formato valido.
  • Use Ignorar existentes para saltar duplicados ou Actualizar existentes para actualizar clientes ja registados.
  • Importe sempre na empresa activa correcta para evitar cruzamento de dados.

Artigos relacionados

  • criar-editar-clientes
  • emitir-factura-oriun

Este artigo foi útil?

Útil: 0 · Pode melhorar: 0