Tag Archives: bling api

Integração Bling API – Como configurar

Nesse post iremos apenas explicar em detalhes como realizar a configuração para integração entre a loja virtual da Brasil na Web e o Bling através da API.

Caso queira ver uma explicação geral sobre o funcionamento da integração, acesse Integração Bling API – Como funciona.

BLING

1- Usuário de acesso

O primeiro passo é criar um usuário do tipo API e liberar as permissões necessárias. Clique aqui para criar o usuário no Bling. Você deverá selecionar “Usuário API” e selecionar as seguintes permissões:
– Cadastros > Clientes e Fornecedores > Inclusão e Edição
– Cadastros > Produtos > Inclusão e Edição
– Cadastros > Integrações e Lojas Virtuais > Inclusão e Edição
– Suprimentos > Depósitos de estoque
– Vendas > Pedidos de Venda

2- Configuração de integração

É preciso realizar as configurações para integração dos produtos e pedidos. Acesse sua lista de lojas no Bling, procure por “api” e clique sobre a opção “Bling API”.

Na aba Autenticação preencha um nome para identificar a loja.

Na aba Callbacks, ative as opções como na imagem abaixo. A URL de estoque deve ser https://www.SEUDOMINIO/bling/api/estoque e a URL de pedidos deve ser https://www.SEUDOMINIO/bling/api/pedido. SEUDOMINIO deve ser substituído pelo domínio da sua loja.

OBS.: Se você não precisar receber notificação de atualização de status dos pedidos do Bling, você pode deixar o callback de pedidos de venda desativado.

Por fim, clique em Salvar e depois clique sobre a loja criada. Agora nessa tela o Código da loja API Bling estará preenchido. Copie esse código porque ele será necessário na configuração da loja.

O próximo passo é acessar as configurações para lojas virtuais e verificar o seguinte item:

  • Na importação através da API, buscar produtos por código ou descrição. Ele deve ser marcado com a opção Código.

3- Estoque

O normal quando se utiliza a integração com o Bling é que ele passe a ser o sistema que centraliza a informação de estoque, já que ele controla tanto a entrada de produtos (compra) quanto as saídas (pedidos), tanto para loja física quanto para loja virtual.

Para isso, é preciso realizar algumas configurações no Bling:
1- Se você quiser que o Bling já considere os pedidos “Em Aberto” (ex.: Aguardando pagamento) no cálculo do estoque, acesse as configurações de estoque e habilite o campo É importante habilitar a reserva de estoque de acordo com o status dos pedidos. Maiores detalhes nesse tutorial de ajuda do Bling sobre reserva de estoque.

2- Lançamento automático de estoque. Depois que um pedido sai do status de “estoque reservado” (ex.: aguardando pagamento), o estoque do pedido precisaria ser lançado para que ele seja realmente contabilizado como “baixa” no Bling. Você pode fazer isso manualmente ou pode configurar isso de forma automática, utilizando a ferramenta Gerenciador de Transição disponível no Bling.

3- Na loja virtual, dentro das configurações do Bling, será preciso desabilitar a opção Enviar estoque para o Bling ao exportar produtos, para que assim o Bling sempre mantenha o estoque correto.

IMPORTANTE: Se você não quiser que o Bling controle o estoque da loja, você pode desabilitar o Callback de estoque configurado no passo 2 – Configuração de integração.

 

LOJA VIRTUAL

No painel administrativo da loja, acesse Menu > Recursos >  Barra de pesquisa > Bling API.

Preencha os campos de Chave API e Código da loja API gerados nos passos anteriores e clique em Salvar.

A tela será recarregada agora como mais campos para configuração.

Para os campos da loja virtual não existe uma configuração “correta”, você deve preencher de acordo com o que for mais conveniente para o seu fluxo de trabalho. Entre outras coisas, você poderá:

– Bloquear a sincronização de algumas informações se quiser (ex.: nome do produto, descrição, preço, estoque)
– Definir qual depósito de estoque (Bling) será utilizado para manter o estoque dos produtos da loja. Dessa forma, você pode ter no Bling um depósito exclusivo para o estoque da loja virtual
– Definir se a loja deve ou não enviar o valor do frete do pedido
– Definir se a loja deve ou não enviar o valor do desconto do pedido
– Definir em que status o pedido é enviado ao Bling
– Definir em que status o pedido é atualizado no Bling e vice-versa (do Bling para a loja)
– Definir a correspondência/mapeamento dos status entre Bling e loja

