Ir para o conteúdo

Premium Opencart Explicando sobre o uso da melhoria e sua configuração.' description_internal: 'Documentação Bling ERP
Premium Opencart Explicando sobre o uso da melhoria e sua configuração.'


Documentaçã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.

Demostração dos novos recursos da versão 2.0 do Bling ERP para Opencart, agora com suporte a Categorias e Status de
Filtros dos Pedidos

Importante

Informe SKU único

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

Aprenda passo a passo como Instalar e demostração de alguns recursos do Bling ERP

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.

Observação

  • 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

Recurso extra usando a API V2 do Bling ERP para importar dados adicionais para o Bling, 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:

  • Logue no Bling ERP
  • Acesse Home → Preferências → Integrações → Configurações de integração com lojas virtuais e marketplaces
  • Escolha Bling API, informe o Nome desejado em Nome do canal de venda
  • Clique em Callbacks e configure como a imagem abaixo, trocando apenas a URL do Callback no número 4:

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:

  • Logue no Bling ERP
  • Acesse Home → Preferências → Integrações → Configurações de integração com lojas virtuais e marketplaces
  • Escolha Bling API, informe o Nome desejado em Nome do canal de venda
  • Em Callbacks no Tipo de retorno no callback escolha JSON
  • Callback de estoque marque como Ativado e informe a URL criada acima, depois clique em SALVAR

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

  • Logar no Administrador do Opencart
  • Configurar em Extensões → Extensões → Módulos Premium, clicando no ícone de Configurar na linha da melhoria.

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

Vídeo ensinando a Configurar:

Configurando o Identificador Loja Bling

Uma das primeiras etapas é informar o Identificador Loja Bling, ele é usado por alguns recursos que usam a API V2 como
Promoções e Importar Pedidos pela API V2.

Descobrindo o ID da Loja

  • Logue no Bling ERP
  • Clica no ícone da engrenagem -> Configurações de integrações -> Clica na linha do Opencart
  • Anote o número dentro do campo Código da loja API Bling
  • Salve no Painel da Configuração do Módulo no campo Identificador Loja Bling

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 com a conta usada na Loja.

Suporta recursos essenciais:

  • Importar Pedidos forma Tradicional
  • Importar Pedidos pela API V2
  • Importar/Exportar Produtos, recomendo importar da Loja → Bling

Importar Pedidos forma Tradicional/Padrão

  • Entre em Vendas → Pedidos de venda multilojas
  • Em Selecione seu canal de venda, escolha sua loja Opencart
  • No lado esquerdo tem um ícone de um Filtro, pode abrir ele se desejar usar os Filtros
  • Clique em Visualizar para ver os Pedidos
  • Clique em Importar no Pedido que deseja importar
  • Após importado o Pedido fica em Vendas → Pedidos de Venda

Importar Pedidos pela API V2

Recurso implementado na Versão 2.2, foi feito do zero para ser usada a API V2 do Bling ERP com no documento:
https://ajuda.bling.com.br/hc/pt-br/articles/360047064693-POST-pedido

Antes de criar o Pedido no Bling é criado/atualizado o Cadastro do Cliente usando a
API https://ajuda.bling.com.br/hc/pt-br/articles/360046378614-POST-contato, desta forma o Bling mantém o código do
Cliente como o ID do cliente na Loja, por isso optamos por fazer separado.

Recomendamos o uso, caso o modo Tradicional não atenda 100% seu caso de uso ou precise que o Pedido seja criado de forma
mais automática, usando Cron Job, para este recurso verificar os Pedidos recentes da Loja e se não tiver no Bling ERP
adiciona nele.

Este recurso faz uso do Cache do Opencart, logo tem um desempenho muito bom.
Tentamos manter o mesmo suporte de recursos do modo Tradicional e alguns a mais devido à liberdade de uso da API V2.

Observações

  • Só tem suporte a até 2 Opções por Produto em um Pedido, temos que transformar elas em Produtos a parte, pois a API
    não tem suporta a Opções/Variações, logo 2 Opção vira 2 Produtos
  • Caso sua loja tenha mais de 2 Opções por Produto em certos Pedidos melhor não usar este recurso
  • Verifica antes se já foi importado o Pedido no Bling, se sim não faz mais nada e vai para o próximo Pedido

Comando Cron Job:
wget -q -O - 'https://www.seusite.com.br/index.php?route=feed/rest_api/addOrdersBling&key=sua_key&day=30&
status=&limit=1000&xml=0&date_exit=1&date_preview=1&shipping_type=D&option_more_to_equal=0&price_product=0' >/dev/null
2>&1

