Absències

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.

curl -X POST https://api.factuarea.com/v1/companies/$COMPANY_ID/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.

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 de la ruta, 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/companies/$COMPANY_ID/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.

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/companies/$COMPANY_ID/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"
  }'

Flux típic

1. Revisa els tipus sembrats, o crea els teus.
2. Crea polítiques amb una assignació de dies i una meritació, i cobreix els tipus pertinents.
3. Assigna cada política als seus empleats.
4. Els empleats sol·liciten; els managers aproven o rebutgen.
5. 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