Essa é a versão mais atual de integração com Bling, onde tratamos algumas melhorias na sincronização de catálogo e performance nos demais fluxos.

Autenticação

A primeira etapa consiste em autenticar a integração no painel Vnda, para isso irá precisar de um login e senha de acesso a conta do Bling.

No painel Vnda, acesse: Configurações > Integrações > Bling.

O botão “Conectar” vai direcionar para uma nova aba onde deve preencher com o login e senha do Bling.

Com a Autenticação realizada, acessar o painel do Bling em Integrações > Configurações de integração com lojas virtuais e marketplaces.

Na lateral direita estará o campo de pesquisa em Pesquise por integrações, aplicativos e serviços. Busque por "API", e instale a integração.

Após salvar, volte na integração em Minhas Instalações e copie o Código da loja API Bling em um bloco de notas, precisaremos dele nos próximos passos.

HUB Vnda

No painel Vnda da loja acessar em: Configurações > Sistemas ERP. Clique no botão "adicionar nova integração" e preencha os dados a seguir:

Integração: Bling 3
Host: preencher com o host da loja em produção
Loja: preencher com Código da loja API Bling identificado na etapa anterior
Faturar pedido: selecionar “sim” apenas o seller desejar emissão automática de NF
Enviar nf: Se a etapa anterior for 'Sim”, selecionar o tipo de NF que será emitida e enviada para o Sefaz automaticamente
ID da situação: serve para atualizar automaticamente a situação de pedido no Bling logo que for criado, situações possíveis:
6 - Em aberto
9 - Atendido
15 - Em andamento
Inserir apenas o número correspondente a situação desejada pelo cliente.
Salvar personalização de produto como:
As personalizações possuem alguns valores possíveis:
Não salvar
Item
Extra
Valor
Não usar as opções Não salvar e Extra caso a customização tenha algum custo, irá apresentar erro para integrar.

Para situações de pedidos customizadas é necessário inspecionar a página clicando com o botão direito sobre a situação destino desejada:

Com o ponteiro do mouse exatamente sobre o nome da transição ao inspecionar já irá abrir a página no local onde consta o ID da situação e seu nome:

Ao usar o ID 72430 irá vincular a situação "Teste" neste exemplo.

Contribuinte: vendas b2c, por padrão, devem utilizar opção "9 - Não contribuinte..."

Natureza da operação (id): acessar o Bling em Notas Fiscais > Natureza da Operação. Abrir o cadastro que for padrão venda, na Url vai ter o ID.
Campo de estoque:
Código dos depósitos: acessar o menu Preferências > Todas as Configurações > Suprimentos > Depósitos de estoque, e pressione F12 para inspecionar os elementos.
Clique na aba Network e depois clique sobre o nome do depósito a integrar. Haverá o elemento depositos.server.php?f=obterDeposito, clicando sobre ele há o campo Id para inserir como Código dos depósitos.

Situação equivalente a embalado: preencha com o nome da situação no bling
Situação equivalente a em transito: preencha com o nome da situação no bling
Situação equivalente a entregue: preencha com o nome da situação no bling

Diferenças entre atualizações de ciclos:

Físico: não seleciona a reserva de estoque dos produtos. É o saldo "real" do produto.
Virtual: seleciona a reserva de estoque dos produtos. É o saldo "real" + saldo com reservas dos produtos.

Para atualizar o estoque por ciclos é necessário importar a listagem de produtos na aba Mapeamentos.

Sem essa importação não irá ocorrer a sincronização dos produtos.

Cadastro de Callbacks

3.2 Callback para atualização de estoque:

Ainda nas preferências da conta, acesse o menu Integrações;
Clique em Configurações de integração com lojas virtuais e marketplaces;
Clique na integração criada na etapa de Autenticação, Integração Vnda;
Acesse o menu Callbacks;

Selecione na configuração de "Tipo de retorno no callback" a opção "JSON"
Acione o botão Callback de estoque
Preencha o campo com a URL de estoque da seguinte forma:

https://hub.vnda.com.br/api/stocks/bling3/notification?shop_host=urldaloja

Lembre-se de alterar a URL para informar o shop host correto!

Monitoramento desse recurso: https://dashboard.ops.olist.io/d/Ro9K-W-4k/hub-metricas?orgId=1&from=now-24h&to=now

3.2 Callback de pedidos de venda:

Os pedidos serão atualizados na Vnda conforme o nome das situações de pedido Bling configurados na primeira etapa desse artiigo. Ainda na mesma integração criada no Bling, ative a opção Callback de pedidos de venda. Adicione a seguinte URL de notificação:

https://hub.vnda.com.br/api/trackings/bling3/notification?shop_host=www.urldaloja.com.br&token=tokenhub

Lembre-se de alterar o trecho "www.urldaloja.com.br" conforme host da loja e a ultima parte "tokenhub" deve ser conforme o token da loja na listagem do hub.

3.3 Callback de notas fiscais:

Nessa mesma aplicação, podemos ativar o callback de notas fiscais e preencher da seguinte forma:

https://hub.vnda.com.br/api/invoices/bling3/notification?shop_host=urldaloja

Não se esqueça de alterar a parte "urldaloja" conforme o domínio.

Mapeamento de produtos

Os mapeamentos seguem a estrutura De/Para, isto é, um campo na Vnda equivalente ao campo do Bling. O caractere "," é o separador dos campos no mapeamento. Abaixo a indicação de modelos que podem ser utilizados:

Produto Simples

reference:codigo,description:descricaoCurta,product_name:nome,sku:codigo,variant_name:nome,price:preco,width:dimensoes.largura,height:dimensoes.altura,length:dimensoes.profundidade,weight:pesoLiquido,images:midia.imagens.internas.link+midia.imagens.externas.link,external_id:id

Produto com Variação

reference:codigo,description:descricaoCurta,product_name:nome,sku:variacao.codigo,variant_name:nome,price:variacao.preco,width:variacao.dimensoes.largura,height:variacao.dimensoes.altura,length:variacao.dimensoes.profundidade,weight:variacao.pesoLiquido,property1:variacao.Tamanho,property2:variacao.Cor,images:midia.imagens.internas.link+midia.imagens.externas.link,external_id:variacao.id

Observações!

Caso a importação de imagens não funcione, altere o parâmetro de imagens para:

images:midia.imagens.internas.link -- Para caso o seller tenha cadastrado as imagens de forma interna no Bling;

images:midia.imagens.externas.link -- Para caso o seller tenha cadastro as imagens de forma externa (link) no Bling.

Os campos de "property1" e "property2" correspondem aos atributos e variam de acordo com o cadastro de cada loja. Sendo assim, recomendamos validar a ordem utilizada no Bling e aplicar a configuração de acordo na Vnda neste acesso: Configurações > Atributos.

Os mapeamentos external_id:id e external_id:variacao.id são utilizados para possibilitar a sincronização de estoque entre o Bling e a Vnda.

Após inserir estes parâmetros, é necessário realizar uma atualização da listagem de produtos no HUB, para que o mapeamento passe a valer.

⚠️ Em casos onde o cliente cadastra o produto diretamente na Vnda, sem ocorrer a importação através da integração, ainda assim é necessário incluir esse parâmetro e manter a listagem dos produtos no HUB. Não se faz necessária a importação dos produtos do HUB para a Vnda, porém eles precisam estar listados em "Produtos no ERP" (/admin/hub/produtos).

Importação de produtos Bling > Vnda

Para trazer os produtos para a Vnda, basta selecionar os produtos existentes em Admin > HUB > "Produtos no ERP", que eles serão mostrados em "Produtos disponíveis no ERP".

Caso não apareçam os produtos, é necessário clicar em Atualizar e aguardar os produtos estarem disponíveis na aba.

É importante que o botão "Atualizar" seja clicado uma única vez. Não será exibida nenhuma mensagem após este clique, porém é possível visualizar a busca pelos produtos iniciada no Sidekiq: https://hub.vnda.com.br/sidekiq

Após selecionar os mesmos, clique em "Importar Selecionados". Ao final do processo, os mesmos estarão disponíveis no e-commerce.

Para importar todos os produtos sem a necessidade de selecionar um a um, clique em "Importar todos" no canto inferior direito da página.

Mapeamento de pedidos

MEIO DE PAGAMENTO

De (Vnda): cadastre cada forma de pagamento com a nomenclatura padrão da Vnda:
- American Express - Crédito
- Diners - Crédito
- Elo - Crédito
- Hipercard - Crédito
- Mastercard - Crédito
- Visa - Crédito
- Boleto
- Pix
- Depósito
- Paypal Plus

Caso deseje realizar o mapeamento das formas de pagamento com a informação do número de parcelas, essa informação deve ser posicionada, entre parênteses, imediatamente após a descrição da forma de pagamento, seguindo o padrão definido.

Formato esperado:

Nome da Bandeira - Tipo de Pagamento (descrição do parcelamento)

Exemplos:

Mastercard - Crédito (à vista) → pagamento em 1 parcela;
Mastercard - Crédito (em 2 vezes) → pagamento em 2 parcelas;
Mastercard - Crédito (em 3 vezes) → pagamento em 3 parcelas;

Esse padrão deve ser seguido para todas as formas de pagamento que envolvam parcelamento, e é necessário repeti-lo até que todas as parcelas estejam sendo cobertas.

Para (Bling): cadastre as formas de pagamento de acordo com o ID do Bling. Para obter o ID, acesse https://www.bling.com.br/formas.pagamento.php. Dentro de cada forma de pagamento, o ID que precisamos estará na URL.
- Exemplo:
  - De: American Express - Crédito
  - Para: 69070883

Caso o seller não possua formas de pagamento cadastradas, faça o cadastro conforme abaixo:

Acesse as preferências da conta (todas as configurações da conta) e clique no menu Finanças;
Clique em Gerenciar formas de pagamento;
Depois clique no botão Incluir forma (canto superior direito);
No campo Descrição, preencha seguindo o padrão de nomenclatura da Vnda:
- American Express - Crédito
- Dinners - Crédito
- Elo - Crédito
- Hipercard - Crédito
- Mastercard - Crédito
- Visa - Crédito
- Boleto
- Pix
- Depósito
Em Tipo de pagamento, selecione a opção Outros;
Clique em Salvar.
Repita a operação para todos os meios de pagamento acima.

TIPO DE ENTREGA

De (Vnda): insira o nome cadastrado no campo Descrição da forma de entrega, que pode ser localizado na tela de edição de cada forma de entrega em https://www.nomedaloja.com.br/admin/config/entrega/regras.
🚩 Importante: letras devem ser todas minúsculas e espaços devem ser substituídos por hífen. Exemplo: Jadlog Com > jadlog-com
Para (Bling): nome da forma de entrega cadastrado no Bling, na coluna Serviço.
- Para encontrá-lo, acesse o cadastro da transportadora em Configurações de integrações logísticas no Bling;

TRANSPORTADORA

De (Vnda): insira o nome cadastrado no campo Nome da forma de entrega, que pode ser localizado na tela de edição de cada forma de entrega em https://www.nomedaloja.com.br/admin/config/entrega/regras.
Para (Bling): nome da forma de entrega cadastrado no Bling, na coluna Transportadora. (caso esteja em branco, usar a coluna Serviço).
- Para encontrá-lo, acesse o cadastro da transportadora em Configurações de integrações logísticas no Bling;

CÓDIGO DA TRANSPORTADORA

De (Vnda): insira o nome da forma de entrega cadastrado no campo Nome do app Shipping Vnda (shipping.vnda.com.br).
Para (Bling): será necessário clicar no ícone de lápis ao lado do nome da forma de entrega para visualizar suas configuração, no fina da lista há o campo IDs adicionados copie um e utilize no Para para vincular a forma de envio com o pedido.

CÓDIGO DE VENDEDOR

De (Vnda): insira o código externo do vendedor na VNDA
Para (Bling): Inserir o ID do vendedor, conforme consta na URL do Bling, dentro da página de edição do vendedor

Sincronização de estoque (+ configurações extras admin)

Para que a sincronização de estoque ocorra de forma automática, em ciclos, devemos acessar o admin após a criação da loja no HUB e seguir o caminho Configurações > Integrações > Sistemas ERP:

Nessa tela, precisamos garantir duas coisas:

Campo Integrar estoque automaticamente estar com a flag "Sim";
Campo Importar imagens de produtos estar com a flag "Sim" (essa configuração não interfere no estoque, apenas na integração de imagens);

Após garantir estas duas configurações, salve.

Postagem

Caso o cliente queira habilitar a integração de postagem através do Bling, onde recebemos o código de rastreio e os status dos pedidos, basta seguir o passo a passo desse artigo.

Integração Bling V3 [Interno]