Bling

Visão Geral

A nova integração BLIV3 foi criada para adaptar a API do Bling para a versão 3 garantindo a compatibilidade com as funcionalidades existentes no Consistem ERP. A principal mudança é a adoção da autenticação OAuth2.0, com isso foram adicionados os novos campos Client ID, Secret ID, Code, Access Token, Access Token Expira, Refresh Token e Refresh Token Expira no programa Aba Dados Gerais visando a autorização do Consistem ERP na conta Bling.

Foram criados novos endpoints na Aba Endpoints e novos campos e rotina de configurações, sendo a opção Sub-ramo de Atividade na coluna Campo do programa Configurações Gerais por Empresa para a criação/alteração correta dos clientes. O novo programa Configuração Integração Bling - Natureza Operação foi criado para configuração "De/Para" dos IDs das naturezas de operação do Bling para as CFOPs cadastradas no Consistem ERP garantindo a correlação necessária para o envio das Notas Fiscais. As outras configurações seguem conforme a versão anterior do Bling.

Requisitos

Parametrizações

Sistema de Gestão Bling

1. Acesse o Bling com os dados de login;

2. Cadastro e autorização do aplicativo;

   1. Acesse Preferências (Engrenagem) > Todas as Configurações > Cadastros > Cadastro de Aplicativos > + CRIAR NOVO APLICATIVO.

   2. Tipo de Aplicativo: API

   3. Uso do Aplicativo: Privado

   4. Exemplo de Preenchimento: Nome: Consistem Categoria: Plataforma de e-commerce Descrição: Integração Consistem URL de Redirecionamento: https://consistem.com.br/ Preencher as informações de contato. Lista de Escopos: selecionar todos os possíveis, exceto Contratos e Nota de Serviço. Salvar a configuração.

   5. Ao salvar o cadastro serão gerados Client Id, Client Secret, e Link de convite (para acesso ao link e cópia do número Code gerado);

3. Autenticação OAuth2.0.

Sistema Consistem ERP

1. Acesse o programa Integração e no grid selecione a Integração API Bling V3;

1. Acione o Editar para executar o Cadastro de Integração permitindo realizar a parametrização e ativação da integração;

1. Na Aba Dados Gerais inicia-se a configuração e habilita-se a integração. sistema de Gestão Bling.

No grid constam dados de Campos existentes no Bling e, ao lado, na coluna Valor é possível preencher com as informações relacionadas.

1. No botão OAuth2.0 é realizada a validação e geração dos demais dados no grid.

2. No botão Empresa é exibido o programa Configurações Gerais por Empresa, neste são feitas parametrizações por empresa de natureza de estoque, tabela de preço, ramo de atividade, entre outros.

No grid constam dados de Campos existentes no Bling, a empresa em questão e, ao lado, na coluna Valor é possível preencher com as informações relacionadas.

1. No botão Específico é exibido o programa Configuração Integração Bling permitindo configurar os dados da loja para geração do pedido na integração com o Bling. Campos: código da loja configurada no Bling, uma descrição, código da empresa e a tabela de preço para essa loja. Grid: informar o mesmo código da loja para o marketplace, o representante para essa integração quando entrar os pedidos, o tipo de nota, o ramo de atividade, informar a etapa do pedido que irá entrar caso haja, o tipo de nota sem duplicata, a condição de venda, o portador e o tipo de cobrança.

1. No botão Natureza de Operação é exibido o programa Configuração Integração Bling - Natureza Operação para configuração de/para dos IDs das naturezas de operação do Bling para as CFOPs cadastradas no Consistem.

1. No botão Forma de Pagamento é exibido o programa Configuração Integração Bling - Forma de Pagamento permitindo relacionar os códigos das formas de pagamento da Bling com a condição de venda, portador e tipo de cobrança do Consistem para quando for importado um pedido o sistema identificar qual deverá utilizar.

1. No botão Transportadora é executado o programa Configuração Integração Bling - Transportadora/Serviço permitindo configurar a transportadora do Consistem com o serviço ou transportadora da Bling para gerar os dados na entrada do pedido.

1. Retornando para o programa Cadastro de Integração temos a Aba Endpoints que estão disponíveis os endpoints vinculados à integração do Bling. Aqui é possível habilitar e desabilitar os endpoints da integração conforme necessidade e, ainda, verificar e detalhar os possíveis erros caso hajam. Lembrando que a integração de envio ou importação irá ocorrer entre os sistemas caso estejam ativados. O endpoint de contatos não é utilizada pois a Bling não monitora os clientes cadastrados no marketplace e que ainda não realizaram nenhum pedido. Quando o cliente realizar o pedido, automaticamente, o cadastro do mesmo será importado para o Bling e consequentemente para o Consistem ERP. Os endpoints estão separados por grupos conforme citação abaixo, pois precisam estar ativos em conjunto para que funcionem corretamente.

1. Já a Aba Integração Manual poderá ser utilizada caso o usuário queira realizar a geração de uma requisição manual para integração com o sistema terceiro, ou até mesmo para correção de um possível erro. Existem dados predeterminados facilitando a seleção.

1. Agora sim, na Aba Carga Dados é possível a geração de carga de dados inicial para todo o sistema integrado, agilizando assim o processo de integração com o Bling.

1. Retorne ao programa Integração e no grid selecione a Integracao API Bling V3; Clique em Ações e Agendamentos de Tarefas para executar o programa Agendamento de Tarefas; Cadastre um novo agendamento para a integração com o Bling V3 tanto para consumir ou enviar dados.

2. Pronto, configuração realizada com sucesso!

3. O relacionamento dos produtos acontece de maneira automática na primeira carga de dados ou quando a integração localiza um novo produto cadastrado. Para o relacionamento ocorrer deverão estes produtos obrigatoriamente possuir no programa Cadastro de Engenharia o campo Narrativa preenchido com a descrição de como o produto será nomeado para o e-commerce, peso líquido e bruto no Cadastro de Item, cadastro no programa Inclusão de Tabela de Preços e foto no FTP. As fotos deverão ser salvas na pasta de FTP configuradas no programa Cadastro de Integração, na Aba Dados Gerais e o padrão de nomenclatura da imagem é "sequencia_codRefProvisoria_codCorBase_formatoImagem", atualmente somente é compatível o formato de imagem jpg. Quando a integração não ocorre de maneira automática é possível utilizar o programa Importação e Manutenção do Código de Automação do Produto. Neste programa o sistema lê os produtos na Bling e apresenta o relacionamento com os produtos no Consistem ERP. Selecione os produtos desejados, acione o Ações e selecione a opção Atualizar Produto Integração Selecionado, para atualização na Bling.

4. No programa Monitor de Pedidos de Integração é possível consultar os pedidos e os detalhamentos.

   1. Caso tenha algum pedido que não foi integrado, selecione o pedido, clique em Ações e em Importar Pedido Selecionado. Se apresentar algum erro o sistema irá detalhar o motivo para que seja corrigido.

Fluxo do Processo