Integrações

Páginas filhas
  • DI Funcionário - Employee

A integração de 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 do funcionário;
  • Sexo do funcionário;
  • Data de admissão do funcionário.

Exemplos de Mensagens

Mensagem XML

Employee_Envio 
<?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>
Employee_Retorno 
<?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

Employee_Envio 
{
	"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"
			}
		}
	}
}
Employee_Retorno 
{
	"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

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
CodeString6Código / Matrícula do funcionário
Name String40Nome do funcionario
ShortNameString
Nome Abreviado / Apelido do funcionario
BirthDateDate-Data de nascimento


Gender


String


1

Genero:

  • M - Masculino
  • F - Femino
CPFString14Número do CPF
RG

Número do RG
EmailString50Correio eletrônico
PhoneNumber

Número de telefone
Address

Endereço
Number

Número do endereço
ZIPCode

Número do CEP
BadgeNumberString
Número do crachá
HiringDateDate-Data de admissão
SalaryDecimal
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
CostCenterCodeString20Centro 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
EmployeePositionCodeString5Có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
EmployeePositionLevelNumber
Código Nivel Cargo
CNPJ

Número do CNPJ
IE

Número da Inscrição Estadual
NumeroCTPS

Número da carteira de trabalho e previdência social
SerieCTPS

Série da carteira de trabalho e previdência social
TransferenceAdmissionDateDate-Data de transferência
WorkCenterCodeString1Código do centro de trabalho
DepartamentCodeString9Codigo do departamento
WorkShiftCodeString3Codigo do turno
WorkShiftSequenceString2Sequencia inicio do turno
PIS

Número do PIS
WorkCardStateIssuingString
Unidade da federação emitente da carteira de trabalho
WorkCardSerieString
Série da carteira de trabalho e previdência social
WorkCardNumberString
Número da carteira de trabalho e previdência social
RuralGroupCodeNumber
Codigo turma rural
CarrierCodeNumber
Codigo do transportador rural
ClockInCardString
Número do cartão ponto do funcionário


LaborType


Number


 Tipo de mão de obra:

  • 1 - Interno
  • 2 - Externo
UnionCodeString
Código do sindicato
WorkGroupCodeNumber
Turma  de trabalho
EmployeeClassCodeNumber
Codigo da classe de funcionários para ponto eletrônico
AllocationPlanCodeString
Código do plano lotacional
DemissionDateDate

-

Data de demissão
DateOfSalaryChangeDate-Data de alteração do cargo/salário
WorkShiftChangeDateDate-Data de alteração de lotação de turno
ContractEndDate-Data de término do contrato trabalho/experiência
PrivateCitizen

Número da pessoa física
RegistrationDigit

Dígito verificador do 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 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 para o PIMS Multicultivos é realizada em modo exclusivo entre as unidades 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 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 na qual o funcionário está sendo cadastrado;
  • O cargo informado para o funcionário deve existir no PIMS Multicultivos.