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, 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, Salva o EAN/GTIN no EAN, 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, 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
• 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 importar
• 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
• 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 Normal ou não importar eles, só importando Produto Normal ou Pai/Principal
• 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.log, fica na pasta storage/logs
• Envia o campo Localização do Produto e um campo Observação do Produto para o Bling ERP
• Envia o valor de Desconto do Pedido, caso tenha algum desconto ativo
• Campos extras enviados no Produto:

• Campos extras enviados no Pedido:

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

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.

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 1702/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.

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

Sobre Variação e Opções
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 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.7
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