INTEGRAÇÃO - Funcionários
Linha de Produto: | PIMSConnector |
Segmento: | Agroindústria |
Módulo: | Mensagens Integração |
Função: | Integração de Funcionários via TXT |
Situação/Requisito: | Ao efetuar o cadastro de Funcionário no ERP o mesmo deve ser integrado com o PIMS Multicultivos via TXT |
Solução/Implementação: | Implementar rotinas para integrar as informações de Funcionário do ERP para o PIMS Multicultivos via TXT |
Requisito: | DAGROINTEGRACAO-192 |
A Integração de Funcionários consiste na movimentação do cadastro no sentido ERP para o PIMS Multicultivos, ou seja, será realizado no ERP e enviado para o PIMS Multicultivos através do PIMSConnector.
Informações da Mensagem
- Employee /Funcionário
- Identificador da Mensagem: Employee
- Versão: 3.002
- Tipo de Envio: <Síncrona>
- Módulo <PIMS Multicultivos>: <Funcionário>
Campos Obrigatórios
- Código
- 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
Limitações/Restrições
- Esta integração está disponível a partir da versão 12.1.19.1 do PIMSConnector.
- A integração de Funcionário é utilizada em modo exclusivo. No ERP precisa estar totalmente exclusivo em nível de Empresa e Filial.
- A integração de Funcionário gera as seguintes tabelas:
- Funcionário (FUNCIONAR): O código do funcionário no PIMS Multicultivos é formado pelo código proveniente do Protheus e pelo conteúdo do campo "Prefixo do Funcionário" do cadastro de filial. Se não for informado mantém o mesmo código do Protheus, se for informado, o código fica composto por "Prefixo do Funcionário" + "Código do Protheus (com tamanho fixo de 6 posições completado com zeros a esquerda)". O cadastro de funcionário tem relacionamento com o cadastro de sindicato, porém, não é uma informação obrigatória. Quando informado, é verificada a existência do mesmo no PIMS Multicultivos;
- Disponibilidade (FUNCIONARIODISP): Disponibilidade do funcionário representa o histórico de cargo, centro de custo, unidade administrativa e situações do funcionário:
- Ativo
- Férias
- Afastado
- Demitido
- Funcionário (FUNCIONAR): O código do funcionário no PIMS Multicultivos é formado pelo código proveniente do Protheus e pelo conteúdo do campo "Prefixo do Funcionário" do cadastro de filial. Se não for informado mantém o mesmo código do Protheus, se for informado, o código fica composto por "Prefixo do Funcionário" + "Código do Protheus (com tamanho fixo de 6 posições completado com zeros a esquerda)". O cadastro de funcionário tem relacionamento com o cadastro de sindicato, porém, não é uma informação obrigatória. Quando informado, é verificada a existência do mesmo no PIMS Multicultivos;
- Na inclusão do funcionário é gerada a informação de disponibilidade tendo como base a data de admissão. Na alteração do funcionário será atualizada a disponibilidade quando houver uma alteração de cargo ou se houver alguma correção na data de admissão. A disponibilidade tem relacionamento com Cadastro de Cargos e Centro de Custos, sendo obrigatórios para geração da disponibilidade.
- 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.
- A exclusão do Funcionário somente será realizada caso não haja relacionamento em outras tabelas.
- Caso já exista o cadastro de Funcionários em ambos os sistemas e precisa ser habilitado o processo de integração, será necessário ajustar o cadastro do PIMS Multicultivos, informando o código do ERP no campo Código ERP, para depois realizar a movimentação das integrações, caso isto não seja feito, o processo de integração não funcionará corretamente, gerando inconsistência nas informações trafegadas entre os aplicativos.
Estrutura do Arquivo TXT
Segue abaixo os campos do arquivo TXT para realização da Integração de Funcionários:
Sequência | Nome Ténico | Delimitador | Tipo | Valores | Detalhamento |
1º | Transaction | || | Fixo | Employee | Identifica o nome da integração |
2º | Type | || | Fixo | BusinessMessage | Tipo de mensagem de integração |
3º | Event | || | Variável | upsert | Qual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração – ou delete – eliminação) |
4º | SourceApplication | || | Variável | ERP | Define qual o aplicativo que originou esta mensagem |
5º | CompanyId | || | Variável | 01 | Código da Empresa |
6º | BranchId | || | Variável | 001 | Código da Filial |
7º | Code | || | Variável | 101010 | Código do funcionário |
8º | Name | || | Variável | João Pedro da Silva | Nome do funcionario |
9º | ShortName | || | Variável | João Silva | Nome Abreviado / Apelido do funcionario |
10º | BirthDate | || | Variável | 1970-01-01 | Data de Nascimento |
11º | Gender | || | Variável | M | Genero: M - Masculino/F - Femino |
12º | CPF | || | Variável | 14512312554 | Número do CPF |
13º | RG | || | Variável | 124565432 | Número do RG |
14º | || | Variável | [email protected] | Correio Eletrônico | |
15º | PhoneNumber | || | Variável | 990909999 | Número de Telefone |
16º | Address | || | Variável | Av. Paulista | Endereço |
17º | Number | || | Variável | 990909999 | Número do endereço |
18º | ZIPCode | || | Variável | 99999999 | Número do CEP |
19º | BadgeNumber | || | Variável | 1234678911 | Número do crachá |
20º | HiringDate | || | Variável | 2013-01-21 | Data de Admissão |
21º | Salary | || | Variável | 4000.39 | Salário em digitos decimais |
22º | SalaryCategory | || | Variável | 1 | Categoria Salarial 1 - Mensalista 2 - Horista 3 - Tarefeiro 4 - Diarista 5 - Quinzenalista 6 - Semanalista 7 - Outros |
23º | CostCenterCode | || | Variável | 5710 | Centro de custo vinculado ao funcionário |
24º | EmployeeType | || | Variável | 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 |
25º | EmployeePositionCode | || | Variável | 11120 | Código do cargo |
26º | EmployeeSituation | || | Variável | 1 | Situação do Funcionário na Folha 1 - Ativo 2 - Demitido 3 - Férias 4 - Afastado 5 - Atestado 6 - Quitação |
27º | EmployeePositionLevel | || | Variável | 11 | Código Nivel Cargo |
28º | CNPJ | || | Variável | 76281346000177 | Número do CNPJ |
29º | IE | || | Variável | 110042490114 | Número da Inscrição Estadual |
30º | NumeroCTPS | || | Variável | 099187 | Número da Carteira de Trabalho e Previdência Social |
31º | SerieCTPS | || | Variável | 0445 | Série da Carteira de Trabalho e Previdência Social |
32º | TransferenceAdmissionDate | || | Variável | 2017-01-01 | Data de Transferência |
33º | WorkCenterCode | || | Variável | 522145 | Código do Centro de Trabalho |
34º | DepartamentCode | || | Variável | 54447895 | Codigo do departamento |
35º | WorkShiftCode | || | Variável | 445 | Codigo do turno |
36º | WorkShiftSequence | || | Variável | 8874 | Sequencia Inicio do Turno |
37º | PIS | || | Variável | 60145258456 | Número do PIS |
38º | WorkCardStateIssuing | || | Variável | SP | Unidade da federação emitente da carteira de trabalho |
39º | WorkCardSerie | || | Variável | 0445 | Série da Carteira de Trabalho e Previdência Social |
40º | WorkCardNumber | || | Variável | 099187 | Número da Carteira de Trabalho e Previdência Social |
41º | RuralGroupCode | || | Variável | 4 | Codigo Turma Rural |
42º | CarrierCode | || | Variável | 41 | Codigo do Transportador Rural |
43º | ClockInCard | || | Variável | 231 | Número do cartão ponto do funcionário |
44º | LaborType | || | Variável | 1 | Tipo de Mão de Obra 1 - Interno 2 - Externo |
45º | UnionCode | || | Variável | 1124 | Código do Sindicato |
46º | WorkGroupCode | || | Variável | 445 | Turma de Trabalho |
47º | EmployeeClassCode | || | Variável | 5545 | Codigo da classe de funcionários para ponto eletrônico |
48º | AllocationPlanCode | || | Variável | 7889 | Código do Plano Lotacional |
49º | DemissionDate | || | Variável | 2018-01-01 | Data de Demissão |
50º | DateOfSalaryChange | || | Variável | 2018-09-09 | Data de alteração do cargo/salário |
51º | WorkShiftChangeDate | || | Variável | 2017-11-11 | Data de alteração de lotação de turno |
52º | ContractEnd | || | Variável | 2017-04-01 | Data de término do contrato trabalho/experiência |
53º | PrivateCitizen | || | Variável | 554656 | Número da Pessoa Física |
54º | RegistrationDigit | || | Variável | 12 | Dígito Verificador do Funcionário |
Exemplo do contéudo do arquivo TXT
Employee||BusinessMessage||upsert||ERP||01||001||101010||João Pedro da Silva||João Silva||01-01-1970||M||14512312554||124565432||[email protected]||990909999||Av. Paulista||990909999||99999999||1234678911||1234678912||4000.39||1||5710||1||11120||1||11||76281346000177||110042490114||099187||0445||522145||54447895||445||8874||60145258456||SP||0445||099187||4||41||231||1||1124||445||||7889||01-01-2018||09-09-2017||11-11-2017||04-01-2017||554656||12
Observação: O delimitador por default é "||", porém pode ser definido outro tipo de delimitador.