Integração Tiny com a VirtUOL

Configurar a integração no Tiny

1. Acesse as configurações de e-commerce do Tiny em Menu → Configurações → Aba E-commerce → Integrações.

2. Agora, clique no botão Incluir integração para adicionar as configurações de integração.

   

   Caso já possua integrações configuradas em sua conta, as mesmas serão exibidas e indicadas com suas respectivas situações.

   Cada situação indica:

   • Ativa: Representa que a configuração da integração foi realizada com sucesso e a mesma encontra-se pronta para uso.
   • Inativa: Indica a inatividade desta loja no Tiny, a mesma não será utilizada ou mostrada para sincronização de pedidos, produtos e demais ações pertinentes.
   • Não configurada: Esta situação indica que a configuração ainda não foi realizada.
   • Não instalada: Representa que ainda não houve a comunicação com o e-commerce para ativar a integração.

   Observação:

   Somente as integrações com a situação Ativa serão exibidas para uso nas sincronizações, importações e demais ações no Tiny.

Configurar aba Integração

1. Na aba Integração , selecione VirtUOL no campo Integração. Assim irá abrir todas as abas de configuração desta integração.

2. No campo Nome informe o nome da sua loja na integração. Este campo já vem preenchido com o nome da integração.

3. Na seção Autenticação , preencha os campos abaixo:

   ID Loja API	Preencha este campo com o ID da loja API.
   Usuário API	Preencha esta informação com o usuário API.
   Senha API	Preencha esta informação com a senha API.
   Integration Key API	Preencha este campo com a Integration Key API.

4. Para concluir, verifique se os dados informados estão corretos clicando no botão Testar configurações.

Configurar aba Configurações

1. Agora, na aba Configurações , defina os campos conforme abaixo:

   Sincronização de produtos

   Enviar imagens dos produtos ao sincronizar	Através desta opção, defina se as imagens dos produtos serão importadas Apenas para novos produtos ou se será importada para todos os itens (ao habilitar a opção Sim ).
   Enviar categorias ao atualizar	Habilite esta opção caso deseje com que a categoria dos produtos na plataforma sejam enviadas ao atualizar produtos já existentes.

   Sincronização de pedidos

   Importar forma de recebimento nos pedidos	Habilite a opção para receber a forma de recebimento na importação dos pedidos. A configuração das formas de recebimento devem ser realizadas na aba Formas de recebimento.
   Importar valor do frete nos pedidos	Habilite a opção se deseja importar o valor do frete na importação dos pedidos.
   Enviar rastreamento ao alterar a situação no Tiny para enviado	Se esta opção estiver habilitada, sempre que a situação de envio do pedido for alterada para Enviado no Tiny, o código de rastreio será enviado de forma automática para a plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.
   Marcar pedido como entregue ao alterar a situação no Tiny	Ao habilitar esta opção, sempre que um pedido for alterado para a situação Entregue no Tiny, o mesmo também terá o seu status alterado na plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.
   Enviar e-mail, através da plataforma, ao enviar rastreamento à VirtUOL	Ative essa opção caso queira que a plataforma envie automaticamente um e-mail para os compradores da loja virtual ao receber o rastreamento a partir do Tiny.

Configurar aba Estoque

1. Na aba estoque, defina as regras de estoque da integração:

   Atualizar estoque na loja virtual a partir do Tiny	Selecione umas opções disponíveis para atualização do estoque, sendo elas: não atualizar, enviar saldo físico (estoque total) ou enviar saldo disponível (estoque total considerando a reserva de estoque).
   Depósito a ser considerado na integração	Escolha qual será o depósito padrão para: importar pedido, importar produtos e enviar estoque. * O campo depósito a ser considerado na integração será exibido nas contas que possuem a extensão depósitos de estoque instalada
   Utilizar reserva de estoque na VirtUOL	Se você utiliza o serviço de Reserva de estoque na VirtUOL , selecione a opção Sim. Também será preciso utilizar o módulo de Reserva de estoque em sua conta no Tiny. Saiba como trabalhar com o módulo reserva de estoque.

Configurar aba Dados Fiscais

1. Na aba Dados Fiscais , no campo Natureza de operação para venda desta integração selecione uma Natureza de venda padrão para essa plataforma. A natureza selecionada será atribuída na Importação dos pedidos no Tiny e no momento em que gerar a Nota Fiscal através do pedido importado.

2. Além disso, você pode Habilitar ou Desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o Tiny identificar que o pedido de venda trata-se de um cliente contribuinte.

Configurar aba Gestão de preços

1. Na aba Gestão de preços , defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce.

   • Preço fixo : conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente;
   • Conforme regras de preço : trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais;
   • Conforme lista de preços : para uso de listas de preços dos produtos, específicas para o e-commerce ou marketplace.

