Voltar para o blog Automação e integração

Integração do Tiny (Olist ERP) e do Omie com n8n: API, limites e armadilhas

O Tiny (Olist ERP) usa OAuth 2.0 na API v3; o Omie, app key e app secret no corpo. Como ligar os dois ao n8n, os limites de cada API e os fluxos que se pagam.

Dá para integrar os dois com n8n, e nenhum dos dois tem nó oficial: a integração é feita pelo nó HTTP Request. O Tiny (hoje Olist ERP) usa, na API v3, OAuth 2.0 com token que vale 4 horas e refresh que vale 1 dia. O Omie não usa OAuth: cada chamada leva a app key e o app secret no corpo da requisição, sempre por POST. O que mais muda de um para o outro não é a autenticação, é o limite de requisições e o comportamento dos webhooks.

Documentação conferida em novembro de 2026, nas páginas oficiais da Olist e do Omie. Onde a documentação não diz, este texto avisa.

Quando vale integrar (e quando não)

O motivo é o mesmo de qualquer ERP: alguém redigita pedido, copia estoque ou avisa o financeiro por mensagem. É o trabalho que descrevemos em por que o dado não chega.

Antes de montar qualquer coisa: já existe conector pronto? Se a sua loja ou o seu marketplace já conversa com o ERP por um conector mantido por alguém, use o conector. O n8n entra no que sobra: portal B2B, e-commerce feito sob medida, formulário do representante, planilha da produção, aviso no WhatsApp.

Tiny (Olist ERP): como a API funciona

A Olist mantém duas APIs documentadas no mesmo portal.

  • API v3 (a atual). REST com JSON em https://api.tiny.com.br/public-api/v3/. Autenticação OAuth 2.0, fluxo Authorization Code, com escopo openid. O access_token vale 4 horas; o refresh_token, 1 dia. O token vai no cabeçalho Authorization: Bearer.
  • API v2 (a antiga, por token). Um token fixo, gerado na extensão “Token API”, que vai como parâmetro token (com formato=json) em chamadas a https://api.tiny.com.br/api2/<serviço>.php. Continua documentada; não encontramos data de desligamento.

Para integração nova, use a v3. Os pontos que importam para o desenho:

  • Aplicativo cadastrado na conta. Em Configurações, Geral, Aplicativos: URL de redirecionamento e permissões por módulo. Segundo a Central de Ajuda, a v3 está disponível a partir do plano Construa, e cada conta aceita até 5 aplicativos.
  • Limite por conta, separado em leitura e escrita. Vai de 30 leituras e 30 escritas por minuto nos planos de entrada até 140 leituras e 100 escritas nos maiores. Os cabeçalhos X-RateLimit-Remaining e X-RateLimit-Reset dizem quanto sobrou no minuto.
  • Paginação por limit e offset, com 100 registros por padrão.
  • Webhooks pelo aplicativo “Webhooks”, disponível só em alguns planos. Os avisos documentados são: pedido de venda criado ou alterado, pedido enviado, estoque atualizado e nota fiscal autorizada. Sem resposta HTTP 200, a Olist reenvia até 10 vezes, com intervalo que cresce 5 minutos a cada tentativa.

Na v2, o limite vai de zero (plano Começar) a 120 por minuto, com até 100 registros por consulta e resposta 429 quando estoura.

No n8n

Crie uma credencial OAuth2 genérica com grant type Authorization Code:

Authorization URL:  https://accounts.tiny.com.br/realms/tiny/protocol/openid-connect/auth
Access Token URL:   https://accounts.tiny.com.br/realms/tiny/protocol/openid-connect/token
Scope:              openid
Client ID / Secret: os do aplicativo criado no Olist ERP

Cole no aplicativo da Olist a URL de redirecionamento que o n8n mostra na credencial, conecte e autorize. Teste com uma leitura simples, como GET /pedidos, antes de qualquer escrita.

Omie: como a API funciona

