Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 13

changes.mady.by.user Olavo Jose Olivio

Gravado em

comparado com

Nova versão 14

changes.mady.by.user Olavo Jose Olivio

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Deck of Cards
id1
Card
id1
labelParametrização
titleParametrização
  • No programa FP0540 - Manutenção Descentralizada HCM
    1. Na aba Ahgora marque a opção "Integra Ahgora PontoWeb" e cadastre os dados para a integração.
      1. Tipo de Ambiente:
        1. Produção ou Homologação
      2. Configurações conexão Ahgora:
        1. Usuário 
        2. Senha
        3. Endereço do servidor

Importante:

        • As informações de acesso ao ambiente da Ahgora devem ser solicitadas ao responsável do contrato da Ahgora.
        • No endereço do servidor, informa a base da URL ex: "https://api.ahgora.com.br".

  • Utiliza Ponto Ahgora
    1. Na aba Cadastral, na inclusão ou alteração dos dados do funcionário, pode ser manutenido os dados para integração.
      1. Nas informações dos campos Utiliza Ponto Ahgora, temos
        • Ponto Obrigatório, para quem deve registrar o ponto.
        • Ponto Livre, para quem não precisa registrar o ponto.
        • Data Elegibilidade Ponto, data relacionada ao dado do campo bate ponto "ponto obrigatório ou livre", data que inicia a elegibilidade do ponto.


Card
id2
labelParametrização Ahgora
titleParametrização Ahgora

Antes da integração, é necessário que os cadastros básicos já existam no sistema da Ahgora. Abaixo estão os dados e onde encontrá-los no RH Datasul:

    • Eventos (Código Contábil Ahgora) - FP0020 - Manutenção Eventos - Analíticos
      • A informação deve ser concatenada com o código da empresa. Além disso, é necessário incluir a descrição do evento.
      • Para empresas que não utilizam eventos por empresa, a concatenação deve ser feita com o código da empresa do funcionário, em vez de usar um asterisco.
      • Exemplo: Empresa 10, evento 103 = "10103 - Horas Extras Noturnas (50%)".
  •  
    • Turno (Escala Ahgora) - FP1400- Manutenção Turno de Trabalho
      • O turno é definido por banco e deve ser utilizado apenas o código do turno cadastrado no programa FP1400. Além disso, é necessário incluir a descrição correspondente do turno.
      • Exemplo: "103 - Produção - 07:30 as 17:30".
  •  
    • Sindicato - FP0600 - Manutenção Sindicatos
      • O sindicato é definido por banco e deve ser utilizado apenas o código do sindicato cadastrado no programa FP0600. Além disso, é necessário incluir a descrição correspondente do sindicato.
      • Exemplo: "18 - SINDICATO DOS TECNOLOGOS".
  •  
    • Centro de Custo - FP0660 - Manutenção Centros de Custo
      • O código de centro de custo precisa ser concatenada com o código da empresa do funcionário. Além disso, é necessário incluir a descrição do centro de custo.
      • Exemplo: Empresa 10, Centro de Custo 0040100 = "10004100 - Administração".
  •  
    • Afastamento - FP0060 - Manutenção Situações
      • A situação de afastamento é definido por banco e deve ser utilizado apenas o código da situação cadastrado no programa FP0060. Além disso, é necessário incluir a descrição correspondente da situação.
      • Exemplo: "29 - Afastado por Doença Horas".


Card
id3
labelIntegração
titleIntegração

Para acessar o novo programa de integração dos produtos do RH Datasul com a Ahgora, vá ao menu e procure, por exemplo, pela palavra 'Ahgora'. Em seguida, será exibido o programa 'Integração Ahgora'.

Ao executar esse programa, será apresentada a aplicação com o menu 'Integração Ahgora', contendo itens como Funcionários e Afastamentos. No menu seguinte, 'Exclusão Ahgora', encontra-se a opção Afastamentos.

A seguir, detalharemos um pouco mais cada uma dessas opções.


Deck of Cards
idIntegração
Card
id3-1
labelFuncionários
titleFuncionários

