API do Tiny ERP: o que dá para fazer e como usar com agentes de IA
A API do Tiny, ERP hoje parte da Olist, permite consultar e incluir pedidos, produtos, estoque, notas fiscais e contas a pagar e receber. É usada por lojas virtuais e distribuidores que vendem em vários canais. O acesso é por token da conta, e há versões diferentes da API em uso.
Os grandes recursos da API, em português claro.
Inclusão, consulta e alteração de situação de pedidos de venda.
Cadastro de produtos, variações e preços.
Consulta e atualização de saldos.
Emissão e consulta de notas vinculadas aos pedidos.
Lançamentos financeiros.
Clientes e fornecedores.
Como se acessa a API do Tiny ERP.
- Com credencial da sua empresaUsa token de API gerado nas configurações da conta Tiny; versões mais recentes da API adotam OAuth 2.0 com aplicativo cadastrado.
- Há limites de requisições por minuto que variam conforme o plano.
- Emissão de nota fiscal tem efeito fiscal: mantenha aprovação.
- Dados de clientes estão sujeitos à LGPD.
- api tiny erp
- api tiny
- tiny erp api documentação
- olist tiny api
- integração api tiny
- tiny api pedidos
- tiny api token
O que um agente do iTeam faz com a API do Tiny ERP.
O agente encontra pedidos parados em separação ou sem nota e avisa a expedição e o cliente.
O agente cruza vendas e estoque e envia ao comprador a lista de produtos para repor.
O cliente pede a nota no WhatsApp e o agente localiza e envia o arquivo do pedido.
Produtos sem NCM, peso ou imagem são listados antes de irem para os marketplaces.
Da credencial ao agente trabalhando, com aprovação.
Gere a credencial no Tiny
Nas configurações da conta, gere o token de API ou cadastre o aplicativo, conforme a versão usada.
Cadastre no cofre do iTeam
A credencial fica no cofre; consultas são livres e emissão de nota ou mudança de situação exigem aprovação no início.
Valide com pedidos reais em leitura
Comece lendo pedidos e estoque e só depois libere escrita aos poucos.
Dúvidas sobre a API do Tiny ERP.
A API do Tiny ERP é gratuita?
De forma geral, o acesso à API depende do plano do Tiny, e alguns planos têm limites de uso. Confira as condições do seu plano.
Preciso programar para usar a API do Tiny ERP com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam aprende os endpoints pela documentação e o time de implantação configura as rotinas.
Qual versão da API é usada?
Depende da sua conta; isso é verificado no diagnóstico para usar a versão suportada pelo Tiny.
Qual a diferença entre a API v2 e a v3 do Tiny ERP, hoje Olist ERP?
A v2 usa token de API da conta, enquanto a v3 adota OAuth 2.0 com aplicativo cadastrado; a documentação está em dev.olist.com. Integrações novas tendem a partir da v3. Confira no portal qual versão sua conta aceita e se a v2 ainda tem prazo de descontinuação.
Como o agente de IA se autentica na API do Tiny?
Na versão com token, usa o gerado nas configurações da conta; na mais nova, usa OAuth 2.0 com um aplicativo cadastrado que o usuário autoriza. O sistema então renova os tokens. Erros de URL de redirecionamento são comuns na primeira configuração. Guarde credenciais e tokens no cofre.
O agente consegue incluir pedidos e atualizar estoque no Tiny?
Consegue consultar e incluir pedidos, produtos e estoque, conforme os recursos da API. Alterar estoque se espalha por todos os canais de venda, então use aprovação e limites. Um uso seguro é o agente apontar produtos com estoque baixo e sugerir reposição, enquanto a alteração fica com o responsável.
O agente pode emitir nota fiscal pelo Tiny?
A API oferece recursos de notas fiscais, mas emitir tem efeito fiscal e não se desfaz sem cancelamento. Mantenha aprovação humana e conferência de dados do pedido antes da emissão. O agente pode preparar o pedido, validar campos que costumam causar rejeição e avisar o responsável de uma nota rejeitada.
Existe sandbox do Tiny ERP para testar integrações?
Não localizei um sandbox oficial. Confira em dev.olist.com. Uma alternativa é uma conta de teste do Tiny, com produtos e contatos fictícios, onde o agente cria pedidos marcados. Teste leitura de produtos e estoque primeiro, depois pedidos, e só ao final qualquer emissão de nota, sempre com acompanhamento.
Quais limites de requisição o Tiny impõe ao agente?
O Tiny limita as requisições por minuto, e o valor varia conforme o plano, segundo a documentação. Confira o número da sua conta no portal. O agente deve consultar em lotes, guardar resultados, evitar varrer todo o catálogo e preferir ler só o que mudou. Se a API recusar, ele espera e retoma.
O Tiny ERP serve para um agente de IA em loja virtual de pequeno porte?
Serve: lojas virtuais e distribuidores que vendem em vários canais costumam usar o Tiny, e o agente ajuda com pedidos atrasados, estoque baixo e contas a receber. Se a loja tem poucos pedidos por dia e uma pessoa cuida de tudo, o ganho é menor. O valor cresce com volume e canais.
Contas a pagar e a receber do Tiny podem ser conciliadas por um agente?
Podem ser lidas pela API e cruzadas com o extrato bancário, e o agente lista o que não bateu: valores diferentes, lançamento duplicado, pagamento não registrado. Ele não baixa títulos sozinho; propõe e uma pessoa confirma. Os dados de clientes seguem a LGPD. No iTeam, cada conferência fica na trilha de auditoria.
