Skip to main content
O Tiny é um ERP focado em pequenos e-commerces. A integração usa API Key (token) fixa por empresa — sem OAuth.

​
Conectando

​
1. Obter API Key

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

​
2. Conectar no BulkRoute

  1. Acesse Integrações > Tiny > Conectar
  2. Informe a API Key no formulário
  3. Clique em Conectar
O BulkRoute armazena a chave na integração. Para desconectar, use Desconectar — a chave é removida.

​
3. Mapear carriers

O Tiny identifica transportadoras por transportadora.id. Mapeie cada uma em Integrações > Tiny > Mapeamentos: Se não houver mapeamento, o BulkRoute faz fallback por nome: se o nome da transportadora contiver “CORREIOS”, “JADLOG” ou “BRASPRESS”, usa o carrier correspondente; caso contrário, usa TINY.

​
4. Disparar sincronização

A sincronização é manual — não há cron automático. Para importar pedidos:
  1. Em Integrações > Tiny, clique em Sincronizar Agora
  2. Escolha o tipo de sync:
    • orders — importa pedidos do Tiny
    • tracking — envia tracking codes de volta ao Tiny
    • full — executa ambos
  3. O job entra na fila BullMQ e processa em background (concurrency 2)
  4. Acompanhe o progresso em Sync History
A importação de pedidos usa dataInicio (formato YYYYMMDD) baseado na data do último sync, para não reimportar pedidos antigos.

​
O que é importado

Metadados adicionais: tinyOrderId, tinyCarrierName, tinyCarrierId. Status inicial: PENDING.

​
Sincronização de tracking

O BulkRoute envia o tracking code de volta ao Tiny via POST /pedido.rastreamento.php com os parâmetros na query string:
O sync tracking busca shipments com tracking_code e metadata.tinyOrderId (limite 200 por execução).

​
Endpoints da API BulkRoute

​
Rate limit e retry

  • A API do Tiny tem rate limit. Em 429, o BulkRoute respeita Retry-After (default 2s) e tenta novamente (até 3 vezes)
  • Fila BullMQ: 3 tentativas, backoff exponencial de 10s
  • Concorrência do worker: 2

​
Troubleshooting