Bagy

Acesse Bagy

A integração com a Bagy foi desenvolvida pela Tiny e permite o gerenciamento dos produtos e pedidos da sua loja.

Para uma melhor experiência em Tiny, sugerimos que você inicie preparando a sua conta. Em seguida, siga os passos da configuração da integração.

Se sua integração já está configurada, confira o passo a passo dos recursos disponíveis para esta integração.

Recursos disponíveis

Como adicionar e configurar uma integração

1. Acesse menu > início > integrações, busque por Bagy e clique em instalar.
   

   Observação

   Se você já tem integrações configuradas em sua conta, elas serão exibidas ao acessar a página de integrações, da seguinte forma:

   • Ativa: Indica que a integração foi realizada com sucesso e encontra-se pronta para uso. 
     Somente as integrações ativas serão exibidas para uso nas sincronizações, importações e demais ações no Tiny.
   • 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 integração ainda não foi configurada em sua conta.
2. Na aba integração, informe o nome da loja integrada ao Tiny.
3. Na seção autenticação, informe no Tiny token gerado na plataforma, para isso, acesse seu painel na Bagy, clique em aplicativos, na lateral esquerda da tela. Em seguida clique em loja de aplicativos.

   Procure por Tiny e clique em instalar aplicativo.

   Após instalado, clique sobre o Tiny e copie o campo token integração Tiny.
   

   Retorne para o Tiny e no campo token, cole o token integração Tiny obtido na plataforma.

4. Clique em testar configurações para validar as credenciais de login.
5. Na aba configurações, defina:
   

   Sincronização de produtos

   Enviar imagens dos produtos ao sincronizar	Define se ao enviar os produtos para a plataforma, as imagens do produto vão ser sempre enviadas (sim) ou enviadas apenas para produtos novos (que ainda não estão cadastrados na plataforma).
   Ao importar produtos	Define se ao importar os produtos da plataforma, as imagens serão cadastradas no item vão ser consideradas anexos (trazem a imagem para o Tiny) ou apenas importar a URL externa das imagens (traz para o Tiny apenas o link da imagem do produto).
   Enviar dias para preparação ao sincronizar	Ao habilitar esse parâmetro, a informação da quantidade de dias necessários para preparação do envio do item vai ser enviada 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.
   Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU)	Ao habilitar esse parâmetro, ao importar os produtos da plataforma, o código (SKU) dos itens será atualizado
   Enviar tags dos produtos	Ao habilitar esse parâmetro, as tags de identificação de um produto também vão ser enviadas para a plataforma.

   Sincronização de pedidos

   Sincronização automática de pedidos	Ao habilitar esse parâmetro, os pedidos gerados na plataforma vão ser automaticamente importados para o Tiny. Saiba mais sobre o recurso em gerenciador de pedidos (OMS).
   Substituir item kit por componentes ao importar pedidos	Ao habilitar esta opção, quando os pedidos que possuem itens do tipo kit forem importados, os componentes dos kits serão apresentados no pedido salvo no ERP.
   Importar valor do frete nos pedidos	Ao habilitar esse parâmetro, o valor do frete das vendas informado na plataforma, vai ser importada para o Tiny.
   Somar o campo Interest nas despesas do pedido	Ao habilitar esse parâmetro, as informações do campo de despesas do pedido vão levar em consideração os valores retornados pela plataforma. Geralmente, tratam-se de valores relacionados a juros pela forma de pagamento.
   Enviar rastreamento ao alterar a situação no Tiny para enviado	Ao habilitar esse parâmetro, o código de rastreio vai ser automaticamente enviado para a plataforma sempre que a situação do pedido for alterada para enviado. Saiba mais sobre essa rotina na ajuda atualizar situação de envio dos pedidos.
   Marcar pedido como entregue ao alterar a situação no Tiny	Ao habilitar esse parâmetro, sempre que a situação do pedido for alterada para entregue no Tiny, o status do pedido também vai ser alterado na plataforma. Saiba mais sobre essa rotina através da ajuda atualizar situação de envio dos pedidos.
   Formatar nome dos contatos no recebimento dos pedidos	Ao habilitar este parâmetro, o nome do cliente dos pedidos importados vai ser 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	Ao habilitar esse parâmetro, o endereço do cliente vai ser 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 vão ser ignorados.

