Páginas filhas
  • ER_PCREQ-4846_Monitor_de_Pendências_Consulta_TSA

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

(Obrigatório)

Informações Gerais

 

Especificação

Produto

TOTVS 12

Módulo

Folha de Pagamento

Segmento Executor

Manufatura

Projeto1

D_MAN_TSA001

IRM1

PCREQ-363

Requisito1

PCREQ-4846

Subtarefa1

PDRMAN-4281

Chamado2

 

País

(X) Brasil  ( ) Argentina  ( ) Mexico  ( ) Chile  ( ) Paraguai  ( ) Equador

( ) USA  ( ) Colombia   ( ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Obrigatório)

Objetivo

  • Permitir a realização da carga de informações somente do que não existe no TSA ainda.
  • Possibilitar que o usuário realize integração de uma seleção de determinada informação sem a necessidade de acessar o cadastro.
  • Integrar a informações somente quando alterar um campo que impacta no TSA (informações de cadastro).

(Obrigatório)

Definição da Regra de Negócio


FP8875:

No programa de carga, abaixo do browse de destino da informação incluir um novo browse que irá conter a lista de chaves da informação as colunas início e fim da informação que virão com “” e “zzz...” e “0” “999...” como default para as informações, conforme demonstrado na tela abaixo. Quando o usuário selecionando o registro no browse de destino, o browse do filtro deverá ser atualizado com as chaves da informação. Ao voltar a informação para o browse de origem limpa a informação do filtro. Quando a informação for do tipo inteiro somente permitir incluir números. 

 

No botão “Filtro” incluir:

  • O campo “Realiza Consutla ” para permitir que o usuário marque caso deseje realizar uma consulta no TSA da informação que está sendo integrada para verificar se a mesma já existe no TSA. Como Default o campo vem marcado.     
  • O campo “Gera XML Consulta” para possibilitar gerar os arquivos XML de envio e retorno para o TSA. Este campo somente será habilitado caso o campo Consulta TSA for marcado.
  • O Campo "Considera Somente Funcionário Desligado" para possibilitar gerar a integração de funcionários demitidos. Este campo vem desmarcado como Default. 

 


FP8875rp (Emissão do Relatório):

  • Quando o campo "Realiza Consulta" (botão Filtro) estiver marcado, a cada lista de informação gerada para a carga o sistema deverá realizar chamar o Webservice de consulta da informação no TSA. 
  • Criar uma include fp8875rp.i que conterá o código que irá realizar a consulta, e irá retornar uma temp-table com os erros que ocorreram, os xml de envio e de retorno e uma temp-table com as chaves tsa que já encontra-se no TSA, sendo que estas chaves precisam ser eliminadas da temp-table de carga assim como precisam ser diminuídas do contador de informações.
  • Caso a temp-table de erro tenha conteúdo  deverá ser demonstrado na colune Status Consulta, conforme demonstrado abaixo. Caso não tenha ocorrido erro o status deverá ser demonstrado como Realizada com sucesso. Ajustar a data e a hora do relatório para que a coluna possa ser demonstrada. retirar a coluna chave tsa.

FPAPI538:

pi-consulta-tsa:

  • Contruir nova procedure interna (pi-consulta-tsa) que irá conter os comandos para montagem do xml e a chamada para a procedure interna da integração da consulta. Esta procedure receberá como parâmetro a temp-table consulta que conterá a tabela do tipo de informação que está sendo feita a consulta e como retorno deverá receber o xml que foi gerado, o xml de retorno e uma temp-table de erro (tt-erro-tsa).
  • Necessário criar um de-para entre informação do HCM com a tabela do TSA (varinc/var10507.i).
  • Exemplo do XML:

         <externalKeysInserted>

               <table>USER</table> 

              <externalKey>1;1;1</externalKey>

             <externalKey>1;1;2</externalKey>

             <externalKey>1;1;3</externalKey>

         </externalKeysInserted>

 

pi-integr-consulta:

  • Construir uma procedure interna (pi-integr-consulta) que irá executar a operação de envio do XML de consulta para o TSA estrutura do XML. Deverá receber como parâmetros o tipo de informação, o xml gerado, o nome da operação que será executada para integração. Deverá retornar  o xml de retorno do TSA e a temp-table de erro (tt-erro-tsa).
  • Chamar a procedure interna (pi-conecta-webservice) para Verificar se a conexão com o TSA está ok, caso não esteja deverá atualizar a temp-table de erro. Nome do serviço é synchronization.
  • Deverá executar a operação no serviço enviando o xml gerado e recebendo um xml de retorno. Nome da operação é externalKeysInserted
  • Deverá executar uma procedure interna que será responsável pelo processamento do xml de retorno (pi-retorno-consulta).

pi-retorno-consulta:

  • Construir uma procedure interna (pi-retorno-consulta)  que irá processar o xml de retorno e irá retornar uma temp-table com os erros encontrados  e outra temp-table com as chaves que encontra-se no TSA.
  • Utilizar as procedures internas do programa xmlutp/ut-genxml.p para maninupar o xml.
  • Procurar pela tag statusCode, poderão retornar quatro códigos:
    • 01401 - indica que existem pelo menos uma chave tsa que existe no TSA Caso ocorra esse retorno deverão ser lidas todas as tags <externalKey> e gravadas na temp-table de retorno para eliminar as informações da carga.
    • 01402 - a tabela informada não existe no TSA. Caso ocorre esse retorno deverá ser atualizada a tabela de erro com o statuscode, buscar a tag <statusDescription> e atualizar no campo mensagem da temp-table de erro.
    • 01403 - nenhuma chave foi encontrada no TSA. Neste caso não deverá atualizar a temp-table de erro. Somente indica que todos os registros deverão ser enviados para o TSA. Então deverá aparecer que a consulta foi realizada com sucesso.
    • 00101 - algum erro técnico ocorrido. Caso ocorre esse retorno deverá ser atualizada a tabela de erro com o statuscode, buscar a tag <statusDescription> e atualizar no campo mensagem da temp-table de erro.

Incluir na Include FP8875.i

Caso o campo "Gera XML Consulta" esteja marcado então gerará no diretório temporário definido para o usuário, um arquivo xml para cada consulta realizada no TSA com a seguinte nomenclatura: a letra “C” de consulta mais “-“ mais o número de sequência do movimento, se tiver (caso não tenha deve ser 00000000000000). Mais “–“, mais o tipo de informação, mais “-“, mais uma sequência numérica consulta. Exemplo de nome: “C-12345678901234-Funcionario-1.xml”. Também gerará um arquivo com o retorno do TSA com a seguinte nomenclatura: a letra “R” de retorno mais “-“ mais o número de sequência do movimento, se tiver (caso não tenha deve ser 00000000000000). Mais “–“, mais o tipo de informação, mais “-“, mais uma sequência numérica consulta. Exemplo de nome: “R-12345678901234-Funcionario-1.xml”.


Gatilhos das informações de cadastro:

Alterar o gatilho do cadastro para enviar somente quando ocorrer alteração nos campos que impactam no TSA conforme quadro abaixo:

Programa

Colunas que impactam no TSA

FP0560

Inclusão de Registro, Alteração da Pessoa Jurídica

FP0660

Inclusão de Registro, Alteração do campo Descrição

FP0720

Inclusão do Registro, Alteração da Descrição

FP1420

Inclusão do Registro, Alteração de CNPJ, CEI, Nome, País, UF, Cidade, Bairro, Endereço, Número, CEP, Fone Contato

FP1440

Inclusão do Registro, Alteração de Nome, Endereço, Número, cidade, e-mail, CPF, RG, Data Emissão RG, Orgão RG, UF RG, Bairro, Telefone, Telefone Contato, UF, Cep

FP0840

Pessoa Física, Tipo De Prestador, Data de Validade, PIS

FP0060

Inclusão do Registro, Alteração da Descrição e do Tipo da Situação

FP1930

Inclusão do Registro, Descrição Localidade

FP1930B

Inclusão do Registro, Descrição Feriado e Repica Feriado

FP1200C

Inclusão do Feriado, Alteração Descrição do Feriado

Funcionário: Quando for alteração do cadastro de funcionário não enviar as informações de histórico.

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

[FP8870 – Monitor TSA]

[Alteração]

[Tarefas]

-

[FP8875 – Carga TSA]

[Alteração]

[Tarefas]

-

[FP8876 - Integrador TSA]

[Alteração]

[Tarefas]

-

[FP8878 - Eliminação Movimentos TSA][Alteração]

[Tarefas]

-

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.