Integração Bling ERP Premium Opencart

Integração Bling ERP Premium Opencart desenvolvido pela Codemarket, deixa mais completa a integração Oficial do Bling ERP para Opencart com campos extras como CPF, Número, Marca, SKU nas Opções, importação/exportação das Imagens dos Produtos, Webhook do Estoque e Situação no Bling, Código de Rastreio do Envio, Logs, melhorias em geral e muito mais.

Acompanha também os recursos da melhoria SKU na Opção feita para funcionar no Painel Codemarket para essa integração do Bling.
Somos Parceiros Oficiais, veja nossa página de Parceria com o Bling e faça sua inscrição no Bling ERP por ela, ajudando nossa equipe.​

Instalação Gratuita
Já acompanha uma Instalação feita pela nossa equipe Codemarket, prazo estimado 3-5 dias úteis.

O que faz

• Melhora a integração Oficial do Bling ERP para Opencart, com novos recursos e melhorias, não precisa dos arquivos dela
• Painel Codemarket com vários recursos
• Definir a Chave de Acesso pelo Painel Codemarket, evitando usar a Chave padrão bling123, com isso fica mais seguro o acesso a API
• Informar a API Key Bling para o uso da API v2 do Bling
• Ao exportar um Produto do Bling -> Opencart: Salva o Modelo como SKU, GTIN/EAN, NCM, CEST, Descrição completa em HTML, Meta título, SEO URL e Imagens, recursos extras devido o uso da API v2
• Ao importar um Produto do Opencart -> Bling: Envia o Código SKU,  GTIN/EAN, NCM, CEST, Link Externo (URL do Produto na Loja) e Imagens do Produto, podendo ativar no Painel se deseja ou não importar, recursos extras devido o uso da API v2
• Ao importar uma Opção do Opencart -> Bling: Envia o Código SKU,  Link Externo (URL do Produto pai na Loja) e Descrição (produto pai), Preço se diferente do Produto Pai, recursos extras devido o uso da API v2
• Uso de Cache principalmente para passar os dados extras dos Produtos do Opencart -> Bling ERP otimizando o desempenho e time_limit para por um tempo máximo para rodar a URL que passa os dados extras
• Todos os recursos nativos da integração Oficial do Bling mantidos, logo os dados enviados na importação/exportação dos produtos, exportação dos pedidos e outros continuam igual, melhorado alguns detalhes e adicionado novos recursos informados nesta descrição, recursos como imagem e dados extras dos Produtos e Pedidos
• 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
• 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
• Além dos campos importados, importa também do Bling -> Opencart  Dimensões, Peso, Marca que precisa de Frete, Preço, Quantidade, não puxa a Promoção, pois o Bling informa como Preço normal atualmente para o Opencart
• Converte 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 ao enviar para o Bling ERP
• Relacionar o Status do Pedido Processado do Bling com um Status do Opencart, exemplo: Pedido Pago, assim pode filtrar no Bling pelo Status Pedido Processado e importar só os Pedidos pagos se desejar
• Salva as imagens importadas do Bling -> Opencart ou Exportadas do Opencart -> Bling
• API para exportar as imagens do Opencart -> Bling, com intervalo de 0.330ms/0.33s por Produto respeitando o limite de 3 chamadas por segundo do Bling, podendo ser rodada manualmente ou por Cron Job
• Pode configurar no Painel se quer importar/exportar ou não as imagens
• Pode configurar no Painel se quer importar Produtos Variação como Opção do Produto Pai/Principal, Normal ou não importar, só importando Produto Normal ou Pai/Principal
• Pode importar o Produto Variação como uma Opção de um Produto Pai no Opencart, 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
• Pode importar/exportar os campos GTIN/EAN, NCM e CEST e ao enviar para o Bling ERP são tratados para ficar apenas número
• Envia o campo Localização do Produto e um campo Observação do Produto para o Bling ERP e do Bling ERP para o Opencart
• Pode alterar de forma automática os estoques dos Produtos e Opções no Opencart conforme muda no Bling ERP o estoque deles, recurso muito importante se integrou o Bling com outras plataformas e Marketplaces, pois ao mudar o estoque no Bling ele avisa a Loja e muda nela o Estoque dos Produtos e Opções
• Pode relacionar os Status dos Pedidos com as Situações dos Pedidos no Bling ERP
• Pode alterar os Status dos Pedidos conforme as mudanças da Situação dos Pedidos no Bling ERP por Callback, verifica também se já foi usado o Status
• Adiciona o Código de Rastreio no Comentário do Status do Pedido se tiver no Bling ERP e pode escolher em qual Status vai adicionar
• Adiciona a URL de Rastreamento no Status do Pedido se tiver no Bling ERP, fica o texto: Restrear o seu Pedido
• As Opções ao serem importados pelo Bling (Opencart -> Bling) tem ID com o ID do Produto e o ID da Opção, para evitar conflito com o ID do Produto, exemplo: 95v45, sendo 95 o ID do Produto e 45 o ID da Opção no Produto
• Relacionar os Campos Extras pelo Painel
• Relacionar alguns Campos do Produto pelo Painel
• Ativar ou Desativar a integração com o Bling ERP, se desativar a API fica bloqueada
• Model alterado do Bling adicionado por xml, não precisa mexer direto no Model do Opencart
• Melhoria extra que adiciona SKU nas Opções do Produto enviando o SKU da Opção para o Bling também, recurso fundamental para não replicarem as opções, pois usam o SKU da opção para verificação
• Melhoria SKU Opção podendo exibir na Fatura o SKU/Código da Opção
• Pode informar qual a coluna usa para o SKU das opções, se usa nossa melhoria é a code_sku, caso use outra versão do Opencart sem ser a internacional, usam o sku como o nome da coluna
• Log único com o nome: Code-Bling, fica na pasta storage/logs, no nome do log fica o mês e ano, logo 1 log por mês e ano, evitando ficar muito grande
• Método para limpar os logs da melhoria
• Log completo inclusive no caso de algum detalhe no Curl para ser fácil identificar o detalhe
• Envia o valor de Desconto do Pedido, caso tenha algum desconto ativo
• Campos extras enviados no Produto Opencart -> Bling:

NCM, CEST, Preço Promocional e Marca

• Campos extras enviados no Pedido Opencart -> Bling:

Tipo de Pessoa (Júridica ou Física), CPF/CNPJ, Número Endereço de Pagamento, Número Endereço de Entrega, Bairro Endereço de Pagamento, Bairro Endereço de Entrega e Celular
Suporte a dois Campos Extras CPF/CNPJ caso tenha separado eles, o primeiro campo extra tem prioridade

Campos extras enviados destacados em verde:

Obs: Precisam ter os dados preenchidos para ser usado e a promoção só se for sem grupo de cliente do Opencart -> Bling, pois o rest_api não tem grupo de cliente definido.

Painel para relacionar os campos extras a serem enviados:


Github da integração Oficial, não usar esse Git, pois colocamos os Models que eles alteram em Models próprios, para evitar mexer direto em arquivos nativos do Opencart e também adicionamos o retorno do SKU da opção nele e outras melhorias.
​Aos poucos vamos adicionando novos recursos, conforme a demanda e necessidade da maioria dos clientes.

Toda interação é feita dentro do Dashboard do Bling ERP, seja para importar os Pedidos do Opencart para o Bling ou a parte de Importar/Exportar Produtos, Sincronizar Estoques e Preços, pois o Bling usa nossa API na sua loja Opencart para interagir.
Somente a parte de Callback do estoque e da situação do Pedido no Bling ERP é automática e avisada a loja quando ocorre mudanças.

Integração sem o uso de Criptografia como o ionCube, garantindo assim melhor desempenho e transparência, assim como todos os nossos módulos e integrações, podendo ser visto o código fonte adicionado em sua loja da melhoria e até se desejar fazer customizações, muito útil também para loja que faz auditoria e validação das melhorias adicionadas.

Recomendamos também o uso da melhoria:
Gerador Automático - URL Amigável, SKU e Modelo dos Produtos para Opencart
Ela ajuda muito na geração automática dos SKU dos Produtos e Opções, além do Modelo e URL Amigável. Sendo muito interessante para loja com vários produtos, pois poupa muito tempo da equipe e evita possíveis erros como cadastro igual de SKU, sendo para o Bling fundamental o SKU único nos Produtos e Opções, pois usam como o código de identificação.

Sistema de Variações no Produto - Opções relacionadas (tamanho, cor...) Opencart
Ela vai ajudar se tiver Produtos contendo Cor e Tamanho, onde a Cor pode ser Produtos Normais relacionados nas Variações e os Tamanhos Opções simples, tem outros usos também como Produtos com diferentes como Modelos diferentes ou se deseja relacionar certos Produtos, muito usado em grandes lojas como Nike, NetShoes, entre outras.

Recurso de informar os dados do Rastreio do Pedido, veja um exemplo de como fica:

Sobre o Bling ERP
O Bling é um ERP online de baixo custo, com vários recursos e integrações, atende principalmente lojas de pequeno e médio porte, sendo um dos mais usados em E-commerce bdevido sua API, recursos e bom preço.
Uma grande vantagem é que se integram com a maioria dos Marketplaces também, não precisando de um Hub de Integrações com Marketplace ou pelo menos não para alguns casos de uso.
Os planos atualmente no dia 03/06/2021 variam de R$ 25,00 até R$ 100,00 mensal, sendo a partir do plano Cobalto de R$ 50,00 mensal no qual começa o suporte a integração com E-commerce, para mais detalhes dos Planos e Recursos, veja a página de Planos do Bling ERP.

