Pular para o conteúdo principal

Linha Pessoal - Configuração de Serviços

Esta seção contém todos os guias de configuração para os serviços orquestrados da Linha Pessoal.


Contracheque

Nome da Crítica Orquestrada

Contracheque

📋 Descrição do Serviço

Permite a consulta e download de contracheques mensais por servidores públicos. O servidor pode visualizar seus holerites com detalhamento de proventos, descontos, base de cálculo e valor líquido recebido, facilitando o acompanhamento da remuneração mensal.

Configuração Inicial

Passo 1: Configure a Crítica de Atendimento

  1. Acesse a área de críticas de atendimento
  2. Adicione as tags necessárias
  3. Defina a natureza como "Atendimento" na crítica que será utilizada

Passo 2: Adicione a Tag ao Menu

  1. Certifique-se de que a tag utilizada na crítica está configurada no menu do sistema
  2. Isso garantirá que o atendimento fique acessível aos usuários

Variável de Ambiente Necessária

Para habilitar a emissão de Contracheques, você precisará configurar 1 variável de ambiente:

Variável do Relatório de Contracheque

CampoValor
ChaveMINHAFOLHA_HOLERITE
Valor[Identificador do relatório de contracheque]

Como obter o identificador do relatório:

  1. Acesse o Portal do Desenvolvedor em https://beth.betha.cloud/desenvolvedor
  2. Selecione a opção MINHA FOLHA
  3. Localize o relatório Contracheque/Holerite
  4. Copie o identificador
  5. Não remova o número e barra do início (ex: 58/abc...)
🚨 Atenção ao Formato do Identificador

Mantenha o identificador no formato completo copiado do Portal do Desenvolvedor, incluindo o número e barra (ex: 58/a7c39abf-5629-4786-9b6b-ee0ff1a60c8f).


✅ Configuração Concluída

Pronto! A variável de ambiente foi configurada e o atendimento de Contracheque está pronto para uso.

Solução de Problemas

❌ Erro: "Variável não configurada"

Causa: A variável de ambiente não foi definida corretamente.

Solução:

  • Verifique se a variável MINHAFOLHA_HOLERITE foi criada
  • Confirme que o nome da variável está correto (sem espaços)
  • Verifique se o identificador está correto

❌ Erro: "Relatório está com parâmetros incorretos"

Causa: O seu relatório pode solicitar algum parâmetro a mais ou com nomes diferentes.

Solução:

  • Verifique se manteve o número e barra do início do identificador
  • Certifique-se de que copiou o identificador da seção MINHA FOLHA
  • Teste o relatório manualmente no sistema antes de configurar
  • Veja no relatório os parâmetros que ele utiliza e quais você precisa alterar/adicionar

Comprovante de Rendimentos

Nome da Crítica Orquestrada

Comprovante de Rendimentos

📋 Descrição do Serviço

Permite a emissão de comprovante anual de rendimentos para declaração de Imposto de Renda. O documento apresenta o detalhamento completo dos rendimentos recebidos pelo servidor durante o ano-calendário, incluindo rendimentos tributáveis, isentos e não tributáveis, contribuições previdenciárias e imposto de renda retido na fonte.

Configuração Inicial

Passo 1: Configure a Crítica de Atendimento

  1. Acesse a área de críticas de atendimento
  2. Adicione as tags necessárias
  3. Defina a natureza como "Atendimento" na crítica que será utilizada

Passo 2: Adicione a Tag ao Menu

  1. Certifique-se de que a tag utilizada na crítica está configurada no menu do sistema
  2. Isso garantirá que o atendimento fique acessível aos usuários

Variável de Ambiente Necessária

Para habilitar a emissão de Comprovante de Rendimentos, você precisará configurar 1 variável de ambiente:

Variável do Relatório de Comprovante de Rendimentos

CampoValor
ChaveFOLHA_COMPROVANTERENDIMENTOS
Valor[Identificador do relatório de comprovante de rendimentos]

Como obter o identificador do relatório:

  1. Acesse o Portal do Desenvolvedor em https://beth.betha.cloud/desenvolvedor
  2. Selecione a opção FOLHA
  3. Localize o relatório Comprovante de Rendimentos
  4. Copie o identificador
  5. Não remova o número e barra do início (ex: 58/abc...)
🚨 Atenção ao Formato do Identificador

Mantenha o identificador no formato completo copiado do Portal do Desenvolvedor, incluindo o número e barra (ex: 58/a7c39abf-5629-4786-9b6b-ee0ff1a60c8f).


✅ Configuração Concluída

