A integração com Bling V2 está obsoleta, e não recebe mais suporte. Necessário utilizar a integração Bling V3, que já está disponível e explicamos aqui como configurar.
O que preciso solicitar ao cliente?
Acesso do Bling
Login:
Senha:
1. Acesse a conta do cliente no Bling e crie o usuário API, seguindo os passos abaixo:
Acesse as preferências da conta (engrenagem no canto superior direito) e clique em "todas as configurações";
Clique em Sistema e, em seguida, em Usuários e usuário API;
Crie um novo usuário através do botão Incluir usuário (canto superior direito);
Selecione a opção Usuário API e preencha o cadastro conforme abaixo:
Nome: Integração Vnda
Email: equipe@vnda.com.br
Clique em Gerar ao lado do campo API key;
Copie o token e salve-o em algum lugar, como um bloco de notas, por exemplo;
Na seção Permissões, selecione todos os checkboxes de todas as abas;
Clique em Salvar.
2. Adicione a integração da Vnda dentro do Bling, seguindo os passos:
2.1 Callback de pedidos de venda:
Ainda nas preferências da conta, acesse o menu Integrações;
Clique em Configurações de integração com lojas virtuais e marketplaces;
Clique no botão com o logotipo da Vnda;
No campo Nome do canal de venda, preencha Integração Vnda;
Clique em Salvar e salve o token gerado em Código da loja da API Bling.
Acesse a aba Callbacks altere o tipo de retorno para JSON e ative a opção Callback de pedidos de venda, adicione a seguinte URL de notificação:
Lembre-se de alterar a URL para informar o shop host correto!
2.2 Callback para atulização de estoque (opcional):
No acesso de Callbacks nesse cadastro:
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:
Lembre-se de alterar a URL para informar o shop host correto!
3. Caso o cliente ainda não tenha cadastrado as formas de pagamento no Bling, 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.
4. Caso o cliente também não tenha cadastrado as integrações logísticas, faça o cadastro conforme abaixo:
Ainda nas preferências da conta, acesse o menu Logística;
Clique em Configurações de integrações logísticas;
Depois clique no botão Incluir nova;
O cadastro da nova forma de entrega vai depender da transportadora contratada pelo cliente:
Melhor Envio
Preencha o campo Nome da Integração Logística com Melhor Envio;
Em Integração, selecione Melhor Envio;
Clique em Autenticar;
Na tela da Melhor Envio, preencha os campos CNPJ padrão e Inscrição estadual padrão e selecione as transportadoras utilizadas pela loja;
Caso o cliente trabalhe com Jadlog, selecione a unidade no campo Agência de postagem;
Todas essas informações podem ser encontradas no atendimento sobre postagem e dentro da Melhor Envio, dentro do menu Integrações, não opção Integração Vnda;
De volta à tela do Bling, adicione as modalidades da Melhor Envio contratadas em Serviços de entrega;
Clique em Salvar.
5. Cadastrar loja no app Hub Vnda (hub.vnda.com.br), seguindo os passos abaixo:
Host: domínio da loja;
Integração: Bling;
Token da API: obtido no passo 1;
Faturar pedido: somente se o cliente tiver autorizado a emissão automática de NF, selecione Sim;
Enviar NF: se o campo anterior tiver sido preenchido com Sim, selecione eNF;
Para emissão automática das NFs, é preciso fazer o mapeamento dos meios de pagamento (passo 6).
Usar mapeamento: Sim;
Depósito: será preciso identificar qual depósito o cliente tem cadastrado no Bling:
Utilizando a conta do Bling da loja, acesse as preferências (engrenagem);
Clique no menu Suprimentos e, depois, na opção Depósitos de estoque;
Depois clique no botão Incluir nova;
Caso o único depósito cadastrado seja Geral, preencher o campo no Hub com esse termo;
Se o cliente tiver mais de um depósito, questione qual deles deve ser considerado;
IMPORTANTE: nesse caso, não ative a sincronização automática de estoque;
Loja: token obtido no passo 2 (Código da loja da API Bling);
Integrar estoque automaticamente: selecionar Sim para integração de estoque por ciclos (de 20 em 20 mins) SOMENTE se o cadastro dos produtos estiver batendo na Vnda e no Bling E o campo Depósito estiver preenchido corretamente;
Tratar números de endereços?: Sim;
Clique em Salvar.
Situação equivalente: nestes novos campos há opção para adicionar quando o pedido foi Enviado, e Entregue. É necessário verificar qual situação de pedido de venda o cliente utiliza para adicionar ao Hub. No exemplo em www.adornashop.com o seller utiliza apenas a situação atendido, a qual será utilizada para em trânsito. Com o mapemaneto desta forma, ao migrar o pedido para atendido aqui na Vnda passa o pedido como Enviado.
Situação equivalente é um campo novo disponibilizado para alterar o pedido para Enviado e Entregue.
Para sincronizar o estoque do bling via webhook (integração é realizada a cada movimento de estoque) basta seguir esse passo a passo.
5.1. Para a importação de produtos, preencher os campos:
Intervalo ao importar produto: preencher com 0,5
Importar imagens de produtos: "Sim" para trazer as imagnes do bling ou "Não" para não trazer.
No campo "Mapeamento de produtos" deve-se inserir a linha abaixo:
Produtos Simples: reference:codigo,product_name:descricao,description:descricaoComplementar,sku:codigo,price:preco,width:larguraProduto,height:alturaProduto,length:profundidadeProduto,weight:pesoBruto
Produtos com Variação: reference:codigo,product_name:descricao,description:descricaoComplementar,sku:variacao.codigo,variant_name:variacao.descricao,price:variacao.preco,width:variacao.larguraProduto,height:variacao.alturaProduto,length:variacao.profundidadeProduto,weight:variacao.pesoBruto,property1:variacao.descricao,property2:variacao.1.descricao
A integração atualmente funciona apenas com um mapping por vez. Se quiser puxar com e sem variação, necessita fazer um de cada vez.
Conforme for configurado, vai puxar só produtos sem ou com variação.
5.2. Para trazer os produtos para a Vnda, basta selecionar os produtos existentes em "Produtos disponíveis no ERP" no Hub, que eles serão mostrados em "Produtos a serem importados".
• Caso não apareçam os produtos, é necessário clicar em Atualizar e aguardar os produtos estarem disponíveis na aba.
Após selecionar os mesmos, clique em "Importar Selecionados". Ao final do processo, os mesmos estarão disponíveis no e-commerce.
Por enquanto não separamos as variantes conforme estão entre vnda x bling. Precisa tratar por planilha/ manualmente.
[DURANTE A HOMOLOGAÇÃO DA LOJA]
6. Faça os mapeamentos da loja no app Hub:
Procure a loja usando a busca do navegador. Após encontrá-la, clique em Opções > Mapeamentos;
Clique em Novo mapeamento e preencha os campos conforme abaixo:
MEIO DE PAGAMENTO
De (Vnda): cadastre cada forma de pagamento com a nomenclatura padrão 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
Paypal Plus
Bandeira-do-cartão - Crédito (em x vezes) utilizar quando o seller solicita para mapear as formas de cartão de crédito parcelado com o ERP.
Para (Bling): cadastre as formas de pagamento de acordo com o ID do Bling. Para isso, abra a forma de pagamento cadastrada e copie o ID localizado no final da URL.
Exemplo:
De: American Express - Crédito
Para: 1793944
Outra opção é utilizando o token de API do Bling nessa Url: https://bling.com.br/Api/v2/formaspagamento/json?apikey=xxxxx
TIPO DE ENTREGA
De (Vnda): insira o nome da forma de entrega cadastrado no campo Descrição do app Shipping Vnda (shipping.vnda.com.br).
Importante: letras devem ser todas minúsculas e espaços devem ser substituídos por hífen. Exemplo: Jadlog Com > jadlog-com
Esse é o nome que fica entre parênteses nas informações do pedido no admin.
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 (passo 4);
TRANSPORTADORA
De (Vnda): insira o nome da forma de entrega cadastrado no campo Nome do app Shipping Vnda (shipping.vnda.com.br).
Esse é o nome que fica fora dos parênteses nas informações do pedido no admin.
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 cadastrado da transportadora Configurações de integrações logísticas no Bling (passo 4);
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).
Esse é o nome que fica fora dos parênteses nas informações do pedido no admin.
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.
Para visualizar um exemplo, acesse o mapeamento da loja Beach, Please!: www.beachplease.com.br/admin/hub/mapeamentos
7. Acesse o admin da loja e cadastre o webhook de disparo dos pedidos para o Bling, de acordo com as orientações abaixo:
Acesse as preferências da loja (engrenagem no canto inferior esquerdo);
No menu Integrações, selecione Webhooks;
Clique no símbolo + no canto superior direito;
Preencha os campos da seguinte forma:
No primeiro, selecione order-confirmed;
URL: no app Hub, copie o link correspondente à integração cadastrada para a loja. Cole-o nesse campo;
IMPORTANTE: atente-se para que não haja espaçamento no campo de URL;
Clique em Salvar.
8. Faça um pedido teste na loja e verifique se ele consta como integrado no Hub da loja:
Clique no menu HUB no admin da loja;
Na barra superior, clique em Pedidos;
Se o pedido tiver sido integrado, o primeiro ícone à direita do pedido estará verde.
Caso o pedido não tenha sido integrado (ícone estará cinza), clique no botão de seta para esquerda (à direita dos ícones do pedido) para verificar o erro. Revise o item do cadastro mencionado.
Após a correção, reenvie o pedido, clicando no botão verde com setas circulares e atualize a página. Persistindo o erro, repita o passo anterior ou peça ajuda para entendê-lo.
9. Após garantir que os pedidos estão sendo integrados corretamente, cancele o pedido no admin e dentro do Bling.
Para cancelar no Bling, acesse o menu Vendas, na barra superior, e clique em Pedidos de venda;
Selecione o checkbox do pedido teste e clique no ícone de lixeira (canto superior direito) para excluí-lo.
Configurações Extras:
Na conta do Bling é possível configurar para importar os produtos pela Api através do Código (sku) ou descrição dos produtos. Acesso em: Preferências > Integrações > Configurações para lojas virtuais e selecionar na opção “Na importação através da API, buscar produtos por código ou descrição”
Baixa no estoque no momento que o pedido integrar:
Campos opcionais na integração de pedido de venda no Bling:
*Campo LOJA: Seguir orientações desse artigo e cadastrar o ID nas preferências do Hub:
*Campo Categoria: Não da pra enviar automaticamente pela API do Bling. É possível configurar no Bling acessando em:
Finanças > Gerenciar categorias receitas e despesas.Configurar uma de suas categorias como "Padrão para vendas", clicando nos "Três pontos" ao lado da categoria e escolhendo para ela "Padrão venda"
*ID da situação: id da situação que os pedidos devem entrar no Bling, se não estiver preenchido entram como 'Em aberto'.
Caso queiram um ID diferente, acessar a url pelo browser https://bling.com.br/Api/v2/situacao/Vendas/json?apikey=XXXXXXX e substituir o XXXXXXX pelo token da loja no bling. Utilizar o número de ID correspondente a nomenclatura desejada.
Para lançar estoque automaticamente através de notas fiscais basta ir em Preferências () > Notas fiscais > Configurações de NF-e > Configurações gerais
Ative a opção: "Lançar estoque ao emitir ou cancelar a nota"
Como dar baixa em estoque quando o pedido for feito: Como dar baixa no estoque no momento que o pedido for feito - Reserva de estoque
Lançar ou estornar estoque de vendas Nfe: Lançar e estornar estoque de vendas
*Tipo do frete é enviado pela nossa integração. Isso pode ser alterado em Hub > Config > Preferências > Tipo do frete
Ele poder ser:
Remetente (CIF) - neste caso a loja é responsável;
Destinatário (FOB) - o cliente é responsável
Sem frete
______________________________________________________________________________
Os formatos de imagem aceitos são: png, jpg, jpeg, gif, bmp, svg, tiff
Integração de nota fiscal entrando no BLING como AUTORIZADA
Para que isto ocorra, é necessário que no HUB, esteja “eNF” em enviar nf.
Feito isto, precisamos revisar a integração dos dados financeiros, aqueles feitos os mapeamentos no HUB.
Relembrando:
MEIO DE PAGAMENTO
De (Vnda): cadastre cada forma de pagamento com a nomenclatura padrão 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
Paypal Plus
Para (Bling): cadastre as formas de pagamento de acordo com o ID do Bling. Para isso, acesse o link bling.com.br/Api/v2/formaspagamento/json?apikey=, colocando a API key da loja (obtida no passo 1) após o sinal de =;
Exemplo:
De: American Express - Crédito
Para: 1793944
Exemplo:
Feito esses passos, o próximo pedido que entrar vai estar autorizada.