Informações da tela

    • Na tela inicial, são apresentados filtros básicos para a seleção dos funcionários que serão enviados. Por padrão, o campo 'Data Admissão De' vem preenchido com um mês anterior à data atual, enquanto o campo 'Data Admissão Até' é preenchido com a data atual.
    • Os filtros 'Estabelecimento' e 'Data Admissão De' são obrigatórios.

    • Para mais filtros, é necessário acessar a opção de . Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados tela principal.

    • Após aplicarmos os filtros será apresentada a seguinte tela:
      • Status: Correspondente ao status do registro
      • Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
      • Nome: Nome do funcionário.
      • Dt. Admissão: Data de admissão.
      • Dt. Demissão: Data de demissão.
      • Turno: Código do turno do funcionário.
      • Cargo: Código do cargo do funcionário.
      • Movimento: Inclusão/Alteração (status alteração ocorrerá sempre que o primeiro cadastro já tenha sido enviado para Ahgora).
      • Dt. Movimento: Data da movimentação (envio a Ahgora).

    • Serão listados até 100 registros por página. Ao final da página, será exibido o botão 'Carregar mais resultados' .
    • Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em 'Integrar Funcionários'. .

    • Ao integrar o registro, se tudo ocorrer corretamente, o status será alterado para 'Aguardando Retorno'. Em seguida, basta selecioná-lo novamente e atualizar o status para verificar o retorno da integração.

    • Ao final da atualização, o status do registro será alterado conforme o resultado:

      • Sem inconsistências: O status será atualizado para 'IN - Integrado', com a mensagem 'Registro integrado com sucesso.'
      • Com inconsistências: O status será atualizado para 'CI - Com Inconsistências'. Nesse caso, o erro pode ser consultado na opção 'Status', acessível ao clicar nos três pontos localizados à direita da tabela.


Card
id3-2
labelAfastamentos
titleAfastamentos

Nessa nova tela, será exibido o menu para integração dos AfastamentosInformações da tela

    • Na tela inicial, são apresentados filtros
basicos
    • básicos para a seleção dos
afastamentos
    • afastamento que serão enviados.
Como sugestão, a
    • Por padrão, o campo 'Data Afastamento De' vem preenchida com um mês anterior que a data atual e a 'Data Afastamento Até' com a data atual.
Filtros
    • Os filtros de '
Filial
    • Estabelecimento' e 'Data Afastamento De' são obrigatórios. 

Image Modified

    • Para mais filtros, é necessário acessar a opção de
'Filtros Avançados'Image Removed. Na opção de 'Filtros Avançados',
    •  Image Added. Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados
na primeira
    • tela principal.

Image RemovedImage AddedSelecionando

    • Após aplicarmos os filtros
na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros'Image Removed, o sistema buscará as informações dos afastamentos dos funcionários.
    • será apresentada a seguinte tela:
      • Status: 

Apresentação das Informações

Ao aplicarmos os filtros será apresentada a seguinte tela:

Lista de Afastamentos

