Colunas, unidade, filial e formatação de um modelo de exportação de pedido

Onde fica

No menu da sua conta, em Catálogo e exportações, na aba Orçamentos e pedidos, no cartão Modelos de orçamento e pedido. As regras abaixo aparecem ao abrir um modelo padrão (CSV e TXT, Excel, PDF) ou ao criar e editar um modelo customizado.

Abrir um modelo leva à tela do modelo: a lista some, e a seta no alto (ou o Voltar do navegador) devolve à lista. O editor é dividido em blocos que abrem e fecham, e cada um mostra um resumo quando está fechado: Colunas (o primeiro, já aberto), Cabeçalho e totais (só no modelo do orçamento enviado, aberto pela linha Orçamento enviado da lista Modelos), Unidade, filiais e página (nos padrões de CSV e de Excel, Unidade e filiais) e Formatação. Todo modelo que já existe salva sozinho: o rodapé diz Salvo automaticamente a cada mudança gravada.

As colunas do arquivo do pedido

No bloco Colunas, cada botão com + acrescenta uma coluna; clicar de novo tira. As colunas escolhidas aparecem numa tabela com Campo, Rótulo e Ordem:

• Rótulo é o título que sai no cabeçalho do arquivo; você pode reescrever;
• as setas de Ordem sobem e descem a coluna;
• o X tira a coluna.

Os campos vêm em grupos, pelo que cada coluna diz:

• Produto: Código, Descrição, Unidade, Grade, Código de barras (EAN) (o código da peça), Código da caixa (DUN) (o da caixa fechada), Imagem, Ref. do Comprador (o código que o cliente escreveu) e Cód. via Match;
• Quantidade e preço: Quantidade, Preço de Tabela, Desconto (%), Desconto por unidade, Desconto da linha, Preço Líquido e Preço Final com impostos. O Desconto (%) é o desconto total da linha sobre o Preço de Tabela (o da tabela ou da regra junto com a concessão do vendedor), e é o mesmo por unidade e na linha. Em valor são dois números: o Desconto por unidade é quanto o Preço Líquido ficou abaixo do Preço de Tabela, e o Desconto da linha é ele vezes a quantidade;
• Impostos: Impostos da linha e, para cada imposto que os produtos da organização têm, a alíquota e o valor da linha (por exemplo IPI (%) e IPI (valor));
• Totais: Total da linha (sem impostos) e Total da linha (com impostos);
• Estoque: Situação, Qtd em estoque, Qtd pré-venda e Chegada da pré-venda;
• Entrega: Filial e CNPJ Filial;
• Outros: Observações.

São três preços de uma unidade, e cada um diz se tem imposto:

• Preço de Tabela: o preço da tabela, antes do desconto. Sem impostos;
• Preço Líquido: o preço depois do desconto. Sem impostos. Quantidade vezes este preço dá o total da linha sem impostos;
• Preço Final com impostos: o Preço Líquido mais os impostos de uma unidade.

E o imposto em dinheiro:

• Impostos da linha: a soma de todos os impostos da linha (IPI, ST e os outros), já multiplicados pela quantidade. Linha sem imposto sai em branco;
• IPI (valor), ST (valor) e as outras colunas por imposto: cada imposto separado, para quem precisa ver um por um.

Os totais são da linha (de cada item); o total do documento sai no rodapé. No rodapé da tabela, Impostos da linha soma a coluna inteira.

Um modelo salvo antes de 18/10/2026 pode ter colunas que não são mais oferecidas para modelos novos: Valor do Imposto (só o primeiro imposto da linha, e não a soma; no editor ela aparece como Valor do 1º imposto) e Código de barras (o EAN, ou o DUN quando o produto não tem EAN). Elas continuam saindo como saíam, com o rótulo que o modelo guardou. Para ver o total de impostos da linha, troque Valor do Imposto por Impostos da linha. A coluna Preço Líquido (legado), que dava o mesmo número do Preço Líquido, foi convertida nele em 19/10/2026, com o rótulo que o modelo guardava: o arquivo sai igual.

Em Atributos do catálogo: os atributos que os produtos da organização têm, como NCM ou linha.

