Homologação · Dados fictícios · Sem consumo de créditos

Simples Nacional em homologação

Teste optantes e não optantes do Simples Nacional e SIMEI, históricos, eventos futuros e o bloco de regime regular. Todos os períodos e eventos são sintéticos e permanecem fixos.

As respostas são estáticas e não consomem saldo. Use os documentos do catálogo abaixo para escolher os casos da sua integração.

Endpoint

GEThttps://sandbox.sintegrapi.com.br/consultas/v2/simples/{cnpj}

Envie x-api-key: sintegrapi-sandbox. Autenticação de homologação.

Parâmetros

ParâmetroLocalTipoObrigatórioPadrãoUso no sandbox
cnpjCaminhostringSim—CNPJ completo do catálogo. Aceita a normalização e os dígitos verificadores da API, inclusive CNPJ alfanumérico.
cacheHeaderintegerNão7Mantido por compatibilidade. Não altera nem faz expirar os dados estáticos do cenário.
x-api-keyHeaderstringSim—Use a chave pública de demonstração sintegrapi-sandbox.
AcceptHeaderstringNãoapplication/jsonUse application/json para os exemplos do catálogo. application/xml negocia XML nas respostas compatíveis; confira o Content-Type recebido.

Particularidades

A resposta reúne Simples Nacional e SIMEI. Trate cada indicador optante e seus períodos separadamente.

Eventos futuros podem estar ausentes ou conter itens incompletos ou nulos. O bloco regime_regular inclui estados indisponível e provisório; suas datas são fixas no catálogo.

O cenário sem resultado conserva HTTP 200 e success=true. Uma falha técnica da fonte também pode usar HTTP 200, com error=true; o status HTTP sozinho não classifica o resultado.

O cache seleciona uma origem simulada. As datas e os dados do cenário são fixos; o prazo não faz o resultado expirar nem consulta uma fonte externa.

Exemplo de requisição

O exemplo usa um documento sintético com resultado encontrado. Copie o código para sua integração; esta página não executa a consulta.

Exemplo de homologação · Simples Nacional

Optante pelo Simples e não optante pelo SIMEI · HTTP 200

Custo simulado: 1 crédito (consulta padrão). Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. Nenhum saldo real é consumido.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90175302000193' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'

Variações e cenários

  • Optante e não optante do Simples Nacional; MEI com SIMEI ativo.
  • Históricos com vários períodos, eventos futuros presentes, omitidos, incompletos ou nulos.
  • regime_regular.origem: INDISPONIVEL e SIMPLES_NACIONAL; indicadores IBS/CBS null ou false e listas null ou vazias.

Use o documento e os parâmetros indicados na mesma linha. Um documento válido desconhecido recebe o retorno de ausência desta consulta. Entradas inválidas são rejeitadas antes da seleção do cenário.

Versão do catálogo: 1.1.0. Baixar todos os cenários e respostas em JSON.

Os custos simulam uma conta tarifada padrão em produção, com os parâmetros indicados; nenhum saldo real é consumido. Tarifas: 2026-11-18. Um custo indeterminado não equivale a zero.

A collection completa inclui todas as consultas e cenários, independentemente do filtro desta página. Como importar e executar no Postman.

13 cenários encontrados.

CenárioDocumentoHTTPCusto simuladoRequisição
Optante pelo Simples e não optante pelo SIMEI
Simples Nacional
simples.completo
Variações cobertas
  • simples_nacional.optante=true
  • simei.optante=false
90175302000193
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90175302000193
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90175302000193' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
CNPJ não encontrado nas bases do Simples
Simples Nacional
simples.sem-resultado
Variações cobertas
  • sem_resultado
  • success=true
  • http=200
90751099000156
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90751099000156
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90751099000156' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Não optante pelo Simples nem SIMEI
Simples Nacional
simples.nao-optante
Variações cobertas
  • simples_nacional.optante=false
  • simei.optante=false
  • desde=omitido
90565064000122
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90565064000122
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90565064000122' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Optante pelo Simples e pelo SIMEI
Simples Nacional
simples.mei
Variações cobertas
  • simei.optante=true
90955898000144
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90955898000144
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90955898000144' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Períodos anteriores do Simples e SIMEI
Simples Nacional
simples.historicos
Variações cobertas
  • simples_nacional.historico=multipla
  • simei.historico=presente
90744090000118
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90744090000118
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90744090000118' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Eventos futuros sintéticos, incluindo entradas incompletas
Simples Nacional
simples.eventos-futuros
Variações cobertas
  • eventos_futuros=multipla
  • eventos_futuros.item=null
  • eventos_futuros.item=incompleto
90170011000102
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90170011000102
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90170011000102' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Fonte sem informação de eventos futuros
Simples Nacional
simples.eventos-nao-informados
Variações cobertas
  • eventos_futuros=omitido
90439877000176
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90439877000176
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90439877000176' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Regime regular no cenário posterior à expiração
Simples Nacional
simples.regime-regular-indisponivel
Variações cobertas
  • regime_regular.origem=INDISPONIVEL
  • regime_regular.ibs.optante=null
  • regime_regular.cbs.optante=null
  • periodos_anteriores=null
90070629000109
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90070629000109
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90070629000109' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Regime regular provisório anterior à expiração
Simples Nacional
simples.regime-regular-provisorio
Variações cobertas
  • regime_regular.origem=SIMPLES_NACIONAL
  • regime_regular.ibs.optante=false
  • regime_regular.cbs.optante=false
  • periodos_anteriores=[]
90951531000152
CNPJ
2001 crédito

Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções.

GET /consultas/v2/simples/90951531000152
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90951531000152' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Erro de consulta com HTTP 200 preservado
Simples Nacional
simples.indisponivel
Variações cobertas
  • erro_tecnico
  • http=200
  • regime_regular=omitido
90636306000121
CNPJ
2000 créditos

Resultado sem consumo de créditos em produção: erro, restrição ou consulta não iniciada.

GET /consultas/v2/simples/90636306000121
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90636306000121' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Timeout simulado imediatamente, sem espera ou consumo real
Simples Nacional
simples.timeout
Variações cobertas
  • http=503
  • CONSULTA_TIMEOUT
90897739000130
CNPJ
503Indeterminado

Timeout não confirma o custo final em produção; consulte o histórico pelo request_id. Nenhum saldo é consumido no sandbox.

GET /consultas/v2/simples/90897739000130
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90897739000130' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Saldo insuficiente simulado; nenhum saldo é consultado
Simples Nacional
simples.saldo-insuficiente
Variações cobertas
  • http=402
  • saldo=simulado
90036875000136
CNPJ
4020 créditos

Resultado sem consumo de créditos em produção: erro, restrição ou consulta não iniciada.

GET /consultas/v2/simples/90036875000136
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90036875000136' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'
Limite de requisições simulado
Simples Nacional
simples.limite-requisicoes
Variações cobertas
  • http=429
  • body=vazio
90930105000132
CNPJ
4290 créditos

Resultado sem consumo de créditos em produção: erro, restrição ou consulta não iniciada.

GET /consultas/v2/simples/90930105000132
Parâmetros e requisição cURL

Nenhum parâmetro adicional.

curl --request GET 'https://sandbox.sintegrapi.com.br/consultas/v2/simples/90930105000132' \
  --header 'x-api-key: sintegrapi-sandbox' \
  --header 'Accept: application/json'

Veja também autenticação, erros simulados e o catálogo completo.

Esta página foi útil?