Skip to main content

API Consulta Produtos com Regra Geral

Consultar os registros da tabela “De-Para – Cenários RT”, que contémRetorna a correlaçãolista entrede osprodutos cenáriosaos daquais se aplica a tributação atualgeral eem seus respectivoscada cenários na Reforma Tributária. rio.

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", 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 aoa IDconcatenação dos dados do último cenário atualregistro retornado na página,gina (IdCenario + codigoProduto + origemProduto), que também será o primeiro a retornar na próxima página.

Sim

*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 regrasregistros 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árioregistro 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áriocenario

-

OOs detalhamentocampos doretornados retornoneste abloco partirsão desteos campomesmos constacampos node itemcenário "Informaçõese daproduto RTexistentes retornadasem nonossas Cockpit"APIs destede manual.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

image.pngimage.png

Exemplo de retorno

 

{
  "ponteiro": "20260415172447"20260415181409",
  "paramProxPag": "150462"MjIzNTkxMDcwMTAxNTA=",
  "status": {
    "codStatus": 200,
    "msgStatus": "Sucesso"
  },
  "cenario"regra": [
    {
      "atual":
    {
      "idCenario": "150461"150459",
      "entSai"codigoProduto": "3"29730",
      "apelido"origemProduto": 0,
      "vigenciaDe": "Revenda-SP-SP-Atacado-Varejista"2025-01-07T17:47:39.367",
      "ufOrigem"dtCriacao": "SP"2025-01-07T17:47:39.36",
      "ufDestino"idCarga": "SP",
        "naturezaOperacao": "121",
        "origem": "2",
        "destinacao": "140"0
    },
      "rt":
    {
      "idCenario": "82"22359",
      "entSai"codigoProduto": "3"10701015",
      "apelido"origemProduto": 0,
      "descricao": "Venda-SP-SP-Atacado-Varejo"CFI 0 48X1000X2000",
      "ufOrigem"ncm": 72193400,
      "ean": "SP"7891285399018",
      "ufDestino"vigenciaDe": "SP",
        "naturezaOperacao": "121",
        "origem": "1553",
        "destinacao": "3042"
      }2025-08-14T00:00:00",
      "dtCriacao": "2025-07-04T13:39:22.073"08-15T15:58:26.8",
      "usuario"idCarga": "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"11223
    }
  ]
}