Como integrar os dados do Tiny no Visio OS

por Lorenzo Lopez Head of Content, Visio 19 de out. de 2026

Para integrar os dados do Tiny, a documentação pública dele mostra duas APIs e um arquivo: a API v3, REST com OAuth2, em que o próprio seller cria o aplicativo, com o plano Construa e a extensão Gestão de Aplicativos; a API v2, por token; e a exportação dos pedidos de venda e do caixa em .xls e .csv (páginas consultadas em 12/10/2026). Levado à camada de Dados do Visio OS, o Tiny entra por API e o dado fica por loja, ao lado do banco e da nota.

Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas.

Quem cria o aplicativo é o seller

Na API v3 do Tiny, a página consultada descreve o aplicativo como criado pelo próprio seller, dentro da conta dele. O acesso, portanto, parte da conta do grupo.

Isso muda o plano: o primeiro passo é de quem administra a conta do Tiny, que cria o aplicativo, confere o plano e guarda a autorização; o time técnico segue depois, dentro do que a conta permitir.

A gestão da rede, no entanto, pergunta por mais fontes do que o Tiny: extrato bancário, nota de compra, delivery, escala. A camada de Dados do Visio OS junta todas por loja, com o Tiny entre elas e cada número definido uma vez pela Visio.

O que o Tiny documenta

Em 12/10/2026, as páginas públicas do Tiny e da Olist trouxeram quatro fatos.

O primeiro é a API v3. A documentação (documentação da API do Tiny, consultada em 12/10/2026) a descreve como REST, com autenticação OAuth2, e diz que o aplicativo é criado pelo próprio seller, com o plano Construa e a extensão Gestão de Aplicativos.

O segundo é a API v2, que a mesma documentação registra com acesso por token. O que cada versão devolve está nas páginas de cada uma.

O terceiro é a exportação. A central de ajuda (ajuda.olist.com, consultada em 12/10/2026) indica que os pedidos de venda e o caixa exportam em .xls e .csv.

O quarto é uma falta: o Tiny não publica MCP próprio nas páginas consultadas.

Plano e extensão vêm antes do código

A condição mais concreta da página é de contratação: o plano Construa e a extensão Gestão de Aplicativos. Antes de escalar uma integração para as lojas, vale responder três perguntas simples sobre a conta que será usada.

Qual conta? Se o grupo tem mais de uma conta do Tiny, cada uma é um ponto de entrada separado.
Qual plano? A página associa o aplicativo da v3 ao plano Construa. Se outros planos servem, a página consultada não diz.
Quem administra? A extensão e o aplicativo são da conta, e alguém do grupo precisa ser o dono do vínculo.

A resposta sobre o plano está na página; as outras duas moram na conta do grupo.

Como avaliar o caminho do Tiny: 5 critérios

Qual versão. A v3 usa OAuth2 e aplicativo criado pelo seller; a v2 usa token. Decida qual a documentação de cada uma cobre para a sua pergunta.
O plano da conta. Plano Construa e extensão Gestão de Aplicativos, segundo a página, para o aplicativo da v3.
O que a pergunta usa. A exportação cita pedidos de venda e caixa. Veja se a pergunta cabe nesses dois recursos.
Por loja ou por conta. O dado é separado por loja ou por conta antes de entrar na análise do grupo.
Quem acompanha. Aplicativo, autorização e token têm um responsável do lado do grupo.

Principais caminhos para integrar os dados do Tiny

São quatro caminhos. Os três primeiros nascem no Tiny, e o quarto é o que a camada faz com qualquer um deles.

1. A API v3, com OAuth2 e aplicativo do seller

É o caminho de programa com OAuth2: o aplicativo nasce na conta do grupo e a autorização segue o padrão do OAuth2. Quem constrói lê a documentação, guarda a autorização, renova o acesso quando for preciso e trata o dado que chegar. A API traz o dado do Tiny; receita líquida, cruzamento com o banco e a nota e permissão por loja não vêm com ele.

2. A API v2, por token

É o caminho de programa por token, que a documentação registra ao lado da v3. Quem parte do zero lê as duas páginas, a da v3 e a da v2, e escolhe pelo que a pergunta exige.

3. A exportação de pedidos de venda e de caixa

É o caminho de arquivo. Quem opera a conta exporta pedidos de venda ou caixa em .xls ou .csv. Não exige desenvolvimento. O arquivo vale pela frequência de quem o exporta, e as colunas não aparecem na página.

4. O Tiny como fonte da camada de Dados do Visio OS

Pelo caminho que a conta permitir, o Tiny entra na camada como fonte, por API, com venda e caixa por loja, na mesma linha do tempo do extrato (Open Finance, com o consentimento do titular) e da nota (certificado digital de cada CNPJ).

A promessa de integração é a da Visio: integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. Se nenhum dos caminhos acima servir à conta do grupo, verifique com a Visio se já existe forma homologada ou parceiro integrador, porque a Visio não extrai dado contra os termos de uso de um sistema.

O que o Tiny passa a responder ao lado do resto

