Consulta CNPJ
Método para recuperar as informações de uma empresa brasileira através do seu CNPJ. As informações são exatamente as mesmas informações retornadas pelo site da Receita Federal.
Documentação API consulta CPNJ
URL para Requisição
http://api.gbcsystems.com.br/rest/apigbc/cnpj/consulta/{cnpj}
Header
Authorization
Token para autenticação. Seu valor deve ser '<API_KEY>', onde <API_KEY> é o token enviado para seu e-mail.
Paramêtros
cnpj
CNPJ que deseja obter as informações.
numérico
OBRIGATÓRIO
Dados retornados
Dados
| Campo | Tipo | Descrição |
|---|---|---|
| code | numérico | Código de retorno da solicitação. |
| status | texto | Status de retorno da solicitação. |
| message | texto | Mensagem de retorno da solicitação |
| result | objeto | Objeto com os dados da empresa |
| cnpj | texto | CNPJ no formato 00000000000000. |
| porte | texto | Código do porte da empresa. |
| tipo | texto | Tipo do estabelecimento (MATRIZ ou FILIAL) |
| nome | texto | Razão social da empresa. |
| nomeFantasia | texto | Nome fantasia da empresa. |
| situacao | texto | Situação cadastral. |
| dataSituacao | data | Data e hora da situação cadastral. |
| motivoSituacao | texto | Motivo da situação cadastral. |
| naturezaJuridica | texto | Natureza jurídica. |
| dataAbertura | data e hora | Data e hora de abertura. |
| logradouro | texto | Nome da rua, incluindo o tipo (Rua, Av. Tv etc). |
| numero | texto | Número da rua. |
| complemento | texto | Complemento do endereço |
| cep | numérico | CEP do endereço. |
| cidade | texto | Cidade do endereço |
| bairro | texto | Bairro do endereço |
| estado | texto | Estado do endereço. |
| telefone | texto | Telefone(s) da empresa. |
| texto | Email de contato. | |
| capitalSocial | texto | Capital social da empresa. |
| quantidadeFuncionario | texto | Quantidade de funcionários informado pela empresa. |
| situacaoEspecial | texto | Código da situação especial. |
| dataSituacaoEspecial | data e hora | Data da situação especial. |
| atividadePrimaria | objeto | Atividade econômica principal. |
| atividadePrimaria.codigo | texto | Código da atividade econômica principal. |
| atividadePrimaria.descricao | texto | Descrição da atividade econômica principal. |
| atividadeSecundaria | array<objetos> | Lista das atividades secundárias. |
| atividadeSecundaria.codigo | texto | Código da atividade secundária. |
| atividadeSecundaria.descricao | texto | Descrição da atividade secundária. |
| qsa | array<objetos> | Lista quadro de sócios e administradores. |
| qsa.nome | texto | Nome do sócio. |
| qsa.qualificacao | texto | Qualificação do sócio. |
Exemplo de resposta
Resposta
A resposta é no formato JSON.
{
"MESSAGE": "consulta realizada com sucesso",
"STATUS": "OK",
"CODE": 0,
"RESULT": {
"COMPLEMENTO": "TORRE NORTE ANDAR 27 PARTE A",
"QUANTIDADEFUNCIONARIO": "",
"ATIVIDADESECUNDARIA": [
{
"Codigo": 4649499,
"Descricao": "Comércio atacadista de outros equipamentos e artigos de uso pessoal e doméstico não especificados anteriormente"
},
{
"Codigo": 6311900,
"Descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
},
{
"Codigo": 7311400,
"Descricao": "Agências de publicidade"
},
{
"Codigo": 6204000,
"Descricao": "Consultoria em e-comerce"
},
{
"Codigo": 7490104,
"Descricao": "Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários"
},
{
"Codigo": 6319400,
"Descricao": "Portais, provedores de conteúdo e outros serviços de informação na internet"
},
{
"Codigo": 8599699,
"Descricao": "Outras atividades de ensino não especificadas anteriormente"
}
],
"CNPJ": "4712500000107",
"MOTIVOSITUACAO": "",
"NATUREZAJURIDICA": "2062 - Sociedade Empresária Limitada",
"ESTADO": "SP",
"TELEFONE": "11 55042929",
"CEP": 4578000,
"SITUACAOESPECIAL": "",
"QSA": [
{
"nome": "MSHC, LLC",
"qualificacao": "37 - SÓCIO PESSOA JURIDICA DOMICILIADO NO EXTERIOR"
},
{
"nome": "JOAO PAULO SEIBEL DE FARIA",
"qualificacao": "05 - ADMINISTRADOR"
},
{
"nome": "UNH 1 CO.",
"qualificacao": "37 - SÓCIO PESSOA JURIDICA DOMICILIADO NO EXTERIOR"
},
{
"nome": "TANIA CONTE COSENTINO",
"qualificacao": "05 - ADMINISTRADOR"
}
],
"CIDADE": "SAO PAULO",
"EMAIL": "CADASTRO@MICROSOFT.COM",
"DATAABERTURA": "2001-10-15T02:00:00.000Z",
"CAPITALSOCIAL": "909000000",
"BAIRRO": "BROOKLIN PAULISTA",
"ATIVIDADEPRIMARIA": {
"Codigo": 6203100,
"Descricao": "Desenvolvimento e licenciamento de programas de computador não-customizáveis"
},
"DATASITUACAOESPECIAL": "1899-11-30T03:06:28.000Z",
"NOME": "MICROSOFT DO BRASIL IMPORTACAO E COMERCIO DE SOFTWARE E VIDEO GAMES LTDA",
"LOGRADOURO": "AVENIDA DAS NACOES UNIDAS",
"PORTE": "05",
"NUMERO": "12901",
"NOMEFANTASIA": "",
"TIPO": "MATRIZ",
"SITUACAO": "ATIVA",
"DATASITUACAO": "2001-10-15T02:00:00.000Z"
}
}Retornos disponíveis
Erros na autenticação
| HTTP Status | Código | Status | Mensagem |
|---|---|---|---|
| 401 | No APIKey provided | ||
| 401 | APIKey invalid | ||
| 401 | error |
Códigos de retorno
| HTTP Status | Código | Status | Mensagem |
|---|---|---|---|
| 200 | 0 | OK | Solicitação realizada com sucesso. |
| 200 | 10 | OK | CNPJ não tem cadastro na Receita federal. |
Consulta CPF
Método para recuperar as informações de uma pessoa brasileira através do seu CPF
Documentação API consulta CPF
URL para Requisição
http://api.gbcsystems.com.br/rest/apigbc/cpf/consulta/{cpf}
Header
Authorization
Token para autenticação. Seu valor deve ser '<API_KEY>', onde <API_KEY> é o token enviado para seu e-mail.
Paramêtros
cpf
CPF que deseja obter as informações.
numérico
OBRIGATÓRIO
Dados retornados
Dados
| Campo | Tipo | Descrição |
|---|---|---|
| status | texto | Status de retorno da solicitação. |
| message | texto | Mensagem de retorno da solicitação |
| result | objeto | Objeto com os dados da empresa |
| nome | texto | Nome do titular. |
| Sexo | texto | |
| DataNascimento | Datetime | Formato yyyy-MM-ddTHH:mm:ss.fffffff |
| NomeMae | texto | Nome da mãe do titular. |
| NomePai | texto | Nome do pai do titular |
| RG | texto | |
| OrgaoEmissor | texto | Orgão emissor do TG. |
| Idade | inteiro | Idade do titular. |
| NaturalidadeCidade | texto | |
| NaturalidadeUF | texto | |
| PossivelNaturalidade | texto | |
| Nacionalidade | texto | |
| EstadoCivil | texto | C - CASADO; S - SOLTEIRO; D - DIVORCIADO; V - VIUVO; O - OUTROS |
| CPFConjuge | texto | |
| ClasseSocial | texto | |
| Escolaridade | texto | |
| CBOCodigo | texto | |
| CBODescricao | texto | |
| ServidorPublico | texto | |
| TipoIdentidade | texto | |
| Especialidade | texto | |
| Telefones | Array{Telefones} | |
| Enderecos | Array{Enderecos} | |
| Emails | Array{Emails} |
Retornos disponíveis
Erros na autenticação
| HTTP Status | Status | Mensagem |
|---|---|---|
| 401 | No APIKey provided | |
| 401 | APIKey invalid | |
| 401 | error |
Códigos de retorno
| HTTP Status | Status | Mensagem |
|---|---|---|
| 200 | OK | Sucesso. |