Enviar um arquivo CSV

Use este procedimento para enviar pedidos, produtos ou cadastros para uma integração por meio de um arquivo CSV, sem depender do fornecedor do ERP.

Você precisa ter o papel Administrador ou Operador. Antes de enviar, confira se:

• o WMS de destino está conectado e testado em Conexões;
• o tipo de importação para esse WMS está ativo e tem um De/Para publicado. Você pode configurá-lo na tela de envio, como descrito abaixo.

Como acessar

Em Importações, clique em Nova importação. A tela Nova importação abre.

Escolher o destino

1. Em Tipo de arquivo, selecione o tipo de registro;
2. Em Destino, escolha o WMS que recebe os dados;
3. Se aparecer Este tipo de importação ainda não foi configurado, clique em Configurar este tipo de importação;
4. Revise e publique o De/Para antes de confirmar a importação. Veja Publicar o De/Para.

Cada tipo de importação relaciona um tipo de arquivo a um WMS de destino. Ele não tem agendamento: a execução depende da confirmação de um arquivo enviado.

Baixar o modelo

1. Selecione o tipo de registro: Pedidos, Produtos ou Cadastros;
2. Confira a tabela de colunas. Ela mostra, para cada coluna, o Tipo, se é Obrigatória e um Exemplo;
3. Clique em Baixar o modelo de arquivo.

O modelo baixado é um arquivo CSV com a linha de cabeçalho e uma linha de exemplo, separadas por ponto e vírgula. Apague a linha de exemplo antes de preencher os seus dados.

Regras do arquivo

