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.
Documentação Bling ERP Premium Opencart
Módulo com 20 avaliações e 346 pedidos 10/05/2024, rumo a mais de 400 pedidos, obrigado a todos.

IMPORTANTE: O Bling está descontinuando a API V2 e usamos para os recursos adicionais. Calendário sobre, basicamente até dia 01/08/2024 vão descontinuar a API V2
Já novas contas do Bling ERP não pega mais a API V2, logo recomendamos para novas contas aguardar nossa atualização.
Pretendemos terminar a nova versão com suporte a API V3 até 06/2024, qualquer novidades vamos avisar aqui, por E-mail para quem já comprou e em nossas Redes Sociais.

• 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:

• 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

Novos recursos Versão 2.3 e 2.2 - 01/02/2022

• Adicionado no Painel para informar se quer subir Produtos desativados do Opencart para o Bling ERP

Promoção do Bling para o Opencart:

• Produto com Promoção no Bling pode ser importado 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

Importar Pedidos do Opencart para o Bling pela API V2:

• Importa os Pedidos do Opencart para o Bling usando a API V2 para vários Pedidos
• Pode escolher os Status dos Pedidos para Enviar
• 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
• Pode definir a quantidade de Pedidos para verificar e importar
• Pode definir o intervalo em horas para verificar
• Pode informar o tempo limite para rodar
• Pode informar o valor mínimo, por exemplo 0, vai retornar Pedidos com valor 0 ou maior, já se informar 1, só vai retornar Pedidos com valor 1 ou maior
• Cache para melhor desempenho
• Verifica antes se já foi enviado o Pedido para o Bling ERP
• Cria/atualiza antes o Cadastro do Cliente
• Cria o Pedido e Cadastro do Cliente com os IDs usados no Opencart
• Pode ainda usar o modo tradicional pelo Painel do Bling ou este novo recurso pela URL no modo Manual ou por Cron Job para rodar automaticamente

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.

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 02/02/2022 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 antiga 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.5 - 11/08/2022
Foco principal em informativo para a URL updateProdutoBlingApiV2 e updatePriceAndStockBlingApiV2 e duas novas URLS para ver os caches dos Produtos e limpar eles

Melhorias para os recursos da URL updateProdutoBlingApiV2 e updatePriceAndStockBlingApiV2
Estes recursos informam dados extras para os Produtos do Opencart para o Bling e atualizam o preço e estoque

• Salvo o SKU na atualização dos Produtos do Opencart para o Bling junto ao seu ID
• Informação do SKU e ID do Produto ao atualizar os Produtos do Opencart para o Bling
• Mais informativo nos textos das URLs que atualizam os Produtos do Opencart para o Bling
• Atualização dos dados das variações/opções puxando a descrição, imagens, link do produto e fornecedor do produto pai/principal
• Tempo de espera de 350ms para 500ms ao atualizar os Produtos do Opencart para o Bling devido o limite de 3 chamadas por segundo

• Novos recursos de limpar o cache dos Produtos e de ver o cache dos Produtos usando URLs
• Novos recursos adicionados ao Painel na aba Documentação para facilitar o uso e também o time_limit
• Mais logs e documentação no geral

Atualização recomendada, devido os novos recursos e melhorias

Versão 2.4.1 - 14/07/2022

• Melhoria na sincronização dos Preços da versão 2.4, que estava aparecendo um aviso ao Sincronizar os Preços do Bling para o Opencart/Loja
• Mais logs e comentários
• Retirado o uso do cache do Produto ao atualizar o preço ou ao atualizar o Produto do Bling para o Opencart, para evitar que seja usado dados não tão atuais do Produto

Atualização muito recomendada, principalmente se usa o Bling 2.4.
Estamos fazendo a atualização gratuitamente para todos que usam o 2.4 ou que estão ainda no prazo do Suporte e Atualização/Download.

Versão 2.4 - 24/06/2022
Diversos recursos novos focados nas Observações dos Pedidos, Dados do Fornecedor no Produto, Promoção atualizada ao atualizar o preço e muito mais