O Omie segue outro modelo, mais antigo no desenho:

  • Sem OAuth. Cada aplicativo tem uma app key e um app secret, que só usuário administrador consegue ver (no resumo do aplicativo ou na área Developer). Se alguém resetar a chave, todas as integrações que usam a antiga param na hora.
  • Tudo por POST, com JSON. A URL indica o módulo (por exemplo, https://app.omie.com.br/api/v1/produtos/pedido/) e o corpo diz o método, como no exemplo abaixo. O próprio Omie diz que a API não é RESTful e que chamadas GET dão erro.
  • Paginação por pagina e registros_por_pagina, com limite de 100 registros por página.
  • Limites por IP e por método. 960 requisições por minuto por IP; 240 por minuto e 4 simultâneas por combinação de IP, app key e método. Alguns métodos aceitam só uma chamada por vez.
  • Webhooks configurados na área Developer, por aplicativo, com eventos nomeados por tópico (o exemplo da ajuda é produto.alterado). A lista completa de tópicos fica no painel do aplicativo; não a encontramos publicada na Central de Ajuda.

Uma chamada típica, listando pedidos de venda:

{
  "call": "ListarPedidos",
  "app_key": "SUA_APP_KEY",
  "app_secret": "SEU_APP_SECRET",
  "param": [{ "pagina": 1, "registros_por_pagina": 100 }]
}

No n8n

Como a chave vai no corpo, a credencial mais limpa é a Custom Auth do HTTP Request, que injeta campos no body:

{ "body": { "app_key": "SUA_APP_KEY", "app_secret": "SEU_APP_SECRET" } }

No nó, deixe só call e param no corpo. Assim a chave não aparece no workflow, nem em quem exportar o JSON dele.

Bling, Tiny e Omie lado a lado

Os dados do Bling vêm do nosso texto sobre integração do Bling com n8n.

BlingTiny (Olist ERP), API v3Omie
AutenticaçãoOAuth 2.0OAuth 2.0 (v2: token fixo)App key + app secret no corpo
Validade do acessoToken de 6 h; refresh de 30 diasToken de 4 h; refresh de 1 diaChave fixa, até alguém resetar
FormatoREST, JSONREST, JSONJSON sempre por POST, método no corpo
Limite3 por segundo e 120 mil por dia, por conta30 a 140 leituras e 30 a 100 escritas por minuto, por conta240 por minuto por IP + app + método; 960 por minuto por IP
Paginaçãopagina e limite, 100 por padrãolimit e offset, 100 por padrãopagina e registros_por_pagina, máximo 100
WebhooksPedido, produto, estoque, nota e outrosPedido, pedido enviado, estoque, nota autorizadaPor tópico, escolhidos no Developer
Se o seu endpoint falhaTenta por até 3 dias, depois desativaAté 10 reenvios, intervalo crescente3 tentativas rápidas, depois fila por até 5 dias
Nó oficial no n8nNãoNãoNão

Há nós da comunidade para os dois no npm, mantidos por terceiros; os não verificados só rodam no n8n auto-hospedado. Para fluxo que mexe em pedido e nota, o HTTP Request dá menos surpresa.

O limite na prática: carga de 3.000 pedidos

Imagine importar 3.000 pedidos de um portal antigo, uma chamada por pedido:

  • Tiny, plano com 30 escritas por minuto: 3.000 ÷ 30 = 100 minutos, sem sobrar nada para as outras integrações da conta nesse tempo.
  • Omie, 240 por minuto no método de incluir pedido: 3.000 ÷ 240 = 12,5 minutos.
  • Bling, 3 por segundo (180 por minuto): 3.000 ÷ 180 ≈ 17 minutos.

No Tiny, a carga roda de madrugada, em lotes, lendo X-RateLimit-Remaining. No Omie, o cuidado é não passar de 4 chamadas simultâneas no mesmo método.

Três fluxos que se pagam primeiro

  1. Pedido de fora para dentro. O pedido do portal B2B, do e-commerce próprio ou do formulário do representante vira pedido de venda no ERP. Antes de gravar, o fluxo confere se o cliente e os produtos existem (na v3 do Tiny, cada item do pedido leva o id do produto) e cadastra o cliente novo quando faltar.
  2. Estoque do ERP para a loja. O webhook de estoque atualiza a loja, o portal ou o alerta de estoque mínimo do comprador. Onde o webhook não cobre, uma rotina a cada poucos minutos lê só o que mudou, com filtro de data de atualização.
  3. Nota emitida, cliente e financeiro avisados. No Tiny, o webhook de nota autorizada dispara o e-mail ou a mensagem para o cliente com o link da nota, e avisa o financeiro e a expedição. No Omie, use o tópico de nota se ele aparecer no painel do seu aplicativo; se não, uma rotina que lista as notas emitidas desde a última leitura.

Comece pelo fluxo em que hoje uma pessoa copia dado do ERP para outro lugar mais de uma vez por dia. A calculadora de custo do n8n mostra quanto esse volume custa para rodar em cada opção.

As armadilhas de cada um

Tiny: o refresh token dura um dia

No Bling o refresh vale 30 dias; aqui, 1 dia. Integração que passa um fim de semana sem rodar perde a autorização, e alguém precisa reconectar. Agende no n8n uma leitura leve a cada poucas horas, só para manter o token vivo, e um alerta se a renovação falhar.

Tiny: o limite é da conta inteira

O marketplace, o hub de frete e a sua integração dividem o mesmo minuto. Mudar as permissões do aplicativo obriga a autorizar de novo. E o webhook não se restringe a um aplicativo: quem configura recebe os eventos da conta.

Omie: consulta repetida volta vazia

Consultar o mesmo ID duas vezes em 60 segundos traz o dado só na primeira; a segunda volta com aviso de requisição já feita. Webhook que chega duplicado e dispara duas consultas ao mesmo pedido cai exatamente nisso. Guarde o resultado da primeira consulta e trate duplicidade antes de consultar.

Omie: dez erros e o método fica bloqueado

Na décima requisição com erro no mesmo IP, app key e método, o Omie bloqueia por 30 minutos, com HTTP 425. Fluxo em loop com parâmetro errado se bloqueia sozinho e leva junto o que usa a mesma chave e o mesmo método. Repetição, só com intervalo e limite de tentativas.

Omie: um evento travado segura a fila

Os webhooks do Omie saem em ordem, por aplicativo e endpoint. Enquanto um evento falha e é reenviado, os seguintes esperam: um pedido com erro atrasa todos os que vêm depois. O Omie espera até 7 segundos, tenta 3 vezes e depois passa o evento para uma fila de espera, com uma tentativa a cada 10 minutos por até 5 dias. Responda 2xx na hora, guarde o evento e processe depois.

Nos dois: webhook sem assinatura documentada

O Bling assina cada evento com HMAC. Na documentação do Tiny e do Omie, não encontramos assinatura. Use uma URL difícil de adivinhar e, antes de agir, consulte o registro na API para confirmar que ele está como o evento diz.

Nos dois: falha em silêncio

Vale o mesmo do Bling: um workflow de erro no n8n que avise alguém, com o pedido ou o evento que falhou, para reprocessar.

O que não conseguimos confirmar

  • O valor máximo de limit nas listagens da v3 do Tiny.
  • O formato do corpo dos webhooks do Tiny v3 e do Omie, e se algum deles assina o evento.
  • A lista completa de tópicos de webhook do Omie (a ajuda cita só produto.alterado).
  • Se a API v2 do Tiny tem data para ser desligada.
  • O código HTTP que a v3 do Tiny devolve ao estourar o limite (a v2 devolve 429).

Antes de pôr em produção, confira esses pontos na conta real, com um aplicativo de teste.

Cloud ou servidor próprio

As três integrações funcionam no n8n Cloud, porque usam só HTTP Request e Webhook. O servidor próprio faz sentido para nó da comunidade não verificado, volume alto ou dado que precisa ficar em casa. A conta está em n8n: cloud ou self-hosted, e a escolha da ferramenta em n8n vs Make vs Zapier.

Perguntas frequentes

O n8n tem nó nativo do Tiny ou do Omie?

Não. Nenhum dos dois tem nó oficial no n8n. A integração é feita pelo nó HTTP Request, com credencial OAuth2 no Tiny e Custom Auth no Omie. Há nós da comunidade no npm, mantidos por terceiros.

Como autenticar na API do Omie?

Com a app key e o app secret do aplicativo, enviados no corpo JSON de cada requisição, junto com o nome do método em call e os parâmetros em param. Toda chamada é POST. Só administradores enxergam a chave.

Qual é o limite de requisições da API do Omie?

240 requisições por minuto e 4 simultâneas por IP, app key e método, e 960 por minuto por IP. A décima requisição com erro no mesmo método bloqueia por 30 minutos.

Qual é o limite da API do Tiny (Olist ERP)?

Na v3, depende do plano: de 30 a 140 leituras e de 30 a 100 escritas por minuto, por conta, somando todos os aplicativos. Na v2, de 30 a 120 por minuto, e zero no plano Começar.

Quanto tempo dura o token da API v3 do Tiny?

O access_token vale 4 horas e o refresh_token, 1 dia. Se a integração passar mais de um dia sem renovar, é preciso autorizar o aplicativo de novo.

Tiny ou Omie: qual é mais fácil de integrar?

As duas APIs atendem os fluxos comuns. O Tiny tem API mais moderna e limite mais apertado; o Omie, limite folgado e regras de bloqueio mais duras. A escolha do ERP não deveria vir daí.


Quer tirar a redigitação entre o ERP e o resto da operação? Agende um diagnóstico ou veja a frente de automação e integração.

tinyolist erpomien8nintegraçãoerpapi

Pronto para destravar a sua operação?

Agende um diagnóstico: a gente mapeia os gargalos e mostra por onde começar.

Agende um diagnóstico