API:

API Parametrização Fiscal Bearer Token – Como utilizar os parâmetros referente ao consumo das regras

Escrito por: Rafael Sena

O endpoint de consumo de regras entrega as regras tributárias de acordo com os dados das operações e produtos informados pelo cliente, a Systax tem o compromisso de manter as regras atualizadas conforme as alterações das legislações. Para este tópico, mostraremos abaixo as etapas, o uso do ponteiro e como os parâmetros devem ser enviados no dia seguinte (pressupondo que esse processo ocorrerá uma vez por dia).

Obs.: As explicações sobre o conceito do ponteiro de atualização e sobre a paginação também se aplicam para as demais APIs de consumo de regras, ou seja, se aplicam para Ws via SOAP por exemplo.

Existem 2 tipos de carga:

1. Carga inicial: onde o ponteiro informado na chamada será “0” e serão entregues todas as regras disponíveis para o cliente;
2. Carga de atualização: onde deverá ser informado o ponteiro recebido na primeira chamada da carga anterior e serão entregues somente as regras geradas após o registro desse ponteiro (regras novas ou atualizações das regras já entregues).

Como realizar o consumo?

1. Utilize o método Get informe o endpoint http://app.systax.com.br/auth/access-token/ para obter o Token.

2. Utilizando o método POST, informe o endpoint https://api-gateway.systax.com.br/cockpit/v2/api/regras e faça a primeira chamada do dia, utilizando os parâmetros conforme o print abaixo e armazene o ponteiro de atualização entregue no final do retorno desta chamada para utilizar no dia seguinte (lembrando que estamos pressupondo que esse processo ocorrerá uma vez por dia).

3. Para o dia seguinte, no Body da chamada informar no campo “ponteiro_atualizacao”, o ponteiro armazenado do dia anterior (tópico 2).

4. Sempre que retornar a mesma quantidade de regras informada no campo paginação da chamada (ex.: se informado “100” na chamada e retornadas 100 regras), é necessário fazer novas chamadas até que o número de regras retornado seja menor que o número informado no campo paginação da chamada.
5. Ocorrendo isso, a partir da segunda chamada do dia, deverão ser informados os últimos id_cenario, codigo_produto e origem_produto retornados na página/chamada anterior e manter o mesmo ponteiro de atualização para todas as chamadas do mesmo dia

Voltar