> ## 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.

# Conectando o Tiny (ERP)

> Importe pedidos do Tiny automaticamente e sincronize o tracking de volta.

O [Tiny](https://www.tiny.com.br) é um ERP focado em pequenos e-commerces. A integração usa API Key fixa por empresa.

## Conectando

### 1. Obter API Key

1. Faça login no Tiny
2. Vá em **Configurações** > **API**
3. Gere uma nova API Key
4. Copie o valor

### 2. Configurar no BulkRoute

1. Acesse **Integrações** > **Tiny**
2. Cole a **API Key**
3. Clique em **Testar Conexão**
4. Salve

### 3. Mapear carriers

Mesmo processo do [Bling](/integracoes/bling#mapear-carriers) — mapeie cada carrier do Tiny para o carrier correspondente no BulkRoute.

### 4. Ativar sincronização

Ative a sincronização automática (padrão: 30 minutos).

## O que é importado

| Campo do Tiny          | Campo no BulkRoute  |
| :--------------------- | :------------------ |
| `numero`               | `external_order_id` |
| `contato.nome`         | `recipient.name`    |
| `contato.fone`         | `recipient.phone`   |
| `transporte.cep`       | `destination_zip`   |
| `itens[].produto.peso` | `items[].weight`    |
| `itens[].valor`        | `items[].value`     |

## Sincronização de tracking

O worker `tiny-sync` envia o tracking code de volta ao Tiny via `POST /rastreio`.

## Troubleshooting

| Problema             | Causa                       | Solução                      |
| :------------------- | :-------------------------- | :--------------------------- |
| API Key inválida     | Key expirou ou foi revogada | Gerar nova no Tiny           |
| Pedidos não importam | Sincronização desativada    | Ativar em Integrações > Tiny |
| CEP inválido         | Pedido sem CEP no Tiny      | Preencher CEP no Tiny        |