Ir para o conteúdo principal

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, com optante e situacao por 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 false e [] como o preenchimento padronizado desta versão, não como pesquisa individual dos dois tributos. Trate a virada para null pelo prazo de expira_em.
  • 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?

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.