A integração de situação do funcionário consiste na movimentação de informações referentes a férias, afastamentos e demissões no sentido ERP para PIMS Multicultivos, ou seja, será realizada no ERP e enviada para o PIMS Multicultivos através do PIMSConnector.
- Identificador da Mensagem: EmployeeSituations
- Versão: 1.000
- Módulo PIMS Multicultivos: Tabelas > Administrativo> Funcionário
- Tipo de Envio: Assíncrona / Síncrona
- Tipo de Evento: Upsert / Delete
Campos Obrigatórios
- Empresa;
- Filial;
- Código do funcionário;
- Data inicial da situação;
- Quantidade de dias na situação;
- Tipo de situação.
Exemplos de Mensagens
Mensagem XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
<MessageInformation version="1.000">
<BranchId>D MG 01</BranchId>
<CompanyId>T1</CompanyId>
<DeliveryType>Sync</DeliveryType>
<GeneratedOn>2018-05-21T18:11:37</GeneratedOn>
<Product name="ERP" version="11"/>
<SourceApplication>P118_PRD</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>EMPLOYEESITUATIONS</Transaction>
<Type>BusinessMessage</Type>
<UUID>pg24pilh-sypf-ggh8-shgp-h7bglwpln518</UUID>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>EmployeeSituations</Entity>
<Event>upsert</Event>
<Identification>
<key name="InternalID"/>
</Identification>
</BusinessEvent>
<BusinessContent>
<Situation>
<ListOfEmployee>
<Employee>
<CompanyId>T1</CompanyId>
<BranchId>D MG 01</BranchId>
<CompanyInternalId>01|0101</CompanyInternalId>
<InternalId>01|0101|00010 |2|02032015|001</InternalId>
<EmployeeCode>1420</EmployeeCode>
<WorkCenterCode/>
<SiteCode/>
<ListOfSituation>
<Situation>
<CommencementDate>2018-07-10</CommencementDate>
<SituationLastDay>2018-10-20</SituationLastDay>
<INSSPaymentCommencement/>
<OriginSituation>20</OriginSituation>
<SituationDay>30</SituationDay>
<SituationTime/>
<SituationScheduleEnd/>
<CIDCode/>
<CommencementSchedule/>
<SituationInformation>
<SituationCode/>
<SituationMeaning>6</SituationMeaning>
<AbsenteeismType/>
</SituationInformation>
</Situation>
</ListOfSituation>
</Employee>
</ListOfEmployee>
</Situation>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
<MessageInformation version="1.000">
<BranchId>D MG 01</BranchId>
<CompanyId>T1</CompanyId>
<DeliveryType>Sync</DeliveryType>
<GeneratedOn>2018-05-24T15:04:45</GeneratedOn>
<Product name="PIMS" version="12.1.20"/>
<SourceApplication>PIMSCONNECTOR</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>EMPLOYEESITUATIONS</Transaction>
<Type>Response</Type>
<UUID>905b3e9d-c546-4317-8915-d27db0c885e8</UUID>
</MessageInformation>
<ResponseMessage>
<ProcessingInformation>
<ProcessedOn>2018-05-24T15:04:45</ProcessedOn>
<Status>OK</Status>
</ProcessingInformation>
<ReceivedMessage>
<MessageContent/>
<SentBy>ERP</SentBy>
<UUID>pg24pilh-sypf-ggh8-shgp-h7bglwpln518</UUID>
</ReceivedMessage>
<ReturnContent>
<ListOfInternalId>
<InternalId>
<Destination>T1|D MG 01|5121091917675948691</Destination>
<Name>EMPLOYEESITUATIONS</Name>
<Origin>01|0101|00010 |2|02032015|001</Origin>
</InternalId>
</ListOfInternalId>
</ReturnContent>
</ResponseMessage>
</TOTVSMessage>
Mensagem JSON
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "1.000",
"BranchId" : "D MG 01",
"CompanyId" : "T1",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-05-21T18:11:37",
"Product" : {
"@name" : "ERP",
"@version" : "11"
},
"SourceApplication" : "P118_PRD",
"StandardVersion" : "1.000",
"Transaction" : "EMPLOYEESITUATIONS",
"Type" : "BusinessMessage",
"UUID" : "pg24pilh-sypf-ggh8-shgp-h7bglwpln518"
},
"BusinessMessage" : {
"BusinessEvent" : {
"Entity" : "EmployeeSituations",
"Event" : "upsert",
"Identification" : {
"key" : {
"@name" : "InternalID"
}
}
},
"BusinessContent" : {
"Situation" : {
"ListOfEmployee" : {
"Employee" : {
"CompanyId" : "T1",
"BranchId" : "D MG 01",
"CompanyInternalId" : "01|0101",
"InternalId" : "01|0101|00010 |2|02032015|001",
"EmployeeCode" : "1420",
"WorkCenterCode" : null,
"SiteCode" : null,
"ListOfSituation" : {
"Situation" : {
"CommencementDate" : "2018-07-10",
"SituationLastDay" : "2018-10-20",
"INSSPaymentCommencement" : null,
"OriginSituation" : "20",
"SituationDay" : "30",
"SituationTime" : null,
"SituationScheduleEnd" : null,
"CIDCode" : null,
"CommencementSchedule" : null,
"SituationInformation" : {
"SituationCode" : null,
"SituationMeaning" : "6",
"AbsenteeismType" : null
}
}
}
}
}
}
}
}
}
}
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "1.000",
"BranchId" : "D MG 01",
"CompanyId" : "T1",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-05-24T15:04:45",
"Product" : {
"@name" : "PIMS",
"@version" : "12.1.20"
},
"SourceApplication" : "PIMSCONNECTOR",
"StandardVersion" : "1.000",
"Transaction" : "EMPLOYEESITUATIONS",
"Type" : "Response",
"UUID" : "905b3e9d-c546-4317-8915-d27db0c885e8"
},
"ResponseMessage" : {
"ProcessingInformation" : {
"ProcessedOn" : "2018-05-24T15:04:45",
"Status" : "OK"
},
"ReceivedMessage" : {
"MessageContent" : null,
"SentBy" : "ERP",
"UUID" : "pg24pilh-sypf-ggh8-shgp-h7bglwpln518"
},
"ReturnContent" : {
"ListOfInternalId" : {
"InternalId" : {
"Destination" : "T1|D MG 01|5121091917675948691",
"Name" : "EMPLOYEESITUATIONS",
"Origin" : "01|0101|00010 |2|02032015|001"
}
}
}
}
}
}
SEGMENTO | TAGS | TIPO | TAMANHO | DESCRITIVO DA TAG |
---|
BusinessEvent | Entity | String | 50 | Nome da entidade que gerou o evento |
Event | String | 10 | Qual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração ou delete – eliminação) |
Identification | String | - | Campos da chave primária da transação. Atributo "Name" define o nome do campo, enquanto que o conteúdo do elemento representa o valor do campo |
BusinessContent | CompanyId | String | 10 | Código da empresa |
BranchId | String | 20 | Código da filial |
EmployeeCode | Number | 38 | Código do funcionário |
WorkCenterCode | String | 15 | Representa a unidade administrativa no PIMSMC |
SiteCode | Number | 3 | Código do estabelecimento do funcionário |
CommencementDate | Date | - | Data de início da situação |
SituationLastDay | Date | - | Data do último dia da situação |
INSSPaymentCommencement | Date | - | Data de início do pagamento do INSS |
OriginSituation |
Number |
1 | Origem da situação: - 1 - Informada
- 2 - Cálculo
- 3 - Ponto
- 4 - Divergência
- 5 - Agrícola
|
SituationDay | Number | 4 | Número de dias em que o funcionário se encontra nesta situação |
SituationTime | Decimal | 8,5 | Quantidade de horas na situação |
SituationScheduleEnd | Number | 6 | Número horário de término da situação do afastamento |
CIDCode | String | 6 | Código do acidente ou doença para as situações de afastamento por doença |
CommencementSchedule | String | 6 | Número horário de início da situação do afastamento |
SituationCode | Number | 2 | Código da situação |
SituationMeaning |
Number |
1 | Significado da situação: - 1 - Trabalhando
- 2 - Afastado
- 3 - Entrada transferência
- 4 - Saída transferência
- 5 - Férias
- 6 - Rescisão de contrato
- 7 - Falta injustificada
- 8 - Jornada incompleta
- 9 - Ausência justificada
- 10 - Contrato desativado
|
AbsenteeismType |
Number |
1 | Tipo de 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
|
Limitações e Restrições
- Esta integração está disponível a partir da versão 12.1.4 do PIMS Multicultivos e PIMSConnector;
- Caso a integração não seja realizada através do seu fluxo normal, as informações de DE/PARA não serão preenchidas, necessitando assim, que sejam geradas manualmente no cadastro de DE/PARA do ERP;
- A integração de disponibilidade do Funcionários para o PIMS Multicultivos é realizada em modo exclusivo entre as unidades administrativas;
- Não é permitido intercalar datas de afastamentos e/ou férias;
- Não é permitido excluir uma situação de demissão;
- Não é permitido intercalar períodos de afastamento ou férias;
- Não é permitido demitir o funcionário dentro de um período de afastamento ou férias;
- Não é permitido gerar afastamento ou férias com data menor que a data de admissão do funcionário;
- Não é permitido gerar afastamento, férias e demissão para um funcionário que está demitido;
- Não é permitido demitir o funcionário em uma data menor que a data da disponibilidade mais recente;
- Não é permitido demitir o funcionário em uma data menor que a data de início da equipe, classe de pagamento, histórico de salário, histórico de horário ou da escala de folga;
- O Centro de Custo "Padrão" e Cargo "A DEFINIR" são utilizados quando não existe disponibilidade anterior lançada para o funcionário. Quando existe disponibilidade anterior são recuperados o centro de custo e o cargo para geração de novas disponibilidades. Estas informações do centro de custo e do cargo devem ser informadas previamente para evitar erros na rotina de integração.