RH - Linha Protheus - PON x Suricato - XML da Integração com o Suricato

Tempo aproximado para leitura: 00:05:00 min

Dúvida
Como funciona a montagem do arquivo XML para integração do Protheus com o Suricato?

Ambiente
TOTVS RH - TOTVS RH (Linha Protheus) - Gestão de Pessoal - Todas as versões 

Solução
Nesta documentação, iremos abordar sobre como é feita a montagem do conteúdo do XML, no qual será enviado para o Web Service. Lembrando que caso haja a necessidade de pegar o XML completo, com as informações do cabeçalho e etc, será necessário ativar o parâmetro MV_TSATLOG com o valor 5 e verificar o arquivo gerado na pasta System, conforme descrito anteriormente no tópico de Parâmetros. Neste exemplo, iremos realizar a integração da partir da rotina de Carga Inicial (Integração TSA - PONM430), integrando o Centro de Custo.
Ao acessar a rotina de A rotina de Carga Inicial (POMM430 - Miscelânea → S.r.e.p. → Integração Tsa), quando selecionamos apenas o Centro de Custo, podemos observar que o valor da opção é 06:


Sabendo disso, podemos localizar qual função irá realizar essa integração, no caso, é função ProcP08 no fonte da Carga Inicial (PONM430):


Verificando a função ProcP08, ela está chamando outra função, que neste caso é a WSRHCostCenter:


Procurando onde a função WSRHCostCenter está, descobrimos que ela está localizada no fonte PONXFUN1:


Aqui podemos verificar que ela faz a busca das informações dos Centro de Custos diretamente na tabela:


Após realizar a consulta na tabela CTT, o sistema irá enviar essas informações para o método WSCostCenter:


O método WSCostCenter, está localizado no fonte PTSREPOBJ:


Antes de enviar as informações para o Web Service, podemos verificar que o sistema está montando as informações do Centro de Custo, como a Descrição e a Chave Externa:

Observação: O método do Web Service chamado, foi o insertOrUpdate.

O método insertOrUpdate localizado no Web Service WebWSClient_WSRHTSACostCenter, está realizando a integração com o Suricato:


Antes de enviar as informações da integração, conseguiremos verificar o conteúdo do XML, no caso as informações do Centro de Custo, verificando o conteúdo do objeto oWSarg0:


Após todo esse processo, conseguimos verificar de fato quais informações estão sendo integradas com o Suricato. Este mesmo processo pode ser realizado com as demais integrações, como por exemplo as integrações de Funcionários, Funções, Turnos e etc. Para isso, só será necessário identificar qual é a opção selecionada e posteriormente a função desta opção. Em outros casos, como por exemplo, a integração de funcionário realizadas após a inclusão ou alteração do mesmo, precisaremos localizar no fonte de Cadastro de Funcionário, qual função ou método está sendo chamado para a integração. Por exemplo, no cadastro de funcionário, os métodos WSNatural e WSUser estão sendo chamados:


OCORRÊNCIAS NA INTEGRAÇÃO
Com a utilização do parâmetro MV_TSATLOG, na qual o parâmetro permite que todas as rotinas de integração gerem um log de retorno com as críticas realizadas pelas regras do aplicativo, é possível saber exatamente qual foi o erro gerado durante o processo de integração. No exemplo que iremos mostrar, utilizamos o parâmetro com o valor igual a 5, desta maneira iremos ter o XML enviado e o XML de retorno com o código do erro ou sucesso.


Após a inclusão do funcionário no Protheus, iremos visualizar o código de retorno informado no log gerado. Para isso, basta acessar a pasta System do Protheus e procurar pelo arquivo. O nome do arquivo é composto por um número sequencial, seguido de _RCV.xml para o XML de retorno e _SND.xml para o XML enviado. Em nosso exemplo, o nome do arquivo de retorno gerado é 55847972_rcv.xml. Ao abrir o arquivo de retorno devemos procurar pela Tag statusCode, ela que conterá o código do retorno, que poderá ser de sucesso ou erro na integração. No nosso teste, o código gerado foi o 00100, isso significa que a integração funcionou corretamente.


Cada Web Service possui códigos e descrições diferentes, por isso para facilitar no entendimento dos códigos de retorno, segue abaixo a tabela de códigos de cada Web Service:

Empresa
 

Unidade

Centro de Custo

Unidade de Lotação

Turno

Tabela de Horário Padrão

Funcionários

Localidade

Funções

Afastamento

Exceção

Feriados

Usuários

Marcações

CAMPOS DA TABELA UTILIZADA - SRA
Ao incluir ou alterar qualquer um dos dados utilizados para a montagem do XML de funcionários, será realizada uma nova integração, utilizando os campos/Web Services abaixo:

WSRHTSANaturalPerson
<?xml version="1.0" encoding="UTF-8"?>
-<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    -<soap:Body>
        -<insertOrUpdate xmlns="http://naturalperson.tsa.totvs.com/">
            -<arg0 xmlns="">
                <address>AV. BRAZ LEME </address> Endereço + Num.Endereço + Compl.Ender. (RA_ENDEREC + RA_NUMENDE + RA_COMPLEM)
                <city>SAO PAULO </city> Municipio (RA_MUNICIP)
                <country>BRASILEIRO</country> Nacionalid. (RA_NACIONA)
                <email>totvs@totvs.com.br</email> End. E-Mail (RA_EMAIL)
                <externalKey>T1D MG 01 00079820211011164347</externalKey> Código Unico RA_CODUNIC (Empresa + RA_FILIAL + RA_MAT + Data e hora da Integração)
                <federalId>03024407049</federalId> CPF (RA_CIC)
                <idCard>2020-01-01</idCard> R.G. (RA_RG)
                <idCardDate>1900-01-01</idCardDate> D t.Emis.RG (RA_DTRGEXP) Se não for preenchido será enviado 1900-01-01
                <idCardEmitter>SSP </idCardEmitter> Orgao expedR (RA_RGEXP)
                <idCardState>SP </idCardState> UF do RG (RA_RGUF)
                <name>Funcionário Totvs </name> Nome do Funcionário (RA_NOME)
                <neighborhood>CASA VERDE </neighborhood> Bairro (RA_BAIRRO)
                <phone1>11111111 </phone1> Telefone (RA_TELEFON)
                <phone2>911111111 </phone2> Num. Celular (RA_NUMCELU)
                <phoneCode1>11</phoneCode1> DDD Telefone (RA_DDDFONE)
                <phoneCode2>11</phoneCode2> DDD Celular (RA_DDDCELU)
                <state>SP</state> Estado (RA_ESTADO)
                <zipCode>02511000</zipCode> CEP (RA_CEP)
                <sex>M</sex> Sexo (RA_SEXO)
                <birthDate>1985-11-19</birthDate> Data Nasc. (RA_NASC)
           </arg0>
       </insertOrUpdate>
    </soap:Body>
</soap:Envelope>

WSRHTSAUserIntegration
<?xml version="1.0" encoding="UTF-8"?>
-<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    -<soap:Body>
        -<insertUserShiftWork xmlns="http://user.tsa.totvs.com/">
            -<arg0 xmlns="">
                <endDate>2049-12-31T00:00:00</endDate> Data Demissão (RA_DEMISSA se RA_DEMISSA estiver vazia será enviado 2049-12-31)
                <initialDate>2021-01-01T00:00:00</initialDate> Data Admissão (RA_ADMISSA)
                <shiftWorkExternalKey>T1D MG 00101</shiftWorkExternalKey> Chave de identificação do turno (Empresa + Turno + Sequencia (Empresa + PF_FILIAL + PF_TURNOPA + PF_SEQUEPA))
                <userExternalKey>T1D MG 01 000798</userExternalKey> Chave de identificação do funcionário (Empresa + RA_FILIAL + RA_MAT)
                <InitialScaleBaseDate>2020-12-28T00:00:00</InitialScaleBaseDate> Primeiro dia da sequência e turno informado. Por exemplo a data de admissão do funcionário foi no dia 01/01/2021, esse dia é uma sexta-feria e a sequência 01 começa na segunda, então será enviada o dia 28/12/2020.
            </arg0>
        </insertUserShiftWork>
    </soap:Body>
</soap:Envelope>

Saiba Mais:
Acesso e Segurança by Suricato
Integração Protheus x Suricato
Pacote de Expedição Contínua - Acumulado RH