Central de Ajuda Paylog Central de Ajuda Paylog

Importar pedidos em lote

Importe vários pedidos de uma planilha usando pacotes já cadastrados ou apenas os IDs dos produtos.

Nesta página 12

Use a importação em lote para registrar muitos pedidos de uma só vez a partir de uma planilha, sem precisar cadastrar um por um. O assistente tem cinco etapas: Modelo & Itens, Upload, Mapeamento, Configurar e Resultado.

Importante

Somente pessoas com permissão para importar pedidos em lote veem Importar em Lote no menu. Se o item não aparecer, peça a permissão a quem administra a sua conta.

1. Abra a importação em lote

No menu principal, acesse Vendas > Pedidos > Importar em Lote.

2. Escolha como os itens vêm na planilha

No cartão Como os itens vêm na planilha?, selecione um dos dois modos. Cada modo usa uma coluna de itens diferente, então escolha antes de baixar o modelo.

  • Pacotes: a planilha traz a coluna pacote_id com o ID de um pacote já cadastrado e ativo.
  • Produtos: a planilha traz a coluna produtos com os IDs dos produtos. O Paylog monta ou reaproveita o pacote sozinho, e você não precisa cadastrar um pacote antes.
Cuidado

Trocar o modo reinicia o assistente na etapa Modelo & Itens. Um arquivo já enviado pertence às colunas do outro modo e é descartado.

Logo abaixo, o Paylog mostra a sua tabela de referência com os IDs que você deve usar no arquivo:

  • no modo Pacotes, a tabela Seus Pacotes Aprovados lista os pacotes ativos, os produtos de cada um e o estoque disponível;
  • no modo Produtos, a tabela Seus Produtos Aprovados lista os produtos aprovados e o estoque de cada um.
Importante

Se você ainda não tem pacote ativo (modo Pacotes) ou produto aprovado (modo Produtos), o Paylog exibe um aviso e a importação não avança. Cadastre e ative o item antes de continuar.

3. Baixe o modelo e preencha a planilha

No cartão Modelo de Importação, clique em Baixar XLSX ou Baixar CSV. O modelo já vem com as colunas do modo escolhido e com uma linha de exemplo.

Colunas do modo Pacotes

Coluna Obrigatória O que preencher
pacote_id Sim ID de um pacote seu, ativo.
nome Sim Nome do cliente.
email Sim E-mail válido do cliente.
endereco Sim Rua ou avenida.
numero Sim Número do endereço.
bairro Sim Bairro.
cidade Sim Cidade.
estado Sim Sigla do estado, como SP.
cep Sim CEP com 8 dígitos.
valor_pedido Sim Valor total do pedido.
cpf Não CPF do cliente.
complemento Não Complemento do endereço.
telefone Não Telefone do cliente.
id_externo Não Sua referência da venda, usada para evitar duplicidade.

Colunas do modo Produtos

As colunas são as mesmas, exceto a primeira: no lugar de pacote_id, a planilha traz produtos.

Coluna Obrigatória O que preencher
produtos Sim IDs dos produtos da venda (veja a sintaxe abaixo).

As demais colunas — de nome a id_externo — seguem exatamente a tabela do modo Pacotes.

Importante

Nos dois modos, valor_pedido é o valor total do pedido, não o valor de cada produto. Informe o valor em reais com centavos, como 249,80 ou 249.80.

Como preencher a coluna produtos

O que você quer O que escrever Resultado
Um produto 101 1 unidade do produto 101.
Vários produtos 101,205 1 unidade do 101 e 1 unidade do 205.
Repetir o mesmo produto 101x2 2 unidades do produto 101.
Combinar os dois casos 101x2,205 2 unidades do 101 e 1 unidade do 205.

Detalhes que o Paylog aceita sem reclamar:

  • separadores entre produtos: ,, ;, | ou +;
  • separadores entre o ID e a quantidade: x, *, : ou = — 101x2, 101*2, 101:2 e 101=2 são equivalentes;
  • um # antes do ID, como #101;
  • o mesmo ID repetido na linha: as quantidades são somadas, então 101,101 vale o mesmo que 101x2.
Dica

Prefira a vírgula como separador, do jeito que o modelo já vem preenchido: 101x2,205.

Atenção

Não use ; dentro da coluna produtos de um arquivo CSV. O ponto e vírgula é o separador de colunas do CSV no Paylog, então ele quebraria a célula em duas colunas. O ; só é seguro em XLSX ou quando o campo está entre aspas.

Importante

Em uma planilha, se a coluna produtos não estiver formatada como texto, o Excel pode entender 101,205 como o número decimal 101.205. O modelo que você baixa já vem com essa coluna formatada como texto — o problema só aparece em arquivos montados do zero. Quando acontece, a linha falha com um erro Item '...' inválido em vez de importar o produto errado.

4. Envie o arquivo

No cartão Enviar Arquivo, selecione a planilha preenchida. São aceitos arquivos CSV, TXT, XLS e XLSX, com até 10MB.

Depois do envio, o Paylog abre a etapa Upload com a Pré-visualização do Arquivo: o total de linhas encontradas, as cinco primeiras linhas e um aviso indicando se todas as colunas obrigatórias foram reconhecidas.

Clique em Continuar para seguir.

5. Confira o mapeamento das colunas

Se o Paylog reconheceu todas as colunas obrigatórias, a etapa Mapeamento é pulada e você vai direto para Configurar.

Se alguma coluna obrigatória não foi reconhecida, a tela Mapeamento de Colunas mostra cada coluna do seu arquivo, um exemplo do conteúdo e uma lista para escolher o campo correspondente do sistema. Os campos obrigatórios aparecem com *. Escolha -- Ignorar -- para as colunas que o Paylog não deve usar.

O botão Continuar só é liberado quando todos os campos obrigatórios estiverem mapeados.

6. Escolha o status dos pedidos

Na etapa Configuração da Importação, defina o Status dos pedidos importados:

  • Aprovado: os pedidos seguem imediatamente para faturamento e preparação do envio;
  • Pendente: os pedidos aguardam aprovação manual.

O resumo mostra as linhas no arquivo, os campos mapeados, o Modo escolhido e o Status selecionado. Clique em Processar N Pedidos e confirme.

Atenção

Use Aprovado somente depois de conferir a planilha. Essa opção inicia o fluxo operacional de todos os pedidos de uma vez.

Se a sua operação usa a janela de pausa para edição, um pedido importado como aprovado pode abrir com o status Parado — Aguardando Edição do Produtor.

7. Acompanhe o resultado

A etapa Resultado mostra o andamento e quatro contadores:

  • Processados: linhas já analisadas do total;
  • Sucesso: pedidos criados;
  • Erros: linhas recusadas;
  • Ignorados: linhas puladas de propósito.

A tabela Resultados lista cada linha com o status, a mensagem e o link para o pedido criado.

Uma linha é ignorada, e não recusada, quando:

  • o id_externo já existe em outro pedido seu;
  • o CPF do cliente já tem um pedido ativo para o mesmo pacote.

Ao final, use Nova Importação para começar outro arquivo ou Ver Pedidos para abrir a lista de pedidos.

8. Corrija as linhas com erro

Quando houver erros, o botão Baixar Erros exporta uma planilha só com as linhas que não entraram. Ela traz as colunas linha e erro na frente dos dados originais, então basta corrigir o que a mensagem indica e enviar o arquivo corrigido em uma nova importação.

Observação

A coluna linha corresponde à linha da sua planilha original — o cabeçalho é a linha 1 e os dados começam na linha 2.

Se a importação não funcionar

Situação O que verificar
Campo obrigatório '...' está vazio Preencha a coluna indicada em todas as linhas ou mapeie a coluna correta na etapa Mapeamento.
Pacote #X não encontrado, não pertence ao produtor ou está inativo Confira o ID na tabela Seus Pacotes Aprovados e confirme se o pacote está ativo.
Produto(s) #X não encontrado(s), não pertence(m) ao produtor ou não está(ão) aprovado(s) Confira o ID na tabela Seus Produtos Aprovados e confirme se o produto está aprovado.
Item '...' inválido na coluna 'produtos' Use o ID do produto ou IDxQUANTIDADE, como 101x2, separe os produtos por vírgula e formate a coluna como texto.
Nenhuma embalagem disponível comporta os produtos informados Revise peso e dimensões dos produtos e confirme se existe uma embalagem compatível com a composição.
CEP '...' inválido (deve ter 8 dígitos) Formate a coluna cep como texto para não perder o zero à esquerda.
Estado '...' inválido Use a sigla de duas letras do estado, como SP ou RJ.
Valor do pedido '...' inválido (deve ser maior que zero) Informe o valor total em reais, como 249,80.
E-mail '...' inválido Corrija o endereço de e-mail do cliente.
Todas as linhas foram ignoradas Confira se você já importou esse mesmo arquivo antes, pelo id_externo ou pelo CPF do cliente.
O arquivo não é aceito Envie um CSV, TXT, XLS ou XLSX com no máximo 10MB.

Veja como acompanhar o pedido, parar, retomar ou cancelar.

Atualizado em 05/08/2026