2. Ao definir a regra como Conforme lista de preços , no campo Lista de preços utilizada nos produtos , selecione a lista de preços que será utilizada na importação de pedidos do e-commerce. Saiba como configurar Listas de preços.

3. Ao definir a regra como Conforme regras de preço , siga a configuração de Precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.

Configurar aba Situações

1. Na aba Situações , ao clicar em Adicionar situações padrão , é adicionado as situações presentes no e-commerce e as mesmas serão listadas na coluna Código da situação no E-commerce.

2. Abaixo, em Sequência das situações no Tiny é apresentado um fluxo de situações dos pedidos.

3. No campo Permite retroceder situação dos pedidos na sincronização de situações , habilite a opção se deseja permitir a alteração da situação do pedido para uma situação anterior da situação atual, por exemplo, um pedido Enviado voltar para a situação Preparando Envio.

4. Na coluna Situação no Tiny , selecione a situação correspondente no Tiny. Existe também, a possibilidade de adicionar novas situações ao clicar em + Adicionar mapeamento de situação.

Configurar aba Formas de Recebimento

Na aba Formas de Recebimento , pode-se relacionar as formas de pagamento dos seus pedidos da loja virtual com a forma de recebimento no Tiny. Esta configuração fará com que suas contas a receber sejam geradas corretamente no Tiny, com as mesmas informações.

1. Ao habilitar o parâmetro Importar forma de recebimento nos pedidos , será possível realizar o mapeamento das formas de pagamento presentes em sua plataforma com os respectivos destinos no Tiny.

2. Na configuração Forma de recebimento padrão para os pedidos importados deste e-commerce , selecione a forma de recebimento que será utilizada caso o pedido seja importado sem nenhuma forma mapeada.

3. Logo abaixo, em Relacione as formas de recebimento do Tiny com as da integração , no campo de Forma de recebimento , selecione a forma de recebimento do Tiny que deseja mapear.

   Depois, através do campo Código na integração , clique sobre o botão Relacionar forma de recebimento.

4. Na janela que será exibida, selecione a forma de recebimento de sua plataforma que será vinculada à forma de pagamento escolhida anteriormente.

5. Caso nenhuma forma de recebimento seja exibida ou se a forma que você deseja vincular não está sendo exibida na listagem, existe a possibilidade de realizar a busca da forma vinculada em um pedido da plataforma através do botão Obter via pedido. Também, caso você já possua a informação de qual código deverá utilizar para realizar o vínculo, clique em Informar código manualmente.

6. Após realizar o vínculo, clique em Selecionar.

7. Para incluir uma nova forma de recebimento, clique em Adicionar forma de recebimento. Caso não possua nenhuma forma de recebimento e deseje cadastrar, acesse a ajuda Formas de Recebimento.

Configurar aba Formas de frete

Em Formas de frete pode ser realizado o mapeamento das formas de frete presentes no e-commerce, com as formas de envio cadastradas em sua conta no Tiny.

1. Para isso, no campo Forma de envio e Forma de frete , selecione a forma de frete que deseja mapear.

2. Em Código na integração , clique no botão Relacionar forma de frete.

3. Na janela que será exibida, informe o Identificador do pedido na integração para que o Tiny realize a busca de qual forma de frete está inserida no mesmo para que o vínculo seja realizado. Desta forma, todas as vendas com a mesma forma de envio do pedido utilizado como exemplo, serão identificadas com a forma escolhida anteriormente.

4. Se a forma de envio não for localizada na busca pela venda e você tiver o código para mapeamento, clique no botão Informar código manualmente e insira a respectiva informação.

5. Caso precise adicionar novas formas de frete, clique em Adicionar.

6. Ao final, não esqueça de Salvar as configurações.

1. Os pedidos realizados na VirtUOL serão listados em Menu → Vendas → Pedidos no e-commerce na Aba da loja virtual.

2. Vale lembrar que é possível Filtrar os pedidos por situação e por período.

3. Após isso, Selecione os pedidos desejados e clique em Receber pedidos. Com esta ação os pedidos serão recebidos no Tiny e ficarão visíveis em Menu → Vendas → Pedidos de Venda.

1. Para enviar o cadastro de produtos do Tiny para a VirtUOL, acesse Menu → Cadastros → Produtos → Marque o item que deseja enviar na lateral esquerda → Enviar para o e-commerce.

   

   Campos enviados:

   • Código (SKU)
   • Descrição
   • Estoque atual
   • Preço de venda
   • Preço promocional
   • Altura embalagem
   • Largura embalagem
   • Comprimento embalagem
   • Diâmetro embalagem
   • Peso bruto
   • Descrição complementar
   • Imagens
   • Variações
   • Id da categoria no Tiny
   • GTIN
   • Slug
   • Marca

