Conectores
ERP

Bling

9min

Objetivo/Resumo

Bling é uma plataforma de gestão empresarial desenvolvida para ajudar pequenas e médias empresas a gerenciar suas operações de forma integrada. Ele oferece uma variedade de recursos e ferramentas para auxiliar na organização e automação de processos, como controle de estoque, vendas, finanças, compras, emissão de notas fiscais, gestão de clientes, entre outros. Este conector facilitará integrações com outras plataformas de e-commerce e marketplace.

Criando um fluxo utilizando o conector Bling

Para criar um fluxo utilizando o conector Bling é preciso criar uma conexão e em seguida configurar o fluxo.

Criando conexão Bling

OBS: Clique aqui e acesse nosso passo a passo para saber como criar uma conexão.

Estes são os seguintes parâmetros de configuração da conexão Bling que serão requisitados na criação:

  • Nome: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório);
  • Descrição: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão;
  • API Key: informe a chave da API disponibilizada pelo sistema Bling (A API key será gerada ao cadastrar um usuário API na Bling clique aqui e veja como gerar uma API Key)

Configurando fluxo Bling

Crie um fluxo e arraste o conector Bling para o canvas.

OBS: Clique aqui e acesse nosso passo a passo para saber como criar um fluxo.

Selecione o conector e na aba de Parametrização preencha os seguintes parâmetros de configuração:

  • Recurso: entidade para qual será realizada a ação. No momento o conector dispões dois recursos sendo eles, Pedidos e Nota Fiscal;
  • Operação: ação que será realizada para o recurso selecionado.
    • Operações disponiveis para recurso Pedidos:
      • Consultar: requer o número do pedido;
      • Inserir: requer o XML da requisição, podendo ser enviado utilizando De/para ou Template;
      • Atualizar Situação: requer o número do pedido e o XML da requisição, podendo ser enviado utilizando De/para ou Template;
      • Listar: não requer nenhuma informação, retornará todos os pedidos da base bling;
    • Operações disponiveis para recurso Nota Fiscal:
      • Consultar: requer número da nota fiscal e número de série;
      • Inserir: requer o corpo da requisição com o objeto da nota que deseja inserir, podendo ser utilizado o De/para ou Template para referenciar o corpo;

Na aba Propriedades selecione a conexão desejada, dê um nome ao passo e se necessário detalhe uma descrição.

Na prática

Neste tópico criaremos um exemplo de um fluxo utilizando o conector da Bling. O fluxo terá apenas um passo que será responsável pelo envio de um pedido para o sistema Bling. Enviaremos um payload de entrada, que passará por uma transformação em nosso De/para, onde será validado algumas Rules, e por fim montaremos o XML necessário para inserir o pedido na Bling usando um Template.

Document image


Passo 'envia-pedido'

Este primeiro e unico passo irá inserir o pedido no sitema Bling somente se todas as Rules mandatórias forem atendidas. Assim ficará a Parametrização do envia-pedido:

Document image


Para tratar os dados recebidos do payload de entrada usamos o De/para. E por fim utilizamos o Template para montar o XML da requisição que a operação espera.

Assim ficou nosso De/Para:

Document image


Para mais informações sobre como tratamos de/paras clique em saiba mais.

Se observar, alguns valores do nosso de/para estão sendo referenciado algumas rules, essas são rules internas, para mais informações acesse nossa documentação sobre Rules.

Assim ficou nossas rules:

JSON


E por fim, o template no formato esperado pela Bling:

Document image


Na aba Propriedades informamos o nome do passo e a conexão criada com a credencial da Bling:

Document image


Conclusão

Com o passo configurado basta disparar o fluxo informando o payload de entrada, para este caso termos esse a seguir:

JSON

Document image


Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:

Document image


Ao clicar em detalhes, temos a requisição e a resposta retornada pela Bling:

Document image




Updated 16 Oct 2023
Doc contributor
Doc contributor
Did this page help you?