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 |
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.
{
"requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}
Status 422
Significa que ocorreu um erro de validação dos dados enviados.
{
"message": "The given data was invalid.",
"errors": {
"cpf": [
"O campo cpf é obrigatório."
],
"nome": [
"O campo name é 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
{
"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",
"pdf": ""
}
{
"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",
"pdf": ""
}
{
"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",
"pdf": "..."
}
{
"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",
"motivoSituacaoCadastral": "ANULADA POR VICIOS",
"motivoSituacaoEspecial": "********",
"situacaoEspecial": "********",
"dataSituacaoEspecial": "********",
"dataHoraEmissaoComprovante": "10/02/2022 10:20:10",
"pdf": "...",
}
{
"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": "JVB..."
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..."
}