Pular para as operações

Verificação de empresas

Middesk em um fluxo de decisão.

2 Middesk 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
Verificação de empresas
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

Verificação de empresas a partir de registros públicos dos EUA.

A Middesk verifica empresas dos EUA contra registros estaduais, dados da Receita americana, listas restritivas e outras fontes públicas, e devolve um veredito estruturado sobre a empresa, o endereço e os responsáveis. Ela também cuida do registro fiscal e de folha nos estados para seus clientes.

O que um fluxo pode chamar

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

  1. POST/v1/businesses

    Verificar razão social e endereço

    Abre um pedido assíncrono de verificação de empresa nos EUA.

  2. GET/v1/businesses/$data.middesk_business_id

    Ler uma verificação de empresa

    Consulta uma empresa criada por Verificar razão social e endereço.

Onde isso entra na decisão

Business verification calls have a natural place in a flow.

As checagens cadastrais respondem se a empresa que está pedindo existe, quem a controla e se os registros dela sustentam a proposta. Costumam rodar cedo: se a empresa não pode ser verificada, quase tudo o que vem depois perde o sentido, e o fluxo consegue recusar ou encaminhar antes de gastar com qualquer outra coisa.

Whatever Middesk 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 Middesk as a connection authenticating with an API key.
  • 02A Middesk 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 — “Verificar razão social e endereço” 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 Middesk em um fluxo.

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

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

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

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

2 operações: “Verificar razão social e endereço”, “Ler uma verificação de empresa”. 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 “Verificar razão social e endereço”. 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 Middesk deve ser chamada?

As checagens cadastrais respondem se a empresa que está pedindo existe, quem a controla e se os registros dela sustentam a proposta. Costumam rodar cedo: se a empresa não pode ser verificada, quase tudo o que vem depois perde o sentido, e o fluxo consegue recusar ou encaminhar antes de gastar com qualquer outra coisa.

Quando você quiser

Wire Middesk 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