BConnector
Central de Ajuda
5 min de leitura

Grupos de Integração

Organize quais contas devem espelhar estoque

Os Grupos de Integração são o coração da plataforma. Eles definem quais das suas contas Bling devem compartilhar estoque entre si. Sem um grupo, cada conta opera isolada — com grupo, qualquer venda em uma conta baixa o saldo equivalente em todas as outras do mesmo grupo.

Tela de grupos de integração
Cada grupo define quais contas espelham estoque entre si

Quando criar um grupo

Cria um grupo sempre que duas ou mais contas Bling representam o mesmo estoque físico. Exemplos:

  • Você vende em dois marketplaces diferentes (cada um com sua conta Bling) mas o estoque sai do mesmo galpão.
  • Tem duas empresas (CNPJs) que compartilham produtos e quer evitar venda duplicada.
  • Tem uma conta "PJ" e uma "MEI" com tetos diferentes mas o produto físico é o mesmo.

O que NÃO precisa de grupo

Se você tem duas contas Bling com estoques físicos completamente separados (galpões diferentes, produtos diferentes), não conecte elas no mesmo grupo. A plataforma ainda monitora as duas, mas não tenta espelhar nada.

Criar um grupo

1

Clique em "Novo Grupo"

Botão no canto superior direito.
2

Dê um nome descritivo

Use nomes que façam sentido pro seu negócio: "Galpão SP", "Estoque Eletrônicos", "CNPJ Principal + Filial RJ". Você pode editar depois.
3

Selecione as contas que vão participar

Marque cada conta Bling que deve compartilhar estoque com as outras desse grupo. Cada conta só pode estar em um grupo por vez.
4

Defina a estratégia de propagação

Escolha o comportamento padrão do grupo:
  • Saldo zerado pra todos: quando o estoque acaba em uma conta, é zerado nas outras (recomendado pra evitar overselling).
  • Espelho proporcional: mantém a mesma quantidade exata em todas as contas.
5

Salve e aguarde a sincronização

Ao salvar, o sistema faz uma sincronização inicial pra alinhar os estoques. Pode levar alguns minutos dependendo do volume.

Como o Sentinel evita loops

Sem proteção, ligar duas contas diretamente causa loops infinitos: a conta A dispara um webhook, a B recebe, a B dispara outro webhook, a A recebe...O Sentinel é o componente que rompe esse ciclo: cada evento recebe uma assinatura, e movimentos que são reflexo de outro evento são ignorados automaticamente.

Por que isso importa pra você

Você nunca vai ver "mil sincronizações em um minuto" aqui. Mesmo com várias contas no mesmo grupo, o trabalho é o mínimo necessário. Isso protege os limites da API do Bling e mantém o sistema rápido.

Editar um grupo

Clique no grupo na listagem pra abrir as configurações. Você pode:

  • Adicionar/remover contas (recalcula sincronização).
  • Trocar a estratégia de propagação.
  • Pausar o grupo temporariamente (mantém as configurações mas para de espelhar).
  • Excluir o grupo (não exclui as contas, só desfaz o vínculo).

Perguntas frequentes

Posso ter uma conta em mais de um grupo?

Não. Cada conta Bling pertence a, no máximo, um grupo. Se uma conta precisa compartilhar estoque com várias outras, todas devem estar no mesmo grupo.

O que acontece se eu adicionar uma conta nova a um grupo existente?

O sistema usa o estoque atual do conjunto como referência. Por padrão, ele "puxa pra baixo": se a conta nova tem 100 unidades e o grupo tem 10, a nova passa a ter 10 também (pra evitar overselling).

Posso ver o histórico de sincronizações do grupo?

Sim. Abra o grupo e clique em Histórico — ou vá direto no módulo Histórico e filtre pelo nome do grupo.