API de Leitura de Regras - Cockpit Reforma Tributária
Manual contendo as últimas atualizações efetuadas em 15/04/2026.
- Introdução
- Descrição dos campos de retorno
- Atualizações
- Autenticação
- Swagger
- API Leitura de regras RT
- Exemplos
- Informações da Reforma Tributária retornadas no Cockpit
- Grupo Cenário
- Grupo Produto
- Grupo IBS
- Grupo IBS Tributação Regular
- Grupo IBS Crédito Presumido
- Grupo IBS Crédito
- Grupo IBSMun
- Grupo IBSMun Tributação Regular
- Grupo IBSMun Crédito Presumido
- Grupo IBMun Crédito
- Grupo CBS
- Grupo CBS Tributação Regular
- Grupo CBS Crédito Presumido
- Grupo CBS Crédito
- Grupo IS
- API Consulta do De-Para de Cenários
- API Consulta Produtos com Regra Geral
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
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.
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: |
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. |
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 |
|
|
|
|
|
|
|
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. |
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 |
|
|
|
|
|
|
|
|
|
|
|
|
|
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 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 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
}
]
}