# API de Aprovação ou Rejeição de Regras

# Estrutura dos dados da chamada

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-descri%C3%A7%C3%A3o-obri"><tbody><tr><td>**Campo**</td><td>**Descrição**</td><td>**Obrigatório**</td></tr><tr><td>id</td><td>Não tem validação de informação indicada, deve ser retornado como indicação do item no response</td><td>Não</td></tr><tr><td>acao</td><td>Indica qual ação será executada pela API.  
  
**A:** Aprovar regras pendentes, de acordo com os parâmetros informados.  
  
**R:** Rejeitar regras pendentes, de acordo com os parâmetros informados.  
 </td><td>Sim</td></tr><tr><td>cenario</td><td>Aprova ou rejeita regras relacionadas ao cenário indicado</td><td>Não</td></tr><tr><td>natureza</td><td>Aprova ou rejeita regras relacionadas a informação, se recebida</td><td>Não</td></tr><tr><td>ufOrigem</td><td>Aprova ou rejeita regras relacionadas a informação, se recebida</td><td>Não</td></tr><tr><td>ufDestino</td><td>Aprova ou rejeita regras relecionadas a informação, se recebida</td><td>Não</td></tr><tr><td>perfilOrigem</td><td>Aprova ou rejeita regras relacionadas a informação, se recebida</td><td>Não</td></tr><tr><td>perfilDestino</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>munOrigem</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>munDestino</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>finalidade</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>codProduto</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>origemProduto</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>ncm</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>extipi</td><td>Aprova ou rejeita regras, relacionadas a informação, se recebidas</td><td>Não</td></tr><tr><td>ean</td><td>Aprova ou rejeita regras, relacionadas a informação se recebidas</td><td>Não</td></tr><tr><td>periodo</td><td>É indicado no formato dd/mm/aaaa a dd/mm/aaaa e a API aprova ou rejeita regras pendentes dentro desse </td><td> </td></tr></tbody></table>

**Importante:** Caso não seja informado o campo ação, a API irá retornar uma mensagem de erro "o campo acao deve ser indicado".  
**Importante 2:** Se não informado nenhum parâmetro, todas as regras pendentes serão aprovadas ou rejeitadas, de acordo com a ação indicada.  
  
**Códigos de retorno**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-retorno-0-par"><tbody><tr><td>**Código**</td><td>**Retorno**</td></tr><tr><td>0</td><td>Parâmetros incorretos</td></tr><tr><td>1</td><td>Deve ser indicada "acao"</td></tr><tr><td>2</td><td>Retornado com sucesso</td></tr><tr><td>3</td><td>Não existem regras pendentes</td></tr></tbody></table>

# Estrutura dos dados de retorno

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-descri%C3%A7%C3%A3o-id-r"><tbody><tr><td>**Campo**</td><td>**Descrição**</td></tr><tr><td>id</td><td>Retorna de acordo com o valor indicado na chamada</td></tr><tr><td>protocolo</td><td>Protocolo gerado no retorno da chamada</td></tr><tr><td>data</td><td>Informa a data em que a ação foi executada</td></tr><tr><td>cod</td><td>Informa o código de retorno, que indica se ação foi executada com sucesso ou não</td></tr><tr><td>message</td><td>Mensagem de retorno, de acordo com o código acima</td></tr></tbody></table>

# Exemplo de chamada

{  
 "itens": \[  
 {  
 "id": 0,  
 "acao": "A",  
 "cenario": "2104488",  
 "natureza": "108",  
 "ufOrigem": "GO",  
 "ufDestino": "SP",  
 "perfilOrigem": "2",  
 "perfilDestino": "578",  
 "munOrigem": "",  
 "munDestino": "",  
 "finalidade": "175",  
 "codProduto": "630797",  
 "origemProduto": "0",  
 "ncm": "01012100",  
 "extipi": "",  
 "ean": "10203040",  
 "periodo": ""  
 }  
 \]  
}

[![API Aprovação e Rejeição de Regras - Exemplo de chamada (Imagem 1).png](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/scaled-1680-/api-aprovacao-e-rejeicao-de-regras-exemplo-de-chamada-imagem-1.png)](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/api-aprovacao-e-rejeicao-de-regras-exemplo-de-chamada-imagem-1.png)

# Exemplo de retorno

{  
 "itens": \[  
 {  
 "id": 0,  
 "protocolo": 35,  
 "data": "18/09/2023 16:06:14",  
 "cod": 2,  
 "message": "Retornado com sucesso"  
 }  
 \]  
}

[![API Aprovação e Rejeição de Regras - Exemplo de retorno (Imagem 1).png](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/scaled-1680-/api-aprovacao-e-rejeicao-de-regras-exemplo-de-retorno-imagem-1.png)](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/api-aprovacao-e-rejeicao-de-regras-exemplo-de-retorno-imagem-1.png)