> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bulkroute.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Logística Reversa & Devoluções

> Gerencie devoluções de ponta a ponta — desde a solicitação até a inspeção e reposição em estoque.

O módulo de Logística Reversa do BulkRoute permite criar e acompanhar devoluções de forma estruturada, com workflow de status, etiqueta de retorno, inspeção e reposição em estoque.

<Note>
  Acesso: **Pedidos** > **Logística Reversa** (`/admin/reverse-logistics`). Requer perfil Manager.
</Note>

## Workflow de devolução

```mermaid theme={null}
graph LR
    A[requested] --> B[picked_up]
    B --> C[in_transit]
    C --> D[received]
    D --> E[inspected]
    E --> F[restocked]
    A --> G[cancelled]
    E --> H[rejected]
```

| Status          | Descrição                                     |
| :-------------- | :-------------------------------------------- |
| **requested**   | Devolução solicitada                          |
| **picked\_up**  | Carga coletada no cliente                     |
| **in\_transit** | Em trânsito de volta ao CD                    |
| **received**    | Recebida no CD                                |
| **inspected**   | Inspecionada (aprovada, rejeitada ou parcial) |
| **restocked**   | Reposta no estoque                            |
| **cancelled**   | Devolução cancelada                           |

## KPIs no topo

| KPI             | Descrição                              |
| :-------------- | :------------------------------------- |
| **Solicitadas** | Total de devoluções no período         |
| **Em Trânsito** | Devoluções entre picked\_up e received |
| **Recebidas**   | Devoluções que chegaram no CD          |
| **Restocadas**  | Devoluções inspecionadas e repostas    |

## Criando uma devolução

1. Vá em **Pedidos** > **Logística Reversa**
2. Clique em **Nova Devolução**
3. Busque e selecione o envio original (forward) digitando código, destinatário, CEP ou pedido
4. Selecione o motivo:

| Motivo            | Descrição             |
| :---------------- | :-------------------- |
| `customer_return` | Cliente devolveu      |
| `exchange`        | Troca                 |
| `damage`          | Mercadoria danificada |
| `wrong_item`      | Item errado           |
| `other`           | Outro                 |

5. (Opcional) Escolha uma transportadora — se não escolher, usa a mesma do envio original
6. Adicione observações
7. Clique em **Criar Devolução**

## Detalhe da devolução

Acesse o detalhe de uma devolução para ver 3 sub-abas:

### Resumo

Dados completos da devolução: envio original, carrier, tracking code, motivo, observações e etiqueta.

### Timeline

Linha do tempo visual do workflow, mostrando cada mudança de status com data/hora.

### Inspeção

Registre o resultado da inspeção física da mercadoria devolvida:

| Resultado    | Descrição                                   |
| :----------- | :------------------------------------------ |
| **approved** | Mercadoria em condições, pode ser repostada |
| **rejected** | Mercadoria danificada/irreutilizável        |
| **partial**  | Parte aproveitada                           |

Após a inspeção, você pode:

* **Repor em estoque** (quando `inspected` e `approved`)
* **Cancelar devolução** (a qualquer momento)

## Etiqueta de retorno

No detalhe da devolução:

1. Clique em **Gerar Etiqueta** — cria o PDF da etiqueta de coleta
2. Clique em **Baixar Etiqueta** — baixa o PDF gerado

A etiqueta pode ser regenerada se necessário.

## Confirmação de recebimento

Quando a devolução chega no CD (status `in_transit`):

1. Abra o detalhe da devolução
2. Clique em **Confirmar Recebimento**
3. O status muda para `received`
4. Prossiga para a inspeção

## Endpoint público

O cliente final pode acompanhar a devolução por um link público:

```
https://app.bulkroute.com.br/returns/public/{token}
```

O token é gerado automaticamente na criação da devolução.