Os dois recursos que a exportação cita, pedidos de venda e caixa, são a matéria-prima de duas perguntas diferentes: o que foi vendido e o que entrou no caixa. Cada uma ganha outro peso quando o Tiny deixa de ser a única fonte.

Com o extrato bancário ao lado, o caixa do Tiny pode ser lido contra o que a conta da loja recebeu, e a conciliação deixa de ser tarefa de uma pessoa. Com a nota de compra, o pedido de venda passa a ter, do outro lado, o que a loja comprou para vender. E, para quem constrói ferramentas sobre o dado, a API da camada serve o aplicativo do builder com a mesma estrutura por loja e a mesma permissão do login, o que faz uma ferramenta nova custar a ferramenta, e não o pipeline.

Quem já usa o Power BI ou o Looker Studio continua usando: o painel passa a ler, pela API, um dado que já chegou pronto. A sua IA lê a métrica calculada com o seu login, e só o que o login pode ver.

Há ainda o dado que nasce dentro do Visio OS: cada Tool que o time usa escreve de volta o que produz, como a meta batida, a tarefa feita e a contagem logada. Esse dado se soma ao que o Tiny registra, e a pergunta sobre a venda passa a poder olhar também para o que a loja fez.

Comparativo dos caminhos para integrar o Tiny

A tabela compara os caminhos que as páginas do Tiny descrevem. Onde elas não dizem, a célula diz que não foi possível confirmar.

Critério	API v3 (OAuth2)	API v2 (token)	Exportação .xls e .csv	Camada de Dados do Visio OS
O que expõe	A API REST da documentação; o conteúdo, não foi possível confirmar	A API v2 da documentação; o conteúdo, não foi possível confirmar	Pedidos de venda e caixa	O que o caminho escolhido entrega, estruturado por loja
Quem libera	O seller, que cria o aplicativo, com o plano Construa e a extensão Gestão de Aplicativos	Token; quem o emite, não foi possível confirmar	Quem opera a conta	A Visio, a partir do mapeamento
Formato	REST com OAuth2; o formato de resposta, não foi possível confirmar	Não foi possível confirmar	.xls e .csv; as colunas, não foi possível confirmar	Pelo caminho que existe, na mesma linha do tempo
Por loja	Se o time construir	Se o time construir	Manual	Sim, com a mesma definição da rede
Quem mantém	O time do grupo, com o aplicativo e a autorização	O time do grupo, com o token	A pessoa que exporta	A Visio: nada para hospedar nem manter

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a pesquisa por «como integrar os dados do Tiny» se divide entre duas versões de API e um arquivo, e que o ponto de partida mais útil não é qual versão escolher, e sim de quem é o aplicativo. Para ele, o fato de o seller criar o próprio aplicativo coloca a decisão na mão de quem administra a conta, e o guia deve dizer isso antes de falar de código.

A posição dele é a de que o leitor ganha ao registrar quem é o dono do vínculo e qual plano a conta tem antes de abrir a documentação. Ele vê a camada de Dados do Visio OS como o lugar onde o que o Tiny entregar passa a valer por loja, ao lado do banco e da nota.

Perguntas frequentes

O Tiny tem API para integrar os dados?

Sim. A documentação do Tiny, consultada em 12/10/2026, descreve a API v3, REST com OAuth2, e a API v2, por token.

Qual a diferença entre a API v2 e a API v3 do Tiny?

Na autenticação e na forma de acesso, segundo a documentação consultada em 12/10/2026: a v3 é REST com OAuth2 e exige um aplicativo criado pelo seller, e a v2 usa token. O que cada versão devolve está na página de cada uma, e a escolha depende do que a pergunta precisa.

Preciso de um plano específico para usar a API do Tiny?

Para o aplicativo da v3, a documentação consultada em 12/10/2026 cita o plano Construa e a extensão Gestão de Aplicativos. A página não diz se outros planos servem, então confirme na conta.

Dá para exportar os dados do Tiny sem usar a API?

Sim. A central de ajuda da Olist, consultada em 12/10/2026, indica que os pedidos de venda e o caixa exportam em .xls e .csv. A página não lista as colunas de cada relatório.

O Tiny tem MCP oficial?

Nas páginas consultadas em 12/10/2026, o Tiny não publica MCP próprio. O Tiny chega à sua IA pela camada: o dado entra estruturado, e o MCP da Visio o entrega com o seu login.

E se o caminho do Tiny na minha operação não estiver claro?

Verifique com a Visio se já existe forma homologada ou parceiro integrador antes de construir. A Visio integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. O primeiro passo é o mapeamento de quais fontes a operação já tem e de como cada uma conecta.

Próximos passos

O próximo passo é o mapeamento de quais fontes a sua operação já tem e de como cada uma conecta, o Tiny entre elas.

A camada completa está descrita na página da camada de Dados.

Ver também

Conclusão

Integrar os dados do Tiny é decidir entre a API v3, a v2 e o arquivo a partir de quem administra a conta, de qual plano ela tem e do que a pergunta usa. O que o Tiny entregar por qualquer um deles entra numa camada que o estrutura por loja, com a mesma definição, ao lado do banco e da nota, e fica disponível para a sua IA e para o seu aplicativo.

Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.