Histórico da Página

A integração de Funcionário funcionário consiste na movimentação do cadastro no sentido ERP para PIMS Multicultivos, ou seja, será realizada no ERP e enviada para o PIMS Multicultivos através do PIMSConnector. Nesta integração é possível incluir, alterar e excluir o funcionário.

Informações da Mensagem

Identificador da Mensagem: Employee
Versão: 3.002
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 / Matrícula do funcionário;
Nome do funcionário;
Cargo do funcionário;
Centro de Custo custo do funcionário;
Sexo do funcionário;
Data de Admissão admissão do funcionário.

Exemplos de Mensagens

Mensagem XML

Bloco de código

language	xml
title	Employee_Envio
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="3.002">
		<BranchId>D MG 01</BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2015-04-17T14:40:18</GeneratedOn>
		<Product name="ERP" version="11"/>
		<SourceApplication>P118_PRD</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>EMPLOYEE</Transaction>
		<Type>BusinessMessage</Type>
		<UUID>pg24pilh-krjt-bg29-ypfn-w98j4p9ln535</UUID>
	</MessageInformation>
	<BusinessMessage>
		<BusinessEvent>
			<Entity>Employee</Entity>
			<Event>upsert</Event>
			<Identification>
				<key name="InternalID">01|0101|000194</key>
			</Identification>
		</BusinessEvent>
		<BusinessContent>
			<CompanyId>T1</CompanyId>
			<BranchId>D MG 01</BranchId>
			<CompanyInternalId>01|0101</CompanyInternalId>
			<Code>1420</Code>
			<InternalId>01|0101|000194</InternalId>
			<FullName/>
			<Name>João da Silva</Name>
			<ShortName/>
			<BadgeNumber>85494</BadgeNumber>
			<EmployeeType>1</EmployeeType>
			<EmployeeDocument>
				<WorkCardStateIssuing>SP</WorkCardStateIssuing>
				<WorkCardModel/>
				<WorkCardSerie>34</WorkCardSerie>
				<WorkCardNumber>23432</WorkCardNumber>
				<PIS>96170989385</PIS>
			</EmployeeDocument>
			<GovernmentalInformation>
				<CNPJ/>
				<CPF>31564837700</CPF>
				<RG>493212413</RG>
				<IE/>
				<NumeroCTPS>14202189385</NumeroCTPS>
				<SerieCTPS>0685</SerieCTPS>
			</GovernmentalInformation>
			<AdressInformation>
				<Address>Rua Minas Gerais</Address>
				<Number>525</Number>
				<Complement>Terceiro Andar</Complement>
				<City>
					<Code/>
					<Description/>
				</City>
				<District/>
				<State>
					<Code/>
					<Description/>
				</State>
				<Country>
					<Code/>
					<Description/>
				</Country>
				<ZIPCode/>
				<Region/>
				<POBox/>
			</AdressInformation>
			<CommunicationInformation>
				<PhoneNumber/>
				<PhoneExtension/>
				<FaxNumber/>
				<FaxNumberExtension/>
				<HomePage/>
				<Email/>
			</CommunicationInformation>
			<AllocationInformation>
				<BusinessUnit/>
				<ClockInCard/>
				<LaborType/>
				<UnionCode/>
				<WorkGroupCode/>
				<MarkingPlace/>
				<EmployeeClassCode/>
				<Locality/>
				<AllocationPlanCode/>
				<CountryLocalityCode/>
				<WorkShiftChangeDate/>
				<ListOfTimeTable>
					<TimeTable/>
					<MealIntervalCode/>
				</ListOfTimeTable>
			</AllocationInformation>
			<RuralCarrierInformation>
				<CarrierCode/>
				<RuralGroupCode/>
			</RuralCarrierInformation>
			<EmployeePositionCode>114</EmployeePositionCode>
			<EmployeePositionCodeInternalId>01|01|1291</EmployeePositionCodeInternalId>
			<EmployeePositionLevel/>
			<RoleCode>1</RoleCode>
			<RoleInternalId>01|01|1</RoleInternalId>
			<RoleLevel/>
			<HiringDate>2014-09-04</HiringDate>
			<WorkShiftCode>0202</WorkShiftCode>
			<WorkShiftInternalId>01|01|2</WorkShiftInternalId>
			<WorkShiftSequence>1</WorkShiftSequence>
			<DateInitialShiftSequence>2015-04-13</DateInitialShiftSequence>
			<SalaryCategory>3</SalaryCategory>
			<Salary>1000</Salary>
			<EmployeeSituation>1</EmployeeSituation>
			<CostCenterCode>T20010</CostCenterCode>
			<CostCenterInternalId>01|0101|170021517</CostCenterInternalId>
			<BirthDate>1980-10-08</BirthDate>
			<Gender>F</Gender>
			<HomeState>SP</HomeState>
			<NaturalCity>SP</NaturalCity>
			<MonthlyWorkingHours>220</MonthlyWorkingHours>
		</BusinessContent>
	</BusinessMessage>
</TOTVSMessage>

Bloco de código

language	xml
title	Employee_Retorno
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="3.002">
		<BranchId>D MG 01</BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-05-24T10:47:33</GeneratedOn>
		<Product name="PIMS" version="12.1.20"/>
		<SourceApplication>PIMSCONNECTOR</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>EMPLOYEE</Transaction>
		<Type>Response</Type>
		<UUID>27ae7878-6c56-4806-b1e2-ef0356bd7254</UUID>
	</MessageInformation>
	<ResponseMessage>
		<ProcessingInformation>
			<ProcessedOn>2018-05-24T10:47:33</ProcessedOn>
			<Status>OK</Status>
		</ProcessingInformation>
		<ReceivedMessage>
			<MessageContent/>
			<SentBy>ERP</SentBy>
			<UUID>pg24pilh-krjt-bg29-ypfn-w98j4p9ln535</UUID>
		</ReceivedMessage>
		<ReturnContent>
			<ListOfInternalId>
				<InternalId>
					<Destination>T1|D MG 01|5121091917675948691</Destination>
					<Name>EMPLOYEE</Name>
					<Origin>01|0101|000194</Origin>
				</InternalId>
			</ListOfInternalId>
		</ReturnContent>
	</ResponseMessage>
</TOTVSMessage>

Mensagem JSON

Bloco de código

language	js
title	Employee_Envio
linenumbers	true
collapse	true

{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "3.002",
			"BranchId" : "D MG 01",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2015-04-17T14:40:18",
			"Product" : {
				"@name" : "ERP",
				"@version" : "11"
			},
			"SourceApplication" : "P118_PRD",
			"StandardVersion" : "1.000",
			"Transaction" : "EMPLOYEE",
			"Type" : "BusinessMessage",
			"UUID" : "pg24pilh-krjt-bg29-ypfn-w98j4p9ln535"
		},
		"BusinessMessage" : {
			"BusinessEvent" : {
				"Entity" : "Employee",
				"Event" : "upsert",
				"Identification" : {
					"key" : {
						"@name" : "InternalID",
						"$" : "01|0101|000194"
					}
				}
			},
			"BusinessContent" : {
				"CompanyId" : "T1",
				"BranchId" : "D MG 01",
				"CompanyInternalId" : "01|0101",
				"Code" : "1420",
				"InternalId" : "01|0101|000194",
				"FullName" : null,
				"Name" : "João da Silva",
				"ShortName" : null,
				"BadgeNumber" : "85494",
				"EmployeeType" : "1",
				"EmployeeDocument" : {
					"WorkCardStateIssuing" : "SP",
					"WorkCardModel" : null,
					"WorkCardSerie" : "34",
					"WorkCardNumber" : "23432",
					"PIS" : "96170989385"
				},
				"GovernmentalInformation" : {
					"CNPJ" : null,
					"CPF" : "31564837700",
					"RG" : "493212413",
					"IE" : null,
					"NumeroCTPS" : "14202189385",
					"SerieCTPS" : "0685"
				},
				"AdressInformation" : {
					"Address" : "Rua Minas Gerais",
					"Number" : "525",
					"Complement" : "Terceiro Andar",
					"City" : {
						"Code" : null,
						"Description" : null
					},
					"District" : null,
					"State" : {
						"Code" : null,
						"Description" : null
					},
					"Country" : {
						"Code" : null,
						"Description" : null
					},
					"ZIPCode" : null,
					"Region" : null,
					"POBox" : null
				},
				"CommunicationInformation" : {
					"PhoneNumber" : null,
					"PhoneExtension" : null,
					"FaxNumber" : null,
					"FaxNumberExtension" : null,
					"HomePage" : null,
					"Email" : null
				},
				"AllocationInformation" : {
					"BusinessUnit" : null,
					"ClockInCard" : null,
					"LaborType" : null,
					"UnionCode" : null,
					"WorkGroupCode" : null,
					"MarkingPlace" : null,
					"EmployeeClassCode" : null,
					"Locality" : null,
					"AllocationPlanCode" : null,
					"CountryLocalityCode" : null,
					"WorkShiftChangeDate" : null,
					"ListOfTimeTable" : {
						"TimeTable" : null,
						"MealIntervalCode" : null
					}
				},
				"RuralCarrierInformation" : {
					"CarrierCode" : null,
					"RuralGroupCode" : null
				},
				"EmployeePositionCode" : "114",
				"EmployeePositionCodeInternalId" : "01|01|1291",
				"EmployeePositionLevel" : null,
				"RoleCode" : "1",
				"RoleInternalId" : "01|01|1",
				"RoleLevel" : null,
				"HiringDate" : "2014-09-04",
				"WorkShiftCode" : "0202",
				"WorkShiftInternalId" : "01|01|2",
				"WorkShiftSequence" : "1",
				"DateInitialShiftSequence" : "2015-04-13",
				"SalaryCategory" : "3",
				"Salary" : "1000",
				"EmployeeSituation" : "1",
				"CostCenterCode" : "T20010",
				"CostCenterInternalId" : "01|0101|170021517",
				"BirthDate" : "1980-10-08",
				"Gender" : "F",
				"HomeState" : "SP",
				"NaturalCity" : "SP",
				"MonthlyWorkingHours" : "220"
			}
		}
	}
}

