Factuarea APIDevelopers
Contracte

Un empleat donat de baixa és de només lectura

Fitxar l'entrada, assignar un horari o una política d'absències, aprovar una absència que passa de la baixa i convidar al portal un empleat donat de baixa responen 422 amb el subcode employee_inactive. El resum d'equip llista tot empleat d'alta durant el mes, tingui horari o no.

31 d'octubre de 2026 — Un empleat donat de baixa (status inactive) és ara de només lectura: les seves dades es conserven i es consulten, però ja no admet operacions noves. Les sis operacions de la taula responen 422 business_rule_violation amb el subcode employee_inactive i no escriuen res. Cap operació canvia per a un empleat en actiu i no se'n retira cap.

Operacions d'aquesta versió

OperacióoperationIdEina MCPQuè canvia
POST /v1/companies/{company}/time-entries/clock-inpublic-api.v1.time_entries.clock_inclock_inUn empleat de baixa no fitxa l'entrada, ni tan sols el dia de la seva baixa. Un instant posterior a la baixa continua responent clocking_outside_employment_period.
POST /v1/companies/{company}/work-schedules/{schedule}/assignpublic-api.v1.work_schedules.assignassign_work_scheduleNo s'assigna un horari a un empleat de baixa.
POST /v1/companies/{company}/absence-policies/{absence_policy}/assignpublic-api.v1.absence-policies.assignassign_absence_policyNo s'assigna una política a un empleat de baixa; amb diversos empleats no s'assigna a ningú.
POST /v1/companies/{company}/absence-requests/{absence_request}/approvepublic-api.v1.absence-requests.approveapprove_absence_requestUna absència que acaba després de la data de baixa no s'aprova i continua pending.
POST /v1/companies/{company}/employee-invitationspublic-api.v1.employee-invitations.sendsend_employee_invitationNo es convida al portal l'email d'un empleat de baixa (param email).
POST /v1/companies/{company}/employee-invitations/{invitation}/resendpublic-api.v1.employee-invitations.resendresend_employee_invitationTampoc es reenvia la seva invitació.
GET /v1/companies/{company}/time-balances/team-summarypublic-api.v1.time_balances.team_summaryget_team_time_balance_summaryUna fila per empleat d'alta algun dia del mes, amb o sense horari o compte del portal.

Empleat de baixa

{
  "error": {
    "type": "invalid_request_error",
    "code": "business_rule_violation",
    "subcode": "employee_inactive",
    "message": "El empleado está de baja y no puede fichar la entrada. Si sigue trabajando, reactívalo antes.",
    "param": "employee_id",
    "doc_url": "https://docs.factuarea.com/guides/errors#business_rule_violation",
    "request_id": "req_01HKQS5NTIMEEMPINACTIVE03"
  }
}

Continuen permesos consultar les seves dades, els seus fitxatges i les seves absències, editar la seva fitxa, anotar a mà o corregir els dies en què va estar d'alta mentre el mes no estigui tancat (POST /v1/companies/{company}/time-entries/manual), pausar, reprendre i fitxar la sortida d'una jornada que ja tingués oberta, tancar el mes, rebutjar o cancel·lar les seves absències i desassignar-li un horari o una política. Reactivar-lo amb POST /v1/companies/{company}/employees/{employee}/reactivate li torna tot. A més, l'usuari del seu portal perd l'accés a aquesta empresa. Consulta l'error.

Què cal fer. Ramifica per error.subcode. Si la persona continua treballant, reactiva-la abans de repetir la crida; si una integració bolca fitxatges endarrerits d'algú que ja va causar baixa, envia'ls com a fitxatge manual dels dies en què va estar d'alta.

Resum d'equip

GET /v1/companies/{company}/time-balances/team-summary llista ara tot empleat amb algun dia d'alta al mes, els mateixos que congela el tancament mensual. Abans només hi sortien els empleats en actiu amb un horari vigent i un compte del portal. Sense horari, els seus dies compten 0 minuts previstos i no generen avisos; el donat de baixa dins del mes hi apareix amb els dies fins a la seva baixa. La forma de cada fila no canvia.

En aquesta pàgina

Et donem un cop de mà?Contactar amb suport