Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

O que é

Na consulta Receita Federal - Comprovante de Situação Cadastral no CPF - você verifica se um CPF está em situação regular.

Veja mais informações em nossa central de ajuda: Receita Federal - Comprovante de Situação Cadastral no CPF

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/receita/comprovante-situacao-cadastral

...

Include Page
URL Base
URL Base

Parâmetros do header

Nome

Tipo

Obrigatório?

Descrição

Authorization

String

Sim

Chave de API gerada no cadastro no Plexi, prefixada com Bearer

Callback

String

Não

URL para onde o resultado da requisição será enviado via HTTP POST.

Parâmetros do body

Nome

Tipo

Obrigatório?

Descrição

cpf

String

Sim

CPF a ser pesquisado, com ou sem máscara. Exemplos: 99999999999 ou 999.999.999-99

dataNascimento

Date

Sim

Data de nascimento da pessoa no formato dia/mês/ano (DD/MM/AAAA)

Retornos possíveis da requisição

Status

Significado

Descrição

Informações retornadas

201

Created

Solicitação criada

Campo requestId, com o ID da requisição criada.

422

Unprocessable Entity

A solicitação contém erro

Em quais campos houve erro.

Exemplos de retornos

Status 201

Code Block
{
  "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}

...

Code Block
{
  "message": "The given data was invalid.",
  "errors": {
    "cpf": [
      "O campo cpf é obrigatório."
    ],
    "nome": [
      "O campo name é obrigatório."
    ]
  }
}

 

Resultados da pesquisa ( retornados no callback ou fazendo requisição à API de respostas )

Valores possíveis do campo “status“

Status

Significado

irregular

CPF está cadastrado e está irregular

regular

CPF está cadastrado e está regular

pendente

CPF está pendente de regularização

cancelada

CPF foi cancelado

suspensa

CPF está suspenso

falecido

O titular do CPF faleceu

erro

Ocorre quando o documento informado não existe ou quando as informações de documento e data de nascimento estão divergentes das cadastradas.

Resposta com registro encontrado

Code Block
languagejson
{
	"cpf": "999.999.999-99",
	"statusnome": "regularNOME DA PESSOA",
	"dataNascimento": "18/06/1987",
	"pdfstatus": "pendente",
	"JVBERi0xLjQKMSAwIG9iago8...dataInscricao"
}
Code Block
languagejson
{
  "status": "irregular",
  "pdf: "28/05/2001",
	"digitoVerificador": 04,
	"dataHoraComprovante": "03/09/2020 16:36:57",
	"codigoComprovante": "JVBERi0xLjQKMSAwIG9iago8AA0.0000.000A.0000" 
}

Resposta com erro

Code Block
languagejson
{
  "status": "erro",
  "mensagem": "Data de nascimento informada está divergente da constante na base de dados da Secretaria da Receita Federal do Brasil."
}

...