Se preferir manualmente para testar ou enviar um ou poucos pedidos tem a URL:
https://www.seusite.com.br/index.php?route=feed/rest_api/addOrderBling&key=sua_key&order_id=&xml=0&date_exit=1&date_preview=1&shipping_type=D&option_more_to_equal=0&price_product=0

Muda as variáveis conforme desejado, veja mais detalhes sobre cada variável da URL abaixo.

No Painel de Configuração do Módulo tem montada uma base deste Cron Job, URL e de outros recursos.

Variáveis na URL addOrdersBling - Cron Job

Valor Padrão Resumno
day 5 Quantos dias anteriores verificar, se hoje é 30/01/2022 e informa 10, vai verificar a partir do dia 20/01/2022
status Obrigatório Status dos Pedidos a serem verificados separados por vírgula, ex: 1,5,10
limit 30 Quantidade máxima de Pedidos para Verificar

Variáveis na URL addOrderBling - Manual

Valor Padrão Resumno
order_id Obrigatório Informe os IDs dos Pedidos que deseja importar separados por vírgula, ex: 14,50,100

Variáveis Gerais na URL

Valor Padrão Resumno
xml 0 Se 1 vai exibir o objeto do XML usado para Teste apenas
date_exit 1 Data prevista de saída fica a data modificada + o date_exit em dias, por padrão é 1
date_preview 1 Data prevista fica a data modificada do Pedido + o date_preview em dias, por padrão é 1
shipping_type D Tipos de Frete, ex: D = Contratação do Frete por conta do Destinatário (FOB)
option_more_to_equal 0 Se 1 a opção com prefixo + deve ser tratada como o valor igual e não como soma, por padrão é 0 para ficar o preço do produto + soma da variação. Recurso apenas se tiver mais de uma Opção
price_product 0 Se 1 usar o Preço nativo do Produto, se não informar nada ou 0 vai ficar o preço do Order Product que é o padrão. Recurso apenas se tiver mais de uma Opção
use_order_id Vazio Use 1 caso queira usar no Número do Pedido do Bling o mesmo ID do Pedido da Loja
use_customer_id Vazio Use 1 caso queira usar o ID do Cliente como ID/Código no Bling em Clientes e Fornecedores
customer_id_prefix Vazio Prefixo do Número do Cliente com até 2 Letras, exemplo: L, ficaria L10, se o ID do Cliente na Loja for 10
nat_operacao Venda de mercadorias Pode informar a Natureza de Operação

Prefixo

O use_order_id e use_customer_id são importantes, caso já usava o Bling ERP antes pelo modo tradicional de puxar os Pedidos ou outros canais de Vendas.
Serve para evitar ID duplicado e com isso não cadastrar o Pedido ou o Cliente, exemplo: Se no Bling tiver um Pedido com ID 100 de outro canal e na Loja tentar importar o Pedido 100, não vai conseguir por ser igual.
Logo não use eles, caso já tenha puxado alguns Pedidos do BLing ou vendas em outras canais.
Se a Loja for nova e focada apenas no Opencart recomendamos o uso para ser mais fácil encontrar o Pedido e Cliente.
Já o customer_id_prefix é interessante, caso queira usar o ID do Cliente da Loja, mas evitar conflitos, usando algum Prefixo, infelizmente Pedido não tem Suporte a Texto no Número/Código, por isso não implementamos o recurso de Prefixo.

O cliente o Bling vai atualizar se for o mesmo ID/Código, mesmo que o cliente pertença a outro Canal de venda, pois ele
atualiza com base no ID do Cliente. Já com Prefixo só vai criar ou atualizar o cliente com Código exato com o Prefixo.

Por padrão o Cliente o Bling cria sem Código, porém se habilitar o suporte ao código com use_customer_id=1, o Bling vai atualizar o Cadastro já existente.
Parece que usa o E-mail ou algum outro dado para referência do Cliente quando não tem o Código informado e fica um aviso que foi atualizado pela API.

Recomendações

  • use_order_id = 0 ou sem informar na URL se usa outros Canais de Venda no Bling ERP ou já importou alguns Pedidos no
    Opencart usando o Modo Tradicional
  • use_customer_id = 1 com customer_id_prefix = Iniciais da Loja ou como Preferir, exemplo: O, L, S ou iniciais da Loja,
    por exemplo Codemarket usariamos CM

Na parte do Cliente tem mais liberdade, já na do Pedido mais fácil deixar no geral o Número automático do Bling para evitar qualquer conflito no ID/Código.

Tipos de Fretes

Valor Descrição
R Contratação do Frete por conta do Remetente (CIF)
D Contratação do Frete por conta do Destinatário (FOB)
T Contratação do Frete por conta de Terceiros
3 Transporte Próprio por conta do Remetente
4 Transporte Próprio por conta do Destinatário
5 Sem Ocorrência de Transporte (Use para Produto Digital)

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.

  • No menu do topo no lado direito, clique no ícone da engrenagem
  • Depois ao lado esquerdo em Cadastros → Configurações de produtos
  • No Código do produto selecione Manual
  • No final da página clique em Salvar

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.

  • No menu do topo no lado direito, clique no ícone da engrenagem
  • Depois ao lado esquerdo em Integrações → Configurações para lojas virtuais
  • No Na importação/Exportação de produtos para Lojas Virtuais e Marketplaces, considerar tem duas opções:
    Imagens armazenadas no Bling: Escolha para Armazenar as imagens no Bling URL de Imagens Externas: Escolha para só
    salvar a URL da imagem no Bling, boa opção para economizar o espaço do Bling

Tempo de validade das imagens:

  • No Validade das Imagens quando vinculadas e expostas externamente (API e/ou Exportação via Integração) escolha o
    tempo desejado para a validade das imagens importadas. Por padrão pode escolher 1 mês (30 dias) até 1 ano (365 dias),
    recomendo configurar para 1 ano

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.

Criar uma Promoção no Bling ERP

  • Acesse a sua Conta do Bling ERP
  • Clique em Cadastros -> Produtos
  • Clique no ícone verde do Carrinho na linha do Produto que deseja criar a Promoção
  • Vai abrir um Modal, clique em Exibir na linha da Loja
  • Em Preço Promocional informe o Preço da Promoção e clique no botão SALVAR

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.

Importar Produtos com Promoção do Opencart para o Bling

Aprenda a criar Promoções ao importar um Produto com Promoção do Bling para o Opencart.

Pasoss

  • Acesse o Painel de Configurações do Módulo em Módulos Premium ou Minha Conta -> Licenças em nosso site
  • Clique na tab Configuração 2
  • Em Habilitar Promoção marque Sim se desejar Habilitar o recurso
  • Lembre em Configuração -> Identificador Loja Bling já ter informado o
    identificador da Loja no Bling
  • Depois basta repetir o passo
    acima importar os Produtos do Bling para o Opencart

O que vai acontecer ao usar este recurso

  • Se tiver Habilitada a Promoção, vai ser removida todas as Promoções do Produto no Opencart
  • Só é removida as promoçÕes e feito os demais passos se o Produto tiver alguma Promoção no Bling ERP
  • Muda o Preço Normal para o Preço da Loja
  • Cria uma promoção com data atual - 2 dias e a final com + 90 dias
  • Promoção só pega para Produto normal, não pega para Produto do tipo Serviço, pois o Bling não envia na API v2 os dados
    da Loja se for Serviço

Observações

  • No Bling ERP o Produto precisa ter uma Promoção criada para a Loja
  • Lembre-se que vai ser removida todas as Promoções do Produto
  • O Produto precisa antes já ter cido importado para o Opencart
  • Não tem no momento como controlar o período da data final da Promoção

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 Tamanho;M - Errado devido o uso do ; no lugar do :

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.

  • Acesse Cadastros → Produtos
  • Selecione o Produto ou Produtos que deseje sincronizar

Sincronizar os estoques:

  • No menu do lado direito, clique em Sincronizar estoque do sistema na loja virtual
  • Escolha em Selecione a loja que deseja utilizar para esta operação a Loja Opencart
  • Escolha em Selecione o Deposito que deseja utilizar para esta operação o Deposito usado
  • Clique em Sim e Aguarde alguns segundos

Sincronizar os preços:

  • No menu do lado direito, clique em Sincronizar preços do sistema na lojas virtual
  • Escolha em Selecione a loja que deseja utilizar para esta operação a Loja Opencart
  • Clique em Sim e Aguarde alguns segundos

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/Atualizações

Recomendamos sempre manter atualizado o Produto de preferência com a última versão atual. Veja abaixo as versões deste
Produto e seus detalhes.

Versão 2.3.1 - 11/02/2022

