Versões comparadas

Chave

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

CONTEÚDO

  1. Versões
  2. Visão Geral
  3. Parametrização e Exemplo de utilização
  4. Documentação

01. VERSÕES

Informações
iconfalse

A partir dos patches:

02. VISÃO GERAL

Disponibilizamos um processo nativo no produto em interface no POUI que permite a integração entre a Folha de Pagamento RM e o Ponto Web Ahgora. Através desse processo, é possível integrar três tipos de cadastros:

  • API de Funcionários: Todos os funcionários serão integrados conforme o filtro de seleção, incluindo alterações nos dados cadastrais.
  • API de Afastamento: Serão integrados afastamentos e férias para o sistema da Ahgora, conforme o filtro de seleção.
  • API de Resultados: Toda a movimentação do funcionário existente na Ahgora, como horas extras e faltas, será integrada ao sistema de Folha de Pagamento RM.

03. PARAMETRIZAÇÃO E EXEMPLO DE UTILIZAÇÃO


Deck of Cards
id1
Card
id1
labelParametrização
titleParametrização

1) Acesse o menu Serviços Globais | Segurança | Perfis, selecione o sistema Folha de pagamento, edite o perfil desejado, vá em acesso aos menus e permita o acesso 01.05.01 - Integração Performance e Metas / Feedz:



2) Acesse RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.10 - TOTVS RH Performance e Metas / Feedz selecione a opção Feedz e cadastre os dados para a integração.

3) bate ponto ahgora

3.1 Acesse Administração de Pessoal | Funcionários | Submenu Registros, será apresentada a nova aba "Ahgora", onde você poderá marcar a opção de utilização de ponto (aba só será exibida após a parametrização do item 2).

Image Added

3.2 Acesse o menu Serviços Globais | Segurança | Perfis, e conceda permissão para acesso ao histórico do campo "Ahgora".

Image Added

3.3 Acesse Administração de Pessoal | Funcionários | Anexos | Históricos | Histórico Utiliza Ponto Ahgora, para vusualizar o histórico cadastrado para o campo de utilização do Ponto Web Ahgora.

Image Added





Card
id1
labelParametrização Ahgora
titleParametrização Ahgora

Antes da integração, é necessário que existam cadastros básicos no sistema da Ahgora:

  • Sindicato - Tabela 
  • Turno de trabalho - Tabela 
  • Tipos de afastamentos - Tabela 
  • Eventos- Tabela 







Card
id3
labelDe/Para
titleDe/Para
Card
id3
labelDe/Para
titleDe/Para

1 - PESSOAS

1.1 - DADOS ENVIADOS NO ENDPOINT DE PESSOAS

Campo

Descrição

Campo RM
integrationIdIdentificador único de integração do objeto no sistema de origem com o FeedzPFUNC.CODPESSOA
nameNomePPESSOA.NOME
socialNameNome de preferência PPESSOA.NOMESOCIAL
emailEmailPPESSOA.EMAIL
admissionDateData de admissãoPFUNC.DATAADMISSAO
lastRaiseDateData de último aumentoPFHSTSAL.DATAMUDANCA
birthDateData de aniversárioPPESSOA.DTNASCIMENTO
demissionDateData de demissãoPFUNC.DATADEMISSAO
experienceEndDateData do fim do período de experiênciaPFUNC.FIMPRAZOCONTR
dismissalType

Tipo de demissão:
1 - Pedido de desligamento
2 - Sem justa causa
3 - Com justa causa

DE/PARA:

Caso o tipo de demissão seja  3 - Inic.Empregado com justa causa ou  4 - Inic.Empregado sem justa causa, retorna 1 - Pedido de desligamento.

Caso o tipo de demissão 2 - Inic.Empregador sem justa causa retorna 2 - Sem justa causa.

Caso o tipo de demissão 1  - Inic.Empregador com justa causa, retorna 3 - Com justa causa.

Valores diferentes dos citados acima, retorna  2 - Sem justa causa.

PFUNC.TIPODEMISSAO
hiringTypeIntegrationId

Identificador único de integração do regime de contratação

PFUNC.CODTIPO
departmentIntegrationIdIdentificador único de integração da área da pessoaPFUNC.CODSECAO
positionIntegrationIdIdentificador único de integração do cargo da pessoaPFUNC.CODFUNCAO
positionLevelIntegrationIdIdentificador único de integração do nível cargo da pessoaPFUNC.CODNIVELSAL
facilityIntegrationIdIdentificador único de integração da unidade da pessoaPFUNC.CODFILIAL
managerIntegrationIdIdentificador único de integração do líder imediato da pessoaCódigo da Pessoa do chefe imediato, verificando a estrutura de Chefe/Supervisor
ou Hierarquia por Posição (quando ativada).
registrationChapa do funcionário

PFUNC.CHAPA

cpfCPF do funcionárioPPESSOA.CPF

Retorno


Descrição

Valor stringO retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote


2 - REGISTROS AUXILIARES

2.1 - DADOS ENVIADOS NO ENDPOINT DE CARGOS

Campo

Descrição

Campo RM
integrationIdIdentificador único de integração do objeto no sistema de origem com o FeedzPFUNCAO.CODIGO
nameNomePFUNCAO.NOME
positionGroupIntegrationIdIdentificador único de integração do grupo de cargo do cargoPFUNCAO.CARGO


Retorno


Descrição

Valor string

O retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote


2 - REGISTROS AUXILIARES

2.2 - DADOS ENVIADOS NO ENDPOINT DE UNIDADES

Campo

Descrição

Campo RM
integrationIdIdentificador único de integração do objeto no sistema de origem com o FeedzGFILIAL.CODFILIAL
name

Nome

GFILIAL.NOME


Retorno


Descrição

