Bagy
A integração com a Bagy foi desenvolvida pelo ERP e permite que você gerencie os produtos e pedidos da sua loja.
Para uma melhor experiência no ERP, prepare sua conta e, em seguida, siga os passos para configurar a integração.
Se sua integração já está configurada, confira o passo a passo dos recursos disponíveis.
- Acesse o site da Bagy.
Recursos disponíveis
| Receber produtos | ✔ |
| Receber pedidos | ✔ |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | ✔ |
| Sincronizar situação | ✔ |
| OMS | ✔ |
Como adicionar e configurar a integração
- Acesse menu > início > Integrações.
- Clique em adicionar integração.
- Busque por Bagy e clique em instalar.
Siga os passos para configurar sua integração:
- Na aba Integração, informe o nome da sua loja.
- Na seção Autenticação, você precisa informar o token gerado na Bagy. Para isso:
- Acesse seu painel na Bagy e clique em Aplicativos, na lateral esquerda da tela.
- Em seguida, clique em Loja de aplicativos.
- Procure por ERP e clique em instalar aplicativo.
- Após instalado, clique sobre o ERP e copie o token integração ERP.
- Retorne ao ERP e cole o código no campo Token.
- Clique em testar configurações para validar os dados.
- Na aba Configurações, defina as opções.
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 ERP) ou apenas importar a URL externa das imagens (traz para o ERP 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 ERP. 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 ERP. |
| 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 ERP 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 ERP | Ao habilitar esse parâmetro, sempre que a situação do pedido for alterada para entregue no ERP, 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 ERP, 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. |
Na aba estoque, defina as regras de estoque para a integração:
| Atualizar estoque na loja virtual a partir do ERP |
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. |
- 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 ERP 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.
- Na aba categorias, faça o mapeamento das categorias de produtos no ERP 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 ERP. 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 ERP, 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 produtos.
- Para que o envio dos produtos para o e-commerce ocorra com sucesso, é necessário que o mapeamento das categorias do ERP e da plataforma esteja feito, assim, ao sincronizar os produtos, eles serão corretamente vinculados.
- Na aba situações, é possível relacionar a situação dos pedidos no e-commerce com as respectivas situações no ERP, assim como o fluxo da sequência das situações no ERP.
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ções:
- Se você utiliza o recurso OMS, sugerimos que mantenha o parâmetro 'permite retroceder situação dos pedidos na sincronização de situações' desabilitado.
- Ao importar um pedido de venda do e-commerce para o ERP, o pedido assume a situação configurada. Caso a situação não esteja configurada, o pedido importado vai ter a situação em aberto atribuída.
- Na aba formas de recebimento, pode-se relacionar as formas de recebimento dos seus pedidos da loja virtual com a forma de recebimento no ERP. Esta configuração fará com que suas contas a receber sejam geradas no ERP com as mesmas informações da plataforma.
Observação:
Ao adicionar as formas de recebimento selecionadas, o ERP busca as formas já configuradas em sua conta. Para informações de como cadastrar as formas de envio, acesse formas de recebimento.
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 ERP. Para isso, clique em adicionar forma de recebimento.
A seguir, no campo de forma de recebimento, selecione a forma de recebimento do ERP 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 ERP.
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.
Observação:
Ao importar um pedido de venda do e-commerce para o ERP, o pedido assume a forma de recebimento mapeada. Caso a forma de recebimento não esteja configurada, o pedido importado terá a forma de recebimento padrão atribuída.
- Na aba variações: são relacionadas as variações de um produto no e-commerce com as respectivas variações no ERP. 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 ERP as variações existentes na plataforma e vinculá-las às categorias no ERP.
Observação:
A aba variações somente aparecerá com a extensão variações instalada e após salvar as configurações.
- 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 ERP.
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 ERP 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 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.
Observação:
A aba custos somente aparecerá com a extensão custos instalada.
- 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 ERP
Aqui, você encontra o passo a passo para a importação dos produtos do seu e-commerce para o ERP.
- Para importar os produtos cadastrados em sua loja virtual, acesse menu > cadastros > produtos > receber do e-commerce.
- Selecione sua loja virtual no campo integração e clique em avançar.
- Selecione quais anúncios deseja importar todos os anúncios, apenas anúncios novos - que não estão cadastrados no ERP - ou anúncio individual, sendo necessário o identificador do anúncio e clique em prosseguir.
- 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.
- Clique em importar para concluir o processo.
Observações:
- A opção criar exceções de preços será exibida se a regra de preço da integração for definida conforme lista de preços. Ao marcar essa opção, os produtos que estão na lista de produtos com preços diferentes serão criados e atualizados. Saiba mais em listas de preços.
- Se durante a importação dos produtos ocorrer algum imprevisto e for necessário interromper a ação ou então ocorrer algum problema devido ao grande número de produtos a serem importados, é possível "interromper" a recepção de produtos para continuar a importação num momento posterior.
- Com a ação interromper, é possível continuar a importação num outro momento, continuando do ponto em que parou. É possível retomar esta importação em até 7 dias corridos.
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 ERP
- 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.
Como enviar produtos do ERP 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 Bagy, 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:
- 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.
Observações:
- Os campos sincronizados devem ser alterados somente no ERP. Caso você altere alguma destas informações no painel de controle da sua loja virtual, elas serão sobrescritas pelos dados cadastrados no ERP assim que rodar a próxima rotina de sincronização.
- Para o envio de variações para a plataforma, é permitido enviar itens com no máximo 3 grades de produtos, sendo que, uma dessas grades deverá ser, obrigatoriamente, uma grade de cor. Veja como cadastrar um produto com variações.
- As variações do tipo cor terão suas imagens enviadas para a plataforma.
- Para enviar a lista completa dos produtos no ERP para o e-commerce, acesse a ajuda enviar produtos em lote ao e-commerce.
Como enviar estoque dos produtos no ERP ao e-commerce
- 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 Bagy, 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 enviar o preço dos produtos no ERP ao 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 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. - 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.
Acesse menu > vendas > pedidos do e-commerce.
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 ERP corresponderá à situação do pedido no e-commerce, conforme o mapeamento realizado.
Como marcar pedidos como entregue
Acesse menu > vendas > expedição.
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.
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
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, na aba concluídas, clique em menu de contexto (...) > enviar código de rastreio para o e-commerce.
- Ao acessar a expedição será adicionado um marcador que identifica quando o código de rastreio já foi enviado à plataforma.
Observação:
Ao enviar o código de rastreio, o status dos pedidos são alterados para enviado na 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 ERP. Lembramos que essa ação, depois de concluída, não poderá ser desfeita.
