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