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, Inicio 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".
- Despesas do pedido — grava "Adicionar despesa" quando uma despesa (conta a pagar) é lançada com vínculo ao pedido.
- Fechar Pedido (botão da ficha do pedido, que aparece como Fechar Nota Fiscal quando o tipo de pedido não movimenta estoque e como Fechar OS em ordem de serviço) — grava "Finalizar pedido" com Sucesso quando o pedido entra na operação e, quando a finalização é recusada, grava "Finalizar pedido" com Problema trazendo nos Comentários o motivo da recusa (status que não permite finalizar, endereço ou CEP incompleto, pedido sem itens, pagamento divergente, cadastro fiscal do produto incompleto, falta de transportadora, etc.). Antes, só a recusa por CEP não localizado nos Correios ficava registrada; agora toda recusa devolvida pelo sistema ao tentar finalizar fica registrada no histórico do pedido (o botão Fechar Pedido desabilitado na ficha do pedido, por falta de privilégio ou pelo status, não gera evento).
- Picking List / Packing — grava "Inserido Picking List", "Removido picking list", "Inicio 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" nas duas pontas do pedido: pronto para manuseio (assim que o pedido é finalizado e entra na operação), em andamento, postado, saiu para entrega, em atenção, aguardando retirada, entregue e pós entrega; além de "Envio e-mail/WhatsApp NF", "Envio e-mail/WhatsApp boleto" e "Enviar mensagem".
- Retirada em loja — grava "Código de segurança para retirada gerado", "Reenvio do código de segurança solicitado", "Código de segurança enviado por e-mail", "Código de segurança enviado por WhatsApp" e "Código de segurança validado".
- Integrações com canais — grava "Gerar etiqueta canal de venda", "Baixar pacote canal de venda", "Rastreio enviado ao canal de venda" (cada ocorrência de rastreio de um pedido Mercado Livre ME1 repassada ao canal), "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".
- Link de pagamento da Cielo — grava "Pagamento negado", com Problema, a cada tentativa de pagamento recusada no link de pagamento de um pedido.
- virgginIA (WhatsApp) — grava "Ação pela virgginIA" a cada alteração no pedido que o usuário confirma na conversa com a virgginIA, como fechar o pedido ou emitir a NF-e. Consultas e recusas não geram registro, nem as alterações em que o sistema respondeu que não conseguiu fazer.
- Transferência entre CDs — quando o pedido de transferência é finalizado e a empresa usa recebimento sem nota fiscal, grava um "Pedido editado" informando o número do recebimento que o sistema abriu automaticamente no CD de destino. É o atalho para achar o recebimento correspondente ao pedido.
A lista completa hoje tem 82 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. Nas ações feitas pela virgginIA, aparece o usuário que confirmou a ação na conversa.
- 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.
- Falhas de Criar NF simbólica (devolução simbólica de armazenagem) são sempre registradas com o motivo — Tipo de Pedido sem a devolução simbólica configurada, item sem lote de saída referenciado, lote sem chave de devolução ou sem lote de entrada. Vale mesmo quando o processo segue adiante sem interromper a operação.
- A ação de envio da NF por e-mail registra dois envios diferentes: o e-mail automático da NF (XML + DANFE), mandado ao cliente e às cópias ocultas configuradas nas parametrizações quando a NF é emitida, e o e-mail das regras da Mensageria pedido com o gatilho Emissão de nota fiscal. Os parágrafos abaixo valem para o e-mail automático da NF. Quando quem falha é o e-mail da Mensageria pedido, o comentário traz o motivo devolvido pelo servidor de e-mail, nunca começa com "Não será reenviado:" e o sistema tenta enviar de novo automaticamente.
- Falhas no e-mail automático da NF trazem o motivo devolvido pelo servidor de e-mail (ex.: a resposta do servidor de e-mail próprio da empresa ou a recusa do endereço do destinatário). Quando o comentário começa com "Não será reenviado:", a falha é definitiva e o sistema não tenta enviar de novo. Alguns exemplos: usuário/senha recusados pelo servidor de e-mail próprio da empresa, endereço do destinatário inválido ou recusado, remetente da empresa não verificado, nenhum destinatário para a NF ou outra recusa definitiva do servidor de e-mail próprio da empresa (como caixa do destinatário cheia ou mensagem recusada). Não há na tela uma ação para reenviar o e-mail da NF que falhou: corrija a causa para que as próximas NFs sejam enviadas e mande o XML/DANFE dessa NF ao cliente por fora.
- Nas falhas passageiras (ex.: servidor de e-mail que não respondeu a tempo), o comentário vem sem esse prefixo e o sistema tenta enviar de novo automaticamente, até três envios no total. Cada tentativa que falha gera uma nova linha com Problema e, se uma delas der certo, aparece a linha com Sucesso. Se as três falharem, o envio é abandonado sem nenhuma linha a mais no log: várias linhas de Problema sem o prefixo e nenhuma de Sucesso querem dizer que o e-mail não foi entregue.
- Quando o servidor de e-mail próprio da empresa recusa o usuário/senha, além da linha com Problema a integração de e-mail fica marcada para revalidar as credenciais: quem tem acesso às parametrizações vê, logo depois de entrar no sistema (uma vez por login), o aviso para Validar credenciais para a integração. Enquanto o usuário/senha não forem corrigidos na integração de e-mail, os próximos envios por esse servidor continuam falhando.
- Se o pedido não tem um e-mail de cliente para receber a NF (cliente sem e-mail, envio ao cliente desligado ou e-mail de um domínio que o sistema bloqueia), mas há e-mails de cópia oculta configurados para receber as NFs, o primeiro e-mail de cópia oculta passa a ser o destinatário e a NF é enviada normalmente (linha com Sucesso). Se o cliente não tem e-mail (ou o envio ao cliente está desligado) e não há cópia oculta configurada, o e-mail da NF nem é enviado e nenhuma linha é gravada no log. Se o e-mail do cliente é de um domínio bloqueado e não há cópia oculta configurada, o envio não acontece e a linha com Problema traz "Não será reenviado:" seguido do motivo.
- Nas NFs que chegam pelo canal de venda (marketplace), o e-mail automático da NF não vai para o cliente: vai só para o e-mail configurado para isso na integração do canal. Sem esse e-mail configurado, não há envio nem linha no log.
- Quando a finalização do pedido é recusada, o evento Finalizar pedido com Problema traz a mesma mensagem de erro que o sistema devolveu na tentativa, seja de um usuário na tela, seja de uma finalização automática (integração/hub, prazo estimado de expedição, boleto pago). Quando o pedido é desviado para aprovação (margem, desconto ou crédito do cliente), na primeira tentativa o evento de aprovação pendente é gravado como antes, junto com o Finalizar pedido com Problema; em novas tentativas com o pedido já aguardando aprovação, em geral aparece só o Finalizar pedido com Problema (a exceção é a margem de contribuição abaixo do mínimo, que grava o evento de aprovação a cada tentativa).
- Adicionar despesa traz, numa linha só (separada por "|"), o número da despesa, o valor, o vencimento e os demais dados informados no lançamento: fornecedor ou cliente, plano de contas, forma de pagamento, tipo e número do documento, competência, a quantidade e o total das retenções e a observação. O valor registrado é o líquido, já descontadas as retenções. Numa despesa recorrente, traz a quantidade e os números das despesas (até 12), o valor total e o intervalo de vencimentos.
- Rastreio enviado ao canal de venda traz a situação enviada ao Mercado Livre (status/substatus) e a descrição da ocorrência de rastreio.
- Pagamento negado traz uma linha que começa com "Cielo: pagamento negado em (data e hora da tentativa)", seguida, entre parênteses, do valor, da bandeira e do final do cartão, das parcelas (quando há mais de uma) e do NSU, e depois do código de retorno com o motivo (ex.: "código 51 - SALDO/LIMITE INSUFICIENTE"). A marca
[tentativa ...]no fim da linha identifica a tentativa na Cielo, e é por ela que cada tentativa é registrada uma vez só. O mesmo texto vai para o Comentários do pagamento do pedido, se o pagamento daquele link ainda existir no pedido. - Ação pela virgginIA traz "Feito pela virgginIA (WhatsApp) a pedido de (nome do usuário), confirmado às HH:MM:", seguido do resumo do que foi feito (ex.: "Fechar o pedido"). Em algumas alterações, quando o sistema demora para responder, o resumo termina com "(o sistema demorou para responder; pode não ter sido concluído)": confira o pedido antes de repetir a ação.
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, Inicio 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, Rastreio enviado ao 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, pronto para manuseio, pedido em andamento, saiu para entrega, postado, em atenção, aguardando retirada, entregue, pós entrega, boleto) e os equivalentes Envio WhatsApp; Enviar mensagem.
- Retirada em loja: Código de segurança para retirada gerado, Reenvio do código de segurança solicitado, Código de segurança enviado por e-mail, Código de segurança enviado por WhatsApp, Código de segurança validado.
- 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, Pagamento negado, Adicionar despesa, Ação pela virgginIA, Alteração status plataforma (em manuseio, faturado, enviado, entregue, faturamento parcial, "Já tenho o produto").
Novidade: os eventos Envio e-mail pronto para manuseio e Envio WhatsApp pronto para manuseio passaram a ser gravados no momento em que o pedido é finalizado e entra na operação — é o aviso de "pedido confirmado / pagamento aprovado" que o cliente recebe. O sistema grava um registro por canal e por pedido: se o time refizer a finalização do mesmo pedido, a mensagem não é reenviada nem duplicada no log. Se o evento não aparece, confira em TMS → Mensageria pedido se existe uma regra ativa com o gatilho Pedido pronto para manuseio (e, quando a regra restringe canal de venda ou tipo de pedido, se o pedido se encaixa) e se o cliente tem e-mail/telefone preenchidos no cadastro.
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. |