Taas – Trace do TaaS
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
|
Chamada |
Resposta |
|
|
|
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.