Bloco de código

language	js
title	Employee_Retorno
linenumbers	true
collapse	true

{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "3.002",
			"BranchId" : "D MG 01",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-05-24T10:47:33",
			"Product" : {
				"@name" : "PIMS",
				"@version" : "12.1.20"
			},
			"SourceApplication" : "PIMSCONNECTOR",
			"StandardVersion" : "1.000",
			"Transaction" : "EMPLOYEE",
			"Type" : "Response",
			"UUID" : "27ae7878-6c56-4806-b1e2-ef0356bd7254"
		},
		"ResponseMessage" : {
			"ProcessingInformation" : {
				"ProcessedOn" : "2018-05-24T10:47:33",
				"Status" : "OK"
			},
			"ReceivedMessage" : {
				"MessageContent" : null,
				"SentBy" : "ERP",
				"UUID" : "pg24pilh-krjt-bg29-ypfn-w98j4p9ln535"
			},
			"ReturnContent" : {
				"ListOfInternalId" : {
					"InternalId" : {
						"Destination" : "T1|D MG 01|5121091917675948691",
						"Name" : "EMPLOYEE",
						"Origin" : "01|0101|000194"
					}
				}
			}
		}
	}
}

Descrição Detalhada das Tags

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 Empresaempresa
	BranchId	String	20	Filial Código da Empresafilial
	Code	String	6	Código / Matrícula do funcionário
	Name	String	40	Nome do funcionario
	ShortName	String		Nome Abreviado / Apelido do funcionario
	BirthDate	Date	-	Data de Nascimentonascimento
	Gender	String	1	Genero: M - Masculino F - Femino
	CPF	String	14	Número do CPF
	RG			Número do RG
	Email	String	50	Correio Eletrônicoeletrônico
	PhoneNumber			Número de Telefonetelefone
	Address			Endereço
	Number			Número do endereço
	ZIPCode			Número do CEP
	BadgeNumber	String		Número do crachá
	HiringDate	Date	-	Data de Admissãoadmissão
	Salary	Decimal		Salário em digitos decimais
	SalaryCategory	String	1	Categoria salarial: 1 - Mensalista 2 - Horista 3 - Tarefeiro 4 - Diárista 5 - Quinzenalista 6 - Semanalista 7 - Outros
	CostCenterCode	String	20	Centro de custo vinculado ao funcionário
	EmployeeType	Number	1	Tipo do funcionário 1 - Funcionário 2 - Estagiário 3 - Aposentado 4 - Empregador 5 - Prazo determinado 6 - Tempo parcial 7 - Menor aprendiz 8 - Reservado 9 - Reserv 10 - Temporário 11 - Cooperado 12 - Contratado 13 - Sócio quotista 14 - Estagiário contratado 15 - Terceiro ponto
	EmployeePositionCode	String	5	Código do cargo
	EmployeeSituation	String	1	Situação do funcionário na folha: 1 - Ativo 2 - Demitido 3 - Férias 4 - Afastado 5 - Atestado 6 - Quitação
	EmployeePositionLevel	Number		Código Nivel Cargo
	CNPJ			Número do CNPJ
	IE			Número da Inscrição Estadual
	NumeroCTPS			Número da Carteira carteira de Trabalho trabalho e Previdência Socialprevidência social
	SerieCTPS			Série da Carteira carteira de Trabalho trabalho e Previdência Socialprevidência social
	TransferenceAdmissionDate	Date	-	Data de Transferênciatransferência
	WorkCenterCode	String	1	Código do Centro centro de Trabalhotrabalho
	DepartamentCode	String	9	Codigo do departamento
	WorkShiftCode	String	3	Codigo do turno
	WorkShiftSequence	String	2	Sequencia Inicio inicio do Turnoturno
	PIS			Número do PIS
	WorkCardStateIssuing	String		Unidade da federação emitente da carteira de trabalho
	WorkCardSerie	String		Série da Carteira carteira de Trabalho trabalho e Previdência Socialprevidência social
	WorkCardNumber	String		Número da Carteira carteira de Trabalho trabalho e Previdência Socialprevidência social
	RuralGroupCode	Number		Codigo Turma Ruralturma rural
	CarrierCode	Number		Codigo do Transportador Ruraltransportador rural
	ClockInCard	String		Número do cartão ponto do funcionário
	LaborType	Number		Tipo de mão de obra: 1 - Interno 2 - Externo
	UnionCode	String		Código do Sindicatosindicato
	WorkGroupCode	Number		Turma de Trabalhotrabalho
	EmployeeClassCode	Number		Codigo da classe de funcionários para ponto eletrônico
	AllocationPlanCode	String		Código do Plano Lotacionalplano lotacional
	DemissionDate	Date	-	Data de Demissãodemissão
	DateOfSalaryChange	Date	-	Data de alteração do cargo/salário
	WorkShiftChangeDate	Date	-	Data de alteração de lotação de turno
	ContractEnd	Date	-	Data de término do contrato trabalho/experiência
	PrivateCitizen			Número da Pessoa Físicapessoa física
	RegistrationDigit			Dígito Verificador verificador do Funcionáriofuncionário

