API de Leitura de Regras - Cockpit Reforma Tributária Manual contendo as últimas atualizações efetuadas em 15/04/2026. Introdução O objetivo deste manual é fornecer as informações necessárias para o consumo das regras tributárias referentes à Reforma Tributária. Aqui você encontrará orientações sobre as seguintes APIs do Cockpit: API de Leitura de Regras Retorna as regras tributárias aprovadas dos tributos relacionados à Reforma Tributária. API de Consulta de Produtos Tributados com Regra Geral Retorna a lista de produtos aos quais se aplica a tributação geral em cada cenário. Observação: o uso dessa API é aplicável apenas a clientes e parceiros que optaram por receber as regras de forma consolidada, considerando regras gerais e específicas. Nos casos em que foi mantido o layout atual (uma regra por produto em cada cenário), essa API não será utilizada. API de Consulta do De-Para de Cenários Retorna os registros da tabela “De-Para – Cenários RT”, que contém a correlação entre os cenários da tributação atual e seus respectivos cenários na Reforma Tributária. Observação: essa API se aplica exclusivamente a clientes e parceiros que contratam tanto as regras da tributação atual quanto as regras da Reforma Tributária. Caso a contratação envolva apenas as regras da Reforma, essa API não será utilizada.     Descrição dos campos de retorno   Retorno Campo PAI Descrição success / Status do retorno message / Mensagem do retorno record_count / Número de registros retornados id data ID do grupo descricao data Descrição do grupo Tabela de referência para os campo "success" e "message" Código de retorno success message 200 true OK 400 false token_invalid false token_expired 500 false internal error Atualizações 15/04/2026 API de Consulta de Produtos Tributados com Regra Geral Inseridas as informações da API criada para consultar os produtos tributados pela regra geral de cada cenário. API de Consulta do De-Para de Cenários Inseridas as informações da API criada para consultar a tabela de de-para de cenários do Cockpit, que contem a correlação entre os cenários da tributação atual e os da Reforma.   04/11/2025 API - Leitura de Regras RT  Inserida a informação de que o campo “ParamProxPag” está parametrizado em base64  Informações da Reforma Tributária retornadas no Cockpit As seguintes modificações foram feitas Alteração das Tags “IBSUF” e ”IBSUF Crédito” para “IBS” e “IBS Crédito” ; Exclusão dos campos “IBSMUn CST” , “IBSMun Class Trib” e “Cenario_CFOP” ; Inclusão do novo campo “tipoRegra” , encontrado na tag “Produto” Autenticação A autenticação da API de leitura de regras do Cockpit é feita via bearer token. Para mais detalhes de como obtê-la, acesse a última versão de documentação pelo link:  https://documentacao.systax.com.br/books/manual-da-api-de-geracao-de-token Swagger O Swagger é uma estrutura de software de código aberto que permite aos desenvolvedores projetar, criar, documentar e consumir serviços da Web RESTful. Esse recurso facilita o trabalho dos desenvolvedores, fazendo com que eles tenham um entendimento do objetivo da API, permitindo executar chamadas sem a necessidade de desenvolvimento de códigos. Link URL: https://wscockpit.systax.com.br/api/swagger/index.html?urls.primaryName=Cockpit%20-%20Reforma%20Tribut%C3%A1ria API Leitura de regras RT Método: GET API Rest/ Json: https://wscockpit.systax.com.br/api/api/RegrasReforma/reforma/ {paginacao}/{ponteiro}/{paramProxPag} Obs.: dada a utilização do método GET, os parâmetros da chamada são informados na própria URL e não há body. Descricão dos parâmetros da chamada Parâmetro Detalhamento do preenchimento Obrigatório Paginação Quantidade de registros/regras a serem entregues por página. Limite máximo 100. Sim Ponteiro Ponteiro do controle de atualização. Sim -Para carga inicial (recebimento de todas as regras), informar 0. -Para atualizações, informar o ponteiro retornado na primeira chamada do dia anterior (ou o ponteiro retornado na primeira chamada do processo anterior, caso seja realizado mais de um processo de leitura por dia). *paramProxPag É o dado recebido no response que identificará quais regras devem retornar na próxima página. Na primeira chamada do processo, informar 0. Sempre que a quantidade de regras retornadas for igual ao valor informado no critério "paginacao", deverá ser feita mais uma chamda para obter a próxima página. A partir da 2ª chamada, informar no parâmetro "paramProxPagina" o valor retornado no campo "paramProxPagina" do response da página anterior.  Sim * Os dados apresentados nesta Tag estão parametrizados em base64. Descrição dos campos de retorno Campo Pai Descrição Ponteiro - Ponteiro de atualização no formato ano+mês+dia+hora+minuto+segundo. Essa informação é retornada na primeira página do processo de carga e deverá ser armazenada para servir de parâmetro para utilização na próxima carga, que identificará quais regras já foram recebidas no processo anterior e, portanto, não deverão ser entregues novamente. codStatus status Código de retorno msgStatus status Mensagem de retorno paramProxPag - Retorna o resultado da concatenação de "IdCenario | codigoProduto | origemProduto" do último produto e cenário retornado nesta página. O objetivo é usar este valor como parâmetro na request da próxima página para definir quais regras devem retornar nesta, assim a primeira regra a ser entregue deverá ser a regra do produto e cenário identificados nesta concatenação e as próximas regras deverão ser as que são subsequentes à primeira.  retorno tributário - O detalhamento do retorno a partir deste campo consta no item "Informações da RT retornadas no Cockpit" deste manual. Mensagens de retorno cod_status msg_status 200 Sucesso 401 Token ou Login/ Senha inválidos 500 Falha na aplicação 901 Usuario sem cliente 902 Cliente sem connection string Exemplos Retorno {     "ponteiro": "20250527141314",     "paramProxPag": "29633451550330",     "status": {         "codStatus": 200,         "msgStatus": "Sucesso"     },     "cenario": [         {             "idCenario": "2963345",             "entSai": "1",             "naturezaOperacao": "121",             "finalidade": "",             "ufOrigem": "SP",             "ufDestino": "SP",             "perfilOrigem": "1552",             "perfilDestino": "3051",             "baseCalculo": "145",             "apelido": "Revenda-SP-SP-Var",             "diasFuturos": "30",             "produto": [                 {                     "codigoProduto": "139274",                     "descricao": "Produto Teste",                     "ncm": "02013000",                     "ean": "7890000164290",                     "origemProduto": "0",                     "tipoRegra": "ESP",                     "regra": {                         "ibs": {                             "operacao": {                                 "cst": "0",                                 "cClassTrib": "1",                                 "pIBS": "0.1000",                                 "pAliq": "0",                                 "pRedAliq": "0",                                 "pAliqEfet": "0",                                 "aliquotaAdRem": "0",                                 "aliquotaAdRemReten": "0",                                 "pDif": "0",                                 "pDevTrib": "0",                                 "valorPauta": "0",                                 "uTrib": "string",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string"                             },                             "gTribRegular": {                                 "cstReg": "0",                                 "cClassTribReg": "0",                                 "pAliqEfetRegIBS": "0",                                 "baseCalculoReg": "0",                                 "pIBS": "0",                                 "pRedAliq": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-12-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string"                             },                             "creditoPresumido": {                                 "indicadorCreditoPres": "111",                                 "cCredPres": "1111111111",                                 "pCredPres": "111.1111",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-12-31T00:00:00",                                 "dispositivoLegal": "Teste de inserção de informações",                                 "observacoes": "Teste de inserção de informações",                                 "informacoesAdicionais": "Teste de inserção de informações"                             },                             "credito": {                                 "indicadorCredito": "0",                                 "cstEntrada": "0",                                 "cfopEntrada": "0",                                 "percentualCredito": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-30T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string"                             }                         },                         "ibsmun": {                             "operacao": {                                 "pIBSMun": "0",                                 "pAliq": "0",                                 "pRedAliq": "0",                                 "pAliqEfet": "0",                                 "aliquotaAdRem": "0",                                 "aliquotaAdRemReten": "0",                                 "pDif": "0",                                 "pDevTrib": "0",                                 "valorPauta": "0",                                 "uTrib": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string",                                 "estatistica": "string|"                             },                             "gTribRegular": {                                 "cstReg": "0",                                 "cClassTribReg": "0",                                 "pAliqEfetRegIBSMun": "0",                                 "baseCalculoReg": "0",                                 "pIBSMun": "0",                                 "pRedAliq": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string"                             },                             "creditoPresumido": {                                 "indicadorCreditoPres": "0",                                 "cCredPres": "0",                                 "pCredPres": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string"                             },                             "credito": {                                 "indicadorCredito": "0",                                 "cstEntrada": "0",                                 "cfopEntrada": "0",                                 "percentualCredito": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string"                             }                         },                         "cbs": {                             "operacao": {                                 "cst": "0",                                 "cClassTrib": "0",                                 "pCBS": "1",                                 "pAliq": "0.9000",                                 "pRedAliq": "0",                                 "pAliqEfet": "0",                                 "aliquotaAdRem": "0",                                 "aliquotaAdRemReten": "0",                                 "pDif": "0",                                 "pDevTrib": "0",                                 "valorPauta": "0",                                 "uTrib": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-12-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string",                                 "estatistica": "string"                             },                             "gTribRegular": {                                 "cstReg": "0",                                 "cClassTribReg": "0",                                 "pAliqEfetRegCBS": "0",                                 "baseCalculoReg": "0",                                 "pCBS": "0",                                 "pRedAliq": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-12-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string"                             },                             "creditoPresumido": {                                 "indicadorCreditoPres": "0",                                 "cCredPres": "0",                                 "pCredPres": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string"                             },                             "credito": {                                 "indicadorCredito": "0",                                 "cstEntrada": "0",                                 "percentualCredito": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-12-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "estatistica": "0"                             }                         },                         "is": {                             "operacao": {                                 "cstIS": "0",                                 "cClassTribIS": "0",                                 "baseCalculo": "0",                                 "pIS": "0",                                 "pISEspec": "0",                                 "valorPauta": "0",                                 "uTrib": "0",                                 "vigenciaDe": "2026-01-01T00:00:00",                                 "vigenciaAte": "2026-01-31T00:00:00",                                 "dispositivoLegal": "string",                                 "observacoes": "string",                                 "informacoesAdicionais": "string",                                 "estatistica": "string"                           }                         }                     }                 }             ]         }     ] } Informações da Reforma Tributária retornadas no Cockpit Neste capítulo, iremos apresentar um descritivo de cada grupo dentro do retorno de uma chamada, descrevendo cada campo existente. Grupo Cenário Reúne somente informações relacionadas aos cenários. Tag Pai Descrição Tipo Obrigatório idCenario cenario ID do cenário Numérico (10 dígitos) Sim Entrada/Saida cenario  Indicação do tipo da operação: 1- Entrada 2- Devolução de Entradas 3- Saídas 4- Devolução de Saídas Obs.: Os itens 2 e 4 existem apenas para situações específicas para integrações com sistema SAP. Numérico (1 dígitos) Não NaturezaOperacao cenario Código de natureza da operação Numérico (4 dígitos) Não Finalidade cenario Código que indica a finalidade do produto, qual a destinação desse produto. Para verificar os códigos, veja a tabela “Natureza de Operações – Utilizado no campo “natureza_operacao”. Numérico (1 dígitos) Não ufOrigem cenario Sigla da UF de origem da mercadoria. String (2 caracteres) Sim municípioOrigem cenario Código de Município de origem da operação. Deve ser utilizada a Tabela de código de Município mantida pelo IBGE disponível em: Tabela Códigos dos Municípios - IBGE Numérico (7 dígitos) Não ufDestino cenario Sigla da UF de destino da mercadoria. String (2 caracteres) Sim municípioDestino cenario Código de Município de destino da operação. Deve ser utilizada a Tabela de código de Município mantida pelo IBGE disponível em: Tabela Códigos dos Municípios - IBGE Numérico (7 dígitos) Não ufEntrega cenario Sigla da UF de entrega da mercadoria String (2 caracteres) Não municípioEntrega cenario Código de Município de entrega da operação. Deve ser utilizada a Tabela de código de Município mantida pelo IBGE disponível em: Tabela Códigos dos Municípios - IBGE Numérico (7 dígitos) Não municípioExecucao cenario Código de Município de execução da operação. Deve ser utilizada a Tabela de código de Município mantida pelo IBGE disponível em: Tabela Códigos dos Municípios - IBGE Numérico (7 dígitos) Não perfilOrigem cenario Perfil do estabelecimento remetente da operação. Para verificar os códigos, veja a tabela “Remetente”. Numérico (5 dígitos) Sim cnaeOrigem cenario Código de Classificação Nacional de Atividades Econômicas (CNAE) do estabelecimento remetente. Deve ser utilizada a tabela mantida pelo IBGE disponível em: Tabela de CNAE do IBGE Numérico (7 dígitos) Não perfilDestino cenario Perfil do estabelecimento remetente da operação. Para verificar os códigos, veja a tabela “Destinação”. Numérico (5 dígitos) Sim cnaeDestino cenario Código de Classificação Nacional de Atividades Econômicas (CNAE) do estabelecimento destinatário. Deve ser utilizada a tabela mantida pelo IBGE disponível em: Tabela de CNAE do IBGE String (10 caracteres) Não perfilPrestador cenario Perfil do prestador de um serviço Numérico (5 dígitos) Não perfilTomador cenario Perfil do prestador de um serviço Numérico (5 dígitos) Não perfilExecutor cenario Perfil do executor de um serviço Numérico (5 dígitos) Não CFOP cenario Código CFOP (Código Fiscal de Operação e Prestação) – Tabela oficial. Numérico (4 dígitos) Sim baseCalculo cenario Base de cálculo para apuração do Imposto sobre Bens e Serviços (IBS) e Contribuição sobre Bens e Serviços (CBS) Numérico (4 dígitos) Sim apelido cenario Identificação do cenário. String (50 caracteres) Não diasFuturos cenario Indicar a quantidade de dias futuros a ser analisada a legislação. Por exemplo se o campo estiver preenchido com “30”, o sistema localizará regras vigentes 30 dias após a data da consulta. Numérico (3 dígitos) Não grupoProdutos cenario Nome dos grupos de produtos associados a esse cenário. String (25 caracteres) Não porporcao cenario Retorno de informação da regra tributária composto pelo valor da pauta dividido pela unidade de medida Numérico (11,4) Não Grupo Produto Informações relacionadas a produtos. Tag Pai Descrição Tipo Obrigatório codigoProduto Cenario Código do produto String (60 caracteres) Sim descricao Cenario Descrição do produto String (120 caracteres) Não ncm Cenario Código do produto conforme a Nomenclatura Comum do Mercosul – Tabela oficial. Código de 8 dígitos. Numérico (8 dígitos) Sim exTipi Cenario Código do produto conforme a Nomenclatura Comum do Mercosul (Exceção) – Tabela oficial. Código de 2 ou 3 dígitos. Numérico (3 dígitos) Não ean Cenario Código universal de identificação de um produto, composto por dígitos correspondentes a código do país, código dda empresa, número do artigo e dígito de verificaçao. String (14 caracteres) Não origemProduto Cenario Origem da Mercadoria ou Serviço – Tabela oficial. Numérico (1 dígitos) Não codigoServMunicipal Cenario Código de serviço específico de cda Prefeitura Numérico (10 dígitos) Sim NBS Cenario Código identificador da Nomenclatura Brasileira de Serviços Numérico (10 dígitos) Não tipoRegra Cenário Campo para determinação do tipo de regra Systax, contendo as Tags RGO (Regra Geral por Operação), ESP (Regra Específica por Produto) e REG (Regra Geral coom parâmetros de cenários) String (3 caracteres Sim Grupo IBS Informações relacionadas ao Imposto sobre Bens e Serviços Estaduais. Tag Pai Descrição Tipo Obrigatório cst Regra Código de Situação Tributária e Código de Situação da Operação – Simples Nacional – CSOSN. Numérico (3 dígitos) Sim cClassTrib Regra Código de Classificação Tributária Numérico (10 dígitos) Sim pIBSUF Regra Alíquota (em %) Percentual (3,4 dígitos) Não pAliq Regra Alíquota (em R$) Percentual (3,4 dígitos) Não pRedAliq Regra Percentual de redução de base de cálculo. Percentual (3,4 dígitos) Não pAliqEfet Regra Alíquota efetiva que do IBS de competência das UF que será aplicada a base de cálculo Percentual (3,4 dígitos) Não aliquotaAdRem Regra Alíquota por unidade de medida Valor (3,4 dígitos) Não aliquotaAdRemReten Regra Alíquota por unidade de medida com retenção Valor (3,4 dígitos) Não pDif Regra Percentual do imposto diferido. Percentual (3,4 dígitos) Não pDevTrib Regra Percentual de devolução na forma de Cashback Percentual (3,4 dígitos) não valorPauta Regra Valor da pauta. Valor utilizado para determinação do valor da base de cálculo do imposto. Valor (11,4 dígitos) Não uTrib Regra Unidade de medida tributável String (1,6 caracteres) Não vigenciaDe Regra Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte Regra Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal Regra Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes Regra Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais Regra Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres) Não estatistica Regra Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo IBS Tributação Regular Reúne as informações do Imposto sobre Bens e Serviços Estaduais relacionadas a tributação caso não cumprida a condição resolutória/ suspensiva. Tag Pai Descrição Tipo Obrigatório CSTREG IBS Código da Situação Tributária do IBSUF Numérico (3 dígitos)  Sim cClassTribReg IBS Código da Classificação Tributária do IBSUF Numérico (10 dígitos) Sim  pAliqEfetRegIBSUF IBS Valor da alíquota efetiva da tributação regular Do IBSUF Numérico (3,4 dígitos)  Não baseCalculoReg IBS Base de cálculo da tributação regular do IBSUF Numérico (4 dígitos)  Sim  pIBSUF IBS Alíquota (em %) Percentual (3,4 dígitos)   Não pRedAliq IBS Percentual de redução de base de cálculo. Percentual (3,4 dígitos)  Não  vigenciaDe IBS Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte IBS Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal IBS Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes IBS Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais IBS Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres) Não estatistica IBS Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo IBS Crédito Presumido Reúne as informações de crédito presumido relacionados ao Imposto sobre Bens e Serviços Estaduais Tag Pai Descrição Tipo Obrigatório indicadorCreditoPres IBS Indicador se hã ou não crédito presumido Numérico (3 dígitos) Sim  cCredPres IBS Código de Classificiação do Crédito Presumido Numérico (10 dígitos) Sim pCredPres IBS Percentual do Crédito Presumido Numérico (3,4 dígitos) Não vigenciaDe IBS Data de início da vigência da tributação. Data (20 dígitos)  Não  vigenciaAte IBS Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal IBS Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes IBS Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais IBS Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres) Não estatistica IBS Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo IBS Crédito Informações de crédito relacionados ao Imposto sobre Bens e Serviços Estaduais. Tag Pai Descrição Tipo Obrigatório indicadorCredito IBS Indicação se há ou não crédito e forma de sua apropriação. Vide tabela “indicador_credito” Numérico (3 dígitos) Sim cstEntrada IBS Código de Situação Tributária. Numérico (3 dígitos) Não cfopEntrada IBS Código CFOP (Código Fiscal de Operação e Prestação) – Tabela oficial relacionado a entradas Numérico (4 dígitos) Sim percentualCredito IBS Percentual de crédito a ser apropriado. Percentual (3,4 dígitos) Não vigenciaDe IBS Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte IBS Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal IBS Norma legal que ampara a tributação indicada. String (300 caracteres) Sim observacoes IBS Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não estatistica IBS Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não   Grupo IBSMun Informações relacionadas ao Imposto sobre Bens e Serviços Municipais. Tag Pai Descrição Tipo Obrigatório cst Regra Código de Situação Tributária e Código de Situação da Operação – Simples Nacional – CSOSN. Numérico (3 dígitos) Sim cClassTrib Regra Código de Classificação Tributária String (10 dígitos) Sim pIBSMun Regra Alíquota (em %) Percentual (3,4 dígitos) Não pAliq Regra Alíquota (em R$) Percentual (3,4 dígitos) Não pRedAliq Regra Percentual de redução de base de cálculo. Percentual (3,4 dígitos) Não pAliqEfet Regra Alíquota efetiva que do IBS de competência das UF que será aplicada a base de cálculo Percentual (3,4 dígitos) Não aliquotaAdRem Regra Alíquota por unidade de medida Valor (3,4 dígitos) Não aliquotaAdRemReten Regra Alíquota por unidade de medida com retenção Valor (3,4 dígitos) Não pDif Regra Percentual do imposto diferido. Percentual (3,4 dígitos) Não pDevTrib Regra Percentual de devolução na forma de Cashback Percentual (3,4 dígitos) não valorPauta Regra Valor da pauta. Valor utilizado para determinação do valor da base de cálculo do imposto. Valor (11,4 dígitos) Não uTrib Regra Unidade de medida tributável String (6 caracteres) Não vigenciaDe Regra Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte Regra Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal Regra Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes Regra Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais Regra Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres) Não estatistica Regra Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo IBSMun Tributação Regular Reúne as informações do Imposto sobre Bens e Serviços Municipais relacionadas a tributação caso não cumprida a condição resolutória/ suspensiva. Tag Pai Descrição Tipo Obrigatório CSTREG IBSMun Código da Situação Tributária do IBSMun Numérico (3 dígitos) Sim  cClassTribReg IBSMun Código da Classificação Tributária do IBSMun Numérico (10 dígitos) Sim  pAliqEfetRegIBSMun IBSMun Valor da alíquota efetiva da tributação regular Do IBSMun Numérico (3,4 dígitos) Não baseCalculoReg IBSMun Base de cálculo da tributação regular do IBSMun Numérico (4 dígitos) Sim  pIBSUF IBSMun Alíquota (em %) Percentual (3,4 dígitos) Não pRedAliq IBSMun Percentual de redução de base de cálculo. Percentual (3,4 dígitos) Não vigenciaDe IBSMun Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte IBSMun Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal IBSMun Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes IBSMun Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais IBSMun Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres) Não estatistica IBSMun Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres)  Não  Grupo IBSMun Crédito Presumido Reúne as informações de crédito presumido relacionados ao Imposto sobre Bens e Serviços Municipais. Tag Pai Descrição Tipo Obrigatório indicadorCreditoPres IBSMun Indicador se hã ou não crédito presumido Numérico (3 dígitos)  Sim cCredPres IBSMun Código de Classificiação do Crédito Presumido Numérico (10 dígitos)  Sim pCredPres IBSMun Percentual do Crédito Presumido Numérico (3,4 dígitos)  Não  vigenciaDe IBSMun Data de início da vigência da tributação. Data (20 dígitos)  Não  vigenciaAte IBSMun Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos)  Não  dispositivoLegal IBSMun Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes IBSMun Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres)  Não  informacoesAdicionais IBSMun Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres) Não estatistica IBSMun Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres)  Não  Grupo IBMun Crédito Informações de crédito relacionados ao Imposto sobre Bens e Serviços Municipais. Tag Pai Descrição Tipo Obrigatório indicadorCredito IBSMun Indicação se há ou não crédito e forma de sua apropriação. Vide tabela “indicador_credito” Numérico (3 dígitos) Sim cstEntrada IBSMun Código de Situação Tributária. Numérico (3 dígitos) Não cClassCredPres IBSMun Código de Classificação Tributária do Crédito Presumido Numérico (10 dígitos) Não cfopEntrada IBSMun Código CFOP (Código Fiscal de Operação e Prestação) – Tabela oficial relacionado a entradas Numérico (4 dígitos) Sim percentualCredito IBSMun Percentual de crédito a ser apropriado. Percentual (3,4 dígitos) Não vigenciaDe IBSMun Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte IBSMun Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal IBSMun Norma legal que ampara a tributação indicada. String (300 caracteres) Sim observacoes IBSMun Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não estatistica IBSMun Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo CBS Informações relacionadas à Contribuição sobre Bens e Serviços. Tag Pai Descrição Tipo Obrigatório cst Regra Código de Situação Tributária e Código de Situação da Operação – Simples Nacional – CSOSN. Numérico (3 dígitos) Sim cClassTrib Regra Código de Classificação Tributária Numérico (6 dígitos) Sim pCBS Regra Alíquota (em %) Percentual (3,4 dígitos) Não pAliq Regra Alíquota (em R$) Percentual (3,4 dígitos) Não pRedAliq Regra Percentual de redução de base de cálculo. Percentual (3,4 dígitos) Não pAliqEfet Regra Alíquota efetiva que do IBS de competência das UF que será aplicada a base de cálculo Percentual (3,4 dígitos) Não aliquotaAdRem Regra Alíquota por unidade de medida Percentual (3,4 dígitos) Não aliquotaAdRemReten Regra Alíquota por unidade de medida com retenção Percentual (3,4 dígitos) Não pDif Regra Percentual do imposto diferido. Percentual (3,4 dígitos) Não pDevTrib Regra Percentual de devolução na forma de Cashback Percentual (3,4 dígitos) Não valorPauta Regra Valor da pauta. Valor utilizado para determinação do valor da base de cálculo do imposto. Valor (11,4 dígitos) Não uTrib Regra Unidade de medida tributável String (1,6 caracteres) Não vigenciaDe Regra Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte Regra Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal Regra Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes Regra Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais Regra Informações adicionais relevantes a operação String (300 caracteres) Não estatistica Regra Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo CBS Tributação Regular Reúne as informações da Contribuição sobre Bens e Serviços relacionadas a tributação caso não cumprida a condição resolutória/ suspensiva Tag Pai Descrição Tipo Obrigatório CSTREG CBS Código da Situação Tributária do CBS Numérico (3 dígitos)  Sim cClassTribReg CBS Código da Classificação Tributária do CBS Numérico (10 dígitos) Sim  pAliqEfetRegCBS CBS Valor da alíquota efetiva da tributação regular Do CBS Numérico (3,4 dígitos) Não baseCalculoReg CBS Base de cálculo da tributação regular do IBSUF Numérico (4 dígitos) Sim  pCBSUF CBS Alíquota (em %) Percentual (3,4 dígitos) Não pRedAliq CBS Percentual de redução de base de cálculo. Percentual (3,4 dígitos) Não vigenciaDe CBS Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte CBS Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal CBS Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes CBS Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais CBS Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres) Não estatistica CBS Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo CBS Crédito Presumido Reúne as informações de crédito presumido relacionadas a Contribuição sobre Bens e Serviços. Tag Pai Descrição Tipo Obrigatório indicadorCreditoPres CBS Indicador se hã ou não crédito presumido Numérico (3 dígitos) Sim  cCredPres CBS Código de Classficiação do Crédito Presumido Numérico (10 dígitos) Sim  pCredPres CBS Percentual do Crédito Presumido Numérico (3,4 dígitos) Não vigenciaDe CBS Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte CBS Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal CBS Norma legal que ampara a tributação indicada. String (300 caracteres) Não observacoes CBS Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais CBS Expressão obrigatória a constar no documento fiscal em decorrência do dispositivo legal da tributação apresentada. String (500 caracteres)  Não  estatistica CBS Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres)  Não  Grupo CBS Crédito Informações de crédito relacionadas a Contribuição sobre Bens e Serviços Tag Pai Descrição Tipo Obrigatório indicadorCredito CBS Indicação se há ou não crédito e forma de sua apropriação. Vide tabela “indicador_credito” Numérico (3 dígitos) Sim cstEntrada CBS Código de Situação Tributária. Numérico (3 dígitos) Não percentualCredito CBS Percentual de crédito a ser apropriado. String (3,4 dígitos) Não vigenciaDe CBS Data de início da vigência da tributação. Data (20 dígitos) Não vigenciaAte CBS Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. Data (20 dígitos) Não dispositivoLegal CBS Norma legal que ampara a tributação indicada. String (300 caracteres) Sim observacoes CBS Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não estatistica CBS Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não Grupo IS Informações relacionadas ao Imposto seletivo Tag Pai Descrição Tipo Obrigatório CSTIS Regra Código de Situação Tributária e Código de Situação da Operação – Simples Nacional – CSOSN. Numérico (3 dígitos) Sim cClassTribIS Regra Código de Classificação Tributária Numérico (10 dígitos) Sim baseCalculo Regra Base de cálculo para apuração do Imposto Seletivo Numérico (4 dígitos) Sim pIS Regra Alíquota do Imposto seletivo Percentual (3,4 dígitos) Sim pISEspec Regra Alíquota específica por unidade de medida apropriada Percentual (3,4 dígitos) Não valorPauta Regra Valor da pauta. Valor utilizado para determinação do valor da base de cálculo do imposto. Valor (11,4 dígitos) Não uTrib Regra Unidade de medida tributável String (1,6 caracteres) Não vigenciaDe Regra Data de início da vigência da tributação. data (20 dígitos) Não vigenciaAte Regra Data de término da vigência da tributação. Quando estiver vazio indica que está vigente por tempo indeterminado. data (20 dígitos) Não dispositivoLegal Regra Norma legal que ampara a tributação indicada. String (300 caracteres) Sim observacoes Regra Indicação de um dispositivo legal que traz condições para a aplicação da tributação apresentada. String (300 caracteres) Não informacoesAdicionais Regra Informações adicionais relevantes a operação String (300 caracteres) Não estatistica Regra Código indicador do campo que sofreu alteração em relação ao último retorno de tributação. É aceita lista de códigos, separados por pipe. String (50 caracteres) Não API Consulta do De-Para de Cenários Consultar os registros da tabela “De-Para – Cenários RT”, que contém a correlação entre os cenários da tributação atual e seus respectivos cenários na Reforma Tributária.  Método: GET API Rest/ Json: https://wscockpit.systax.com.br/api/api/RegrasReforma/DeParaCenarios/ {paginacao}/{ponteiro}/{paramProxPag} Obs.: dada a utilização do método GET, os parâmetros da chamada são informados na própria URL e não há body. Descrição dos parâmetros da chamada  Parâmetro Detalhamento do preenchimento Obrigatório Paginação Quantidade de registros/regras a serem entregues por página. Limite máximo 1.000. Sim Ponteiro Ponteiro do controle de atualização. Sim -Para carga inicial (recebimento de todos os registros), informar 0. -Para atualizações, informar o ponteiro retornado na primeira chamada da carga anterior. *paramProxPag É o dado recebido no response que identificará quais registros devem retornar na próxima página. Na primeira chamada do processo, informar 0. Sempre que retornado o campo "paramProxPag", deverá ser feita mais uma chamada para obter a próxima página. A partir da 2ª chamada, informar no parâmetro "paramProxPagina" o valor retornado no campo "paramProxPagina" do response da página anterior.  O conteúdo retornado neste campo é sempre equivalente ao ID do último cenário atual retornado na página, que também será o primeiro a retornar na próxima página. Sim   Descrição dos campos de retorno Campo Pai Descrição Ponteiro - Ponteiro de atualização no formato ano+mês+dia+hora+minuto+segundo. Essa informação é retornada na primeira página do processo de carga e deverá ser armazenada para servir de parâmetro para utilização na próxima carga, que identificará quais regras já foram recebidas no processo anterior e, portanto, não deverão ser entregues novamente. codStatus status Código de retorno msgStatus status Mensagem de retorno paramProxPag - Retorna o resultado da concatenação de "IdCenario | codigoProduto | origemProduto" do último produto e cenário retornado nesta página. O objetivo é usar este valor como parâmetro na request da próxima página para definir quais regras devem retornar nesta, assim a primeira regra a ser entregue deverá ser a regra do produto e cenário identificados nesta concatenação e as próximas regras deverão ser as que são subsequentes à primeira.  retorno tributário - O detalhamento do retorno a partir deste campo consta no item "Informações da RT retornadas no Cockpit" deste manual. Mensagens de retorno cod_status msg_status 200 Sucesso 401 Token ou Login/ Senha inválidos 500 Falha na aplicação 901 Usuario sem cliente 902 Cliente sem connection string Exemplo de chamada Exemplo de retorno {   "ponteiro": "20260415172447",   "paramProxPag": "150462",   "status": {     "codStatus": 200,     "msgStatus": "Sucesso"   },   "cenario": [     {       "atual": {         "idCenario": "150461",         "entSai": "3",         "apelido": "Revenda-SP-SP-Atacado-Varejista",         "ufOrigem": "SP",         "ufDestino": "SP",         "naturezaOperacao": "121",         "origem": "2",         "destinacao": "140"       },       "rt": {         "idCenario": "82",         "entSai": "3",         "apelido": "Venda-SP-SP-Atacado-Varejo",         "ufOrigem": "SP",         "ufDestino": "SP",         "naturezaOperacao": "121",         "origem": "1553",         "destinacao": "3042"       },       "dtCriacao": "2025-07-04T13:39:22.073",       "usuario": "Superdemo"     },     {       "atual": {         "idCenario": "150462",         "entSai": "1",         "apelido": "Compra-SP-SP-Industria-Atacado",         "ufOrigem": "SP",         "ufDestino": "SP",         "naturezaOperacao": "120",         "finalidade": "569",         "origem": "1",         "destinacao": "138"       },       "rt": {         "idCenario": "82",         "entSai": "3",         "apelido": "Venda-SP-SP-Atacado-Varejo",         "ufOrigem": "SP",         "ufDestino": "SP",         "naturezaOperacao": "121",         "origem": "1553",         "destinacao": "3042"       },       "dtCriacao": "2026-04-14T09:23:58.463",       "usuario": "Superdemo"     }   ] } API Consulta Produtos com Regra Geral Retorna a lista de produtos aos quais se aplica a tributação geral em cada cenário. Método: GET API Rest/ Json: https://wscockpit.systax.com.br/api/api/RegrasReforma/ {paginacao}/{ponteiro}/{paramProxPag} Obs.: dada a utilização do método GET, os parâmetros da chamada são informados na própria URL e não há body. Descrição dos parâmetros da chamada  Parâmetro Detalhamento do preenchimento Obrigatório Paginação Quantidade de registros/regras a serem entregues por página. Limite máximo 1.000. Sim Ponteiro Ponteiro do controle de atualização. Sim -Para carga inicial (recebimento de todos os registros), informar 0. -Para atualizações, informar o ponteiro retornado na primeira chamada da carga anterior. paramProxPag É o dado recebido no response que identificará quais registros devem retornar na próxima página. Na primeira chamada do processo, informar 0. Sempre que retornado o campo "paramProxPag" no response, deverá ser feita mais uma chamada para obter a próxima página. A partir da 2ª chamada, informar no parâmetro "paramProxPagina" o valor retornado no campo "paramProxPagina" do response da página anterior.  O conteúdo retornado neste campo é sempre equivalente a concatenação dos dados do último registro retornado na página (IdCenario + codigoProduto + origemProduto), que também será o primeiro a retornar na próxima página.   * Os dados apresentados nesta Tag estão parametrizados em base64. Sim Descrição dos campos de retorno Campo Pai Descrição Ponteiro - Ponteiro de atualização no formato ano+mês+dia+hora+minuto+segundo. Essa informação é retornada na primeira página do processo de carga e deverá ser armazenada para servir de parâmetro para utilização na próxima carga, que identificará quais registros já foram recebidas no processo anterior e, portanto, não deverão ser entregues novamente. codStatus status Código de retorno msgStatus status Mensagem de retorno paramProxPag - Retorna o resultado da concatenação de "IdCenario + codigoProduto + origemProduto" do último registro retornado nesta página. O objetivo é usar este valor como parâmetro na request da próxima página para definir quais regras devem retornar nesta, assim a primeira regra a ser entregue deverá ser a regra do produto e cenário identificados nesta concatenação e as próximas regras deverão ser as que são subsequentes à primeira.  cenario - Os campos retornados neste bloco são os mesmos campos de cenário e produto existentes em nossas APIs de cadastros. Para consultar mais detalhes, clique aqui . Mensagens de retorno cod_status msg_status 200 Sucesso 401 Token ou Login/ Senha inválidos 500 Falha na aplicação 901 Usuario sem cliente 902 Cliente sem connection string Exemplo de chamada Exemplo de retorno { "ponteiro": "20260415181409", "paramProxPag": "MjIzNTkxMDcwMTAxNTA=", "status": { "codStatus": 200, "msgStatus": "Sucesso" }, "regra": [ { "idCenario": "150459", "codigoProduto": "29730", "origemProduto": 0, "vigenciaDe": "2025-01-07T17:47:39.367", "dtCriacao": "2025-01-07T17:47:39.36", "idCarga": 0 }, { "idCenario": "22359", "codigoProduto": "10701015", "origemProduto": 0, "descricao": "CFI 0 48X1000X2000", "ncm": 72193400, "ean": "7891285399018", "vigenciaDe": "2025-08-14T00:00:00", "dtCriacao": "2025-08-15T15:58:26.8", "idCarga": 11223 } ] }