IBS e CBS: as opções para 2027 já podem ser consultadas pela API da Sintegrapi.
Leve os eventos de IBS e CBS para o seu ERP, CRM ou sistema contábil e prepare os cadastros de clientes e fornecedores para 2027.
Seu fornecedor registrou uma opção pelo Regime Regular do IBS e da CBS? A partir de quando ela produz efeitos? E como levar essa informação para o seu ERP sem depender de uma conferência manual a cada cadastro?
Com a API de Simples Nacional da Sintegrapi, sua empresa já recebe o bloco regime_regular, com campos separados para IBS e CBS, tanto na consulta individual quanto na consulta multifonte de CNPJ. Os eventos futuros disponíveis na fonte continuam separados, com tributo, descrição e data de efeito, junto das informações de Simples Nacional e SIMEI que a integração já utiliza.
Para software houses, equipes fiscais, contabilidades e operações de compras, o ganho está em transformar a informação em um dado que pode ser lido pelo sistema: identificar os cadastros que merecem atenção, organizar a revisão e preparar a operação para 2027.
Simples Nacional, SIMEI, regime_regular e eventos de IBS/CBS na mesma consulta, por 1 crédito, sem cobrança adicional por cada tributo. Na multifonte, você escolhe quais fontes deseja consultar.
O que a consulta entrega para o seu sistema
A resposta organiza quatro conjuntos de informações:
- Simples Nacional: opção atual, início informado pela fonte e histórico de períodos, quando disponíveis.
- SIMEI: enquadramento no regime do microempreendedor individual e seu histórico.
- Regime Regular de IBS e CBS: o bloco
regime_regular, comoptanteesituacaopor tributo, períodos anteriores, origem e prazo do preenchimento de 2026. - Eventos futuros de IBS e CBS: ocorrências informadas pela fonte, com o tributo, a descrição e a data a partir da qual produzem efeitos. Elas não são substituídas pelo bloco novo.
Essa separação permite consultar o enquadramento atual e preparar a revisão de uma mudança futura sem misturar os dois momentos. Sua equipe continua responsável por interpretar os dados no contexto fiscal da operação; a API fornece os elementos para essa análise.
Como consultar o Simples individual
A integração utiliza o endpoint de Simples Nacional:
GET https://api.sintegrapi.com.br/consultas/v2/simples/{cnpj}
x-api-key: SUA_API_KEY
Substitua {cnpj} pelo documento que deseja consultar e envie sua chave de API no cabeçalho. A chave deve ficar no servidor da sua aplicação, não em páginas públicas ou no código do navegador.
Não é necessário chamar uma rota adicional para receber os eventos de IBS e CBS. Quando disponíveis na fonte, eles vêm na lista simples_nacional.eventos_futuros.
Exemplo de resposta JSON do Simples individual
O exemplo abaixo é ilustrativo: os valores servem para demonstrar a estrutura e não representam uma consulta a uma empresa específica. Os campos disponíveis podem variar conforme os dados informados pela fonte.
{
"request_id": "11111111-1111-4111-8111-111111111111",
"success": true,
"error": false,
"cnpj": "12345678000195",
"atualizado_em": "2026-10-26T12:00:00Z",
"simples_nacional": {
"optante": true,
"desde": "2020-01-01",
"historico": [],
"eventos_futuros": [
{
"regime": "IBS",
"descricao": "Opção pelo Regime Regular",
"data_efeito": "2027-01-01"
},
{
"regime": "CBS",
"descricao": "Opção pelo Regime Regular",
"data_efeito": "2027-01-01"
}
]
},
"simei": {
"optante": false,
"historico": []
},
"regime_regular": {
"ibs": {
"optante": false,
"situacao": "Não optante"
},
"cbs": {
"optante": false,
"situacao": "Não optante"
},
"periodos_anteriores": [],
"origem": "SIMPLES_NACIONAL",
"expira_em": "2027-01-01T00:00:00-03:00"
}
}
Como ler esse exemplo: a empresa está identificada como optante pelo Simples Nacional e não optante pelo SIMEI. Separadamente, há dois eventos de opção pelo regime regular, um de IBS e outro de CBS, com efeitos em 1º de janeiro de 2027. O bloco regime_regular mantém IBS e CBS como false/"Não optante" no preenchimento de 2026. Os eventos com efeito em 2027 não antecipam essa situação. A origem e o prazo desse preenchimento estão explicados adiante.
Como receber o mesmo bloco na consulta multifonte
Se o seu sistema usa a consulta multifonte de CNPJ, o contrato do Simples fica dentro de fontes.simples_nacional.dados. Por isso, o caminho completo é fontes.simples_nacional.dados.regime_regular — e não regime_regular na raiz da multifonte.
Para consultar somente o Simples Nacional, sem acionar Receita Federal, Sintegra ou Suframa:
GET https://api.sintegrapi.com.br/consultas/v2/cnpj-multifonte/{cnpj}?receita=false&sintegra=false&suframa=false&simples=true
x-api-key: SUA_API_KEY
Exemplo ilustrativo completo, usando os mesmos dados fictícios da resposta individual e o preço normal de uma fonte, fora das isenções:
{
"request_id": "22222222-2222-4222-8222-222222222222",
"success": true,
"error": false,
"parcial": false,
"creditos": 1,
"cobranca_pendente": false,
"fontes": {
"simples_nacional": {
"request_id": "11111111-1111-4111-8111-111111111111",
"status_http": 200,
"creditos": 1,
"cobranca_pendente": false,
"dados": {
"request_id": "11111111-1111-4111-8111-111111111111",
"success": true,
"error": false,
"cnpj": "12345678000195",
"atualizado_em": "2026-10-26T12:00:00Z",
"simples_nacional": {
"optante": true,
"desde": "2020-01-01",
"historico": [],
"eventos_futuros": [
{
"regime": "IBS",
"descricao": "Opção pelo Regime Regular",
"data_efeito": "2027-01-01"
},
{
"regime": "CBS",
"descricao": "Opção pelo Regime Regular",
"data_efeito": "2027-01-01"
}
]
},
"simei": {
"optante": false,
"historico": []
},
"regime_regular": {
"ibs": {
"optante": false,
"situacao": "Não optante"
},
"cbs": {
"optante": false,
"situacao": "Não optante"
},
"periodos_anteriores": [],
"origem": "SIMPLES_NACIONAL",
"expira_em": "2027-01-01T00:00:00-03:00"
}
}
}
}
}
O envelope informa o status e o consumo de cada fonte. Neste exemplo, apenas o Simples foi selecionado, a consulta foi concluída e o total é de 1 crédito. O bloco IBS/CBS não acrescenta custo. Se habilitar outras fontes, vale a cobrança normal por fonte concluída.
Atenção à seleção: os parâmetros omitidos valem true. Informe os três false do exemplo para consultar apenas Simples. Com simples=false, essa fonte e seu regime_regular não aparecem. Consulte os detalhes de resultados parciais e cobrança na documentação da multifonte.
Entenda os campos retornados
Os caminhos da tabela partem da raiz da resposta individual. Na multifonte, acrescente o prefixo fontes.simples_nacional.dados.. Nos três campos de itens de eventos, o caminho abreviado eventos_futuros[] parte de simples_nacional; [] significa “cada item da lista”.
No celular, deslize a tabela para o lado para ver todas as colunas.
| Campo | Tipo | Exemplo | O que significa e como usar |
|---|---|---|---|
request_id |
string | 11111111-1111-4111-8111-111111111111 |
Identificador da requisição. Guarde para rastrear a consulta e facilitar o atendimento de suporte. |
success |
boolean | true |
Indica sucesso no processamento. Leia em conjunto com error e os dados disponíveis antes de atualizar o cadastro. |
error |
boolean | false |
Indica se a resposta sinaliza erro. Uma falha não deve substituir o enquadramento já salvo por “não optante”. |
cnpj |
string | 12345678000195 |
Documento consultado. Use para vincular a resposta ao cliente ou fornecedor correto. |
atualizado_em |
string date-time | 2026-10-26T12:00:00Z |
Referência de atualização do Simples recebida da fonte. Considere o cache; essa data não comprova atualização dos valores padronizados de regime_regular. |
simples_nacional.optante |
boolean | true |
Situação atual no Simples Nacional. Não é o indicador de opção pelo regime regular do IBS ou da CBS. |
simples_nacional.desde |
string de data | 2020-01-01 |
Início da opção pelo Simples, quando informado pela fonte. |
simples_nacional.historico |
array | [] |
Períodos anteriores do Simples. Quando houver itens, eles podem trazer de, ate e motivo. |
simples_nacional.eventos_futuros |
array opcional | Dois eventos no exemplo | Lista de ocorrências com efeito futuro informadas na consulta. Leia todos os itens, não apenas o primeiro. |
eventos_futuros[].regime |
string | "IBS" ou "CBS" |
Tributo associado ao evento. Identifique cada item por esse campo; não dependa da posição na lista. |
eventos_futuros[].descricao |
string | "Opção pelo Regime Regular" |
Descrição recebida da fonte. Apresente o texto à equipe fiscal junto do tributo e da data. |
eventos_futuros[].data_efeito |
string de data | 2027-01-01 |
Data a partir da qual o evento produz efeitos. Não é a data em que a consulta foi feita. |
simei.optante |
boolean | false |
Situação atual no SIMEI. false nesse campo não significa erro da consulta. |
simei.desde |
string de data, quando informada | Ausente no exemplo | Início da opção pelo SIMEI, quando disponível. Não preencha uma data por suposição. |
simei.historico |
array | [] |
Histórico do SIMEI, separado do histórico do Simples e dos eventos de IBS/CBS. |
regime_regular.ibs.optante |
boolean ou null | false |
Indicador de IBS: false no preenchimento de 2026; null a partir da expiração enquanto não houver integração da situação atual. |
regime_regular.ibs.situacao |
string ou null | "Não optante" |
Texto de IBS correspondente ao preenchimento de 2026; fica null após o prazo. |
regime_regular.cbs.optante |
boolean ou null | false |
Indicador de CBS, separado de IBS e da opção pelo Simples; segue a mesma regra de expiração. |
regime_regular.cbs.situacao |
string ou null | "Não optante" |
Texto da situação de CBS; fica null após o prazo. |
regime_regular.periodos_anteriores |
array ou null | [] |
Lista vazia padronizada em 2026, não uma pesquisa do histórico. Após a expiração, retorna null; nenhum período é inventado. |
regime_regular.origem |
string | "SIMPLES_NACIONAL" |
Acompanha sempre o bloco. Identifica o contexto do preenchimento de 2026; após o prazo, passa a "INDISPONIVEL". |
regime_regular.expira_em |
string date-time | 2027-01-01T00:00:00-03:00 |
Instante em que termina o preenchimento padronizado. Não é uma data de atualização nem o prazo de opção do contribuinte. |
Os campos dos eventos podem vir incompletos quando a fonte não fornece todas as informações. A integração deve aceitar campos ausentes ou nulos e preservar descrições e datas recebidas. O contrato completo está na documentação da API de Simples Nacional.
Por que separar situação atual e efeitos em 2027?
No contexto do Simples Nacional, as opções pelo Regime Regular do IBS e da CBS para o primeiro semestre de 2027 começam a produzir efeitos em 1º de janeiro de 2027, conforme a orientação da Receita Federal e a regulamentação do CGSN.
O manual oficial do Portal do Simples Nacional também distingue a data da solicitação da data em que a opção entra em vigor. Essa é a distinção que sua integração precisa preservar.
Na prática, um evento com data de efeito em janeiro de 2027 pode orientar a preparação da equipe ainda em 2026, mas não deve ser tratado como um enquadramento já vigente antes daquela data.
Como o regime_regular se comporta em 2026 e na virada para 2027
No contexto do Simples Nacional descrito pelo portal e pela regulamentação, as opções para 2027 têm efeitos futuros. Na versão atual da API, o retorno de 2026 é padronizado: IBS e CBS recebem false e "Não optante", e periodos_anteriores recebe [].
Esses valores são preenchidos pela regra de transição da API; não resultam de uma pesquisa individual do enquadramento atual ou do histórico de cada tributo. origem: "SIMPLES_NACIONAL" identifica esse contexto, não uma atualização em tempo real. Para acompanhar opções registradas para 2027, leia os eventos efetivamente informados em simples_nacional.eventos_futuros.
O preenchimento vale somente antes de 2027-01-01T00:00:00-03:00, equivalente a 2027-01-01T03:00:00Z. Exatamente nesse instante e depois, enquanto a integração da situação atual não estiver disponível, o bloco passa a retornar:
{
"regime_regular": {
"ibs": {
"optante": null,
"situacao": null
},
"cbs": {
"optante": null,
"situacao": null
},
"periodos_anteriores": null,
"origem": "INDISPONIVEL",
"expira_em": "2027-01-01T00:00:00-03:00"
}
}
Esse é um fragmento da resposta individual. Na multifonte, o mesmo objeto fica em fontes.simples_nacional.dados.regime_regular. Os nulos aparecem explicitamente no JSON, inclusive quando o Simples vem do cache. null significa informação indisponível, não “não optante”.
A consulta válida de Simples Nacional continua bem-sucedida. A expiração dos campos novos não a transforma em erro, não muda atualizado_em nem apaga os eventos futuros. Em respostas com erro ou sem dados do Simples, o bloco não é preenchido.
Como usar esses dados na sua operação
Cadastro de fornecedores e compras
Inclua os eventos de IBS/CBS na conferência cadastral. Quando surgir uma opção com efeito futuro, encaminhe o cadastro para revisão da equipe fiscal, mantendo o tributo, a descrição, a data de efeito e a referência de atualização da consulta.
Isso ajuda a organizar a análise das relações comerciais sem exigir que a equipe descubra cada mudança apenas quando uma operação estiver sendo processada.
ERP, software fiscal e plataformas contábeis
Apresente regime_regular.ibs e regime_regular.cbs em campos separados, com origem e prazo, e mantenha os eventos futuros em outra área. Na multifonte, reutilize essa leitura a partir de fontes.simples_nacional.dados. Seu sistema pode registrar uma tarefa de revisão para a data relevante e manter a resposta vinculada ao CNPJ e ao request_id.
Evite criar uma regra que classifique automaticamente a empresa apenas porque a lista de eventos existe. A interpretação depende do conteúdo de cada evento, de sua data e do contexto fiscal.
Contabilidade e atendimento ao cliente
Use as informações para orientar uma conversa objetiva: qual opção foi informada, a qual tributo ela se refere e quando começa a produzir efeitos. Assim, a consulta deixa de ser apenas uma conferência de “sim ou não” e passa a apoiar a preparação do cliente para a mudança.
Cuidados para uma integração confiável
- Lista vazia:
eventos_futuros: []significa que a fonte retornou uma lista vazia naquela consulta; não é uma confirmação genérica de ausência de qualquer opção. - Campo ausente ou nulo: a informação não foi fornecida naquela resposta. Não transforme ausência de dados em “não optante”.
- Regime regular em 2026: interprete
falsee[]como o preenchimento padronizado desta versão, não como pesquisa individual dos dois tributos. Trate a virada paranullpelo prazo deexpira_em. - Cache: uma resposta anterior pode não trazer eventos mais recentes. Considere
atualizado_eme a política de cache definida para sua integração. - Erros: trate o status HTTP e os indicadores da resposta antes de substituir dados já conhecidos.
- Evolução do contrato: preserve campos e valores novos que possam aparecer, sem presumir que sempre haverá exatamente dois eventos.
Esses cuidados permitem incorporar a consulta ao fluxo do seu sistema com uma leitura consistente dos dados, sem antecipar efeitos tributários.
Quanto custa consultar IBS e CBS pela Sintegrapi?
O bloco regime_regular e os eventos disponíveis integram a consulta de Simples Nacional, cujo consumo é de 1 crédito por requisição concluída sem erro, em cache ou online. Não há cobrança adicional por campo, tributo ou evento. Na multifonte, selecionar somente Simples mantém esse custo normal; ao habilitar outras fontes, cada uma segue sua própria cobrança.
O valor financeiro do crédito depende do plano contratado. Confira os planos e a tabela de consumo para escolher a opção compatível com o volume da sua operação.
Prepare seu sistema agora
A preparação para 2027 começa com informação organizada no cadastro de clientes e fornecedores. Com a Sintegrapi, você já pode integrar a estrutura de IBS/CBS, seus prazos e os eventos futuros disponíveis ao ERP, CRM ou sistema contábil, pela rota individual ou pela multifonte, e dar à equipe mais tempo para analisar e agir.
Conheça os planos e contrate a API da Sintegrapi.
Já utiliza nossa API? Veja os exemplos de Simples individual e CNPJ multifonte. Acrescente regime_regular, sua expiração e os eventos futuros à sua rotina, sem criar consultas separadas para IBS e CBS.