Este guia mostra, passo a passo, como conectar sua conta da Tiny (by olist) à Martz via integração por API e, em seguida, como trazer seus dados históricos (produtos, clientes e pedidos) da Tiny para a Martz.
O processo é dividido em duas partes independentes e complementares:
Integração via API — conecta as duas plataformas para sincronização contínua dos dados a partir do momento da conexão.
Migração de dados históricos — traz para a Martz os registros que já existiam na Tiny antes da integração.
Atenção antes de começar: se você já possui um e-commerce conectado diretamente à Martz (por exemplo, a Bagy ou a Shopify), preste muita atenção às configurações de exclusão de canal de venda destacadas neste artigo. Elas existem para evitar duplicidade de pedidos na sua base.
Parte 1 — Integração da Tiny com a Martz (via API)
A integração é feita com o Token API da sua conta Tiny. Ele é o identificador único que autoriza a Martz a acessar os dados da sua conta.
Passo 1 — Gerar o Token API na Tiny
Na Tiny, acesse o menu Configurações.
Localize a opção Token API (dentro das configurações de API).
Na tela Token API, clique em gerar token API.
O código gerado aparecerá no campo Token. Copie esse valor — ele será usado na Martz.
O Token é o identificador único da sua conta no ERP e permite operações na conta por meio da API. Trate-o como uma informação sensível: ao compartilhá-lo, o serviço de destino passa a ter acesso aos dados da sua conta.
Passo 2 — Iniciar a integração na Martz
Na Martz, acesse a tela de integrações e localize a seção ERPs.
No card da Tiny (by olist), clique em Integrar.
Na tela de conexão da Tiny, cole o código copiado no campo Token da aplicação.
Clique em Iniciar integração.
Se o token estiver correto, a integração avança para as etapas de Verificação das permissões e Configurações adicionais.
Passo 3 — Excluir o canal do e-commerce já integrado (etapa essencial)
Esta etapa só é necessária se você já possui um e-commerce conectado diretamente à Martz.
Depois de inserir o token com sucesso, avance até o passo de Configurações adicionais e configure a Martz para desconsiderar, vindo da Tiny, as vendas originadas no seu e-commerce.
Exemplo prático: se o seu e-commerce é a Bagy e você já conectou sua conta Bagy diretamente na Martz, neste passo da integração com a Tiny você deve excluir a "Bagy" como canal de venda vindo da Tiny (escrevendo "Bagy" no campo). Se seu e-commerce é a Shopify, escreva "Shopify" nesse campo.
Por que isso é importante? Sem essa exclusão, o mesmo pedido chegaria à Martz por dois caminhos diferentes — uma vez pela integração direta com a Bagy e outra vez pela Tiny (que também recebe esses pedidos). O resultado seria pedidos duplicados na sua base.
Após configurar a exclusão do canal, conclua a integração.
Parte 2 — Exportar dados históricos na Tiny e importar na Martz
A integração por API passa a sincronizar os dados a partir do momento da conexão. Para trazer o que já existia antes, é preciso exportar as planilhas na Tiny e importá-las na Martz.
São três conjuntos de dados a exportar: produtos, clientes e fornecedores e pedidos de venda.
2.1 — Exportar Produtos
Na Tiny, acesse Cadastros → Produtos.
Clique em mais ações (canto superior direito) e escolha exportar produtos para planilha.
Na tela Exportação de produtos, selecione o formato Excel (.xlsx).
Defina o Depósito para o Saldo em Estoque (a opção Todos considera todos os depósitos) e, se desejar, o intervalo de produtos (Produto inicial / Produto final).
Clique em Download para baixar o arquivo.
2.2 — Exportar Clientes e Fornecedores
Na Tiny, acesse Cadastros → Clientes e Fornecedores.
Clique em mais ações e escolha exportar clientes e fornecedores para planilha.
Selecione o formato (precisa ser Excel .xlsx) e conclua o download.
2.3 — Exportar Pedidos de Venda (atenção ao filtro)
Na Tiny, acesse Vendas → Pedidos de Venda.
Clique em mais ações e escolha exportar pedidos para planilha.
Antes de concluir a exportação dos pedidos, dois cuidados são indispensáveis:
a) Filtre o período desejado. Use os filtros da Tiny para selecionar o intervalo de datas que você quer trazer para a Martz.
b) Exclua, no filtro, as vendas provenientes do e-commerce já integrado com a Martz (se houver).
Por que excluir essas vendas? Se o seu e-commerce (por exemplo, a Bagy) já está sincronizando diretamente com a Martz, esses mesmos pedidos também estão na Tiny. Ao importar a planilha de pedidos da Tiny — que incluiria as vendas desse e-commerce — para a Martz, o histórico de pedidos do e-commerce iria duplicar, pois a Martz já recebe esses pedidos pelo canal direto.
A regra é simples: a planilha de pedidos exportada da Tiny deve conter apenas as vendas que a Martz ainda não conhece — ou seja, tudo, exceto o que já vem pelo canal de e-commerce integrado.
Depois de aplicar o período e excluir o canal de e-commerce no filtro, conclua a exportação e baixe o arquivo.
2.4 — Importar os dados na Martz
Com os três arquivos exportados, é hora de importá-los na Martz.
Na Martz, abra a tela "Importe as planilhas da Tiny para a sua base de dados Martz!".
Envie um arquivo ZIP em cada campo correspondente:
Produtos — o arquivo compactado com os arquivos Excel contendo os produtos fornecido pela Tiny.
Clientes — o arquivo compactado com os arquivos Excel contendo os clientes fornecido pela Tiny.
Pedidos — o arquivo compactado com os arquivos Excel contendo os pedidos fornecido pela Tiny.
Clique em Importar.
Importante: a Martz aceita, nesta tela, somente arquivos com extensão ZIP, contendo as planilhas compactadas. Se necessário, compacte o conjunto de arquivos exportado em cada tela da Tiny antes de enviá-los.
Resumo rápido
Etapa | Onde | O que fazer |
Gerar token | Tiny → Configurações → Token API | Clicar em "gerar token API" e copiar o código |
Conectar | Martz → ERPs → Tiny → Integrar | Colar o token e clicar em "Iniciar integração" |
Configurar canal | Martz → Configurações adicionais | Excluir o canal de e-commerce já integrado (ex.: Bagy) |
Exportar produtos | Tiny → Cadastros → Produtos | mais ações → exportar produtos para planilha |
Exportar clientes | Tiny → Cadastros → Clientes e Fornecedores | mais ações → exportar para planilha |
Exportar pedidos | Tiny → Vendas → Pedidos de Venda | mais ações → exportar; filtrar período e excluir o e-commerce integrado |
Importar | Martz → Importar planilhas | Enviar os 3 arquivos em ZIP e clicar em "Importar" |
Pontos de atenção (para evitar duplicidade)
Ao integrar, exclua o canal do e-commerce já conectado à Martz vindo da Tiny.
Ao exportar os pedidos, filtre o período e exclua as vendas do e-commerce já integrado.
Esses dois cuidados são as principais causas de pedidos duplicados na migração — seguindo-os, seu histórico ficará íntegro.