# 13.4 Rastreamento automático

> Como o Cota Frete acompanha o rastreio dos pedidos e atualiza o status na Shopify, quais pedidos e transportadoras ele acompanha, de quanto em quanto tempo e o que ele não faz.

Fonte: https://www.cotafrete.app/manual/pedidos/rastreamento-automatico/
Planos: Basic, Business · no checkout, requer o Carrier Calculated Shipping (CCS) da Shopify
Atualizado em 25/10/2026

---

"Cadê meu pedido?" é a pergunta mais repetida no atendimento de qualquer loja. Ela aparece quando o cliente fica sem notícia. O rastreamento automático do Cota Frete existe para que a notícia chegue antes da pergunta: a cada mudança de status na transportadora, o pedido na Shopify é atualizado, e a própria Shopify avisa o cliente.

Não há tela nem configuração no app. O que você precisa fazer é o que já faz hoje: marcar o pedido como enviado, com o código de rastreio.

## Quais pedidos são acompanhados

O app acompanha um pedido quando duas condições se cumprem:

1. **O frete do pedido saiu da cotação do Cota Frete no checkout.** É pelo código do serviço escolhido no checkout que o app sabe qual transportadora consultar. A cotação no checkout depende do Carrier Calculated Shipping (CCS, "cotação calculada pela transportadora") da Shopify e faz parte dos planos Basic e Business. Numa loja no plano Widget, que cota só na página do produto e no carrinho, não há pedido para acompanhar.
2. **O serviço é de uma transportadora conectada direto** e que tem rastreamento no app: **Correios, Total Express, J&T Express, Jadlog, Gollog e Lalamove**.

Ficam de fora os pedidos enviados por Loggi, R3 Express, pela entrega local ou pelas tabelas dos Fretes Próprios, e pelos serviços de um gateway de frete (Melhor Envio, Frenet, Intelipost, SmartEnvios, SuperFrete), mesmo quando a transportadora por trás é uma das acompanhadas. Nesses casos, o rastreio segue o padrão da Shopify: o link que você informou no envio.

Na Lalamove, o código de rastreio é o número do pedido feito na Lalamove. Veja [Lalamove](https://www.cotafrete.app/manual/transportadoras/lalamove/).

## Como funciona

1. Você marca o pedido como **enviado** na Shopify, com o código de rastreio.
2. A Shopify avisa o app, e ele passa a acompanhar aquele código.
3. A cada 3 horas, o app consulta a transportadora. Na Lalamove, que entrega no mesmo dia, a consulta é a cada 10 minutos, durante os 2 primeiros dias.
4. Quando o status muda, o app registra um **evento de envio** no pedido da Shopify.
5. A Shopify envia ao cliente a notificação correspondente, do jeito que está configurada na sua loja.
6. Quando o status vira **entregue**, o app para de consultar.

O histórico fica na linha do tempo do pedido, no admin. O cliente recebe o e-mail com a identidade visual da loja, porque quem envia é a Shopify.

Se você trocar o código de rastreio de um envio, o app recomeça o acompanhamento com o código novo e descarta o histórico do antigo.

## Os status

O app traduz a resposta de cada transportadora para os status de envio da Shopify:

| Status | O que significa |
|---|---|
| Confirmado | A transportadora registrou o envio |
| Em trânsito | O pacote está a caminho |
| Saiu para entrega | O pacote está com o entregador |
| Disponível para retirada | O pacote aguarda o cliente numa agência ou ponto |
| Tentativa de entrega | O entregador não conseguiu entregar |
| Atrasado | A transportadora sinalizou atraso |
| Falha | A entrega não pôde ser feita |
| Entregue | O pacote chegou |

Quando a transportadora devolve um status que o app ainda não conhece, o pedido fica como **Em trânsito** e a equipe do Cota Frete recebe o aviso para mapear o status novo.

## Código que a transportadora não encontra

Um código digitado errado, ou postado em outra transportadora, nunca vai aparecer no sistema dela. Quando a Jadlog responde "não localizado" ou a J&T Express responde que o código não existe, o app conta a falha em vez de registrar um status. Depois de 5 falhas seguidas, num envio com pelo menos 7 dias, o app para de consultar aquele código. Ele sai das consultas e dos números de "em trânsito" e "atrasadas" do painel, mas continua guardado. Se a transportadora passar a encontrar o código antes disso, a contagem volta a zero.

Se um pedido parou de atualizar, confira o código de rastreio no envio.

## O que o rastreamento não faz

- **Não envia e-mail próprio.** Quem avisa o cliente é a Shopify, com os templates dela. Para mudar o texto, edite o template de notificação na Shopify.
- **Não tem página de rastreio.** O cliente acompanha pela página de status do pedido da Shopify ou pelo site da transportadora.
- **Não funciona sem código.** Envio marcado sem código de rastreio não tem o que acompanhar.

## Duas rotinas que fazem diferença

- **Marque o envio no dia da postagem**, com o código certo. O acompanhamento começa dali, e um código errado gera status que não correspondem ao pacote.
- **Ative as notificações de entrega na Shopify.** Algumas vêm desligadas. Sem elas, o pedido é atualizado mas o cliente não recebe nada. Veja [Notificações de entrega da Shopify](https://www.cotafrete.app/manual/pedidos/notificacoes-de-entrega/).

Os mesmos dados alimentam a aba [Rastreio](https://www.cotafrete.app/manual/painel-e-relatorios/aba-rastreio/) do Painel e relatórios, onde você vê o percentual de entregas no prazo e o tempo médio por estado.