6. Na aba estoque, defina as regras de estoque para a integração:
   

   Atualizar estoque na loja virtual a partir do Tiny	Defina a forma de atualização dos estoque na plataforma: Não atualizar: nenhum produto vai ter o estoque atualizado. Enviar saldo físico: envia o estoque total dos produtos, sem considerar a reserva de estoque. Enviar saldo disponível: envia somente o estoque disponível, pois considera a reserva de estoque.
   Depósito a ser considerado na integração	Defina qual o depósito vai ser considerado para as ações: importar pedido, importar produtos e enviar estoque, ou seja, toda movimentação de produtos vai ser atribuída a este depósito padrão. * 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 itens no estoque de segurança. Desta forma, quando seu estoque atingir este número, a quantidade de itens enviada para a plataforma vai ser zero. Por exemplo: Estoque de segurança = 5. Estoque atual = 2. Ao atualizar o estoque na plataforma, vai ser enviado saldo = 0. * Parâmetro não considerado para produtos sob encomenda.

7. Na aba dados fiscais, você define a natureza de operação para venda padrão nesta integração, informação importante para os cálculos de tributação.

   A natureza selecionada vai ser atribuída de forma padrão para todos os pedidos importador e notas fiscais geradas através dos pedidos importados.

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

8. Na aba categorias, faça o mapeamento das 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).

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

10. Na aba formas de recebimento, pode-se relacionar as formas de recebimento 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 no Tiny com as mesmas informações da plataforma.

Ao habilitar o parâmetro importar forma de recebimento nos pedidos, será possível relacionar as formas de pagamento presentes em sua plataforma com os respectivos destinos no Tiny. Para isso, clique em adicionar forma de recebimento.

A seguir, no campo de forma de recebimento, selecione a forma de recebimento do Tiny a ser relacionada com a da integração. No campo código na integração, clique sobre o botão relacionar forma de recebimento e selecione a forma de recebimento de sua plataforma que corresponderá à do Tiny.

Se a forma de recebimento correspondente não for exibida, é possível buscar por pedido que possua a mesma forma de recebimento selecionada para realizar o relacionamento ou, caso saiba o código de integração, clique em informar código manualmente e digite o código

Para confirmar o relacionamento, clique em relacionar.

No campo forma de recebimento padrão, defina a forma de recebimento que será utilizada sempre que o pedido importado não possua nenhuma forma relacionada.

11. Na aba variações: são relacionadas as variações de um produto no e-commerce com as respectivas variações no Tiny. Para verificar o cadastro de variações de um produto, acesse como cadastrar produtos com variações.
    Clique em obter variações do e-commerce para trazer para o Tiny as variações existentes na plataforma e vinculá-las às categorias no Tiny.

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

13. Na aba custos, são definidos os custos de comissão cobrados pelos pedidos do marketplace. Defina se a base de cálculo da comissão irá considerar o valor total da venda (considerando o valor do frete no cálculo) ou o total da venda sem o valor do frete.

14. Não esqueça de salvar as configurações!

Como utilizar os recursos da integração

Nessa seção, você encontra o passo a passo para importar produtos e pedidos, enviar produtos, estoque e preços.

Como receber produtos do e-commerce no Tiny

Aqui, você encontra o passo a passo para a importação dos produtos do seu e-commerce para o Tiny.

1. Para importar os produtos cadastrados em sua loja virtual, acesse menu > cadastros > produtos > receber do e-commerce.
2. Selecione sua loja virtual no campo integração e clique em avançar. 
3. Selecione quais anúncios deseja importar todos os anúncios, apenas anúncios novos - que não estão cadastrados no Tiny - ou anúncio individual, sendo necessário o identificador do anúncio e clique em prosseguir.
4. Marque as opções de atualização dos produtos importados: 
   • Atualizar dados do produto: todas as informações do produto são atualizadas;
   • Atualizar preço dos produtos já existentes: somente o preço do produto é atualizado;
   • Atualizar o estoque: apenas o estoque do produto é atualizado;
   • Atualizar imagens: apenas as imagens do produto são atualizadas.

     Você pode também preencher os dados fiscais (unidade, NCM e origem) dos produtos. Essas são informações padrão, que serão utilizadas apenas para produtos que não possuam dados fiscais previamente cadastrados.

