Páginas filhas
  • DT - TXT Implementação da Integração de Funcionários

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
  • 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ênciaNome Ténico Delimitador TipoValoresDetalhamento
Transaction||FixoEmployeeIdentifica o nome da integração
Type||FixoBusinessMessageTipo de mensagem de integração
Event||VariávelupsertQual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração – ou delete – eliminação)
SourceApplication||VariávelERPDefine qual o aplicativo que originou esta mensagem
CompanyId||Variável01Código da Empresa
BranchId||Variável001Código da Filial
Code||Variável101010Código do funcionário
Name ||VariávelJoão Pedro da SilvaNome do funcionario
ShortName||VariávelJoão SilvaNome Abreviado / Apelido do funcionario
10ºBirthDate||Variável1970-01-01Data de Nascimento
11ºGender||VariávelMGenero: M - Masculino/F - Femino
12ºCPF||Variável14512312554Número do CPF
13ºRG||Variável124565432Número do RG
14ºEmail||Variável[email protected]Correio Eletrônico
15ºPhoneNumber||Variável990909999Número de Telefone
16ºAddress||VariávelAv. PaulistaEndereço
17ºNumber||Variável990909999Número do endereço
18ºZIPCode||Variável99999999Número do CEP
19ºBadgeNumber||Variável1234678911Número do crachá
20ºHiringDate||Variável2013-01-21Data de Admissão
21ºSalary||Variável4000.39Salário em digitos decimais
22ºSalaryCategory||Variável1Categoria Salarial          
1 - Mensalista
    2 - Horista
    3 - Tarefeiro
    4 - Diarista
    5 - Quinzenalista
    6 - Semanalista
    7 - Outros
23ºCostCenterCode||Variável5710Centro de custo vinculado ao funcionário
24ºEmployeeType||Variável1Tipo 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ável11120Código do cargo
26ºEmployeeSituation||Variável1Situação do Funcionário na Folha
1 - Ativo
    2 - Demitido
    3 - Férias
    4 - Afastado
    5 - Atestado
    6 - Quitação
27ºEmployeePositionLevel||Variável11Código Nivel Cargo
28ºCNPJ||Variável76281346000177Número do CNPJ
29ºIE||Variável110042490114Número da Inscrição Estadual
30ºNumeroCTPS||Variável099187Número da Carteira de Trabalho e Previdência Social
31ºSerieCTPS||Variável0445Série da Carteira de Trabalho e Previdência Social
32ºTransferenceAdmissionDate||Variável2017-01-01Data de Transferência
33ºWorkCenterCode||Variável522145Código do Centro de Trabalho
34ºDepartamentCode||Variável54447895Codigo do departamento
35ºWorkShiftCode||Variável445Codigo do turno
36ºWorkShiftSequence||Variável8874Sequencia Inicio do Turno
37ºPIS||Variável60145258456Número do PIS
38ºWorkCardStateIssuing||VariávelSPUnidade da federação emitente da carteira de trabalho
39ºWorkCardSerie||Variável0445Série da Carteira de Trabalho e Previdência Social
40ºWorkCardNumber||Variável099187Número da Carteira de Trabalho e Previdência Social
41ºRuralGroupCode||Variável4Codigo Turma Rural
42ºCarrierCode||Variável41Codigo do Transportador Rural
43ºClockInCard||Variável231Número do cartão ponto do funcionário
44ºLaborType||Variável1Tipo de Mão de Obra
1 - Interno
     2 - Externo
45ºUnionCode||Variável1124Código do Sindicato
46ºWorkGroupCode||Variável445Turma  de Trabalho
47ºEmployeeClassCode||Variável5545Codigo da classe de funcionários para ponto eletrônico
48ºAllocationPlanCode||Variável7889Código do Plano Lotacional
49ºDemissionDate||Variável2018-01-01Data de Demissão
50ºDateOfSalaryChange||Variável2018-09-09Data de alteração do cargo/salário
51ºWorkShiftChangeDate||Variável2017-11-11Data de alteração de lotação de turno
52ºContractEnd||Variável2017-04-01Data de término do contrato trabalho/experiência
53ºPrivateCitizen||Variável554656Número da Pessoa Física
54ºRegistrationDigit||Variável12Dí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.