Mais recursos para a Função de Importar Pedidos pela API V2

  • Adicionado Prefixo para o ID/Código do Cliente para a URL de Importar Pedidos API V2 para evitar conflito de ID/Código
  • Adicionado variável para URL use_order_id e use_customer_id para informar se deseja usar o ID do Pedido e Cliente da Loja ou o gerado pelo Bling
  • Adicionado variável para URL nat_operacao para poder informar a Natureza da Operação, por padrão é usado Venda de mercadorias
  • Limpado o nome do Produto e da Opção retirando possíveis HTMLs para evitar conflito com o XML

Atualização opcional, mas importante se já importou alguns Pedidos pelo modo Tradicional ou usa outros Canais de Venda e deseja usar o novo recurso pela API V2.
O prefixo para o Pedido chegamos a adicionar, porém, infelizmente o Bling não aceita no Número do Pedido letras.

Por padrão o Cliente o Bling cria sem Código, porém se habilitar o suporte ao código com use_customer_id=1, o Bling vai atualizar o Cadastro já existente.
Parece que usa o E-mail ou algum outro dado para referência do Cliente quando não tem o Código.

Versão 2.3 - 01/02/2022

Importação dos Pedidos da Loja Opencart para o Bling ERP por Cron Job usando a API V2

  • Adicionado o modo debug, se informado na URL debug=1 vai ativar o modo debug, ele vai retornar o array no lugar do
    Json
  • Melhorado o desempenho da importação dos Produtos do Opencart para o Bling com mudanças que evitam Produtos repetidos
  • Deixado o retorno do atributo vazio, pois não é usado pelo Bling
  • Pequenos ajustes no código principalmente para a parte que retorna os dados do Pedido
  • Criado recursos para ser possível importar Pedidos do Opencart para o Bling, com diversos filtros e regras pela URL
  • Novo recurso de importar Pedidos para o Bling rodando por Cron Job com Token seguro
  • Passando dados extras na Observação do Pedido como o último comentário e data com hora, adicionado também Nome do
    Pagamento e Código dele
  • Removido " e ″ das variações para evitar Opções com problema no texto, prefira sempre usar só número, texto, traço e
    acentos nos títulos dos produtos e opções
  • Se informar na URL disableCache = 1 desativa o cache da Adição dos Pedidos da API V2
  • Adicionado no Painel para informar se quer subir Produtos desativados do Opencart para o Bling ERP

Atualização muito recomendada, devido um dos recursos mais aguardados pelos nossos clientes. Trabalhamos por quase 3
meses nesta versão, tivemos que criar código do zero para integrar a API v2 para enviar os Pedidos do Opencart para o
Bling sem precisar acessar o Administrador do Bling.

Continua funcionando o recurso de puxar os Pedidos pelo Administrador do Bling, ambos tem algumas diferenças nos dados.
Tentamos passar o máximo de dados possíveis nesta nova versão com o uso da API V2, recomendo testar ambos os modos e ver
qual atende melhor seu caso de uso.

Versão 2.2 - 08/12/2021

Adicionado recurso de Promoção do Bling para o Opencart

  • Se tiver o Preço Promocional da Loja remove todas as Promoções do Produto e adiciona uma nova no Opencart
  • Muda o Preço normal no Opencart para o Preço da Loja no Bling
  • A promoção é criada com a data atual menos 2 dias e a final criada com data atual mais 90 dias
  • Promoção só pega para Produto normal, não pega para Produto do tipo Serviço, pois o Bling não envia na API v2 os dados
    da Loja se for produto do tipo Serviço

Atualização recomenda se deseja o recurso de Promoção do Bling para o Opencart.

Versões Anteriores

Versão 2.1.1 - 03/12/2021

  • Melhorado o uso do cache na atualização dos dados extras dos Produtos do Opencart para o Bling, não estava limpando o
    cache para Produtos sem Variações
  • Formatação para o padrão PSR-12 e mais alguns Logs

Em breve, vamos lançar a versão 2.3, que vai ter suporte a enviar os Pedidos do Opencart para o Bling usando a API V2 do
Bling, prevista para ser lançada no final deste mês 12/2021 ou no início de 2022.
Atualização recomendada, principalmente se usa a versão 2.1 e o recurso que adiciona dados extras aos Produtos como as
imagens.