Nas colunas de produto, Exibir como, ao lado do rótulo, escolhe como cada uma sai. A foto: Imagem (dentro da célula do Excel e do PDF), Link (um "Ver imagem" que abre sem login, para o cliente que recebe o arquivo) ou Imagem e link. No Excel e no PDF, a foto que o produto tem e que não chegou a tempo vira o link "Ver imagem". Os códigos: Número, Barra (desenhada no Excel e no PDF) ou Número e barra. No CSV a foto sai sempre como o endereço, e o código como o número.

As colunas de estoque (Situação, Qtd em estoque, Qtd pré-venda e Chegada da pré-venda) são só da equipe: saem no arquivo que alguém da equipe baixa e nunca no que vai para o cliente. Por isso o padrão de formato não as oferece.

No bloco Unidade, filiais e página (no padrão de Excel, Unidade e filiais), o campo Itens não encontrados no catálogo escolhe onde sai o item que a cotação não achou no catálogo: Numa nota depois da tabela ou Na tabela, na ordem da cotação. Ele não aparece no padrão de CSV e TXT, que vai para o ERP sem linha fora do catálogo, nem no modelo do orçamento enviado, onde esse item sai sempre na nota.

Modelo de pedido sem nenhuma coluna

Sem colunas escolhidas, o sistema monta um layout automático que varia conforme o documento: acrescenta imagem, o código de barras da peça (EAN), desconto e impostos quando encontra. Escolha as colunas quando precisar de um arquivo sempre igual, por exemplo para um ERP que importa por posição de coluna.

No modelo do orçamento enviado, a tabela de colunas já mostra as que saem hoje, na ordem do papel, e cada uma que só sai em parte das cotações diz quando (por exemplo, só se a cotação tem desconto). Mude direto ali: a primeira mudança grava a lista inteira. Depois de gravada, a imagem, o EAN, o desconto, o preço de tabela e cada imposto continuam saindo no PDF só na cotação que os tem.

As colunas Filial e CNPJ Filial

Filial e CNPJ Filial só saem quando o arquivo tem uma linha por filial, ou seja, num pedido rateado com Uma linha por filial. Num arquivo consolidado elas não saem, mesmo escolhidas: coluna vazia num arquivo que alguém vai importar seria pior que coluna ausente.

Colunas de imposto com os tributos desligados

O modelo vale para todas as lojas da empresa: o editor oferece os campos de tributo quando ao menos uma loja mostra algum tributo no orçamento (a decisão geral da aba Impostos, ou o bloco Orçamentos e pedidos de Ajustar por lugar), qualquer que seja a loja em que você entrou. Com todos os tributos desligados em todas, eles deixam de ser oferecidos. Se um modelo já tinha Impostos da linha, a coluna continua na lista, riscada, com o aviso sem efeito dizendo que os tributos estão todos desligados. No arquivo de uma loja com todos desligados, a coluna não sai. Total da linha (com impostos) continua saindo, sem o "(com impostos)".

O padrão do orçamento

Onde ninguém escolheu colunas, o PDF e o Excel do orçamento saem no padrão: a coluna Unidade logo depois da quantidade (é por ela que o cliente vê se o número é de caixas ou de peças), uma coluna por imposto com só o valor (sem a coluna de porcentagem) e, quando a cotação tem imposto, os dois totais lado a lado, sem impostos e com. Isso vale para o layout automático e para o padrão de fábrica que veio pronto e nunca foi mexido (é o caso de quase todas as empresas), e também para a cópia do pedido que sai no padrão. A pré-visualização da janela Escolher modelo… mostra as mesmas colunas do arquivo que você baixa.

O que não muda: os modelos e padrões em que você mexeu nas colunas (trocou, tirou, acrescentou, mudou a ordem ou o nome de alguma); o CSV e o TXT; o PDF do orçamento enviado ao cliente (e a prévia dele); e a cópia do pedido depois de você ajustar as colunas pela conversa. Para usar o padrão num modelo que você já personalizou, acrescente a Unidade e o Total da linha (sem impostos) no bloco Colunas.

Com todos os tributos desligados na loja, o Total da linha (com impostos) sai do arquivo quando o modelo também tem o Total da linha (sem impostos): sem imposto os dois seriam o mesmo número.

Unidade: peças, caixas ou como está

