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, já adicionamos ela nos arquivos e de forma correta usando xml
• 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
• Pode configurar no Painel se quer importar ou não as imagens
• Pode configurar no Painel se quer exportar ou não as imagens
• 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 para o rest_api, chamado CodeBlingRestAPI.log e log para os novos Models CodeBling.log, CodeBlingProduto.log e CodeBlingPedido.log
• 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

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.

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, devido 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 27/07/2020 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 no xml: Codemarket-Bling-Oficial-Model.ocmod.xml para assim a Loja não precisar mexer diretamente nos arquivos originais do Opencart, já está incluso os arquivos junto da nossa integração, nela pode ver os recursos suportados pela integração do Bling.
Site Oficial Bling ERP - Planos

Arquivos
A estrutura dessa integração é composta por:
Uma pasta system contendo 2 xmls, que são:
Codemarket-Bling-Opcao-SKU.ocmod.xml, contém a melhoria que adiciona o SKU nas Opções
Codemarket-Bling-Premium.ocmod.xml, contém as melhorias feitas para o Bling dos campos extras e mudança da Chave de segurança pelo Painel

Pasta catalog, controller, feed contendo o arquivo rest_api.php
catalog/controller/feed/rest_api.php
Arquivo da integração Oifical do Bling, fundamental para o funcionamento da integração

Model ​catalog/model/module/code_bling.php
Ele melhora alguns recursos usando a API v2 do Bling, contém mais de 500 linhas de código, criado na versão 1.2 da nossa melhoria
Model code_bling_native_order.php e code_bling_native_product.php,  contém as funções feita pela integração Oficial do Bling, novas funções e melhorias, criado na versão 1.3 da nossa melhoria

Observação:
Só nos responsabilizamos pelos recursos extras propostas pela nossa melhoria, o funcionamento correto da Integração depende do Bling ERP e sua equipe que fizeram a integração.
Nossa melhoria adiciona campos e alguns recursos que ficaram pendente, porém ainda depende da integração Oficial do Bling para o seu funcionamento.

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.

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

Instalr o Painel Codemarket, configurar e fazer as etapas sugeridas pela Documentação do Bling, a parte do Painel não usa, pois usa o nosso Painel para por a chave de segurança e outros recursos extras.

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