Histórico da Página

Informações Gerais

Objetivo

Permitir que o módulo SigaMNT do Protheus recupere a situação atual dos funcionários no módulo TOTVS Folha de Pagamento da linha RM.

Definição da Regra de Negócio

Será realizada evolução da integração TOTVS Manutenção de Ativos x BackOffice RM, onde será adicionado um mapeamento de uma mensagem de requisição, para que o Protheus solicite a situação dos funcionários e o RM retorne. O funcionamento da requisição será realizado através da arquitetura de mensageria única condizendo com a própria integração.

Para que o sincronismo dessa mensagem funcione corretamente, é necessário que os seguintes pré-requisitos sejam atendidos:

• WebService RM configurado no Protheus.

 • Cadastro do de-para da empresa/filial realizado.

 • Integração de funcionários realizada.

Para atender a arquitetura proposta, deverá ser utilizado/implementado os seguintes itens:

• Mensagem única: Será utilizada a mensagem de requisição GetEmployeeSituations_1_000, que atende a demanda desse requisito. Segue a estrutura da mensagem:

Mensagem Padrão

Descrição

RM

PROTHEUS

Obrigatório

Tabela

Campo

Obrigatório

Tabela

Campo

Return < ListOfEmployeeSituations> - > RM retorna para o Protheus

Employee

CompanyId

Código da empresa do funcionário

Sim

PFUNC

CODCOLIGADA

Sim

SM0

M0_CODIGO

BranchId

Código da filial do funcionário

Sim

PFUNC

CODFILIAL

Sim

SRA

RA_FILIAL

InternalId

InternalId das informações do Funcionário

Sim

PFUNC

CODCOLIGADA | CHAPA

Sim

SRA

M0_CODIGO|RA_FILIAL|RA_MAT

EmployeeCode

Matrícula do Funcionário

Sim

PFUNC

CHAPA

Sim

SRA

RA_MAT

WorkCenterCode

Centro de custo

Sim

PSECAO

NROCENCUSTOCONT

Sim

SRA

RA_CC

SiteCode

Código do Estabelecimento do Funcionário

Não

x

x

Não

x

x

<ListOfSituations>

Lista de situações

Sim

Sim

< ListOfSituations>

Situation

CommencementDate

Data início da situação

Sim

PFHSTSIT/PFHSTAFT/PFUFERIASPER

CALCULADO

Sim

SR8

R8_DATAINI

SituationLastDay

Data do último dia da situação

Sim

PFHSTSIT/PFHSTAFT/PFUFERIASPER

CALCULADO

Sim

SR8

R8_DATAFIM

INSSPaymentCommencement

Data início pagamento pelo INSS

Não

x

x

Não

x

x

OriginSituation

Origem da situação (Informada/Cálculo/Ponto/Divergência/Agrícola)

Não

x

x

Não

x

x

SituationDay

Número de dias em que o funcionário se encontra na situação

Sim

PFHSTSIT/PFHSTAFT/PFUFERIASPER

CALCULADO

Sim

SR8

R8_DURACAO

SituationTime

Quantidade de horas na situação

Não

x

x

Não

x

x

SituationScheduleEnd

Número horário término situação afastamento

Não

x

x

Não

x

x

CIDCode

Código do acidente ou doença para as situações de afastamento por doença

Não

x

x

Não

x

x

CommencementSchedule

Número Horário início situação afastamento

Não

x

x

Não

x

x

<SituationInformation>

Informações gerais da situação

Sim

Sim

<SituationInformation>

SituationCode

Código da situação

Não

x

x

Não

x

x

SituationMeaning

Significado da situação:

1 - Trabalhando

2 - Afastado

3 - Entrada Transferência

4 - Saída Transferência

5 - Férias

6 - Rescisão Contrato

7 - Falta Injustificada

8 - Jornada Incompleta

9 - Ausência Justificada

10 - Contrato Desativado

Sim

PCODSITUACAO

CODINTERNO

1 – A/V/X/Z

2 - U/P/T/E/M/R/W

3 - -

4 - -

5 – F/G

6 - D

7 - -

8 - -

9 - -

10 - C

Sim

R8

1 - em branco

2 - A

3 - 5

4 - 5

5 - F

6 - 2/4/H/I/K

7 - -

8 - -

9 - -

10 - 3/L

AbsenteeismType

Tipo do Afastamento:

1 - Ausência

2 - Doença

3 - Acidente

4 - Maternidade

5 - Paternidade

6 - Serviço Militar

7 - Licença Remunerada

8 - Licença não Remunerada

Não

PCODSITUACAO

CODINTERNO

1 - U

2 – P/I/O

3 - T

4 – E/W

5 - -

6 - M

7 – R/S

8 - L

Não

R8

R8_AFARAIS

1 - -

2 - 30/40

3 - 10/20

4 - 50

5 - -

6 - 60

7 - -

8 - 70

• Transformação: Será criado um cadastro de transformação para realizar a montagem da mensagem acima no RM. O cadastro será realizado através do configurador de integrações e terá as seguintes informações:

Image Added

Image AddedImage AddedImage Added

• XsltRetorno: Transformação do retorno RM para a mensagem única.

Regras de Integridade

Parâmetros necessários:

Para o correto funcionamento da integração, o Protheus deverá enviar as informações obrigatórias para o RM:

• CompanyId: Código da empresa do funcionário
• StartDate: Data início da situação
• FinishDate: Data fim da situação
• StartEmployeeCode: InternalId do funcionário

No caso de ser apenas um dia, o FinishDate deverá ter o mesmo calor que o StartDate. 

Matrícula do funcionário:

Como a chapa pode ser valor alfanumérico, não será utilizado a faixa de matrículas. Nesse caso será utilizado somente a tag StartEmployeeCode, enquanto a tag FinishEmployeeCode ficará obsoleta.

Mapeamento das situações no RM

O mapeamento das situações no RM será realizado da seguinte maneira:

1) Segue o de-para das situações da mensagem única com as situações do RM:

 Significado da situação:

Tipo do afastamento:

1) Será verificado se a data informada é anterior a data de admissão do funcionário. Caso positivo será enviado um retorno informando que o funcionário não estava admitido.

2) Se a data informada for igual ou posterior a data de admissão:

   2.1) Será verificado se existe data de desligamento e a data informada é maior ou igual a data desligamento. Caso positivo a situação mapeada será “D”. (Demitido).

   2.2) Caso negativo, será verificado se existe data de desligamento e a data informada é menor que a data desligamento, ou se não existe a data de desligamento. Caso positivo:
        2.2.1) O sistema irá verificar no histórico de férias se possui período de gozo na data informada. Caso positivo a situação mapeada será “F”. (Férias).
        2.2.2) Caso negativo, o sistema irá verificar no histórico de afastamento se o funcionário esteve afastado na data informada. Caso positivo a situação mapeada será o tipo do afastamento encontrado.
        2.2.3) Caso negativo, o sistema irá verificar no histórico de situação se o funcionário possui histórico para a data informada. Caso positivo a situação mapeada será a situação encontrada no histórico.
        2.2.4) Caso negativo, a situação mapeada será “A”. (Ativo)

3) A data início e fim da situação será conforme o histórico. Caso a situação seja a situação atual, a data fim enviada será a data atual.

Exemplos:  

Situação 1 : 

Funcionário demitido em 15/03/2015 

Hoje é 15/03/2015 e foi pedido a situação do funcionário em 16/03/2015.
Deverá retornar a situação ‘D’ (15/03/2015 a data atual)

Hoje é 15/03/2015 e foi pedido a situação do funcionário em 14/03/2015.
Deverá verificar se o funcionário está de férias ou afastado, caso não esteja em nenhumas destas situações deverá verificar se a data está dentro de algum dos períodos do histórico de situação e retornar a situação equivalente. Caso não seja encontrado em nenhuma dessas alternativas, deverá ser retornado ‘A’ (Ativo) como padrão (Data admissão a data atual).

Situação 2 :

Funcionário Ativo em 15/03/2015
Férias em 01/04/2015 a 20/04/2015
Afastado por Acidente do Trabalho em 01/02/2015 a 28/02/2015

Hoje é 15/03/2015 e foi pedido a situação do funcionário em 16/03/2015, deverá retornar ‘A’ (Ativo) (15/03/2015 a 31/03/2015)
Hoje é 15/03/2015 e foi pedido a situação do funcionário em 01/04/2015, deverá retornar ‘F’ (Férias) (01/04/2015 a 20/04/2015)
Hoje é 15/03/2015 e foi pedido a situação do funcionário em 10/02/2015, deverá retornar ‘T’ (Afastado por acidente de trabalho)
(01/02/2015 a 28/02/2015)

Release Notes

Fluxo do Processo

Casos de Testes

Um caso de teste contém informações gerais que determinam como testes anteriormente especificado pelo Plano de Testes devem ser conduzidos. Geralmente, eles são agrupados por requisito. Entretanto, é possível agrupar casos de teste por conjunto de requisitos, caso os testes estejam verificando integradamente os requisitos que pertencem a esse conjunto.

Os casos de testes mencionados abaixo devem ser executados para garantir a qualidade do produto, atendendo a finalidade do projeto e os resultados esperados.