Tabela de conteúdos

Documentação Integração Bling ERP Premium Opencart

, , , , ,

Documentação oficial do Módulo Integração Bling ERP Premium Opencart, ensinando como Configurar e usar.
A primeira instalação da melhoria é feita pela nossa equipe.

Importante

Importante sempre informar SKU único nos Produtos e Opções.
O Bling usa o SKU como referência, semelhante a um ID do Produto, se estiver sem ele e importar novamente o Produto, o Bling vai cadastrar um novo se estiver sem SKU.

O SKU precisa ser único por Produto e por Opções, caso precise de um gerador para facilitar, indicamos o Módulo:
Gerador Automático - URL Amigável, SKU e Modelo dos Produtos para Opencart

Instalação

Estes passos são o resumo do que nossa equipe faz ao instalar a integração em sua loja Opencart:

  1. Cadastrar a Loja em Minha Conta → Lojas se não estiver cadastrada
  2. Instalar o Painel Codemarket e verificar a instalação, se não tiver instalado antes
  3. Gerar a Licença de uso para a Loja
  4. Subir os arquivos da melhoria da sua versão do Opencart pelo FTP/SFTP
  5. Em Extensões → Modificações → Clicar no ícone azul para atualizar o cache das Modificações
  6. No Bling ERP criar o usuário da API e validar a comunicação com a Loja.
  7. Clique no ícone da engrenagem no Bling ERP → Sistema → Usuários e usuário API → Cique em INCLUIR USUÁRIO do lado direito
  8. Escolha USUÁRIO API , informe um Nome e E-mail e clique em GERAR, anote a API Key Gerada e salve no Painel da melhoria no campo API key Bling
  9. Marque as Permissões de preferência todas as opções e depois clique em SALVAR
  10. Clique no ícone da engrenagem no Bling ERP → Integrações → Configurações de integração com lojas virtuais e marketplaces → Plataformas → Escolha Opencart
  11. Informe o nome Nome do canal de venda, recomendamos o nome da Loja - Opencart
  12. Na URL do canal de venda informe a URL da Loja, exemplo: https://www.seusite.com.br, troque seusite pelo domínio do seu site
  13. No Secret key informe a chave Chave de Segurança Rest API cadastrada no Painel da melhoria
  14. Clique em TESTAR e depois do sucesso em SALVAR
  15. Pronto melhoria instalada, agora basta usar

Obs: importante a loja não estar em manutenção e não ter bloqueio da Hospedagem ou WAF/CDN para pegar a melhoria, pois o Bling precisa conseguir se comunicar com a API que está na loja para o seu funcionamento. Precisa ter pelo menos 1 Produto cadastro na Loja para pegar a verificação do Bling ERP.

Importando dados Produtos API V2

Recurso para importar dados adicionais para o Bling ERP, no momento serve para importar as Imagens, GTIN/EAN, NCM, CEST, Localização, Observação e URL do Produto para o Bling ERP. Interessante ser usado este recurso, após Importar/Sincronizar Produtos do Opencart para o Bling ERP, pode ser rodado manualmente a URL ou por Cron Job.

URL para rodar: https://www.seusite.com.br/index.php?route=feed/rest_api/updateProdutoBlingApiV2&key=sua_key

Troque: seusite.com.br pelo endereço do seu site sua_key pela Chave de Segurança Rest API informada no Painel da melhoria

A URL acima é montada também no Painel da melhoria em Dicas e Cron Job para facilitar.

Comando Cron Job: wget -q -O - 'https://www.seusite.com.br/index.php?route=feed/rest_api/updateProdutoBlingApiV2&key=sua_key' >/dev/null 2>&1

Recomendado rodar no Cron Job a cada 5-10 minutos ou conforme o tempo médio que costuma Importar os Produtos do Opencart para o Bling, pode se preferir rodar manualmente também a URL após importar novos Produtos.

Após rodado, a melhoria limpa o cache da lista de Produtos a ser rodado, logo só roda se tiver Produtos adicionados/atualizados novos, assim otimiza o seu uso.

Cada produto tem um intervalo de 330ms/0.33s, devido o limite de 3 chamadas por segundo do Bling ERP, logo se tem 3 Produtos para enviar as imagens, vai levar pelo menos 1s + o tempo da API do Bling.

Sincronizando o Status do Pedido Automáticamente - Bling -> Opencart

A partir da versão 1.5 da melhoria, pode sincronizar os Status do Pedido com base na Situação do Pedido no Bling ERP. Este recurso é feito com o recurso de Callback do Bling, que se comunica com o novo recurso da API, quando uma Situação do Pedido muda no Bling.

URL do Callback:
https://www.seusite.com.br/index.php?route=feed/rest_api/callbackOrder&key=sua_key

Troque: seusite.com.br pelo endereço do seu site sua_key pela Chave de Segurança Rest API informada no Painel da melhoria

A URL acima é montada também no Painel da melhoria em Dicas e Cron Job para facilitar.

Passos:

Configuração Callback Situação Pedido Bling ERP

Pronto, agora após mudanças na Situação do Pedido a loja vai ser notificada e alterado o Status do Pedido se não foi ainda usado o Status.

Sincronizando o Estoque dos Produtos Automáticamente - Bling -> Opencart

A partir da versão 1.8 da melhoria, pode sincronizar o Estoque dos Produtos do Bling ERP para o Opencart. Este recurso é feito com o recurso de Callback do Bling, que se comunica com o novo recurso da API, quando o estoque de um Produto muda no Bling.

A URL acima é montada também no Painel da melhoria em Dicas e Cron Job para facilitar.

URL do Callback:
https://www.seusite.com.br/index.php?route=feed/rest_api/callbackStock&key=sua_key

Troque: seusite.com.br pelo endereço do seu site sua_key pela Chave de Segurança Rest API informada no Painel da melhoria

Passos:

Pronto, agora após mudanças no estoque dos Produtos no Bling a loja vai ser notificada e altera o estoque dos Produtos conforme a notificação do Bling ERP.

Configuração

Vai abrir o Painel da melhoria, configure como desejado, evite mexer na parte das chaves/tokens e na parte do SKU deixe code_sku se estiver usando nossa melhoria de Opções e o Opencart Oficial do Opencart.com.

Imagens da tela de Configuração:
Tela de Configuração da melhoria Bling ERP Premium Opencart - Configuração Inicial

Tela de Configuração da melhoria Bling ERP Premium Opencart - Personalizações e Campos Extras

Uso da integração

Todo uso da integração é feito com a interação dentro do Bling ERP, após estar logado. Logo primeiro precisa logar no Bling ERP: https://www.bling.com.br/login .

Suporta dois recursos essenciais:

Como importar Pedidos

Configurar o Produto para o uso do Código/SKU

Configuração obrigatória, por padrão a maioria já está com está configuração como padrão.

Configurar imagem dos Produtos no Bling ERP

No Bling ERP pode configurar para as imagens serem baixadas no Bling, ocupando espaço ou ser adicionada apenas a URL da imagem usada na Loja.

Tempo de validade das imagens:

Como importar Produtos para o Bling

Entre em Cadastros → Produtos, aqui onde vai fazer toda interação com os produtos, como importar, exportar e sincronizar estoque e preços.

Para importar os Produtos da sua Loja Opencart para o Bling, no menu do lado direito clique em Importar Produtos Multilojas, vai abrir um Modal, em Selecione o canal de venda escolha a sua Loja Opencart, defina a faixa inicial e final da data de cadastro dos Produtos a serem importados e clique em Importar.

Aguarde alguns segundos, após o Processo deve aparecer os Produtos, recomendamos fazer o processo anterior novamente, pois dependendo da velocidade, que o Bling leva para salvar os Produtos, pode não ter chego as imagens e outros recursos enviados pela API v2.