O campo Unidade, no bloco Unidade, filiais e página, converte as quantidades do arquivo:

• Manter como está: cada linha sai na unidade em que está no pedido;
• Unidades (peças): linhas em caixa viram peças;
• Caixas (pacotes): linhas em peça viram caixas.

Na conversão, o preço unitário é ajustado na mesma proporção, então o total da linha não muda. Unidades que o sistema não reconhece (quilo, por exemplo) ficam como estão.

⚠️ Para converter peças em caixas o sistema precisa saber quantas peças vêm na caixa. Faltando isso, a janela Escolher modelo… mostra Embalagem ausente para conversão em caixas, com um campo Unidades por caixa por item: preencha e clique em Salvar embalagem e pré-visualizar (o valor fica gravado no produto), ou clique em Exportar sem caixas, que troca para um modelo customizado que não converte em caixas; se não houver nenhum, cadastre um com unidade Manter como está. Um atalho ★ que esbarra nisso abre essa janela.

Por filial: uma linha, somar ou um arquivo por filial

O campo Por filial decide o que acontece num pedido rateado entre filiais do cliente:

• Uma linha por filial: uma linha para cada filial, no mesmo arquivo;
• Somar todas as filiais: uma linha por produto com o total de todas as filiais. O arquivo sai sem as colunas de filial e CNPJ;
• Um arquivo por filial (.zip): um arquivo por destino, dentro de um .zip. Só existe nos modelos customizados, e só vale em pedido rateado; sem rateio, sai o arquivo único.

Orientação da página do PDF

Orientação da página (PDF) tem Automática (recomendado), Sempre retrato e Sempre paisagem. Na automática, o PDF mede as colunas e vira para paisagem só quando precisa.

No PDF, o que estoura a folha é a largura das colunas, não a quantidade. Quando não cabe, o documento tenta, nesta ordem: virar para paisagem, apertar as colunas de texto, reduzir a fonte, abreviar os títulos padrão (com legenda no rodapé) e, por fim, desenhar cada item em duas linhas. Títulos que você digitou nunca são abreviados. Para saber o que acontece com as suas colunas, gere o arquivo.

Formatação: caixa do texto, números e o CSV

No bloco Formatação:

• Caixa do texto: Manter original, MAIÚSCULAS, minúsculas ou Iniciais Maiúsculas;
• Separador decimal: Vírgula (,) ou Ponto (.);
• Casas decimais: de 0 a 6;
• Separador de milhar: Nenhum, Ponto (.) ou Vírgula (,). Ele não pode ser igual ao separador decimal: o modelo não salva;
• Delimitador (CSV/TXT): Ponto e vírgula (;), Vírgula (,), Tabulação ou Barra vertical (|);
• Codificação (CSV/TXT): UTF-8 com BOM (abre certo no Excel), UTF-8 ou Latin-1, para sistemas antigos.

O documento enviado ao cliente

As colunas valem para os arquivos que alguém baixa. O PDF que Enviar orçamento gera para o cliente sai no modelo da linha Orçamento enviado, na lista Modelos. A empresa pode ter vários modelos de orçamento e escolhe qual sai pelo Trocar. Nesse modelo, validade, totais, condições e frete saem sempre, fora da tabela, e as colunas de código ou descrição, quantidade, preço unitário e total da linha são obrigatórias. O bloco Cabeçalho e totais liga e desliga o resto, como o endereço do cliente, o Vendedor, os impostos abertos por tributo e a logística. O Vendedor (quem atende o cliente, da equipe ou da representação) já vem ligado. O Título do documento escrito ali é o que sai no alto do papel; vazio, sai o título de sempre (Cotação ou Pedido de compra). A Unidade fica travada em Unidade do documento, e a tabela do PDF sai consolidada, com a distribuição por filial numa seção própria. Sem personalização, o documento sai no orçamento padrão do sistema, com a orientação automática.

Quando dá errado

• Escolhi Filial e ela não saiu: o pedido não é rateado, ou o modelo está em Somar todas as filiais.
• O arquivo abre com acentos quebrados: troque a Codificação (CSV/TXT); para sistemas antigos, tente Latin-1.
• Os números saem como 1.234,50 e o sistema quer 1234.50: ajuste Separador decimal e Separador de milhar no modelo daquele formato.