Pular para as operações

Dados de empresas

Omie em um fluxo de decisão.

6 Omie 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
body credentials
Ambiente de teste
Somente host de produção

Quem são

ERP em nuvem para pequenas e médias empresas brasileiras.

A Omie toca o back office de uma pequena empresa brasileira: emissão de nota, contas a receber, contas a pagar, estoque e a contabilidade que vem depois. Vende em boa parte por meio de escritórios de contabilidade, e é por isso que tantos clientes deles acabam nela. A API é RPC sobre HTTP: um endereço por recurso, com o método nomeado no corpo da requisição.

O que um fluxo pode chamar

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

  1. POST/geral/clientes/

    Listar clientes

    Percorre, página a página, os clientes cadastrados na empresa da Omie.

  2. POST/geral/clientes/

    Encontrar um cliente pelo CNPJ

    Looks one customer up by document. This is the join between a decision and the ERP: the flow knows a CNPJ, and everything below needs Omie's own codigo_cliente_omie.

  3. POST/financas/contareceber/

    Listar contas a receber

    O que a empresa tem a receber e se chegou.

  4. POST/financas/contapagar/

    Listar contas a pagar

    O outro lado do razão — o que a empresa deve aos próprios fornecedores.

  5. POST/geral/clientes/

    Cadastrar um cliente

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

  6. POST/geral/empresas/

    Verificar a credencial

    Lista as empresas que a credencial enxerga. Jeito mais barato de confirmar que a conexão funciona e de checar a qual empresa da Omie o par de chaves pertence — o que importa, porque uma chave vale para uma empresa só, e um cliente com várias precisa de uma conexão para cada.

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 Omie 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 Omie as a connection authenticating with body credentials.
  • 02A Omie 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 — “Listar clientes” 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 Omie em um fluxo.

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

Adicione a Omie como uma conexão no seu workspace, autenticando com body credentials, 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 Omie em uma decisão sem nunca ver o segredo.

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

A Omie 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 Omie?

6 operações, incluindo “Listar clientes”, “Encontrar um cliente pelo CNPJ”, “Listar contas a receber”. 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 “Listar clientes”. 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 Omie 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 Omie 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