## Junta Comercial / SP / NIRE (Pesquisa Avançada) Consulta o Número de identificação do Registro de Empresas (NIRE) na Junta Comercial do Estado de São Paulo (JUCESP) a partir de filtros da empresa, como razão social, endereço, objeto ou tipo de empresa. A API retornará até 15 resultados da pesquisa. ### URL do site - https://jucesponline.sp.gov.br/BuscaAvancada.aspx?IDProduto= ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/junta-comercial/sp/nire` | Parâmetro | Descrição | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | token* | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. | | razao_social** | Razão social da empresa. | | objeto** | Conteúdo presente no objeto da empresa. | | capital_minimo** | Valor mínimo do capital social. Para o valor de R$ 1.200,35, o valor que deve ser informado é "1200.35" | | capital_maximo** | Valor máximo do capital social. Para o valor de R$ 1.200,35, o valor que deve ser informado é "1200.35" | | abertura_inicio** | Data anterior à abertura da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. | | abertura_fim** | Data posterior à abertura da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. | | dissolucao_inicio** | Data anterior à dissolução da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. | | dissolucao_fim** | Data posterior à dissolução da empresa no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. | | logradouro** | Logradouro da empresa. | | cep** | CEP da empresa. | | bairro** | Bairro da empresa. | | municipio** | Município da empresa. | | uf** | UF da empresa. Por exemplo, para o estado de São Paulo, o valor que deve ser informado é SP. | | tipo_empresa** | Tipo da empresa. Possíveis valores:
| | inclui_inativas** | Se a pesquisa deve incluir empresas inativas, este campo deve ter o valor 1 informado. | > * Parâmetro obrigatório. > ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente. ### Exemplos de respostas (OK) ```json { "code": 200, "code_message": "A requisição foi processada com sucesso.", "errors": [], "header": { "api_version": "v2", "service": "junta-comercial/sp/nire", "parameters": { "name": "Nome de Exemplo", "cpf": "11111111111", "senha": "3$Nfp10os92pr" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.2", "requested_at": "2020-01-03T15:45:07.000-03:00", "elapsed_time_in_milliseconds": 3191, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX1+BkeRLRCkXeYvSai6jsOzsmabEDoO1JmJNAO58y+RCdaO/SqzVNg4g4uy7gdUBFGN8xooyPlv7ag==" }, "data_count": 1, "data": [ { "municipio": "São Paulo", "nire": "11111111111", "nome": "Nome de Exemplo", "site_receipt": "https://api.infosimples.com/exemplo-de-url" } ], "site_receipts": [ "https://api.infosimples.com/exemplo-de-url" ] } ``` ### Arquivo de visualização de consulta O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API é **emitido pela fonte original**. ### Exemplos de códigos para integração com a API #### Python ```python # Testado com: Python 3.10.19, Python 3.14.0 import requests url = 'https://api.infosimples.com/api/v2/consultas/junta-comercial/sp/nire' args = { "razao_social": "VALOR_DO_PARAMETRO_RAZAO_SOCIAL", "objeto": "VALOR_DO_PARAMETRO_OBJETO", "capital_minimo": "VALOR_DO_PARAMETRO_CAPITAL_MINIMO", "capital_maximo": "VALOR_DO_PARAMETRO_CAPITAL_MAXIMO", "abertura_inicio": "VALOR_DO_PARAMETRO_ABERTURA_INICIO", "abertura_fim": "VALOR_DO_PARAMETRO_ABERTURA_FIM", "dissolucao_inicio": "VALOR_DO_PARAMETRO_DISSOLUCAO_INICIO", "dissolucao_fim": "VALOR_DO_PARAMETRO_DISSOLUCAO_FIM", "logradouro": "VALOR_DO_PARAMETRO_LOGRADOURO", "cep": "VALOR_DO_PARAMETRO_CEP", "bairro": "VALOR_DO_PARAMETRO_BAIRRO", "municipio": "VALOR_DO_PARAMETRO_MUNICIPIO", "uf": "VALOR_DO_PARAMETRO_UF", "tipo_empresa": "VALOR_DO_PARAMETRO_TIPO_EMPRESA", "inclui_inativas": "VALOR_DO_PARAMETRO_INCLUI_INATIVAS", "token": "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO", "timeout": "300" } response = requests.post(url, args) response_json = response.json() response.close() if response_json['code'] == 200: print("Retorno com sucesso: ", response_json['data']) elif response_json['code'] in range(600, 799): mensagem = "Resultado sem sucesso. Leia para saber mais: \n" mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message']) mensagem += "; ".join(response_json['errors']) print(mensagem) print("Cabeçalho da consulta: ", response_json['header']) print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts']) ``` ## Estamos prontos para ajudar Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.