Valor string

O retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote


2 - REGISTROS AUXILIARES

2.3 - DADOS ENVIADOS NO ENDPOINT DE DEPARTAMENTO

Campo

Descrição

Campo RM
integrationIdIdentificador único de integração do objeto no sistema de origem com o P&MPSECAO.CODIGO
nameNomePSECAO.DESCRICAO


Retorno


Descrição

Valor stringO retorno é uma string que é o identificador do processo que será utilizado no endpoint de consulta para checar o status do processamento do lote
Card
id4
labelErros de validação e seus códigos
titleErros de validação e seus códigos
Card
id3
labelDe/Para
titleDe/Para

Lista de erros de validação e seus códigos

Alguns erros podem acontecer durante o processamento do lote enviado ou durante a validação dos itens do lote enviado, sendo eles:

Código

Mensagem

Detalhes

4998

Id do processo não encontrado

Significa que o processId informado na requisição de consulta de lotes está incorreto.

4999

Ocorreu um erro inesperado!

Representa erros genéricos ou inesperados que podem acontecer no servidor ou que podem ser gerados por algum aspecto incorreto não previsto do lote enviado.

5000

Token inválido ou expirado! / Bearer token não informado.

Isso indica que o token não foi informado na requisição ou informado não é válido. É necessário conferir se o token informado é igual à chave API na plataforma Feedz. Em caso afirmativo, é necessário gerar outra chave.

5000

Body vazio

Significa que foi enviada uma requisição para gravar um lote, mas sem nenhum dado.

5001

O total de itens enviados no corpo da requisição excede o limite de 100 registros. Todos os registros foram ignorados no processamento.

Ocorre ao enviar um lote com mais de 100 registros.

5003

A pessoa NPE (IntegrationId = IDN) está referenciando um gestor que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um gestor que ainda não foi cadastrado.

5004

A pessoa NPE (IntegrationId = IDN) está referenciando ela mesmo como chefe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando ela mesma como gestora (integrationId = managerIntegrationId).

5005

A pessoa NPE (IntegrationId = IDN) está referenciando um departamento que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um departamento que ainda não foi cadastrado.

5006

A pessoa NPE (IntegrationId = IDN) está referenciando uma unidade que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a uma unidade que ainda não foi cadastrada.

5008

A pessoa NPE (IntegrationId = IDN) está referenciando um cargo que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um cargo que ainda não foi cadastrado.

5009

O ID de integração (IntegrationId) é obrigatório e não foi informado para a Pessoa NPE. Essa pessoa não será importada.

Ocorre ao enviar uma pessoa e não informar se id de integração.

5011

O nome (Name) é obrigatório e não foi informado para a Pessoa (IntegrationId = IDN). Essa pessoa não será importada.

Ocorre ao enviar uma pessoa e não informar seu nome.

512

O e-mail (Email) é obrigatório e não foi informado para a Pessoa 'NPE' (IntegrationId = IDN). Essa pessoa não será importada.

Ocorre ao enviar uma pessoa e não informar seu e-mail.

5013

A pessoa 'NPE' (IntegrationId = IDN) possui o mesmo e-mail de outra pessoa da lista de pessoas enviadas ou da base. Essa pessoa não será importada.

Essa validação existe para evitar cadastrar pessoas duplicadas na base. Assim não é possível cadastrar dois e-mails iguais para integrationIds diferentes e vice versa.

5014

A pessoa 'NPE' (IntegrationId = IDN) deve ter o nome digitado somente com caracteres com nome, sobrenome e apenas 1(um) espaço entre eles.

Esse erro ocorre ao informar um nome inválido.

5015

A pessoa 'NPE' (IntegrationId = IDN) não pode ter o apelido igual ao nome.

Ocorre quando o name é igual ao socialName.

5016

O email fornecido 'EML' para a pessoa 'NPE' (IntegrationId = IDN) não está em um formato válido.

Ocorre ao enviar uma pessoa com o e-mail em formato inválido.

5017

O registro com o nome 'NRA' não foi salvo durante o processamento porque o campo 'IntegrationId' não foi informado."

Ocorre ao enviar qualquer registro auxiliar e não informar o integrationId.

5018

O registro com o código 'IDN' não foi salvo durante o processamento porque o campo 'Name' não foi informado.

Ocorre ao enviar qualquer registro auxiliar e não informar o nome.

5030

Quando informado a data de demissão deve ser também informado o motivo (dismissalType).

Ocorre ao enviar data de demissão e não informar o motivo.

5031

Deve ser informado o motivo da demissão (dismissalType) apenas quando for informado a data de demissão.

Ocorre ao enviar motivo da demissão e não informar a data de demissão.

5032

A data de admissão não pode ser maior que a data de demissão.

Ocorre ao enviar uma data de admissão posterior à data de demissão.

5048

O ID de integração do líder (managerIntegrationId = MII) informado para a pessoa (personIntegrationId = IDN) não existe.

Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse líder cadastrado previamente na plataforma.

5049

O ID de integração da pessoa (personIntegrationId = IDN) informada não existe.

Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse colaborador cadastrado previamente na plataforma.

5050

Uma pessoa (personIntegrationId = IDN) não pode ser líder de sí próprio

Ocorre ao tentar vincular uma pessoa a ela mesma como líder (personIntegrationId = managerIntegrationId) através da rota persons-bind.

Card
defaulttrue
id4
labelIntegração
titleIntegração

Através do menu Administração de Pessoal | Integração RM X Ahgora, é possível realizar a integração dos dados , utilizando os filtros disponíveis na tela.

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

TELA

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. 

TELA


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

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ções

Ao aplicarmos os filtros será apresentada a seguinte tela:

Lista de Funcionários

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


04.  DOCUMENTAÇÃO