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", "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..." }
{ "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", "certidaoBaixa": null, "pdf": "JVBERi0xLjcNCiW1tbW1DQ..." }
{ "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", "certidaoBaixa": null, "pdf": "JVBERi0xLjcNCiW1tbW1DQ..."
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..." }