Pedidos

🛂 Permissões: order.view, order.create, order.edit, order.delete, order.cancel, order.confirm_payment, order.assign_driver, order.start_delivery, order.complete_delivery 🔒 Plano: número máximo de pedidos/mês limitado por max_monthly_orders. 📍 Caminho: Operações → Pedidos

Pedidos são o coração da operação. Esta seção descreve como criar, gerenciar e mover pedidos pelo ciclo de vida (do recebimento à entrega).

Onde os pedidos vêm

1. Loja online (B2C) — cliente final compra na vitrine.
2. Vendedor (B2B) — usuário com permissão order.create cria o pedido pelo painel ou pelo app mobile.
3. Agente de IA por WhatsApp — quando o cliente fecha pelo chat, o agente cria o pedido automaticamente.
4. API pública — integração com ERP/PDV externo via API Keys.

Lista de pedidos

A página Operações → Pedidos mostra todos os pedidos com:

• Filtros: status, status de pagamento, período, vendedor, cliente.
• Busca por número, cliente ou produto.
• Paginação.

Criar pedido manual

1. Clique em Novo Pedido.
2. Selecione/cadastre o cliente.
3. Selecione o endereço de entrega (ou marque retirada).
4. Adicione produtos: o sistema busca por nome/SKU/EAN. O preço é puxado da tabela do cliente ou do preço base (ver Tabelas de preço).
5. Aplique cupom se houver.
6. Escolha forma de pagamento e método de frete.
7. (Opcional) Defina data agendada de entrega.
8. Salve.

O pedido nasce em status Pending e Unpaid por padrão.

Status do pedido

Status	Significado
Pending	Recebido, aguardando processamento.
In_Transit	Saiu para entrega.
Delivered	Entregue.
Canceled	Cancelado.

Status de pagamento

Status	Significado
Unpaid	Sem pagamento.
Waiting_Confirmation	Pagamento iniciado, aguardando confirmação.
Paid	Confirmado.

Pedidos online via gateway atualizam o status sozinhos. Pedidos CASH/OTHER exigem confirmação manual (botão Confirmar pagamento — permissão order.confirm_payment).

Ações disponíveis sobre o pedido

Na lista ou no detalhe, conforme a permissão:

• Editar itens, endereço, frete (order.edit).
• Cancelar (order.cancel).
• Atribuir motorista (order.assign_driver).
• Iniciar entrega — muda status para In_Transit (order.start_delivery).
• Concluir entrega — muda para Delivered (order.complete_delivery).
• Confirmar pagamento (order.confirm_payment).

Detalhes do pedido

A tela do pedido mostra:

• Itens, quantidades, preço unitário e desconto.
• Subtotal, frete, descontos (cupom + promoção), total.
• Cliente, endereço, contato.
• Forma de pagamento e status.
• Histórico (criação, transições de status, observações).
• Notas internas (internal_notes) — visíveis apenas para a equipe.

Cancelamento

Cancelar um pedido (order.cancel):

• Estoque é estornado automaticamente.
• Comissões geradas são marcadas como CANCELLED.
• Pagamento online já confirmado não é estornado automaticamente — deve ser ressarcido pelo painel do gateway.

Comprovante / impressão

Pedidos podem ser baixados em PDF (cupom/comprovante) e enviados por WhatsApp para o cliente.

Limites do plano

A criação é bloqueada quando o tenant atinge max_monthly_orders no mês corrente. Faça upgrade ou aguarde a virada do mês.

Boas práticas

• Treine vendedores a sempre selecionar o cliente (não criar pedido anônimo) — preserva histórico para a inteligência comercial.
• Use notas internas para combinados que o cliente final não precisa ver.
• Antes de marcar Pago manualmente, valide o comprovante (foto / extrato bancário) para evitar fraudes.
• Para grandes lotes B2B, prefira o Importador (off-painel) ou a API pública (API Keys).