Receita Federal - Cartão CNPJ

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.

Sobre a requisição#

Método: POST

Endereço: https://api.plexi.com.br/api/maestro/receita/cartao-cnpj

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

A consulta recebida com sucesso e será processada. Com o ID retornado você pode consultar se já houve resposta.

JSON

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

Status 422

Significa que ocorreu um erro de validação dos dados enviados.

JSON

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

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
ativa	Cartão CNPJ com situação cadastral ativa
baixada	Cartão CNPJ com situação cadastral baixada
nula	Cartão CNPJ com situação cadastral nula
suspensa	Cartão CNPJ com situação cadastral suspensa
inapta	Cartão CNPJ com situação cadastral inapta

Respostas com registro encontrado

JSON

{
    "status": "ativa",
    "numeroInscricao": "99.999.999/9999-99",
    "dataAbertura": "28/02/2022",
    "nomeEmpresarial": "EMPRESA X S/A",
    "nomeFantasia": "EMPRESA X",
    "porte": "DEMAIS",
    "atividadeEconomicaPrincipal": {
        "codigo": "51.11-1-00",
        "descricao": "Transporte aéreo de passageiros regular"
    },
    "atividadeEconomicaSecundaria": [
        {
            "codigo": "51.20-0-00",
            "descricao": "Transporte aéreo de carga"
        }
    ],
    "endereco": {
        "logradouro": "R ATICA",
        "numero": "123",
        "complemento": "SALA 123",
        "cep": "12.345-678",
        "bairroDistrito": "BAIRRO X",
        "municipio": "SAO PAULO",
        "uf": "SP"
    },
    "naturezaJuridica": "217-8 - Estabelecimento, no Brasil, de Sociedade Estrangeira",
    "enderecoEletronico": "CONTATO@EMPRESAX.COM.BR",
    "telefone": "(11) 1234-5678/ (11) 1234-5678",
    "enteFederativo": "*****",
    "situacaoCadastral": "ATIVA",
    "dataSituacaoCadastral": "01/01/2020",
    "motivoSituacaoCadastral": null,
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022 10:51:19",
    "certidaoBaixa": null,
    "pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
  }

JSON

{
    "status": "baixada",
    "numeroInscricao": "12.345.678/0000-00",
    "dataAbertura": "12/09/2022",
    "nomeEmpresarial": "EMPRESA Y LTDA",
    "nomeFantasia": "********",
    "porte": "DEMAIS",
    "atividadeEconomicaPrincipal": {
        "codigo": null,
        "descricao": "********"
    },
    "atividadeEconomicaSecundaria": [
        {
            "codigo": null,
            "descricao": "Não informada"
        }
    ],
    "endereco": {
        "logradouro": "********",
        "numero": "********",
        "complemento": "********",
        "cep": "********",
        "bairroDistrito": "********",
        "municipio": "********",
        "uf": "********"
    },
    "naturezaJuridica": "206-2 - SOCIEDADE EMPRESARIA LIMITADA",
    "enderecoEletronico": null,
    "telefone": null,
    "enteFederativo": "*****",
    "situacaoCadastral": "BAIXADA",
    "dataSituacaoCadastral": "01/01/2020",
    "motivoSituacaoCadastral": "INAPTIDAO (LEI 11.941/2009 ART.54)",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022 10:50:31",
    "certidaoBaixa": {
    "numeroInscricao": "12.345.678/0000-00",
    "dataBaixa": "15/02/2022",
    "nomeEmpresarial": "EMPRESA Y LTDA",
    "endereco": {
      "logradouro": "R ATICA",
      "numero": "12",
      "complemento": "APT 1002",
      "bairroDistrito": "BAIRRO X",
      "cep": "99.999-999",
      "municipio": "SAO PAULO",
      "uf": "MG",
      "telefone": "(99) 9999-9999"
    },
    "motivoBaixa": "EXTINCAO P/ ENC LIQ VOLUNTARIA",
    "dataHoraEmissao": "05/09/2022 18:01:49",
    "unidadeCadastradora": "0610100 - BELO HORIZONTE"
  },
    "pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
}

JSON

{
    "status": "inapta",
    "numeroInscricao": "12.345.678/9101-11",
    "dataAbertura": "10/05/2011",
    "nomeEmpresarial": "EMPRESA X LTDA" ,
    "nomeFantasia": "********",
    "porte": "DEMAIS",
    "atividadeEconomicaPrincipal": {
        "codigo": null,
        "descricao": "********"
    },
    "atividadeEconomicaSecundaria": [
        {
            "codigo": null,
            "descricao": "********"
        }
    ],
    "endereco": {
        "logradouro": "********",
        "numero": "********",
        "complemento": "********",
        "cep": "********",
        "bairroDistrito": "********",
        "municipio": "********",
        "uf": "********"
    },
    "naturezaJuridica": "224-0 - Sociedade Simples Limitada",
    "enderecoEletronico": "EMPRESAX@EMPRESAX.COM.BR",
    "telefone": "(21) 1234-5678",
    "enteFederativo": "*****",
    "situacaoCadastral": "INAPTA",
    "dataSituacaoCadastral": "01/01/2020",
    "motivoSituacaoCadastral": "OMISSAO DE DECLARACOES",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022 10:47:57",
    "certidaoBaixa": null,
    "pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
}

JSON

{
    "status": "nula",
    "numeroInscricao": "99.999.999/0001-05",
    "dataAbertura": "21/03/2022",
    "nomeEmpresarial": "EMPRESA X",
    "nomeFantasia": "********",
    "porte": "ME",
    "atividadeEconomicaPrincipal": {
        "codigo": null,
        "descricao": "********"
    },
    "atividadeEconomicaSecundaria": [
        {
            "codigo": null,
            "descricao": "Não informada"
        }
    ],
    "endereco": {
        "logradouro": "********",
        "numero": "********",
        "complemento": "********",
        "cep": "********",
        "bairroDistrito": "********",
        "municipio": "********",
        "uf": "********"
    },
    "naturezaJuridica": "213-5 - Empresário (Individual)",
    "enderecoEletronico": "EMPRESAX@EMAIL.COM",
    "telefone": "(12) 1234-1234",
    "enteFederativo": "*****",
    "situacaoCadastral": "NULA",
    "dataSituacaoCadastral": "01/01/2020",
    "motivoSituacaoCadastral": "ANULADA POR VICIOS",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022 10:20:10",
    "certidaoBaixa": null,
    "pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
}

JSON

{
    "status": "suspensa",
    "numeroInscricao": "00.000.999/0000-00",
    "dataAbertura": "24/01/2022",
    "nomeEmpresarial": "EMPRESA X ",
    "nomeFantasia": "********",
    "porte": "ME",
    "atividadeEconomicaPrincipal": {
        "codigo": null,
        "descricao": "********"
    },
    "atividadeEconomicaSecundaria": [
        {
            "codigo": null,
            "descricao": "Não informada"
        }
    ],
    "endereco": {
        "logradouro": "********",
        "numero": "********",
        "complemento": "********",
        "cep": "********",
        "bairroDistrito": "********",
        "municipio": "********",
        "uf": "********"
    },
    "naturezaJuridica": "206-2 - Sociedade Empresária Limitada",
    "enderecoEletronico": null,
    "telefone": null,
    "enteFederativo": "*****",
    "situacaoCadastral": "SUSPENSA",
    "dataSituacaoCadastral": "01/01/2020",
    "motivoSituacaoCadastral": "INTERRUPCAO TEMP ATIVIDADES",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022 10:48:58",
    "certidaoBaixa": null,
    "pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
}

Resposta com erro

JSON

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