IBS e CBS: as opções para 2027 já podem ser consultadas pela API da Sintegrapi.

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á pode consultar por CNPJ os eventos futuros de IBS e CBS disponíveis na fonte. A resposta reúne a identificação do tributo, a descrição do evento e a 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.

Tudo na mesma consulta de Simples Nacional, por 1 crédito, sem cobrança adicional pelos eventos de IBS e CBS.

O que a consulta entrega para o seu sistema

A resposta organiza três 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.
• 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.

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 pela API

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

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": []
  }
}

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. A presença desses eventos não altera, por si só, o enquadramento atual apresentado nos outros campos.

Entenda os campos retornados

Na tabela, [] dentro do nome de um campo significa “cada item da lista”. Os caminhos de eventos partem de simples_nacional.

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 recebida da fonte. Considere essa data ao avaliar uma resposta em cache.
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.

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 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 os eventos em uma área separada da situação atual. 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”.
• Cache: uma resposta anterior pode não trazer eventos mais recentes. Considere atualizado_em e 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?

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á uma cobrança adicional por cada evento nem uma chamada separada para IBS e CBS.

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ê pode levar os eventos de IBS e CBS para o ERP, CRM ou sistema contábil e dar à equipe mais tempo para analisar e agir.

Conheça os planos e contrate a API da Sintegrapi.

Já utiliza nossa API? Veja o contrato e os exemplos de integração e acrescente a leitura de simples_nacional.eventos_futuros à sua rotina.