Log Pedidos
A tela Log Pedidos é o histórico cronológico de tudo que acontece em cada pedido. Cada linha mostra uma ação registrada pelo sistema — quem fez (usuário), o que fez (Pedido criado, Cancelar pedido, Emissão Nota Fiscal, Início Packing, Envio e-mail, Alteração status, etc.), em qual pedido e com qual resultado (Sucesso, Problema ou um status alternativo). A coluna Comentários (expansível) traz o detalhe que o sistema gravou para aquela ação, incluindo a mensagem de erro quando a ação falhou.
A tela é somente leitura — não cria, edita nem exclui registros. Os eventos são gravados automaticamente pelas demais telas do sistema (Pedidos, Picking List, Packing, Romaneio, Notas Fiscais, integrações com canais, envio de mensagens, etc.) à medida que elas executam suas ações. Use Log Pedidos para diagnosticar problemas ("por que esse pedido não saiu?", "quem cancelou esse pedido?") e para auditar o que cada usuário fez no histórico do pedido.
Índice
Conceito
Lendo a lista
- O que significa cada Status (Sucesso, Problema)?
- O que aparece em Comentários?
- Quais ações são registradas?
- Como abrir o pedido a partir da linha?
Busca e filtros
- Como filtrar por pedido?
- Como filtrar por ação?
- Como filtrar por usuário?
- Como filtrar por período?
- Como ver só o que deu erro?
Regras de negócio
- Posso apagar ou editar um registro?
- Por que um pedido não aparece no log?
- Quanto tempo o histórico fica guardado?
Referência rápida
O que é Log Pedidos?
É o histórico de ações realizadas em cada pedido. Cada vez que uma tela executa uma ação relevante — finalizar um pedido, emitir uma nota fiscal, cancelar, mover de status, gerar etiqueta, enviar um e-mail, etc. — o sistema grava uma linha aqui com a data/hora, o usuário responsável, a descrição da ação, o resultado (Sucesso ou Problema) e um comentário detalhando o que aconteceu.
📍 Onde: menu lateral → Vendas → Log Pedidos.
De onde vêm os eventos da lista?
Os eventos são gravados pelas próprias telas do sistema, no momento em que elas executam suas ações. Esta tela apenas consulta esses registros. Exemplos de origem:
- Pedidos — grava "Pedido criado", "Pedido editado", "Cancelar pedido", "Alteração status", "Adicionar/Remover/Editar Item", "Adicionar/Remover/Editar pagamento", "Segurar pedido", "Colocar em espera".
- Picking List / Packing — grava "Inserido Picking List", "Removido picking list", "Início Packing", "Aguardando expedição", "Finalizar Picking".
- Romaneio / Expedição — grava "Expedido", "Envio EDI transportadora", "Cancelar EDI transportadora", "Aguardando retirada", "Entregue com sucesso", "Devolvido", "Extraviado".
- Notas Fiscais — grava "Emissão Nota Fiscal", "Nota Fiscal importada", "Cancelar Nota Fiscal", "Carta Correção Nota Fiscal", "Inutilização Nota Fiscal", "Limpar dados fiscais", "Consulta status NF", "Criar NF simbólica".
- Comunicação com o cliente — grava "Envio e-mail" e "Envio WhatsApp" (em andamento, saiu para entrega, postado, entregue, em atenção, boleto, NF), "Enviar mensagem".
- Integrações com canais — grava "Gerar etiqueta canal de venda", "Baixar pacote canal de venda", "Alteração status plataforma…", "Integração externa", "Gerar SRO".
- Operação — grava "Não conformidade", "Em tratativa", "Solicitar correios reverso", "Aprovação margem pendente", "Aprovação desconto máximo", "Aprovação crédito cliente pendente", "Criado/adicionado pedido de compra", "Simulação de frete", "Split pedido", "Gerar boleto".
A lista completa hoje tem mais de 60 tipos de ação. Para ver todos: filtro Ação abre a lista oficial.
Quais informações cada linha mostra?
Cada linha do log traz:
- Data/hora — momento exato em que a ação foi registrada.
- Usuário — quem executou a ação (nome + login). Quando a ação foi disparada por um processo automático (worker, integração), aparece o usuário técnico responsável.
- Descrição da ação — texto curto que identifica o tipo da ação (ex.: "Pedido criado", "Cancelar Nota Fiscal").
- Código pedido — código interno do pedido envolvido.
- Visualizar pedido — ícone de olho que abre o pedido em uma nova aba (quando você tem privilégio de visualizar pedidos).
- Status — resultado da ação (Sucesso, Problema ou status alternativo). Coloração: verde para Sucesso, vermelho para Problema, cinza para os demais.
- Conta — em ambiente multi-conta, identifica a conta dona do pedido.
- Código log — id interno do registro (útil para suporte).
Ao expandir a linha (ícone de seta à esquerda), você vê Comentários com o detalhe completo daquele evento.
O que significa cada Status (Sucesso, Problema)?
Três valores possíveis:
| Status | Significado |
|---|---|
| Sucesso (verde) | A ação foi concluída sem erro. É o caso da grande maioria dos eventos. |
| Problema (vermelho) | A ação falhou. Os Comentários trazem a mensagem de erro retornada por quem tentou executar a ação (ex.: rejeição da Sefaz, erro do canal de venda, validação interna). |
| Status (cinza) | Eventos especiais (ex.: ações que ainda estão em andamento ou registros internos marcados como Inativos). Pouco comum no dia a dia. |
O filtro Status da tela só lista Erro e Sucesso — para ver os demais, faça a busca sem filtro de status.
O que aparece em Comentários?
O texto que o sistema gravou para aquela ação. Varia bastante por tipo:
- Para ações com Sucesso, geralmente vem vazio ou com uma pequena descrição (ex.: motivo do cancelamento, número da NF emitida, transportadora utilizada).
- Para ações com Problema, vem a mensagem de erro completa — incluindo retornos crus de Sefaz, do canal de venda ou de webservices externos. Essa é a principal pista para entender por que algo falhou.
Clique no ícone de seta à esquerda da linha para expandir e ler o comentário inteiro.
Quais ações são registradas?
A lista oficial das ações que o sistema reconhece está dentro do próprio filtro Ação (Filtros → Ação → abrir a lista). As mais comuns no dia a dia incluem:
- Ciclo do pedido: Pedido criado, Pedido editado, Adicionar/Remover/Editar Item, Adicionar/Remover/Editar pagamento, Finalizar pedido, Alteração status, Cancelar pedido, Segurar pedido, Colocar em espera, Split pedido.
- Operação no CD: Inserido Picking List, Removido picking list, Finalizar Picking, Início Packing, Aguardando expedição, Não conformidade, Em tratativa.
- Expedição: Expedido, Envio EDI transportadora, Cancelar EDI transportadora, Gerar etiqueta canal de venda, Baixar pacote canal de venda, Gerar SRO, Aguardando retirada, Entregue com sucesso, Extraviado, Devolvido, Solicitar correios reverso.
- Notas fiscais: Emissão Nota Fiscal, Cancelar Nota Fiscal, Carta Correção Nota Fiscal, Inutilização Nota Fiscal, Nota Fiscal importada, Limpar dados fiscais, Consulta status NF, Criar NF simbólica.
- Comunicação: Envio e-mail (Nota Fiscal, pedido em andamento, saiu para entrega, postado, em atenção, aguardando retirada, entregue) e os equivalentes Envio WhatsApp; Enviar mensagem.
- Aprovações e integrações: Aprovação margem pendente, Aprovação desconto máximo, Aprovação crédito cliente pendente, Integração externa, Criado/adicionado pedido de compra, Simulação de frete, Gerar boleto, Alteração status plataforma (em manuseio, faturado, enviado, entregue, faturamento parcial, "Já tenho o produto").
Como abrir o pedido a partir da linha?
Clique no ícone olho (coluna Visualizar pedido) na linha desejada. O pedido abre em uma nova aba, mantendo o log aberto.
Pré-requisito: o usuário precisa ter o privilégio Visualizar Pedido (ou equivalente do módulo de Pedidos). Sem ele, o ícone não fica disponível.
Como filtrar por pedido?
Use os campos do painel Filtros (botão no topo da tela):
- Código pedido — busca pelo id interno do pedido (mesmo número exibido na coluna).
- Pedido — busca pelo número do pedido visível ao cliente (o "número humano" que aparece na nota e nos canais).
Use um ou outro conforme o que você tem em mãos.
Como filtrar por ação?
No painel Filtros, abra o seletor Ação e escolha o tipo de evento (ex.: "Cancelar Nota Fiscal", "Emissão Nota Fiscal", "Alteração status"). O sistema lista apenas os eventos daquele tipo.
Útil para perguntas do tipo "quais pedidos tiveram a NF cancelada hoje?" ou "quais pedidos foram cancelados nesta semana?".
Como filtrar por usuário?
No painel Filtros, abra o seletor Usuário e escolha o operador. O sistema lista apenas os eventos disparados por aquele usuário.
Quando a ação foi disparada por um processo automático (worker de integração, agendamento), aparece registrada no nome do usuário técnico associado.
Como filtrar por período?
No painel Filtros, use o campo Data log (seletor de intervalo de datas). A faixa cobre o dia inteiro: do início da data inicial até 23:59:59 da data final.
Sem informar período, a busca traz os registros mais recentes (até 5.000 por página, ordenados do mais recente para o mais antigo).
Como ver só o que deu erro?
No painel Filtros, abra o seletor Status e escolha Erro. A lista passa a mostrar apenas eventos com Problema — combine com o filtro de Ação ou de Período para focar no que importa.
Esse é o uso mais comum desta tela: vasculhar falhas para entender o que travou em uma operação (NF rejeitada, envio de e-mail falhou, integração com canal não respondeu, etc.).
Posso apagar ou editar um registro?
Não. O Log Pedidos é somente leitura. Os registros são gravados automaticamente pelas demais telas e ficam imutáveis — isso garante a confiabilidade do histórico para auditoria. A tela não tem botão Adicionar, Editar nem Remover.
Por que um pedido não aparece no log?
Possibilidades:
- O pedido não pertence à conta que você está consultando — use o filtro Conta ou troque a conta ativa.
- O usuário não tem privilégio para ver pedidos daquela conta.
- O filtro de Data log está cortando os registros — alargue o período.
- A ação esperada não chegou a ser registrada (ex.: o pedido nunca passou por aquele estágio).
Se o pedido realmente existe e mesmo assim não aparece, abra o pedido pela tela de Pedidos e verifique se a aba/seção de Histórico dele está vazia — isso confirma se o problema é só de filtro ou se nenhum evento foi gravado.
Quanto tempo o histórico fica guardado?
O log fica gravado por tempo indeterminado junto com o pedido — não há expiração padrão. A consulta tem um limite técnico de 5.000 registros por página, ordenados do mais recente para o mais antigo. Para janelas grandes, restrinja por Data log, Ação, Usuário ou Pedido antes de exportar.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar Log pedidos | Acesso à tela e à consulta do histórico. |