Como importar os Produtos do Bling para o Opencart

Na tela de Cadastros → Produtos, clique marque o Produto ou Produtos que deseja enviar para a sua Loja Opencart, no menu do lado direito, clique em Exportar produtos multiloja. Em Selecione a loja que deseja utilizar para esta operação, escolha a Loja Opencart e no Selecione o Deposito que deseja utilizar para esta operação escolha o Deposito usado.

Clique em Exportar e aguarde alguns segundos, pronto deve ter exportados os Produtos do Bling para o Opencart com sucesso.

No Painel da melhoria Configurar o Importar Produto - Bling → Loja para o tipo desejado e também em Importar Imagens - Bling → Loja se deseja ou não importar as imagens do Bling para o Opencart.

Importando um Produto Variação no Bling para o Opencart como Opção no Opencart

No Painel da Configuração em Importar Produto - Bling → Opencart escolha: Importar Produto Variação como Opção no Produto Pai

Recurso adicionado a partir da versão 1.8 da integração. Com isso um Produto Variação no Bling pode ser cadastrado como Opção de um Produto Pai/Principal na sua Loja Opencart caso envie o Produto do Bling → Opencart . Podendo agora ao importar um Produto Variação adicionar como Opção, Produto Normal ou não importar para a Loja.

Importante o Produto Variação no Bling estar no Padrão: Título do Produto Nome:Valor Onde o Nome é o Nome da Opção previamente cadastrada na sua Loja, por exemplo: Tamanho, Cor ou outro nome desejado, tem que ser idêntico ao Nome da Opção Valor: Valor da Opção, tem que estar Cadastrado na Opção na sua Loja Opencart, por exemplo: P, M, G, GG, 35, 36, 37, 38, 39, Azul, Verde, Vermelho, Branco, Cinza, Amarelo, Rosa e outros valores possíveis, tem que ser idêntico ao Valor da Opção.

Exemplos certos: Camiseta Azul Tamanho:M Camiseta Verde Tamanho:P Calça Cor:Verde Título do Produto Nome:Valor

Exemplos errados: Camiseta Tamanho:M;Cor:Azul - Vai cadastrar apenas a Opção Tamanho M, pois só pode ter 1 Opção por Produto Variação devido termos que salvar o SKU/Código único Camiseta Tamanhp;M - Errado devido o uso do ; no lugar do :

Como sincronizar Estoque e Preços dos Produtos

Aprenda a sincronizar o Estoque e Preços do Bling para o Opencart.

Importante: No ícone do Carrinho Verde da listagem dos Produtos, fica o Preço do Produto passado para a Loja, caso queira mudar o Preço para uma Loja/Plataforma precisa mudar nele, clicando nele, depois em Exibir e alterando o Preço.
O Preço Promocional o Bling envia da mesma forma, que o Preço, porém troca o Preço por ele, logo se preencher ele, vai ficar no lugar do Preço na sua loja.

Sincronizar os estoques:

Sincronizar os preços:

Erro na Importação/exportação ou sincronização dos Produtos

Em caso de erro na Importação/exportação ou sincronização dos preços e estoques, o Bling pode remover o ID do Produto.

Se o produto já estava em sua Loja Opencart e relacionado no Bling, importante verificar n ícone do Carrinho Verde da listagem dos Produto, clicando em Exibir, se o ID na Loja continua com o ID do Produto na Loja, caso esteja 0, precisa ser adicionado o ID do Produto certo, caso contrário ao importar/exportar, o Bling vai criar um Produto novo nele ou na sua loja Opencart.

A partir da versão 1.5 da nossa integração, usamos o SKU do Produto para descobrir o ID dele na Loja, assim evita o detalhe acima, porém ainda é muito importante o ID do Produto correto no Bling para sincronizar o Estoque e Preços.

Changelog (Histórico das Versões)