# 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

**<span lang="EN-US">API Rest/ Json: </span>**<span lang="EN-US">https://wscockpit.systax.com.br/api/api/RegrasReforma/</span>{paginacao}/{ponteiro}/{paramProxPag}

<u>Obs.:</u> 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**

<table border="0" cellpadding="0" cellspacing="0" class="MsoNormalTable" id="bkmrk-par%C3%A2metro-detalhamen" style="width: 92.5%;"><thead><tr><td style="width: 14.6877%;">**Parâmetro**

</td><td style="width: 61.8376%;">**Detalhamento do preenchimento**

</td><td style="width: 23.4542%;">**Obrigatório**

</td></tr></thead><tbody><tr><td style="width: 14.6877%;">Paginação

</td><td style="width: 61.8376%;">Quantidade de registros/regras a serem entregues por página. Limite máximo 1.000.

</td><td style="width: 23.4542%;">Sim

</td></tr><tr><td rowspan="3" style="width: 14.6877%;">Ponteiro

</td><td style="width: 61.8376%;">Ponteiro do controle de atualização.

</td><td rowspan="3" style="width: 23.4542%;">Sim

</td></tr><tr><td style="width: 61.8376%;">-Para carga inicial (recebimento de todos os registros), informar 0.

</td></tr><tr><td style="width: 61.8376%;">-Para atualizações, informar o ponteiro retornado na primeira chamada da carga anterior.

</td></tr><tr><td style="width: 14.6877%;">paramProxPag

</td><td style="width: 61.8376%;">É 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.*

</td><td style="width: 23.4542%;">Sim

</td></tr></tbody></table>

**Descrição dos campos de retorno**

<table border="0" cellpadding="0" cellspacing="0" class="MsoNormalTable" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o-"><tbody><tr><td nowrap="nowrap">**Campo**

</td><td nowrap="nowrap">**Pai**

</td><td nowrap="nowrap">**Descrição**

</td></tr><tr><td nowrap="nowrap">Ponteiro

</td><td nowrap="nowrap">-

</td><td>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.

</td></tr><tr><td nowrap="nowrap">codStatus

</td><td nowrap="nowrap">status

</td><td>Código de retorno

</td></tr><tr><td nowrap="nowrap">msgStatus

</td><td nowrap="nowrap">status

</td><td>Mensagem de retorno

</td></tr><tr><td nowrap="nowrap">paramProxPag

</td><td nowrap="nowrap">-

</td><td>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.

</td></tr><tr><td nowrap="nowrap">cenario

</td><td nowrap="nowrap">-

</td><td>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](https://documentacao.systax.com.br/books/manual-de-cadastro-de-produtos-e-cenarios-cfm "Manual de cadastro de Produtos e Cenários").

</td></tr></tbody></table>

**Mensagens de retorno**

<table border="0" cellpadding="0" cellspacing="0" class="MsoNormalTable" id="bkmrk-cod_status-msg_statu"><thead><tr><td class="align-left" nowrap="nowrap">**cod\_status**

</td><td class="align-left" nowrap="nowrap">**msg\_status**

</td></tr></thead><tbody><tr><td class="align-left" nowrap="nowrap">200

</td><td class="align-left" nowrap="nowrap">Sucesso

</td></tr><tr><td class="align-left" nowrap="nowrap">401

</td><td class="align-left" nowrap="nowrap">Token ou Login/ Senha inválidos

</td></tr><tr><td class="align-left" nowrap="nowrap">500

</td><td class="align-left" nowrap="nowrap">Falha na aplicação

</td></tr><tr><td class="align-left" nowrap="nowrap">901

</td><td class="align-left" nowrap="nowrap">Usuario sem cliente

</td></tr><tr><td class="align-left" nowrap="nowrap">902

</td><td class="align-left" nowrap="nowrap">Cliente sem connection string

</td></tr></tbody></table>

<details id="bkmrk-exemplo-de-chamada"><summary>Exemplo de chamada</summary>

[![image.png](https://documentacao.systax.com.br/uploads/images/gallery/2026-04/scaled-1680-/rItimage.png)](https://documentacao.systax.com.br/uploads/images/gallery/2026-04/rItimage.png)

</details><details id="bkmrk-exemplo-de-retorno-%C2%A0"><summary>Exemplo de retorno</summary>

```json
{
  "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
    }
  ]
}
```

</details>