Pular para as operações

Dados de empresas

Conta Azul em um fluxo de decisão.

5 Conta Azul 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

Contabilidade e gestão financeira para pequenas empresas brasileiras.

Conta Azul keeps a small company's books — sales, receivables, bank reconciliation and the reports an accountant needs — and is often set up by that accountant rather than by the business itself. It sits closer to the accounting end of the market than the operational ERPs do. Access is by OAuth2 authorization code.

O que um fluxo pode chamar

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

  1. GET/v1/customers?search=$data.cnpj

    Encontrar um cliente

    Looks a customer up by document or name. The join between a decision and the books: the calls below take Conta Azul's own uuid rather than a CNPJ.

  2. GET/v1/sales?customer_id=$data.contaazul_customer_id

    Listar vendas

    Vendas registradas para um cliente — quanto compram e com que frequência.

  3. GET/v1/financial-events?start_date=$data.period_start&end_date=$data.period_end

    Listar eventos financeiros

    Dinheiro que entrou e saiu num período. Essa é a leitura de capacidade de pagamento de uma empresa: o que os livros dizem que de fato se moveu, e não o que o solicitante declarou.

  4. POST/v1/customers

    Cadastrar um cliente

    Grava o solicitante aprovado nos livros para que o time financeiro possa faturá-lo sem redigitar nada.

  5. GET/v1/person

    Verificar a conexão

    Devolve a conta a que o token pertence. Jeito mais barato de confirmar que a conexão funciona — e, neste provedor, isso também prova que o ciclo de renovação está funcionando, porque o token em uso provavelmente 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 Conta Azul 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 Conta Azul as a connection authenticating with oauth2 refresh.
  • 02A Conta Azul 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 cliente” 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 Conta Azul em um fluxo.

Como conecto a Conta Azul a um fluxo de decisão?

Adicione a Conta Azul 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 Conta Azul em uma decisão sem nunca ver o segredo.

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

A Conta Azul 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 Conta Azul?

5 operações, incluindo “Encontrar um cliente”, “Listar vendas”, “Listar eventos financeiros”. 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 cliente”. 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 Conta Azul 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.

Also in Business data

Quando você quiser

Wire Conta Azul 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