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

Empresa

empresa
BranchId	String	20

Filial

Código da

Empresa

filial
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

Nascimento

nascimento

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ônico

eletrônico

PhoneNumber

Número de

Telefone

telefone

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ão

admissã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 Social

previdência social

SerieCTPS

Série da

Carteira

carteira de

Trabalho

trabalho e

Previdência Social

previdência social

TransferenceAdmissionDate

Date

-

Data de

Transferência

transferência

WorkCenterCode

String

1

Código do

Centro

centro de

Trabalho

trabalho

DepartamentCode

String

9	Codigo do departamento
WorkShiftCode

String

3	Codigo do turno
WorkShiftSequence

String

2

Sequencia

Inicio

inicio do

Turno

turno

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 Social

previdência social

WorkCardNumber

String

Número da

Carteira

carteira de

Trabalho

trabalho e

Previdência Social

previdência social

RuralGroupCode

Number

Codigo

Turma Rural

turma rural

CarrierCode

Number

Codigo do

Transportador Rural

transportador 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

Sindicato

sindicato

WorkGroupCode

Number

Turma de

Trabalho

trabalho

EmployeeClassCode

Number

	Codigo da classe de funcionários para ponto eletrônico
AllocationPlanCode

String

Código do

Plano Lotacional

plano lotacional

DemissionDate

Date

-

Data de

Demissão

demissã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ísica

pessoa física

RegistrationDigit

Dígito

Verificador

verificador do

Funcionário

funcioná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 3

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