Árvore de páginas

Versões comparadas

Chave

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

...

        Este método é responsável por importar os resultados do sistema Ahgora, nos lançamentos do funcionário no Protheus.

  • Endpoint:api/rh/v1/v1/ahgora/results
  • Método: POST
  • Autenticação: Basic

...

Deck of Cards
startHiddenfalse
idbody
Card
defaulttrue
idbody1
labelDefinição das propriedades
titleDefinição das propriedades
Campos ProtheusPropriedades APIDescrição
RGB_MATmatriculaMatrícula do funcionário - Matrícula deve ser enviada concatenada sem o pipe: Empresa + Filial + Matricula 
RGB_PERIODanocomAno do período do resultado
RGB_PERIODmescomMês do período do resultado
RGB_SEMANAsemanacampoAdicionalPara o protheus será tratado para verificar a semana Semana do período

codfuncionarioCódigo do funcionário separado por pipe contendo Empresa + Filial + Matrícula
RGB_PDrubricaCódigo da verba do funcionário 
RGB_HORASreferenciaReferência em horas ou dia da verba
RGB_DTREFdatafaltaData da falta


Informações
titleImportante
  • Envio do atributo 'datafalta'  vazio, será assumido o primeiro dia do período que está sendo processado, todas as verbas serão gravadas com referência.
  • Para o atributo 'campoAdicional', para o protheus será usado para enviar a semana do período, caso seja enviado vazio, será assumido a semana aberta do período em questão.
  • Caso ocorra um segundo envio do resultado para o funcionário no mesmo período, o primeiro envio do resultado será deletado da tabela RGB, e será gravado apenas o último envio.
Card
idbody2
labelBody
titleBody
Bloco de código
languagecpp
themeConfluence
titleBody
{
  "items": [
    {
      "matricula": "0000010101000001",
      "anocom": "2024",
      "mescom": "08",
      "semanacampoAdicional": "1",
      "codfuncionario": "01|01|000001",
      "resultados": [
        {
          "rubrica": "114",
          "referencia": "1,30",
          "datafalta": ""
        }
      ]
    }
  ]
}

...

Deck of Cards
startHiddenfalse
idretorno
Card
defaulttrue
id200ok
label200 - OK
titleSucesso
Propriedades APIDescrição
matriculaMatrícula do funcionário  concatenada por Empresa + Filial + Matricula
rubricaVerba processada
statusStatus 'S'(Sucesso) ou 'E'(Erro)
mensagemDetalhe da mensagem
referenciaReferência da rubrica
datafaltaData da falta quando houver


Retorno status 'S'

Bloco de código
languagecpp
themeConfluence
titleRetorno status 'S'Operação realizada com sucesso!
{
  "response": [
    {
      "resultados": [
        {
          "matricula": "0000010101000001",
          "rubrica": "114",
          "status": "S",
          "mensagem": "Operação realizada com sucesso!",
          "referencia": "1",
          "datafalta": "20240722" 
        }        }
      ]
    }
  ]
}


Retorno status 'E' 

Bloco de código
languagecpp
themeConfluence
titleRetorno status 'E'Verba não encontrada na base de dados
{
  "response": [
    {
      "resultados": [
        {
          "matricula": "0000010101000001",
          "rubrica": "ASD",
          "status": "E",
          "mensagem": "Verba não encontrada na base de dados.",
		  "referencia": "1",
          "datafalta": ""  
         }
      ]
    }
  ]
}
Card
id400bas
label400 - Solicitação inválida
titleBody



