Lista de Pedidos de Venda
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Pedidos de Venda Última atualização: 20/04/2026
Para que serve
Exibe todos os pedidos de venda do tenant. Permite buscar, criar, abrir e remover pedidos. Pedidos faturados exibem o status da NF-e e permitem baixar o DANFE (PDF) e o XML diretamente da lista.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Acesse Menu > Comercial > Pedidos de Venda.
- Use o campo de busca para filtrar por número ou cliente.
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o pedido e editá-lo.
- Clique em "Novo Pedido" para criar um novo pedido.
- Clique no ícone PDF para baixar o DANFE (quando disponível).
- Clique no ícone XML para baixar o XML da NF-e (quando disponível).
- Clique no ícone de lixeira para remover (soft delete — confirmação obrigatória).
- A lista carrega mais registros ao rolar até o fim (scroll infinito, lotes de 50).
Campos da tela
Filtros
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Número ou nome do cliente | Filtra em tempo real |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| ID | Identificador interno sequencial |
| Número | Número sequencial do pedido por filial ou "-" |
| Cliente | Nome do cliente ou nome avulso |
| Filial | Nome fantasia ou razão social da filial |
| Data Emissão | Data no formato DD/MM/AAAA |
| Previsão Entrega | Data prevista de entrega no formato DD/MM/AAAA |
| Total NF | Valor total formatado em BRL |
| Situação | Rascunho, Confirmado, Em Separação, Faturado, Entregue, Cancelado ou Devolvido |
| NF-e | Status da NF-e (Emitida, Cancelada, Rejeitada, Denegada) e número/série quando emitida |
| Ações | PDF (DANFE), XML e lixeira |
Validações e regras
- Os botões de PDF e XML só aparecem quando a NF-e foi emitida (
nfe_pdf_s3_key/nfe_xml_s3_keypreenchidos). - O clique na lixeira não propaga para outras ações da linha (não abre o pedido ao remover).
- O soft delete desativa o pedido em vez de excluir definitivamente.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar pedidos de venda" | Falha de comunicação com a API | Verifique a conexão e recarregue a página |
| "Pedido de venda removido com sucesso" | Remoção bem-sucedida | — |
| "Erro ao remover pedido de venda" | Pedido em uso (faturado, com NF-e emitida etc.) | ⚠️ CONFIRMAR mensagem exata do backend |
| "Erro ao gerar link de download" | Arquivo não disponível no S3 | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
pedidosVendaService(pedidos-venda.service) - Downloads de DANFE e XML usam pre-signed URLs do S3 (AWS)
- Pedidos podem ser gerados a partir de Orçamentos aprovados
- Pedidos faturados podem gerar Devoluções de Cliente
Dúvidas frequentes
Por que o botão de PDF não aparece? A NF-e ainda não foi emitida ou o arquivo não foi gerado. Abra o pedido e emita a NF-e na aba Fiscal.
Posso cancelar um pedido faturado? Pedidos faturados exigem cancelamento da NF-e antes (disponível na tela de edição). Após o cancelamento da NF-e, a situação do pedido pode ser alterada.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |