Trace do TaaS

Por Fernanda Almeida

Para facilitar a análise das chamadas do TaaS e dar visibilidade à consulta de logs das chamadas realizadas pelos clientes que usam o TaaS, desenvolvemos a Trace.

Por definição, “trace” quer dizer percurso e é isso que essa ferramenta faz, ela faz o percurso de ida e volta desde a chamada do cliente até o retorno da chamada, passando pela determinação de perfil, tax engine e TaaS.

Ida:

Volta:

A trace pode ser consultada através do Insomnia ou do Postman.

As URLs gerais são:

Homologação - https://wscockpit.systax.com.br/TaaSHML/api/Trace/List

Produção - https://wscockpit.systax.com.br/TaaSPD/api/Trace/List

A consulta deverá ser feita por meio do login e senha do cliente. A mesma utilizada para fazer as chamadas no TaaS ou no tax engine.

>> Para configurar no insomnia:

Abrir um novo projeto no Insomnia e considerar o método: POST

- Inserir a URL desejada (homologação ou produção);

- Inserir o login e senha na aba “Basic” (a mesma para fazer as chamadas do TaaS)

- Chamada em formato Json

>> Inserção dos dados da chamada nessa estrutura:

{

  "sessionId": "",

  "year": 2024,

  "month": 1,

  "pageSize": 100,

  "page": 1,

  "ondemandFilter": 0,

  "profileFilter": 0,

  "CodProd": "",

  "OrigemProd":0,

  "Finalidade":"",

  "PerfilDest":"",

  "PerfilRem":"",

  "NatOp":"121", 

  "UFOrigem":"",

  "UFDestino":"",

  "Ondemand":0,

  "ProfileNotFound":"" 

}

A chamada poderá ser feita considerando os seguintes registros:

  "sessionId": consulta pelo ID da chamada no TaaS

  "year": informar sempre o ano da chamada

  "month": informar sempre o mês da chamada

  "pageSize": itens por página

  "page": número da página a ser consultada

  "ondemandFilter": informar 0 ou 1  (0 – sem ondemand // 1 – com ondemand)

  "profileFilter": informar o número do ID da planilha de determinação de perfil

  "CodProd": consulta pelo código de produto ou itemCode

  "OrigemProd": consulta pela origem do produto ou materialOrigin (por ex.: 0 – nacional, 1 – importado, etc)

  "Finalidade":  consulta pela finalidade da operação (por ex.: 569 – compra pra revenda, 202 – compra de insumo, etc)

  "PerfilDest":  consulta pelo perfil destino do cenário (por ex.: 138 – atacadista, 140 – varejista, etc)

  "PerfilRem":  consulta pelo perfil origem do cenário (por ex.: 1 – indústria, 2 – atacadista, etc)

  "NatOp":  consulta pela natureza de operação (por ex.: 108 – transferência de produto para comercialização, etc)   

  "UFOrigem":  consulta pela UF origem da operação (por ex.: SP, RJ, etc)

  "UFDestino":  consulta pela UF destino da operação (por ex.: RS, EX, ES, etc)

  "Ondemand": consulta se o resultado da chamada é on demand ou não

  "ProfileNotFound":  consulta se a chamada não tem perfil na tabela de determinação de perfil

Exemplo:

 - consulta por ID da chamada:

- consulta por código de produto:

O resultado será na seguinte estrutura:

• Chamada do TaaS
• Retorno do TaaS
• Determinação de perfil
• Chamada do Motor
• Retorno do Motor
• Filtros da Determinação de Perfil

Conclusão: A ferramenta trace facilita as equipes a analisarem as chamadas realizadas pelo TaaS, a chamada que foi requisitada no motor de cálculo e o resultado do cálculo. Também é possível diminuir a demanda do cliente, pois ao invés do envido do payload request, basta que o cliente informe o session ID para para possa ser feito todo o rastreamento da chamada, sem qualquer intervenção manual.

Voltar