fiscalisto 0.1.59 → 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 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.59";
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.59";
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.
@@ -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ó. */
@@ -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ó. */
@@ -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»…). */
@@ -4234,6 +4360,167 @@ export interface CustomerPaymentBehavior {
4234
4360
  expected_payment_date: string;
4235
4361
  }[];
4236
4362
  }
4363
+ /** El flujo de efectivo de las próximas 13 semanas: lo que le deben (con lo que cada cliente suele tardar), lo que debe a proveedores, la nómina, las declaraciones, las facturas recurrentes y sus movimientos previstos, desde el saldo que usted dio. Una estimación: no cambia nada. */
4364
+ export interface CashForecast {
4365
+ /** Siempre cash_forecast. */
4366
+ object: "cash_forecast";
4367
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
4368
+ livemode: boolean;
4369
+ /** El emisor (iss_…). */
4370
+ issuer: string;
4371
+ /** Hoy en la Ciudad de México (AAAA-MM-DD): el inicio. */
4372
+ today: string;
4373
+ /** El último día de la semana 13. */
4374
+ end: string;
4375
+ /** Todo en pesos: lo de otra moneda, a su tipo de cambio. */
4376
+ currency: "MXN";
4377
+ /** El saldo de hoy que usted dio; null si no lo ha dado (el flujo parte de 0). */
4378
+ starting_balance: {
4379
+ /** Lo que tenía en el banco, en pesos. */
4380
+ amount: number;
4381
+ /** El día de ese saldo. */
4382
+ date: string;
4383
+ } | null;
4384
+ /** Lo menos que quiere tener; cada semana debajo trae un aviso. 0 si no lo dio. */
4385
+ minimum_balance: number;
4386
+ /** El saldo de sus últimos estados de cuenta en Conciliación (60 días), solo como sugerencia; null sin ellos. */
4387
+ suggested_starting_balance: {
4388
+ /** La suma de los saldos, en pesos. */
4389
+ amount: number;
4390
+ /** El día del estado de cuenta más reciente. */
4391
+ date: string;
4392
+ } | null;
4393
+ /** El escenario con que se calculó: el de los parámetros de la consulta. */
4394
+ scenario: {
4395
+ /** Días que se movieron los cobros (0 como siempre). */
4396
+ customers_pay_days_later: number;
4397
+ /** Días que se movieron los pagos a proveedores. */
4398
+ pay_suppliers_days_later: number;
4399
+ /** Si cuenta lo que lleva más de 90 días de atraso. */
4400
+ include_doubtful: boolean;
4401
+ /** Si cuenta las facturas recurrentes que aún no se emiten. */
4402
+ include_recurring: boolean;
4403
+ /** Por ciento que cambiaron las recurrentes (−20 a +10…). */
4404
+ recurring_sales_change: number;
4405
+ };
4406
+ /** Las 13 semanas juntas. */
4407
+ totals: {
4408
+ /** Lo que entra en las 13 semanas. */
4409
+ inflows: number;
4410
+ /** Lo que sale en las 13 semanas. */
4411
+ outflows: number;
4412
+ /** El saldo al final de la semana 13. */
4413
+ ending_balance: number;
4414
+ /** El saldo más bajo al cierre de una semana. */
4415
+ lowest_balance: number;
4416
+ /** La semana de ese saldo (1 a 13). */
4417
+ lowest_week: number;
4418
+ /** Cuántas semanas cierran debajo de minimum_balance (o de 0). */
4419
+ weeks_below_minimum: number;
4420
+ /** Lo que se dejó fuera por llevar más de 90 días de atraso. */
4421
+ doubtful_left_out: number;
4422
+ };
4423
+ /** Las 13 semanas, en orden. */
4424
+ weeks: {
4425
+ /** 1 a 13; la 1 va de hoy al domingo. */
4426
+ week: number;
4427
+ /** El primer día (AAAA-MM-DD). */
4428
+ start: string;
4429
+ /** El último día, un domingo. */
4430
+ end: string;
4431
+ /** El saldo al empezar la semana. */
4432
+ starting_balance: number;
4433
+ /** Lo que entra. */
4434
+ inflows: number;
4435
+ /** Lo que sale. */
4436
+ outflows: number;
4437
+ /** El saldo al cerrar la semana. */
4438
+ ending_balance: number;
4439
+ /** Lo de cada tipo de renglón (lines[].type) esa semana, en pesos. */
4440
+ by_type: Record<string, number>;
4441
+ }[];
4442
+ /** Cada cosa que entra o sale, de la que se suman las semanas. */
4443
+ lines: {
4444
+ /** El renglón, para cambiarlo con POST /v1/cash_forecast/adjustments. */
4445
+ line: string;
4446
+ /** receivable: lo que le deben sus clientes; recurring_invoice: lo que facturarán sus recurrentes; planned_inflow / planned_outflow: un movimiento previsto que usted agregó; payable: lo que debe a proveedores; payroll: la nómina; taxes: las declaraciones mensuales. */
4447
+ type: "receivable" | "recurring_invoice" | "planned_inflow" | "payable" | "payroll" | "taxes" | "planned_outflow";
4448
+ /** inflow entra; outflow sale. */
4449
+ direction: "inflow" | "outflow";
4450
+ /** El día en que se cuenta, con cambios y escenario. */
4451
+ date: string;
4452
+ /** El día que se estimó. */
4453
+ estimated_date: string;
4454
+ /** La semana en que cae; null si se dejó fuera (left_out). */
4455
+ week: number | null;
4456
+ /** Lo que se cuenta, en pesos. */
4457
+ amount: number;
4458
+ /** Lo que se estimó, en pesos. */
4459
+ estimated_amount: number;
4460
+ /** Qué es, como en la app. */
4461
+ description: string;
4462
+ /** El RFC del cliente o proveedor, o null. */
4463
+ tax_id: string | null;
4464
+ /** Cuántas facturas suma, o null. */
4465
+ invoices: number | null;
4466
+ /** Cuándo vencía, o null. */
4467
+ due_date: string | null;
4468
+ /** Días de atraso si ya pasó el día esperado, o null. */
4469
+ days_overdue: number | null;
4470
+ /** Cómo se estimó, en palabras. */
4471
+ basis: string;
4472
+ /** high: un monto y día conocidos; medium: un promedio; low: atrasado o sin historial. */
4473
+ confidence: "high" | "medium" | "low";
4474
+ /** Por qué no cuenta: excluded usted lo quitó; doubtful más de 90 días de atraso; scenario el escenario lo quitó; after_horizon cae después de la semana 13. null si cuenta. */
4475
+ left_out: "excluded" | "doubtful" | "scenario" | "after_horizon" | null;
4476
+ /** true si usted le cambió el día, monto o lo quitó. */
4477
+ adjusted: boolean;
4478
+ /** El movimiento previsto (cfi_…) del que viene, o null. */
4479
+ planned_item: string | null;
4480
+ }[];
4481
+ /** Avisos con lo que puede hacer; usted decide. */
4482
+ warnings: {
4483
+ /** no_starting_balance: falta el saldo de hoy; stale_starting_balance: tiene más de 7 días; shortfall: una semana cierra debajo del mínimo; overdue_receivables: mucho por cobrar está atrasado; customer_concentration: un cliente es 40 % o más de lo que entra; doubtful_left_out: se dejó fuera lo de más de 90 días. */
4484
+ type: "no_starting_balance" | "stale_starting_balance" | "shortfall" | "overdue_receivables" | "customer_concentration" | "doubtful_left_out";
4485
+ /** Qué tan urgente es. */
4486
+ severity: "critical" | "warning" | "info";
4487
+ /** El aviso, en palabras. */
4488
+ title: string;
4489
+ /** Qué puede hacer; nada cambia solo. */
4490
+ detail: string;
4491
+ /** La semana, o null. */
4492
+ week: number | null;
4493
+ /** Lo que faltaría, en pesos, o null. */
4494
+ shortfall: number | null;
4495
+ }[];
4496
+ /** Sus movimientos previstos. */
4497
+ planned_items: CashForecastItem[];
4498
+ /** Lo que no se pudo estimar y por qué. */
4499
+ notes: string[];
4500
+ }
4501
+ /** Algo que espera pagar o cobrar y que ninguna factura dice (una renta, un crédito, una venta de contado), que cuenta en el flujo de efectivo. */
4502
+ export interface CashForecastItem {
4503
+ /** El movimiento previsto (cfi_…). */
4504
+ id: string;
4505
+ /** Siempre cash_forecast_item. */
4506
+ object: "cash_forecast_item";
4507
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
4508
+ livemode: boolean;
4509
+ /** El emisor (iss_…). */
4510
+ issuer: string;
4511
+ /** Qué es: «Renta», «Crédito del banco». */
4512
+ description: string;
4513
+ /** inflow entra dinero; outflow sale. */
4514
+ direction: "inflow" | "outflow";
4515
+ /** Cuánto, en pesos. */
4516
+ amount: number;
4517
+ /** El día (AAAA-MM-DD), o la primera vez si se repite. */
4518
+ date: string;
4519
+ /** once una vez; weekly cada semana; biweekly cada dos; monthly cada mes. */
4520
+ frequency: "once" | "weekly" | "biweekly" | "monthly";
4521
+ /** El último día en que se repite; null sin fin. */
4522
+ until: string | null;
4523
+ }
4237
4524
  /** Un depósito de la cuenta del emisor, y las facturas que pagó. */
4238
4525
  export interface BankTransaction {
4239
4526
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -6376,6 +6663,80 @@ export interface ListReceivablesParams {
6376
6663
  /** Solo este cliente: su RFC o su id (cus_…). */
6377
6664
  customer?: string;
6378
6665
  }
6666
+ /** Los parámetros de GET /v1/cash_forecast. */
6667
+ export interface GetCashForecastParams {
6668
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
6669
+ issuer?: string;
6670
+ /** Escenario: sus clientes le pagan estos días después (0 a 120). */
6671
+ customers_pay_days_later?: number;
6672
+ /** Escenario: usted paga a sus proveedores estos días después (0 a 120). */
6673
+ pay_suppliers_days_later?: number;
6674
+ /** true cuenta lo que lleva más de 90 días de atraso (por omisión no). */
6675
+ include_doubtful?: boolean;
6676
+ /** false deja fuera las facturas recurrentes que aún no se emiten. */
6677
+ include_recurring?: boolean;
6678
+ /** Escenario: por ciento que cambian sus recurrentes (−100 a 100). */
6679
+ recurring_sales_change?: number;
6680
+ }
6681
+ export interface UpdateCashForecastParams {
6682
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6683
+ issuer?: string;
6684
+ /** El saldo de hoy en sus cuentas de banco; null lo quita. */
6685
+ starting_balance?: {
6686
+ /** Lo que tiene en el banco, en pesos. */
6687
+ amount: number;
6688
+ /** El día de ese saldo (AAAA-MM-DD); hoy si no se indica. */
6689
+ date?: string;
6690
+ } | null;
6691
+ /** Lo menos que quiere tener: cada semana debajo trae un aviso. 0 para ninguno. */
6692
+ minimum_balance?: number;
6693
+ }
6694
+ export interface CreateCashForecastItemParams {
6695
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6696
+ issuer?: string;
6697
+ /** Qué es: «Renta», «Crédito del banco». */
6698
+ description: string;
6699
+ /** inflow si es dinero que entra; outflow si sale. */
6700
+ direction: "inflow" | "outflow";
6701
+ /** Cuánto, en pesos. */
6702
+ amount: number;
6703
+ /** El día (o la primera vez, si se repite). */
6704
+ date: string;
6705
+ /** once (por omisión), weekly, biweekly (cada dos semanas) o monthly. */
6706
+ frequency?: "once" | "weekly" | "biweekly" | "monthly";
6707
+ /** El último día en que se repite; null sin fin. */
6708
+ until?: string | null;
6709
+ }
6710
+ export interface UpdateCashForecastItemParams {
6711
+ /** Qué es: «Renta», «Crédito del banco». */
6712
+ description?: string;
6713
+ /** inflow si es dinero que entra; outflow si sale. */
6714
+ direction?: "inflow" | "outflow";
6715
+ /** Cuánto, en pesos. */
6716
+ amount?: number;
6717
+ /** El día (o la primera vez, si se repite). */
6718
+ date?: string;
6719
+ /** once (por omisión), weekly, biweekly (cada dos semanas) o monthly. */
6720
+ frequency?: "once" | "weekly" | "biweekly" | "monthly";
6721
+ /** El último día en que se repite; null sin fin. */
6722
+ until?: string | null;
6723
+ }
6724
+ export interface AdjustCashForecastParams {
6725
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6726
+ issuer?: string;
6727
+ /** El renglón (lines[].line de GET /v1/cash_forecast). */
6728
+ line: string;
6729
+ /** Otro día para ese renglón; null el estimado. */
6730
+ date?: string | null;
6731
+ /** Otro monto, en pesos; null el estimado. */
6732
+ amount?: number | null;
6733
+ /** true para no contarlo. */
6734
+ excluded?: boolean;
6735
+ /** Por qué (lo ve quien abra la semana en la app). */
6736
+ note?: string | null;
6737
+ /** true lo regresa a lo estimado; lo demás se ignora. */
6738
+ reset?: boolean;
6739
+ }
6379
6740
  export interface CreateBankTransactionsParams {
6380
6741
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6381
6742
  issuer?: string;
@@ -7549,6 +7910,31 @@ export interface QuotePricesParams {
7549
7910
  unit?: string | null;
7550
7911
  }[];
7551
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
+ }
7552
7938
  export interface CreateExpensePersonParams {
7553
7939
  /** El emisor (iss_…). Por omisión, su único emisor. */
7554
7940
  issuer?: string;
@@ -10028,6 +10414,65 @@ export declare class CustomersResource {
10028
10414
  */
10029
10415
  delete(id: string, options?: RequestOptions): Promise<Deleted>;
10030
10416
  }
10417
+ /** Flujo de efectivo: fiscalisto.cashForecast. */
10418
+ export declare class CashForecastResource {
10419
+ #private;
10420
+ constructor(client: Client);
10421
+ /**
10422
+ * Ver el flujo de efectivo
10423
+ *
10424
+ * Las próximas 13 semanas del emisor, como «Flujo de efectivo» en la app: lo que le deben, con lo que cada cliente suele tardar en pagar; lo que debe a proveedores; la nómina; las declaraciones mensuales; las facturas recurrentes y sus movimientos previstos, desde el saldo que dio. Trae avisos con lo que puede hacer, y con los parámetros, un escenario (no se guarda). Una estimación: nada cambia solo.
10425
+ *
10426
+ * GET /v1/cash_forecast
10427
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/get-cash-forecast
10428
+ */
10429
+ get(params?: GetCashForecastParams, options?: RequestOptions): Promise<CashForecast>;
10430
+ /**
10431
+ * Dar el saldo de hoy
10432
+ *
10433
+ * El saldo de hoy en sus cuentas de banco (de donde parte el flujo) y lo menos que quiere tener. Solo lo que mande cambia. Responde el flujo con el saldo nuevo.
10434
+ *
10435
+ * POST /v1/cash_forecast
10436
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/update-cash-forecast
10437
+ */
10438
+ update(params?: UpdateCashForecastParams, options?: RequestOptions): Promise<CashForecast>;
10439
+ /**
10440
+ * Agregar un movimiento previsto
10441
+ *
10442
+ * Algo que espera pagar o cobrar y que ninguna factura dice: una renta, un crédito, una venta de contado. Una vez o cada semana, dos semanas o mes. Hasta 200.
10443
+ *
10444
+ * POST /v1/cash_forecast/planned_items
10445
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/create-cash-forecast-item
10446
+ */
10447
+ createItem(params: CreateCashForecastItemParams, options?: RequestOptions): Promise<CashForecastItem>;
10448
+ /**
10449
+ * Cambiar un movimiento previsto
10450
+ *
10451
+ * Solo lo que mande cambia.
10452
+ *
10453
+ * POST /v1/cash_forecast/planned_items/{id}
10454
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/update-cash-forecast-item
10455
+ */
10456
+ updateItem(id: string, params?: UpdateCashForecastItemParams, options?: RequestOptions): Promise<CashForecastItem>;
10457
+ /**
10458
+ * Borrar un movimiento previsto
10459
+ *
10460
+ * Ya no cuenta en el flujo.
10461
+ *
10462
+ * DELETE /v1/cash_forecast/planned_items/{id}
10463
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/delete-cash-forecast-item
10464
+ */
10465
+ deleteItem(id: string, options?: RequestOptions): Promise<Deleted>;
10466
+ /**
10467
+ * Cambiar un renglón del flujo
10468
+ *
10469
+ * Otro día o monto para un renglón (lines[].line), o no contarlo: un cliente le avisó que paga después, o una factura ya se pagó por fuera. Solo cambia el pronóstico, nunca la factura. reset: true lo regresa a lo estimado. Responde el flujo con el cambio.
10470
+ *
10471
+ * POST /v1/cash_forecast/adjustments
10472
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/adjust-cash-forecast
10473
+ */
10474
+ adjust(params: AdjustCashForecastParams, options?: RequestOptions): Promise<CashForecast>;
10475
+ }
10031
10476
  /** Conciliación bancaria: fiscalisto.bankTransactions. */
10032
10477
  export declare class BankTransactionsResource {
10033
10478
  #private;
@@ -10771,6 +11216,38 @@ export declare class PricesResource {
10771
11216
  */
10772
11217
  quote(params: QuotePricesParams, options?: RequestOptions): Promise<PriceQuote>;
10773
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
+ }
10774
11251
  /** Viáticos y gastos: fiscalisto.expensePeople. */
10775
11252
  export declare class ExpensePeopleResource {
10776
11253
  #private;
@@ -12352,6 +12829,7 @@ export declare class FiscalistoApi extends Core {
12352
12829
  readonly invoices: InvoicesResource;
12353
12830
  readonly receivables: ReceivablesResource;
12354
12831
  readonly customers: CustomersResource;
12832
+ readonly cashForecast: CashForecastResource;
12355
12833
  readonly bankTransactions: BankTransactionsResource;
12356
12834
  readonly purchaseReceipts: PurchaseReceiptsResource;
12357
12835
  readonly payments: PaymentsResource;
@@ -12371,6 +12849,7 @@ export declare class FiscalistoApi extends Core {
12371
12849
  readonly priceLists: PriceListsResource;
12372
12850
  readonly customerGroups: CustomerGroupsResource;
12373
12851
  readonly prices: PricesResource;
12852
+ readonly attendance: AttendanceResource;
12374
12853
  readonly expensePeople: ExpensePeopleResource;
12375
12854
  readonly expenseReports: ExpenseReportsResource;
12376
12855
  readonly expensePolicy: ExpensePolicyResource;