Regra	Como deve ser
Formato	Arquivo CSV, com a primeira linha de cabeçalho.
Codificação	UTF-8. Um arquivo salvo em Windows-1252, comum no Excel, também é aceito e convertido na leitura.
Separador	Ponto e vírgula (;) ou vírgula (,). Prefira o ponto e vírgula, porque a vírgula também separa os decimais. Um valor que contém o separador precisa estar entre aspas (").
Nomes das colunas	Iguais aos da tabela. Letras maiúsculas, acentos, espaços e sublinhados não fazem diferença: Número do Pedido vale como numero_pedido. Use os nomes do modelo baixado para evitar dúvidas.
Colunas a mais	São ignoradas. A tela de conferência avisa quais foram ignoradas.
Números decimais	No formato brasileiro, como 1.234,56 ou 1234,56.
Datas	No formato DD/MM/AAAA, como 31/12/2026.
Sim ou não	S, Sim, 1, V, true para sim. N, Não, 0, F, false para não.
Lista fechada	Só os valores da lista, em maiúsculas ou minúsculas.
Colunas de identificação	Identificam os registros já entregues. Em pedidos, use a combinação de numero_pedido e item; em produtos, codigo_produto e codigo_embalagem; em cadastros, cnpj_cpf. A identificação não pode se repetir no arquivo.
Tamanho	Até 50 MB e 200000 linhas por arquivo.

Dica

Enviar o mesmo arquivo de novo não duplica nada. Os registros que já foram entregues não são entregues outra vez.

Mantenha juntas as linhas do mesmo numero_pedido e, nos arquivos de produtos, as linhas do mesmo codigo_produto. Depois de começar outro pedido ou produto, não volte ao anterior. Se uma linha for recusada por estar fora dessa sequência, agrupe as linhas do pedido ou produto antes de reenviar.

Colunas de Pedidos

Coluna	Tipo	Obrigatória	Observação
numero_pedido	Texto	Sim	Parte da identificação do registro. Até 20 caracteres.
item	Número inteiro	Sim	Parte da identificação do registro.
data_pedido	Data	Sim
cnpj_cliente	Texto	Sim	Até 18 caracteres.
nome_cliente	Texto	Sim	Até 60 caracteres.
tipo_pessoa	Lista fechada	Não	Valores: F, J.
endereco	Texto	Sim	Até 80 caracteres.
numero	Texto	Não	Até 10 caracteres.
complemento	Texto	Não	Até 50 caracteres.
bairro	Texto	Não	Até 50 caracteres.
cep	Texto	Não	Até 9 caracteres.
cidade	Texto	Não	Até 40 caracteres.
uf	Texto	Não	Até 2 caracteres.
codigo_produto	Texto	Sim	Até 20 caracteres.
descricao_produto	Texto	Não	Até 80 caracteres.
quantidade	Número inteiro	Sim
observacao	Texto	Não	Até 200 caracteres.

Colunas de Produtos

Coluna	Tipo	Obrigatória	Observação
codigo_produto	Texto	Sim	Parte da identificação do registro. Até 20 caracteres.
codigo_embalagem	Texto	Sim	Parte da identificação do registro. Até 60 caracteres.
descricao	Texto	Sim	Até 80 caracteres.
ncm	Texto	Sim	Até 10 caracteres.
unidade	Lista fechada	Sim	Valores: UN, CX, KG, L, M.
quantidade_por_embalagem	Número inteiro	Sim
codigo_barras	Texto	Sim	Até 20 caracteres.
altura_mm	Número inteiro	Sim
largura_mm	Número inteiro	Sim
comprimento_mm	Número inteiro	Sim
peso_bruto_g	Número inteiro	Sim
peso_liquido_g	Número inteiro	Sim
ativo	Sim ou não	Não

Colunas de Cadastros

Coluna	Tipo	Obrigatória	Observação
cnpj_cpf	Texto	Sim	Parte da identificação do registro. Até 18 caracteres.
razao_social	Texto	Sim	Até 120 caracteres.
tipo	Lista fechada	Sim	Valores: CLIENTE, FORNECEDOR, TRANSPORTADORA.
cep	Texto	Não	Até 9 caracteres.
cidade	Texto	Não	Até 80 caracteres.
uf	Texto	Não	Até 2 caracteres.

Enviar o arquivo

1. Com o tipo de registro certo selecionado, vá até Enviar o arquivo;
2. Em Arquivo CSV, selecione o arquivo no seu computador;
3. Clique em Enviar e conferir.

A tela da importação abre com a situação Pronto para importar.

Conferir e confirmar

Na seção Confira antes de importar, a tela mostra o separador e a codificação identificados no arquivo e as cinco primeiras linhas, como estão no arquivo.

As primeiras linhas mostram os valores como estão no arquivo. Confira se os acentos, as datas e os números aparecem corretamente.

1. Confira se os acentos, os números e as datas das primeiras linhas estão certos;
2. Leia as observações, se houver. Se a tela disser Provável — confirme ou Ambíguo — confirme, confira o separador com atenção;
3. Em Separador, deixe selecionado o separador do seu arquivo: Ponto e vírgula ( ; ) ou Vírgula ( , );
4. Clique em Confirmar e importar.

Atenção

Se o separador for a vírgula e o arquivo tiver colunas de número decimal, a tela avisa: Este arquivo tem colunas numéricas e o separador identificado é a vírgula. Como a vírgula também separa os decimais, confira as linhas abaixo com atenção. Nesse caso, salve o arquivo de novo usando ponto e vírgula como separador e envie-o outra vez.

Depois da confirmação

Após a confirmação aceita, aparece Arquivo confirmado. A importação está na fila. A situação passa para Na fila e depois para Importando durante a leitura. A execução aparece em Execuções, com a origem Manual.

Ao terminar, o arquivo mostra Importado ou Importado com recusas, conforme o resultado. Confira os registros entregues e recusados na tela da importação.

Se a confirmação for recusada porque o tipo está pausado ou inativo, o De/Para não está publicado ou outra importação está em andamento, corrija a condição indicada e clique em Confirmar e importar novamente no mesmo arquivo. A tela informa quando é necessário enviar outro arquivo.

flowchart LR
  A[Enviar e conferir] --> B{Arquivo legível?}
  B -->|não| C[Arquivo recusado, nada é importado]
  B -->|sim| D[Confira antes de importar]
  D --> E[Confirmar e importar]
  E --> F[Execução lê o arquivo]
  F --> G[Linhas certas são entregues]
  F --> H[Linhas com problema viram linhas recusadas]

Arquivo recusado

Se o arquivo inteiro tiver um problema, ele é recusado no envio e nada é importado. A tela mostra O arquivo foi recusado e nada foi importado. e o motivo:

Motivo	O que fazer
O arquivo está vazio.	Confira se você escolheu o arquivo certo.
O arquivo não está em UTF-8 e não pôde ser lido.	Salve o arquivo de novo como CSV UTF-8.
O arquivo não tem linha de cabeçalho.	Inclua a linha de cabeçalho do modelo.
O arquivo não tem a coluna obrigatória “{coluna}”.	Inclua a coluna indicada.
O cabeçalho repete a coluna “{coluna}”.	Deixe a coluna uma vez só.
O arquivo ultrapassa o limite de {limite} bytes.	Divida o arquivo em partes menores.

Alguns problemas só aparecem quando a execução lê o arquivo inteiro, depois da confirmação. Nesse caso, a execução falha com a frase Não foi possível ler o arquivo, e nenhuma linha foi enviada. Os motivos possíveis são:

• O arquivo ultrapassa o limite de {limite} linhas. Divida o arquivo em partes menores;
• O arquivo terminou no meio de um campo entre aspas. Confira se todas as aspas foram fechadas;
• O arquivo não está em UTF-8 e não pôde ser lido. Salve o arquivo de novo como CSV UTF-8.

Veja como ler a execução em Investigar uma execução.

Linhas recusadas

Uma linha com problema não impede a importação das outras: ela fica de fora, e as demais seguem para o destino. As primeiras linhas com problema já aparecem na conferência, com o motivo no lugar dos valores. Depois da execução, todas aparecem em Linhas recusadas, na tela da importação.

Os motivos de recusa de uma linha são:

• A coluna obrigatória “{coluna}” está vazia.
• A coluna identificadora “{coluna}” está vazia.
• O identificador “{valor}” da coluna “{coluna}” já apareceu antes neste arquivo.
• A coluna “{coluna}” tem “{valor}”, que não é um número válido.
• A coluna “{coluna}” tem “{valor}”, que não é uma data válida.
• A coluna “{coluna}” tem “{valor}”, que não foi reconhecido como sim nem como não.
• A coluna “{coluna}” tem “{valor}”, fora dos valores aceitos: {valores}.
• A coluna “{coluna}” ultrapassa o limite de {tamanho} caracteres.
• A linha tem {encontradas} colunas e o cabeçalho tem {esperadas}.

Para corrigir:

1. Na tela da importação, clique em Baixar as linhas recusadas;
2. Corrija as linhas no arquivo baixado;
3. Envie o arquivo corrigido, seguindo Enviar o arquivo.

O arquivo baixado tem, além das colunas do modelo, as colunas linha e motivo_da_rejeicao. A coluna motivo_da_rejeicao traz o motivo da recusa por extenso. As duas colunas não fazem parte do modelo e são ignoradas no novo envio.

Saiba mais em Importações.