Integração Tiny com a Hoop

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 plataformas com a situação Ativa serão exibidas para uso nas sincronizações, importações e demais ações no Tiny.

3. Na aba Integração , selecione Hoop no campo Integração. Abaixo, no campo Nome informe o nome da sua loja.

4. Em Configurações , defina os seguintes campos abaixo:

   Sincronização de produtos

   Enviar dias para preparação ao sincronizar

   Habilite a opção para enviar a informação da quantidade de dias necessários para o envio de produtos para a plataforma. * Para preencher este campo, acesse o menu → cadastro → produto → editar, na aba dados gerais, na seção estoque clique em dias para preparação. Lembramos que esse campo pode ser alimentado por planilha e será inserido também nas APIs de cálculos dos fretes.

   Notificações por e-mail

   Enviar e-mail de rastreamento ao alterar a situação no Tiny para enviado	Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no Tiny, o código de rastreio será enviado de forma automática via e-mail conforme layout estabelecido nas configurações da expedição.
   Enviar e-mail de entrega  ao alterar a situação no Tiny para entregue	Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no Tiny, será enviado de forma automática um e-mail conforme layout estabelecido nas configurações da expedição.

5. 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

6. 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.

   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.

   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.

7. 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.

   Observação:

   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.

8. Na aba Notificações preencha os campos URL do notificações de estoque , URL para envio de produtos e URL para envio dos preços com as URLs utilizadas para webhook de sua loja virtual.

   Observação:

   Estes links são gerados diretamente através da configuração na Hoop. Saiba mais através da ajuda Como integrar o Tiny na Hoop.

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

1. Inicie adicionando a extensão Token API em sua conta. Para isso acesse Menu → Início → Extensões do Tiny.

2. Na seção Vendas , adicione a extensão Token API.

3. Agora, clique em Instalar e Confirme a instalação da extensão.

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

2. No campo Token , encontra-se o Token identificador da sua conta.

   Esse token deve ser adicionado no momento que instalar o aplicativo do Tiny na CartX, conforme orientação Como integrar o Tiny na Hoop.

Enviar apenas um produto

1. Para enviar apenas um produto para Hoop, acesse em Menu → Cadastros → Produtos.

2. Agora, acesse o Menu de contexto do produto e clique em Enviar para o e-commerce.

3. A seguir, no campo Plataforma selecione sua loja Hoop e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.

4. Valide se o produto esta com as informações corretas para envio clique em Enviar.

   Campos enviados:

   • Descrição;
   • Descrição complementar;
   • Código;
   • Unidade;
   • GTIN;
   • GTIN embalagem;
   • Origem;
   • NCM;
   • Preço;
   • Preço de custo;
   • Peso bruto;
   • Peso líquido;
   • Estoque;
   • Imagens;
   • CEST;
   • Unidades por caixa;
   • Código no fabricante;
   • Variações.

   Observações:

   Os campos sincronizados devem ser corrigidos/modificados apenas no Tiny. Caso você corrija/modifique alguma destas informações no painel de controle da Hoop, estas informações serão sobrescritas pelos dados cadastrados no Tiny assim que rodar a próxima rotina de sincronização.

Enviar produtos selecionados

1. Para enviar o cadastro de produtos do Tiny para Hoop, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.

2. A seguir, no campo Plataforma selecione sua loja Hoop e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.

3. Valide se o produto esta com as informações corretas para envio clique em Enviar.

   Campos enviados:

   • Descrição;
   • Descrição complementar;
   • Código;
   • Unidade;
   • GTIN;
   • GTIN embalagem;
   • Origem;
   • NCM;
   • Preço;
   • Preço de custo;
   • Peso bruto;
   • Peso líquido;
   • Estoque;
   • Imagens;
   • CEST;
   • Unidades por caixa;
   • Código no fabricante;
   • Variações.

   Observações:

   Os campos sincronizados devem ser corrigidos/modificados apenas no Tiny. Caso você corrija/modifique alguma destas informações no painel de controle da Hoop, estas informações serão sobrescritas pelos dados cadastrados no Tiny assim que rodar a próxima rotina de sincronização.

Para que o mapeamento dos itens entre o Tiny e a Hoop ocorra, é necessário sincronizar o produto desejado a partir do Tiny. Saiba mais como enviar produtos para a plataforma através da ajuda Como enviar produtos do Tiny para Hoop.

A importação dos pedidos é realizada de forma automática. Para visualizar os pedidos, acesse sua conta no Tiny em Menu → Vendas → Pedidos de venda.

1. Para ativar e configurar a integração da loja com o sistema Tiny ERP, acesse o painel da Hoop e clique sobre o ícone de sua loja.

2. Nas configurações de sua loja, selecione a integração do Tiny e preencha os campos API Key com o Token gerado anteriormente e, também, o Identificador do integrador.

   Caso você ainda não tenha gerado essas informações, acesse a ajuda Como configurar a Hopp no Tiny.

3. Após realizar as demais configurações, clique em Salvar. Ao concluir esse processo, as URL para uso dos webhooks serão geradas e poderão ser configuradas no Tiny.