Central de Ajuda

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user Daniele Schmidt

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Daniele Schmidt

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Easy Heading Macro
headingIndent5
navigationTitleGuia
selectorh1
navigationWidth200

Secção

Visão geral

A nova integração BLIV3 foi criada para adaptar a API do Bling a versão 3, garantindo a migração contínua da versão 2 para a versão 3, mantendo as funcionalidades existentes no Consistem ERP. A principal mudança é a adoção da autenticação OAuth2.0, que para seu funcionamento, novos campos de configuração foram adicionados no programa Aba Dados Gerais (CSINTEGRACAO010ATAB1) sendo ClientId, SecretId, Code, AccessToken, Access Token Expira, RefreshToken e Refresh Token Expira, obtidos por adaptações e da necessidade do cadastro e autorização do aplicativo Consistem na conta Bling. Agora com a estrutura das requisições reformuladas e em JSON, foram criados novos endpoints na Aba Endpoints (CSINTEGRACAO010ATAB2) 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 (CSINTEGRACAO010ATAB1A) para a criação/alteração correta dos clientes e novo programa Configuração Integração Bling - Natureza Operação (CCPV093C) para configuração "De/Para" dos IDs das naturezas de operação do Bling para as CFOPs cadastradas no Consistem, devem ser verificadas as naturezas de operação cadastradas no Bling, pois são necessárias para o envio correto das Notas Fiscais. Além de uma pequena mudança na coluna Marketplace do programa Configuração Integração Bling (CCPV093). As outras configurações seguem conforme a versão anterior do Bling.

Descontinuação da API V2 a partir de 01/08/2024 de acordo com o calendário do BlingO Sistema de Gestão Bling gerencia as vendas originadas em diferentes marketplaces, ao finalizar uma venda em um destes canais, ocorre a importação de um pedido a esta plataforma de e-commerce. A integração com o Consistem ERP facilita a continuidade do processo das vendas, como o controle de separação das mercadorias, emissão de notas fiscais e boletos.

