Conectando o Tiny (ERP) - BulkRoute Central de Ajuda

O Tiny é um ERP focado em pequenos e-commerces. A integração usa API Key fixa por empresa.

Conectando

1. Obter API Key

Faça login no Tiny
Vá em Configurações > API
Gere uma nova API Key
Copie o valor

2. Configurar no BulkRoute

Acesse Integrações > Tiny
Cole a API Key
Clique em Testar Conexão
Salve

3. Mapear carriers

Mesmo processo do Bling — 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