Versão 2.1 - 16/09/2021

  • Uso de cache na atualização dos dados extras dos Produtos do Opencart para o Bling e adição da variável time_limit na
    URL para informar o limite máximo em segundos para rodar, na próxima chamada vai continuar de onde parou no Cache até
    rodar para todos os produtos importados recentemente, excelente melhoria para loja com muitos produtos importados do
    Opencart para o Bling ERP
  • Melhorado o tratamento dos dados retornados dos Pedidos limpando qualquer espaço, caso o cliente digite por exemplo
    Cidade São Paulo, mas com espaço no começo ou fim, vai ser enviado ao Bling sem o espaço
  • Adicionado Suporte para atualizar os dados das Opções/variações do Opencart para o Bling com suporte a informar a
    descrição (puxa do produto pai), link na loja (puxa do produto pai), preço da Opção se for diferente do Produto
  • Suporte ao Opencart 3.0.3.8

Atualização recomendada principalmente para loja com vários Produtos para importar do Opencart para o Bling e que deseja
passar as imagens e demais dados extras

Versão 2.0.2 - 25/08/2021

  • Adicionai mais logs para o modo Debug
  • Na imagem enviada para o Bling ERP trocado espaço por %20 para assim o Bling conseguir baixar a imagem. O ideal é
    nunca usar espaço ou acentos nas imagens, apenas letras, número e no lugar de espaço traço.

Versão 2.0.1 - 18/08/2021

  • Alterado a forma de verificar a extensão da imagem, devido algumas Hospedagens não funcionar a função getimagesize do
    PHP, por isso mudamos para o uso do Curl

Atualização opcional, importante se na sua loja não estiver salvando as imagens dos Produtos vindos do Bling para o
Opencart.

Versão 2.0 - 10/08/2021

  • Adicionado Modo Debug para o Log, assim se ativado exibe mais logs com mais detalhes
  • Pode informar para o campo Modelo do Produto qual campo deseja do Bling ERP, por padrão é usado o Código
  • Cadastro de Categorias do Bling ERP para o Opencart podendo adicionar 1 categoria filha e 1 pai ou só uma principal
  • Exemplo Categoria Calçados -> Tênis, no Bling está vinculado Tênis, logo no Opencart é criado e vinculado ao Produto a
    categoria Tênis e a pai Calçados, verificando se já existe, se já existir só relaciona
  • Pode informar se deseja Habilitar a Categoria nova
  • Adicionado o suporte a relação dos Status dos Pedidos para filtrar melhor em Pedidos de venda multilojas no Bling
    podendo relacionar Status como Cancelado, Processando, Processado, Concluído e outros, antes só tinha o Processado
    para relacionar
  • Pequenas otimizações e mais logs
  • Segue vídeo sobre os novos Recursos: https://www.youtube.com/watch?v=ZoUM8EhDBsM demostrando o uso deles

Versão muito recomendada, principalmente devido ao recurso das Categorias muito aguardado e desejado para facilitar
ainda mais o Cadastro dos Produtos no Opencart.
Além dos recursos como os novos Status para Filtrar os Pedidos, mais Logs e outras melhorias.

Versão 1.9 - 22/06/2021

  • Arquivo de Log criado com base no mês e ano para evitar ficar muito grande um arquivo apenas
  • Criado método para limpar os logs, pode ser adicionado no Cron Job para limpar quando desejado ou rodar manualmente
  • Adicionado mais logs e melhor retorno em caso de algum detalhe no Curl para ser passado para a Hospedagem ou Bling os
    detalhes
  • Adicionado mais alguns logs principalmente ao adicionar um produto do Bling -> Opencart

Atualização recomendada principalmente se está tendo algum detalhe com o Curl e quer ter mais mais recursos nos logs
Evitem usar hospedagem compartilhada principalmente se tem muitas visitas, produtos e pedidos, recomendamos
a Infinite Cloud na Infra Digital Ocean

Versão 1.8.2 - 03/06/2021

  • Pequenas melhorias no SKU das Opções, como mudança no Placeholder e tamanho mínimo para o campo de 150px no Opencart 2
  • Mudança na parte de puxar os dados do Produto para puxar de qualquer store_id (Loja) com prioridade na Loja com menor
    ID, recurso importante caso use com Multiloja, mesmo sendo recomendado ser usado apenas para uma loja normal

Atualização opcional, recomendado para loja, que use multiloja principalmente, pois se o produto não estiver na loja 0,
ainda assim vai ser retornado na API

