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

> Para o administrador: montar o modelo de exportação de pedido, com colunas, peças ou caixas, linha por filial, orientação do PDF e formatação.

Fonte: https://vendria.com/ajuda/regras-do-modelo-de-exportacao-de-pedidos

## 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.