A funcionalidade de **Importação de Pedidos** permite que você crie múltiplos pedidos de uma só vez através do upload de uma planilha Excel ou CSV. Ideal para clientes que recebem listas de pedidos de seus sistemas ou parceiros.
---
No painel administrativo, navegue até:
**Pedidos → Importar Pedidos**
Ou acesse diretamente: `https://entregasexpressas.com.br/admin/order-imports`
---
Clique no botão **"Baixar Modelo"** (verde) para obter a planilha template com:
---
Abra o arquivo baixado e preencha com os dados dos seus pedidos seguindo o **Guia de Colunas** abaixo.
⚠️ **Importante:**
---
**Formatos aceitos:**
**Tamanho máximo:** 10 MB
**Como enviar:**
1. Clique em **"Selecionar Arquivo"** ou
2. Arraste e solte a planilha na área pontilhada
3. Aguarde a validação automática
4. Clique em **"Importar Arquivo"**
---
A importação acontece em **tempo real** com barra de progresso mostrando:
Após conclusão, você será redirecionado para a página de detalhes.
---
| Coluna | Descrição | Exemplo |
|--------|-----------|----------|
| **cliente_nome*** | Nome do cliente que está solicitando o pedido | `João Silva` |
| **cliente_email*** | Email do cliente | `[email protected]` |
| **tipo_veiculo*** | Nome do Tipo de Serviço (deve existir no sistema). Deixe em branco para veículo automático | `Moto` |
| **categoria_servico*** | Nome da Categoria (deve existir no sistema) | `Documentos` |
| **endereco_coleta*** | Endereço completo de coleta (rua, número, bairro, cidade, estado) | `Rua das Flores, 123 - São Paulo, SP` |
| **enderecos_entregas*** | Primeiro endereço de entrega no formato: `Nome\|Telefone\|Endereço\|Complemento` | `João Silva\|(11) 99999-9999\|Rua das Palmeiras, 456 - São Paulo, SP\|Apto 202` |
| Coluna | Descrição | Exemplo | Valor Padrão |
|--------|-----------|----------|---------------|
| **data_agendamento** | Data e hora do agendamento (formato: `YYYY-MM-DD HH:MM:SS`). Datas no passado serão ajustadas para 1 minuto após o momento atual | `2026-02-21 14:30:00` | Momento atual |
| **cliente_phone** | Telefone do cliente com DDD | `(11) 99999-9999` | - |
| **endereco_coleta_complemento** | Complemento do endereço de coleta | `Apto 101`, `Sala 205` | - |
| **metodo_pagamento** | Método de pagamento. Opções: `pagamento_faturado`, `carteira_digital`, ou nome do método offline cadastrado | `pagamento_faturado` | `pagamento_faturado` |
| **possui_retorno** | Se o pedido precisa retornar ao local de coleta. Opções: `Sim` ou `Não` | `Sim` | `Não` |
| **enderecos_entregas_2** | Segundo endereço de entrega (mesmo formato) | `Maria Silva\|(11) 88888-8888\|Rua dos Ipês, 789 - SP\|Casa` | - |
| **enderecos_entregas_3** | Terceiro endereço de entrega | - | - |
| **enderecos_entregas_4...50** | Você pode adicionar até **50 endereços de entrega** no total (enderecos_entregas_4, enderecos_entregas_5, etc.) | - | - |
---
Cada endereço deve seguir o padrão:
```
Nome|Telefone|Endereço Completo|Complemento
```
**Exemplos válidos:**
```csv
João Silva|(11) 99999-9999|Rua das Palmeiras, 456 - São Paulo, SP|Apto 202
Maria Silva|(11) 88888-8888|Rua dos Ipês, 789 - São Paulo, SP|Casa
Pedro Santos|(11) 77777-7777|Av. Paulista, 1000 - São Paulo, SP|
```
⚠️ **Atenção:**
---
| data_agendamento | cliente_nome | cliente_email | cliente_phone | tipo_veiculo | categoria_servico | endereco_coleta | endereco_coleta_complemento | metodo_pagamento | possui_retorno | enderecos_entregas |
|------------------|--------------|---------------|---------------|--------------|-------------------|-----------------|----------------------------|------------------|----------------|-------------------|
| 2026-02-21 14:00:00 | João Silva | [email protected] | (11) 99999-9999 | Moto | Documentos | Rua das Flores, 123 - São Paulo, SP | Apto 101 | pagamento_faturado | Sim | João Silva\|(11) 99999-9999\|Rua das Palmeiras, 456 - SP\|Apto 202 |
| 2026-02-21 16:00:00 | Carlos Santos | [email protected] | (11) 77777-7777 | Carro | Alimentos | Av. Paulista, 1000 - São Paulo, SP | | carteira_digital | Não | Carlos Santos\|(11) 77777-7777\|Rua Augusta, 500 - SP\|Sala 301 |
---
Na mesma página, você encontra o **Histórico de Importações** com:
---
Quando houver erros na importação:
1. A importação **não é interrompida**
2. Pedidos válidos são criados normalmente
3. Linhas com erro são registradas com detalhes
4. Você pode baixar o relatório de erros na página de detalhes
**Erros comuns:**
---
✓ **Teste com poucos pedidos primeiro** - Envie 2-3 linhas para validar o formato antes de importar centenas
✓ **Verifique os nomes cadastrados** - Tipo de veículo e categoria devem estar **exatamente** como cadastrados no sistema (case-sensitive)
✓ **Use codificação UTF-8** - Para evitar problemas com acentos e caracteres especiais
✓ **Endereços completos** - Sempre inclua número, bairro, cidade e estado para melhor precisão no mapa
✓ **Revise o guia de colunas** - Clique em "Ver Guia das Colunas" sempre que tiver dúvida
✓ **Acompanhe em tempo real** - A página atualiza automaticamente, você não precisa recarregar
---
Se encontrar dificuldades:
1. Clique em **"Ver Guia das Colunas"** na página de importação
2. Verifique os detalhes dos erros no histórico
3. Entre em contato com o suporte através do chat
---
**Última atualização:** 21/02/2026
**Versão:** 1.0