API - Leitura de Regras Serviços
Objetivo: Retornar as regras de Serviços aprovadas do Cockpit
Método: POST
API Rest / Json: https://api-gateway.systax.com.br/cockpit/v2/api/regras/servicos
Descrição dos campos de chamada:
| Campo | PAI | Descrição | Obrigatório |
| municipio_prestador | / | Informar o código IBGE do município do Prestador ou vazio. | Não |
| cod_trib_municipio | / | Informar o Código do serviço no município ou vazio. | Não |
| cod_servico_interno | / | Informar o Código do serviço interno no cadastro cliente ou vazio. | Não |
| cod_subitem_lei | / | Informar o Código do serviço na Lei 116/2003 ou vazio. | 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. -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:
{
"municipio_prestador": "4314902",
"cod_trib_municipio": "",
"cod_servico_interno": "",
"cod_subitem_lei": "",
"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": [
{
"id_cenario": "RS4314902RS4314902RJ4314902",
"ent_sai": "1",
"cod_natop": "172",
"dt_criacao": "26-12-2022",
"uf_prestador": "RS",
"municipio_prestador": "4314902",
"uf_tomador": "RS",
"municipio_tomador": "4314902",
"uf_servico_prestado": "RJ",
"id_municipio_servico": "3304557",
"servico": [
{
"ser_codi": 240,
"cod_servico_interno": "SERV-SECU",
"desc_servico_interno": "SERV-SECU",
"cod_subitem_lei": "11.02",
"desc_servico": "Vigilância, segurança ou monitoramento de bens, pessoas e semoventes.",
"desc_servico_municipio": "Vigilância, segurança ou monitoramento de bens, pessoas e semoventes.",
"dt_criacao": "26-12-2022",
"iss": {
"iss_responsavel": "TOMADOR",
"iss_mun_incidencia": "EXECUÇÃO",
"iss_exigibilidade": 1,
"iss_aliq": "5",
"iss_bc_comp": "110",
"iss_gene": "ISSRet=S",
"iss_displeg": "Lei 691 de 24/12/1984, art. 14/art. 33,inc I.",
"iss_obs": "CEPOM/SP - Lei nº 13.701/2003, arts. 9º-A, caput e 9º-B, caput - Lei nº 14.042/2005, art. 2º - Decreto nº 53.151/2012, art. 69 - Portaria SF nº 101/2005",
"iss_pis_cst": "1",
"iss_pis_aliq": "1.6500",
"iss_pis_bc_comp": 110,
"iss_pis_vig_de": "02-01-2023",
"iss_pis_displeg": "Art. 30 da Lei 10.833/2003 e Instrução Normativa SRF 459/2004.",
"iss_cofins_cst": "1",
"iss_cofins_aliq": "7.6000",
"iss_cofins_bc_comp": 110,
"iss_cofins_vig_de": "02-01-2023",
"iss_cofins_displeg": "Art. 30 da Lei 10.833/2003 e Instrução Normativa SRF 459/2004."
},
"retencao": {
"ret_pis_aliq": "0.65",
"ret_pis_bc_comp": 40,
"ret_pis_vig_de": "01-01-2019",
"ret_pis_vig_ate": "02-01-2023",
"ret_pis_displeg": "Art. 30 da Lei 10.833/2003 e Instrução Normativa SRF 459/2004.",
"ret_cofins_aliq": "3",
"ret_cofins_bc_comp": 40,
"ret_cofins_vig_de": "01-01-2019",
"ret_cofins_vig_ate": "02-01-2023",
"ret_cofins_displeg": "Art. 30 da Lei 10.833/2003 e Instrução Normativa SRF 459/2004.",
"ret_csll_aliq": "1",
"ret_csll_bc_comp": 40,
"ret_csll_vig_de": "01-01-2019",
"ret_csll_vig_ate": "02-01-2023",
"ret_csll_displeg": "Art. 30 da Lei 10.833/2003 e Instrução Normativa SRF 459/2004.",
"ret_inss_aliq": "11.0000",
"ret_inss_bc_comp": 40,
"ret_inss_vig_de": "01-01-2019",
"ret_inss_vig_ate": "02-01-2023",
"ret_inss_displeg": "Artigo 119 da IN RFB nº 971/2009",
"ret_inss_obs": "Não há retenção",
"ret_irrf_aliq": "1.5",
"ret_irrf_bc_comp": 40,
"ret_irrf_vig_de": "01-01-2019",
"ret_irrf_vig_ate": "02-01-2023",
"ret_irrf_displeg": "IN SRF nº 23/86 e Artigo 714 do RIR/2018.",
"ret_cprb_aliq": "11.0000",
"ret_cprb_bc_comp": 40,
"ret_cprb_vig_de": "01-01-2019",
"ret_cprb_vig_ate": "02-01-2023",
"ret_cprb_displeg": "Lei 12.546/2011",
"ret_cprb_obs": "Não há retenção."
}
}