Versão 1.8.1 - 04/05/2021

  • Adicionado recurso para converter o Peso para Kg e as Dimensões para cm
  • Converte o peso e dimensões com base na Configuração da Loja e ao usar a URL para importar dados extras usando a API
    V2 usa como base a Configuração do Produto
  • No Bling precisa ficar cm e Kg, o que a melhoria faz é padronizar, se na loja usa Milímetro e Grama vai ser convertido
    para cm e Kg
  • Feita a conversão do peso e dimensões do Opencart -> Bling e do Bling -> Opencart
  • Ao salvar um Produto do Bling -> Opencart usa a classe do peso e dimensão informado no Painel, para ficar cm e kg
  • Mudado para dar baixa no estoque para os Produtos vindos do Bling

Atualização opcional, recomendado para loja ou produtos que não usam o padrão cm e Kg

Versão 1.8 - 28/04/2021
Parte 1 - Recurso de salvar Produto Variação no Bling como Opção no Produto principal/pai da Loja e outras melhorias e
recursos

  • Melhorado a documentação
  • Melhorado o Desconto para somar mais de um Desconto se tiver, como Desconto por Forma de Pagamento + Cupom
  • Adicionado o recurso para salvar uma Variação do Bling como uma Opção do Produto pai no Opencart, recurso aguardado a
    muito tempo, importante no Opencart estar cadastrado a Opção e seu Valor e na Variação do Bling estar no padrão: Nome:
    Valor, exemplo: Camisa Azul Tamanho:M, logo a Opção é o Tamanho e o Valor é o M
  • Salva a Localização do Produto no Opencart, funcionando agora tanto do Opencart -> Bling, quanto do Bling -> Opencart
  • Melhorado o Slug da URL Amigável para Lojas com vários idiomas
  • Pequenas correções e melhorias no geral

Parte 2 - Implementado a parte do Estoque automático e outros recursos

  • Implementado o Callback dos Estoques para os Produtos e Opções, o Bling vai notificar a Loja a cada alteração de
    estoque nele e vai ser alterado na Loja o estoque
  • Colocado mais alguns logs
  • Adicionado no Painel o GTIN/EAN para informar o input name usado, antes era usado como padrão o ean, agora pode
    informar qual deseja
  • Adiciona na Loja Opencart o GTIN/EAN, NCM e CEST se não estiver vazio
  • Adiciona no Bling ERP o GTIN/EAN, NCM e CEST se não estiver vazio e tratado para só enviar como número sem pontos ou
    traços

Atualizações recomendadas, principalmente se usa Variações no Bling ou se vende em Marketplaces para notificar a Loja as
mudanças de Estoque

Versão 1.7 - 01/04/2021

  • Melhorado o retorno de Desconto, antes o Bling só puxava o Desconto por Cupom, mudamos para puxar qualquer desconto (
    valor negativo), devido o Bling não usar o total do Pedido e sim a soma do total dos Produtos, Frete e Descontos no
    Preço final do Pedido
  • Melhorado o retorno dos dados do Produto para loja com mais de um idioma, sendo retornado nos dados do produto e
    opções para o idioma Português
  • Puxa o campo Localização do Produto e adiciona em Localização do Bling ERP
  • Pode informar um campo para ser usado como Observação no Produto
  • NCM e CEST do Produto tratado para retornar apenas número, pois o Bling pode não reconhecer muito bem se usar pontos
    nestes campos

Atualização recomendada, principalmente se usa descontos sem ser o Cupom como desconto por Pagamento ou quantidade, além
dos novos recursos como Localização e Observação

Versão 1.6.1 - 17/02/2021

  • Corrigido a mensagem de Rastreio no Histórico do Pedido
  • Adicionado link da URL de Rastreamento se tiver com o texto: Rastrear o seu Pedido
  • Suporte ao Opencart 3.0.3.7

Atualização recomendada se deseja exibir o Código de Rastreamento do Bling ERP no Histórico do Pedido

Versão 1.6 - 19/01/2021

  • Adicionado suporte a mais um campo extra CPF/CNPJ
  • Se estiver sem endereço de entrega, fica o endereço de pagamento no lugar

Atualização opcional, recomendada se tiver os campos CPF e CNPJ separados, o primeira campo extra tem prioridade

