Tracking
A tela de Tracking é o painel de acompanhamento de todos os pedidos em movimento — dos que acabaram de ser postados até os que já chegaram ao cliente final. É aqui que o time de logística e atendimento monitora o que está em rota, identifica atrasos antes do cliente reclamar e age preventivamente em pedidos com sinal amarelo.
Cada linha representa um pedido com pelo menos um pacote em transporte e mostra: número do pedido, transportadora, código de rastreio, último status do rastreio, último evento da transportadora, datas-chave (postagem, prazo prometido, entrega real) e dois indicadores de pontualidade calculados em tempo real — um pela ótica do cliente (data prometida ao consumidor) e outro pela ótica da transportadora (data acordada no contrato).
A tela é somente leitura — você não cria pedido aqui. Tudo o que aparece veio das outras telas (Vendas, Importação de marketplace, integração da transportadora). Use os filtros do canto direito para focar em um período, transportadora, canal de venda, status ou indicador específico.
Índice
Conceito
- O que é a tela de Tracking?
- De onde vem cada informação?
- Qual a diferença para a tela Mensagem Tracking?
Lendo a lista
- Quais são os status de tracking possíveis?
- Como funciona o status de entrega ao consumidor?
- Como funciona o status de entrega à transportadora?
- O que significa "Último status" do rastreio?
- Qual a diferença entre data de postagem, prazo estimado e entrega?
Uso da tela
- Como filtrar por período?
- Como filtrar por transportadora ou canal de venda?
- Como ver só pedidos atrasados?
- Como ver só pedidos com rastreio ativo na transportadora?
- Como abrir o pedido a partir da linha?
- Posso comentar ou finalizar tracking direto da tela?
Pré-requisitos
Diagnóstico
Referência rápida
O que é a tela de Tracking?
É o espelho de tudo o que está em transporte. Combina, em uma linha por pedido:
- Dados do pedido: número, tipo, valor do frete, consumidor, CEP destino.
- Dados da transportadora: razão social, código de rastreio (ShippingId), modalidade.
- Status atual do rastreio (Postado, Em andamento, Saiu para entrega, Finalizado, Atenção, Extraviado, Devolvido).
- Último evento da transportadora (texto curto descrevendo o que aconteceu por último).
- Datas-chave: postagem, prazo estimado ao consumidor, prazo prometido à transportadora, data de entrega real e data de finalização.
- Indicadores de pontualidade: no prazo, atrasado, em curso, entregue antes/depois.
📍 Onde: menu lateral → Logística → Tracking.
De onde vem cada informação?
A tela é construída em tempo real juntando dados de várias fontes:
| Informação | Origem |
|---|---|
| Número, valor, consumidor, CEP, transportadora | Cadastro do pedido (criado em Vendas ou importado de marketplace). |
| Data de postagem | Registro do pacote (Postar Pedido ou integração da transportadora). |
| Código de rastreio (ShippingId) | Gerado pela transportadora (via integração) ou digitado manualmente no momento da postagem. |
| Status do tracking | Atualizado pela integração da transportadora — entra automaticamente conforme o pacote avança. |
| Último evento da transportadora | Cada evento enviado pela transportadora vira uma linha em Tracking Pedido da ficha do pedido. A coluna mostra o mais recente. |
| Data de entrega | Evento de tracking marcado como "Finalizado" pela transportadora (ou ação manual via privilégio Finalizar tracking). |
| Indicadores de pontualidade | Calculados na hora pela tela, comparando data de entrega vs. data prometida (ao consumidor e à transportadora). |
Qual a diferença para a tela Mensagem Tracking?
| Tracking (esta tela) | Mensagem Tracking | |
|---|---|---|
| O que é | Lista de pedidos em movimento, com status atual. | Cadastro de regras de comunicação (e-mail/WhatsApp) disparadas em cada transição de status. |
| O que faz | Mostra o estado de cada pedido. | Define o que é enviado ao cliente em cada mudança. |
| Tela | Logística → Tracking. | Logística → Mensagem Tracking. |
A Mensagem Tracking é o gatilho de comunicação; esta tela é o espelho de movimento.
Quais são os status de tracking possíveis?
Os status que aparecem na coluna Status tracking vêm dos eventos da transportadora e são mapeados pelo idworks em um conjunto fixo:
| Status | Significado |
|---|---|
| Postado | Pacote foi registrado mas ainda não entrou em transporte. Cor cinza claro. |
| Em andamento | Está em trânsito entre centros da transportadora. Cor azul. |
| Saiu para entrega | Com o entregador para entrega no dia. Cor azul. |
| Finalizado | Entregue com sucesso. Cor verde. |
| Atenção | Há um evento que merece acompanhamento (tentativa falhada, endereço incorreto, devolução em curso). Cor vermelho claro. |
| Extraviado | Transportadora reportou perda. Cor cinza claro. |
| Devolvido | Pacote voltou à origem. Cor cinza claro. |
Quando o tracking ainda não foi iniciado (pacote criado mas a transportadora ainda não enviou nenhum evento), a coluna pode vir vazia.
Como funciona o status de entrega ao consumidor?
A coluna Entrega consumidor indica como o prazo prometido ao cliente está sendo cumprido. O cálculo compara duas datas:
- Data esperada =
Data estimada de entregado pedido (data informada ao consumidor no checkout). - Data real = data em que o pedido foi marcado como Finalizado. Se ainda não foi entregue, usa a data de hoje.
Resultado:
| Status | Significado |
|---|---|
| Entregue antes do prazo | Pedido finalizado em data anterior à estimada. |
| Entregue após o prazo | Pedido finalizado em data posterior à estimada. |
| Entregue no prazo | Pedido finalizado no dia exato da estimativa. |
| Em curso, dentro do prazo | Pedido ainda não foi entregue, mas a data estimada ainda não venceu. |
| Atrasado | Pedido ainda não foi entregue e a data estimada já passou. |
Atenção: se o pedido não tem Data estimada de entrega cadastrada, esta coluna vem vazia.
Como funciona o status de entrega à transportadora?
Mesma lógica do anterior, mas comparando contra a Data prometida à transportadora (CarrierDeliveryDate) — a data acordada no contrato com a transportadora, geralmente diferente do prazo informado ao consumidor (que costuma incluir um colchão).
Os códigos são os mesmos. Se a transportadora cumpre o contrato mas estoura o prazo prometido ao consumidor, você vê:
- Entrega transportadora = Entregue no prazo ou antes.
- Entrega consumidor = Entregue após o prazo.
Esse confronto ajuda a entender se o atraso veio da transportadora ou do colchão prometido ao cliente.
O que significa "Último status" do rastreio?
A coluna Último status mostra o texto descritivo do evento mais recente enviado pela transportadora — por exemplo "Saiu para entrega em São Paulo/SP", "Entrega não realizada — destinatário ausente", "Em separação". É o evento bruto da transportadora, complementar ao status macro (Postado / Em andamento / etc.).
Junto vem a coluna Última data com a data e hora do evento.
Qual a diferença entre data de postagem, prazo estimado e entrega?
| Coluna | O que significa | De onde vem |
|---|---|---|
| Data postagem | Quando o pacote foi efetivamente postado/coletado. | Registro do pacote — etiqueta gerada e pacote enviado à transportadora. |
| Prazo estimado | Data prometida ao consumidor no checkout. | Cotação de frete + offset de processamento interno. |
| Prazo transportadora | Data acordada no contrato com a transportadora. | Cotação de frete bruta (sem colchão). |
| Data entrega | Quando o pedido foi marcado como Finalizado. | Evento da transportadora (status = Finalizado) ou ação manual via privilégio Finalizar tracking. |
| Data finalização | Quando o pedido teve qualquer evento de finalização (entregue, devolvido, extraviado). | Evento mais recente que finaliza o ciclo. |
Como filtrar por período?
- Clique no botão Filtros no canto superior direito.
- No painel, escolha um intervalo em:
- Data pedido (data de criação do pedido).
- Data postagem (data em que o pacote foi postado).
- Data estimada (prazo prometido ao consumidor).
- Aplique o filtro.
Você pode combinar mais de um intervalo. Útil quando quer ver "pedidos postados entre o dia 1 e 5, com prazo estimado expirando nesta semana".
Como filtrar por transportadora ou canal de venda?
No painel de Filtros, use:
- Transportadora: lista as transportadoras cadastradas como fornecedor da empresa.
- Canal de venda: lista os canais (Mercado Livre, Shopee, loja própria, etc.).
- Integração: filtra por integração específica (útil quando você tem mais de uma conta no mesmo canal).
Combine os três para ver, por exemplo, "pedidos do Mercado Livre conta X postados pela Correios".
Como ver só pedidos atrasados?
No painel de Filtros, no campo Entrega consumidor ou Entrega transportadora, selecione "Atrasado". A lista passa a mostrar só pedidos cujo prazo já venceu e ainda não foram entregues.
Combine com filtro de período (ex.: pedidos com prazo estimado nos últimos 7 dias) para focar nos mais urgentes.
Como ver só pedidos com rastreio ativo na transportadora?
A URL desta tela suporta um parâmetro extra que liga um filtro automático: quando ela é aberta pelo menu Logística → Tracking ela mostra todos os pedidos em movimento; se vier por um link que inclui o sinalizador de rastreio ativo, a lista é restrita aos pedidos cuja transportadora tem integração de rastreio ativa.
Isso é útil quando você só quer monitorar pedidos onde a transportadora envia eventos automaticamente para o idworks (a maioria dos casos modernos) — sem se preocupar com pedidos enviados por transportadoras que não atualizam o tracking.
Como abrir o pedido a partir da linha?
Três opções:
- Clique no número do pedido (coluna Pedido) — abre a ficha em uma aba paralela.
- Botão Visualizar (ícone de olho) na coluna de ações — abre o pedido em janela modal, já posicionado na aba Tracking do pedido.
- Duplo clique na linha — mesmo efeito do botão Visualizar (precisa do privilégio de visualizar pedidos).
Dentro da ficha do pedido, a aba Tracking mostra toda a linha do tempo de eventos da transportadora, comentários internos do time e, dependendo do privilégio, permite comentar ou marcar como finalizado.
Posso comentar ou finalizar tracking direto da tela?
Não direto desta tela. Para comentar ou marcar como finalizado, abra a ficha do pedido (clique no número ou no ícone Visualizar) e use a aba Tracking do pedido — onde existem privilégios separados:
- Fazer comentário tracking — adiciona texto interno ao histórico do rastreio (não vai para o cliente, é nota do time).
- Finalizar tracking — marca manualmente o pacote como entregue (útil quando a transportadora não envia o evento Finalizado mas você confirmou a entrega por outro canal).
Pré-requisitos para a tela funcionar bem
Embora a tela seja somente de consulta, alguns pontos no cadastro afetam o que aparece aqui:
| Configuração | Onde | Por que importa |
|---|---|---|
| Pedidos com pacote criado | Vendas / Importação de marketplace | A tela só lista pedidos com pelo menos 1 pacote. Sem pacote = pedido não aparece. |
| Transportadora cadastrada como fornecedor | Cadastros → Fornecedores | O nome da transportadora vem desse cadastro. |
| Transportadora com integração de rastreio | Cadastro do tipo da transportadora | Sem integração ativa, o status do tracking não atualiza automático. |
| Data estimada de entrega no pedido | Cotação de frete / cadastro do pedido | Sem ela, o indicador de pontualidade ao consumidor fica vazio. |
| Data prometida à transportadora | Cotação de frete | Sem ela, o indicador de pontualidade à transportadora fica vazio. |
| Eventos do tracking chegando | Integração da transportadora | Sem eventos, status e último evento ficam vazios — o pedido aparece como "Postado" indefinidamente. |
Um pedido sumiu da tela — onde foi?
Possibilidades em ordem de probabilidade:
- Pedido cancelado: pedidos cancelados continuam no histórico mas não aparecem nesta tela (que foca em movimento).
- Pacote não criado: se o pedido ainda não teve o pacote gerado, ele não entra na lista. Confira na ficha do pedido se o pacote existe.
- Filtros aplicados: confira o painel de Filtros — pode estar restringindo por período, transportadora, status ou indicador que excluem o pedido.
- Conta diferente (multi-empresa): verifique se você está na conta correta no seletor.
- Já passou da paginação: a tela mostra 3000 por página; se o pedido é antigo, role para baixo ou pagine.
O status de tracking não atualizou — por quê?
Causas comuns:
- Transportadora sem integração de rastreio: nem todas as transportadoras enviam eventos automáticos. Sem integração, o status fica como Postado até alguém finalizar manualmente.
- Código de rastreio ausente ou incorreto: a integração só consegue puxar eventos se o
ShippingId(código de rastreio) está correto. Confira na ficha do pedido. - Atraso da transportadora em enviar o evento: algumas transportadoras só atualizam de tempos em tempos (a cada 2-4 horas). Aguarde e dê F5.
- Erro na integração: abra um chamado de suporte para verificar se a integração da transportadora está saudável.
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 tracking | Acessa a tela e a lista de pedidos em rastreamento, com todos os filtros disponíveis. Sem este privilégio, o item de menu nem aparece. |
| Fazer comentário tracking | Permite adicionar comentários internos no histórico de tracking de cada pedido (visível na aba Tracking do pedido, não vai para o cliente). |
| Finalizar tracking | Permite marcar manualmente um pedido como entregue/finalizado quando a transportadora não envia o evento. |
Os dois últimos privilégios não atuam direto nesta lista — eles habilitam ações dentro da aba Tracking de cada pedido, alcançada via Visualizar.