Ao obter a lista de funcionários, temos as colunas:

    • Status:
      • Correspondente ao status do registro
        • Legenda verde, Tag 'NI' - Integrados
        • Legenda azul, Tag 'IN' - Não integrados
        • Legenda vermelha, Tag 'CI' - Com Inconsistências 
        • Legenda laranja, Tag 'AR' - Aguardando Retorno
      Image Removed
            • IN - Integrado.
            • NI - Não Integrado.
            • CI - Com Inconsistência.
            • AR - Aguardando Retorno.
          • Matrícula Ahgora:
          • Codigo
          •  Código da
          • coligada + Chapa do funcionário
          • empresa + estabelecimento + matricula.
          • Nome:
          • Nome
          •  Nome do funcionário.
          • Tipo do afastamento:
          • Tipo
          • Situação e descrição do afastamento.
          • Dt. Início: Inicio do afastamento.
          • Dt. Fim: Fim do afastamento
        • Movimento: Inclusão/Alteração  (status alteração ocorrerá sempre que o primeiro cadastro ja tenha sido enviado para ahgora)
          • Dt. Movimento: Data da movimentação (envio a ahgora)
          • .

      Image Added

        • Serão listados até 100 registros por página
      , ao
        • . Ao final da página, será
      mostrado
        • exibido o botão
      para "carregar
        • 'Carregar mais resultados
      "
        • ' Image Modified.
      Image Removed
        • Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em
      "
        • 'Integrar Afastamentos
      " Image Removed
        • '. Image Added.
      Image Removed

      Image Added

      Image Removed

      Image Added

      Image Removed

        • Ao integrar o registro, se tudo ocorrer
      tudo certo
        • corretamente, o
      registro
        • status será alterado para 'Aguardando Retorno'.
      Basta seleciona-ló
        • Em seguida, basta selecioná-lo novamente e atualizar o status Image Added, para verificar o retorno da integração.
      Image Removed

      Image Added

      Image Removed

        • Ao final da atualização

      do status

        • , o status do registro será alterado conforme o resultado:

          • Sem inconsistências: O status será atualizado para 'IN
      '
          • - Integrado
      : o registro foi
          • ', com a mensagem 'Registro integrado com sucesso.
          • '
          • Com inconsistências: O status será atualizado para

      Image Removed

          • 'CI
      '
          • - Com Inconsistências
      : Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte
          • '. Nesse caso, o erro pode ser consultado na opção 'Status', acessível ao clicar nos três pontos localizados à direita da tabela.

      Image Removed

      Image Removed

      Erro é apresentado na tela

      Image Removed

      Image Added

      Image Added

    Card
    id3-3
    labelExclusão Afastamentos
    titleExclusão Afastamentos

    Nessa nova tela, será exibido o menu para integração das Exclusões dos Afastamentos

    Na tela inicial são apresentados filtros basicos para a seleção das exclusões dos afastamentos que serão enviados. Como sugestão, a 'Data Exclusões De' vem preenchida com um mês anterior que a data atual e a 'Data Exclusões Até' com a data atual. Filtros de 'Filial' e 'Data Exclusões De' são obrigatórios. 

    Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'. Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

    Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros', o sistema buscará as informações das Exclusões de afastamentos dos funcionários.

    Apresentação das Informações

    Ao aplicarmos os filtros será apresentada a seguinte tela:

    Lista de Afastamentos

    Ao obter a lista de funcionários, temos as colunas:

      • Status: Correspondente ao status do registro
        • Legenda verde, Tag 'NI' - Integrados
        • Legenda azul, Tag 'IN' - Não integrados
        • Legenda vermelha, Tag 'CI' - Com Inconsistências 
        • Legenda laranja, Tag 'AR' - Aguardando Retorno

      • Matrícula Ahgora: Codigo da coligada + Chapa do funcionário
      • Nome: Nome do funcionário
      • Tipo do afastamento: Tipo e descrição do afastamento
      • Dt. Início: Inicio do afastamento
      • Dt. Fim: Fim do afastamento
      • Movimento: Exclusão
      • Dt. Movimento: Data da movimentação (envio a ahgora)

    Serão listados 100 registros por página, ao final da página será mostrado o botão para "carregar mais resultados" .

    Atenção: serão gravadas as exclusões dos afastamentos que possuam o status 'NI' - Integrados


    Para realizar o envio, selecione o registro desejado e clique em "Integrar Exclusões" .


    Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'. Basta seleciona-ló novamente e atualizar o status para verificar o retorno da integração.

    Ao final da atualização do status, o registro será alterado:

    'IN' - Integrado: o registro foi integrado com sucesso.

    'CI' - Com Inconsistências: Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte direita da tabela.

    Erro é apresentado na tela

    Card
    id3-4
    labelAgendamento do processo
    titleAgendamento do processo

    Após a realização da ativação da integração com a ahgora, o sistema começa a registrar automaticamente os novos eventos de admissão, alteração e exclusão relacionados aos funcionários e seus afastamentos. Para o envio a Ahgora.

     Para realizar o agendamento desses envios acesse: Acesse RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.11 - Ahgora

    Na aba Agendamento, você pode programar a integração dos registros que foram gravados para ocorrerem automaticamente, sem a necessidade de interação do usuário, tornando o processo mais dinâmico e produtivo. Isso funciona com o JobServer configurado para execução em modo 3 Camadas. Para mais informações sobre a configuração, clique aqui.

    Para consultar os envios basta acessar  Acesse RH | Folha de pagamento | Ambiente | Gerenciador de Jobs

    Serão criados dois jobs FopEnviarFuncionariosAfastamentosAhgoraProcess(envio dos funcionarios/afastamento e exclusões) e FopAtualizarStatusAhgoraProcess (Solicitação de atualização de status);


    Card
    id3-5
    labelApuração de Resultados
    titleApuração de Resultados

    Para gerar as credenciais de Resultados para cadastro na ahgora 

    1) Realize a configuração do DefaultDB. Informações em : Configurando DefaultDB

    2) Usuario e senha que serão fornecidos: Criar um usuario do sistema Folha de pagamento que possua permissão (01.06 - Ahgora), conforme aba "Parametrização"

    3) API para recebimento da apuração é composta por servidor: maquina onde o RM está instalado + ApiPort do host e o caminho fixo "/api/rh/v1/ahgora/results"

    Exemplo: http://servidor:ApiPort/api/rh/v1/ahgora/results 


    Após a apuração do ponto na Ahgora, realize o envio para o RM das informações.

    O RM guardará as informações recebidas em Folha Mensal | Consulta | Consulta Movimento da Integração

     

    Poderá ser encontrada com o tipo de lançamento Ahgora

    Caso o parametro "utiliza controle de faltas para cálculo de avos" esteja marcado, o sistema guardará as faltas no historico de faltas.

    Acesse Administração de pessoal | Funcionários | Anexos | Movimento | Controle de Faltas para Cálculo de Avos

    Para processar os eventos para a folha de pagamento será necessario o processamento no grupo de eventos com o novo tipo criado. Acesse  Folha Mensal | Lançamentos | Grupo de eventos

    Selecione o grupo de eventos que irá lançar o movimento e clique em editar

    Marque o parâmetro "Lançar eventos da integração com outros aplicativos" na aba Identificação.

    Será criado a aba "Integração com outros aplicativos ", selecione a nova integração "TOTVS Ahgora" e faça o lançamento.

    Verifique que os valores foram lançado corretamente para o envelope de pagamento.

    Importante: Caso haja necessidade de retirar algum evento, será necessario que realizar uma nova carga de envio dos eventos das ahgora, e logo após um novo processamento dos passos a acima para a correção do lançamento para o envelope de pagamento.


    Card
    id4
    labelDe/Para
    titleDe/Para
    Card
    id1
    labelDe/Para
    titleDe/Para

    1 - FUNCIONÁRIOS


    Descrição AhgoraCampo Tabela RMDescrição / Regra
    Identificação do colaboradorPFUNC.CODICOLIGADA + PFUNC.CHAPAColigada + Chapa
    Chapa do Funcionário.
    Quando for chefe externo preencher o código do chefe externo.
    Não pode haver matricula repedita na mesma coligada.
    Nome do FuncionárioPPESSOA.NOMENome do Funcionario, ou nome do chefe externo.
    É permitido acentuação e caracteres especiais.
    PIS do FuncionárioPFUNC.PISPASEPNumero do PIS do Funcionário.
    Enviar somente números.
    Quando não houver, deverá preencher o campo "    sem_pis" com true
    Matrícula do E-SocialPFUNC.MATRICULAESOCIALMatricula do eSocial
    Data em que o Funcionário foi AdmitidoPFUNC.DATAADMISSAOData de Admissão. DD/MM/AAAA
    Para o chefe externo deverá ser a data de inicio.
    Data de DemissãoPFUNC.DATADEMISSAOData de Demissão. DD/MM/AAAA
    Transferência do tipo "5" não é considerado como demissão, mandar esse campo em branco para esse tipo.
    Para o chefe externo deverá ser a data fim
    Localizações do funcionárioFormula na tela do processoAdicionar um campo na interface onde o usuário possa informar uma fórmula personalizada. Este campo será aberto, permitindo que qualquer campo do cadastro do funcionário seja utilizado. A funcionalidade visa facilitar a criação de filtros e a geração de relatórios no sistema Ahgora. Trata-se de um campo flexível, definido pelo usuário, que oferece maior liberdade e precisão na manipulação de dados e relatórios.
    Código da escala/ turno do funcionário
    PFHSTHOR.CODHORARIO    		Horário do Funcionário - Histórico Horário
    Preencher com o último existente no histórico de horário.
    Coligada + Código
    Data da alteração de escala/turnoPFHSTHOR.DTMUDANCAData da Mudança do Horário do Funcionário.
    Preencher com o último existente no histórico de horário.
    Tipo de Escala de TrabalhoNÃO ENVIARNão existe essa informação na folha de pagamento.
    Carteira de TrabalhoPPESSOA.CARTEIRATRAB
    PPESSOA.SERIECARTTRAB
    PPESSOA.UFCARTTRAB    		Carteira de Trabalho
    Concatenar os 3 campos (numero, série e UF), separando os campos com barra "/". Exemplo: 9999/999/MG
    Título do CargoPHSTFCO.CODFUNCAOFunção do Funcionário - Histórico de Função
    Preencher com o último existente no histórico de função.
    Concater o Código + Descrição, separando com traço "-". Exemplo: 001-ANALISTA DE SISTEMAS
    Descrição do departamento do FuncionárioPFUNC.CODSECAOSeção do funcionário
    Concater o Código + Descrição, separando com traço "-". Exemplo: 01.01.03-DEPARTAMENTO PESSOAL
    Gênero do FuncionárioPPESSOA.SEXOSexo do Funcionário.
    Preencher com F ou M.
    E-mail do FuncionárioPPESSOA.EMAILEmail do funcionário.
    Múltiplos vínculos ter um email por funcionário, não pode ser repetido.
    CPF do FuncionárioPPESSOA.CPFCPF do Funcionário.
    Preencher sem caracteres. Exemplo: 11122233344.
    Para chefe externo busca tbm o CPF
    RG do FuncionárioPPESSOA.CARIDENTIDADECarteira de Identidade.
    Preencher apenas com o RG, podendo ter caracteres.
    Exemplo: M-7.7777
    CNPJ da filial do FuncionárioPSECAO.CGC (JOIN) PFUNC.CODSECAOCNPJ da Seção do funcionário.
    Preencher apenas com numeros, sem caracteres.
    Data da atribuição do CNPJ da empresa ao funcionárioPFUNC.DTTRANSFERENCIAData da Transferencia entre filiais ou coligada.
    Código do centro de custo do funcionárioPSECAO.NROCENCUSTOCONTColigada + Código do Centro de Custo da Seção do Funcionário.
    Regime de Trabalho do FuncionárioDE/PARA NO PARAMETRIZADOR DO RMBuscar a descrição do DE/PARA que será criado no parametrizador do RM, para PFUNC.CATEGORIAESOCIAL X TABELA AHGORA.
    Preencher com a Descrição.
    Data de Nascimento do FuncionárioPPESSOA.DTNASCIMENTOData de Nascismento. DD/MM/AAAA
    Data de Alteração de CargoPHSTFCO.DTMUDANCAData da Mudança da Função do Funcionário.
    Preencher com o último existente no histórico de função.
    Definição de carga horáriaPFUNC.JORNADA_MENSALJornada Mensal do Funcionário.
    Preencher com a quantidade de horas mensais. Exemplo: 220
    Ponto ObrigatórioPFHSTUTILIZACAMPOAHGORA.UTILIZAPONTOEnviar true ou false.
    Data de troca da elegibilidade do registro de pontoPFHSTUTILIZACAMPOAHGORA.DTMUDANCAEnviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.
    Matrícula Chefia ImediataPFUNC.CODICOLIGADA + PFUNC.CHAPAColigada + Chapa do chefe do funcionário ou código do chefe externo.
    Nome Chefia ImediataPFUNC.NOMENome do chefe do Funcionario, ou nome do chefe externo.
    É permitido acentuação e caracteres especiais.
    e-mail Chefia ImediataPPESSOA.EMAILEmail do chefe do funcionário ou email do chefe externo do funcionário.
    Código do SindicatoPFUNC.CODSINDICATOColigada + Código do Sindicato do funcionário
    Data da alteração do código do sindicatoPFSINDIC.DTMUDANCAData da mudança do Sindicato do Funcionário.
    TelefonePPESSOA.TELEFONE2Número do Telefone Celular. Permite caracteres especiais.
    PisPFUNC.PISPASEPPreencher comtrue quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.
    codInternoPFUNC.CHAPAColigada + Chapa
    Chapa do Funcionário.
    Quando for chefe externo preencher o código do chefe externo.
    Não pode haver matricula repedita na mesma coligada.
    matricula_anteriorPFUNC.CHAPAORIGEMPreencher com a chapa do registro demitido.
    Este campo deve ser preenchido quando houve transferencia do tipo "5" e o funcionário ativo tiver uma nova chapa.
    Define o custo hora do funcionário, utilizado para cálculos financeiros.PFUNC.SALARIO / PFUNC.JORNADASalario hora
    Valor do salário do colaboradorPFUNC.SALARIOSalario do funcionário


    2 - AFASTAMENTOS

    Descrição AhgoraCampo Tabela RMDescrição / Regra
    Identificação do colaboradorPFHSTAFT.CHAPA
    PFUFERIASPER.CHAPA    		Coligada + Chapa
    Matricula do Funcionario.
    Busca da tabela de Afastamento e de Férias.
    Motivo do AfastamentoPFHSTAFT.TIPO ou
    F quando for férias    		Coligada + Tipo de Afastamento.
    Quando for férias enviar     F
    Terá um cadastro previo na AHGORA igual do RM.
    Data e/ou hora Inicial do AfastamentoPFHSTAFT.DTINICIO
    PFUFERIASPER.DATAINICIO    		Data inicio do afastamento ou do gozo das férias.
    Informar a hora 00:00. YYYY-MM-DDTHH:MM
    Data e/ou hora Final do AfastamentoPFHSTAFT.DTFINAL
    PFUFERIASPER.DATAFIM    		Data inicio do afastamento ou do gozo das férias. YYYY-MM-DDTHH:MM
    Informar 24:00 quando for o dia integral. Caso não tenha data fim, deverá enviar vazio. A Ahgora irá preencher com da fim 31/12/2050, quando chegar vazio.
    Código interno do AfastamentoCHAVEInformar a chave unica para identificar se irá incluir ou alterar. Verificar se pode ser Coligada + Chapa + Data Inicio.
    Tratativa da Ahgora: Se já existir a chave ele susbstitui, senao inclui.

    3 - EXCLUSÃO DE AFASTAMENTOS

    Campo Tabela RMDescrição AhgoraDescrição / Regra
    PFMOVTEMP.CHAPAmatriculaPode ser alfanumerica
    Campo matrícula
    PFMOVTEMP.ANOCOMPanocomPadrão AAAA
    PFMOVTEMP.MESCOMPmescomPadrão MM
    Ex. Janeiro enviar 01
    -campoAdicionalInformação do campo adicional no PW
    Não é obrigatório
    PFMOVTEMP.;CODEVENTOrubricaSerá cadastrado no PW igual o sistema de destino
    PFMOVTEMP.HORA
    PFMOVTEMP.REF    		referenciaHoras sexagesimal (serparador ",")
    Ex: 1h30min, enviar 1,30
    Dias em número inteiro
    Ex: 3 dias, enviar 3

    ...