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:
| 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. -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. |
Não |
Exemplo de chamada:
{
"id_cenario": "0",
"codigo_produto": "0",
"origem_produto": "0",
"paginacao": 100,
"ponteiro_atualizacao": "0"
}
Descrição dos campos de 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. |
Tabela de referência para os campos "cod_status" e "msg_status":
| cod_status | msg_status |
| 0 | Sucesso |
| 1 | LoginSenhaInvalido |
| 8 | UsuarioSemCliente |
| 9 | ClienteSemConnectionString |
| 10 | FalhaNaAplicacao |
Exemplo de retorno:
{
"cenario": [
{
"ent_sai": "3",
"id_cenario": "152275",
"apelido": "Revenda_PR_TO_Importador_CFC",
"uf_origem": "PR",
"uf_destino": "TO",
"origem": "24",
"destinacao": "3",
"cod_natureza_operacao": "712",
"retorno": [
{
"cod_prod": "100500",
"descricao": "ROLAMENTO - AGULHAS",
"ean": "00000000000000",
"ncm": "84824000",
"origem_produto": "1",
"cfop": "6106",
"cest": "0104900",
"icms": {
"cst": "10",
"bc_composicao": 1,
"bc_composicao_sn_especial": 0,
"bc_composicao_fcp": 0,
"aliquota": "4.0000",
"generico": "tributos_aproximados_Estadual=18.00|tributos_aproximados_Federal=19.35",
"vigencia_de": "2017-10-01T00:00:00",
"dispositivo_legal": "Art. 8º, §2º, I, do RICMS/PR. Art. 18, III, do RICMS/PR.",
"inf_adicionais": "Art. 61 e Item 11 do Anexo XXI do RICMS/TO. Art. 8º, §2º, I, do RICMS/PR. Art. 18, III, do RICMS/PR. Protocolo ICMS CONSELHO NACIONAL DE POLÍTICA FAZENDÁRIA - CONFAZ nº 97 de 09.07.2010",
"icms_st": {
"bc_composicao": 71,
"bc_composicao_fcp": 0,
"aliquota_st": "18.0000",
"vigencia_de": "2020-02-01T00:00:00",
"dispositivo_legal": "Protocolo ICMS CONSELHO NACIONAL DE POLÍTICA FAZENDÁRIA - CONFAZ nº 97 de 09.07.2010. Art. 61 e Item 11 do Anexo XXI do RICMS/TO"
},
"estatistica": "A51"
},
"ipi": {
"cst": "50",
"cenq": "999",
"bc_composicao": 57,
"aliquota": "12.0000",
"generico": "ipi_cenq=999",
"vigencia_de": "2017-03-09T00:00:00",
"dispositivo_legal": "Art. 190 do RIPI/2010 e Decreto nº 8.950/2016"
},
"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"
},
"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"
}
}
]
}
],
"ponteiro_atualizacao": "20210514111645",
"origem": "Systax",
"sistema": "Cockpit",
"status": {
"cod_status": 0,
"msg_status": "Retorno com sucesso. "
}
}