Pular para as operações

Dados de empresas

Bling em um fluxo de decisão.

6 Bling operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Dados de empresas
Tipo
Integração
Autenticação
oauth2 refresh
Ambiente de teste
Somente host de produção

Quem são

ERP brasileiro voltado a quem vende online.

O Bling cuida de pedidos, estoque, emissão de nota e finanças de pequenas empresas, com forte inclinação para e-commerce e vendedores de marketplace. Ele se integra aos marketplaces e às lojas virtuais brasileiras por onde seus clientes vendem. A API atual usa o fluxo OAuth2 de authorization code e troca o refresh token a cada renovação.

O que um fluxo pode chamar

6 operações, cada uma um passo que você coloca no editor.

  1. GET/contatos?numeroDocumento=$data.cnpj

    Encontrar um contato pelo documento

    Looks a customer or supplier up by CNPJ or CPF. This is the join between a decision and the ERP — everything below takes Bling's own contact id rather than a document number.

  2. GET/contas/receber?idContato=$data.bling_contact_id

    Listar contas a receber

    O que a empresa tem a receber e se chegou.

  3. GET/contas/pagar?idContato=$data.bling_contact_id

    Listar contas a pagar

    O outro lado do razão — o que a empresa deve.

  4. GET/pedidos/vendas?idContato=$data.bling_contact_id

    Listar pedidos de venda

    Histórico de pedidos de um contato — quanto compram e com que frequência.

  5. POST/contatos

    Cadastrar um contato

    Grava o solicitante aprovado no ERP para que o time comercial possa faturá-lo sem redigitar nada.

  6. GET/produtos

    Verificar a conexão

    Lista produtos. Sem argumentos, barato, e é o jeito mais rápido de confirmar que o token está vivo — o que, neste provedor, também prova que o ciclo de renovação está funcionando, porque o token usado quase certamente foi emitido por uma renovação, e não pela instalação.

Onde isso entra na decisão

Business data calls have a natural place in a flow.

Accounting data describes a company's own books rather than its filings, which makes it the input for decisions about trading history and cash position. It arrives after the applicant has connected a source, so a flow reads it where it exists and falls back to submitted figures where it does not.

Whatever Bling returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Bling as a connection authenticating with oauth2 refresh.
  • 02A Bling tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Encontrar um contato pelo documento” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Bling em um fluxo.

Como conecto a Bling a um fluxo de decisão?

Adicione a Bling como uma conexão no seu workspace, autenticando com oauth2 refresh, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Bling em uma decisão sem nunca ver o segredo.

Dá para testar a Bling sem tocar em produção?

A Bling expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na Bling?

6 operações, incluindo “Encontrar um contato pelo documento”, “Listar contas a receber”, “Listar contas a pagar”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Encontrar um contato pelo documento”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a Bling deve ser chamada?

Accounting data describes a company's own books rather than its filings, which makes it the input for decisions about trading history and cash position. It arrives after the applicant has connected a source, so a flow reads it where it exists and falls back to submitted figures where it does not.

Quando você quiser

Wire Bling into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação