O que é

Na consulta Cartão CNPJ você verifica a situação cadastral de um CNPJ, que pode ser cadastrada, irregular, inapta.

O resultado desta consulta é um comprovante da situação cadastral, que contém também outras informações sobre o CNPJ pesquisado: nome empresarial, descrição da natureza empresarial, telefone, motivo da situação cadastral.

Veja mais informações em nossa central de ajuda: Receita Federal - Cartão CNPJ

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/receita/cartao-cnpj

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

cnpj

string

Sim

CNPJ a ser pesquisado.

Estrutura da resposta

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 quando você faz a requisição:

Status 201

Status 422

Exemplos de retornos do resultado da pesquisa

Valores possíveis do campo “status“

Status

Significado

erro

Erro ao buscar informações, seja por documento ou outro dado incorreto

Respostas com registro encontrado

{
  "razao_social": "EMPRESA S/A",
  "data_abertura": "28/08/1973",
  "nome_fantasia": "EMPRESA",
  "porte": "DEMAIS",
  "natureza_juridica": "217-8 - Estabelecimento, no Brasil, de Sociedade Estrangeira",
  "endereco": {
    "logradouro": "R ATICA",
    "complemento": "SALA 1001",
    "numero": "6778",
    "cep": "04.634-042",
    "bairro": "JARDIM BRASIL",
    "municipio": "SAO PAULO",
    "uf": "SP"
  },
  "email": "CONTATO@EXAMPLE.COM.BR",
  "telefone": "(11) 9999-9999\/ (11) 9999-9999",
  "ente_federativo": "*****",
  "situacao_cadastral": "ATIVA",
  "data_situacao_cadastral": "03/11/2005",
  "motivo_situacao_cadastral": "",
  "situacao_especial": "********",
  "data_situacao_especial": "********",
  "cnae_principal": {
    "codigo": "51.11-1-00",
    "descricao": "Transporte aéreo de passageiros regular"
  },
  "cnaes": [
    {
      "codigo": "51.20-0-00",
      "descricao": "Transporte aéreo de carga"
    }
  ],
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}

Resposta com erro

{
  "status": "erro",
  "mensagem": "Não existe no Cadastro de Pessoas Jurídicas o número de CNPJ informado. Verifique se o mesmo foi digitado corretamente.",
  "pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}