Importação de pedidos

Quem chega de outro sistema costuma querer trazer as vendas antigas junto: o histórico do cliente, o que foi vendido e como foi pago. A importação lê um arquivo e cria os pedidos de uma vez, aproveitando ou criando os cadastros de cliente, vendedor, produto e serviço que vierem no arquivo.

Modelos prontos para baixar

• Baixar modelo CSV
• Baixar modelo JSON

São os mesmos arquivos oferecidos na tela de importação, em Baixar modelo CSV e Baixar modelo JSON. Os dois trazem pedidos de exemplo em situações diferentes: um completo, um só com serviço, um com o mínimo de informação e um cancelado.

Qual arquivo usar

• CSV: cada linha é um pedido com um único item (um produto ou um serviço) e um único pagamento. É o formato mais fácil de montar numa planilha.
• JSON: cada pedido pode ter vários produtos, vários serviços e vários pagamentos. Use quando as vendas têm mais de um item.

Como importar

1. Abra Vendas > Pedidos (ou Orçamentos, para importar orçamentos).

2. Clique em Opções > Importação de Pedidos, no grupo Importação e exportação.

   

3. Baixe o modelo pelo botão da própria tela e preencha com os seus dados.

4. Anexe o arquivo e marque as opções desejadas.

5. Na primeira vez, marque Apenas validar e clique em Importar: o sistema confere o arquivo sem gravar nada.

6. Corrija o que apareceu no resumo, desmarque Apenas validar e importe de verdade.

7. Confira o resumo com a quantidade de importados e de falhas. O botão Baixar relatório traz o motivo de cada pedido recusado.

Nota

A opção Importação de Pedidos só aparece para quem tem a permissão de importação de pedidos. Se ela não estiver no menu Opções, peça ao responsável pela empresa para liberar.

Opções da tela

Opção	O que faz
Apenas validar	Confere o arquivo e mostra o resumo sem gravar nada. Use sempre antes da importação definitiva.
Pedidos	Grava os pedidos. Desmarcada, o arquivo serve só para criar os cadastros que vierem nele.
Clientes	Cria o cadastro dos clientes que ainda não existem.
Produtos	Cria os produtos que ainda não existem, com o preço de venda que veio no pedido.
Serviços	Cria os serviços que ainda não existem.
Vendedores	Cria os vendedores que ainda não existem, com a comissão informada.
Atualizar se já existir	Quando o pedido já está no sistema, atualiza em vez de ignorar. Escolha entre Preencher apenas campos vazios e Sobrescrever todos os campos.
Importar formas de pagamento	Cria as formas de pagamento que vierem no arquivo e ainda não existem.
Importar contas a receber e a pagar	Lança no financeiro os pagamentos de cada pedido importado. Use só se essas vendas ainda não estão no seu financeiro.

Cliente, vendedor, produto e serviço que já existem no cadastro são ligados ao pedido mesmo com a opção desmarcada. O sistema procura o cliente pelo CPF/CNPJ e depois pelo nome; produto pelo código e depois pelo nome; serviço e vendedor pelo nome.

Cabeçalho do CSV

numero_pedido;origem_id;data_emissao;situacao;cliente_nome;cliente_cpfcnpj;cliente_email;cliente_telefone;cliente_endereco;cliente_cidade;cliente_uf;cliente_cep;vendedor_nome;vendedor_comissao;produto_codigo;produto_nome;produto_quantidade;produto_valor_unitario;servico_nome;servico_quantidade;servico_valor_unitario;desconto_valor;acrescimo_valor;forma_pagamento;tipo_pagamento;total_pago;obs

O separador é o ponto e vírgula (;). A ordem das colunas não importa, mas o nome de cada uma precisa ser exatamente o do modelo. Mantenha todas as colunas em todas as linhas, mesmo vazias: uma linha com número de colunas diferente do cabeçalho recusa o arquivo inteiro.

Campo a campo