Versão 1.5 - 15/12/2020

  • Traduzido as mensagens de retorno da API
  • Implementado Callback para a Situação dos Pedidos do Bling, ao mudar uma Situação no Bling é avisado o Opencart e muda
    o Status do Pedido relacionado na sua loja Opencart, antes verifica se o Status já foi usado no Pedido
  • Adicionado Código de Rastreio no comentário Status do Pedido conforme a Situação do Pedido no Bling ERP. O Pedido no
    Bling ERP precisa ter o código do Rastreio para ser adicionado
  • Adicionado mais logs e melhorias no geral
  • Adicionado recurso para importar só Produto ou Importar (Bling -> Opencart) Produto e Variação do Bling como Produto
    normal. Antes sempre importava uma Variação como um Produto no Opencart, agora pode escolher, se quer ou não importar
    este tipo de Produto e para isso foi implementando também verificação para ver se é um Produto principal ou Variação
    usando a consulta do Produto, pois nativamente o Bling não retorna está informação na chamada da API
  • Adicionado cache na consulta do Produto, assim melhora o desempenho, já que atualmente a consulta é usada em dois
    métodos ao Sincronizar/Importar Produtos do Bling -> Opencart
  • No método de Adicionar/Atualizar um Produto do Bling -> Opencart, usamos agora o SKU para descobrir o ID do Produto ou
    da Opção, evitando o detalhe do Bling enviar ID 0, mesmo para Produto já cadastrado na Loja. Importante sempre manter
    o SKU dos Produtos e Opções como únicos.
  • Se não encontrar o Produto na consulta do Bling, não adiciona ele na Loja
  • As Opções retornam agora como ID o ID do Produto V e o ID da Opção, exemplo: 95v45, para evitar conflito entre o ID do
    Produto e da Opção, já que no Bling é salvo ambos no mesmo campo ID
  • Alterado os métodos de atualizar o Preço e Estoque das Opções para usarem o novo formato de ID, mas antes mantendo a
    compatibilidade com o formato anterior do ID da Opçào apenas
  • Mais métodos de consulta na API do Bling implementados, como Consultar os Pedidos, Produtos e Categoria para serem
    usados nos novos recursos ou futuros recursos

Atualização recomendada, principalmente devido as mudanças no ID de retorno da Opção, novo recurso da Situação dos
Pedidos, entre outros recursos novos e melhorias

Versão 1.4.1 - 30/11/2020

  • Melhoria no Número e Complemento do Endereço de Entrega, estava retornando o mesmo do Pagamento, agora retorna o certo
    do Entrega se tiver os dados
  • Melhorado as verificações do SKU das Opções no Produto

Atualização recomendada, principalmente se os clientes costumam usar endereço de entrega diferente do de pagamento e com
campo extra Número e Complemento

Versão 1.4 - 12/11/2020

  • Suporte a mais linguagens na importação do Bling para o Opencart, mesmo assim recomendamos usar apenas Português
    Brasil na linguagem da Loja
  • Adicionado na URL Amigável o código da linguagem se for diferente do Português Brasil, para não ficar com URL Amigável
    duplicada, mesmo assim recomendamos usar apenas Português Brasil na linguagem da Loja
  • Criado log único unificado, com o nome: Code-Bling.log, logo agora todos os logs da melhoria vão para ele
  • Adicionado mais comentários, logs e melhorado eles
  • Melhoria para quando a Opção no Produto é nova, não estava retornando seu ID e com isso não salvava o SKU na primeira
    vez, só nas demais
  • Adicionado intervalo de 330ms/0.33s entre os Produtos para a chamada de atualização para o Bling com a Imagem e link
    externo, devido limite de 3 requisições por segundo da API v2 do Bling
  • Retirado do retorno dos Produtos a chamada para enviar dados extras do Produto, pois se for Produto novo ainda não
    importado, teria que rodar duas vezes a Importação para o Bling salvar a imagem e link do Produto
  • Criado na API o updateProdutoBlingApiV2, em que usa Cache da Lista dos Produtos a ser rodada, para enviar dados extras
    dos Produtos como imagem e url, após rodado limpa o cache, recurso chamado por URL ou por Cron Job
  • Melhoria no tempo de importação dos Produtos do Opencart para o Bling, pois a parte de enviar a imagem e link do
    Produto para o Bling vai ser feita depois pela API updateProdutoBlingApiV2, conforme a lista de Produtos importados

Atualização recomendada, principalmente se usa o recurso de importar as imagens para o Bling, vai tornar mais rápido
também a adição dos Produtos no Bling, pois a parte da imagem vai ser rodada pelo método novo updateProdutoBlingApiV2.

Versão 1.3.1 - 27/07/2020

  • Alterado para sempre marcar Precisa de frete? como sim ao exportar um produto do Bling ERP para o Opencart
  • Suporta a última versão atual do Opencart, o Opencart 3.0.3.6

Atualização opcional, importante apenas se adiciona produtos do Bling para o Opencart e são produtos com envio,
automatizando a marcação.

