Afastamentos (Absences)


Serviço utilizado para cadastrar. alterar e remover afastamentos do Ahgora PontoWeb.


Permitido envio em lote, máximo 1000 registros por requisição, ou 1mb (mega)


Afastamentos (absences)

Item

Descrição

Fluxo:Cliente → PontoWeb
Rotahttps://api.ahgora.com.br/absences
Método:POST
Afastamentos - Absences
CampoTipoObrig.DescriçãoRegra
matriculaStringSimMatrícula do Funcionário
motivoStringSimMotivo do Afastamento*String do motivo de afastamento cadastrado no PontoWeb
Enviar o Código ou o Motivo, é obrigatória uma das informações
inicioStringSimData e/ou hora Inicial do AfastamentoYYYY-MM-DDTHH:MM
fimStringSimData e/ou hora Final do AfastamentoYYYY-MM-DDTHH:MM (Enviando hora final 2400 corresponde ao dia total)
cod_internoString*SimCódigo interno do Afastamento*Obrigatório para manutenções via integração.
A manutenção da ausência depende do campo 'internalCode', caso o mesmo não seja informado não será possível alterar ou remover a ausência pela integração
Este código é armazenado para servir de chave para alterações no afastamento
operationStringSimAção a ser realizadaINS operação para inserção
ALT para alterar
DEL para remoção da ausência


Exemplos de Requisições (Requests)


Exemplo de corpo da requisição - Inclusão:

[
  {
    "matricula": "00000001",
    "motivo": "Atestado médico",
    "inicio": "2024-01-11T10:00",
    "fim": "2024-01-15T23:00",
    "cod_interno": "w289fdf2",
    "operation": "INS"
  }
]


Exemplo de corpo da requisição - Exclusão:

[
  {
    "matricula": "00000001",
    "motivo": "Atestado médico",
    "inicio": "2024-01-11T10:00",
    "fim": "2024-01-15T23:00",
    "cod_interno": "w289fdf2",
    "operation": "DEL"
  }
]



Exemplos de Retornos (Responses)


Exemplo de resposta quando SUCESSO - Code 200:

{
  "company": "a000101",
  "unique": "bd751350",
  "message": "Absences Integration on progress"
}

Para obter mais detalhe, utilize o serviço Process. Para saber mais entre no link.


Exemplo de ERRO de validação - Code 400:

{
  "message": "Request format must be an Array",
  "code": 400
}


Exemplo de ERRO de autenticação - Code 401:

{
  "message": "Unauthorized",
  "code": 401
}