Atualmente, o recurso de roteamento de pedidos não está disponível na nova integração com o Tiny ERP. Por isso, para operações com Multi-CD, utilizamos a integração por meio do Hub.
A integração com o Tiny é feita via webhook, o que significa que notificações são enviadas para atualizar os dados de catálogo e pedidos em tempo real. Embora as atualizações geralmente ocorram rapidamente, em alguns casos pode haver atrasos devido a filas de processamento.
As informações enviadas entre o Vnda e o Tiny incluem:
Envio de pedidos (Vnda → Tiny)
Recebimento de produtos (Tiny → Vnda)
Envio de produtos (Vnda → Tiny, em andamento)
Envio de estoque (Tiny → Vnda)
Envio de preços (Tiny → Vnda)
Sincronização da situação dos pedidos (Tiny → Vnda)
Envio da NFe (Tiny → Vnda)
Envio do rastreio (Tiny → Vnda)
O fluxo de ativação dessa integração é dividido em duas etapas:
Configurações no Tiny
Configurações no Hub
1. Configurações no Tiny ERP
Acesse o menu: Configurações > E-commerce > Integrações > Adicionar Integração > Vnda
Na aba "Configurações", ative as seguintes opções:
Sincronização de pedidos
Enviar rastreamento ao alterar a situação do pedido no Tiny para "Enviado"
Na aba "Estoque", escolha uma das opções:
Enviar saldo disponível
Enviar saldo físico
Clique em "Salvar"
Na aba "Integrações", configure a URL da seguinte forma no campo de URL de situação de pedidos:
URL:
https://www.NOME_DA_LOJA.com.br/api/v2/orders/tinyerp?tinyerp_hook_token=TOKENSubstitua “NOME_DA_LOJA” pela URL de produção da loja e “TOKEN” pelo token gerado pela integração
(Exemplo:
https://www.vnda.com.br/api/v2/orders/tinyerp?tinyerp_hook_token=XPTO).
Guarde o código do token gerado.
No admin do Vnda, adicione a configuração adicional da loja:
tinyerp_hook_token: {token} (substitua “{token}” pelo token da API do Tiny).
💡 Importante: Caso você precise substituir o token (por exemplo, se a conta Tiny foi alterada), basta seguir o mesmo processo e o token antigo será substituído.
ℹ️ Extensão Reserva de Estoque: O botão "Enviar saldo disponível" fica disponível após a instalação da extensão "Reserva de Estoque". Para instalá-la, acesse Extensões do Tiny > Suprimentos, role até "Suprimentos" e selecione a extensão "Reserva de Estoque". Clique em "Instalar".
2. Configurações no Hub (Admin E-commerce)
Para configurar a integração no Hub, siga as instruções abaixo, prestando atenção nos campos obrigatórios:
Acesse as configurações no admin, indo em Integrações, e busque por Sistemas ERP. Em seguida, clique no "+" na parte superior da tela (Adicionar nova integração).
No primeiro campo, "Integração", selecione a opção Tiny ERP. Marque a integração como Ativa.
No campo Token de acesso, cole o código do token obtido no passo anterior.
Preencha os campos seguintes conforme necessário:
Depósitos: Geral (ou conforme o nome do depósito no Tiny).
Situação padrão do pedido: Em aberto
Enviar developer-id: Sim.
CNPJ da loja: Deve ser o mesmo CNPJ da conta Tiny.
Importar imagens de produtos: Sim (ou não, caso as imagens sejam cadastradas na Vnda).
As demais configurações de "Preferências" no Hub podem ser ajustadas conforme as necessidades do cliente.
2.1. Mapeamentos
Os campos de mapeamento definem a correspondência entre os termos usados na Vnda e os termos usados no Tiny ERP. Cada termo é mapeado da seguinte maneira:
Mapeamento de Produtos Simples:
reference:codigo,description:descricaoComplementar,product_name:nome,sku:codigo,variant_name:nome,price:preco,width:larguraEmbalagem,height:alturaEmbalagem,length:comprimentoEmbalagem,weight:pesoBruto,quantity:estoqueAtual
Mapeamento de Produtos com Variações:
reference:codigo,description:descricaoComplementar,product_name:nome,sku:variacao.codigo,variant_name:nome,price:preco,width:larguraEmbalagem,height:alturaEmbalagem,length:comprimentoEmbalagem,weight:pesoBruto, property1:variacao.grade.0.valor,quantity:variacao.estoqueAtual
Nota: Se o produto tiver mais de uma variação, adicione os atributos de forma sequencial (sem aspas):
property1:variacao.grade.0.valor(uma variação)property1:variacao.grade.0.valor,property2:variacao.grade.1.valor(duas variações)property1:variacao.grade.0.valor,property2:variacao.grade.1.valor,property3:variacao.grade.2.valor(três variações)
⚠️ Atenção: Para produtos com variação, é necessário garantir que as variações no cadastro do Tiny e da Vnda estejam consistentes e na mesma ordem. Caso contrário, pode haver confusão entre as variantes (por exemplo, "Tamanho: amarelo").
Mapeamento de Pedidos
Setup dos mapeamentos no HUB
Tipo de entrega
De (Vnda): preencher valores enviado fora dos parênteses na informação de entrega do pedido no admin.
Ex: "Normal", "Expressa"...
Para (integração): colocar uma das seguintes letras (sem o que está entre parênteses)
C (Correios)
T (Transportadora)
M (Mercado Envios)
E (Correios E-fulfillment)
B (B2W Entrega)
X (Customizada)
S (Sem Frete)
G (Gateway logístico)
*Obs: caso n tenha nenhuma cadastrada será enviado C
Transportadora
De (Vnda): preencher valores enviado fora dos parênteses na informação de entrega do pedido no admin.
Ex: "Normal", "Expressa"...
Para (integração): de acordo com a Descrição cadastrada no Tiny em Configurações > Vendas > Formas de Envio.
*Usar a descrição de baixo em caso de ter forma de entrega, se não tiver cadastrada, a descrição de cima.
Meio de pagamento
De (Vnda): Possíveis valores
American Express - Crédito
Diners - Crédito
Elo - Crédito
Hipercard - Crédito
Mastercard - Crédito
Visa - Crédito
Boleto
Pix
Depósito
Paypal Plus
Para (integração): Possíveis valores
múltiplas
dinheiro
credito
debito
boleto
deposito
pix
cheque
crediário
duplicata_mercantil
Condição de pagamento
De (Vnda): Possíveis valores
American Express - Crédito
Diners - Crédito
Elo - Crédito
Hipercard - Crédito
Mastercard - Crédito
Visa - Crédito
Boleto
Pix
Depósito
Paypal Plus
Para (integração): Preencher exatamente com o nome do gateway cadastrado em Configurações > Finanças > Cadastro de gateways no Tiny.
*Obs: o cliente tem que instalar a extensão no Tiny.
3. URLs do Hub a serem configuradas no Tiny:
Estoque:
https://hub.vnda.com.br/api/stocks/tinyerp/notificationProdutos:
https://hub.vnda.com.br/api/products/tinyerp/notificationRastreio:
https://hub.vnda.com.br/api/trackings/tinyerp/notificationNota Fiscal:
https://hub.vnda.com.br/api/invoices/tinyerp/notificationPreço:
https://hub.vnda.com.br/api/prices/tinyerp/notificationAtualização de pedidos:
https://www.nome_da_loja.com.br/api/v2/orders/tinyerp?tinyerp_hook_token=token
4. Ativação do Módulo Multi-CD Integrado ao Tiny
Para ativar o módulo Multi-CD com a integração ao Tiny ERP, algumas configurações adicionais precisam ser feitas durante o cadastro da loja no Hub.
Configurações Necessárias no Hub:
Identificador do Pacote:
No campo "Identificador do pacote", preencha com o ID do local cadastrado no Hub.
Identificador do Centro de Distribuição:
No campo "Identificador do centro de distribuição", preencha com o mesmo nome que foi utilizado no cadastro do local.
Sincronização de Estoque:
No campo "Sincronizar estoque com o:", altere a opção de e-commerce para Local/loja.
Campo CNPJ da loja:
Podemos validar na conta Tiny, em dados da conta, qual é o cnpj cadastrado pois devemos preencher com exatamente o mesmo cnpj nesse campo, utilizando com apenas números.
Observação: quando recebemos a notificação de estoque do Tiny, buscamos todos os hubs que estão vinculados ao CNPJ recebido na notificação. Portanto, é muito importante que não tenha mais de 1 hub com o mesmo CNPJ, mesmo que esteja inativo esse Hub pode causar interferência na sincronização.
Multiempresa Tiny:
As contas Tiny devem ter a configuração ativa do multiempresa. Isso é feito pelo próprio seller ou pelo suporte do Tiny.
Nesse cadastro devemos apenas validar se está configurado conforme o print abaixo para que a sincronização de estoque funcione corretamente:
Acesso em Configurações → Geral → Multiempresa
Mapeamento de Produtos:
Para simplificar a integração e garantir que as informações de estoque e preço sejam corretamente sincronizadas, você pode reduzir o mapeamento para os seguintes campos:
Mapeamento de Produtos Simples:
reference:codigo,sku:codigo,price:preco,quantity:estoqueAtual
Mapeamento de Produtos com Variações:
reference:codigo,sku:variacao.codigo,price:preco,quantity:variacao.estoqueAtual
Integração com o Tiny: Antiga e Nova
No módulo Multi-CD integramos tanto a integração "antiga" quanto a nova com o Tiny ERP. Ambas as integrações funcionam de forma conjunta, divididas em duas funções específicas:
Integração Nova - Produtos:
Esta versão é responsável pela sincronização do catálogo completo de produtos. Sempre que for necessário criar um novo produto na Vnda, deve-se utilizar esta integração primeiro. A integração nova também é responsável por sincronizar os dados de produtos entre a Vnda e o Tiny.
Integração Antiga - Pedidos e Estoque:
Esta versão foca na sincronização de pedidos e estoque. Ela é usada para:Atualizar o estoque dedicado a cada local na Vnda.
Recebe os pedidos com a identificação de CD.
Permite o roteamento de pedidos entre as contas do Tiny, facilitando a gestão do processo de pedidos em Multi-CD.
Cadastro de Produtos e Anúncios:
O cadastro completo dos produtos pode ser centralizado em apenas uma das contas do Tiny, caso o cliente queira. Esta conta será usada para criar os produtos na Vnda por meio da integração Olist Vnda - Produtos.
Nas outras contas do Tiny, é necessário apenas criar os anúncios (e não o cadastro completo dos produtos) através da integração Olist Vnda - Pedidos e Estoque.'