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
Rota	https://api.ahgora.com.br/absences
Método:	POST

Afastamentos - Absences
Campo	Tipo	Obrig.	Descrição	Regra
matricula	String	Sim	Matrícula do Funcionário
motivo	String	Sim	Motivo do Afastamento	*String do motivo de afastamento cadastrado no PontoWeb Enviar o Código ou o Motivo, é obrigatória uma das informações
inicio	String	Sim	Data e/ou hora Inicial do Afastamento	YYYY-MM-DDTHH:MM
fim	String	Sim	Data e/ou hora Final do Afastamento	YYYY-MM-DDTHH:MM (Enviando hora final 24:00 corresponde ao dia total)
cod_interno	String	*Sim	Código interno do Afastamento	*Obrigatório para manutenções via integração. Este campo é chave para acessar o registro. A manutenção da ausência depende deste campo, caso o mesmo não seja informado não será possível alterar ou remover a ausência pela integração. Ele deve ser único para todos os afastamentos cadastrados pela integração.
operation	String	Sim	Ação a ser realizada	INS operação para inserção ALT para alterar DEL para remoção da ausência
ignora_bloqueio	String	Não	Ignora bloqueios de períodos	Ignora o bloqueio de apurações. Se o período de apuração onde o afastamento tem interferência, estiver bloqueado, utilize o "ignora_bloqueio" para alterar dados do afastamento. Caso deseje inserir um afastamento em um período bloqueado, também pode utiliza-lo. 0 = false (default quando o campo não é enviado) 1 = true Obs: Ele só vai interferir na apuração da competência bloqueada se o período for desbloqueado. Exemplo: Um afastamento de doença, inserido em 10/10/2000 se ele retornasse ao trabalho dia 05/05/2025 , se os períodos anteriores estiverem bloqueados, deve-se utilizar o "ignora_bloqueio" = "1". Caso não utilize e os períodos anteriores estiverem bloqueados, não será permitido alterar.

Exemplos de Requisições (Requests)

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"
  }
]

Corpo da Requisição - Alteração:

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

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)

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.

ERRO de Validação - Code 400:

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

ERRO de Autenticação - Code 401:

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

ERRO de Permissão - Code 403:

{
    "error": {
        "message": "Forbidden",
        "code": 403
    }
}

Observação: Verificar as permissões do usuário para acessar a rota/serviço.

Absences

Service used to register, change and remove leave from Ahgora PontoWeb.

Batch sending allowed, maximum 1000 records per request, or 1mb (mega)

Afastamentos (absences)

Item	Description
Flow:	Client → PontoWeb
Route	https://api.ahgora.com.br/absences
Method:	POST

Absences
Field	Type	Required	Description	Rule
matricula	String	Yes	Employee's registration
motivo	String	Yes	Reason for absence	*String of the leave reason registered in PontoWeb Send the Code or Reason, one of the following is mandatory
inicio	String	Yes	Start date and/or time of absence	Expected format: "YYYY-MM-DDTHH:MM"
fim	String	Yes	End date and/or time of absence	Expected formta: "YYYY-MM-DDTHH:MM" (Sending end time 24:00 corresponds to the total day)
cod_interno	String	Yes*	Internal code for absence	*Mandatory for maintenance via integration. This field is key to accessing the record. Maintenance of the absence depends on this field; if it is not entered, it will not be possible to change or remove the absence via the integration. It must be unique for all absences registered via the integration.
operation	String	Yes	Action to be taken	INS (insertion operation) ALT (to alter) DEL (to remove the absence)

Requests examples:

Body Request - Inclusion:

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

Body Resquest - Exclusion:

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

Responses examples:

Response when SUCCESS - Code 200:

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

For more details, use the Process service. To find out more, click here.

Validation ERROR - Code 400:

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

Authentication ERROR - Code 401:

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

Permission ERROR - Code 403:

{
    "error": {
        "message": "Forbidden",
        "code": 403
    }
}

Note: Check the user's permissions to access the route/service.