Integração do Bling V3 com a Irroba (Novo Dashboard)

Somos parceiros do Bling V3, uma plataforma de gestão empresarial que facilita a administração de lojas online, oferecendo controle total sobre estoque, pedidos, vendas e financeiro em um único ambiente.

Confira o guia abaixo e simplifique a gestão do seu e-commerce com a nossa integração:

Lembrando que, para realizar a integração, é necessário possuir uma conta ativa no ERP Bling.

Link para o Vídeo com o passo a passo da Integração 📎

1. Configurando Aplicativo:

Na página inicial do Bling, clique em “Central de extensões”, localizado no canto superior direito.

Na página seguinte, clique em “Área do Integrador”, localizada no canto superior direito.

Clique no botão “Criar novo aplicativo”.

Nas configurações iniciais do aplicativo, mantenha as opções padrão selecionadas (API e Privado) e clique em “Próximo”.

Na etapa seguinte, configure os campos de identificação e descrição do aplicativo:

Logo: Opcional. Caso deseje adicionar a logo da sua loja ou da Irroba, a imagem precisa estar no formato .svg.

Nome: Esse campo identifica o aplicativo dentro do Bling. Recomendamos inserir o nome da sua loja ou “Irroba”.

Categoria: Selecione a opção “Plataforma de E-commerce”.

Descrição: Insira uma breve descrição da sua loja ou, se preferir, apenas um ponto "." para prosseguir.

Descrição curta: Esta descrição será exibida na visualização resumida do aplicativo na Central de Extensões. Recomendamos que seja escrito “Plataforma de E-Commerce”, para sua identificação.

Abaixo dessas configurações, há o campo “Link de Redirecionamento”. O valor correto para este campo está disponível no aplicativo Bling V3 dentro da nossa plataforma. Acesse a aba de Aplicativos, busque por “Bling V3” e clique no resultado da pesquisa.

Você poderá copiar o link clicando no ícone disponível no campo “URL de Redirecionamento”.

Após copiar, cole essa URL no campo “Link de Redirecionamento” no Bling.

No campo “Lista de Escopos”, serão configuradas as permissões da integração. Clique em “Adicionar” e selecione todas as opções exibidas para garantir o funcionamento completo da integração. Em seguida, clique novamente em “Adicionar”.

Por fim, preencha os campos de “Informações para contato” e clique em “Salvar dados básicos”.

Depois de salvar, role a página para cima e acesse a nova aba “Informações do app”. Nela, serão exibidos os campos Client ID e Client Secret, que são as credenciais necessárias para completar a integração com a nossa plataforma.

Copie o Client ID e cole no campo correspondente dentro do aplicativo Bling V3 em nossa plataforma. Faça o mesmo com o Client Secret.

Depois de inserir esses dados, dê um nome à integração, habilite a opção “Status da integração” e clique em Integrar.

Após clicar no botão, uma nova página será exibida. Caso apareçam erros, isso significa que sua conta Bling não possui permissão para algumas das funcionalidades solicitadas. Nesse caso, será necessário remover os escopos que estão gerando o erro.

Por exemplo, se a conta não tiver acesso à funcionalidade de “Ordens de Produção”, será necessário acessar novamente a configuração dos escopos, clicar em “Adicionar Escopo”, buscar pela permissão principal (“pai”) e desmarcar todas as opções relacionadas. 

Após isso, clique em “Adicionar” e depois em “Salvar dados básicos”, aceitando os termos.

Feito isso, retorne à página de autorização da integração e pressione a tecla F5 para atualizar. O botão de autorização será exibido corretamente, desde que todas as permissões estejam em conformidade.

2. Configurando API

Agora é necessário configurar a API, que será responsável por enviar as informações do Bling para a nossa plataforma.

Para isso, volte à tela inicial do Bling e acesse o ícone de “Central de extensões”

Acesse a aba de “Integrações” e na barra de pesquisa, digite “api” e clique na opção “API - Em Outro”.

Na tela seguinte, dê um nome à API, como, por exemplo “IrrobaAPI”, e clique em Salvar.

Em seguida, role a página até a seção “Outro”, localize a API recém-criada e clique para acessá-la.

Copie o valor do campo “Código da loja API Bling” e cole no campo correspondente “Código da Loja” dentro do aplicativo Bling V3 em nossa plataforma.

Depois, na mesma página da API no Bling, vá até a aba “Callbacks” e selecione “JSON” no campo “Tipo de retorno no callback”.

Agora, retorne ao aplicativo do Bling V3 em nossa plataforma e copie os links de callback para:

• Estoque (caso deseje que o estoque seja atualizado automaticamente do Bling para a nossa plataforma);
  
   
• Pedidos;
  
   
• Notas fiscais (neste caso, é necessário aceitar o termo de cobrança de R$ 0,30 por nota emitida).

Cole cada URL no campo correspondente na API do Bling: estoque no campo de estoque, pedidos no campo de pedidos, e assim por diante. Ao finalizar, clique em Salvar.

