Integração Tiny com Spiritshop – Ajuda do Olist Tiny

Integração desenvolvida pela Spiritshop, através da nossa API de integração.

Recursos disponíveis

Receber pedidos Solução desenvolvida pela Spiritshop	✔
Receber produtos Solução desenvolvida pela Spiritshop	✔
Enviar produtos	✔
Enviar estoque	✔
Enviar preços	✔
Sincronizar situação	✔
Receber clientes	X

Configuração no Tiny

Configurar integração com a Spiritshop

Acesse as configurações de e-commerce do Tiny em Menu → Configurações → Aba E-commerce → Integrações.
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.
Na aba Integração , selecione Spiritshop no campo Integração. Abaixo, no campo Nome informe o nome da sua loja.

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

Sincronização de produtos

Enviar imagens dos produtos ao sincronizar

Selecione umas das opções disponíveis para que as imagens do produto, no Tiny, sejam enviadas para o e-commerce.

Enviar dias para preparação ao sincronizar

Habilite a opção para enviar a informação do campo Dias para preparação no envio de produtos para Americanas Marketplace. Para preencher este campo, acesse o Cadastro do seu produto , clique em Editar e na aba Dados gerais , na seção Estoque preencha o campo 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 (Carrefour, por exemplo).

Sincronização de pedidos

Enviar 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 para a plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.

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.

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

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.
Na aba Notificações preencha os campos URL do notificações de estoque, URL para envio de produtos, URL para envio do rastreio, URL para envio da nota fiscal, URL para envio dos preços e URL para envio de alteração na situação de pedidos com as URLs utilizadas para webhook de sua loja virtual.

Observação:
Estes links devem ser solicitados ao suporte da Spiritshop.
Ao final, não esqueça de Salvar as configurações.

Adicionar extensão token api

Inicie adicionando a extensão Token API em sua conta. Para isso acesse Menu → Início → Extensões do Tiny.
Na seção Vendas , adicione a extensão Token API.
Agora, clique em Instalar e Confirme a instalação da extensão.

Gerar token api

Acesse as configurações de e-commerce do Tiny em Menu → Configurações → Aba E-commerce → Token API.
No campo Token , encontra-se o Token identificador da sua conta.
Esse Token deve ser adicionado no momento que integrar o Tiny na Spiritshop

Como enviar produtos do Tiny para a Spiritshop

Enviar apenas um produto

Para enviar apenas um produto para a Spiritshop, acesse em Menu → Cadastros → Produtos.
Agora, acesse o Menu de contexto do produto e clique em Enviar para o e-commerce.
A seguir, no campo Plataforma selecione sua loja Spiritshop e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.

Campos enviados:
- Descrição
- Preço
- Peso bruto
- NCM
- Origem
- Estoque
- Estoque mínimo
- Dimensões
- Variações
- Anexos
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 Spiritshop, estas informações serão sobrescritas pelos dados cadastrados no Tiny assim que rodar a próxima rotina de sincronização.

Enviar produtos selecionados

Para enviar o cadastro de produtos do Tiny para a Spiritshop, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.
A seguir, no campo Plataforma selecione sua loja Spiritshop e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.

Campos enviados:
- Descrição
- Preço
- Peso bruto
- NCM
- Origem
- Estoque
- Estoque mínimo
- Dimensões
- Variações
- Anexos
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 Spiritshop, estas informações serão sobrescritas pelos dados cadastrados no Tiny assim que rodar a próxima rotina de sincronização.

Como mapear o cadastro dos produtos para integração do estoque

Para que o mapeamento dos itens entre o Tiny e a Spiritshop ocorra, é necessário sincronizar o produto desejado a partir do Tiny.

Como visualizar os pedidos do e-commerce no Tiny

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.

Configuração na Spiritshop

Como integrar o Tiny com a plataforma Spiritshop

Para ativar e configurar a integração da loja com o sistema Tiny ERP, entre em contato com o suporte da Spiritshop e encaminhe o Token gerado anteriormente no Tiny.

Informações relacionadas

Cadastrando os produtos no Tiny