Versão 1.3 - 26/06/2020

  • Criado 2 Models novos com as funções que ficavam no model product.php e order.php para melhor isolamento e fizemos
    melhorias e novas funções
  • Removido o xml /system/ Codemarket-Bling-Oficial-Model.ocmod.xml, recomendado que seja removido também da loja ao
    atualizar, não precisa mais dele
  • Melhorado busca dos produtos, variações e pedidos, estava retornando em alguns casos dados repitidos
  • Adicionado logs para os novos Models
  • Adicionado novo recurso no Painel para informar a coluna do SKU das Opções, assim pode usar code_sku para a nossa
    melhoria ou outra coluna se usa outra melhoria de SKU nas Opções
  • Formatado o rest_api, adicionado boa parte das mudanças feitas no Codemarket-Bling-Premium.ocmod.xml diretamente para
    ele, adicionado logs para as buscas dos produtos e pedidos, no ínicio e no final

Está versão tem como foco o maior isolamento da melhoria, devido ter lojas que tem muitas mudanças no model product.php
e order.php, gerando raramente conflitos entre as melhorias.
Por isso, fizemos model próprio para isolamento e evitar estes conflitos, além de melhorias gerais no código.

Atualização recomendada, vai melhorar o desempenho e isolamento, além de melhoria geral no código e novos recursos como
poder informar a coluna do SKU das Opções.

Versão 1.2 - 28/05/2020

Fizemos grandes avanços, com o uso do API v2 para auxiliar, já que tem certos dados que não chegam do Bling para o
Opencart.
Foram mais de 15h investidas nesta versão, muito trabalho e testes, com foco principal na parte dos Produtos, importação
e imagens.
Agora pode baixar as imagens do Bling para sua Loja ou enviar da Loja para o Bling.

Melhorias no geral:

  • Adicionado log para o rest_api, chamado CodeBlingRestAPI.log e log para o novo Model CodeBling.log
  • Adicionado filtro para o Pedido Processado do Bling, agora consegue puxar só os Pedidos Processado se desejar
  • Pode definir no Painel qual o Status do Pedido Processado usado na Loja
  • Melhorado a melhoria do SKU nas Opções, pequena reformulação nela e melhorado a parte de salvar o SKU
  • Melhorado as verificações, que verificam se está habilitada e se tem os dados essenciais configurados
  • Adicionado a parte de Complemento do endereço
  • Removido a relação do SKU do Produto, para deixar fico como sendo o SKU que é o correto
  • Adicionado a versão na melhoria

Novos Recursos usando a API v2 do Bling com Model auxiliar:

  • Criado um Model novo com várias funções e mais de 500 linhas de código
  • Usando a API v2 e consultando o Produto no Bling pelo SKU/Código, melhoramos a parte de importar os Produtos do Bling
    para o Opencart
  • Ao Importar um Produto do Bling -> Opencart: Salva o Modelo como SKU, Salva o EAN/GTIN no EAN, Descrição completa em
    HTML, Meta título e SEO URL
  • Ao exportar um Produto do Opencart -> Bling: Envia o Código SKU, Link Externo (URL do Produto na Loja) e Imagens do
    Produto
  • Salva as imagens importadas do Bling -> Opencart ou Exportadas do Opencart -> Bling
  • Pode configurar no Painel se quer importar ou não as imagens
  • Pode configurar no Painel se quer exportar ou não as imagens
  • Pode informar a API Key Bling do API V2 no Painel
  • Criado métodos GET e POST para interagir com a API v2 do Bling

Atualização altamente recomendada, principalmente se deseja importar os produtos do Bling -> Opencart e se deseja
importar/exportar as imagens dos Produtos.
A parte das imagens, leva na média 1s por imagem importada, recomendo após fazer a importação/exportação das imagens
desativar no Painel para assim ficar só as atualizações dos dados nas próximas sincronizações.

Agradecemos a equipe da loja EletroMassa em especial ao Marciel, por terem ajudado com parte do investimento para as
atualizações e sugerido algumas mudanças criadas nesta nova versão.

Versão 1.1 - 23/10/2019

  • Corrigido um detalhe do Bling ERP para a quantidade do Produto principal com opções, está sendo retornado quantidade 0
    pelo Bling, fizemos uma melhoria que mantém a quantidade total das opções para a quantidade do Produto principal ao
    sincronizar o estoque do Bling para o Opencart.

Atualização recomendada para quem usa o recurso de sincronizar estoque do Bling ERP para o Opencart, já que se o produto
principal tiver opção por algum motivo enviam com quantidade 0.

Voltar ao topo