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 |
Respostas com registro encontrado
{ "razao_social": "EMPRESA S/A", "data_abertura": "28/08/1973", "nome_fantasia": "EMPRESA", "porte": "DEMAIS", "natureza_juridica": "217-8 - Estabelecimento, no Brasil, de Sociedade Estrangeira", "endereco": { "logradouro": "R ATICA", "complemento": "SALA 1001", "numero": "6778", "cep": "04.634-042", "bairro": "JARDIM BRASIL", "municipio": "SAO PAULO", "uf": "SP" }, "email": "CONTATO@EXAMPLE.COM.BR", "telefone": "(11) 9999-9999\/ (11) 9999-9999", "ente_federativo": "*****", "situacao_cadastral": "ATIVA", "data_situacao_cadastral": "03/11/2005", "motivo_situacao_cadastral": "", "situacao_especial": "********", "data_situacao_especial": "********", "cnae_principal": { "codigo": "51.11-1-00", "descricao": "Transporte aéreo de passageiros regular" }, "cnaes": [ { "codigo": "51.20-0-00", "descricao": "Transporte aéreo de carga" } ], "pdf": "JVBERi0xLjQKMSAwIG9iago8..." }
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..." }