fiscalisto 0.1.61 → 0.1.63

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/core.d.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * llamar.
5
5
  */
6
6
  import type { ErrorCode } from "./error-codes.js";
7
- export declare const VERSION = "0.1.61";
7
+ export declare const VERSION = "0.1.63";
8
8
  /**
9
9
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
10
10
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
package/dist/core.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * errores y las listas que se recorren solas. Los recursos (generated.ts) solo dicen qué ruta
4
4
  * llamar.
5
5
  */
6
- export const VERSION = "0.1.61";
6
+ export const VERSION = "0.1.63";
7
7
  /**
8
8
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
9
9
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
@@ -80,6 +80,10 @@ export interface AttendanceReport {
80
80
  from: string;
81
81
  /** Último día del periodo, AAAA-MM-DD. */
82
82
  to: string;
83
+ /** true: las horas extra cuentan solo hasta lo que la empresa autorizó cada día. */
84
+ overtime_approval: boolean;
85
+ /** Cómo llegan las horas extra a la nómina: approval (necesitan autorización), all (cuentan todas) o none (no hay horas extra: quedan en el registro y nunca cuentan). */
86
+ overtime_policy: "approval" | "all" | "none";
83
87
  /** Cada empleado del emisor en el periodo. */
84
88
  employees: {
85
89
  /** El empleado (emp_…). */
@@ -112,6 +116,12 @@ export interface AttendanceReport {
112
116
  overtime_double_minutes: number;
113
117
  /** Horas extra que se pagan triples (las que pasan del límite de la semana). */
114
118
  overtime_triple_minutes: number;
119
+ /** Todos los minutos de más en el registro, autorizados o no. */
120
+ overtime_minutes: number;
121
+ /** Minutos de más que nadie autorizó: quedan en el registro y no cuentan para la nómina. */
122
+ unapproved_overtime_minutes: number;
123
+ /** Minutos de más que la empresa rechazó: quedan en el registro, no cuentan para la nómina y ya no están por autorizar. */
124
+ rejected_overtime_minutes: number;
115
125
  /** Días de descanso en que trabajó. */
116
126
  rest_days_worked: number;
117
127
  /** Días festivos en que trabajó. */
@@ -146,6 +156,10 @@ export interface AttendanceReport {
146
156
  late_minutes: number;
147
157
  /** Minutos de más ese día (horas extra). */
148
158
  overtime_minutes: number;
159
+ /** De esos, los que cuentan para la nómina: con overtime_policy approval, hasta lo autorizado ese día; con all, todos; con none, ninguno. */
160
+ approved_overtime_minutes: number;
161
+ /** De esos, los que la empresa rechazó ese día: no cuentan para la nómina. */
162
+ rejected_overtime_minutes: number;
149
163
  /** La nota del día que puso la empresa, o null. */
150
164
  note: "vacaciones" | "incapacidad" | "permiso_con_goce" | "permiso_sin_goce" | "descanso" | "festivo" | "falta" | null;
151
165
  /** El nombre del día festivo, o null. */
@@ -155,6 +169,23 @@ export interface AttendanceReport {
155
169
  marks: AttendanceMark[] | null;
156
170
  }[];
157
171
  }
172
+ /** Las horas extra que la empresa autorizó o rechazó para un día de un empleado, antes o después de ese día. */
173
+ export interface AttendanceOvertime {
174
+ /** Qué tipo de objeto es («invoice», «customer»…). */
175
+ object: "attendance_overtime";
176
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
177
+ livemode: boolean;
178
+ /** El empleado (emp_…). */
179
+ employee: string;
180
+ /** El día, AAAA-MM-DD. */
181
+ date: string;
182
+ /** Hasta cuántos minutos de horas extra de ese día cuentan para la nómina (0 si se rechazaron); null: sin decisión. */
183
+ minutes: number | null;
184
+ /** true: la empresa rechazó las horas extra de ese día. */
185
+ rejected: boolean;
186
+ /** Por qué, o null. */
187
+ comment: string | null;
188
+ }
158
189
  /** Timbres de producción de la cuenta, por paquete, el que vence antes primero. */
159
190
  export interface Balance {
160
191
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -7935,6 +7966,18 @@ export interface VoidAttendanceMarkParams {
7935
7966
  /** Por qué se quita: queda tachada con este motivo y el empleado lo ve. */
7936
7967
  reason: string;
7937
7968
  }
7969
+ export interface ApproveAttendanceOvertimeParams {
7970
+ /** El empleado (emp_…). */
7971
+ employee: string;
7972
+ /** AAAA-MM-DD. */
7973
+ date: string;
7974
+ /** Hasta cuántos minutos de horas extra de ese día cuentan para la nómina (0 a 960); null quita la decisión. Con rejected: true se ignora. */
7975
+ minutes: number | null;
7976
+ /** true rechaza todas las horas extra de ese día: quedan en el registro, no cuentan para la nómina y dejan de estar por autorizar. Pide comment. */
7977
+ rejected?: boolean;
7978
+ /** Por qué (obligatorio al rechazar; el empleado lo ve). */
7979
+ comment?: string;
7980
+ }
7938
7981
  export interface CreateExpensePersonParams {
7939
7982
  /** El emisor (iss_…). Por omisión, su único emisor. */
7940
7983
  issuer?: string;
@@ -11247,6 +11290,15 @@ export declare class AttendanceResource {
11247
11290
  * @see https://fiscalisto.com/docs/api/referencia/asistencia/void-attendance-mark
11248
11291
  */
11249
11292
  voidMark(id: string, params: VoidAttendanceMarkParams, options?: RequestOptions): Promise<AttendanceMark>;
11293
+ /**
11294
+ * Autorizar o rechazar horas extra
11295
+ *
11296
+ * Hasta cuántos minutos de horas extra de un día de un empleado cuentan para la nómina, antes o después de ese día, o rechazarlas todas (rejected: true, con comment). minutes null quita la decisión. Con la regla de horas extra «Necesitan autorización», lo que nadie autorizó queda en el registro como sin autorizar.
11297
+ *
11298
+ * POST /v1/attendance/overtime
11299
+ * @see https://fiscalisto.com/docs/api/referencia/asistencia/approve-attendance-overtime
11300
+ */
11301
+ approveOvertime(params: ApproveAttendanceOvertimeParams, options?: RequestOptions): Promise<AttendanceOvertime>;
11250
11302
  }
11251
11303
  /** Viáticos y gastos: fiscalisto.expensePeople. */
11252
11304
  export declare class ExpensePeopleResource {
package/dist/generated.js CHANGED
@@ -1694,6 +1694,17 @@ export class AttendanceResource {
1694
1694
  voidMark(id, params, options) {
1695
1695
  return this.#client.request({ method: "POST", path: `/v1/attendance/marks/${encodeURIComponent(id)}/void`, body: params, idempotent: true }, options);
1696
1696
  }
1697
+ /**
1698
+ * Autorizar o rechazar horas extra
1699
+ *
1700
+ * Hasta cuántos minutos de horas extra de un día de un empleado cuentan para la nómina, antes o después de ese día, o rechazarlas todas (rejected: true, con comment). minutes null quita la decisión. Con la regla de horas extra «Necesitan autorización», lo que nadie autorizó queda en el registro como sin autorizar.
1701
+ *
1702
+ * POST /v1/attendance/overtime
1703
+ * @see https://fiscalisto.com/docs/api/referencia/asistencia/approve-attendance-overtime
1704
+ */
1705
+ approveOvertime(params, options) {
1706
+ return this.#client.request({ method: "POST", path: "/v1/attendance/overtime", body: params, idempotent: true }, options);
1707
+ }
1697
1708
  }
1698
1709
  /** Viáticos y gastos: fiscalisto.expensePeople. */
1699
1710
  export class ExpensePeopleResource {