Versions Compared

Key

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

O que é

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

...

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

...

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

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

Include Page
Status 201
Status 201

...

Include Page
status 422
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

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

Code Block
languagejson
{
    "razao_socialstatus": "EMPRESA S/A","ativa",
    "numeroInscricao": "99.999.999/9999-99",
    "data_aberturadataAbertura": "28/08/1973",/02/2022",
    "nomeEmpresarial": "EMPRESA X S/A",
    "nome_fantasianomeFantasia": "EMPRESA X",
    "porte": "DEMAIS",
  "natureza_juridica  "atividadeEconomicaPrincipal": {
        "codigo": "217-8 - Estabelecimento, no Brasil, de Sociedade Estrangeira",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",
        "complementonumero": "SALA 1001123",
        "numerocomplemento": "6778SALA 123",
        "cep": "0412.634345-042678",
        "bairrobairroDistrito": "JARDIMBAIRRO BRASILX",
        "municipio": "SAO PAULO",
        "uf": "SP"
    },
    "email"naturezaJuridica": "217-8 - Estabelecimento, no Brasil, de Sociedade Estrangeira",
    "enderecoEletronico": "CONTATO@EXAMPLECONTATO@EMPRESAX.COM.BR",
    "telefone": "(11) 99991234-9999\5678/ (11) 99991234-99995678",
    "ente_federativoenteFederativo": "*****",
    "situacao_cadastralsituacaoCadastral": "ATIVA",
    "motivoSituacaoCadastral": null,
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022  10:51:19",
    "pdf": ""
  }
Code Block
languagejson
{
    "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": "********",
       "data_situacao_cadastral": "03/11/2005",
  "motivo_situacao_cadastral": "",
  "situacao_especial "bairroDistrito": "********",
        "municipio": "********",
        "uf": "********"
    },
    "naturezaJuridica": "206-2 - SOCIEDADE EMPRESARIA LIMITADA",
    "enderecoEletronico": null,
    "telefone": null,
    "enteFederativo": "*****",
    "situacaoCadastral": "BAIXADA",
    "motivoSituacaoCadastral": "INAPTIDAO (LEI 11.941/2009 ART.54)",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022  10:50:31",
    "pdf": ""
}
Code Block
languagejson
{
    "status": "inapta",
    "numeroInscricao": "12.345.678/9101-11",
    "dataAbertura": "10/05/2011",
    "nomeEmpresarial": "EMPRESA X LTDA" ,
    "nomeFantasia": "********",
    "porte": "DEMAIS",
    "atividadeEconomicaPrincipal": {
        "codigo": null,
  "data_situacao_especial      "descricao": "********"
    },
    "cnae_principalatividadeEconomicaSecundaria": [
        {
            "codigo": null,
            "descricao": "51.11-1-00"********"
        }
    ],
    "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",
    "motivoSituacaoCadastral": "OMISSAO DE DECLARACOES",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022  10:47:57",
    "pdf": "..."
}
Code Block
languagejson
{
    "status": "nula",
    "numeroInscricao": "99.999.999/0001-05",
    "dataAbertura": "21/03/2022",
    "nomeEmpresarial": "EMPRESA X",
    "nomeFantasia": "********",
    "porte": "ME",
    "descricaoatividadeEconomicaPrincipal": {
       "Transporte aéreo de passageiros regular" "codigo": null,
        "descricao": "********"
    },
    "cnaesatividadeEconomicaSecundaria": [
        {
            "codigo": null,
            "descricao": "Não informada"
        }
    ],
    "endereco": {
        "logradouro": "********",
        "numero": "********",
        "complemento": "********",
        "cep": "********",
      "51.20-0-00",
      "descricao": "Transporte aéreo de carga  "bairroDistrito": "********",
        "municipio": "********",
        "uf": "********"
    },
    "naturezaJuridica": "213-5 - Empresário (Individual)",
    "enderecoEletronico": "EMPRESAX@EMAIL.COM",
    "telefone": "(12) 1234-1234",
    "enteFederativo": "*****",
    "situacaoCadastral": "NULA",
    "motivoSituacaoCadastral": "ANULADA POR VICIOS",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022  10:20:10",
    "pdf": "...",
}
Code Block
languagejson
{
    "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",
    "motivoSituacaoCadastral": "INTERRUPCAO TEMP ATIVIDADES",
    "motivoSituacaoEspecial": "********",
    "situacaoEspecial": "********",
    "dataSituacaoEspecial": "********",
    "dataHoraEmissaoComprovante": "10/02/2022  10:48:58",
    "pdf": "JVBERi0xLjQKMSAwIG9iago8JVB..."
}

Resposta com erro

Code Block
languagejson
{
  "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..."
}

...