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: 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 |
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 |
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
{
"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",
"motivoSituacaoCadastral": null,
"motivoSituacaoEspecial": "********",
"situacaoEspecial": "********",
"dataSituacaoEspecial": "********",
"dataHoraEmissaoComprovante": "10/02/2022 10:51:19",
"certidaoBaixa": null,
"pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
}
{
"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",
"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..."
}
{
"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",
"motivoSituacaoCadastral": "OMISSAO DE DECLARACOES",
"motivoSituacaoEspecial": "********",
"situacaoEspecial": "********",
"dataSituacaoEspecial": "********",
"dataHoraEmissaoComprovante": "10/02/2022 10:47:57",
"certidaoBaixa": null,
"pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
}
Resposta com erro