> For the complete documentation index, see [llms.txt](https://docs.troqueedevolva.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.troqueedevolva.com.br/rastreamento/configuracoes/ativando-a-importacao-de-pedidos.md).

# Ativando a importação de pedidos

Para ativar o rastreamento com a importação de todos os seus pedidos, acesse **Configurações > Configurações gerais.**

## Configurando a importação

### Ativando a importação de pedidos

Ative a importação, marcando o botão "**Ativar**". 

Por padrão, a importação e atualização dos dados de pedidos ocorrem a cada 4 horas e funcinam em três etapas:

1. São importados todos os pedidos que estejam com pagamento confirmado
2. Depois, será cadastrada a nota fiscal
3. Por fim, serão cadastrados os volumes.

 A cada 4 horas (ou no tempo que você configurar), a Troque & Devolva vai investigar sua plataforma de e-commerce em busca de novos pedidos pagos e de atualizações dos pedidos que já tinham sido importados anteriormente. 

Ao ativar a importação, você verá o agendamento da próxima execução:

<figure><img src="/files/6T16nq3ryaF3e7CuJwqm" alt=""><figcaption></figcaption></figure>

### Tempo entre execuções e dias retroativos

Utilizamos **código Cron** para sinalizar ao sistema, de quantas em quantas horas devem ser buscados novos pedidos. O padrão é sempre a cada 4 horas.

Você pode, se precisar, ajustar quantos dias retroativos devem ser importados. Por padrão, buscaremos sempre pedidos de 3 dias retroativos.&#x20;

<figure><img src="/files/tFLPVUMA8tqFykepoKOm" alt=""><figcaption></figcaption></figure>

### Impedindo a importação de determinados pedidos

{% hint style="info" %}
Pedidos que possuam apenas produtos digitais, que não possuem entrega física, nunca são importados.&#x20;
{% endhint %}

A Troque & Devolva importará todos os pedidos do seu e-commerce, desde que os pedidos estejam pagos. Mas podem ocorrer situações em que vocês não desejem importar pedidos, como por exemplo, pedidos que foram retirados diretamente na sua loja (não precisam ser rastreados).&#x20;

Para estes casos, você deve cadastrar **filtros de exclusão:**

<figure><img src="/files/vGxAyha1DnXug5f4BgUZ" alt=""><figcaption></figcaption></figure>

## Realizando importação manualmente

Há possibilidade de importar todos os pedidos e, se for algo pontual, apenas um pedido. \
Para isso, clique no menu Ações > **Importar agora:**

<figure><img src="/files/zedLwkjMYHNX8EqHFphc" alt=""><figcaption></figcaption></figure>

A importação ocorrerá em segundo plano e você poderá voltar depois para consultar o status:

<figure><img src="/files/XEP7FBraoF8rq70fJRkV" alt="" width="563"><figcaption></figcaption></figure>

### Verificando o histórico de importação

Para saber quais pedidos retornaram erro, basta clicar sobre a marcação da quantidade de erros no card de **Última Execução**:

<figure><img src="/files/O0ADYxLMddvDp4rudC9c" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/x88bFWvTAiXbDCSHByc2" alt="" width="563"><figcaption></figcaption></figure>

## Verificando por que pedidos não foram importados

Quando um pedido específico não aparece no painel de Rastreamento, também é possível verificar o motivo pelo qual ele não foi importado.

### Como verificar o erro de importação

Para identificar por que um pedido específico não foi importado, siga os passos abaixo:

#### 1. Identifique o número do pedido

Tenha em mãos o número do pedido que não foi importado para o painel de Rastreamento.

#### 2. Acesse as configurações

No painel de Rastreamento, acesse **Configurações** > **Configurações Gerais**.

#### 3. Importe o pedido específico

Clique em **Ações** > **Importar agora**, habilite o campo "Importar apenas um pedido" e informe o número do pedido que deseja verificar.

<figure><img src="/files/UaGaTZtRzhkUmS93a3i3" alt=""><figcaption></figcaption></figure>

#### 4. Verifique o motivo do erro

Após executar a importação, o erro aparecerá no campo "Última execução". Clique sobre ele para visualizar o motivo pelo qual o pedido não foi importado.

<figure><img src="/files/6vQgO2QABRyIC19I18tW" alt=""><figcaption></figcaption></figure>

### Motivos comuns para pedidos não serem importados

Nem todos os pedidos do e-commerce serão importados automaticamente para o painel de Rastreamento. Os principais motivos são:

* **Pedidos não pagos**: Somente pedidos com pagamento confirmado são importados.
* **Produtos virtuais ou retirada na loja**: Pedidos de produtos digitais ou configurados para retirada na loja física não são importados, pois não necessitam de rastreamento.
* **Pedidos sem frete**: Pedidos que não possuem informações de envio ou frete não são importados para o módulo de Rastreamento.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.troqueedevolva.com.br/rastreamento/configuracoes/ativando-a-importacao-de-pedidos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.