Pronto! A variável de ambiente foi configurada e o atendimento de Comprovante de Rendimentos está pronto para uso.

Solução de Problemas

❌ Erro: "Variável não configurada"

Causa: A variável de ambiente não foi definida corretamente.

Solução:

  • Verifique se a variável FOLHA_COMPROVANTERENDIMENTOS foi criada
  • Confirme que o nome da variável está correto (sem espaços)
  • Verifique se o identificador está correto

❌ Erro: "Relatório está com parâmetros incorretos"

Causa: O seu relatório pode solicitar algum parâmetro a mais ou com nomes diferentes.

Solução:

  • Verifique se manteve o número e barra do início do identificador
  • Certifique-se de que copiou o identificador da seção FOLHA
  • Teste o relatório manualmente no sistema antes de configurar
  • Veja no relatório os parâmetros que ele utiliza e quais você precisa alterar/adicionar

Tempo de Serviço

Nome da Crítica Orquestrada

Tempo de Serviço

📋 Descrição do Serviço

Permite a emissão de certidão de tempo de contribuição e tempo de serviço. O documento apresenta o histórico de vínculos do servidor, períodos trabalhados, tempo de contribuição previdenciária e outras informações necessárias para fins de aposentadoria, averbação ou comprovação de tempo de serviço.

Configuração Inicial

Passo 1: Configure a Crítica de Atendimento

  1. Acesse a área de críticas de atendimento
  2. Adicione as tags necessárias
  3. Defina a natureza como "Atendimento" na crítica que será utilizada

Passo 2: Adicione a Tag ao Menu

  1. Certifique-se de que a tag utilizada na crítica está configurada no menu do sistema
  2. Isso garantirá que o atendimento fique acessível aos usuários

Variável de Ambiente Necessária

Para habilitar a emissão de Tempo de Serviço, você precisará configurar 1 variável de ambiente, dependendo do sistema que possui o relatório:

Opção 1: Relatório do Sistema RH

Se o seu relatório está cadastrado no sistema RH:

CampoValor
ChaveRH_TEMPODESERVICO
Valor[Identificador do relatório de tempo de serviço]

Como obter o identificador do relatório:

  1. Acesse o Portal do Desenvolvedor em https://beth.betha.cloud/desenvolvedor
  2. Selecione a opção RH
  3. Localize o relatório Tempo de Serviço
  4. Copie o identificador
  5. Não remova o número e barra do início (ex: 58/abc...)

Opção 2: Relatório do Sistema FOLHA

Se o seu relatório está cadastrado no sistema FOLHA:

CampoValor
ChaveFOLHA_TEMPODECONTRIBUICAO
Valor[Identificador do relatório de tempo de contribuição]

Como obter o identificador do relatório:

  1. Acesse o Portal do Desenvolvedor em https://beth.betha.cloud/desenvolvedor
  2. Selecione a opção FOLHA
  3. Localize o relatório Tempo de Contribuição
  4. Copie o identificador
  5. Não remova o número e barra do início (ex: 58/abc...)
🚨 Atenção ao Formato do Identificador

Mantenha o identificador no formato completo copiado do Portal do Desenvolvedor, incluindo o número e barra (ex: 58/a7c39abf-5629-4786-9b6b-ee0ff1a60c8f).

💡 Qual opção escolher?

Configure apenas uma das variáveis acima, dependendo de qual sistema (RH ou FOLHA) possui o relatório de tempo de serviço/contribuição cadastrado em sua entidade.


✅ Configuração Concluída

Pronto! A variável de ambiente foi configurada e o atendimento de Tempo de Serviço está pronto para uso.

Solução de Problemas

❌ Erro: "Variável não configurada"

Causa: A variável de ambiente não foi definida corretamente.

Solução:

  • Verifique se a variável RH_TEMPODESERVICO ou FOLHA_TEMPODECONTRIBUICAO foi criada
  • Confirme que o nome da variável está correto (sem espaços)
  • Verifique se o identificador está correto

❌ Erro: "Relatório está com parâmetros incorretos"

Causa: O seu relatório pode solicitar algum parâmetro a mais ou com nomes diferentes.

Solução:

  • Verifique se manteve o número e barra do início do identificador
  • Certifique-se de que copiou o identificador da seção correta (RH ou FOLHA)
  • Confirme que está usando a variável correspondente ao sistema do relatório
  • Teste o relatório manualmente no sistema antes de configurar
  • Veja no relatório os parâmetros que ele utiliza e quais você precisa alterar/adicionar

← Voltar para Serviços Orquestrados