fiscalisto 0.1.60 → 0.1.61
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 +1 -1
- package/dist/core.js +1 -1
- package/dist/error-codes.d.ts +2 -0
- package/dist/error-codes.js +2 -0
- package/dist/generated.d.ts +184 -0
- package/dist/generated.js +41 -0
- package/dist/mock-routes.gen.js +1 -1
- package/package.json +1 -1
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.
|
|
7
|
+
export declare const VERSION = "0.1.61";
|
|
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.
|
|
6
|
+
export const VERSION = "0.1.61";
|
|
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.
|
package/dist/error-codes.d.ts
CHANGED
|
@@ -7,6 +7,8 @@ export declare const ErrorCode: {
|
|
|
7
7
|
readonly AccountSuspended: "account_suspended";
|
|
8
8
|
/** No existe esa versión de la API (en Fiscalisto-Version o api_version). El mensaje dice cuáles hay; vea Versiones. */
|
|
9
9
|
readonly ApiVersionInvalid: "api_version_invalid";
|
|
10
|
+
/** Asistencia no lo permite: el mensaje dice por qué (una hora en el futuro o de hace más de 400 días, un empleado con fecha de baja, un periodo de más de 92 días, una marca ya quitada). */
|
|
11
|
+
readonly AttendanceInvalid: "attendance_invalid";
|
|
10
12
|
/** El depósito no se puede conciliar, clasificar o reabrir así (ya está conciliado, las facturas son de otro cliente o una está cancelada…). El mensaje dice por qué. */
|
|
11
13
|
readonly BankTransactionInvalid: "bank_transaction_invalid";
|
|
12
14
|
/** Una factura del lote no pasa la revisión; param dice cuál (invoices.3.items.0.unit_price). Ninguna del lote se timbró. */
|
package/dist/error-codes.js
CHANGED
|
@@ -8,6 +8,8 @@ export const ErrorCode = {
|
|
|
8
8
|
AccountSuspended: "account_suspended",
|
|
9
9
|
/** No existe esa versión de la API (en Fiscalisto-Version o api_version). El mensaje dice cuáles hay; vea Versiones. */
|
|
10
10
|
ApiVersionInvalid: "api_version_invalid",
|
|
11
|
+
/** Asistencia no lo permite: el mensaje dice por qué (una hora en el futuro o de hace más de 400 días, un empleado con fecha de baja, un periodo de más de 92 días, una marca ya quitada). */
|
|
12
|
+
AttendanceInvalid: "attendance_invalid",
|
|
11
13
|
/** El depósito no se puede conciliar, clasificar o reabrir así (ya está conciliado, las facturas son de otro cliente o una está cancelada…). El mensaje dice por qué. */
|
|
12
14
|
BankTransactionInvalid: "bank_transaction_invalid",
|
|
13
15
|
/** Una factura del lote no pasa la revisión; param dice cuál (invoices.3.items.0.unit_price). Ninguna del lote se timbró. */
|
package/dist/generated.d.ts
CHANGED
|
@@ -29,6 +29,132 @@ export interface Account {
|
|
|
29
29
|
sandbox: string | null;
|
|
30
30
|
};
|
|
31
31
|
}
|
|
32
|
+
/** Una marca de entrada o salida de Asistencia (registro electrónico de jornada, LFT art. 132). */
|
|
33
|
+
export interface AttendanceMark {
|
|
34
|
+
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
35
|
+
id: string;
|
|
36
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
37
|
+
livemode: boolean;
|
|
38
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
39
|
+
object: "attendance_mark";
|
|
40
|
+
/** El empleado (emp_…). */
|
|
41
|
+
employee: string;
|
|
42
|
+
/** in: entrada; out: salida. */
|
|
43
|
+
kind: "in" | "out";
|
|
44
|
+
/** Cuándo marcó (UTC). */
|
|
45
|
+
at: string;
|
|
46
|
+
/** El día al que cuenta, AAAA-MM-DD en la hora del lugar. */
|
|
47
|
+
date: string;
|
|
48
|
+
/** La hora en el lugar, HH:MM. */
|
|
49
|
+
time: string;
|
|
50
|
+
/** Cómo marcó: kiosk_qr (el código del checador), kiosk_pin (número y NIP en el checador), printed_qr (el QR impreso), remote (fuera de la sucursal, con su ubicación), manual (corrección en la app), api. */
|
|
51
|
+
method: "kiosk_qr" | "kiosk_pin" | "printed_qr" | "remote" | "manual" | "api";
|
|
52
|
+
/** El lugar donde marcó, o null. */
|
|
53
|
+
place: string | null;
|
|
54
|
+
/** A cuántos metros del lugar estaba, si dio su ubicación; si no, null. */
|
|
55
|
+
distance_m: number | null;
|
|
56
|
+
/** Notas para revisar (la marca nunca se rechaza por ellas): no_location (no dio su ubicación), far (lejos del lugar), imprecise (ubicación imprecisa), remote (fuera de la sucursal), new_device (un celular nuevo). */
|
|
57
|
+
flags: ("no_location" | "far" | "imprecise" | "remote" | "new_device")[];
|
|
58
|
+
/** Por qué se agregó, en una corrección o desde la API (el empleado lo ve); null si la hizo él. */
|
|
59
|
+
reason: string | null;
|
|
60
|
+
/** Quién la agregó, en una corrección; null si la hizo él. */
|
|
61
|
+
created_by: string | null;
|
|
62
|
+
/** true si se quitó: queda tachada, no cuenta, y se ve con su motivo. */
|
|
63
|
+
voided: boolean;
|
|
64
|
+
/** Por qué se quitó, o null. */
|
|
65
|
+
void_reason: string | null;
|
|
66
|
+
/** Quién la quitó, o null. */
|
|
67
|
+
voided_by: string | null;
|
|
68
|
+
/** Cuándo se quitó, o null. */
|
|
69
|
+
voided_at: string | null;
|
|
70
|
+
}
|
|
71
|
+
/** La asistencia de un periodo, por empleado: horas contra su horario, faltas, retardos y horas extra dobles y triples por semana, como Nómina › Asistencia › Registro. */
|
|
72
|
+
export interface AttendanceReport {
|
|
73
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
74
|
+
object: "attendance_report";
|
|
75
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
76
|
+
livemode: boolean;
|
|
77
|
+
/** El emisor (iss_…), el patrón. */
|
|
78
|
+
issuer: string;
|
|
79
|
+
/** Primer día del periodo, AAAA-MM-DD. */
|
|
80
|
+
from: string;
|
|
81
|
+
/** Último día del periodo, AAAA-MM-DD. */
|
|
82
|
+
to: string;
|
|
83
|
+
/** Cada empleado del emisor en el periodo. */
|
|
84
|
+
employees: {
|
|
85
|
+
/** El empleado (emp_…). */
|
|
86
|
+
employee: string;
|
|
87
|
+
/** Su nombre. */
|
|
88
|
+
name: string;
|
|
89
|
+
/** Su número de empleado, o null. */
|
|
90
|
+
number: string | null;
|
|
91
|
+
/** Donde marca, o null (cualquier lugar). */
|
|
92
|
+
place: string | null;
|
|
93
|
+
/** Minutos trabajados en el periodo. */
|
|
94
|
+
worked_minutes: number;
|
|
95
|
+
/** Minutos de su horario en el periodo. */
|
|
96
|
+
scheduled_minutes: number;
|
|
97
|
+
/** Faltas: días de trabajo sin marcas ni nota. */
|
|
98
|
+
absences: number;
|
|
99
|
+
/** Días con nota de incapacidad. */
|
|
100
|
+
disability_days: number;
|
|
101
|
+
/** Días con nota de vacaciones. */
|
|
102
|
+
vacation_days: number;
|
|
103
|
+
/** Cuántos días llegó tarde. */
|
|
104
|
+
late_count: number;
|
|
105
|
+
/** Minutos de retardo en total. */
|
|
106
|
+
late_minutes: number;
|
|
107
|
+
/** Días con una marca sin su pareja (sin salida). */
|
|
108
|
+
incomplete_days: number;
|
|
109
|
+
/** Marcas con una nota para revisar (flags). */
|
|
110
|
+
flagged_marks: number;
|
|
111
|
+
/** Horas extra que se pagan dobles (hasta 9 por semana en 2026, 12 desde 2027). */
|
|
112
|
+
overtime_double_minutes: number;
|
|
113
|
+
/** Horas extra que se pagan triples (las que pasan del límite de la semana). */
|
|
114
|
+
overtime_triple_minutes: number;
|
|
115
|
+
/** Días de descanso en que trabajó. */
|
|
116
|
+
rest_days_worked: number;
|
|
117
|
+
/** Días festivos en que trabajó. */
|
|
118
|
+
holidays_worked: number;
|
|
119
|
+
/** Semanas que el empleado confirmó en su enlace. */
|
|
120
|
+
weeks_confirmed: number;
|
|
121
|
+
/** Las semanas con las que el empleado no está de acuerdo. */
|
|
122
|
+
weeks_disputed: {
|
|
123
|
+
/** El lunes de la semana, AAAA-MM-DD. */
|
|
124
|
+
week: string;
|
|
125
|
+
/** Lo que el empleado dijo que no coincide. */
|
|
126
|
+
text: string;
|
|
127
|
+
}[];
|
|
128
|
+
/** Cada día del periodo, solo cuando se pide un employee; si no, null. */
|
|
129
|
+
days: {
|
|
130
|
+
/** AAAA-MM-DD. */
|
|
131
|
+
date: string;
|
|
132
|
+
/** worked (trabajó), incomplete (falta una marca), absent (falta), rest (descanso), holiday (día festivo), excused (justificado con una nota), upcoming (por venir), before (antes de empezar su registro). */
|
|
133
|
+
status: "worked" | "incomplete" | "absent" | "rest" | "holiday" | "excused" | "upcoming" | "before";
|
|
134
|
+
/** Su horario ese día, o null si descansa. */
|
|
135
|
+
scheduled: {
|
|
136
|
+
/** Hora de entrada, HH:MM. */
|
|
137
|
+
start: string;
|
|
138
|
+
/** Hora de salida, HH:MM (antes de la entrada: al día siguiente). */
|
|
139
|
+
end: string;
|
|
140
|
+
/** Minutos de comida que no se pagan. */
|
|
141
|
+
break_minutes: number;
|
|
142
|
+
} | null;
|
|
143
|
+
/** Minutos trabajados ese día. */
|
|
144
|
+
worked_minutes: number;
|
|
145
|
+
/** Minutos de retardo, pasada la tolerancia. */
|
|
146
|
+
late_minutes: number;
|
|
147
|
+
/** Minutos de más ese día (horas extra). */
|
|
148
|
+
overtime_minutes: number;
|
|
149
|
+
/** La nota del día que puso la empresa, o null. */
|
|
150
|
+
note: "vacaciones" | "incapacidad" | "permiso_con_goce" | "permiso_sin_goce" | "descanso" | "festivo" | "falta" | null;
|
|
151
|
+
/** El nombre del día festivo, o null. */
|
|
152
|
+
holiday: string | null;
|
|
153
|
+
}[] | null;
|
|
154
|
+
/** Sus marcas, también las quitadas, solo cuando se pide un employee; si no, null. */
|
|
155
|
+
marks: AttendanceMark[] | null;
|
|
156
|
+
}[];
|
|
157
|
+
}
|
|
32
158
|
/** Timbres de producción de la cuenta, por paquete, el que vence antes primero. */
|
|
33
159
|
export interface Balance {
|
|
34
160
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
@@ -7784,6 +7910,31 @@ export interface QuotePricesParams {
|
|
|
7784
7910
|
unit?: string | null;
|
|
7785
7911
|
}[];
|
|
7786
7912
|
}
|
|
7913
|
+
/** Los parámetros de GET /v1/attendance. */
|
|
7914
|
+
export interface GetAttendanceParams {
|
|
7915
|
+
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
7916
|
+
issuer?: string;
|
|
7917
|
+
/** Primer día, AAAA-MM-DD. */
|
|
7918
|
+
from: string;
|
|
7919
|
+
/** Último día, AAAA-MM-DD (hasta 92 días después de from). */
|
|
7920
|
+
to: string;
|
|
7921
|
+
/** Solo este empleado (emp_…), con sus días y marcas. */
|
|
7922
|
+
employee?: string;
|
|
7923
|
+
}
|
|
7924
|
+
export interface CreateAttendanceMarkParams {
|
|
7925
|
+
/** El empleado (emp_…). */
|
|
7926
|
+
employee: string;
|
|
7927
|
+
/** in: entrada; out: salida. */
|
|
7928
|
+
kind: "in" | "out";
|
|
7929
|
+
/** Cuándo marcó, con su zona horaria (2027-01-04T09:02:00-06:00). No en el futuro ni de hace más de 400 días. */
|
|
7930
|
+
at: string;
|
|
7931
|
+
/** Por qué se registra (se guarda y el empleado lo ve en su enlace). Por omisión «Registrada por la API». */
|
|
7932
|
+
reason?: string;
|
|
7933
|
+
}
|
|
7934
|
+
export interface VoidAttendanceMarkParams {
|
|
7935
|
+
/** Por qué se quita: queda tachada con este motivo y el empleado lo ve. */
|
|
7936
|
+
reason: string;
|
|
7937
|
+
}
|
|
7787
7938
|
export interface CreateExpensePersonParams {
|
|
7788
7939
|
/** El emisor (iss_…). Por omisión, su único emisor. */
|
|
7789
7940
|
issuer?: string;
|
|
@@ -11065,6 +11216,38 @@ export declare class PricesResource {
|
|
|
11065
11216
|
*/
|
|
11066
11217
|
quote(params: QuotePricesParams, options?: RequestOptions): Promise<PriceQuote>;
|
|
11067
11218
|
}
|
|
11219
|
+
/** Asistencia: fiscalisto.attendance. */
|
|
11220
|
+
export declare class AttendanceResource {
|
|
11221
|
+
#private;
|
|
11222
|
+
constructor(client: Client);
|
|
11223
|
+
/**
|
|
11224
|
+
* Ver la asistencia de un periodo
|
|
11225
|
+
*
|
|
11226
|
+
* El registro de jornada del emisor (LFT art. 132) del periodo, por empleado: minutos trabajados contra su horario, faltas, retardos, días sin salida, marcas con notas y horas extra dobles y triples por semana. Con employee, también cada día y cada marca (con sus correcciones). Hasta 92 días a la vez.
|
|
11227
|
+
*
|
|
11228
|
+
* GET /v1/attendance
|
|
11229
|
+
* @see https://fiscalisto.com/docs/api/referencia/asistencia/get-attendance
|
|
11230
|
+
*/
|
|
11231
|
+
get(params: GetAttendanceParams, options?: RequestOptions): Promise<AttendanceReport>;
|
|
11232
|
+
/**
|
|
11233
|
+
* Registrar una marca
|
|
11234
|
+
*
|
|
11235
|
+
* Una entrada o salida que viene de otro reloj checador. Queda con method api y su motivo, y el empleado la ve en su enlace. Una marca igual del mismo empleado dentro de 60 segundos no se duplica.
|
|
11236
|
+
*
|
|
11237
|
+
* POST /v1/attendance/marks
|
|
11238
|
+
* @see https://fiscalisto.com/docs/api/referencia/asistencia/create-attendance-mark
|
|
11239
|
+
*/
|
|
11240
|
+
createMark(params: CreateAttendanceMarkParams, options?: RequestOptions): Promise<AttendanceMark>;
|
|
11241
|
+
/**
|
|
11242
|
+
* Quitar una marca
|
|
11243
|
+
*
|
|
11244
|
+
* La marca deja de contar y queda tachada con su motivo, quién y cuándo (nunca se borra). En la app se puede restaurar.
|
|
11245
|
+
*
|
|
11246
|
+
* POST /v1/attendance/marks/{id}/void
|
|
11247
|
+
* @see https://fiscalisto.com/docs/api/referencia/asistencia/void-attendance-mark
|
|
11248
|
+
*/
|
|
11249
|
+
voidMark(id: string, params: VoidAttendanceMarkParams, options?: RequestOptions): Promise<AttendanceMark>;
|
|
11250
|
+
}
|
|
11068
11251
|
/** Viáticos y gastos: fiscalisto.expensePeople. */
|
|
11069
11252
|
export declare class ExpensePeopleResource {
|
|
11070
11253
|
#private;
|
|
@@ -12666,6 +12849,7 @@ export declare class FiscalistoApi extends Core {
|
|
|
12666
12849
|
readonly priceLists: PriceListsResource;
|
|
12667
12850
|
readonly customerGroups: CustomerGroupsResource;
|
|
12668
12851
|
readonly prices: PricesResource;
|
|
12852
|
+
readonly attendance: AttendanceResource;
|
|
12669
12853
|
readonly expensePeople: ExpensePeopleResource;
|
|
12670
12854
|
readonly expenseReports: ExpenseReportsResource;
|
|
12671
12855
|
readonly expensePolicy: ExpensePolicyResource;
|
package/dist/generated.js
CHANGED
|
@@ -1655,6 +1655,46 @@ export class PricesResource {
|
|
|
1655
1655
|
return this.#client.request({ method: "POST", path: "/v1/prices", body: params, idempotent: true }, options);
|
|
1656
1656
|
}
|
|
1657
1657
|
}
|
|
1658
|
+
/** Asistencia: fiscalisto.attendance. */
|
|
1659
|
+
export class AttendanceResource {
|
|
1660
|
+
#client;
|
|
1661
|
+
constructor(client) {
|
|
1662
|
+
this.#client = client;
|
|
1663
|
+
}
|
|
1664
|
+
/**
|
|
1665
|
+
* Ver la asistencia de un periodo
|
|
1666
|
+
*
|
|
1667
|
+
* El registro de jornada del emisor (LFT art. 132) del periodo, por empleado: minutos trabajados contra su horario, faltas, retardos, días sin salida, marcas con notas y horas extra dobles y triples por semana. Con employee, también cada día y cada marca (con sus correcciones). Hasta 92 días a la vez.
|
|
1668
|
+
*
|
|
1669
|
+
* GET /v1/attendance
|
|
1670
|
+
* @see https://fiscalisto.com/docs/api/referencia/asistencia/get-attendance
|
|
1671
|
+
*/
|
|
1672
|
+
get(params, options) {
|
|
1673
|
+
return this.#client.request({ method: "GET", path: "/v1/attendance", query: params }, options);
|
|
1674
|
+
}
|
|
1675
|
+
/**
|
|
1676
|
+
* Registrar una marca
|
|
1677
|
+
*
|
|
1678
|
+
* Una entrada o salida que viene de otro reloj checador. Queda con method api y su motivo, y el empleado la ve en su enlace. Una marca igual del mismo empleado dentro de 60 segundos no se duplica.
|
|
1679
|
+
*
|
|
1680
|
+
* POST /v1/attendance/marks
|
|
1681
|
+
* @see https://fiscalisto.com/docs/api/referencia/asistencia/create-attendance-mark
|
|
1682
|
+
*/
|
|
1683
|
+
createMark(params, options) {
|
|
1684
|
+
return this.#client.request({ method: "POST", path: "/v1/attendance/marks", body: params, idempotent: true }, options);
|
|
1685
|
+
}
|
|
1686
|
+
/**
|
|
1687
|
+
* Quitar una marca
|
|
1688
|
+
*
|
|
1689
|
+
* La marca deja de contar y queda tachada con su motivo, quién y cuándo (nunca se borra). En la app se puede restaurar.
|
|
1690
|
+
*
|
|
1691
|
+
* POST /v1/attendance/marks/{id}/void
|
|
1692
|
+
* @see https://fiscalisto.com/docs/api/referencia/asistencia/void-attendance-mark
|
|
1693
|
+
*/
|
|
1694
|
+
voidMark(id, params, options) {
|
|
1695
|
+
return this.#client.request({ method: "POST", path: `/v1/attendance/marks/${encodeURIComponent(id)}/void`, body: params, idempotent: true }, options);
|
|
1696
|
+
}
|
|
1697
|
+
}
|
|
1658
1698
|
/** Viáticos y gastos: fiscalisto.expensePeople. */
|
|
1659
1699
|
export class ExpensePeopleResource {
|
|
1660
1700
|
#client;
|
|
@@ -3636,6 +3676,7 @@ export class FiscalistoApi extends Core {
|
|
|
3636
3676
|
priceLists = new PriceListsResource(this);
|
|
3637
3677
|
customerGroups = new CustomerGroupsResource(this);
|
|
3638
3678
|
prices = new PricesResource(this);
|
|
3679
|
+
attendance = new AttendanceResource(this);
|
|
3639
3680
|
expensePeople = new ExpensePeopleResource(this);
|
|
3640
3681
|
expenseReports = new ExpenseReportsResource(this);
|
|
3641
3682
|
expensePolicy = new ExpensePolicyResource(this);
|