API Simples Nacional

Documentação da API Simples Nacional

Recuperar dados de uma empresa no Simples Nacional

Método para recuperar as informações de uma empresa brasileira através do seu CNPJ. As informações são exatamente as mesmas retornadas pelo site do Simples Nacional.

GET

URL para requisição 

https://www.sintegraws.com.br/api/v1/execute-api.php?token={token}&cnpj={cnpj}&plugin={SN}

Parâmetros de requisição da API do Simples Nacional

token
string

obrigatório
O seu token é gerado após o cadastro no portal.
Ver meu token

cnpj
string

obrigatório
CNPJ que deseja obter as informações do Simples Nacional. Utilize o formato 00000000000000.

plugin
string

obrigatório
Site no qual deseja as informações, no caso da API Simples Nacional informar "SN".

Exemplo de resposta da API Simples Nacional
Uma resposta típica é composta por um JSON.

  • Status: 200 OK
  • Time: 200 ms
  • Size: 2021 bytes 
{"code":"0","status":"OK","message":"Pesquisa realizada com sucesso.","cnpj":"06990590000123","cnpj_matriz":"06.990.590\/0001-23","nome_empresarial":"GOOGLE BRASIL INTERNET LTDA.","situacao_simples_nacional":"N\u00c3O optante pelo Simples Nacional","situacao_simei":"N\u00c3O optante pelo SIMEI","situacao_simples_nacional_anterior":"N\u00e3o Existem","situacao_simei_anterior":"N\u00e3o Existem","agendamentos":"N\u00e3o Existem","eventos_futuros_simples_nacional":"N\u00e3o Existem","eventos_futuros_simples_simei":"N\u00e3o Existem"}

Campos de retorno da API Simples Nacional

status string
Indica a situação da requisição.
Valores possíveis:
  • OK
  • ERROR
code string
Código de retorno utilizado para informar o status da requisição.
message string
Mensagem explicativa indicando o campo status.
cnpj string
CNPJ no formato 00000000000000.
cnpj_matriz string
CNPJ no formato 00.000.000/0000-00.
nome_empresarial string
Razão social.
situacao_simples_nacional string
Situação no Simples Nacional.
situacao_simei string
Situação no SIMEI.
situacao_simples_nacional_anterior string
Opções pelo Simples Nacional em Períodos Anteriores.
situacao_simei_anterior string
Opções pelo SIMEI em Períodos Anteriores.
agendamentos string
Agendamentos no Simples Nacional.
eventos_futuros_simples_nacional string
Eventos Futuros no Simples Nacional.
eventos_futuros_simples_simei string
Eventos Futuros no SIMEI.
Retornos disponíveis
Status Request code status message
200 OK 0 OK Pesquisa realizada com sucesso.
200 OK 1 OK CNPJ não tem cadastro no site do simples nacional.
200 OK 2 ERROR CNPJ inválido.
401 Unauthorized 3 ERROR Token inválido.
200 OK 4 ERROR Usuário não contratou nenhum pacote de créditos.
200 OK 5 ERROR Os créditos contratados acabaram.
200 OK 6 ERROR Plugin não existe.
200 OK 7 ERROR Site do Simples Nacional está com instabilidade.
200 OK 8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.