Campo	Obrigatório	Exemplo	Observações
numero_pedido	Não	1001	Número que o pedido terá no sistema. Vazio, o sistema usa o próximo número da sequência.
origem_id	Não	1001	Número ou código do pedido no sistema antigo. É por ele que o sistema reconhece o pedido numa segunda importação.
data_emissao	Não	10/01/2026	Data da venda, no formato DD/MM/AAAA (aceita hora: 10/01/2026 09:30:00). Vazia, entra a data de hoje.
situacao	Não	FECHADO	FECHADO (venda concluída), PENDENTE ou CANCELADO. Vazia, entra como PENDENTE.
cliente_nome	Sim	MARIA SILVA COMERCIO LTDA	Nome do cliente. Sem ele o pedido fica sem cliente.
cliente_cpfcnpj	Não	12.345.678/0001-95	Com ou sem pontuação. Precisa ser um CPF ou CNPJ válido, senão o pedido é recusado.
cliente_email	Não	[email protected]	E-mail inválido recusa o pedido.
cliente_telefone	Não	(11) 99999-0000	Fica só com os números.
cliente_endereco	Não	RUA DAS FLORES, 120	Logradouro e número.
cliente_cidade	Não	SAO PAULO
cliente_uf	Não	SP	Sigla do estado, com duas letras.
cliente_cep	Não	01001-000	Com ou sem traço.
vendedor_nome	Não	CARLOS VENDEDOR	Nome do vendedor.
vendedor_comissao	Não	5	Percentual de comissão, de 0 a 100.
produto_codigo	Não	1001	Código do produto no cadastro.
produto_nome	Sim, se a linha é de produto	ARROZ TIPO 1 5KG	Nome do produto.
produto_quantidade	Sim, se a linha é de produto	2	Sem quantidade o item entra zerado.
produto_valor_unitario	Sim, se a linha é de produto	34,90	Preço unitário praticado na venda.
servico_nome	Sim, se a linha é de serviço	INSTALACAO DE AR CONDICIONADO	Nome do serviço.
servico_quantidade	Não	1	Vazia, entra 1.
servico_valor_unitario	Sim, se a linha é de serviço	350,00	Valor unitário do serviço.
desconto_valor	Não	10,00	Desconto sobre o total do pedido, em reais.
acrescimo_valor	Não	5,00	Acréscimo sobre o total do pedido, em reais.
forma_pagamento	Não	DINHEIRO	Nome da forma de pagamento. Preencha junto com total_pago.
tipo_pagamento	Não	PIX	Tipo da forma de pagamento: DINHEIRO, PIX, CARTAO CREDITO, CARTAO DEBITO, BOLETO, CREDIARIO, DEPOSITO BANCARIO, TRANSFERENCIA BANCARIA, CHEQUE.
total_pago	Não	69,80	Valor recebido. Vazio, o pedido entra sem pagamento.
obs	Não	VENDA NO BALCAO	Observação do pedido, até 1000 caracteres.

Valores aceitam vírgula ou ponto como separador decimal (34,90 ou 34.90). Não use ponto como separador de milhar sem casas decimais: 2.500 é lido como dois e meio.

Modelo JSON

Os nomes dos campos são os mesmos do CSV, com cliente, vendedor, produtos, serviços e pagamentos agrupados dentro de cada pedido:

[
  {
    "numero": 1001,
    "origemId": "1001",
    "createdAt": "10/01/2026 09:30:00",
    "situacao": "FECHADO",
    "obs": "VENDA NO BALCAO",
    "cliente": {
      "nome": "MARIA SILVA COMERCIO LTDA",
      "cpf_cnpj": "12345678000195",
      "email": "[email protected]",
      "telefone": "11999990000",
      "endereco": "RUA DAS FLORES, 120",
      "cidade": "SAO PAULO",
      "uf": "SP",
      "cep": "01001000"
    },
    "vendedor": { "nome": "CARLOS VENDEDOR", "comissao": 5 },
    "produtos": [
      { "codigo": "1001", "nome": "ARROZ TIPO 1 5KG", "quantidade": 2, "valor_unitario": 34.90 },
      { "codigo": "1002", "nome": "FEIJAO CARIOCA 1KG", "quantidade": 5, "valor_unitario": 9.80 }
    ],
    "servicos": [
      { "nome": "ENTREGA EM DOMICILIO", "quantidade": 1, "valor_unitario": 15.00 }
    ],
    "desconto_valor": 3.80,
    "pagamentos": [
      { "forma_pagamento": "PIX", "valor": 100.00, "data": "10/01/2026" },
      { "forma_pagamento": "DINHEIRO", "valor": 30.00, "data": "10/01/2026" }
    ]
  }
]

O que muda em relação ao CSV:

• numero é obrigatório. Pedido sem esse campo é ignorado. Use 0 para o sistema numerar.
• createdAt é a data da venda (o data_emissao do CSV).
• quantidade vazia em produto ou serviço entra como 1.
• Pagamento sem valor entra com o total do pedido. data é a data do recebimento; sem ela, entra a data da venda.
• Números usam ponto como separador decimal, sem aspas: 34.90.

Como o sistema reconhece um pedido repetido

Importar o mesmo arquivo duas vezes não duplica as vendas:

• Se o pedido tem origem_id, é ele que identifica o pedido.
• Se não tem, o sistema compara cliente, valor total e itens. Pedido igual é considerado repetido.

Pedido repetido aparece no relatório como Ignorado, com os dados do que já está no sistema, e conta como falha no resumo. Com Atualizar se já existir marcado, ele é atualizado e aparece como Atualizado.

O que o sistema ajusta sozinho

• Número vazio recebe o próximo da sequência. Situação vazia entra como PENDENTE. Data vazia entra como hoje.
• Nomes e observações ficam em maiúsculas e sem acentos. CPF/CNPJ, CEP e telefone ficam só com os números.
• Os totais do pedido são recalculados a partir dos itens, do desconto e do acréscimo.
• Produto e serviço sem unidade entram como UN.
• Produto novo criado pela importação recebe o preço de venda e o custo iguais ao valor praticado no pedido.

Erros comuns

Sintoma	Causa provável	Como corrigir
Arquivo CSV inválido	Arquivo sem cabeçalho, sem linhas ou com separador diferente de ;	Baixe o modelo de novo e copie os seus dados para dentro dele.
Nenhum pedido válido encontrado no arquivo JSON	Nenhum pedido tem o campo numero, ou o JSON não é uma lista [ ... ]	Coloque numero em todos os pedidos (use 0 para numerar automaticamente).
Pedido recusado por CpfCnpj do Cliente	CPF ou CNPJ inválido	Corrija o documento ou deixe a coluna vazia.
Pedido recusado por Email	E-mail com erro de digitação	Corrija o e-mail ou deixe a coluna vazia.
Muitos pedidos em Ignorado	O arquivo já foi importado antes	É o esperado. Para atualizar, marque Atualizar se já existir.
Pedido com total zero	Linha de produto sem produto_quantidade	Preencha a quantidade em todas as linhas de produto.
Cliente entrou repetido no cadastro	Nome escrito de forma diferente e sem CPF/CNPJ	Padronize o nome ou informe o CPF/CNPJ, que é o primeiro critério de busca.
Erro ao ler arquivo CSV: record on line 3: wrong number of fields	A linha indicada tem mais ou menos colunas que o cabeçalho (em geral um ; a mais dentro de um texto, ou colunas vazias cortadas no fim)	Corrija a linha apontada: mantenha todas as colunas e coloque entre aspas o texto que tiver ;.

Antes de importar

• Arquivo salvo em CSV com separador ; (ou em JSON)
• Cabeçalho igual ao do modelo
• cliente_nome preenchido em todos os pedidos
• Quantidade e valor unitário preenchidos em todos os itens
• CPF/CNPJ conferidos
• origem_id preenchido, para poder repetir a importação sem duplicar
• Primeira rodada com Apenas validar