Propriedades APIDescrição
empresaCódigo da empresa
filialFilial do funcionário
userUsuário do sistema
matriculaMatrícula do funcionário
periodoAno/Mês do Período
semanaSemana do período
processoCódigo do processo do período
roteiroRoteiro de cálculo do período
mensagemDetalhe da mensagem
Bloco de código
languagecpp
themeConfluence
titleRetorno funcionário não encontrada na base de dados
{
  "response": [
    {
      "resultados": [
        {
          "matricula": "0101XXXXXX",
          "rubrica": "001",
          "status": "E",
          "mensagem": "Funcionário não localizado na base de dados.",
   "filial       "referencia": "D MG 01 ",
  "matricula": "XXXXX",
  "message1",
          "datafalta": "20240722"  
        },
        {
          "matricula": "0101XXXXXX",
          "rubrica": "001",
          "status": "E",
          "mensagem": "Funcionário não localizado na base de dados.",
          "referencia": "1",
          "datafalta": "20240723"           
        }
      ]
    }
  ]
}
Bloco de código
languagecpp
themeConfluence
titleRetorno de usuário sem permissão de acesso
{
  "response": [
    {
      "resultados": [
        {
          "matricula": "0101000001",
          "rubrica": "Z52",
          "status": "E",
          "mensagem": "Usuário sem permissão de acesso na Empresa/Filial.",
   "empresa       "referencia": "T21",
          "datafalta": ""  
   "filial     },
        {
          "matricula": "D MG 01 ",
  "user0101000001",
          "rubrica": "Z53",
          "status": "ahgoraE",
           "messagemensagem": "Usuário sem permissão de acesso na Empresa/Filial.",
		  "referencia": "1",
          "datafalta": ""  
        }
      ]
    }
  ]
}
Bloco de código
languagecpp
themeConfluence
titleRetorno de empresa/filial inexistente na base de dados
{
  "empresa  "response": [
    {
      "resultados": [
        {
          "matricula": "Z10101000001",
           "filialrubrica": "D MG 01 ",
  "message"Z52",
          "status": "E",
          "mensagem": "Empresa/Filial não encontradas na base de dados.",
          "referencia": "1",
          "datafalta": ""  
        }
      ]
    }
  ]
}
Bloco de código
languagecpp
themeConfluence
titleRetorno de usuário sem acesso a filial processadaperíodo do processamento não encontrado ou fechado
{
  "empresaresponse": "T1",
  "filial": "D MG 02 ",
  "user": "ahgora",
  "message": "Usuário sem permissão de acesso na filial."
}
Bloco de código
languagecpp
themeConfluence
titleRetorno de período do processamento não encontrado ou fechado
{
  "periodo": "202403",
  "semana": "01",
  "processo": "02117",
  "roteiro": "FOL",
  "message[
    {
      "resultados": [
        {
          "matricula": "0101000001",
          "rubrica": "202",
          "status": "E",
          "mensagem": "Período/Semana não encontrados na base de dados ou o período está fechado. Necessário verificar o cadastro de períodos!",
          "referencia": "1",
          "datafalta": "20240722" 
        },
        {
          "matricula": "0101000002",
          "rubrica": "203",
          "status": "E",
          "mensagem": "Período/Semana não encontrados na base de dados ou o período está fechado. Necessário verificar o cadastro de períodos!"
		  "referencia": "1",
          "datafalta": ""  
        }
      ]
    }
  ]
}
Bloco de código
languagecpp
themeConfluence
titleRetorno de limite de lançamentos diários para a mesma verba
{
  "response": [
    {
      "resultados": [
        {
          "matricula": "T2D MG 02 600528",
          "rubrica": "003",
          "status": "S",
          "mensagem": "Operação realizada com sucesso!",
          "referencia": "1,30",
          "datafalta": ""
        },
        {
          "matricula": "T2D MG 02 600528",
          "rubrica": "003",
          "status": "E",
          "mensagem": "Verba ultrapassou o limite de lançamentos diários, verificar o cadastro da verba.",
          "referencia": "1,30",
          "datafalta": "20220102"
        },
        {
          "matricula": "T2D MG 02 600528",
          "rubrica": "003",
          "status": "E",
          "mensagem": "Verba ultrapassou o limite de lançamentos diários, verificar o cadastro da verba.",
          "referencia": "1,30",
          "datafalta": "20220103"
        }
      ]
    }
  ]
}
Card
id400bas
label400 - Solicitação inválida
titleBody
Bloco de código
languagecpp
themeConfluence
{
  "code": 400,
  "message": "Não foi enviado nenhum registro na requisição para ser gravado."
}

04. DEMAIS INFORMAÇÕES

...