> ## 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 a Omie (ERP)

> Importe pedidos da Omie automaticamente e sincronize o tracking de volta.

A [Omie](https://www.omie.com.br) é um ERP completo para PMEs. A integração usa autenticação por App Key + App Secret.

## Conectando

### 1. Obter credenciais

1. Faça login na Omie
2. Vá em **Configurações** > **API**
3. Gere um par **App Key** + **App Secret**
4. Copie ambos

### 2. Configurar no BulkRoute

1. Acesse **Integrações** > **Omie**
2. Preencha **App Key** e **App Secret**
3. Clique em **Testar Conexão**
4. Salve

### 3. Mapear carriers e ativar sync

Mesmo processo das outras integrações — veja [Bling](/integracoes/bling#mapear-carriers).

## O que é importado

A Omie usa o endpoint `pedido_venda_produto_list`:

| Campo da Omie          | Campo no BulkRoute  |
| :--------------------- | :------------------ |
| `codigo`               | `external_order_id` |
| `cliente.nome`         | `recipient.name`    |
| `cliente.fone`         | `recipient.phone`   |
| `transporte.cep`       | `destination_zip`   |
| `itens[].produto.peso` | `items[].weight`    |
| `itens[].valor`        | `items[].value`     |

## Sincronização de tracking

O worker `omie-sync` envia o tracking code de volta à Omie.

## Troubleshooting

| Problema                 | Causa                            | Solução                    |
| :----------------------- | :------------------------------- | :------------------------- |
| App Key/Secret inválidos | Credenciais erradas ou revogadas | Gerar novo par na Omie     |
| Rate limit               | Muitas requisições               | Aumentar intervalo de sync |
| Pedido sem CEP           | Cliente sem endereço completo    | Preencher CEP na Omie      |