Pular para as operações

Verificação de empresas

Serpro em um fluxo de decisão.

4 Serpro 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
Credenciais de cliente OAuth 2.0
Ambiente de teste
Somente host de produção

Quem são

The Brazilian government's data processing company.

O Serpro é estatal e opera a tecnologia por trás da Receita Federal e de outros órgãos federais, o que faz dele a fonte primária dos dados cadastrais de CPF e CNPJ, e não um revendedor deles. Ele vende esses dados por um portal de desenvolvedor, por produto, com endpoints de demonstração gratuitos que respondem para documentos de teste publicados. Quando uma auditoria precisa dizer de onde veio um dado, essa é a resposta que encerra a pergunta.

O que um fluxo pode chamar

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

  1. GET/consulta-cpf/v1/cpf/$data.cpf

    Consultar um CPF (Receita Federal)

    Nome, data de nascimento e situação cadastral de um CPF, direto da Receita Federal.

  2. GET/consulta-cnpj/v2/basica/$data.cnpj

    Consultar um CNPJ (dados cadastrais)

    Dados cadastrais de uma empresa: razão social, nome fantasia, data de abertura, situação cadastral e atividade principal.

  3. GET/consulta-cpf-df/v1/cpf/$data.cpf

    Consultar um CPF (demonstração gratuita)

    The same call against Serpro's free demonstration product, which answers only for a published set of test documents.

  4. GET/consulta-cnpj-df/v2/basica/$data.cnpj

    Consultar um CNPJ (demonstração gratuita)

    O gêmeo de demonstração da consulta de CNPJ, que responde para um conjunto fixo de empresas de teste.

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 Serpro 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 Serpro as a connection authenticating with OAuth 2.0 client credentials.
  • 02A Serpro 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 — “Consultar um CPF (Receita Federal)” 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 Serpro em um fluxo.

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

Adicione a Serpro como uma conexão no seu workspace, autenticando com credenciais de cliente OAuth 2.0, 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 Serpro em uma decisão sem nunca ver o segredo.

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

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

4 operações, incluindo “Consultar um CPF (Receita Federal)”, “Consultar um CNPJ (dados cadastrais)”, “Consultar um CPF (demonstração gratuita)”. 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 “Consultar um CPF (Receita Federal)”. 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 Serpro 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 Serpro 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