Por fim, retorne ao aplicativo Bling V3 em nossa plataforma e clique em Salvar novamente.

3. Configurações Bling

Cada loja possui regras próprias, por isso as configurações da integração podem variar conforme as necessidades específicas da operação.

• ESTOQUE:

Depósitos: Selecione o depósito que deseja utilizar. Ex.: se você possui um para loja física e outro para loja virtual, escolha qual será sincronizado. Caso não tenha, deixe como “Geral”.

Nota: Certifique-se de que o depósito esteja cadastrado no Bling.

Atualizar Estoque: Habilite esta opção se a Irroba for utilizado como estoque principal. Neste caso, a Irroba enviará as informações de estoque para o Bling.

Utilizar Estoque Virtual: Ao ativar esta opção, o sistema passará a considerar o estoque virtual, que já desconsidera as unidades reservadas.
Por exemplo: se há 5 unidades cadastradas no Bling e 2 estão reservadas, o estoque virtual disponível será de 3 unidades.

Essa configuração também é essencial caso o Bling seja utilizado como sistema principal de controle de estoque.

Criar variações não encontradas: Ao exportar um produto existente, se for detectada uma nova variação, ela será criada automaticamente no Bling.

• PRODUTO:

Atualizar informações dos produtos no Bling: Envia ao Bling todas as atualizações feitas no Irroba quando o produto é exportado.

Exportar produto com referência das variações: Exporta os códigos de referência das variações como códigos distintos de cada variação no Bling.

 

Exportar GTIN das variações para o Bling: Ao ativar esta opção, o valor informado no campo "Referência" de cada variação será exportado para o Bling como GTIN.

É importante garantir que o GTIN informado seja válido, pois, caso contrário, o produto não será exportado com sucesso.

Clonar informações do produto pai: Quando essa opção está habilitada, o Bling ativa automaticamente a função "Utilizar informações do produto pai" ao criar as variações de um novo produto. 

Importar marca dos produtos: Com essa funcionalidade ativa, ao importar um produto do Bling para a Irroba, a informação da "Marca" também será trazida e vinculada corretamente ao produto na plataforma.

Delimitador de Exportação: Neste campo, você pode definir um caractere para separar o código do produto do código de variação.

Por exemplo, se você utilizar o caractere “-”, o código será exportado da seguinte forma: TESTE-40

• PEDIDO:

• Direcionamento personalizado de pedidos: 

Essa opção permite configurar regras para o direcionamento de pedidos entre diferentes contas do Bling, com base em critérios como estado de destino ou valor do pedido.

Exemplo: pedidos com entrega em São Paulo podem ser direcionados para a conta 1, enquanto os demais vão para a conta 2.

• Enviar para o Bling:

Exportar Pedidos Automaticamente: Exporta todos os pedidos automaticamente para o Bling, independentemente do status de pagamento.

Exportar Automaticamente Somente Pedidos Aprovados: Exporta automaticamente apenas pedidos com pagamento aprovado.

Exportar Pedido com Irroba ID: Mantém o mesmo ID utilizado na Irroba ao exportar o pedido para o Bling.

Atenção: se sua conta Bling também estiver integrada a outros marketplaces ou lojas, pode haver conflito de ID, o que pode resultar em erro na exportação.

Emitir Notas Fiscais Automaticamente: Permite a emissão automática de notas fiscais no Bling após a exportação do pedido.

Enviar Peso Bruto: Transfere o peso bruto dos produtos da Irroba para o Bling.

Enviar quantidade de Volumes do pedido: Por padrão, a Irroba envia como quantidade de volumes a soma dos itens do pedido.

Com esta opção ativada, será utilizado o campo "Quantidade de Volumes" existente nos pedidos da plataforma (preenchido por padrão com o valor 1).

• Status dos pedidos para Irroba:

Essa configuração é essencial para manter a sincronização dos status dos pedidos entre o Bling e a plataforma Irroba.

• A coluna da esquerda representa o status que será atualizado na Irroba.
  
   
• A coluna da direita mostra o status correspondente no Bling.
  
   

Exemplo: conforme ilustrado na imagem abaixo, se o pedido for marcado como “Atendido” no Bling, a plataforma Irroba atualizará automaticamente para o status “Emissão de Nota Fiscal”.

• Métodos de Pagamento: A configuração desse campo é abordada em um artigo complementar.

Caso deseje que a "Forma de Pagamento" seja enviada automaticamente para o Bling e conste na nota fiscal emitida, recomendamos que você realize essa configuração.

Link do artigo: Configuração Métodos de Pagamento para o Bling V3 📎

• Receitas:

Estas configurações são utilizadas para mapear corretamente as receitas entre a plataforma Irroba e o Bling.

Durante a exportação de um pedido, essas definições garantem que as informações financeiras sejam lançadas corretamente no ERP.

Lucas Vizoto - Time de Suporte

Irroba E-commerce