5. Clique em importar para concluir o processo.

Os campos importados são os seguintes:

• Código (SKU)
• Código da categoria principal no e-commerce
• Descrição
• Descrição complementar
• Descrição para SEO
• Dias para preparação
• Dimensões da embalagem
• Estoque atual
• Garantia
• GTIN
• Imagens
• Keywords para SEO
• Link do vídeo
• Marca
• Peso bruto
• Peso líquido
• Preço de custo
• Preço de venda
• Preço de venda ou promocional, caso preenchido
• Preço promocional
• Situação
• Slug
• Tags
• Título para SEO
• Variações

Como receber pedidos do e-commerce no Tiny

1. Para importação dos pedidos acesse menu > vendas > pedidos do e-commerce
2. Ou, acesse menu > vendas > pedidos de venda > receber do e-commerce.
3. 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.

Como enviar produtos do Tiny para o e-commerce

1. Acesse menu > cadastros > produtos.
2. Selecione um ou mais produtos para envio e clique em enviar para o e-commerce.

1. Selecione sua loja Bagy, no campo plataforma.
2. 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. 
3. 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.
4. Clique em enviar para concluir o envio dos produtos.

Campos enviados:

• Código (SKU)
• Código da categoria principal no e-commerce
• Descrição
• Descrição complementar
• Descrição para SEO
• Dias para preparação
• Dimensões da embalagem
• embalagem
• Estoque atual
• Garantia
• GTIN
• Imagens
• Keywords para SEO
• Link do vídeo
• Marca
• Peso bruto
• Peso líquido
• Preço de custo
• Preço de venda
• Preço promocional
• Situação
• Slug
• Tags
• Título para SEO
• Variações

Será apresentada a tela resumo do envio. Clique em revisar para avaliar as informações do produto ou finalizar para concluir o processo.

Como enviar estoque dos produtos no Tiny ao e-commerce

1. Acesse menu → cadastros →produtos.
2. Selecione um ou mais produtos para envio.
3. Clique em mais ações → enviar estoque para o e-commerce.

4. Selecione sua loja Bagy, no campo plataforma.
5. 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.
6. Valide se o produto está com as informações corretas e clique em enviar.

Como enviar o preço dos produtos no Tiny ao e-commerce

1. Acesse menu → cadastros →produtos.
2. Selecione um ou mais produtos para envio.
3.  Clique em mais ações → enviar preços para o e-commerce.

4. Selecione sua loja Bagy, 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.
5. Valide se o produto está com as informações corretas e clique em enviar.

Sincronizar situação dos pedidos

Para sincronizar a situação dos pedidos, é necessário que o mapeamento das situações tenha sido feita, ao configurar a integração.

1. Acesse menu > vendas > pedidos do e-commerce.

2. Selecione a loja virtual e marque os pedidos que já foram enviados e clique em Sincronizar situação.

   Observação:

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

Como marcar pedidos como entregue

1. Acesse menu > vendas > expedição.

2. Selecione a forma de envio e na aba concluídas, clique no menu de contexto (...) da expedição e em seguida em marcar pedidos como entregue.

3. Ao acessar a expedição será adicionado um marcador que identifica que a venda foi marcada como entregue também na plataforma.

Como enviar o código de rastreio para a plataforma

1. Acesse início > vendas > expedição.
2. Adicione o filtro por forma de envio e selecione a forma de envio Correios, na aba concluídas, clique em menu de contexto (...) > enviar código de rastreio para o e-commerce.
3. Ao acessar a expedição será adicionado um marcador que identifica quando o código de rastreio já foi enviado à plataforma.

Informação adicional

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 essa ação, depois de concluída, não poderá ser desfeita.