2. A seguir, no campo Plataforma , selecione a opção VirtUOL.

3. Para atualizar o estoque do produto, marque a opção Atualizar estoque no e-commerce.

4. Caso desejar interromper o envio se algum produto for rejeitado, marque a opção Parar o envio em lote caso algum produto seja rejeitado.

5. Agora, clique em Avançar para prosseguir com o envio dos produtos.

6. A seguir, são apresentados os dados de envio dos produtos, por exemplo: Identificador na VirtUOL, Descrição, Código (SKU), Preço e Estoque.

7. Clique em Enviar para concluir o envio dos produtos para a VirtUOL.

8. O aviso do envio de produtos com sucesso, representa que os mesmos foram enviados à VirtUOL.

Para enviar a lista completa dos produtos no Tiny para o e-commerce, acesse a ajuda Enviar produtos em lote ao e-commerce.

1. Para realizar os ajustes nos preços dos produtos cadastrados no Tiny e após atualizar na loja virtual, acesse Menu → Cadastros → Produtos → Mais ações → Reajustar preço dos produtos.

2. Utilize as opções de Filtros caso deseje, ou clique direto em Listar produtos.

3. Após isso, será exibido a lista dos produtos, clique em Informar reajuste.

4. Selecione os produtos que deseja atualizar os preços, utilize uma das opções disponíveis para atualizar os preços: por reajuste de Percentual , ou adicione o novo preço em cada produto na coluna Novo preço , marque a opção Atualizar preços no e-commerce e selecione a integração correspondente, por fim clique em Salvar.

Enviar quantidade em estoque em lote

1. Para realizar o envio da quantidade em estoque dos produtos ao e-commerce em lote, acesse Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar estoque ao e-commerce.

2. Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque dos produtos na lista que será exibida.

3. Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.

4. Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Estoque.

5. Para concluir o processo de envio, clique em Enviar.

Enviar quantidade em estoque de forma individual

1. Caso queira enviar somente a quantidade em estoque de um produto específico, acesse o Menu de contexto do produto e clique em Enviar estoque ao e-commerce.

2. No campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque do produto na lista que será exibida.

3. Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.

4. Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Estoque.

5. Para concluir o processo de envio, clique em Enviar.

Enviar preços em lote

1. Para realizar o envio dos preços dos produtos ao e-commerce em lote, acesse Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar preços para o e-commerce.

2. Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços na lista que será exibida.

3. Após definir para qual ou quais integrações será realizado o envio dos preços, clique em Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.

4. Para concluir o processo de envio, clique em Enviar.

Enviar preço de forma individual

1. Caso queira enviar somente o preço de um produto em específico, acesse o Menu de contexto do produto e clique em Enviar preços para o e-commerce.

2. Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços na lista que será exibida.

3. Após definir para qual ou quais integrações será realizado o envio dos preços, clique em Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.

4. Para concluir o processo de envio, clique em Enviar.

1. Acesse Menu → Vendas → Pedidos do e-commerce → Selecione a loja virtual → Marque os pedidos que já foram enviados e clique em Sincronizar situação.

   Observação:

   Ao sincronizar situação, o status presente em Situação no Tiny corresponderá a situação do pedido no e-commerce conforme o mapeamento realizado.

1. Acesse o módulo de Expedição, selecione a forma de envio Correios/Transportadora → Aba Concluídas → Clique no Menu de contexto ao lado da expedição gerada → Enviar código de rastreio para o e-commerce.

1. Após isso, ao acessar a expedição será adicionado um Marcador que identifica quando o código de rastreio já foi enviado para VirtUOL.

Ao marcar os pedidos como entregue no Tiny, os mesmos serão sincronizados com o status Entregue na VirtUOL.

1. Para isso, acesse Menu → Vendas → Expedição → Selecione a forma de envio → Aba Concluídas → Clique no Menu de contexto ao lado da expedição gerada → Marcar pedidos como entregue.

2. Assim, será adicionado na expedição um Marcador que identificará que a venda já foi marcada como entregue e sincronizada na VirtUOL.

• Caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse Configurações → Aba E-commerce → Integrações e marque a integração desejada. Depois, clique em Mais ações → Excluir todos os anúncios no Tiny. É importante mencionar que esta ação, depois de concluída, não poderá ser desfeita.
• Após importar um pedido, é possível realizar o cadastro do produto no Tiny, através do lançamento de estoque, disponível no Menu de contexto , localizado ao lado do pedido ou da nota → Lançar estoque.
• Se desejar, você pode realizar a importação de produtos através de planilha de acordo com o nosso layout disponibilizado em Importador de produtos.
• Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.