Absències
Configura tipus i polítiques d'absència, gestiona les sol·licituds i llegeix els saldos i el calendari d'equip sobre l'API v1.
El domini d'absències té dues capes: una capa de configuració (què es pot
sol·licitar i quant) i una capa de flux (sol·licituds, saldos i calendari).
Tot està acotat per absences:read / absences:write i gatejat pel mòdul
control_horario, sota https://api.factuarea.com/v1.
Tipus d'absència
Un tipus d'absència és el que un empleat pot sol·licitar — vacances, baixa per
malaltia, un dia d'assumptes propis. Cada tipus porta: si és retribuït
(is_paid), si requereix aprovació (requires_approval), una unitat de
mesura (days o hours), un color hex, una visibilitat (everyone o
managers_only) i un estat (active / archived). El nom és únic per empresa. A
cada empresa nova es sembra un conjunt de tipus espanyols per defecte, així
que sovint arrenques amb un catàleg funcional.
| Operació | Endpoint |
|---|---|
| Llistar / detall | GET /v1/absence-types, GET /v1/absence-types/{type} |
| Crear / actualitzar | POST /v1/absence-types, PATCH /v1/absence-types/{type} |
| Arxivar / desarxivar | POST /v1/absence-types/{type}/archive, .../unarchive |
curl -X POST https://api.factuarea.com/v1/absence-types \
-H "Authorization: Bearer $FACTUAREA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Assumptes propis",
"is_paid": true,
"requires_approval": true,
"measurement_unit": "days",
"color": "#4F46E5",
"visibility": "everyone"
}'Polítiques d'absència
Una política d'absència decideix quant i per a qui. Fixa una
assignació de dies — limited (un nombre positiu de dies) o unlimited —, un
mètode de meritació (annual o monthly), el conjunt de tipus que cobreix
i els empleats als quals s'assigna. Associar tipus és un reemplaçament total;
una política s'assigna i es desassigna d'empleats en lot.
| Operació | Endpoint |
|---|---|
| Llistar / detall | GET /v1/absence-policies, GET /v1/absence-policies/{policy} |
| Crear / actualitzar | POST /v1/absence-policies, PATCH /v1/absence-policies/{policy} |
| Assignar / desassignar empleats | POST /v1/absence-policies/{policy}/assign, .../unassign |
| Llistar assignacions | GET /v1/absence-policies/{policy}/assignments |
| Arrossegament | GET /v1/absence-policies/{policy}/carryover |
| Arxivar / desarxivar | POST /v1/absence-policies/{policy}/archive, .../unarchive |
L'arrossegament exposa quanta assignació no consumida passa al següent període de meritació per empleat. L'assignació sempre resol l'empleat dins de l'empresa autenticada, així que una política de l'empresa A mai s'assigna a un empleat de l'empresa B.
curl -X POST https://api.factuarea.com/v1/absence-policies \
-H "Authorization: Bearer $FACTUAREA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Estàndard 22 dies",
"allowance": { "type": "limited", "days": 22 },
"accrual_method": "annual",
"absence_type_ids": ["01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0b"]
}'Sol·licituds, saldos i calendari
Quan existeixen tipus i polítiques, els empleats sol·liciten absències i els managers les resolen.
| Operació | Endpoint | Scope |
|---|---|---|
| Crear una sol·licitud | POST /v1/absence-requests | absences:write |
| Aprovar / rebutjar | POST /v1/absence-requests/{request}/approve, .../reject | absences:write |
| Cancel·lar | POST /v1/absence-requests/{request}/cancel | absences:write |
| Llistar / detall | GET /v1/absence-requests, GET /v1/absence-requests/{request} | absences:read |
| Saldos | GET /v1/absence-balances, GET /v1/absence-balances/{employee} | absences:read |
| Calendari d'equip | GET /v1/absence-calendar | absences:read |
Un saldo és l'assignació restant per empleat i tipus, derivada de la meritació de la política menys les sol·licituds aprovades. El calendari retorna les absències de l'equip en un rang de dates — la vista del manager de qui és fora i quan.
curl -X POST https://api.factuarea.com/v1/absence-requests \
-H "Authorization: Bearer $FACTUAREA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0b",
"absence_type_id": "01931b3e-7c4a-7f2e-9a8b-4d6e7f8a9b0c",
"start_date": "2026-08-01",
"end_date": "2026-08-15"
}'Un tipus amb requires_approval: false es concedeix en sol·licitar-lo; un amb
requires_approval: true espera que un manager l'aprovi o el rebutgi abans de
descomptar-lo del saldo.
Flux típic
- Revisa els tipus sembrats, o crea els teus.
- Crea polítiques amb una assignació de dies i una meritació, i cobreix els tipus pertinents.
- Assigna cada política als seus empleats.
- Els empleats sol·liciten; els managers aproven o rebutgen.
- Llegeix saldos i el calendari, i consulta l'arrossegament al tancament de l'any.
Els festius que afecten les absències viuen al seu propi domini de només lectura — consulta la visió general i la referència de festius.
Pròxims passos
- Tancament mensual — les absències aprovades alimenten l'informe mensual.
- Navega la referència de tipus, polítiques i sol·licituds.