É gerado na Bling.
    • Coluna
    width600

    Requisitos

    Consistem ERPBling

    Compatibilidade:6.13.135, 6.14.87, 7.0.31 3 ou superiores do Consistem ERP.

    Lembrando que a versão 6.13 se aplica ao ramo de Confecção.
    Lembrando que a versão a partir da 6.14 se aplica aos ramos de Confecção e Padrão.

    Módulos Componentes, Comercial, Financeiro, Estoque e Itens.

    Tabela de preço configurada no programa Inclusão de Tabela de Preços (CCPV181).

    Aquisição de licença Orientamos o acompanhamento da nossa equipe de consultores.

    Módulo de integração com Bling 3 ativo.

    		Aquisição do plano com integração E-Commerce.
    Saiba mais

    Parametrizações

    Sistema de Gestão Bling

    1. Acesse o Bling com os dados de login;
    2. Cadastre o usuário do tipo API e realize a geração do token da API;
    3. Configure o marketplace para integrar com o Bling;
      1. Realize a configuração e cadastro dos produtos, vendas, integração automática de pedidos e meios de pagamento;
    4. Configure a logística;
    5. Consulte os produtos cadastrados no Bling e realize a exportação para o marketplace;
      Importante: atente-se ao cadastro dos pesos líquido e bruto dos produtos, caso não sejam preenchidas essas informações não será possível realizar a exportação para o marketplace.
      1. Após realizada a exportação da primeira vez não terá a necessidade de refazer, pois será feita atualização de forma automática, sempre atualizando preço e estoque.
      6. Realize a importação dos pedidos de venda.
    Image Removed
    1. 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);
    2. Autenticação OAuth2.0.

      Image Added

    Sistema Consistem ERP

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



    2. Acione o Editar para executar o Cadastro de Integração (CSINTEGRACAO010A) permitindo realizar a parametrização e ativação da integração.



    3. Na Aba Dados Gerais (CSINTEGRACAO010ATAB1) inicia-se a configuração e habilita-se a integração.
      Importante: se atentar ao campo Situação, pois se permanecer como Inativo não irá funcionar a integração.
      Importante: os dados incluídos no sistema Consistem ERP devem ser os mesmos que foram cadastrados no sistema de Gestão Bling.

      1. No grid constam dados de

        2. CampO pedido é gerado no Consistem ERPos

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

        CampoValor
    		API Key
    Client IDInformação disponível na Bling conforme o cadastro.
    Secret IDInformação disponível na Bling conforme o cadastro.
    Code

    O Code é essencial para geração dos Tokens pela primeira vez.
    Após ter gerado o cadastro do aplicativo, copie o "Link de Convite" e cole no navegador, irá retornar a página home da consistem com o "Code" inserido no URL, exemplo de URL de Callback: https://consistem.com.br/?code=e5cd5ce586bb7b1d539baaa1198c5f994b6fc9df&state=9bcd9f020f42421d518b08de09cb5289
    Copie a parte em laranja = Code, cole na configuração de integração no consistem e clique no botão OAuth2.0, pronto, sua autenticação irá gerar os Tokens e as respectivas datas de expiração, caso não tenha gerado é porque passou de 1 minuto, tente novamente com o link de convite.
    Observação: caso tenha expirado o "Refresh Token" (Refresh Token Expira) este processo deve ser feito novamente, lembrando que o Refresh Token expira em 30 dias e sempre se renova automaticamente.

    Access TokenGerado automaticamente após acionar OAuth2.0. Com esse acesso será possível realizar requisições na API do Bling.
    Access Token Expira

    Gerado automaticamente após acionar OAuth2.0. Válido por 6 horas.

    Após a expiração do Access Token, deverá ser utilizado o RefreshToken para obter novos tokens.

    Refresh TokenGerado automaticamente após acionar OAuth2.0.
    Refresh Token Expira

    Gerado automaticamente após acionar OAuth2.0. Válido por 30 dias.

    Após a expiração do Refresh Token deverá repetir o processo inicial para geração de novo Code.

    Clonar Dados PaiCombo Sim ou Não. 

  • Diretório FTPQuando for enviar as imagens para algum FTP.
    Envia Imagem URL FTPCombo Sim ou Não.
    Sugere Pedido PPCP PadrãoCombo Sim ou Não.
    Intervalo Importação em minutosIntervalo de tempo importação dos pedidos
    Motivo pra Pedidos CanceladoMotivo para quando um pedido for Cancelado
    Porta FTPCaso haja.
    Senha FTPCaso haja.
    Situação pra Pedidos BloqueadoInformação disponível na Bling conforme o cadastro.
    Situação pra Pedidos CanceladoInformação disponível na Bling conforme o cadastro.
    Sugere Cor Pedido ParcialCombo Sim ou Não.
    Sugere Tamanho Pedido ParcialCombo Sim ou Não.
    Forma de Envio de ImagemCombo de opções disponíveis.
    URL Imagem/FTPCaso haja.
    URL Imagem BlingCaso haja.
    Usuário FTPCaso haja.


  • No botão OAuth2.0 é realizada a validação e geração dos demais dados no grid.
  • No botão Empresa é exibido o programa Configurações Gerais por Empresa (CSINTEGRACAO010ATAB1A), neste são feitas parametrizações por empresa de natureza de estoque, tabela de preço, ramo de atividade, entre outros.
    Image Removed
    Image Added

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

      CampoValor
      CategoriaCategoria padrão.
      NaturezaQuais naturezas fazem parte da integração.
      Ramo de AtividadeQual o ramo de atividade para os novos clientes que surgirem.
      RepresentanteQual o representante padrão.
      Situação Pedido Venda ImportaçãoQuais as situações do pedido de venda que irão ser monitorados. Quando configurado aqui, o sistema não irá mais considerar o tempo de intervalo de importação dos pedidos que foi preenchido na tela anterior. 
      Situação Pedido Venda Bling depois de CanceladoDeterminar a situação que o pedido será considerado no Bling depois de Cancelado no Consistem.
      Sub-ramo de AtividadeQual o sub-ramo de atividade para os novos clientes que surgirem.
      Tabela de Preço CustoTabela de preço padrão.
      Tabela de Preço VendaTabela de preço padrão.
  • No botão botão Específico é exibido o programa Configuração Integração Bling (CCPV093) permitindo configurar os dados da loja para geração do pedido na integração com o o Bling. 
    1. Campos: código da loja configurada no Bling, uma descrição, código da empresa e a tabela de preço para essa loja.
    2. Grid: informar qual o campo da integraçãomesmo 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.
      Image Removed
      Image Added

  • No botão Natureza de Operação é exibido o programa Configuração Integração Bling - Natureza Operação (CCPV093C) para configuração de/para dos IDs das naturezas de operação do Bling para as CFOPs cadastradas no Consistem.
    Importante: deve ser verificado se no Bling as naturezas de operação estão cadastradas corretamente para envio da NF-e.

    Image Added

  • No botão Forma de Pagamento é exibido o programa Configuração Integração Bling - Forma de Pagamento (CCPV093B) 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.
    Image Removed
    Image Added

  • No botão Transportadora é executado o programa Configuração Integração Bling - Transportadora/Serviço (CCPV093A) permitindo configurar a transportadora do Consistem com o serviço ou transportadora da Bling para gerar os dados na entrada do pedido.
    Importante: o código do serviço é o mesmo que foi cadastrado no Bling.
    Image Removed
    Image Added

  • Retornando para o programa Cadastro de Integração (CSINTEGRACAO010A) temos a Aba Endpoints (CSINTEGRACAO010ATAB2) 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.

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

    2. Os endpoints estão separados por grupos conforme citação abaixo, pois precisam estar ativos em conjunto para que funcionem corretamente.

      DELETEv2/produto/{codProduto}/jsonGETv2/jsonImportar IndisponívelGETv2formaspagamentojsonImportar Forma de Pagamento > Consistemv2pedidocodPedido/json Pedido Automação GET
      MétodoEndpointDescriçãoFluxo de integração
      GET/Api/
      v3/contatosImportar Cliente BlingBling > Consistem
      POST
      Enviar Exclusão Produto BlingConsistem > Bling
      /Api/
      v3/contatos
      Enviar Cliente Bling
      Consistem > Bling
      PUT/Api/
      v3/
      contatos/
      {codCliente}Enviar Atualização de Cliente BlingConsistem > Bling
      GET/Api/
      v3/
      contatos/{
      idContato}
      Importar
      Cliente-ID Bling V3Bling > Consistem

      v2pedidos/{stringPagina}/jsonGETv2produtocodProduto/jsonGET
      POST/Api/
      v3/
      Importar Pedido BlingBling > Consistem
      categorias/produtosEnviar Categoria BlingConsistem > Bling
      PUT/Api/
      v3/categorias/
      produtos/{
      codCategoria}
      Obter Código Produto Loja BlingIndisponível
      Enviar Atualização de Categoria BlingConsistem > Bling


      v2/produtos/{stringPagina}/jsonGETv2situacaostringModulo/jsonPOSTv2categoria/json Categoria BlingPOSTv2contatojsonPOSTv2deposito/jsonEnviar Natureza > Blingv2formapagamento/json Forma de Pagamento IndisponívelPOSTv2notafiscaljsonIndisponívelv2produtojsonPOSTv2produto/json Atualização POSTv2/produtoLoja/{codLoja}/json Loja v2categoriacodCategoriajson de Categoria PUTv2contatocodCliente}/json
       POST/Api/
      v3/depositosEnviar Natureza Bling Consistem > Bling
       PUT
      Importar Produto BlingBling > Consistem
      /Api/
      v3/
      depositos/{
      codNatureza}
      Importar Cadastro de Situação BlingBling > Consistem
      Enviar Atualização Natureza Bling Consistem > Bling
       POST
      /Api/
      v3/
      estoquesEnviar
      Estoque Produto Bling Consistem > Bling
       GET/Api/
      v3/
      estoques/
      Enviar Cliente BlingIndisponível
      saldosImportar Produto-Estoque Bling V3 Bling > Consistem
      GET
      /Api/
      v3/
      produtosImportar Produtos
      BlingBling > Consistem
      POST/Api/
      v3/
      produtosEnviar
      Produto Bling
      Consistem > Bling
      GET/Api/
      v3/
      produtos/
      Enviar Nota Fiscal Bling
      lojasObter Código Produto Loja BlingConsistem > Bling
      POST/Api/
      v3/
      produtos/
      lojasEnviar Produto Loja BlingConsistem > Bling
      DELETE/Api/
      v3/
      produtos/{codProduto}
      Enviar
      Exclusão Produto BlingConsistem > Bling
      PUT/Api/
      v3/produtos/{codProduto}
      Enviar Atualização Produto
      BlingConsistem > Bling
      PUT/Api/
      v3/
      produtos/{
      codProduto}/
      {idProdutoLoja}Enviar Atualização
      Produto Loja BlingConsistem > Bling
      GET/Api/
      v3/
      produtos/{
      Enviar Atualização de Cliente BlingIndisponível
      idProduto}Importar Produto BlingBling > Consistem


      PUTv2/deposito/{codNatureza}/jsonEnviar Atualização Natureza v2formapagamento/json Bling/Api/v2/pedido
      GET/Api/v3/formas-pagamentosImportar Forma de Pagamento BlingBling > Consistem
      POST
      /Api/
      v3/formas-pagamentosEnviar Forma de Pagamento
      BlingConsistem > Bling
      PUT/Api/
      v3/
      formas-pagamentos/{codFormaPagamento}
      Enviar Atualização da Forma de Pagamento
      IndisponívelPUT
      Bling  Consistem > Bling


      GET/Api/v3/naturezas-operacoesImportar Natureza de Operacao BlingBling > Consistem
      POST/Api/v3/nfeEnviar Nota Fiscal Bling Consistem > Bling


      jsonPUTv2produtoLojacodLoja}/{codProduto}/jsonConsistem > Bling
      GET/Api/v3/pedidos/vendasImportar Pedido Automação BlingBling > Consistem
      PATCH/Api/v3/pedidos/vendas/{codPedido}/situacoes/
      {codSituacao}Enviar Atualização Pedido BlingConsistem > Bling
      GET/Api/v3/
      pedidos/
      vendas/{
      idPedido}Importar Pedido-ID Bling V3Bling > Consistem
      GET/Api/v3/situacoes/modulos/{idModulo}Importar Cadastro de Situação BlingBling > Consistem
      Enviar Atualização Produto Loja Bling


  • Já a Aba Integração Manual (CSINTEGRACAO010ATAB3) 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.
    Image Removed
    Image Added

  • Agora sim, na Aba Carga Dados (CSINTEGRACAO010ATAB4) é 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.
    Image Removed
    Image Added

  • Retorne ao programa Integração (CSINTEGRACAO010) e no grid selecione a Integração Integracao API Bling V3;
    1. Clique em Ações e Agendamentos de Tarefas para executar o programa Agendamento de Tarefas (CSTASK015);
    2. Cadastre um novo agendamento para a integração com o Bling Bling V3 tanto para consumir ou enviar dados.
  • Pronto, configuração realizada com sucesso!
  • 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 (CCTCP020) 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 (CCCGI015), cadastro no programa Inclusão de Tabela de Preços (CCPV181) e foto no FTP. As fotos deverão ser salvas na pasta de FTP configuradas no programa Cadastro de Integração (CSINTEGRACAO010A), na Aba Dados Gerais (CSINTEGRACAO010ATAB1) 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 (CCCGI910). Neste programa o sistema lê os produtos na Bling e apresenta o relacionamento com os produtos no Consistem ERP.
    1. Selecione os produtos desejados, acione o Ações e selecione a opção Atualizar Produto Integração Selecionado, para atualização na Bling.
  • No programa Monitor de Pedidos de Integração (CCPV990) é 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

    UI Steps
    sizesmall
    UI Step

    O pedido é gerado pelo cliente na loja do Marketplace que envia ao Sistema de Gestão Bling.

    UI Step

    Ao receber o pedido, o Sistema de Gestão Bling dispara a integração com o Consistem ERP.

    UI Step

    O pedido é gerado no Consistem ERP de acordo com as parametrizações, efetua a geração da sugestão de faturamento e realiza a reserva no estoque.
    Caso o cliente do pedido não exista na base de dados do ERP o mesmo é criado de forma automática.

    UI Step

    Se a condição de pagamento escolhida for boleto o pedido entra no Consistem ERP com a situação Bloqueado.
    Após a efetivação do pagamento do pedido o sistema atualiza a situação para Liberado/Sugerido.
    Caso o pedido seja alterado para Cancelado ou Faturado no Consistem ERP a integração atualiza a situação do pedido no Sistema de Gestão Bling. 

    UI Step

    Quando o pedido é faturado no Consistem ERP o sistema envia a nota fiscal para o e-mail do cliente e na próxima integração dispara para o Sistema de Gestão Bling a alteração do status do pedido para Atendido.



    ...