Este artigo foi útil para você?!

Integração Bling API – Como funciona

Nesse post iremos apenas explicar em linhas gerais como funciona a integração entre a loja virtual da Brasil na Web e o Bling através da API.

Caso queira ir direto para a configuração da integração, acesse Integração Bling API – Como configurar.

REQUISITOS

  1. Ter uma conta criada no Bling no mínimo no plano Cobalto, que é o plano que permite uso de API
  2. Todos os produtos e opcionais precisam ter SKU já cadastrados na loja virtual.

FUNCIONAMENTO

Sincronia dos produtos

Com os produtos já cadastrados, é possível sincronizar os dados dos produtos do Bling para loja e vice-versa a qualquer momento.
Por padrão, apenas o estoque é sincronizado de forma automática. Para sincronizar outras informações, como nome, descrição e preço, é preciso usar a função de importação/exportação manualmente a partir do painel da loja virtual.

Sincronia dos pedidos

É possível definir em que status o pedido é enviado para o Bling. Depois disso, é possível também enviar ao Bling atualizações de status do pedido conforme o status do pedido na loja virtual. A loja também é capaz de receber atualizações de status a partir do Bling.
Abaixo exemplo de como recomendamos que fique a integração:
– Assim que o pedido é recebido na loja ele é enviado ao Bling, com status de “Em Aberto”. Isso é importante porque quando o Bling recebe o pedido, ele já fica ciente de que o estoque desse produto está reservado
– Quando o pedido é pago na loja, ele pode ser alterado no Bling para “Em Andamento”. Nesse ponto você pode realizar a geração da NFe.
– Quando o pedido é cancelado na loja, ele pode ser alterado no Bling para “Cancelado”, liberando então o estoque do produto
– Caso o código de rastreamento seja gerado no Bling, a loja pode receber esse código e informar o cliente quando o pedido for enviado, mantendo também outras notificações sobre o rastreamento do pedido

Sincronia de clientes

O cadastro do cliente é enviado ao Bling junto do pedido. Caso o cliente já esteja cadastro no Bling com o mesmo CPF/CNPJ da loja virtual, a loja vincula o pedido a esse cliente. Do contrário, um novo cadastro de cliente é criado no Bling.
A loja nunca importa cadastro de clientes do Bling.

Sincronia de estoque

A informação de estoque é centralizada no Bling, porque é nele que são lançados os pedidos de compra/entrada de novas unidades do produto.
Sempre que você realiza uma mudança de estoque manualmente no Bling ou quando você lança um novo pedido de compra ou quando o Bling recebe um pedido através de outras integrações, o Bling envia pra loja uma notificação para informar sobre a atualização de estoque do produto. Esse é o único momento em que o Bling envia a situação de estoque pra loja. Em outras palavras, sempre que o Bling identifica que o estoque foi alterado no sistema deles, a loja é notificada.
A loja por sua vez, nunca envia estoque do produto ao Bling de forma automática, até porque o responsável por manter o estoque real do produto é o Bling e não a loja virtual. Apesar disso, é possível enviar o estoque do produto da loja para o Bling de forma manual usando a função de exportar produtos.

Configurações

A loja permite configurar várias informações referentes à integração:
– Você poderá bloquear a sincronização de algumas informações se quiser (ex.: nome do produto, descrição, preço, estoque)
– Você pode definir qual depósito de estoque (Bling) será utilizado para manter o estoque dos produtos da loja. Dessa forma, você pode ter no Bling um depósito exclusivo para o estoque da loja virtual
– Enviar ou não o valor do frete do pedido
– Enviar ou não o valor do desconto do pedido
– Definir em que status o pedido é enviado ao Bling
– Definir em que status o pedido é atualizado no Bling e vice-versa (do Bling para a loja)
– Definir a correspondência/mapeamento dos status entre Bling e loja

Outras considerações

Para produtos com opcionais, o Bling não armazena o estoque do produto principal, então o estoque do principal seria o somatório dos opcionais. Na loja isso não ocorre de forma automática, mas é possível habilitar isso na integração. Se você tiver no máximo um opcional por produto, isso não trará nenhum problema. Por outro lado, se você tiver um produto com dois tipos de opcional (ex.: cor x tamanho), a integração de estoque pode trazer problemas.

Este artigo foi útil para você?!