¶ Pedido Venda
Caminho: Terus Order → Pedido Venda
Portal: Fornecedor
O módulo Pedido Venda centraliza os pedidos recebidos do varejo. Por aqui você importa os pedidos, valida os itens (DE-PARA, preços, IPI, logística), corrige divergências, aprova ou reprova, unitiza cargas, integra ao ERP e acompanha notas fiscais e tracking logístico.
No menu o módulo aparece como Pedido Venda (em Terus Order). Do ponto de vista do fornecedor, são os pedidos de venda recebidos do cliente varejo.
¶ 1. Como acessar
- Selecione o varejo na barra lateral.
- Abra Terus Order → Pedido Venda.
A tela mostra "Gerencie pedidos recebidos de {varejo}".
Imagem ilustrativa — distribuidor, varejo, lojas, vendedores, valores e datas foram borrados; nº do pedido, status, itens e quantidades permanecem visíveis.
¶ 2. Tela de listagem
¶ Ações no topo
- Processar Novos Pedidos — sincroniza a integração e processa os pedidos novos (fases "Sincronizando..." e "Processando...").
- Atualizar Pedidos — reprocessa pedidos pendentes/em análise, reaplicando DE-PARA, preços, IPI e logística.
- Status ERP — consulta em lote a posição dos pedidos já exportados ao ERP.
- Configuração — abre os parâmetros do módulo (requer permissão específica).
¶ Indicadores (KPIs)
Total de Pedidos, Valor Total, Pendentes, Aprovados, Todo cortado e Divergências (este último é clicável e leva à aba de itens sem DE-PARA).
¶ Abas
- Pedidos — a lista principal.
- Sem De-Para — itens que precisam de mapeamento, com opção de mapear em massa.
¶ Filtros
Busca por pedido/fornecedor/vendedor, Status, Vendedor, Período (padrão: últimos 90 dias), além de alternar Todo cortado e Mostrar/Ocultar Originais (pedidos-pai unitizados).
¶ Colunas
Pedido (com selos de tipo de carga, unitização e depósito), Loja, Emissão, Status, Itens, Valor, Vendedor, Plano de Pagamento e ícones de alerta (divergência, sem DE-PARA, fora de linha). Ações rápidas de Aprovar, Reprovar e Recuperar ficam na própria linha.
¶ 3. Tela de detalhe do pedido
Imagem ilustrativa — loja, vendedor, preços/valores e datas foram borrados; produtos, EAN, quantidades e status permanecem visíveis.
No topo: número do pedido, selos de status, tipo de carga, unitização e dados da loja (CNPJ, endereço), emissão e vendedor.
Pedido com status Agrupado: os itens que o varejo mandou naquele número aparecem só para consulta; a operação está no pedido principal (link na faixa teal). No principal do lote, o bloco Origem dos itens no lote mostra o que veio de cada número, separado da tabela operacional já consolidada.
Indicadores do pedido: Itens, Valor Total, Peso, Volume, Divergências, Sem De-Para, Fora de Linha e itens ativos.
Blocos da tela:
- Plano de Pagamento — visualizar ou alterar (selo NEGOCIADO quando aplicável).
- Obs. NF — observação para a nota fiscal (até 2000 caracteres).
- Painel ERP — posição, importação e eventuais observações/rejeições.
- Notas Fiscais — nº da NF, série, filial, datas, valores, chave da NFe e devolução.
- Tracking Logístico — linha do tempo: Integrado → Faturado → Em Separação → Expedido → Recebido no CD → Remetido à Loja → Recebido na Loja.
- Itens do Pedido — editar quantidade/preço, mapear DE-PARA na linha, ajustar preços e ver informações de estoque/cobertura.
- Histórico — registro de auditoria das ações.
¶ Colunas dos itens
Sequência, Código Varejo, Descrição/EAN, Código Fornecedor, Quantidade (com origem/faturado), Preço do Pedido, Preço de Tabela, IPI% e valor com IPI, Valor da linha e Status (DE-PARA, divergências, fora de linha, cortado, ERP).
¶ 4. Status do pedido
| Status | Significado |
|---|---|
| Pendente | Aguardando análise |
| Em Análise | Em avaliação (editável) |
| Aprovado | Aprovado pelo fornecedor |
| Reprovado | Reprovado (com motivo) |
| Rejeitado | Rejeitado |
| Unitizado | Dividido por unitização |
| Recuperado | Reaberto para edição |
| Exportado | Enviado ao ERP |
| Faturado | Faturado no ERP |
| Fat. c/ dev. parcial | Faturado com devolução parcial |
| Devolvido | Devolvido |
| Em Separação | Em separação no ERP |
| Cancelado ERP | Cancelado no ERP |
| Integrado e-commerce | Aceito pela plataforma de e-commerce (não passou pelo ERP) |
Pedidos em Pendente, Em Análise e Recuperado podem ser editados. Pedido de e-commerce permanece Pendente até a plataforma aceitar — falha na fila (estoque, login, preço do site maior que o pedido) não muda o status.
¶ Devolução de NF (Winthor)
A devolução é lida do Winthor (PCMOV): a linha de saída da NF passa a ter NUMNOTADEV, e as linhas CODOPER='ED' dessa nota de devolução trazem quantidade e valor. Só devolução total move o pedido para Devolvido e libera a reimportação; parcial deixa o pedido em Fat. c/ dev. parcial.
Como o número da nota no Winthor só é único dentro da filial (e é reaproveitado ao longo dos anos), o portal descarta qualquer linha ED com data anterior à saída da NF. Sem esse crivo, uma nota homônima de outra filial/outro ano entrava no lugar da devolução real, e a NF totalmente devolvida aparecia como parcial. Se aparecer uma NF com data de devolução anterior à emissão, é esse sintoma: use backend/scripts/remediar_devolucao_data_incoerente.py.
¶ 5. Ações principais
| Ação | Onde | Observação |
|---|---|---|
| Aprovar | Lista e detalhe | Mesmas regras nos dois lugares (ver paridade abaixo). Bloqueado se houver item sem DE-PARA, pedido todo cortado, sem vendedor ou divergências (conforme configuração). Pedido de e-commerce usa o parâmetro Aprovação livre (e-commerce); o clique enfileira a integração e o status só sai de Pendente quando a plataforma aceitar |
| Reprovar | Lista e detalhe | Motivo obrigatório |
| Recuperar | Lista e detalhe | Reabre pedido reprovado/rejeitado/devolvido |
| Alterar plano de pagamento | Lista e detalhe | |
| Editar quantidade/preço do item | Detalhe | Respeita limites de % e de aumento de quantidade |
| Ajustar Preços | Detalhe | Reduz para o preço de tabela |
| Mapear DE-PARA | Aba Sem De-Para / na linha | |
| Unitizar | Detalhe | Quebra a carga por m³/kg/palete |
| Integrar ERP | Detalhe | Quando a integração não é automática |
| Atualizar Status ERP | Lista e detalhe | |
| Salvar Obs. NF | Detalhe |
¶ Regras de aprovação (resumo)
- Itens sem DE-PARA (que não estejam fora de linha) impedem a aprovação.
- Divergências de preço/múltiplo bloqueiam, salvo em caso de aprovação livre, plano negociado ou confirmação forçada após aviso do sistema.
- Pedidos com destino e-commerce usam o parâmetro próprio Aprovação livre (e-commerce). Quando ligado, a divergência contra a tabela do fornecedor não impede a aprovação — o preço válido é o do site. Pedidos ERP continuam usando só Aprovação livre.
- No e-commerce, se algum produto no site estiver mais caro que o preço do pedido original, a integração não finaliza o carrinho (o pedido fica Pendente e a fila mostra o erro). Site mais barato ou igual segue.
- Pedido todo cortado (zero itens ativos) não pode ser aprovado — oriente-se a reprová-lo.
- Pedido sem vendedor no cabeçalho não pode ser aprovado.
¶ Paridade lista × detalhe (obrigatório)
O 👍 da lista e o botão Aprovar do detalhe devem ter o mesmo comportamento:
- Primeira tentativa sem forçar (
forcar: false). - Se o backend devolver um aviso (ex.: limites de preço excedidos com bloqueio desligado, ou negociação em aberto), o usuário precisa confirmar para reenviar com
forcar: true. - Divergências sem aprovação livre / sem plano NEG, sem DE-PARA, limites bloqueados etc. impedem a aprovação nos dois lugares — sem atalho silencioso.
Código: portal-terus → frontend/.../fornecedor/pedidos/page.tsx e pedidos/[id]/page.tsx. Regra de agente: .cursor/rules/pedido-aprovacao-paridade.mdc.
Testes (regressão): backend/tests/test_pedido_aprovacao.py (gate) e backend/tests/test_pedido_aprovacao_ui_paridade.py (lista/detalhe não enviam forcar: true na 1ª tentativa).
¶ 6. Configuração (avançado)
Disponível para quem tem a permissão de configurar. Agrupa parâmetros por par fornecedor × varejo:
- Agrupamento de Pedidos — junta pedidos similares (mesma loja/data de emissão/vendedor/tipo de carga) em lotes de até N pedidos; N é o teto do ERP de destino (padrão 5 — limite RMS para receber NF, ex. São Luiz). Ordena do menor para o maior volume; funciona com ou sem unitização. Na UI, o principal mostra os numpedidos do lote; secundários ficam com status Agrupado. No ERP (Winthor
OBS1/ VitSisC7OBS1) vai a tagPed.cli A+B+…; oNUMPEDCLI/C7PEDCLIcontinua sendo só o principal.- Consulta dos originais: o pedido Agrupado mostra os itens que o varejo mandou naquele número (somente leitura). A lista também traz quantidade e valor de origem. No principal, o bloco Origem dos itens no lote separa o que veio de cada número — a operação (aprovar, unitizar, ERP) continua só no pedido combinado.
- Consolidação de SKU: produtos repetidos no lote viram uma linha (quantidade somada; preço unitário = o menor entre os pedidos do lote). Sem DE-PARA, não mistura códigos varejo distintos. Atualizar Pedido / Atualizar Pedidos (e a re-unitização) aplicam a mesma regra se ainda houver linhas duplicadas.
- Limitação (Escalonado): até a implementação completa do Escalonado no agrupamento, o preço de cada linha de origem continua calculado com a quantidade por pedido original; na consolidação só se escolhe o menor unitário — não se recalcula a faixa escalonada com a quantidade total do lote. Revisar quando o Escalonado no agrupamento estiver concluído.
- Unitização & Logística — limites de m³/kg, critério, depósitos permitidos.
- Sistemática de abastecimento — quando a rede manda a sistemática no pedido, cada código pode dizer se unitiza (inclusive em CD) e se é crossdock que une pedidos numa loja destino. Código sem regra cadastrada segue o comportamento normal. A quebra por vendedor, tipo de carga e data continua valendo, e produto repetido entra com quantidade somada e o menor preço. Preço e região seguem os da loja de origem. Detalhe: Config. Pedidos.
- Aprovação & Limites — Aprovação livre (só ERP), Aprovação livre (e-commerce) (só destino e-commerce; o preço válido é o do site), % máximo de acréscimo/desconto e bloqueio desses limites (contra a tabela; no e-commerce com o flag ligado não se aplicam). Detalhe dos campos: Config. Pedidos.
- ERP & Integração — conexão, schema, filial ERP, integração automática. Em Winthor, Enviar código de emitente só entra se a Terus estiver no cadastro de emitentes daquele ERP (matrícula, ex.:
7777no JA). Sem cadastro, deixe desligada — o Winthor usa o default da instalação. Detalhe: Config. Pedidos. - Preços — região/tabela padrão, plano de pagamento padrão.
Enquanto não houver configuração salva, a tela exibe o aviso NÃO CONFIGURADO.
O teto do e-commerce não se configura aqui: se o site estiver mais caro que o preço original de algum item, a fila recusa o carrinho.
¶ 7. Boas práticas
- Use Processar Novos Pedidos para trazer o que chegou e Atualizar Pedidos após ajustes de DE-PARA/preço.
- Resolva primeiro os itens Sem De-Para — eles bloqueiam a aprovação (também no e-commerce, mesmo com aprovação livre ligada).
- Confira Divergências antes de aprovar pedidos ERP; use Ajustar Preços quando o pedido vier acima da tabela. No e-commerce, com o parâmetro ligado, a tabela não trava — o que importa é o preço do site na hora de montar o carrinho.
- Pedido de e-commerce que voltou da fila com preço do site maior: não force o reprocesso até o site baixar; o carrinho não é enviado nesse caso.