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
https://sandbox.sintegrapi.com.br/consultas/v2/simples/{cnpj}Envie x-api-key: sintegrapi-sandbox. Autenticação de homologação.
Parâmetros
| Parâmetro | Local | Tipo | Obrigatório | Padrão | Uso no sandbox |
|---|---|---|---|---|---|
cnpj | Caminho | string | Sim | — | CNPJ completo do catálogo. Aceita a normalização e os dígitos verificadores da API, inclusive CNPJ alfanumérico. |
cache | Header | integer | Não | 7 | Mantido por compatibilidade. Não altera nem faz expirar os dados estáticos do cenário. |
x-api-key | Header | string | Sim | — | Use a chave pública de demonstração sintegrapi-sandbox. |
Accept | Header | string | Não | application/json | Use 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ário | Documento | HTTP | Custo simulado | Requisição |
|---|---|---|---|---|
| Optante pelo Simples e não optante pelo SIMEI Simples Nacional simples.completoVariações cobertas
| 90175302000193CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90175302000193Parâmetros e requisição cURLNenhum parâmetro adicional. |
| CNPJ não encontrado nas bases do Simples Simples Nacional simples.sem-resultadoVariações cobertas
| 90751099000156CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90751099000156Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Não optante pelo Simples nem SIMEI Simples Nacional simples.nao-optanteVariações cobertas
| 90565064000122CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90565064000122Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Optante pelo Simples e pelo SIMEI Simples Nacional simples.meiVariações cobertas
| 90955898000144CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90955898000144Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Períodos anteriores do Simples e SIMEI Simples Nacional simples.historicosVariações cobertas
| 90744090000118CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90744090000118Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Eventos futuros sintéticos, incluindo entradas incompletas Simples Nacional simples.eventos-futurosVariações cobertas
| 90170011000102CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90170011000102Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Fonte sem informação de eventos futuros Simples Nacional simples.eventos-nao-informadosVariações cobertas
| 90439877000176CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90439877000176Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Regime regular no cenário posterior à expiração Simples Nacional simples.regime-regular-indisponivelVariações cobertas
| 90070629000109CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90070629000109Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Regime regular provisório anterior à expiração Simples Nacional simples.regime-regular-provisorioVariações cobertas
| 90951531000152CNPJ | 200 | 1 crédito Preço base da consulta concluída, inclusive ausência funcional, para cliente padrão sem isenções. | GET /consultas/v2/simples/90951531000152Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Erro de consulta com HTTP 200 preservado Simples Nacional simples.indisponivelVariações cobertas
| 90636306000121CNPJ | 200 | 0 créditos Resultado sem consumo de créditos em produção: erro, restrição ou consulta não iniciada. | GET /consultas/v2/simples/90636306000121Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Timeout simulado imediatamente, sem espera ou consumo real Simples Nacional simples.timeoutVariações cobertas
| 90897739000130CNPJ | 503 | Indeterminado 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/90897739000130Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Saldo insuficiente simulado; nenhum saldo é consultado Simples Nacional simples.saldo-insuficienteVariações cobertas
| 90036875000136CNPJ | 402 | 0 créditos Resultado sem consumo de créditos em produção: erro, restrição ou consulta não iniciada. | GET /consultas/v2/simples/90036875000136Parâmetros e requisição cURLNenhum parâmetro adicional. |
| Limite de requisições simulado Simples Nacional simples.limite-requisicoesVariações cobertas
| 90930105000132CNPJ | 429 | 0 créditos Resultado sem consumo de créditos em produção: erro, restrição ou consulta não iniciada. | GET /consultas/v2/simples/90930105000132Parâmetros e requisição cURLNenhum parâmetro adicional. |
Veja também autenticação, erros simulados e o catálogo completo.
