Importação de Pedidos por planilha

Crie ou atualize pedidos em massa a partir de um arquivo Excel usando o template oficial da plataforma.

Para que serve este módulo?

A importação facilita migrações e cadastros em lote. Cada linha da planilha representa um item; linhas com o mesmo identificador externo são agrupadas em um único pedido.

1 - Antes de importar

• Faça a operação fora do horário de maior movimento.
• Baixe sempre o template atual.
• Teste primeiro com poucos pedidos.
• Não altere os nomes das colunas.
• Mantenha uma cópia da planilha enviada.

2 - Baixando o template

1. Acesse Vendas > Pedidos.
2. Clique em Importar Pedidos.
3. Na área Template, clique em Baixar template de importação.
4. Abra o arquivo sem remover as colunas existentes.

O arquivo aceito deve estar em formato .xlsx ou .xls e ter no máximo 10 MB.

3 - Como as linhas são agrupadas

Cada linha corresponde a um item. Todas as linhas com o mesmo pedido_externo formam um único pedido com vários itens.

Ao importar novamente o mesmo identificador externo, o sistema atualiza o pedido correspondente em vez de criar outro.

4 - Clientes e produtos

• O cliente pode ser localizado por e-mail ou CPF/CNPJ; quando não existir, poderá ser criado.
• O produto é localizado pelo SKU.
• Sem SKU, o item pode ser criado como avulso usando o nome informado.
• Revise nomes, documentos e SKUs para evitar associações incorretas.

5 - Status, valores e entrega

O campo status representa o pagamento do pedido, enquanto status_item acompanha produção ou entrega do item.

Se valor_pago for menor que o total, o pedido pode ser marcado como parcialmente pago com o valor já recebido.

Também podem ser informados endereço, rastreio, prazo de entrega e previsão de produção do item.

6 - Executando a importação

1. Preencha e salve o template.
2. Abra novamente Importar Pedidos.
3. Selecione o arquivo Excel.
4. Clique em Importar pedidos.
5. Aguarde a conclusão sem fechar ou reenviar o formulário.
6. Leia o resumo de pedidos, itens e possíveis avisos.

7 - Depois da importação

• Abra alguns pedidos e confira cliente, itens, valores e status.
• Revise as linhas indicadas nos alertas.
• Corrija a planilha e reimporte quando necessário.
• Confirme se pedidos atualizados preservaram o identificador externo.

8 - Problemas comuns

Arquivo recusado

Confirme extensão, tamanho e uso do template atual.

Produto virou item avulso

Revise o SKU na planilha e no catálogo.

Pedidos foram agrupados incorretamente

Confira o valor de pedido_externo em cada linha.

Importação com alertas

Leia os números das linhas, corrija os campos indicados e valide o resultado antes de repetir.

Atenção: A importação cria ou atualiza dados em massa. Faça um teste pequeno e confira o resultado antes de processar a planilha completa.