Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleConfiguração necessária para envio de e-mail

MV_RELACNT - Conta utilizada para envio do e-mail
MV_RELSERV - Endereço do servidor de e-mail
MV_RELPSW - Senha da conta utilizada para envio do e-mail
MV_RELAUSR - Usuário de autenticação de e-mail
MV_RELAPSW - Senha do usuário de autenticação de e-mail
MV_RELFROM - Endereço de e-mail que ira disparar o e-mail
MV_RELAUTH - Faz autenticação no servidor de e-mail

Informações
title Log XML - MV_TSATLOG = 5MV_TSATLOG
  1. Quando o parâmetro estiver com a opção 1, só será enviado o e-mail com o log se houver erros de integração.
  2. Quando o parâmetro estiver com a opção 2, só será gerado o log (arquivo txt) no diretório definido no parâmetro MV_TSADARQ se houver erros de integração.
  3. Quando o parâmetro estiver com a opção 3, só será enviado o e-mail e gerado o log (arquivo txt) se houver erros de integração.
  4. Quando o parâmetro estiver com a opção 5 o sistema irá gerar
A opção 5 gera
  1. o xml de envio e retorno na pasta system, essa opção é útil para analisar erros, porém consome muito espaço em disco, por isso é importante ativá-lo para realizar o teste necessário e logo depois desativá-lo. Quando ativo o sistema sempre irá gerar o XML na pasta system, independentemente se houve erro ou não na integração. Além disso, se houver erros na integração será gerado o arquivo de log de erro (arquivo txt) no diretório definido no parâmetro MV_TSADARQ e será enviado o e-mail com o log.
    Nome dos arquivos XMLs gerados:
    "Numero Sequencial"_SND.
XML →
  1. XML → XML enviado ao Suricato
    "Numero Sequencial"_RCV.
XML →
  1. XML → XML recebido do suricato como retorno do XML SND

03. PORTARIA 671

Com a portaria 671/2021 surgiu a necessidade de realizar 2 alterações no Protheus, para que o sistema consiga realizar corretamente a integração de marcações vindas do Suricato.

...

Totvs custom tabs box
tabsSRA
idssra
Totvs custom tabs box items
defaultyes
referenciasra

Campos utilizados na integração do funcionário, ao incluir ou alterar qualquer um dos dados utilizados para a montagem do XML será realizada uma nova integração.

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)
                <image>BitMap da imagem do funcionário</image> Foto do Funcionário (RA_BITMAP)
                <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>

...

Totvs custom tabs box
tabsFontes,Web Services
idsfontes,webservices
Totvs custom tabs box items
defaultyes
referenciafontes
Totvs custom tabs box
tabsCarga Incial,PTSREPOBJ
idscargainicial,ptsrepobj
Totvs custom tabs box items
defaultyes
referenciacargainicial

Carga Incial - PONM430

Para a primeira integração com o Suricato, será necessário realizar a carga inicial. A rotina de Carga Inicial (POMM430 - Miscelânea → S.r.e.p. → Integração Tsa), será responsável por enviar todas as informações necessárias para a utilização do Suricato. Nela é possível selecionar quais informações serão enviadas inicialmente, que vão desde o cadastro da empresa até Férias/Afastamentos dos funcionários, porém a rotina possui uma ordem de execução que NÃO deve ser alterada, mas não há obrigatoriedade de enviar todos os cadastros de uma vez. É recomendado enviar primeiramente os cadastrados da Empresa, Unidade e Lotação.

Informações
titleObservação

A partir do pacote de Expedição Contínua do RH libera no dia 11/03/2024 é possível realizar o reenvio de um XML utilizando a rotina de Carga Inicial. Na pergunta da rotina existirá uma nova opção que é a "Reenviar XML ?", caso ela esteja com sim, o Protheus irá ignorar se a informação foi enviado ou não para o Suricato e irá gerar o XML de integração. Para mais informações do funcionamento do reenvio do XML acesse o link abaixo:

Reenvio de XML - Integração Suricato

Totvs custom tabs box items
defaultno
referenciaptsrepobj

PTSREPOBJ

Este fonte possui todos os métodos que irá fazer a chamada de um Web Service para realizar a integração com o Suricato. Como por exemplo o método WSNatural, este método irá realizar a inclusão/alteração de um funcionário no Suricato. O método irá receber as informações da tabela envolvida e enviará elas para o Web Service NaturalPerson, que irá enviar para o Suricato.

Totvs custom tabs box items
defaultno
referenciawebservices
Totvs custom tabs box
tabsAbsenceReason,AllocationUnit,CostCenter,DayNotWorked,Exception,LegalPerson,LocationIntegration,NaturalPerson,PositionLevel,ScaleIntegration,ShiftWork,Unit,UserIntegration
idsabsencereason,allocationunit,costcenter,daynotworked,exception,legalperson,locationintegration,naturalperson,positionlevel,scaleintegration,shiftwork,unit,userintegration
Totvs custom tabs box items
defaultyes
referenciaabsencereason

WSClient_WSRHTSAAbsenceReason

O AbsenceReason é o Web Service responsável por enviar as informações referentes as ausências. O método que faz a chamada desse Web Service é o WSAbsenceReason, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações da tabela tipo de ausências (RCM), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciaallocationunit

WSClient_WSRHTSAAllocationUnit

O AllocationUnit é o Web Service responsável por enviar as informações referentes as Unidades de Lotações. O método que faz a chamada desse Web Service é o WSAllocation, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações do cadastro de Unidade de Lotação, manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciacostcenter

WSClient_WSRHTSACostCenter

O CostCenter é o Web Service responsável por enviar as informações referentes aos Centros de Custos. O método que faz a chamada desse Web Service é o WSCostCenter, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações da tabela dos Centros de Custos (CTT), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciadaynotworked

WSClient_WSRHTSADayNotWorked

O DayNotWorked é o Web Service responsável por enviar as informações referentes aos Feriados. O método que faz a chamada desse Web Service é o WSDayNotWorked, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações dos Feriados cadastrados (SP3), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciaexception

WSClient_WSRHTSAException

O Exception é o Web Service responsável por enviar as informações referentes as Exceções. O método que faz a chamada desse Web Service é o WSException, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações das Exceções cadastradas (SP2), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referencialegalperson

WSClient_WSRHTSALegalPerson

O LegalPerson é o Web Service responsável por enviar as informações referentes as Empresas. O método que faz a chamada desse Web Service é o WSLegal, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações das Empresas cadastradas, manipulará os dados e enviará para o Suricato.

Observação: O Web Service LegalPerson também é responsável por enviar os Sindicatos cadastrados, através do método WSSindicatoLegal.

Totvs custom tabs box items
defaultno
referencialocationintegration

WSClient_WSRHTSALocationIntegration

O LocationIntegration é o Web Service responsável por enviar as informações referentes as Localizações (Cidades). O método que faz a chamada desse Web Service é o WSLocation, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações das Localizações cadastradas, manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referencianaturalperson

WSClient_WSRHTSANaturalPerson

O NaturalPerson é o Web Service responsável por enviar as informações referentes aos Funcionário. O método que faz a chamada desse Web Service é o WSNatural, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações dos Funcionário cadastrados (SRA), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciapositionlevel

WSClient_WSRHTSAPositionLevel

O PositionLevel é o Web Service responsável por enviar as informações referentes as Funções do funcionário. O método que faz a chamada desse Web Service é o WSPositionLevel, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações das Funções cadastradas (SRJ), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciascaleintegration

WSClient_WSRHTSAScaleIntegration

O ScaleIntegration é o Web Service responsável por enviar as informações referentes a Tabela Horário Padrão. O método que faz a chamada desse Web Service é o WSSCale, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações da Tabela de Horário Padrão cadastradas (SPJ), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciashiftwork

WSClient_WSRHTSAShiftWork

O ShiftWork é o Web Service responsável por enviar as informações referentes ao Turnos. O método que faz a chamada desse Web Service é o WSShiftWork, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações da tabela de Turnos cadastrados (SR6), manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciaunit

WSClient_WSRHTSAUnit

O Unit é o Web Service responsável por enviar as informações referentes a Unidade. O método que faz a chamada desse Web Service é o WSUnit, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações da Unidade cadastrada, manipulará os dados e enviará para o Suricato.

Totvs custom tabs box items
defaultno
referenciauserintegration

WSClient_WSRHTSAUserIntegration

O UserIntegration é o Web Service responsável por enviar as informações referentes aos Usuários. O método que faz a chamada desse Web Service é o WSUser, localizado no fonte PTSREPOBJ. Neste método o sistema irá receber as informações dos Usuários, tais como Nome, Centro de Custo, Papéis (Permissões) e etc, manipulará os dados e enviará para o Suricato.

Observação: Este Web Service é diferente dos demais, pois ele possui vários métodos para inserir informações diferentes, como por exemplo Centro de Custo e Função, utilizando os métodos insertUserShiftWork e insertUserPositionLevel respectivamente, localizados no Web Service.

...