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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"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 | ||
BranchId | String | 20 |
Código da |
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 |
Gender |
String |
1 | Genero:
|
|
CPF |
String |
14 | Número do CPF |
RG |
Número do RG | ||
String |
50 | Correio |
eletrônico |
PhoneNumber |
Número de |
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 |
Salary |
Decimal | Salário em digitos decimais | |
SalaryCategory |
String |
1 | Categoria salarial:
|
CostCenterCode |
String |
20 | Centro de custo vinculado ao funcionário |
EmployeeType |
Number |
1 | Tipo do funcionário
|
EmployeePositionCode |
String |
5 | Código do cargo |
EmployeeSituation |
String |
1 | Situação do funcionário na folha:
|
EmployeePositionLevel |
Number | 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 |
TransferenceAdmissionDate |
Date |
- | Data de |
transferência |
WorkCenterCode |
String |
1 | Código do |
centro de |
trabalho |
DepartamentCode |
String |
9 | Codigo do departamento |
WorkShiftCode |
String |
3 | Codigo do turno |
WorkShiftSequence |
String |
2 | Sequencia |
inicio do |
turno |
PIS |
Número do PIS | |||
WorkCardStateIssuing |
String | Unidade da federação emitente da carteira de trabalho | |
WorkCardSerie |
String | Série da |
carteira de |
trabalho e |
previdência social |
WorkCardNumber |
String |
Número da |
carteira de |
trabalho e |
previdência social |
RuralGroupCode |
Number |
Codigo |
turma rural |
CarrierCode |
Number | Codigo do |
transportador rural |
ClockInCard |
String | Número do cartão ponto do funcionário | |
LaborType |
Number | Tipo de mão de obra:
| |
UnionCode |
String | Código do |
sindicato |
WorkGroupCode |
Number |
Turma de |
trabalho |
EmployeeClassCode |
Number |
Codigo da classe de funcionários para ponto eletrônico | |
AllocationPlanCode |
String | Código do |
plano lotacional |
DemissionDate |
Date |
- | Data de |
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 |
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 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.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas