Páginas filhas
  • DI Situação do Funcionário - EmployeeSituations

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.

Informações da Mensagem

  • 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

EmployeeSituations_Envio
<?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>
EmployeeSituations_Retorno
<?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

EmployeeSituations_Envio
{
	"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
									}
								}
							}
						}
					}
				}
			}
		}
	}
}
EmployeeSituations_Retorno
{
	"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"
					}
				}
			}
		}
	}
}

Descrição Detalhada das Tags

SEGMENTOTAGSTIPOTAMANHODESCRITIVO DA TAG


BusinessEvent

EntityString50Nome da entidade que gerou o evento
EventString10Qual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração ou delete – eliminação)
IdentificationString-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

CompanyIdString10Código da empresa
BranchIdString20Código da filial
EmployeeCodeNumber38Código do funcionário
WorkCenterCodeString15Representa a unidade administrativa no PIMSMC
SiteCodeNumber3Código do estabelecimento do funcionário
CommencementDateDate-Data de início da situação
SituationLastDayDate-Data do último dia da situação
INSSPaymentCommencementDate-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
SituationDayNumber4Número de dias em que o funcionário se encontra nesta situação
SituationTimeDecimal8,5Quantidade de horas na situação
SituationScheduleEndNumber6Número horário de término da situação do afastamento
CIDCodeString6Código do acidente ou doença para as situações de afastamento por doença
CommencementScheduleString6Número horário de início da situação do afastamento
SituationCodeNumber2Có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.