Limitações e Restrições

Esta integração está disponível a partir da versão 12.1.4 do PIMS Multicultivos e do PIMSConnector;
Caso já exista o cadastro de Funcionário funcionário em ambos os sistemas, será necessário habilitar o processo de integração através do ajuste do cadastro do PIMS Multicultivos, informando o código do ERP no campo "Código ERP", para depois realizar a integração. Caso isto não seja feito, o processo de integração não funcionará corretamente, gerando inconsistências nas informações trafegadas entre os aplicativos;
A integração de Funcionários funcionários para o PIMS Multicultivos é realizada em modo exclusivo entre as Unidades Administrativasunidades administrativas;
O sindicato não é obrigatório no cadastro do funcionário, mas caso ele seja informado é necessário que esse sindicato esteja cadastrado no PIMS Multicultivos e pertença a Unidade Administrativa unidade administrativa na qual o funcionário está sendo cadastrado;
O centro de custo informado para o funcionário deve estar cadastrado no PIMS Multicultivos e pertencer a Unidade Administrativa unidade administrativa na qual o funcionário está sendo cadastrado;
O cargo informado para o funcionário deve existir no PIMS Multicultivos.

Páginas filhas

Versões comparadas

Versão antiga 9

Nova versão Atual

Chave

Informações da Mensagem

Campos Obrigatórios

Exemplos de Mensagens

Mensagem XML

Mensagem JSON

Descrição Detalhada das Tags

Limitações e Restrições