Passar para o conteúdo principal

Importador de Pedidos via Planilha no Sistema Administrativo

A funcionalidade de Importar Pedidos permite aos usuários importar pedidos em lote através de planilhas CSV, XLS ou XLSX.

Renan Carvalho avatar
Escrito por Renan Carvalho
Atualizado há mais de 4 meses

Visão Geral

A funcionalidade de Importar Pedidos permite que você crie múltiplos pedidos de uma vez usando uma planilha. É ideal para quando você tem muitos pedidos para criar e quer economizar tempo.

Como Acessar

  1. Vá para a página de Pedidos

  2. Clique no botão "Importar Pedidos"

  3. Você será direcionado para a página de importação

Passo a Passo

1. Baixar o Modelo

  1. Na página de importação, clique em "Baixar Modelo"

  2. Uma planilha será baixada com todas as colunas necessárias

  3. Abra a planilha no Excel, Google Sheets ou similar

2. Preencher a Planilha

Colunas Obrigatórias:

  • data_agendamento: Data e hora do pedido (ex: 2025-08-02 16:24:59)

  • cliente_nome: Nome completo do cliente

  • cliente_email: Email do cliente

  • cliente_phone: Telefone com DDD (ex: (11) 99999-9999)

  • tipo_veiculo: Tipo de veículo (Moto, Carro, Van)

  • categoria_servico: Categoria (Documentos, Alimentos, etc.)

  • endereco_coleta: Endereço completo de coleta

  • endereco_coleta_complemento: Complemento (opcional)

  • metodo_pagamento: pagamento_faturado, carteira_digital ou dinheiro

  • possui_retorno: Sim ou Não

  • enderecos_entregas: Endereços de entrega no formato: Nome|Telefone|Endereço|Complemento

Colunas Opcionais:

  • enderecos_entregas_2 até enderecos_entregas_50: Endereços adicionais de entrega na mesma linha do pedido (até 50 endereços).

3. Salvar o Arquivo

  1. Salve a planilha como CSV

  2. Certifique-se de que o arquivo está no formato correto

  3. Feche a planilha

4. Fazer Upload

  1. Na página de importação, clique em "Selecionar Arquivo"

  2. Ou arraste o arquivo para a área de upload

  3. O sistema validará automaticamente o arquivo

  4. Clique em "Importar" para começar o processamento

5. Acompanhar o Progresso

  1. O sistema mostrará o progresso em tempo real

  2. Você pode acompanhar quantos pedidos foram criados

  3. Se houver erros, eles serão mostrados

  4. Quando terminar, você verá um resumo dos resultados

Você pode abrir os detalhes da importação e verificar o motivo das falhas para corrigir na planilha.

Dicas Importantes

Remova Pedidos já importados

⚠️ Se você for importar a mesma planilha, remova os pedidos que já foram criados para evitar duplicidades de pedidos.

Lembre-se: Se você importar a mesma planilha duas vezes, os mesmos pedidos serão criados novamente.

Para Endereços

  • Use endereços completos: Rua, número, bairro, cidade e estado

  • Exemplo: "Rua das Flores, 123 - Centro, São Paulo - SP"

  • Para múltiplos endereços: Use o formato Nome|Telefone|Endereço|Complemento

Para Datas

  • Formato: YYYY-MM-DD HH:MM:SS

  • Exemplo: 2025-08-02 16:24:59

  • Se deixar em branco: O pedido será agendado para agora

Para Pagamento

  • pagamento_faturado: Pedido será faturado

  • carteira_digital: Pagamento pela carteira digital

  • dinheiro: Pagamento em dinheiro (se disponível)

Exemplos de Uso

Exemplo 1: Pedido Simples

data_agendamento: 2025-08-02 16:24:59
cliente_nome: João Silva
cliente_email: [email protected]
cliente_phone: (11) 99999-9999
tipo_veiculo: Moto
categoria_servico: Documentos
endereco_coleta: Rua das Flores, 123 - São Paulo, SP
endereco_coleta_complemento: Apto 101
metodo_pagamento: pagamento_faturado
possui_retorno: Não
enderecos_entregas: João Silva|(11) 99999-9999|Rua das Palmeiras, 456 - São Paulo, SP|Apto 202

Exemplo 2: Pedido com Múltiplos Endereços

data_agendamento: 2025-08-02 18:24:59
cliente_nome: Empresa ABC
cliente_email: [email protected]
cliente_phone: (11) 44444-4444
tipo_veiculo: Van
categoria_servico: Mercadorias
endereco_coleta: Rua Comercial, 500 - São Paulo, SP
endereco_coleta_complemento: Galpão 10
metodo_pagamento: dinheiro
possui_retorno: Sim
enderecos_entregas: Cliente A|(11) 11111-1111|Rua A, 100 - São Paulo, SP|Escritório
enderecos_entregas_2: Cliente B|(11) 22222-2222|Rua B, 200 - São Paulo, SP|Loja
enderecos_entregas_3: Cliente C|(11) 33333-3333|Rua C, 300 - São Paulo, SP|Depósito

Problemas Comuns e Soluções

Erro: "Arquivo inválido"

  • Solução: Use o modelo baixado do sistema

  • Verifique: Se salvou como CSV

Erro: "Email inválido"

Erro: "Endereço não encontrado"

  • Solução: Use endereços completos com cidade e estado

  • Exemplo: "Rua das Flores, 123 - Centro, São Paulo - SP"

Erro: "Método de pagamento não encontrado"

  • Solução: Use apenas: pagamento_faturado, carteira_digital ou dinheiro

Erro: "Tipo de veículo não encontrado"

  • Solução: Use o nome da mesma forma como você cadastrou nas configurações do tipo de veículo

  • Ou deixe em branco se você possui seleção automática

Verificar Resultados

No Histórico

  1. Na página de importação, veja a tabela de histórico

  2. Cada importação mostra:

  • Nome do arquivo

  • Status (Pendente, Processando, Concluído, Falhou)

  • Progresso

  • Quantos pedidos foram criados e quantos falharam

  • Data e hora

Nos Pedidos

  1. Vá para a página de Pedidos

  2. Os pedidos criados aparecerão na lista

  3. Todos os pedidos importados são agendados por padrão. Se a data for no passado ou atual ele é criado imediatamente.

Dicas Finais

  1. Sempre use o modelo atualizado para evitar problemas

  2. Teste com poucos pedidos antes de importar muitos

  3. Verifique os dados antes do upload

  4. Monitore o histórico para acompanhar o progresso

  5. Use endereços completos para melhor precisão

Suporte

Se tiver dúvidas ou problemas:

  1. Verifique se está usando o modelo correto

  2. Confirme se todos os dados obrigatórios estão preenchidos

  3. Teste com um pedido simples primeiro

  4. Entre em contato com o suporte se necessário

Respondeu à sua pergunta?