• Adicionado o método updatePriceAndStockBlingApiV2, envia dados extras dos Produtos para o Bling, exceto a imagem, foco no Preço e Quantidade, podendo informar o intervalo em segundos para consultar, assim atualiza apenas produtos recentemente modificados conforme o intervalo desejado
• Novo recurso para atualizar os certos dados dos produtos do Opencart para o Bling por Cron Job como: preço, estoque e outros dados, rodando para os produtos recentemente adicionados
• Novo recurso já preparado a montagem de uso na Documentação do Painel, pode usar a variável &second= para informar o intervalo em segundos dos produtos que deseja atualizar no Bling, exemplo: 60, vai puxar todos os produtos atualizados em 60s e atualizar no Bling se existir
• Dados extras do Fornecedor no produto podendo configurar a tabela, coluna e campo usado na busca se não for o ID do Produto, tudo pelo Painel de Configuração
• Mensagem da observação normal e privada do Pedido usando a API V2 podendo configurar a mensagem na configuração e com uso de coringas/variáveis
• Mais dados extras para as observações como forma de entrega, valor da entrega, valor de desconto, código da entrega e muito mais
• Ao todo 13 coringas/variáveis para as observações
• Modo debug colocando na URL &xml=1 para a importação dos Pedidos para ver os dados do XML montado
• Melhorado a documentação no geral do código e logs
• Ao sincronizar/atualizar o Preço dos produtos do Bling para o Opencart, atualiza também as Promoções, não precisando mais sincronizar os Produtos por completo para atualizar as Promoções

Resumo:
Adição de recursos do Fornecedor, Observações dos pedidos criada as mensagens com diversos coringas pelo Painel e atualização dos Preços, Estoque e outros do Bling para o Opencart de forma simples por Cron Job ou rodando a URL

Atualização muito recomendada, devido os novos recursos e melhorias no geral.

Versão 2.3.3 - 02/05/2022
Recursos para a Função de Importar Pedidos pela API V2 e updateProdutoBlingApiV2

• Adicionado o recurso de adicionar um Pedido pela API V2 do Bling ERP, estava sem no Zip anterior, por isso estamos oferecendo uma atualização gratuita feita pela nossa equipe para os Pedidos feitos até 01/02/2022 ou mais atual
• No recurso de atualizar os dados dos Produtos, o updateProdutoBlingApiV2 adicionado mais informações como quantidade de produtos a ser rodado, produtos rodados, quanto falta e também quando chega no tempo limite é atualizado no Cache a listagem dos Produtos removendo os já rodados, assim diminui nas próximas requisições a quantidade de produtos para ser verificado, lembrando que já tem também o Cache por produto atualizado
• Adicionado mais alguns logs e comentários
• No ID da Linguagem, se não encontrar o code pt-br vai retornar o ID 1, que seria a primeira linguagem. Infelizmente tem algumas lojas que usam o code errado do Português Brasil, por isso fizemos este pequeno ajuste
• Comentado o if que verifica a versão do Opencart para os Campos Extras, pois não precisa mais, devido o foco ser no Opencart 3 e 2.3.0.2

Atualização muito importante, devido a adição de algumas mudanças da versão anterior adicionadas no novo Zip e outras melhorias extras

Versão 2.3.2 - 08/03/2022
Recursos para a Função de Importar Pedidos pela API V2

• Adicionado Cache próprio na API com duração padrão de 48h, usado no filtro dos Produtos, Adição dos Pedidos API V2 e demais recursos que usam cache pela API do Módulo/Integração
• Adicionado mais logs e comentários
• Retirado o reward, pois não é usado atualmente pelo Bling ERP
• Tratado o nome dos Produtos retornados do Pedido, tirando & e colocando E no lugar, pois o & pode dar problema no XML usado na API V2
• Diversos recursos novos para a API de Enviar os Pedidos usando a API V2 do Bling ERP, recursos como: Tempo limite para rodar o código, intervalo trocado de dias para horas para ter maior controle, preço mínimo para poder puxar pedidos com valor 0 no Preço ou maior, id inicial e final para o intervalo a ser adicionado otimizando a busca dos pedidos e outros recursos novos
• Documentação do novo recurso de importar Pedidos pela API V2 do Bling ERP informando dos novos recursos

Atualização recomendada, devido os novos recursos e melhorias, tendo ainda mais controle e recursos na API que importa os Pedidos do Opencart para o Bling ERP

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
• Nova documentação
• Documentação do novo recurso de importar Pedidos pela API V2 do Bling ERP

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.

Atualização opcional, mas interessante se já importou alguns Pedidos pelo modo Tradicional e deseja usar o novo recurso pela API V2

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ã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
• Melhorado no geral a formatação para o padrão PSR-12 e mais alguns Logs

Em breve, vamos lançar a versão 2.2, 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.9

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

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 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

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

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

• 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

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

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

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

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

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

• 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.9
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