Integração desenvolvida pela Tiny, com os recursos de importação de pedidos, envio de produtos, estoques e preços além de sincronização do Tiny com o e-commerce.
Para uma melhor experiência em Tiny, sugerimos que você inicie preparando a sua conta, fazendo as configurações necessárias, depois, configure a integração e após siga os passos de ações a realizar no Tiny para aproveitar as funcionalidades disponíveis para a integração.
Recursos disponíveis
| Receber produtos | x |
| Receber pedidos | ✔ |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | ✔ |
| Sincronizar situação | ✔ |
| OMS | ✔ |
Atenção!
Antes de configurar a integração no Tiny, é necessário entrar em contato com o time da Leroy Merlin, comunicando que deseja integrar conosco.No final desse processo, a Leroy lhe fornecerá um token (Consumer Key) que pode ser utilizado para configurar a integração no Tiny.
Como configurar a integração
- Para iniciar a configuração, acesse menu → início → integrações .
Observações:
Caso já possua integrações configuradas em sua conta, elas serão exibidas e indicadas da seguinte forma:
- Ativa: Indica que a integração foi realizada com sucesso e encontra-se pronta para uso.
- Inativa: Indica a inatividade desta loja no Tiny, ou seja, a loja não estará disponível para sincronização de pedidos, produtos e demais ações pertinentes.
- Não conectada: Indica que a configuração ainda não foi realizada.
Somente as integrações Ativas serão exibidas para uso nas sincronizações, importações e demais ações no Tiny.
- Clique em adicionar integração, busque por Leroy Merlin e clique em instalar.
- Na seção autenticação, informe a chave da API informe a chave de API que se encontra no painel administrativo da sua loja. Saiba como localizar a chave API.
Clique em testar configurações para validar as credenciais de login.
- Na aba 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. Sincronização de pedidos
Importar valor do frete nos pedidos Habilite essa opção para importar o valor do frete na importação dos pedidos. Sincronização automática Habilite essa opção para utilizar o recurso de OMS na integração com seu e-commerce. Saiba mais sobre o recurso em OMS. Enviar rastreamento ao alterar a situação no Tiny para enviado Habilite esse parâmetro para que o código de rastreio seja automaticamente enviado para a plataforma sempre que a situação do pedido for alterada para Enviado. Saiba mais sobre essa rotina através da ajuda atualizar situação de envio dos pedidos. Adicionar o endereço do cliente nas observações da venda Habilite esse parâmetro para adicionar o endereço do cliente nas observações da venda, ao importar o pedido do e-commerce. Formatar nome dos contatos no recebimento dos pedidos Habilite essa opção para que o nome do cliente, ao importar os pedidos, seja formatado com as iniciais maiúsculas em seu nome e sobrenome. Completar endereço do cliente a partir do CEP na importação de pedidos Habilite essa opção para que o endereço do cliente seja preenchido no Tiny, ao importar os pedidos, de acordo com a opção escolhida * Escolhendo a opção sempre, o CEP sempre será validado junto ao Correios para preenchimento do endereço do cliente. Assim, os dados de endereço obtidos na plataforma de e-commerce serão ignorados.
Configurações adicionais
Envio de dados da NFe Selecione a forma de envio dos dados na NFe ao e-commerce, automático ou manual. Para envio manual consulte enviar dados da NFe ao e-commerce (Manual). Intermediador Selecione o intermediador de suas operações. Maiores informações em como utilizar e configurar os intermediadores de operações.
* A informação de intermediador da transação é obrigatória para emissão de NFe.
Observação
Nesta integração, os dados da NFe enviados são: XML, chave de acesso, data de envio, número, série e o CFOP do primeiro item da NFe. -
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 as ações: 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.
Estoque de segurança Informe a quantidade de estoque de segurança para que, quando seu estoque atingir este número, a quantidade de estoque enviada para a plataforma seja Zero. * Produtos sob encomenda não estão abrangidos por este parâmetro.
- Na aba dados fiscais, selecione a informação natureza de operação para venda nesta integração. A natureza selecionada será atribuída de forma padrão na importação dos pedidos no Tiny e no momento em que gerar a nota fiscal através do pedido importado.
Observação:
- 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.
- Caso precise configurar uma nova natureza de operação para utilizar nesta integração, acesse a ajuda natureza de operação e inclua uma natureza conforme seu regime tributário e orientações da sua contabilidade.
- 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. Ao definir essa regra, siga a configuração de precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.
- Conforme lista de preços: utiliza de listas de preços dos produtos, específicas para o e-commerce ou marketplace. Ao definir essa regra, no campo lista de preços utilizada nos produtos, selecione a lista de preços a ser considerada na importação de pedidos do e-commerce. Saiba como configurar em listas de preços.
- 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;
- Na aba categorias, relacione as categorias de produtos no Tiny com as categorias do e-commerce, assim os produtos já serão enviados nas categorias mapeadas previamente.
Categorias já cadastradas serão apresentadas em categoria no Tiny. Adicione o código da categoria no e-commerce clicando no botão configurar categoria no e-commerce (∞)
Observações:
- Caso ainda não possua categorias cadastradas em sua conta no Tiny, verifique as instruções para inclusão de categorias em como cadastrar categorias de produtos.
- As instruções para vincular as categorias no cadastro de produtos, estão disponíveis em como cadastrar um produto.
- Na aba situações, é possível relacionar a situação dos pedidos no e-commerce com as respectivas situações no Tiny, assim como o fluxo da sequência das situações no Tiny.
Adicione as situações presentes no e-commerce, clicando em adicionar situações padrão. Para adicionar novas situações, clique em adicionar mapeamento de situação.
Para alterar a situação de um pedido para uma situação anterior à atual, habilite o campo permite retroceder situação dos pedidos na sincronização de situações, assim, por exemplo, um pedido enviado poderá voltar para a situação preparando envio.
Observação:
Ao importar um pedido de venda do e-commerce para o Tiny, o pedido assume a situação configurada. Caso a situação não esteja configurada, o pedido importado terá a situação em aberto atribuída. - Na aba formas de recebimento, é possível definir a forma de recebimento que será utilizada sempre que o pedido for importado do e-commerce, habilitando o parâmetro importar forma de recebimento nos pedidos. No campo forma de recebimento padrão selecione a forma de recebimento que será utilizada para os pedidos importados.
Observação:
Ao adicionar as formas de recebimento padrão, o Tiny busca as formas já configuradas em sua conta. Para informações de como cadastrar as formas de recebimento, acesse formas de recebimento. - Na aba formas de frete: é realizado o mapeamento das formas de frete presentes no e-commerce, com as formas de envio cadastradas em sua conta no Tiny.
Nos campos forma de envio e forma de frete, selecione a forma de frete que deseja mapear. Em código na integração, clique no botão relacionar forma de frete (∞) e selecione a forma de envio correspondente em sua plataforma.
Se a forma de envio não for exibida na busca pela integração e você tiver o código para mapeamento, clique no botão informar código manualmente e insira a respectiva informação.
Para adicionar novas formas de frete, clique em Adicionar.
Observações:
- Ao adicionar as formas de frete selecionadas, o Tiny busca as formas de envio já configuradas em sua conta. Informações de cadastro de novas formas de envio no podem ser acessadas em formas de envio.
- Para mapear as formas de frete da Frenet, acesse a ajuda Mapear formas de frete Frenet
- Na aba cotação de frete, podem ser definidas as formas de envio preferenciais e alternativas de sua loja, sendo possível cotar o valor do frete para o e-commerce com as formas de envio cadastradas no Tiny.
Adicione as formas de envio preferenciais clicando em adicionar forma de envio preferencial.
Para cadastrar outras alternativas de envio, clique em adicionar forma de envio alternativa.
Em modo de cotação dos pedidos, defina a forma de cálculo da cotação que será retornada: menor preço, menor prazo ou maior prazo.
Observações:
- As formas de envio alternativas serão utilizadas somente quando não existir cotação para as formas preferenciais.
- Recomendamos que você cadastre no máximo duas formas de envio preferenciais e que essas sejam Gateways Logísticos, dessa forma o retorno dos dados para a plataforma será mais rápido.
- Não esqueça de salvar as configurações.
Como localizar a chave de API
A chave de API é o código responsável pela comunicação entre os sistemas.
- Para localizar a sua chave de API, acesse o painel administrativo de sua loja e clique sobre o nome do usuário.
- Na aba chave de API e no campo chave de API, clique sobre copiar para área de transferência.
- Em sua conta no Tiny, na aba integrações, cole a chave no campo chave da API.
Como utilizar a API de fretes
A API de fretes é que possibilitará a apresentação das cotações de frete no seu e-commerce.
Acesse sua integração com a Leroy Merlin e na aba configurações, clique em gerar link para utilizar a API de fretes.
Copie o link gerado e envie para equipe de setup da Leroy Merlin.
Observações:
- A cotação do frete é realizada com base nas informações dos produtos (dimensões da embalagem, peso bruto e estoque) cadastrados no Tiny, por isso, é de extrema importância que esses dados estejam corretamente cadastrados.
- No Tiny, você poderá utilizar o serviço de cotação de fretes através da Frenet, Melhor Envio e Correios.
Como realizar as ações em Tiny
Nessa seção, você encontra informações sobre como receber os pedidos, enviar produtos, estoque e preços, sincronizar situação, código de rastreio, chaves de acesso.
Como receber de pedidos do e-commerce no Tiny
- Para importação dos pedidos acesse menu → vendas → pedidos do e-commerce
- Ou, acesse menu → vendas → pedidos de venda → receber do e-commerce.
- Na aba da loja virtual, selecione os pedidos e clique em receber.
Vale lembrar que é possível filtrar os pedidos por situação e por período.
Observação:
Sempre que um pedido é importado, o cliente automaticamente é cadastrado em cadastros → clientes e fornecedores.
- Pedidos identificados com o marcador revisar, indicam que eles têm algum incidente.
- Para verificar a ocorrência, clique no menu de contexto (...) do pedido com o marcador → ocorrências.
- Verifique a mensagem apresentada e realize a correção do pedido no painel da plataforma.
Como enviar produtos do Tiny para o e-commerce
- Acesse menu → cadastros →produtos.
- Selecione um ou mais produtos para envio e clique em enviar para o e-commerce.
Observação:
- Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) → enviar para o e-commerce.
- Selecione sua loja Leroy Merlin, no campo plataforma.
- Marque atualizar estoque no e-commerce e parar o envio em lote caso algum produto seja rejeitado, se desejar que estas ações sejam realizadas.
- Clique em avançar e valide se os produtos estão com as informações corretas. A seguir, são apresentados os dados de envio dos produtos, por exemplo: identificador, descrição, código (SKU), preço e estoque.
- Clique em enviar para concluir o envio dos produtos.
Campos enviados:- Altura embalagem obrigatório
- Atributos
- Código (SKU)
- Comprimento embalagem obrigatório
- Descrição
- Descrição complementar
- GTIN
- Imagens obrigatório
- Largura embalagem obrigatório
- Peso bruto obrigatório
- Variações
Observações:
- É obrigatório que o produto tenha imagens, peso bruto e dimensões preenchidas.
- Ao enviar um produto com variações, uma oferta para cada variação será criada.
- Ao enviar variações que não possuem imagens, as imagens do produto pai serão utilizadas.
- Quando o produto for aprovado pela Leroy Merlin, a oferta de preço será enviada automaticamente e você já poderá começar a vender.
- Se o produto for rejeitado, a informação do anúncio no mapeamento no produto será atualizada.
- Quando todos os produtos forem enviados para os marketplaces, o usuário será notificado no Tiny.
- O Tiny organiza o envio dos produtos em lotes e, para ser compatível com o limite de cada canal, este processo de envio se inicia em 1 hora.
- Ao clicar em enviar, uma consulta diária e automática será feita pelo Tiny, para verificar a situação de cada produto enviado, que podem ser aprovados ou rejeitados:
Como acompanhar o processamento dos anúncios enviados
- Para acompanhar o retorno do processamento em sua conta no Tiny, retorne à tela de produtos e acesse o menu mais ações e clique em consultar anúncios enviados em lote (beta).
- Selecione a integração e clique em buscar protocolos. Serão listados todos os protocolos independente de sua situação, pendente ou finalizado.
- Selecione o protocolo desejado e clique em consultar protocolo.
Serão listados os anúncios enviados com sucesso, com erro e em processamento.
Observações:
- Para acompanhar o retorno do processamento na plataforma, acesse o painel de importações da sua loja Leroy Merlin, e verifique meu estoque → importação a partir do arquivo → monitorar as importações de produtos.
- Lembramos que protocolos com a situação finalizado estar]ao disponíveis para consulta por um período de 7 dias.
Como enviar o preço dos produtos para o e-commerce
- Acesse menu → cadastros →produtos.
- Selecione um ou mais produtos para envio.
- Clique em mais ações → enviar preços para o e-commerce.
Observação:
Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) → enviar preços para o e-commerce. - Selecione sua loja Leroy Merlin, no campo plataforma.
A seguir serão exibidos os dados deste produto tais como: identificador do anúncio, descrição, código(SKU) e preço. - Valide se o produto está com as informações corretas e clique em enviar.
Atenção!
- As ofertas só serão enviadas para o e-commerce após receber a aprovação dos produtos enviados para a plataforma.
- Os preços e estoques das ofertas só podem ser alterados após sua publicação.
- Após as ofertas serem enviadas e publicadas na plataforma, campos como descrição e imagem só poderão ser editados via chamado direto na Leroy Merlin.
- O envio de ofertas irá ocorrer de forma assíncrona, ou seja, não será no momento que enviar as ofertas no Tiny, elas ocorrerão de 5 em 5 minutos com o envio máximo de 100 preços, até que ocorram todas as atualizações enviadas.
Atenção!
O estoque das ofertas só pode ser enviado para a plataforma após as ofertas estarem publicadas.- Acesse menu → cadastros →produtos.
- Selecione um ou mais produtos para envio.
- Clique em mais ações → enviar estoque para o e-commerce.
Observação:
Selecionando apenas um produto, o envio para o e-commerce pode ser realizado em menu de contexto (...) → enviar estoque para o e-commerce. - Selecione sua loja Leroy Merlin, no campo plataforma.
- Defina se serão enviados os saldos físico ou disponível dos produtos e clique em selecionar.
A seguir serão exibidos os dados deste produto tais como: identificador do anúncio, descrição, código(SKU) e estoque. - Valide se o produto está com as informações corretas e clique em enviar.
Como sincronizar a situação dos pedidos
Atenção!
Para sincronizar a situação dos pedidos, é necessário habilitar a sincronização automática, em sincronização de pedidos e feito o mapeamento das situações. Acesse como configurar a integração para ver os passos dessas configurações.-
- 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.
- Acesse menu → vendas → pedidos do e-commerce → selecione a loja virtual → marque os pedidos que já foram enviados e clique em sincronizar situação.
Atenção!
Para enviar o código de rastreamento é preciso identificar o transportador, Correios ou Transportadora, no pedido ou nota fiscal. 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 início → vendas → expedição.
- Adicione o filtro por forma de envio e selecione a forma de envio correios → aba concluídas → menu de contexto (...) → enviar código de rastreio para o e-commerce.
Observação:
Ao enviar o código de rastreio, a forma de frete também é enviada e os pedidos são marcados como Enviados. - Ao acessar a expedição será adicionado um marcador que identifica quando o código de rastreio já foi enviado à plataforma.
Como enviar dados da chave de acesso ao e-commerce
O envio de dados da chave de acesso ao e-commerce pode ser realizado dentro do Tiny pelos módulos de expedição ou nota fiscal.
Observações:
- Além da chave de acesso da Nota Fiscal, também é enviado o número, série e data de emissão, sendo que é necessário a nota fiscal estar autorizada no Sefaz, para o envio das informações ocorrer com sucesso.
- O envio de dados fiscais somente ocorrerá com o pedido no status shipping.
Envio pela expedição
- Acesse Início → Vendas → Expedição, adicione o filtro Agrupamentos e selecione a visualização visão por pedidos e em no filtro por forma de envio, selecione Transportadora.
- Localize o nº de expedição, clique no Menu de contexto (...) e selecione Enviar chave de acesso para o e-commerce.
Envio pelas notas fiscais
- Acesse Início → Vendas → Notas fiscais, na aba Emitidas, selecione as notas que deseja enviar os dados para o e-commerce → mais ações→ Enviar dados da NFe para e-commerce.
Informações adicionais
- Caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse menu → início → integrações. Busque pela integração desejada, clique no menu de contexto (...) → excluir todos os anúncios no Tiny. Lembramos 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.