# API Leitura de regras **Objetivo**: Retornar as regras aprovadas do Cockpit. **Método**: POST **API Rest / Json**: https://api-gateway.systax.com.br/cockpit/v2/api/regras # Descrição dos campos de chamada e Retorno **Chamada**
**Campo** **PAI** **Descrição** **Obrigatório**
id\_cenario / Informar 0 ou 1 para iniciar o processo de leitura. A partir da segunda chamada do processo, informar o último "id\_cenario" retornado na resposta da chamada anterior. Não
codigo\_produto / Informar 0 ou 1 para iniciar o processo de leitura. A partir da segunda chamada do processo, informar o "cod\_prod" do último produto retornado na resposta da chamada anterior. Não
origem\_produto / Informar 0 ou 1 para iniciar o processo de leitura. A partir da segunda chamada do processo, informar a "origem\_produto" do último produto retornado na resposta da chamada anterior. Não
paginacao / Quantidade de registros/regras a serem entregues por página. Limite máximo 100. Não
ponteiro\_atualizacao / Ponteiro do controle de atualização. Não
-Para carga inicial (recebimento de todas as regras), informar 0 ou 1.
-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).
Vide orientações detalhadas no item Ponteiro de atualização e Paginação.
**Retorno**
**Campo** **PAI** **Descrição**
ponteiro\_atualizacao / Ponteiro de atualização no formato ano+mês+dia+hora+minuto+segundo
origem / Valor fixo "Systax".
sistema / Valor fixo "Cockpit".
cod\_status status Código de retorno
msg\_status status Mensagem de retorno
cenario O detalhamento do retorno a partir deste campo está disponível no item Informações retornadas pelo systax\_erp.
**cod\_status** **msg\_status**
0 Sucesso
1 LoginSenhaInvalido
8 UsuarioSemCliente
9 ClienteSemConnectionString
10 FalhaNaAplicacao
# Exemplos de chamada e retorno **Chamada** **{** "id\_cenario": "0", "codigo\_produto": "0", "origem\_produto": "0", "paginacao": 100, "ponteiro\_atualizacao": "0" } **Retorno** { "cenario": \[ { "ent\_sai": "1", "id\_cenario": "292613", "apelido": "Compra-SP-SP-Industria-Varejo--569", "dias\_futuros": "30", "grupo\_produtos": "Industria - Varejo - SP - SP, Compra Origem 2 - SP\_SP, compra origem 0 -SP-SP, SP-SP-120-1-140-569", "uf\_origem": "SP", "uf\_destino": "SP", "origem": "1", "destinacao": "140", "cod\_natureza\_operacao": "120", "finalidade": "569", "retorno": \[ { "cod\_prod": "892478", "descricao": "VENTILADOR DE TETO BRAVO", "ean": "7898140448379", "ncm": "84145990", "origem\_produto": "0", "grupo\_produto\_associado": "SP-SP-120-1-140-569", "cfop": "5401", "cfop\_entrada": "1403", "cest": "2108800", "icms": { "cst": "10", "bc\_composicao": 2, "bc\_composicao\_sn\_especial": 0, "bc\_composicao\_fcp": 0, "aliquota": "18.0000", "vigencia\_de": "2001-01-01T00:00:00", "dispositivo\_legal": "art. 37, I, e § 1º do RICMS/SP. art. 52, I do RICMS/SP", "inf\_adicionais": "Arts. 313-Z 19 do RICMS/SP c/c Portaria SER n º 59/2023. art. 37, I, e § 1º do RICMS/SP. art. 52, I do RICMS/SP.", "icms\_st": { "bc\_composicao": 62, "bc\_composicao\_fcp": 0, "aliquota\_st": "18.0000", "mva": "49.00", "vigencia\_de": "2023-10-01T00:00:00", "dispositivo\_legal": "Arts. 313-Z 19 do RICMS/SP c/c Portaria SER n º 59/2023. art. 52, I do RICMS/SP" }, "estatistica": "Z01|" }, "credito\_icms": { "indicador\_credito": 0, "cst\_entrada": "60", "vigencia\_de": "2001-01-01T00:00:00", "dispositivo\_legal": "Arts. 59, 61 e 272 do RICMS-SP.", "observacoes": "Observar as condições previstas no parágrafo único do art. 272 do RICMS-SP" }, "ipi": { "cst": "51", "cenq": "999", "bc\_composicao": 0, "generico": "ipi\_cenq=999", "vigencia\_de": "2022-08-01T00:00:00", "dispositivo\_legal": "Art. 190 do RIPI/2010 c/c Decreto nº 11.158/2022", "estatistica": "B05|B07" }, "credito\_ipi": { "indicador\_credito": 0, "cst\_entrada": "01", "vigencia\_de": "2010-06-25T00:00:00", "dispositivo\_legal": "Art. 226 do RIPI/2010" }, "pis": { "cst": "01", "bc\_composicao": 2, "aliquota": "1.6500", "vigencia\_de": "2002-12-01T00:00:00", "dispositivo\_legal": "Art. 1º da Lei nº 10.637/2002. Art. 2º, caput, da Lei nº 10.637/2002" }, "credito\_pis": { "indicador\_credito": 1, "cst\_entrada": "50", "percentual\_credito": "100.0000", "vigencia\_de": "2002-12-01T00:00:00", "dispositivo\_legal": "Art. 3°, inciso I, da Lei 10.637/2002" }, "cofins": { "cst": "01", "bc\_composicao": 2, "aliquota": "7.6000", "vigencia\_de": "2004-02-01T00:00:00", "dispositivo\_legal": "Art. 1º da Lei nº 10.833/2003. Art. 2º, caput, da Lei nº 10.833/2003" }, "credito\_cofins": { "indicador\_credito": 1, "cst\_entrada": "50", "percentual\_credito": "100.0000", "vigencia\_de": "2004-02-01T00:00:00", "dispositivo\_legal": "Art. 3°, inciso I, da Lei 10.833/2003" } } \] } \], "ponteiro\_atualizacao": "20241112172839", "origem": "Systax", "sistema": "Cockpit", "status": { "cod\_status": 0, "msg\_status": "Retorno com sucesso. " } }