Quando você opta por integrar o Tiny à Spiritshop, alguns dados são sincronizados entre as duas plataformas, evitando que você precise fazer o cadastro de produtos duas vezes.

É importante que você entenda quais campos serão sincronizados. Segue abaixo a lista com a especificação de cada campo:

Descrição	O campo descrição no Tiny equivale ao campo Título no painel de controle da Spiritshop.
NCM	O NCM do produto no Tiny será sincronizado com o NCM do item na Spiritshop.
Origem	A origem do produto no Tiny será sincronizada com a origem do item na Spiritshop.
Preço	O campo preço de venda no Tiny equivale ao campo preço no painel de controle da Spiritshop.
Peso bruto	O peso bruto equivale ao campo peso bruto no painel de controle da Spiritshop.
Largura	Preencha o campo largura no Tiny com a largura exata do produto. Este campo será vinculado ao campo largura no painel Spiritshop.
Altura	O campo altura no Tiny equivale ao campo altura no painel de controle da Spiritshop.
Comprimento	O campo comprimento no Tiny equivale ao campo comprimento no painel de controle da Spiritshop.
Estoque	O campo estoque no Tiny corresponde ao estoque no painel de controle da Spiritshop.
Estoque Mínimo	O campo estoque mínimo no Tiny corresponde ao estoque no painel de controle da Spiritshop.
Variações	As variações dos produtos no Tiny serão sincronizadas com as variações do item na Spiritshop.
Anexos	As imagens dos produtos no Tiny serão sincronizadas com as imagens dos itens na plataforma.

Saiba como cadastrar no Tiny produtos Simples e com Variações.

Enviar estoque dos produtos no Tiny ao e-commerce

Enviar quantidade em estoque em lote

Para realizar o envio da quantidade em estoque dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar estoque ao e-commerce.
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, selecione as integrações que deseja enviar a quantidade em estoque.

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

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 Preço.

Para concluir o processo de envio, clique em Enviar.

Enviar quantidade em estoque de forma individual

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.
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, selecione aquelas que deseja enviar a quantidade em estoque.

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

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 Preço.

Para concluir o processo de envio, clique em Enviar.

Enviar preço dos produtos no Tiny ao e-commerce

Enviar preços em lote

Para realizar o envio dos preços dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.

Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.

Para concluir o processo de envio, clique em Enviar.

Enviar preço de forma individual

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.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.

Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.

Para concluir o processo de envio, clique em Enviar.

Reajustar preço dos produtos no Tiny e atualizar na Spiritshop

Para realizar os ajustes nos preços dos produtos cadastrados no Tiny e após atualizar na loja virtual, acesse em Cadastros → Produtos → Mais ações → Reajustar preço dos produtos.
Utilize as opções de Filtros caso deseje, ou clique direto em Listar produtos.
Após isso, será exibido a lista dos produtos, clique em Informar reajuste.
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 código de rastreio para Spiritshop

Atenção!

Para enviar o código de rastreamento para Spiritshop, é preciso informar no pedido ou nota fiscal o transportador, sendo ele Correios ou Transportadora. O campo será preenchido no Pedido de Venda ou na Nota Fiscal e por fim, gerar o agrupamento (PLP ou Coleta) no módulo de Expedição. Veja como gerar a Expedição.

Acesse o módulo de Expedição, Selecione a forma de envio → Aba Concluídas → Clique no menu de contexto ao lado da expedição gerada → Enviar código de rastreio para o e-commerce.
Após isso, ao acessar a expedição será adicionado um Marcador que identifica quando o código de rastreio já foi enviado a Spiritshop.

Enviar dados da chave de acesso ao e-commerce

Ao utilizar a integração com a Spiritshop, assim que as notas forem emitidas através das vendas importadas de sua plataforma, os dados das notas fiscais serão enviados de forma automática.

Dicas e informações adicionais

Os campos sincronizados devem ser corrigidos/modificados apenas no Tiny. Caso você corrija/modifique alguma destas informações no painel de controle da Spiritshop, estas informações serão sobrescritas pelos dados cadastrados no Tiny assim que rodar a próxima rotina de sincronização.
Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.