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:

Cadastrar a Loja em Minha Conta → Lojas se não estiver cadastrada
Instalar o Painel Codemarket e verificar a instalação, se não tiver instalado antes
Gerar a Licença de uso para a Loja
Subir os arquivos da melhoria da sua versão do Opencart pelo FTP/SFTP
Em Extensões → Modificações → Clicar no ícone azul para atualizar o cache das Modificações
No Bling ERP criar o usuário da API e validar a comunicação com a Loja.
Clique no ícone da engrenagem no Bling ERP → Sistema
→ Usuários e usuário API → Cique em INCLUIR USUÁRIO do lado direito
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
Marque as Permissões de preferência todas as opções e depois clique em SALVAR
Clique no ícone da engrenagem no Bling ERP → Integrações → Configurações de integração com lojas virtuais e
marketplaces → Plataformas → Escolha Opencart
Informe o nome Nome do canal de venda, recomendamos o nome da Loja - Opencart
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
No Secret key informe a chave Chave de Segurança Rest API cadastrada no Painel da melhoria
Clique em TESTAR e depois do sucesso em SALVAR
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.