Ver categorias

Templates de Importação (planilha): campos e onde buscar

2 minutos de leitura

Atualizado em 19/09/2026

🛠️ Referência. As colunas de cada importação por planilha e onde o sistema busca cada campo. (A importação de Nota Fiscal por XML é diferente — veja Como Registrar uma Nota Fiscal de Entrada.)

Como funciona a importação por planilha #

Cada importação espera uma planilha com colunas específicas. Regras gerais:

  • Campos que referenciam outro cadastro são informados pelo identificador externo daquele cadastro (ex.: o produto é informado pelo id externo do produto; o armazém pelo id externo do armazém).
  • Fornecedor / Destinatário aceitam identificador externo, CPF ou CNPJ (destinatário também CPE).
  • Unidade de medida é buscada pelo nome.
  • Campos Sim/Não aceitam S/N; Status usa A (ativo) / I (inativo); datas no formato dd/MM/yyyy (algumas aceitam hora).
💡 “Onde buscar cada campo no sistema”: os valores de vínculo (produto, armazém, contrato, fornecedor) são os identificadores externos que você definiu no cadastro de cada um. Se a importação não encontra, confira o id externo no cadastro correspondente.

Importar Produtos #

Coluna Obrigatória? Onde buscar / observação
Fornecedor (id externo, CPF ou CNPJ) ✅ Cadastro de Fornecedores (id externo/CPF/CNPJ)
Nome ✅ —
Limite do pallet virtual ✅ Número
Descrição — —
Tipo (inteiro / fracionado fixo / fracionado variável / particionado) — —
Identificação externa — Código do produto no seu sistema
Fator de multiplicação (fracionado fixo) — Número
Limite do bloco — Número
Unidade de medida (Recebimento) — Cadastro de Unidades (pelo nome)
Unidade de medida (Expedição) — Cadastro de Unidades (pelo nome)
Série / Lote / Peso / Valor / Data fabricação / Data validade — como dado complementar (S/N) — S/N
Código de barras (BARCODE/GTIN) — —
Status (A/I) — A = ativo, I = inativo
Identificação externa do contrato — Cadastro de Contratos (id externo)
Código de integração (APIs externas) — —

Importação de Expedição #

Coluna Obrigatória? Onde buscar / observação
Destinatário (id externo, CPF, CNPJ ou CPE) ✅ Cadastro de Pessoas/Clientes
Armazém (id externo) ✅ Cadastro de Armazéns (id externo)
Produto ou Kit (id externo) ✅ Cadastro de Produtos (id externo)
Quantidade ✅ Número
Identificador externo da expedição — Seu número de pedido/operação
Série / Lote / Peso / Valor unitário / Data fabricação / Data validade do item — Dados complementares do item
Identificação externa do contrato — Cadastro de Contratos (id externo)
Data de agendamento — dd/MM/yyyy (ou com hora)
Número do Pedido / Número da NF / Série da NF / Valor da operação — —
Expedição de Transferência (S/N) — S/N
Armazém de destino da transferência (id externo) — Cadastro de Armazéns (id externo)
Nº do Recebimento/Etapa de referência (ex.: 1234/1) — Recebimento existente (número/etapa)

Importar Recebimento (planilha) #

Mesmas colunas da Expedição, aplicadas à entrada: Remetente (id externo/CPF/CNPJ), Armazém (id externo), Produto (id externo) e Quantidade são as principais; os demais (dados complementares do item, contrato, data de agendamento, número/série da NF, número do pedido, valor) são opcionais.

Importar Estoque #

Coluna Observação
Identificação externa do contrato Cadastro de Contratos
Armazém (id externo) Cadastro de Armazéns
Endereçamento (id externo) Cadastro de Endereçamento
Produto (id externo) Cadastro de Produtos
Endereço Texto do endereço (opcional)
Quantidade de Etiquetas ✅ Número
Série inicial / Lote / Peso / Valor / Data fabricação / Data validade / Livre 1 / Livre 2 Dados complementares (aplicados às frações)

Importar Endereçamento (Produto × Endereço) #

Coluna Observação
Identificação externa do contrato Cadastro de Contratos
Armazém (id externo) Cadastro de Armazéns
Endereçamento (id externo) Cadastro de Endereçamento
Produto (id externo) Cadastro de Produtos
Padrão do Endereço Use * para considerar todos

Importar Pessoas (Clientes/Fornecedores) #

Principais colunas: Razão social/Nome (150), Nome fantasia (100), Identificação externa (20), Prefixo GS1 (25), Status (A/I), IE, Passaporte, Nacionalidade, e endereço completo (CEP, endereço, complemento, bairro, cidade, UF, país) e telefone (apenas números). Os tamanhos máximos estão indicados no próprio cabeçalho do template.

Perguntas Frequentes #

A importação acusou “produto não cadastrado”. Por quê?

O valor informado precisa ser o identificador externo do produto (o mesmo do cadastro). Confira o id externo em Dados Básicos → Produtos (veja Cadastro de Produtos (SKUs) e Unidades de Medida).

Onde consigo o modelo (planilha) de cada importação?

Na própria tela de importação (menu Importar), que traz o modelo com as colunas na ordem esperada.

Posso deixar colunas em branco?

Sim, as colunas opcionais podem ficar vazias. As obrigatórias (marcadas com ✅) precisam ser preenchidas.

Artigos Relacionados #

Não resolveu sua dúvida?

Nossa equipe de suporte ajuda você.

Falar com o suporte

Rolar para cima