Documentação da Integração Oficial Bling ERP, a forma de instalação muda, pois a parte do Model que eles alteraram o order.php e product.php, colocamos em arquivos a parte isolados para assim a Loja não precisar mexer diretamente nos arquivos originais do Opencart, além de outras melhorias e recursos.
Site Oficial Bling ERP - Planos

Observação:
Só nos responsabilizamos pelos recursos extras propostas pela nossa melhoria, o funcionamento correto da Integração depende também da API do Bling ERP e sua camada do Opencart.
Nossa melhoria adiciona campos e alguns recursos que ficaram pendente, novos recursos e melhorias no geral.

Na integração Oficial do Bling ERP, colocam uma camada que recebe os dados do Opencart, essa camada a mais de código não usa diretamente os recursos da API v2 do Bling, por isso a forma de integração e retorno dos dados é diferente e só é possível realizar certo recursos dentro da limitação técnica dessa camada, no qual não suporta no momento recursos como informar imagens, categorias e outros detalhes, adicionamos todos os campos extras documentados e que foram possíveis integrar, apenas o fornecedor que não, pois ao adicioná-los, o Bling irá replicá-los e também pelo Opencart não ter nativamente a informação do fornecedor e sim a marca/fabricante do produto no qual adicionamos nos dados enviados do produto.

A partir da versão 1.2, usamos a API v2 para ajudar em alguns recursos pendente informados acima, como a parte de salvar imagens e outros dados extras.

Instalação
Já tenho instalado a integração Oficial do Bling, nesse caso recomendamos, que retire as mudanças adicionadas manualmente no model order.php e product.php pela integração Oficial do Bling, adicionamos esses recursos e melhorias em model próprios isolados e melhorados.

Pode subir depois normalmente na raiz da Loja os arquivos da sua versão Opencart, vai conter uma pasta catalog e system com seus arquivos e subpastas, nenhum arquivo sobrescreve arquivos nativos do Opencart, atualize o rest_api.php com o nosso se já tiver instalado ele.
Depois só ativar o xml em Extensões -> Modificações -> clicar no ícone azul de Limpar Cache das Modificações

Instalar o Painel Codemarket

Adicionado na versão 1.8 suporte a Variação como Opção no Opencart
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 : 

Sobre Variação e Opções (Detalhe antes da versão 1.8 da nossa integração)
O Bling trata as Opções como variação, ou seja, uma Opção Cor Azul ou Tamanho M, no Bling vira um produto de variação ligado ao Produto principal no Bling.
Assim se um produto no Opencart tem 5 opções, no Bling vai ser criado 6 produtos, sendo o principal e o restante 5 produtos variação, que são as Opções no Opencart.

Já quando importa do Bling para o Opencart, as variações no Opencart viram produtos novos, pois o Bling vê elas como produtos variação e não como opções.
Quando faz o inverso, ou seja, importa do Opencart para o Bling, os produtos com opções são criados como produtos variação no Bling e quando faz a sincronia vai continuar como opções no Opencart, pois foi feita a referência, ou seja, o Bling sabe neste caso que os produtos variações tem o mesmo ID do Produto principal no Opencart, com isso atualiza as Opções do Produto quando sincroniza os produtos variações.

Resumindo:
Produto variação novo importando do Bling para o Opencart = Novo produto no Opencart
Produto novo com opções importado do Opencart para o Bling = Novo produto do tipo variação para as opções e o principal vira um produto principal no Bling ERP

O ideal então é importar do Opencart para o Bling os Produtos, assim o Bling entendi que os produtos variações importados são opções no Opencart e quando for sincronizar do Bling para o Opencart não vai criar novos produtos.

Caso ocorra erro na exportação dos produtos Bling -> Opencart
O Bling por algum motivo vai zerar o ID  de referência do Produto, por isso em caso de erro na sincronização ou exportação dos produtos do Bling para o Opencart, bom verificar se o ID do Produto não ficou 0 no Bling ERP.

Este ID pode ser visto clicando no carrinho ao lado direito da listagem dos Produtos, caso esteja 0 para a loja Opencart, precisa ser adicionado o correto ou quando sincronizar de novo, vai ser criado um novo Produto no Opencart.
Já avisamos a equipe do Bling deste detalhe.

Lançamento 
Versão 1.0 - 30/01/2019

Atualização
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, no qual 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.

Compatibilidade
Opencart 3 até 3.0.3.8
Opencart 2.3.0.2
Painel Codemarket
Conta ativa no Bling ERP com Plano que suporta Integração com E-commerce
Espaço sobrando no Bling ERP para receber os dados dos Produtos, Pedidos, Clientes, entre outros