Bagy
A integração com a Bagy permite gerenciar os produtos e pedidos da sua loja diretamente pelo ERP.
Para uma melhor experiência, antes de iniciar a configuração, prepare sua conta e siga o passo a passo deste artigo.
Caso a integração já esteja configurada, consulte as seções abaixo para conhecer os recursos disponíveis e como utilizá-los.
Para mais informações, acesse o site da Bagy.
Recursos disponíveis na integração
| Receber produtos | ✓ |
| Receber pedidos | ✓ |
| Enviar produtos | ✓ |
| Enviar estoque | ✓ |
| Enviar preços | ✓ |
| Sincronizar situação | ✓ |
| OMS | ✓ |
Como instalar a integração passo a passo
- Acesse menu > início > Integrações.
- Clique em adicionar integração.
- Busque por Bagy e clique em instalar.
- 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.
Como configurar Bagy no ERP
Acesse o artigo Como configurar uma integração para saber mais sobre a configuração.
Aba Produtos
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. |
Limite de variações de produtos na integração com a Bagy
Para garantir uma sincronização estável entre o ERP e a Bagy, a integração passou por uma atualização que definiu um limite máximo de variações por produto.
Qual é o limite?
Cada produto (SKU pai) pode ter até 150 variações cadastradas.
Caso esse limite seja ultrapassado, o envio do produto para a Bagy será bloqueado automaticamente, evitando falhas de sincronização e inconsistências nos dados.
Como funciona a validação?
Sempre que você enviar ou atualizar um produto na Bagy, o sistema realiza uma verificação automática:
- Conta a quantidade total de variações cadastradas no produto
- Se o número for maior que 150, o envio é interrompido
Mensagem exibida: “Limite de 150 variações atingido para o produto {nome_do_produto}.”
Atenção: se você vende produtos com muitas combinações (como cor, tamanho e material), recomendamos:
- Fracionar o cadastro do produto
Crie produtos separados no ERP para reduzir a quantidade de variações por item.
Exemplo:
- Camiseta Masculina Algodão
- Camiseta Masculina Poliéster
Assim, cada produto permanece dentro do limite permitido.
- Revisar variações inativas
Verifique se existem variações sem estoque, descontinuadas ou que não são mais utilizadas.
Essas variações podem ser removidas antes do envio.
Aba Pedidos
Etapa para definir as regras no fluxo de recebimento dos pedidos da plataforma para o sistema ERP.
Importante:
- Ao importar um pedido do e-commerce para o ERP, o pedido utilizará a forma de recebimento mapeada.
- Caso não exista um mapeamento, o pedido será importado com a forma de recebimento padrão.
| 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. |
| 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. |
Aba Variações
Nesta aba, são exibidas as variações do produto no e-commerce e o vínculo com as respectivas variações no ERP.
A aba variações somente aparecerá com a extensão variações instalada e após salvar as configurações.
Para sincronizar as variações:
- Clique em Obter variações do e-commerce
- As variações existentes na plataforma serão importadas para o ERP
- Realize o vínculo com as categorias correspondentes
Para mais informações, consulte o artigo como cadastrar produtos com variações.
Como usar o ERP com Bagy
Acesse o artigo Como usar uma integração no dia a dia para saber mais sobre o uso e descobrir como aproveitar ao máximo a integração.
