Histórico da Página
...
| Totvs custom tabs box | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cadastros Básicos para integração Antes da integração, é necessário que existam cadastros básicos no sistema da Ahgora:
Os códigos deverão ser enviados concatenados com empresa/filial(Quando for exclusiva) e código do registro, exceto para as verbas(SRV) e sindicatos(RCE), que só devem ser enviados com o código do registro sem concatenar empresa e filial.
Para essa extração no protheus, pode ser usada a consulta genérica. Documentação: RH - Linha Protheus - GPE - Consulta de informações em arquivos por Consulta Genérica Exemplo de extração de dados no protheus: Meu cadastro de centro de custo compartilhado entre filiais, ou seja, o campo filial está vazio
Tabela CTT de centro de custo com o campo filial vazio:
O código da empresa que vou utilizar é 01:
Recomendamos gerar a tabela pela rotina 'Consulta Génerica' Caminho no menu: Consultas > Cadastros > Genéricos; Filtramos a tabela CTT de centro de custo e clicamos duas vezes em cima do nome da tabela:
Ao abrir a tabela, é possível ver que a filial está vazia, logo, é uma tabela compartilhada entre filiais. Você pode escolher quais campos quer exportar, após isso, pode gerar o arquivo .CSV
O arquivo deverá ser editado para concatenação da empresa + código do centro de custo conforme esperado pela Ahgora. Para o código desse exemplo deverá ficar empresa + código do centro de custo, uma vez que, o campo filial está vazio. 0110301, 0110304, 0110305. Onde 01 é o código da empresa seguido pelo código do centro de custo.
Exemplo de uma tabela exclusiva por filial. SR6 - Turno de trabalho Veja que ao abrir a consulta genérica dessa tabela, é mostrado o campo filial, logo, o código nesse caso será Empresa + Filial + Código do turno = 0101001
Totvs custom tabs box items |
Menu - Rotina GPEM929Primeiro, devemos adicionar a nova tela ao menu.Como sugestão, posicionar dentro do menu Miscelânea no módulo SIGAGPE
Ao acessar o novo menu criado, abre-se uma nova tela. Nessa nova tela, será exibido o menu para integração dos funcionários, afastamentos e exclusões dos afastamento com a Ahgora
Caso exista alguma divergência, será aberto a tela abaixo mostrando o que falta atualizar ou configurar, a tela de integração só será aberta quando não existir pendências de atualizações e configurações. No exemplo, a porta Multiprotocolo não está habilitada, portanto, a tela de integração não será aberta.
Deck of Cards |
Card |
Para integração com Ahgora, a elegibilidade do ponto é obrigatório, onde será enviado na integração do funcionário, se o ponto dele é obrigatório ou livre. Essa configuração deve ser feita antes da integração dos funcionários. Cadastro do Funcionário - Rotina GPEA010 Para alteração da elegibilidade do ponto do funcionário, onde será informado se ele possuí o ponto obrigatório ou ponto livre, o parâmetro que será usado é o MV_RHAHGOR, com o parâmetro habilitado, ao alterar o cadastro do trabalhador, clicar no menu 'Outras ações' > 'Integração Ahgora', será aberta a tela abaixo. A tela também será aberta na inclusão do funcionário, ao confirmar o cadastro.
Ao salvar, será criado um registro no histórico do trabalhador na tabela SR9, esse registro será usado posteriormente na integração do funcionário com o sistema da Ahgora.
Essa mesma tela será aberta na admissão, e ao salvar o cadastro, o registro da elegibilidade do ponto será criado na SR9 e o registro será criado na RUM. Caso seja cancelado, não será criado histórico na SR9 e o registro não será criado na RUM. Carga Inicial Também foi desenvolvida uma rotina para efetuar a carga inicial referente a elegibilidade do colaborar para o ponto. No cadastro de funcionários, em "Outras Ações", deve ser utilizada a opção "Integração Ponto - Ahgora": Será aberto um wizard onde poderá ser definidos alguns filtros:
E deve ser informado se existe ou não controle de ponto, a data de elegibilidade para o controle, e as filiais que serão processadas:
Card |
Foi efetuado a criação do parâmetro no dicionário SX6, conforme estrutura abaixo: X6_VAR X6_TIPO X6_DESCRIC Exemplo de preenchimento MV_INTEGPW | C | Integrar funcionários com Ahgora. 1=Todos; 2=Somente os que batem ponto; 3=Os que batem ponto mais os responsáveis por departamento isentos de ponto; | 1(Padrão), 2 ou 3 | Funcionamento do parâmetro MV_INTEGPW = 1 Todos os funcionários serão integrados independente se tem o ponto obrigatório ou livre, ou seja, qualquer alteração no funcionário, admissões novas, cálculo de férias, afastamentos, rescisão e transferência, serão gerados registros na tabela de integração RUM. MV_INTEGPW = 2 Apenas os funcionários batem ponto serão integrados. Para integração da ahgora entende-se que os funcionários que batem ponto são aqueles que possuem a elegibilidade do ponto 'Obrigatório', esse dado está na tabela de histórico SR9, campo AHGORA = 1. Veja mais no menu Elegibilidade do Ponto. MV_INTEGPW = 3 Todos os funcionários que batem ponto serão integrados, assim como os funcionários isentos de ponto que ocupam cargos de liderança no departamento. Nesse caso, para os funcionários que possuam o 'Ponto Livre'(SR9 campo AHGORA = 2), será verificado se o mesmo é responsável por algum departamento, caso afirmativo, ele será validado para integração.
Card |
Inicialmente a tela abre vazia esperando que sejam informados os filtros. Na tela inicial o filtro é genérico com filial, admissão de/até e qual status da integração deseja filtrar. Para mais filtros, é necessário acessar a opção de 'Filtros Avançados' Como sugestão, a 'Data Admissão De' vem preenchida com um mês anterior que a data atual e a 'Data Admissão Até' com a data atual. Filtros de 'Filial' e 'Data Admissão De' são obrigatórios.
Filtro 'Filial' aceita multivalores
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 dos funcionários. Apresentação das InformaçõesAo aplicarmos os filtros será apresentada a seguinte tela: Lista de FuncionáriosAo obter a lista de funcionários, temos as colunas:
- 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
Serão listados 100 registros por página, ao final da página será mostrado o botão para carregar mais resultados.
Selecionando um registro para integração.
Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'.
Com o registro com status com legenda laranja, 'Aguardando Retorno', será necessário atualizar o status para que seja feita a consulta com o sistema Ahgora, para que possamos saber se o registro foi aceito ou não.
Ao final da atualização do status, o registro será alterado, nesse caso alterou para 'IN' - Integrado, ou seja, o registro foi integrado com sucesso.
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 pontinhoa na parte direita da tabela.
Status Nesse caso, o retorno do erro para o registro foi o E-mail já cadastrado, erro esse enviado pela Ahgora, ou seja, ela não aceitou o registro, pois o e-mail já está cadastrado em outro funcionário.
Consulta lote A segunda opção é a consulta do lote de envio para o ahgora. Ao abrir a tela do lote, é possível salvar o arquivo .json.
Registros que serão enviados na integração Propriedades Descrição Protheus Observações matricula Matrícula Ahgora Concatenada com Empresa + Filial + RA_MAT | nome Nome do funcionário RA_NOME | pis Pis do funcionário RA_PIS matricula_esocial Matrícula eSocial RA_CODUNIC dataAdmissao Data de admissão RA_ADMISSA dataDemissao Data de demissão RA_DEMISSA localizacoes Localizações Busca a localização por filial na tabela RUL Verifique na seção 'Localizações' neste documento | escala_padrao Turno do funcionário RA_TNOTRAB lastChangeDefaultSchedule Data da troca do turno RUM_DATTUR ctps Carteira de trabalho RA_NUMCP cargo Função do funcionário RA_CODFUNC + Descrição da função departamento Departamento do Funcionário RA_DEPTO + Descrição do departamento sexo Sexo do funcionário RA_SEXO E-mail do funcionário RA_EMAIL cpf CPF do funcionário RA_CIC rg RG do funcionário RA_RG cnpj CNPJ da filial do funcionário M0_CGC dataCnpj Data da transferência do funcionário RUM_DATTRA centroCusto Centro de custo do funcionário RA_CC regimeTrabalho Categoria do funcionário RA_CATFUNC dataNascimento Data de nascimento do funcionário RA_NASC dataCargo Data alteração da função RUM_DATFUN carga_horaria Carga horária mensal RA_HRSMES bate_ponto Elegibilidade do ponto Busca no histórico SR9 data_troca_elegibilidade_ponto Troca da Elegibilidade do ponto Busca no histórico SR9 matricula_chefia Matrícula chefia Busca o gestor do departamento do funcionário Verifique abaixo o exemplo de envio da chefia nome_chefia Nome chefia RA_NOME Verifique abaixo o exemplo de envio da chefia email_chefia E-mail da chefia RA_EMAIL Verifique abaixo o exemplo de envio da chefia codSindicato Código do sindicato RA_SINDICA dataCodSindicato Data da troca do funcionário de sindicato Busca no histórico SR9 telefone Telefone do funcionário RA_TELEFON sem_pis Envio se o funcionário possuí PIS ou não Validação interna custo_da_hora Custo da hora do funcionário RA_SALARIO / RA_HRSMES. Para os Horistas, apenas o RA_SALARIO salario Salário contratual RA_SALARIO codInterno Código Interno do funcionário Empresa + filial + matricula separados por pipe matricula_anterior Matrícula anterior na transferência Concatenada com Empresa + Filial + RA_MAT anterior
Alterações no Protheus Rotinas que irão gravar registros para integração do funcionário na tabela RUM(Lote integração Ahgora):
Ao incluir um funcionário será aberto a tela da elegibilidade do ponto, após escolher e salvar, será gerado um registro na tabela de integração. Ao alterar o cadastro do funcionário, caso seja um campo pertinente para integração com a Ahgora, será gerado um registro na tabela de integração. O registro gerado será do tipo 'A', alteração, porém caso não exista, será criado como inclusão "I". Para transferência, caso exista o registro na tabela de integração, e esse registro ainda não estiver integrado, a transferência será abortada.
Hierarquia/Envio da Chefia No envio do funcionário é possível enviar a chefia dos funcionários, propriedades do json: 'matricula_chefia', 'nome_chefia' e 'email_chefia'. Para envio dessas informações, a integração verifica se o funcionário está alocado em algum departamento, estando alocado será criado a estrutura hierárquica no protheus conforme configuração do parâmetro MV_ORGCFG para busca do responsável pelo departamento. Exemplo de uma estrutura de departamento, onde a base é o departamento Suporte 2 e Suporte, ambos tem como responsável a matricula 000068 e o departamento superior é o departamento Liderança. As chaves Keyini dos departamentos da hierarquia devem estar corretas para a busca dessas informações.
O funcionário 000002 que será integrado está alocado no departamento Suporte 2, logo, a a chefia imediata dele é a matrícula 000068.
Matrícula da chefia na SRA - Cadastro do funcionário
Na integração deste funcionário, será validado a hierarquia e essas informações serão integradas no json do funcionário. A matrícula da chefia também é concatenada com a filial.
Documentação auxiliar: Como configurar a hierarquia por departamentos (MV_ORGCFG=0)
Geração dos liderados na alteração do responsável pelo departamento Foi implementado no sistema a geração dos registros dos liderados na tabela de integração com a Ahgora, quando houver mudança de responsável no departamento. Exemplo 3 funcionários alocados no departamento 000000063
Na alteração do responsável pelo departamento 000000063, será criado os registros dos 3 funcionários na RUM para posterior integração com a Ahgora
RUM com os registros gerados para integração com a Ahgora
Card |
Inicialmente a tela abre vazia esperando que sejam informados os filtros. Na tela inicial o filtro é genérico com filial, afastamento de/até e qual status da integração deseja filtrar. Para mais filtros, é necessário acessar a opção de 'Filtros Avançados' Como sugestão, a 'Data Afastamento De' vem preenchida com um mês anterior que a data atual e a 'Data Afastamento Até' com a data atual. Filtros de 'Filial' e 'Data Afastamento De' são obrigatórios. Apresentação das InformaçõesAo aplicarmos os filtros será apresentada a seguinte tela: Lista de AfastamentosAo obter a lista de afastamentos, temos as colunas:
- 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
O processo de integração e retorno das informações funciona da mesma maneira demostrada na seção 'Integração Funcionários' Registros que serão enviados na integração Propriedades Descrição Protheus Observações matricula Matrícula Ahgora Concatenada com Empresa + Filial + RA_MAT | motivo Tipo do afastamento R8_TIPOAFA | inicio Início do afastamento R8_DATAINI fim Fim do afastamento R8_DATAFIM cod_interno Código interno Empresa + Filial + RA_MAT + R8_SEQ separados por ponto. operation Operação INS Validação interna |
Alterações no Protheus Rotinas que irão gravar registros para integração do afastamento na tabela RUM(Lote integração Ahgora):
Ao incluir uma ausência ou alterar um campo no afastamento pertinente para Ahgora, será gerado um registro na tabela de integração. O registro gerado será do tipo 'A', alteração, porém caso não exista, será criado como inclusão "I".
Card |
Inicialmente a tela abre vazia esperando que sejam informados os filtros. Na tela inicial o filtro é genérico com filial, exclusão de/até e qual status da integração deseja filtrar. Para mais filtros, é necessário acessar a opção de 'Filtros Avançados' Como sugestão, a 'Data Exclusão De' vem preenchida com um mês anterior que a data atual e a 'Data Exclusão Até' com a data atual. Filtros de 'Filial' e 'Data Exclusão De' são obrigatórios. Apresentação das InformaçõesAo aplicarmos os filtros será apresentada a seguinte tela: Lista de AfastamentosAo obter a lista de afastamentos, temos as colunas:
- 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
O processo de integração e retorno das informações funciona da mesma maneira demostrada na seção 'Integração Funcionários' Registros que serão enviados na integração Propriedades Descrição Protheus Observações matricula Matrícula Ahgora Concatenada com Empresa + Filial + RA_MAT | motivo Tipo do afastamento R8_TIPOAFA | inicio Início do afastamento R8_DATAINI fim Fim do afastamento R8_DATAFIM cod_interno Código interno Empresa + Filial + RA_MAT + R8_SEQ separados por ponto. operation Operação DEL Validação interna |
Alterações no Protheus Rotinas que irão gravar registros para integração da exclusão do afastamento na tabela RUM(Lote integração Ahgora):
Ao excluir o afastamento no GPE, será validado se existe o afastamento criado na tabela RUM, e se o mesmo está integrado, caso contrário, essa exclusão não será gerada na tabela de integração; O registro gerado será do tipo 'E', exclusão.
Card |
Também foi disponibilizada a rotina GPEM943 para ser possível agendar no Schedule a realização da integração e consulta das integrações com Ahgora. A rotina pode ser cadastrada no Schedule do módulo SIGACFG - Configurador para efetuar a integração automaticamente, conforme exemplo abaixo:
Exemplo de retorno gerado no console do appserver:
O JOB GPEM943 irá seguir a ordem abaixo: 1 - Serão integrados os funcionários contidos na tabela de integração RUM; 2 - Serão consultados o status da integração dos funcionários; 3 - Serão integrados os afastamentos contidos na tabela de integração RUM; 4 - Serão consultados os status da integração dos afastamentos; 5 - Serão integrados as exclusões dos afastamentos contidos na tabela de integração RUM; 6 - Serão consultados os status da integração das exclusões dos afastamentos; Card |
Localizações - Ahgora A localização é uma propriedade criada no envio do funcionário. Caso não seja definida nenhuma localização, não será enviada a propriedade 'localizacoes' no json do funcionário. Requisitos para cadastro das localizações: Foi efetuado a criação de tabelas no dicionário SX2, conforme estrutura abaixo: X2_CHAVE | X2_NOME | X2_MODO | X2_MODOUN | X2_MODOEMP | RUL | Localizações Ahgora | E | E | E Foi efetuado a criação de campos no dicionário SX3 conforme estrutura abaixo: X3_ARQUIVO | X3_ORDEM | X3_CAMPO | X3_TIPO | X3_TAMANHO | X3_TITULO | X3_DESCRIC | RUL | 01 | RUL_FILIAL | C | 2 | Filial | Filial | RUL | 02 | RUL_IDLOC | C | 16 | ID Local | Id da Localização | RUL | 03 | RUL_USAALL | C | 1 | Usa Filiais | Usado para todas filiais | RUL | 04 | RUL_LOCALI | C | 200 | Localização | Código Localização | RUL | 05 | RUL_USASRA | C | 1 | Usa Campos | Usa Campos Cadastro do funcionário | RUL | 06 | RUL_DATINC | D | 8 | Dt. Inclusão | Data de Inclusão | RUL | 07 | RUL_HORINC | C | 8 | Hr. Inclusão | Hora da Inclusão | RUL | 08 | RUL_USER | C | 40 | Usuário | Usuário do Sitema | Foi efetuado a criação de índices no dicionário SIX conforme estrutura abaixo: INDICE | ORDEM | CHAVE | RUL | 01 | RUL_FILIAL+RUL_IDLOC+DTOS(RUL_DATINC)+RUL_HORINC+RUL_LOCALI | RUL | 02 | RUL_FILIAL+RUL_LOCALI | RUL | 03 | RUL_FILIAL+RUL_IDLOC+RUL_LOCALI | RUL | 04 | RUL_FILIAL+RUL_USAALL+RUL_LOCALI | RUL | 05 | RUL_IDLOC+RUL_USAALL+RUL_LOCALI |
Funcionamento: Ao abrir a tela da integração Ahgora, será mostrado o menu Localizações Ahgora
Ao clicar no menu, será validado se possuí a tabela RUL na base de dados, sendo assim, será mostrado a tela de cadastro de uma nova localização.
Primeiro Campo será filtrado os campos do cadastro do funcionário, tabela SRA. Será permitido selecionar no máximo 4 campos. Quando escolher essa opção, será gravado na tabela RUL os campos escolhidos na ordem de seleção concatenados por pipe, no envio do funcionário, será buscado essa localização, e será verificado o conteúdo dos campos escolhidos para montagem da localização. Exemplo cadastro de localização através dos campos da SRA
Vou escolher dois campos, Filial e um outro campo customizado
Na sequencia vou definir se quero usar para todas as filiais ou se vou querer escolher as filiais específicas. Vou usar apenas para a filial 01
Ao confirmar, o registro será salvo e a tabela recarregada.
No cadastro do funcionário tenho o seguinte conteúdo no campo RA_XLOCAL(Campo customizado), "01TESTE"
Como defini que a minha localização é a junção dos campos RA_FILIAL + RA_XLOCAL, logo, a minha localização será '0101TESTE' No envio do funcionário será criado a localização no json de envio:
Localização Livre Posso criar uma nova localização e utilizar o campo livre, ou seja, o conteúdo do campo será a minha localização. Exemplo Minha localização será 'Localização SP' e defini que ela será usada para todas as filais, ou seja, todos os funcionários integrados levarão essa localização no seu envio. Tabela recarregada com a nova localização
Opção de alteração do funcionário. Ao utilizar essa opção na inclusão da localização com 'Sim', será verificado na tabela de integração RUM, os registros correspondentes a filial da localização, caso exista e esteja com status 6-Integrados, será criado um registro de alteração na RUM para que seja possível enviar o funcionário com a localização criada. Caso deixe com 'Não', o fluxo seguirá com a criação da localização, porém não será criado registro de alteração para funcionários já integrados.
Integração do funcionário. Agora temos duas localizações, uma da filial 01 e a outra para todas as filiais. Na integração do funcionário da filial 01, agora, serão integradas duas localizações no json de envio.
Exclusão Ao selecionar o(s) registro(s), clique em 'Excluir', e confirme.
Após confirmar, será mostrado uma pergunta se deseja criar um registro de alteração para os funcionários. É o mesmo cenário da inclusão, porém, como se trata da exclusão da localização, será realizada uma busca na tabela de integração pelos registros já integrados com status 6. Caso o registro exista, será criada uma alteração para que seja possível enviá-lo novamente, agora sem a localização excluída. Caso responda 'Não', o fluxo seguirá com a exclusão da localização e não será criado registro de alteração para funcionários já integrados.
Localização excluída com sucesso
Totvs custom tabs box items |
Foi efetuado a criação de parâmetros no dicionário SX6, conforme estrutura abaixo: X6_VAR X6_TIPO X6_DESCRIC Exemplo de preenchimento Observações MV_RHAHGOR | L | Habilita a integração de dados do Protheus com do sistema da Ahgora | .T. ou .F. Para gerar informações na tabela RUM a partir das inclusões e alterações dos cadastros dos funcionários e afastamentos do GPE, este parâmetro deve ser habilitado MV_AHGORA1 | C | Usuário de acesso do ambiente de integração do sistema da Ahgora | User de integração do sistema Ahgora disponibilizado pela Ahgora | Para abrir a tela em POUI para integração, este parâmetro deve ser preenchido | MV_AHGORA2 | C | Senha de acesso do ambiente de integração do sistema da Ahgora | Senha de integração do sistema Ahgora disponibilizado pela Ahgora | Para abrir a tela em POUI para integração, este parâmetro deve ser preenchido | MV_INTEGPW | C | Integrar funcionários com Ahgora. 1=Todos; 2=Somente os que batem ponto; 3=Os que batem ponto mais os responsáveis por departamento isentos de ponto; | 1(Padrão), 2 ou 3 | A criação do parâmetro depende da aplicação da atualização liberada no pacote de expedição do módulo RH a partir de 11/04/2025 e da execução do UPDDISTR com o dicionário diferencial para os releases iguais ou superiores a versão 12.1.033
Foi efetuado a criação de tabelas no dicionário SX2, conforme estrutura abaixo: X2_CHAVE | X2_NOME | X2_MODO | X2_MODOUN | X2_MODOEMP | RUM | Lote de integração Ahgora | C | C | C Foi efetuado a criação de campos no dicionário SX3 conforme estrutura abaixo: X3_ARQUIVO | X3_ORDEM | X3_CAMPO | X3_TIPO | X3_TAMANHO | X3_TITULO | X3_DESCRIC | RUM | 01 | RUM_FILIAL | C | 2 | Filial | Filial | RUM | 02 | RUM_FIL | C | 2 | Filial Reg | Filial do Registro | RUM | 03 | RUM_MAT | C | 6 | Matrícula | Matrícula | RUM | 04 | RUM_CODINT | C | 40 | Código Inte. | Código Interno | RUM | 05 | RUM_UNIQUE | C | 15 | Unique ID | Código do processamento | RUM | 06 | RUM_SUBUNQ | C | 15 | Sub Unique | Código Sub Unique | RUM | 07 | RUM_TIPO | C | 1 | Tipo API | Tipo API | RUM | 08 | RUM_STATUS | C | 1 | Status | Status da integração | RUM | 09 | RUM_TAB | C | 3 | Tabela | Tabela que foi manipulada | RUM | 10 | RUM_KEY | C | 200 | Chave Reg. | Chave do Registro | RUM | 11 | RUM_OPER | C | 1 | Operação | Operação | RUM | 12 | RUM_TPINT | C | 1 | Tp. Integra. | Tipo de integração | RUM | 13 | RUM_DATINT | D | 8 | Data Integ. | Data Integração | RUM | 14 | RUM_HORINT | C | 8 | Hora Integ. | Hora da integração | RUM | 15 | RUM_LOTE | M | 10 | Lote | Lote da integração | RUM | 16 | RUM_RETORN | M | 10 | Lote Retorno | Lote de retorno | RUM | 17 | RUM_STAMSN | M | 10 | Msn. Status | Mensagem do Status | RUM | 18 | RUM_SEQAFA | C | 3 | Sequencia | Sequencia Afastamento | RUM | 19 | RUM_DATAIN | D | 8 | Dt. Ini. Afa | Data Afastamento | RUM | 20 | RUM_DATFUN | D | 8 | Dt. Alt. Fun | Data alteração da Função | RUM | 21 | RUM_DATTUR | D | 8 | Dt.Alt Turno | Data alteração do turno | RUM | 22 | RUM_DATTRA | D | 8 | Dt. Alt CNPJ | Data alteração CNPJ | RUM | 23 | RUM_DATMOV | D | 8 | Dt Movimento | Data do movimento | RUM | 24 | RUM_USER | C | 40 | Usuário | Usuário logado | Foi efetuado a criação de índices no dicionário SIX conforme estrutura abaixo: INDICE | ORDEM | CHAVE | RUM | 01 | RUM_FILIAL+RUM_TIPO+RUM_TPINT+RUM_CODINT | RUM | 02 | RUM_FILIAL+RUM_TIPO+RUM_UNIQUE+RUM_SUBUNQ | RUM | 03 | RUM_FILIAL+RUM_FIL+RUM_MAT+RUM_TIPO+RUM_CODINT | RUM | 04 | RUM_FILIAL+RUM_TAB+RUM_OPER+RUM_KEY | RUM | 05 | RUM_FILIAL+RUM_TIPO+RUM_SUBUNQ+RUM_UNIQUE | RUM | 06 | RUM_FILIAL+RUM_KEY | RUM | 07 | RUM_FILIAL+RUM_FIL+RUM_MAT+DTOS(RUM_DATINT)+RUM_HORINT+RUM_CODINT | RUM | 08 | RUM_FILIAL+RUM_TIPO+RUM_OPER+DTOS(RUM_DATMOV)+RUM_CODINT | RUM | 09 | RUM_FILIAL+RUM_OPER+DTOS(RUM_DATAIN)+RUM_CODINT | Foi efetuado a criação de relacionamento no dicionário SX9 conforme estrutura abaixo: X9_DOM | X9_IDENT | X9_CDOM | X9_EXPDOM | X9_EXPCDOM | SRA | 001 | RUM | RA_MAT | RUM_MAT | Aviso |
|
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas