fiscalisto 0.1.58 → 0.1.60

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.58";
7
+ export declare const VERSION = "0.1.60";
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.58";
6
+ export const VERSION = "0.1.60";
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.
@@ -759,7 +759,7 @@ export interface Customer {
759
759
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
760
760
  tax_id: string | null;
761
761
  } | null;
762
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
762
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
763
763
  ieps_taxpayer: boolean;
764
764
  /** Su grupo de clientes (cgr_…), o null si no está en ninguno. */
765
765
  group: string | null;
@@ -2897,6 +2897,100 @@ export interface SatFindingCounterparty {
2897
2897
  next_step: string;
2898
2898
  }[];
2899
2899
  }
2900
+ /** Un proveedor del emisor en el periodo: cuánto le facturó, cuánto de eso tiene su evidencia completa (acuerdo, entrega y pago) y, si está en la lista 69-B, su plazo. */
2901
+ export interface MaterialitySupplier {
2902
+ /** Su RFC (el mismo que tax_id). */
2903
+ id: string;
2904
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
2905
+ livemode: boolean;
2906
+ /** Qué tipo de objeto es («invoice», «customer»…). */
2907
+ object: "materiality_supplier";
2908
+ /** El emisor que recibió sus facturas. */
2909
+ issuer: string;
2910
+ /** El RFC del proveedor. */
2911
+ tax_id: string;
2912
+ /** Su nombre como viene en el CFDI, o null. */
2913
+ name: string | null;
2914
+ /** Cuántas facturas recibidas (ingresos, no canceladas) le dio en el periodo. */
2915
+ invoices: number;
2916
+ /** Lo que suman, en pesos (las de otra moneda, a su tipo de cambio). */
2917
+ total: number;
2918
+ /** Lo que suman las que no tienen su evidencia completa, en pesos. */
2919
+ unproven: number;
2920
+ /** Cuántas facturas están complete (acuerdo, entrega y pago), partial (alguna) y none (ninguna). */
2921
+ states: {
2922
+ /** Facturas con acuerdo, entrega y pago. */
2923
+ complete: number;
2924
+ /** Facturas con alguna de las tres pruebas, no todas. */
2925
+ partial: number;
2926
+ /** Facturas sin ninguna prueba. */
2927
+ none: number;
2928
+ };
2929
+ /** A cuántas facturas les falta el acuerdo, la entrega y el pago. */
2930
+ missing: {
2931
+ /** Facturas sin acuerdo (contrato u orden de compra). */
2932
+ agreement: number;
2933
+ /** Facturas sin entrega (recepción, entregables o fotos). */
2934
+ delivery: number;
2935
+ /** Facturas sin pago (complemento, pago en el portal o en la orden, banco o comprobante). */
2936
+ payment: number;
2937
+ };
2938
+ /** Si está en la lista 69-B: definitive (definitivo) o presumed (presunto); en definitivo, el día que se publicó, el último día de los 30 días hábiles para acreditar las operaciones o corregir y cuántos días hábiles quedan (negativo: ya venció). null: no está. */
2939
+ sat_list: {
2940
+ /** definitive (69-B definitivo) o presumed (69-B presunto). */
2941
+ status: "definitive" | "presumed";
2942
+ /** El día que el SAT lo publicó como definitivo (AAAA-MM-DD), o null. */
2943
+ published_on: string | null;
2944
+ /** El último de los 30 días hábiles para acreditar las operaciones o corregir (AAAA-MM-DD), o null. */
2945
+ deadline: string | null;
2946
+ /** Días hábiles que quedan, sin contar hoy; negativo si ya venció. null si no es definitivo. */
2947
+ business_days_left: number | null;
2948
+ } | null;
2949
+ /** Si está en el Portal de proveedores del emisor (para pedirle la evidencia desde la app). */
2950
+ in_supplier_portal: boolean;
2951
+ /** Cuándo se le pidió evidencia que todavía no manda, o null. */
2952
+ evidence_requested_at: string | null;
2953
+ }
2954
+ /** Una factura recibida (ingreso) con lo que prueba que la operación existió: qué tiene, qué le falta y de dónde salió cada evidencia. */
2955
+ export interface MaterialityInvoice {
2956
+ /** El UUID de la factura (el mismo que uuid). */
2957
+ id: string;
2958
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
2959
+ livemode: boolean;
2960
+ /** Qué tipo de objeto es («invoice», «customer»…). */
2961
+ object: "materiality_invoice";
2962
+ /** El emisor que la recibió. */
2963
+ issuer: string;
2964
+ /** El folio fiscal (UUID). */
2965
+ uuid: string;
2966
+ /** Su serie, o null. */
2967
+ series: string | null;
2968
+ /** Su folio, o null. */
2969
+ folio: string | null;
2970
+ /** Su fecha (AAAA-MM-DD). */
2971
+ date: string;
2972
+ /** El RFC del proveedor que la emitió. */
2973
+ supplier_tax_id: string;
2974
+ /** Su nombre como viene en el CFDI, o null. */
2975
+ supplier_name: string | null;
2976
+ /** Su total en pesos (de otra moneda, a su tipo de cambio). */
2977
+ total: number;
2978
+ /** complete (tiene acuerdo, entrega y pago), partial (alguno) o none (ninguno). */
2979
+ state: "complete" | "partial" | "none";
2980
+ /** Lo que ya tiene: agreement (contrato u orden de compra), delivery (recepción, entregables o fotos), payment (complemento, pago en el portal o en la orden, banco o comprobante). */
2981
+ has: ("agreement" | "delivery" | "payment")[];
2982
+ /** Lo que le falta, de lo mismo. */
2983
+ missing: ("agreement" | "delivery" | "payment")[];
2984
+ /** De dónde salió cada evidencia: source es un código estable (orden_compra, recepcion, complemento_pago, pago_banco, foto, mensaje_portal…), proves lo que prueba (null: respaldo que no prueba nada solo) y label lo dice en palabras. */
2985
+ evidence: {
2986
+ /** De dónde salió: orden_compra, recepcion, complemento_pago, pago_banco, foto, mensaje_portal… */
2987
+ source: string;
2988
+ /** Lo que prueba: agreement, delivery o payment; null si solo respalda. */
2989
+ proves: "agreement" | "delivery" | "payment" | null;
2990
+ /** De dónde salió, en palabras. */
2991
+ label: string;
2992
+ }[];
2993
+ }
2900
2994
  /** Una venta que su comprador puede facturar él mismo en el portal del emisor (autofactura). */
2901
2995
  export interface Ticket {
2902
2996
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -4140,6 +4234,167 @@ export interface CustomerPaymentBehavior {
4140
4234
  expected_payment_date: string;
4141
4235
  }[];
4142
4236
  }
4237
+ /** 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. */
4238
+ export interface CashForecast {
4239
+ /** Siempre cash_forecast. */
4240
+ object: "cash_forecast";
4241
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
4242
+ livemode: boolean;
4243
+ /** El emisor (iss_…). */
4244
+ issuer: string;
4245
+ /** Hoy en la Ciudad de México (AAAA-MM-DD): el inicio. */
4246
+ today: string;
4247
+ /** El último día de la semana 13. */
4248
+ end: string;
4249
+ /** Todo en pesos: lo de otra moneda, a su tipo de cambio. */
4250
+ currency: "MXN";
4251
+ /** El saldo de hoy que usted dio; null si no lo ha dado (el flujo parte de 0). */
4252
+ starting_balance: {
4253
+ /** Lo que tenía en el banco, en pesos. */
4254
+ amount: number;
4255
+ /** El día de ese saldo. */
4256
+ date: string;
4257
+ } | null;
4258
+ /** Lo menos que quiere tener; cada semana debajo trae un aviso. 0 si no lo dio. */
4259
+ minimum_balance: number;
4260
+ /** El saldo de sus últimos estados de cuenta en Conciliación (60 días), solo como sugerencia; null sin ellos. */
4261
+ suggested_starting_balance: {
4262
+ /** La suma de los saldos, en pesos. */
4263
+ amount: number;
4264
+ /** El día del estado de cuenta más reciente. */
4265
+ date: string;
4266
+ } | null;
4267
+ /** El escenario con que se calculó: el de los parámetros de la consulta. */
4268
+ scenario: {
4269
+ /** Días que se movieron los cobros (0 como siempre). */
4270
+ customers_pay_days_later: number;
4271
+ /** Días que se movieron los pagos a proveedores. */
4272
+ pay_suppliers_days_later: number;
4273
+ /** Si cuenta lo que lleva más de 90 días de atraso. */
4274
+ include_doubtful: boolean;
4275
+ /** Si cuenta las facturas recurrentes que aún no se emiten. */
4276
+ include_recurring: boolean;
4277
+ /** Por ciento que cambiaron las recurrentes (−20 a +10…). */
4278
+ recurring_sales_change: number;
4279
+ };
4280
+ /** Las 13 semanas juntas. */
4281
+ totals: {
4282
+ /** Lo que entra en las 13 semanas. */
4283
+ inflows: number;
4284
+ /** Lo que sale en las 13 semanas. */
4285
+ outflows: number;
4286
+ /** El saldo al final de la semana 13. */
4287
+ ending_balance: number;
4288
+ /** El saldo más bajo al cierre de una semana. */
4289
+ lowest_balance: number;
4290
+ /** La semana de ese saldo (1 a 13). */
4291
+ lowest_week: number;
4292
+ /** Cuántas semanas cierran debajo de minimum_balance (o de 0). */
4293
+ weeks_below_minimum: number;
4294
+ /** Lo que se dejó fuera por llevar más de 90 días de atraso. */
4295
+ doubtful_left_out: number;
4296
+ };
4297
+ /** Las 13 semanas, en orden. */
4298
+ weeks: {
4299
+ /** 1 a 13; la 1 va de hoy al domingo. */
4300
+ week: number;
4301
+ /** El primer día (AAAA-MM-DD). */
4302
+ start: string;
4303
+ /** El último día, un domingo. */
4304
+ end: string;
4305
+ /** El saldo al empezar la semana. */
4306
+ starting_balance: number;
4307
+ /** Lo que entra. */
4308
+ inflows: number;
4309
+ /** Lo que sale. */
4310
+ outflows: number;
4311
+ /** El saldo al cerrar la semana. */
4312
+ ending_balance: number;
4313
+ /** Lo de cada tipo de renglón (lines[].type) esa semana, en pesos. */
4314
+ by_type: Record<string, number>;
4315
+ }[];
4316
+ /** Cada cosa que entra o sale, de la que se suman las semanas. */
4317
+ lines: {
4318
+ /** El renglón, para cambiarlo con POST /v1/cash_forecast/adjustments. */
4319
+ line: string;
4320
+ /** 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. */
4321
+ type: "receivable" | "recurring_invoice" | "planned_inflow" | "payable" | "payroll" | "taxes" | "planned_outflow";
4322
+ /** inflow entra; outflow sale. */
4323
+ direction: "inflow" | "outflow";
4324
+ /** El día en que se cuenta, con cambios y escenario. */
4325
+ date: string;
4326
+ /** El día que se estimó. */
4327
+ estimated_date: string;
4328
+ /** La semana en que cae; null si se dejó fuera (left_out). */
4329
+ week: number | null;
4330
+ /** Lo que se cuenta, en pesos. */
4331
+ amount: number;
4332
+ /** Lo que se estimó, en pesos. */
4333
+ estimated_amount: number;
4334
+ /** Qué es, como en la app. */
4335
+ description: string;
4336
+ /** El RFC del cliente o proveedor, o null. */
4337
+ tax_id: string | null;
4338
+ /** Cuántas facturas suma, o null. */
4339
+ invoices: number | null;
4340
+ /** Cuándo vencía, o null. */
4341
+ due_date: string | null;
4342
+ /** Días de atraso si ya pasó el día esperado, o null. */
4343
+ days_overdue: number | null;
4344
+ /** Cómo se estimó, en palabras. */
4345
+ basis: string;
4346
+ /** high: un monto y día conocidos; medium: un promedio; low: atrasado o sin historial. */
4347
+ confidence: "high" | "medium" | "low";
4348
+ /** 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. */
4349
+ left_out: "excluded" | "doubtful" | "scenario" | "after_horizon" | null;
4350
+ /** true si usted le cambió el día, monto o lo quitó. */
4351
+ adjusted: boolean;
4352
+ /** El movimiento previsto (cfi_…) del que viene, o null. */
4353
+ planned_item: string | null;
4354
+ }[];
4355
+ /** Avisos con lo que puede hacer; usted decide. */
4356
+ warnings: {
4357
+ /** 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. */
4358
+ type: "no_starting_balance" | "stale_starting_balance" | "shortfall" | "overdue_receivables" | "customer_concentration" | "doubtful_left_out";
4359
+ /** Qué tan urgente es. */
4360
+ severity: "critical" | "warning" | "info";
4361
+ /** El aviso, en palabras. */
4362
+ title: string;
4363
+ /** Qué puede hacer; nada cambia solo. */
4364
+ detail: string;
4365
+ /** La semana, o null. */
4366
+ week: number | null;
4367
+ /** Lo que faltaría, en pesos, o null. */
4368
+ shortfall: number | null;
4369
+ }[];
4370
+ /** Sus movimientos previstos. */
4371
+ planned_items: CashForecastItem[];
4372
+ /** Lo que no se pudo estimar y por qué. */
4373
+ notes: string[];
4374
+ }
4375
+ /** 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. */
4376
+ export interface CashForecastItem {
4377
+ /** El movimiento previsto (cfi_…). */
4378
+ id: string;
4379
+ /** Siempre cash_forecast_item. */
4380
+ object: "cash_forecast_item";
4381
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
4382
+ livemode: boolean;
4383
+ /** El emisor (iss_…). */
4384
+ issuer: string;
4385
+ /** Qué es: «Renta», «Crédito del banco». */
4386
+ description: string;
4387
+ /** inflow entra dinero; outflow sale. */
4388
+ direction: "inflow" | "outflow";
4389
+ /** Cuánto, en pesos. */
4390
+ amount: number;
4391
+ /** El día (AAAA-MM-DD), o la primera vez si se repite. */
4392
+ date: string;
4393
+ /** once una vez; weekly cada semana; biweekly cada dos; monthly cada mes. */
4394
+ frequency: "once" | "weekly" | "biweekly" | "monthly";
4395
+ /** El último día en que se repite; null sin fin. */
4396
+ until: string | null;
4397
+ }
4143
4398
  /** Un depósito de la cuenta del emisor, y las facturas que pagó. */
4144
4399
  export interface BankTransaction {
4145
4400
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -4755,6 +5010,26 @@ export interface SatFindingCounterpartyList {
4755
5010
  /** La ruta de esta lista. */
4756
5011
  url: string;
4757
5012
  }
5013
+ export interface MaterialitySupplierList {
5014
+ /** Qué tipo de objeto es («invoice», «customer»…). */
5015
+ object: "list";
5016
+ /** Los objetos de esta página. */
5017
+ data: MaterialitySupplier[];
5018
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
5019
+ has_more: boolean;
5020
+ /** La ruta de esta lista. */
5021
+ url: string;
5022
+ }
5023
+ export interface MaterialityInvoiceList {
5024
+ /** Qué tipo de objeto es («invoice», «customer»…). */
5025
+ object: "list";
5026
+ /** Los objetos de esta página. */
5027
+ data: MaterialityInvoice[];
5028
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
5029
+ has_more: boolean;
5030
+ /** La ruta de esta lista. */
5031
+ url: string;
5032
+ }
4758
5033
  export interface WarehouseList {
4759
5034
  /** Qué tipo de objeto es («invoice», «customer»…). */
4760
5035
  object: "list";
@@ -5054,7 +5329,7 @@ export interface InvoiceCreate {
5054
5329
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
5055
5330
  tax_id: string;
5056
5331
  };
5057
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
5332
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
5058
5333
  ieps_taxpayer?: boolean;
5059
5334
  };
5060
5335
  /** Conceptos (Conceptos), al menos uno. */
@@ -6262,6 +6537,80 @@ export interface ListReceivablesParams {
6262
6537
  /** Solo este cliente: su RFC o su id (cus_…). */
6263
6538
  customer?: string;
6264
6539
  }
6540
+ /** Los parámetros de GET /v1/cash_forecast. */
6541
+ export interface GetCashForecastParams {
6542
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
6543
+ issuer?: string;
6544
+ /** Escenario: sus clientes le pagan estos días después (0 a 120). */
6545
+ customers_pay_days_later?: number;
6546
+ /** Escenario: usted paga a sus proveedores estos días después (0 a 120). */
6547
+ pay_suppliers_days_later?: number;
6548
+ /** true cuenta lo que lleva más de 90 días de atraso (por omisión no). */
6549
+ include_doubtful?: boolean;
6550
+ /** false deja fuera las facturas recurrentes que aún no se emiten. */
6551
+ include_recurring?: boolean;
6552
+ /** Escenario: por ciento que cambian sus recurrentes (−100 a 100). */
6553
+ recurring_sales_change?: number;
6554
+ }
6555
+ export interface UpdateCashForecastParams {
6556
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6557
+ issuer?: string;
6558
+ /** El saldo de hoy en sus cuentas de banco; null lo quita. */
6559
+ starting_balance?: {
6560
+ /** Lo que tiene en el banco, en pesos. */
6561
+ amount: number;
6562
+ /** El día de ese saldo (AAAA-MM-DD); hoy si no se indica. */
6563
+ date?: string;
6564
+ } | null;
6565
+ /** Lo menos que quiere tener: cada semana debajo trae un aviso. 0 para ninguno. */
6566
+ minimum_balance?: number;
6567
+ }
6568
+ export interface CreateCashForecastItemParams {
6569
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6570
+ issuer?: string;
6571
+ /** Qué es: «Renta», «Crédito del banco». */
6572
+ description: string;
6573
+ /** inflow si es dinero que entra; outflow si sale. */
6574
+ direction: "inflow" | "outflow";
6575
+ /** Cuánto, en pesos. */
6576
+ amount: number;
6577
+ /** El día (o la primera vez, si se repite). */
6578
+ date: string;
6579
+ /** once (por omisión), weekly, biweekly (cada dos semanas) o monthly. */
6580
+ frequency?: "once" | "weekly" | "biweekly" | "monthly";
6581
+ /** El último día en que se repite; null sin fin. */
6582
+ until?: string | null;
6583
+ }
6584
+ export interface UpdateCashForecastItemParams {
6585
+ /** Qué es: «Renta», «Crédito del banco». */
6586
+ description?: string;
6587
+ /** inflow si es dinero que entra; outflow si sale. */
6588
+ direction?: "inflow" | "outflow";
6589
+ /** Cuánto, en pesos. */
6590
+ amount?: number;
6591
+ /** El día (o la primera vez, si se repite). */
6592
+ date?: string;
6593
+ /** once (por omisión), weekly, biweekly (cada dos semanas) o monthly. */
6594
+ frequency?: "once" | "weekly" | "biweekly" | "monthly";
6595
+ /** El último día en que se repite; null sin fin. */
6596
+ until?: string | null;
6597
+ }
6598
+ export interface AdjustCashForecastParams {
6599
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6600
+ issuer?: string;
6601
+ /** El renglón (lines[].line de GET /v1/cash_forecast). */
6602
+ line: string;
6603
+ /** Otro día para ese renglón; null el estimado. */
6604
+ date?: string | null;
6605
+ /** Otro monto, en pesos; null el estimado. */
6606
+ amount?: number | null;
6607
+ /** true para no contarlo. */
6608
+ excluded?: boolean;
6609
+ /** Por qué (lo ve quien abra la semana en la app). */
6610
+ note?: string | null;
6611
+ /** true lo regresa a lo estimado; lo demás se ignora. */
6612
+ reset?: boolean;
6613
+ }
6265
6614
  export interface CreateBankTransactionsParams {
6266
6615
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6267
6616
  issuer?: string;
@@ -6472,7 +6821,7 @@ export interface CreateAdvanceParams {
6472
6821
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
6473
6822
  tax_id: string;
6474
6823
  };
6475
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
6824
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
6476
6825
  ieps_taxpayer?: boolean;
6477
6826
  };
6478
6827
  /** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
@@ -7661,7 +8010,7 @@ export interface CreateCustomerParams {
7661
8010
  price_list?: string | null;
7662
8011
  /** Su propio descuento en cada concepto, en %; null: el de su grupo. */
7663
8012
  discount_percent?: number | null;
7664
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
8013
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
7665
8014
  ieps_taxpayer?: boolean;
7666
8015
  }
7667
8016
  /** Los parámetros de GET /v1/customers. */
@@ -7701,7 +8050,7 @@ export interface UpdateCustomerParams {
7701
8050
  price_list?: string | null;
7702
8051
  /** Su propio descuento en cada concepto, en %; null: el de su grupo. */
7703
8052
  discount_percent?: number | null;
7704
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
8053
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
7705
8054
  ieps_taxpayer?: boolean;
7706
8055
  }
7707
8056
  export interface CreateCustomerDataRequestParams {
@@ -7913,6 +8262,30 @@ export interface ListSatFindingCounterpartiesParams {
7913
8262
  /** Solo quienes tienen este hallazgo (efos_definitivo, cancelado, regla_12…; el code de GET /v1/sat_findings). */
7914
8263
  code?: string;
7915
8264
  }
8265
+ /** Los parámetros de GET /v1/materiality_suppliers. */
8266
+ export interface ListMaterialitySuppliersParams {
8267
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
8268
+ issuer?: string;
8269
+ /** Facturas desde este día (AAAA-MM-DD). */
8270
+ date_gte?: string;
8271
+ /** Facturas hasta este día (AAAA-MM-DD, completo). */
8272
+ date_lte?: string;
8273
+ /** Solo este proveedor (su RFC). */
8274
+ supplier_tax_id?: string;
8275
+ }
8276
+ /** Los parámetros de GET /v1/materiality_invoices. */
8277
+ export interface ListMaterialityInvoicesParams {
8278
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
8279
+ issuer?: string;
8280
+ /** Facturas desde este día (AAAA-MM-DD). */
8281
+ date_gte?: string;
8282
+ /** Facturas hasta este día (AAAA-MM-DD, completo). */
8283
+ date_lte?: string;
8284
+ /** Solo las de este proveedor (su RFC). */
8285
+ supplier_tax_id?: string;
8286
+ /** Solo las de este estado: complete, partial o none. Sin él, las que no están completas. */
8287
+ state?: "complete" | "partial" | "none";
8288
+ }
7916
8289
  /** Los parámetros de GET /v1/warehouses. */
7917
8290
  export interface ListWarehousesParams {
7918
8291
  /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
@@ -8395,8 +8768,10 @@ export interface ListLedgerAccountsParams {
8395
8768
  }
8396
8769
  /** Los parámetros de GET /v1/accounting/electronic_accounting. */
8397
8770
  export interface GetElectronicAccountingParams {
8398
- /** El mes (AAAA-MM). */
8771
+ /** El mes (AAAA-MM), o AAAA-13 para la balanza de cierre de un ejercicio ya terminado. */
8399
8772
  month: string;
8773
+ /** Solo con AAAA-13: true (por omisión) incluye la póliza de cierre, que cancela ingresos, costos y gastos contra el resultado del ejercicio (305.01 utilidad o 305.02 pérdida); false manda los saldos de diciembre sin movimientos. */
8774
+ closing_entry?: "true" | "false";
8400
8775
  /** normal (BN, por omisión) o complementary (BC, con modified_on). */
8401
8776
  type?: "normal" | "complementary";
8402
8777
  /** complementary: el día en que se modificó (AAAA-MM-DD). */
@@ -8592,7 +8967,7 @@ export interface CreateQuoteParams {
8592
8967
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
8593
8968
  tax_id: string;
8594
8969
  };
8595
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
8970
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
8596
8971
  ieps_taxpayer?: boolean;
8597
8972
  } | {
8598
8973
  /** A quién va dirigida. */
@@ -8756,7 +9131,7 @@ export interface UpdateQuoteParams {
8756
9131
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
8757
9132
  tax_id: string;
8758
9133
  };
8759
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
9134
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
8760
9135
  ieps_taxpayer?: boolean;
8761
9136
  } | {
8762
9137
  /** A quién va dirigida. */
@@ -8931,7 +9306,7 @@ export interface CreateSalesOrderParams {
8931
9306
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
8932
9307
  tax_id: string;
8933
9308
  };
8934
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
9309
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
8935
9310
  ieps_taxpayer?: boolean;
8936
9311
  };
8937
9312
  /** Los conceptos, como en POST /v1/invoices (hasta 200). */
@@ -9104,7 +9479,7 @@ export interface UpdateSalesOrderParams {
9104
9479
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
9105
9480
  tax_id: string;
9106
9481
  };
9107
- /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
9482
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
9108
9483
  ieps_taxpayer?: boolean;
9109
9484
  };
9110
9485
  /** Los conceptos, como en POST /v1/invoices (hasta 200). */
@@ -9888,6 +10263,65 @@ export declare class CustomersResource {
9888
10263
  */
9889
10264
  delete(id: string, options?: RequestOptions): Promise<Deleted>;
9890
10265
  }
10266
+ /** Flujo de efectivo: fiscalisto.cashForecast. */
10267
+ export declare class CashForecastResource {
10268
+ #private;
10269
+ constructor(client: Client);
10270
+ /**
10271
+ * Ver el flujo de efectivo
10272
+ *
10273
+ * 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.
10274
+ *
10275
+ * GET /v1/cash_forecast
10276
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/get-cash-forecast
10277
+ */
10278
+ get(params?: GetCashForecastParams, options?: RequestOptions): Promise<CashForecast>;
10279
+ /**
10280
+ * Dar el saldo de hoy
10281
+ *
10282
+ * 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.
10283
+ *
10284
+ * POST /v1/cash_forecast
10285
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/update-cash-forecast
10286
+ */
10287
+ update(params?: UpdateCashForecastParams, options?: RequestOptions): Promise<CashForecast>;
10288
+ /**
10289
+ * Agregar un movimiento previsto
10290
+ *
10291
+ * 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.
10292
+ *
10293
+ * POST /v1/cash_forecast/planned_items
10294
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/create-cash-forecast-item
10295
+ */
10296
+ createItem(params: CreateCashForecastItemParams, options?: RequestOptions): Promise<CashForecastItem>;
10297
+ /**
10298
+ * Cambiar un movimiento previsto
10299
+ *
10300
+ * Solo lo que mande cambia.
10301
+ *
10302
+ * POST /v1/cash_forecast/planned_items/{id}
10303
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/update-cash-forecast-item
10304
+ */
10305
+ updateItem(id: string, params?: UpdateCashForecastItemParams, options?: RequestOptions): Promise<CashForecastItem>;
10306
+ /**
10307
+ * Borrar un movimiento previsto
10308
+ *
10309
+ * Ya no cuenta en el flujo.
10310
+ *
10311
+ * DELETE /v1/cash_forecast/planned_items/{id}
10312
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/delete-cash-forecast-item
10313
+ */
10314
+ deleteItem(id: string, options?: RequestOptions): Promise<Deleted>;
10315
+ /**
10316
+ * Cambiar un renglón del flujo
10317
+ *
10318
+ * 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.
10319
+ *
10320
+ * POST /v1/cash_forecast/adjustments
10321
+ * @see https://fiscalisto.com/docs/api/referencia/flujo-de-efectivo/adjust-cash-forecast
10322
+ */
10323
+ adjust(params: AdjustCashForecastParams, options?: RequestOptions): Promise<CashForecast>;
10324
+ }
9891
10325
  /** Conciliación bancaria: fiscalisto.bankTransactions. */
9892
10326
  export declare class BankTransactionsResource {
9893
10327
  #private;
@@ -10995,6 +11429,34 @@ export declare class SatFindingCounterpartiesResource {
10995
11429
  */
10996
11430
  list(params?: ListSatFindingCounterpartiesParams, options?: RequestOptions): List<SatFindingCounterparty>;
10997
11431
  }
11432
+ /** Cumplimiento SAT: fiscalisto.materialitySuppliers. */
11433
+ export declare class MaterialitySuppliersResource {
11434
+ #private;
11435
+ constructor(client: Client);
11436
+ /**
11437
+ * Listar la materialidad por proveedor
11438
+ *
11439
+ * Como Materialidad en la app: los proveedores de las facturas recibidas (ingresos) del emisor en un periodo, con cuánto de lo que facturaron tiene evidencia completa de que la operación existió (acuerdo, entrega y pago). Primero los que están en 69-B definitivo (corre su plazo de 30 días hábiles), después los de más importe sin probar. Una página, hasta 500. Sin fechas, este año hasta hoy. No usa timbres.
11440
+ *
11441
+ * GET /v1/materiality_suppliers
11442
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/list-materiality-suppliers
11443
+ */
11444
+ list(params?: ListMaterialitySuppliersParams, options?: RequestOptions): Promise<MaterialitySupplierList>;
11445
+ }
11446
+ /** Cumplimiento SAT: fiscalisto.materialityInvoices. */
11447
+ export declare class MaterialityInvoicesResource {
11448
+ #private;
11449
+ constructor(client: Client);
11450
+ /**
11451
+ * Listar facturas recibidas por probar
11452
+ *
11453
+ * Las facturas recibidas (ingresos) del emisor en un periodo que no tienen su evidencia completa, de mayor a menor importe, cada una con lo que tiene, lo que le falta y de dónde salió cada evidencia (orden de compra, recepción, complemento de pago, banco, archivos). Con state, solo las de ese estado. Una página, hasta 300; has_more dice que hay más (acorte el periodo o filtre por proveedor). No usa timbres.
11454
+ *
11455
+ * GET /v1/materiality_invoices
11456
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/list-materiality-invoices
11457
+ */
11458
+ list(params?: ListMaterialityInvoicesParams, options?: RequestOptions): Promise<MaterialityInvoiceList>;
11459
+ }
10998
11460
  /** Inventario: fiscalisto.warehouses. */
10999
11461
  export declare class WarehousesResource {
11000
11462
  #private;
@@ -11668,7 +12130,7 @@ export declare class AccountingResource {
11668
12130
  /**
11669
12131
  * Descargar la contabilidad electrónica
11670
12132
  *
11671
- * El ZIP del mes para el Buzón Tributario: el catálogo (CT) y la balanza (BN, o BC si es complementaria), cada uno en su ZIP con el nombre que espera el SAT, en el formato 1.3 del Anexo 24. Con journal_request, también las pólizas (PL), que se entregan cuando el SAT las pide.
12133
+ * El ZIP del mes para el Buzón Tributario: el catálogo (CT) y la balanza (BN, o BC si es complementaria), cada uno en su ZIP con el nombre que espera el SAT, en el formato 1.3 del Anexo 24. Con journal_request, también las pólizas (PL), que se entregan cuando el SAT las pide. Con month AAAA-13, la balanza de comprobación ajustada al cierre del ejercicio (regla 2.8.1.6 RMF): solo la balanza, con los saldos finales de diciembre como saldos iniciales y, con closing_entry, la póliza de cierre.
11672
12134
  *
11673
12135
  * GET /v1/accounting/electronic_accounting
11674
12136
  * @see https://fiscalisto.com/docs/api/referencia/contabilidad/get-electronic-accounting
@@ -12184,6 +12646,7 @@ export declare class FiscalistoApi extends Core {
12184
12646
  readonly invoices: InvoicesResource;
12185
12647
  readonly receivables: ReceivablesResource;
12186
12648
  readonly customers: CustomersResource;
12649
+ readonly cashForecast: CashForecastResource;
12187
12650
  readonly bankTransactions: BankTransactionsResource;
12188
12651
  readonly purchaseReceipts: PurchaseReceiptsResource;
12189
12652
  readonly payments: PaymentsResource;
@@ -12211,6 +12674,8 @@ export declare class FiscalistoApi extends Core {
12211
12674
  readonly satMailboxMessages: SatMailboxMessagesResource;
12212
12675
  readonly satFindings: SatFindingsResource;
12213
12676
  readonly satFindingCounterparties: SatFindingCounterpartiesResource;
12677
+ readonly materialitySuppliers: MaterialitySuppliersResource;
12678
+ readonly materialityInvoices: MaterialityInvoicesResource;
12214
12679
  readonly warehouses: WarehousesResource;
12215
12680
  readonly stockMovements: StockMovementsResource;
12216
12681
  readonly stockAdjustments: StockAdjustmentsResource;