fiscalisto 0.1.32 → 0.1.34

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.
@@ -691,6 +691,12 @@ export interface Customer {
691
691
  } | null;
692
692
  /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
693
693
  ieps_taxpayer: boolean;
694
+ /** Su grupo de clientes (cgr_…), o null si no está en ninguno. */
695
+ group: string | null;
696
+ /** Lista de precios (prl_…). En un cliente, la suya propia, que gana a la de su grupo; null para usar la de su grupo o la de todos. */
697
+ price_list: string | null;
698
+ /** Porcentaje de descuento sobre el precio, de 0 a 100; en el CFDI va como Descuento de cada concepto. */
699
+ discount_percent: number | null;
694
700
  /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
695
701
  created_at: string;
696
702
  /** Cuándo cambió por última vez, ISO 8601 (-06:00). */
@@ -751,6 +757,12 @@ export interface Product {
751
757
  barcode: string | null;
752
758
  /** Su existencia mínima, o null. */
753
759
  min_stock: number | null;
760
+ /** true si se ofrece en el Portal del cliente para hacer pedidos. */
761
+ portal_visible: boolean;
762
+ /** Lo mínimo que se pide de él en el Portal del cliente, o null sin mínimo. */
763
+ min_order_qty: number | null;
764
+ /** De cuántos en cuántos se pide en el Portal del cliente (6 para pedir 6, 12, 18…), o null de uno en uno. */
765
+ order_step: number | null;
754
766
  /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
755
767
  created_at: string;
756
768
  /** Cuándo cambió por última vez, ISO 8601 (-06:00). */
@@ -1829,6 +1841,118 @@ export interface CostCenter {
1829
1841
  /** Cuándo cambió por última vez. */
1830
1842
  updated_at: string | null;
1831
1843
  }
1844
+ /** Una lista de precios: parte del precio del catálogo (o de otra lista), lo mueve un porcentaje y lo redondea, con precios propios por producto, presentación y desde cierta cantidad (escalones de mayoreo). items solo viene al ver una lista. */
1845
+ export interface PriceList {
1846
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1847
+ id: string;
1848
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1849
+ livemode: boolean;
1850
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1851
+ object: "price_list";
1852
+ /** El emisor (iss_…). */
1853
+ issuer: string;
1854
+ /** Nombre. */
1855
+ name: string;
1856
+ /** Descripción. */
1857
+ description: string | null;
1858
+ /** La lista (prl_…) de la que parte; null parte del precio del catálogo de cada producto. */
1859
+ base_list: string | null;
1860
+ /** Cuánto sube (positivo) o baja (negativo) el precio del que parte, en porcentaje. */
1861
+ adjust_percent: number;
1862
+ /** A cuánto redondea los precios que calcula (0.5, 1, 10…), o null sin redondear. */
1863
+ round_to: number | null;
1864
+ /** Desde qué día vale (YYYY-MM-DD, Ciudad de México), o null desde siempre. */
1865
+ starts_on: string | null;
1866
+ /** Hasta qué día vale, ese día incluido (YYYY-MM-DD), o null sin fin. */
1867
+ ends_on: string | null;
1868
+ /** true si es la lista de todos los clientes que no tienen otra (solo puede haber una). */
1869
+ is_default: boolean;
1870
+ /** false la pausa; true la reanuda desde hoy. */
1871
+ active: boolean;
1872
+ /** Cuántos grupos de clientes la usan. */
1873
+ groups: number;
1874
+ /** Cuántos clientes la tienen como suya. */
1875
+ customers: number;
1876
+ /** Conceptos (Conceptos), al menos uno. */
1877
+ items: {
1878
+ /** Un producto de su catálogo (prd_…): toma su clave, unidad, precio e impuestos. */
1879
+ product: string;
1880
+ /** Unidad aduana (UnidadAduana), c_UnidadAduana. */
1881
+ unit: string | null;
1882
+ /** Desde cuántas unidades (de su presentación) vale este precio: un escalón de mayoreo. 1 por omisión. */
1883
+ min_quantity: number;
1884
+ /** Precio unitario antes de impuestos (ValorUnitario). */
1885
+ unit_price: number | null;
1886
+ /** Porcentaje que baja el precio de la lista para este producto, en vez de un precio fijo. */
1887
+ discount_percent: number | null;
1888
+ }[] | null;
1889
+ /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
1890
+ created_at: string | null;
1891
+ /** Cuándo cambió por última vez, ISO 8601 (-06:00). */
1892
+ updated_at: string | null;
1893
+ }
1894
+ /** Un grupo de clientes: su lista de precios, descuento, días de crédito, pedido mínimo y si piden desde su Portal del cliente. */
1895
+ export interface CustomerGroup {
1896
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1897
+ id: string;
1898
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1899
+ livemode: boolean;
1900
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1901
+ object: "customer_group";
1902
+ /** El emisor (iss_…). */
1903
+ issuer: string;
1904
+ /** Nombre. */
1905
+ name: string;
1906
+ /** Color de su etiqueta en la app: info, warning, positive, critical o muted. */
1907
+ color: string;
1908
+ /** Lista de precios (prl_…). En un cliente, la suya propia, que gana a la de su grupo; null para usar la de su grupo o la de todos. */
1909
+ price_list: string | null;
1910
+ /** Porcentaje de descuento sobre el precio, de 0 a 100; en el CFDI va como Descuento de cada concepto. */
1911
+ discount_percent: number;
1912
+ /** Días de crédito que se le dan, de 0 a 365, o null para no cambiar los del cliente. */
1913
+ credit_days: number | null;
1914
+ /** Pedido mínimo, sin IVA, para pedir desde el Portal del cliente, o null sin mínimo. */
1915
+ min_order: number | null;
1916
+ /** true si sus clientes pueden hacer pedidos desde su Portal del cliente. */
1917
+ portal_ordering: boolean;
1918
+ /** Cuántos clientes hay en el grupo. */
1919
+ customers: number;
1920
+ /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
1921
+ created_at: string | null;
1922
+ }
1923
+ /** Lo que un cliente paga por unos productos a una cantidad: su precio por unidad sin IVA (de su lista), su descuento y el siguiente escalón de mayoreo. */
1924
+ export interface PriceQuote {
1925
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1926
+ object: "price_quote";
1927
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1928
+ livemode: boolean;
1929
+ /** El cliente (cus_…) cuyos precios se calcularon. */
1930
+ customer: string;
1931
+ /** Conceptos (Conceptos), al menos uno. */
1932
+ items: {
1933
+ /** Un producto de su catálogo (prd_…): toma su clave, unidad, precio e impuestos. */
1934
+ product: string;
1935
+ /** Cantidad (Cantidad). Por omisión 1. */
1936
+ quantity: number;
1937
+ /** Unidad aduana (UnidadAduana), c_UnidadAduana. */
1938
+ unit: string | null;
1939
+ /** Precio unitario antes de impuestos (ValorUnitario). */
1940
+ unit_price: number;
1941
+ /** Su precio del catálogo, por unidad y sin IVA, antes de su lista. */
1942
+ catalog_price: number;
1943
+ /** El descuento del cliente (el suyo, o el de su grupo) sobre ese precio; va como Descuento en el CFDI. */
1944
+ discount_percent: number;
1945
+ /** La lista (prl_…) de donde sale el precio, o null si es el del catálogo. */
1946
+ price_list: string | null;
1947
+ /** El siguiente escalón de mayoreo: desde qué cantidad y a qué precio. null si no hay. */
1948
+ next_step: {
1949
+ /** Desde cuántas unidades (de su presentación) vale este precio: un escalón de mayoreo. 1 por omisión. */
1950
+ min_quantity: number;
1951
+ /** Precio unitario antes de impuestos (ValorUnitario). */
1952
+ unit_price: number;
1953
+ } | null;
1954
+ }[];
1955
+ }
1832
1956
  /** Alguien que viaja o gasta por el emisor: un empleado (de Nómina) o alguien por honorarios. Tiene un enlace propio para subir sus facturas sin cuenta. */
1833
1957
  export interface ExpensePerson {
1834
1958
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -3177,6 +3301,158 @@ export interface Quote {
3177
3301
  /** Cuándo se creó. */
3178
3302
  created_at: string | null;
3179
3303
  }
3304
+ /** Un pedido de venta: lo que su cliente pidió, cómo se entrega (remisiones) y cómo se factura y se cobra. */
3305
+ export interface SalesOrder {
3306
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3307
+ id: string;
3308
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
3309
+ livemode: boolean;
3310
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3311
+ object: "sales_order";
3312
+ /** El emisor (iss_…). */
3313
+ issuer: string;
3314
+ /** Su serie y folio (PED-12). */
3315
+ number: string;
3316
+ /** draft (borrador), confirmed, partially_delivered, delivered (todo entregado), invoiced (todo facturado), paid (sus facturas pagadas), closed (se dio por terminado) o canceled. Cambia solo, con lo que pasa. */
3317
+ status: "draft" | "confirmed" | "partially_delivered" | "delivered" | "invoiced" | "paid" | "closed" | "canceled";
3318
+ /** La etapa del negocio en que va («Por empacar», «En ruta»…), o null. Se elige en la app. */
3319
+ stage: string | null;
3320
+ /** La liga donde su cliente ve el pedido, lo confirma, firma cada entrega y abre sus facturas. null mientras sea borrador o no se haya mandado. */
3321
+ url: string | null;
3322
+ /** El cliente: su RFC, nombre, correo y su id en su catálogo. */
3323
+ customer: {
3324
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
3325
+ tax_id: string | null;
3326
+ /** Nombre. */
3327
+ name: string | null;
3328
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
3329
+ email: string | null;
3330
+ /** El cliente (cus_…) en su catálogo, o null si no está en él. */
3331
+ catalog_id: string | null;
3332
+ };
3333
+ /** El número de orden de compra de su cliente, o null. */
3334
+ customer_po: string | null;
3335
+ /** La cotización (quo_…) de donde salió, o null. */
3336
+ quote: string | null;
3337
+ /** La moneda. */
3338
+ currency: string;
3339
+ /** Los conceptos: id (para entregar o facturar una parte), lo pedido, lo entregado, lo facturado y lo que ya no se entregará (canceled). goods es true cuando sale del almacén. */
3340
+ items: {
3341
+ /** El id del concepto en el pedido: con él entrega o factura una parte (line). */
3342
+ id: number;
3343
+ /** Descripción del concepto (Descripcion), hasta 1,000 caracteres. */
3344
+ description: string;
3345
+ /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
3346
+ product_key: string | null;
3347
+ /** Cantidad (Cantidad). Por omisión 1. */
3348
+ quantity: number;
3349
+ /** La unidad, como la ve el cliente. */
3350
+ unit: string | null;
3351
+ /** Precio unitario antes de impuestos (ValorUnitario). */
3352
+ unit_price: number;
3353
+ /** El descuento del concepto, en dinero. */
3354
+ discount: number;
3355
+ /** El importe del concepto, sin impuestos. */
3356
+ amount: number;
3357
+ /** true si sale del almacén con cada entrega; false si es un servicio (solo se factura). */
3358
+ goods: boolean;
3359
+ /** Cuánto ya se entregó. */
3360
+ delivered: number;
3361
+ /** Cuánto ya se facturó. */
3362
+ invoiced: number;
3363
+ /** Cuánto ya no se entregará (POST /v1/sales_orders/{id}/cancel_remaining). */
3364
+ canceled: number;
3365
+ }[];
3366
+ /** El subtotal, sin impuestos. */
3367
+ subtotal: number;
3368
+ /** El total con impuestos. */
3369
+ total: number;
3370
+ /** La suma de sus facturas timbradas (sin las canceladas). */
3371
+ invoiced_total: number;
3372
+ /** Lo que ya se pagó de esas facturas. */
3373
+ paid_total: number;
3374
+ /** La entrega estimada (AAAA-MM-DD), o null. */
3375
+ expected_on: string | null;
3376
+ /** Días de crédito: cada factura vence esos días después de su fecha. */
3377
+ payment_days: number;
3378
+ /** delivered: cada factura lleva lo ya entregado; ordered: se factura lo pedido, entregado o no. */
3379
+ invoice_policy: "delivered" | "ordered";
3380
+ /** Dónde se entrega, o null. */
3381
+ ship_to: string | null;
3382
+ /** Las condiciones impresas en el pedido, o null. */
3383
+ terms: string | null;
3384
+ /** Las notas, como las de una factura. */
3385
+ notes: string | null;
3386
+ /** La nota interna (su cliente no la ve), o null. */
3387
+ internal_note: string | null;
3388
+ /** Sus entregas, cada una con su remisión. */
3389
+ deliveries: SalesOrderDelivery[];
3390
+ /** Sus facturas timbradas (inv_…), con lo que falta por pagar de cada una (balance). */
3391
+ invoices: {
3392
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3393
+ id: string;
3394
+ /** stamped, o canceled (lo que llevaba se puede volver a facturar). */
3395
+ status: "stamped" | "canceled";
3396
+ /** El total de la factura. */
3397
+ total: number;
3398
+ /** Lo que falta por pagar de esa factura, o null si aún no se sabe. */
3399
+ balance: number | null;
3400
+ }[];
3401
+ /** Cuándo su cliente lo confirmó en su liga, o null. */
3402
+ customer_confirmed_at: string | null;
3403
+ /** Cuándo se mandó, o null. */
3404
+ sent_at: string | null;
3405
+ /** Cuándo su cliente abrió la liga por primera vez, o null. */
3406
+ viewed_at: string | null;
3407
+ /** Cuándo se confirmó, o null. */
3408
+ confirmed_at: string | null;
3409
+ /** Cuándo quedó todo entregado, o null. */
3410
+ delivered_at: string | null;
3411
+ /** Cuándo quedó todo facturado, o null. */
3412
+ invoiced_at: string | null;
3413
+ /** Cuándo quedaron pagadas sus facturas, o null. */
3414
+ paid_at: string | null;
3415
+ /** Cuándo se cerró, o null. */
3416
+ closed_at: string | null;
3417
+ /** Cuándo se canceló, o null. */
3418
+ canceled_at: string | null;
3419
+ /** Por qué se canceló, o null. */
3420
+ cancel_reason: string | null;
3421
+ /** Cuándo se creó. */
3422
+ created_at: string | null;
3423
+ }
3424
+ /** Una entrega del pedido, con su remisión (REM-1): lo que salió del almacén. */
3425
+ export interface SalesOrderDelivery {
3426
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3427
+ id: string;
3428
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3429
+ object: "sales_order_delivery";
3430
+ /** Su remisión (REM-1). */
3431
+ number: string;
3432
+ /** delivered, o canceled (la mercancía regresó al almacén). */
3433
+ status: "delivered" | "canceled";
3434
+ /** El día en que salió (AAAA-MM-DD). */
3435
+ delivered_on: string;
3436
+ /** El transporte, o null. */
3437
+ carrier: string | null;
3438
+ /** El número de guía, o null. */
3439
+ tracking: string | null;
3440
+ /** Una nota, o null. */
3441
+ note: string | null;
3442
+ /** Quién recibió (lo firmó en la liga o lo anotó usted), o null. */
3443
+ received_by: string | null;
3444
+ /** Cuándo se recibió, o null. */
3445
+ received_at: string | null;
3446
+ /** Cuánto salió de cada concepto (line es items[].id del pedido). */
3447
+ items: {
3448
+ /** El concepto del pedido (su items[].id). */
3449
+ line: number;
3450
+ /** Cuánto salió de él. */
3451
+ quantity: number;
3452
+ }[];
3453
+ /** Cuándo se registró. */
3454
+ created_at: string | null;
3455
+ }
3180
3456
  /** Lo que un cliente le debe a un emisor en una moneda, de sus facturas abiertas. */
3181
3457
  export interface Receivable {
3182
3458
  /** El RFC y la moneda (RFC:MXN): para starting_after. */
@@ -3491,14 +3767,14 @@ export interface WebhookTest {
3491
3767
  };
3492
3768
  }
3493
3769
  /** Lo que puede pasar: el tipo de cada evento. */
3494
- export type EventType = "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "issuer.ready" | "balance.low" | "test_clock.ready";
3770
+ export type EventType = "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "issuer.ready" | "balance.low" | "test_clock.ready";
3495
3771
  /** Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks). */
3496
3772
  export interface EventBase<T extends EventType = EventType, O = unknown> {
3497
3773
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3498
3774
  id: string;
3499
3775
  /** Qué tipo de objeto es («invoice», «customer»…). */
3500
3776
  object: "event";
3501
- /** Qué pasó: invoice.stamped, invoice.failed, invoice.canceled, invoice.cancellation_pending, invoice.cancellation_rejected, invoice.paid, invoice.partially_paid, retention.stamped, retention.failed, retention.canceled, invoice_batch.completed, payroll_batch.completed, customer_data_request.completed, sat_download.completed, sat_download.failed, sat_declaration.created, sat_declaration.updated, ticket.invoiced, ticket.included_in_global, recurring_invoice.failed, quote.viewed, quote.accepted, quote.changes_requested, quote.rejected, quote.withdrawn, issuer.ready, balance.low o test_clock.ready. */
3777
+ /** Qué pasó: invoice.stamped, invoice.failed, invoice.canceled, invoice.cancellation_pending, invoice.cancellation_rejected, invoice.paid, invoice.partially_paid, retention.stamped, retention.failed, retention.canceled, invoice_batch.completed, payroll_batch.completed, customer_data_request.completed, sat_download.completed, sat_download.failed, sat_declaration.created, sat_declaration.updated, ticket.invoiced, ticket.included_in_global, recurring_invoice.failed, quote.viewed, quote.accepted, quote.changes_requested, quote.rejected, quote.withdrawn, sales_order.confirmed, sales_order.customer_confirmed, sales_order.delivered, sales_order.paid, sales_order.canceled, issuer.ready, balance.low o test_clock.ready. */
3502
3778
  type: T;
3503
3779
  /** Versión de la API con que se armó el objeto. */
3504
3780
  api_version: string;
@@ -3512,7 +3788,7 @@ export interface EventBase<T extends EventType = EventType, O = unknown> {
3512
3788
  };
3513
3789
  }
3514
3790
  /** Un evento: según su type, data.object es la factura, la constancia o el lote. */
3515
- export type Event = EventBase<"invoice.stamped", Invoice> | EventBase<"invoice.failed", Invoice> | EventBase<"invoice.canceled", Invoice> | EventBase<"invoice.cancellation_pending", Invoice> | EventBase<"invoice.cancellation_rejected", Invoice> | EventBase<"invoice.paid", Invoice> | EventBase<"invoice.partially_paid", Invoice> | EventBase<"invoice.email_bounced", Invoice> | EventBase<"invoice.email_complained", Invoice> | EventBase<"retention.stamped", Retention> | EventBase<"retention.failed", Retention> | EventBase<"retention.canceled", Retention> | EventBase<"invoice_batch.completed", InvoiceBatch> | EventBase<"payroll_batch.completed", PayrollBatch> | EventBase<"customer_data_request.completed", CustomerDataRequest> | EventBase<"sat_download.completed", SatDownload> | EventBase<"sat_download.failed", SatDownload> | EventBase<"sat_declaration.created", SatDeclaration> | EventBase<"sat_declaration.updated", SatDeclaration> | EventBase<"ticket.invoiced", Ticket> | EventBase<"ticket.included_in_global", Ticket> | EventBase<"recurring_invoice.failed", RecurringInvoice> | EventBase<"quote.viewed", Quote> | EventBase<"quote.accepted", Quote> | EventBase<"quote.changes_requested", Quote> | EventBase<"quote.rejected", Quote> | EventBase<"quote.withdrawn", Quote> | EventBase<"issuer.ready", Issuer> | EventBase<"balance.low", Balance> | EventBase<"test_clock.ready", TestClock>;
3791
+ export type Event = EventBase<"invoice.stamped", Invoice> | EventBase<"invoice.failed", Invoice> | EventBase<"invoice.canceled", Invoice> | EventBase<"invoice.cancellation_pending", Invoice> | EventBase<"invoice.cancellation_rejected", Invoice> | EventBase<"invoice.paid", Invoice> | EventBase<"invoice.partially_paid", Invoice> | EventBase<"invoice.email_bounced", Invoice> | EventBase<"invoice.email_complained", Invoice> | EventBase<"retention.stamped", Retention> | EventBase<"retention.failed", Retention> | EventBase<"retention.canceled", Retention> | EventBase<"invoice_batch.completed", InvoiceBatch> | EventBase<"payroll_batch.completed", PayrollBatch> | EventBase<"customer_data_request.completed", CustomerDataRequest> | EventBase<"sat_download.completed", SatDownload> | EventBase<"sat_download.failed", SatDownload> | EventBase<"sat_declaration.created", SatDeclaration> | EventBase<"sat_declaration.updated", SatDeclaration> | EventBase<"ticket.invoiced", Ticket> | EventBase<"ticket.included_in_global", Ticket> | EventBase<"recurring_invoice.failed", RecurringInvoice> | EventBase<"quote.viewed", Quote> | EventBase<"quote.accepted", Quote> | EventBase<"quote.changes_requested", Quote> | EventBase<"quote.rejected", Quote> | EventBase<"quote.withdrawn", Quote> | EventBase<"sales_order.confirmed", SalesOrder> | EventBase<"sales_order.customer_confirmed", SalesOrder> | EventBase<"sales_order.delivered", SalesOrder> | EventBase<"sales_order.paid", SalesOrder> | EventBase<"sales_order.canceled", SalesOrder> | EventBase<"issuer.ready", Issuer> | EventBase<"balance.low", Balance> | EventBase<"test_clock.ready", TestClock>;
3516
3792
  /** Confirmación de que se borró. */
3517
3793
  export interface Deleted {
3518
3794
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -3684,6 +3960,26 @@ export interface CostCenterList {
3684
3960
  /** La ruta de esta lista. */
3685
3961
  url: string;
3686
3962
  }
3963
+ export interface PriceListList {
3964
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3965
+ object: "list";
3966
+ /** Los objetos de esta página. */
3967
+ data: PriceList[];
3968
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3969
+ has_more: boolean;
3970
+ /** La ruta de esta lista. */
3971
+ url: string;
3972
+ }
3973
+ export interface CustomerGroupList {
3974
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3975
+ object: "list";
3976
+ /** Los objetos de esta página. */
3977
+ data: CustomerGroup[];
3978
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3979
+ has_more: boolean;
3980
+ /** La ruta de esta lista. */
3981
+ url: string;
3982
+ }
3687
3983
  export interface ExpensePersonList {
3688
3984
  /** Qué tipo de objeto es («invoice», «customer»…). */
3689
3985
  object: "list";
@@ -3914,6 +4210,16 @@ export interface QuoteList {
3914
4210
  /** La ruta de esta lista. */
3915
4211
  url: string;
3916
4212
  }
4213
+ export interface SalesOrderList {
4214
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4215
+ object: "list";
4216
+ /** Los objetos de esta página. */
4217
+ data: SalesOrder[];
4218
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4219
+ has_more: boolean;
4220
+ /** La ruta de esta lista. */
4221
+ url: string;
4222
+ }
3917
4223
  export interface WebhookEndpointList {
3918
4224
  /** Qué tipo de objeto es («invoice», «customer»…). */
3919
4225
  object: "list";
@@ -6142,6 +6448,137 @@ export interface DeleteCostCenterParams {
6142
6448
  /** Otro centro de costo (ccn_…) que se queda con sus facturas. */
6143
6449
  move_to?: string;
6144
6450
  }
6451
+ export interface CreatePriceListParams {
6452
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6453
+ issuer?: string;
6454
+ /** Mayoreo, Distribuidor, Buen Fin… */
6455
+ name: string;
6456
+ /** Descripción. */
6457
+ description?: string | null;
6458
+ /** Otra lista (prl_…) de la que parte; null o sin ella: el precio del catálogo. */
6459
+ base_list?: string | null;
6460
+ /** Cuánto mueve el precio del que parte: −10 lo baja 10 %, 5 lo sube 5 %. */
6461
+ adjust_percent?: number;
6462
+ /** Redondea a: 0.5, 1, 5, 10… (null: a centavos). */
6463
+ round_to?: number | null;
6464
+ /** Desde qué día vale (YYYY-MM-DD, Ciudad de México), o null desde siempre. */
6465
+ starts_on?: string | null;
6466
+ /** Hasta qué día vale, ese día incluido (YYYY-MM-DD), o null sin fin. */
6467
+ ends_on?: string | null;
6468
+ /** La tienen los clientes sin otra lista (ni ellos ni su grupo). Solo una lo es. */
6469
+ is_default?: boolean;
6470
+ /** Sus precios propios; al mandarlos reemplazan a los que tenía. */
6471
+ items?: {
6472
+ /** El producto (prd_…). */
6473
+ product: string;
6474
+ /** Una presentación del producto (su id de unidad, un entero de GET /v1/products/{id}/units), por ejemplo una caja de 12; null o sin él: su propia unidad. */
6475
+ unit?: string | null;
6476
+ /** Desde cuántas aplica (1 por omisión): varios renglones del mismo producto son sus escalones de mayoreo. */
6477
+ min_quantity?: number;
6478
+ /** Su precio por unidad sin IVA. Mande este o discount_percent. */
6479
+ unit_price?: number;
6480
+ /** Un descuento sobre el precio de la lista. Mande este o unit_price. */
6481
+ discount_percent?: number;
6482
+ }[];
6483
+ }
6484
+ /** Los parámetros de GET /v1/price_lists. */
6485
+ export interface ListPriceListsParams {
6486
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
6487
+ limit?: number;
6488
+ /** El id del último de la página anterior, para la siguiente. */
6489
+ starting_after?: string;
6490
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
6491
+ issuer?: string;
6492
+ }
6493
+ export interface UpdatePriceListParams {
6494
+ /** Mayoreo, Distribuidor, Buen Fin… */
6495
+ name?: string;
6496
+ /** Descripción. */
6497
+ description?: string | null;
6498
+ /** Otra lista (prl_…) de la que parte; null o sin ella: el precio del catálogo. */
6499
+ base_list?: string | null;
6500
+ /** Cuánto mueve el precio del que parte: −10 lo baja 10 %, 5 lo sube 5 %. */
6501
+ adjust_percent?: number;
6502
+ /** Redondea a: 0.5, 1, 5, 10… (null: a centavos). */
6503
+ round_to?: number | null;
6504
+ /** Desde qué día vale (YYYY-MM-DD, Ciudad de México), o null desde siempre. */
6505
+ starts_on?: string | null;
6506
+ /** Hasta qué día vale, ese día incluido (YYYY-MM-DD), o null sin fin. */
6507
+ ends_on?: string | null;
6508
+ /** La tienen los clientes sin otra lista (ni ellos ni su grupo). Solo una lo es. */
6509
+ is_default?: boolean;
6510
+ /** Sus precios propios; al mandarlos reemplazan a los que tenía. */
6511
+ items?: {
6512
+ /** El producto (prd_…). */
6513
+ product: string;
6514
+ /** Una presentación del producto (su id de unidad, un entero de GET /v1/products/{id}/units), por ejemplo una caja de 12; null o sin él: su propia unidad. */
6515
+ unit?: string | null;
6516
+ /** Desde cuántas aplica (1 por omisión): varios renglones del mismo producto son sus escalones de mayoreo. */
6517
+ min_quantity?: number;
6518
+ /** Su precio por unidad sin IVA. Mande este o discount_percent. */
6519
+ unit_price?: number;
6520
+ /** Un descuento sobre el precio de la lista. Mande este o unit_price. */
6521
+ discount_percent?: number;
6522
+ }[];
6523
+ }
6524
+ export interface CreateCustomerGroupParams {
6525
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6526
+ issuer?: string;
6527
+ /** Nombre. */
6528
+ name: string;
6529
+ /** Color de su etiqueta en la app: info, warning, positive, critical o muted. */
6530
+ color?: "info" | "warning" | "positive" | "critical" | "muted";
6531
+ /** Su lista (prl_…); null: la que aplica a todos. */
6532
+ price_list?: string | null;
6533
+ /** Un descuento en cada concepto, como descuento del CFDI. */
6534
+ discount_percent?: number;
6535
+ /** Días de crédito que se le dan, de 0 a 365, o null para no cambiar los del cliente. */
6536
+ credit_days?: number | null;
6537
+ /** El pedido mínimo antes de IVA desde el Portal del cliente. */
6538
+ min_order?: number | null;
6539
+ /** Sus clientes pueden hacer pedidos desde su Portal del cliente (true por omisión). */
6540
+ portal_ordering?: boolean;
6541
+ }
6542
+ /** Los parámetros de GET /v1/customer_groups. */
6543
+ export interface ListCustomerGroupsParams {
6544
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
6545
+ limit?: number;
6546
+ /** El id del último de la página anterior, para la siguiente. */
6547
+ starting_after?: string;
6548
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
6549
+ issuer?: string;
6550
+ }
6551
+ export interface UpdateCustomerGroupParams {
6552
+ /** Nombre. */
6553
+ name?: string;
6554
+ /** Color de su etiqueta en la app: info, warning, positive, critical o muted. */
6555
+ color?: "info" | "warning" | "positive" | "critical" | "muted";
6556
+ /** Su lista (prl_…); null: la que aplica a todos. */
6557
+ price_list?: string | null;
6558
+ /** Un descuento en cada concepto, como descuento del CFDI. */
6559
+ discount_percent?: number;
6560
+ /** Días de crédito que se le dan, de 0 a 365, o null para no cambiar los del cliente. */
6561
+ credit_days?: number | null;
6562
+ /** El pedido mínimo antes de IVA desde el Portal del cliente. */
6563
+ min_order?: number | null;
6564
+ /** Sus clientes pueden hacer pedidos desde su Portal del cliente (true por omisión). */
6565
+ portal_ordering?: boolean;
6566
+ }
6567
+ export interface QuotePricesParams {
6568
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6569
+ issuer?: string;
6570
+ /** El cliente (cus_…) o su RFC. */
6571
+ customer: string;
6572
+ /** Conceptos (Conceptos), al menos uno. */
6573
+ items: {
6574
+ /** El producto (prd_…). */
6575
+ product: string;
6576
+ /** Cantidad (Cantidad). Por omisión 1. */
6577
+ quantity?: number;
6578
+ /** Unidad aduana (UnidadAduana), c_UnidadAduana. */
6579
+ unit?: string | null;
6580
+ }[];
6581
+ }
6145
6582
  export interface CreateExpensePersonParams {
6146
6583
  /** El emisor (iss_…). Por omisión, su único emisor. */
6147
6584
  issuer?: string;
@@ -6362,6 +6799,12 @@ export interface CreateCustomerParams {
6362
6799
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
6363
6800
  tax_id: string;
6364
6801
  } | null;
6802
+ /** Su grupo de clientes (cgr_…), o null para ninguno. */
6803
+ group?: string | null;
6804
+ /** Su propia lista de precios (prl_…), que gana sobre la de su grupo; null: la de su grupo o la de todos. */
6805
+ price_list?: string | null;
6806
+ /** Su propio descuento en cada concepto, en %; null: el de su grupo. */
6807
+ discount_percent?: number | null;
6365
6808
  /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
6366
6809
  ieps_taxpayer?: boolean;
6367
6810
  }
@@ -6396,6 +6839,12 @@ export interface UpdateCustomerParams {
6396
6839
  /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
6397
6840
  tax_id: string;
6398
6841
  } | null;
6842
+ /** Su grupo de clientes (cgr_…), o null para ninguno. */
6843
+ group?: string | null;
6844
+ /** Su propia lista de precios (prl_…), que gana sobre la de su grupo; null: la de su grupo o la de todos. */
6845
+ price_list?: string | null;
6846
+ /** Su propio descuento en cada concepto, en %; null: el de su grupo. */
6847
+ discount_percent?: number | null;
6399
6848
  /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
6400
6849
  ieps_taxpayer?: boolean;
6401
6850
  }
@@ -6466,6 +6915,12 @@ export interface CreateProductParams {
6466
6915
  barcode?: string | null;
6467
6916
  /** Existencia mínima: por debajo, el aviso de existencias bajas lo incluye. */
6468
6917
  min_stock?: number | null;
6918
+ /** Se vende en el Portal del cliente: sus clientes lo piden desde ahí, a sus precios (listas de precios), y el pedido llega por confirmar. */
6919
+ portal_visible?: boolean;
6920
+ /** Lo menos que se le pide desde el portal, en su unidad. */
6921
+ min_order_qty?: number | null;
6922
+ /** Se pide de tantos en tantos desde el portal (12: de 12 en 12). */
6923
+ order_step?: number | null;
6469
6924
  }
6470
6925
  /** Los parámetros de GET /v1/products. */
6471
6926
  export interface ListProductsParams {
@@ -6526,6 +6981,12 @@ export interface UpdateProductParams {
6526
6981
  barcode?: string | null;
6527
6982
  /** Existencia mínima: por debajo, el aviso de existencias bajas lo incluye. */
6528
6983
  min_stock?: number | null;
6984
+ /** Se vende en el Portal del cliente: sus clientes lo piden desde ahí, a sus precios (listas de precios), y el pedido llega por confirmar. */
6985
+ portal_visible?: boolean;
6986
+ /** Lo menos que se le pide desde el portal, en su unidad. */
6987
+ min_order_qty?: number | null;
6988
+ /** Se pide de tantos en tantos desde el portal (12: de 12 en 12). */
6989
+ order_step?: number | null;
6529
6990
  }
6530
6991
  /** Los parámetros de GET /v1/sat_mailbox_messages. */
6531
6992
  export interface ListSatMailboxMessagesParams {
@@ -7361,81 +7822,450 @@ export interface RejectQuoteParams {
7361
7822
  /** Por qué (queda en customer_comment; el cliente no la ve). */
7362
7823
  note?: string;
7363
7824
  }
7364
- export interface CreateWebhookEndpointParams {
7365
- /** Dirección https de su servidor que recibe los avisos. */
7366
- url: string;
7367
- /** Eventos que quiere recibir, o ["*"] para todos (por omisión). La lista con cuándo llega cada uno: [Tipos de evento](https://fiscalisto.com/docs/api/webhooks#tipos-de-evento). */
7368
- events?: string[] | null;
7369
- /** Para qué es, para usted (no se manda en los eventos). */
7370
- description?: string | null;
7371
- /** La versión de la API en que llegan sus eventos (por ejemplo 2026-10-24); null o sin mandar: la de la cuenta. Así actualiza un endpoint a la vez. */
7372
- api_version?: string | null;
7373
- }
7374
- /** Los parámetros de GET /v1/webhook_endpoints. */
7375
- export interface ListWebhookEndpointsParams {
7376
- /** Cuántos por página, de 1 a 100. Por omisión 10. */
7377
- limit?: number;
7378
- /** El id del último de la página anterior, para la siguiente. */
7379
- starting_after?: string;
7380
- }
7381
- export interface UpdateWebhookEndpointParams {
7382
- /** Dirección https de su servidor que recibe los avisos. */
7383
- url?: string;
7384
- /** Eventos que quiere recibir, o ["*"] para todos (por omisión). La lista con cuándo llega cada uno: [Tipos de evento](https://fiscalisto.com/docs/api/webhooks#tipos-de-evento). */
7385
- events?: string[] | null;
7386
- /** Para qué es, para usted (no se manda en los eventos). */
7387
- description?: string | null;
7388
- /** true para apagarlo sin borrarlo. */
7389
- disabled?: boolean;
7390
- /** La versión de la API en que llegan sus eventos (por ejemplo 2026-10-24); null o sin mandar: la de la cuenta. Así actualiza un endpoint a la vez. */
7391
- api_version?: string | null;
7392
- }
7393
- export interface RollWebhookSecretParams {
7394
- /** Segundos que el secreto anterior sigue firmando, de 0 (deja de firmar ya: úselo si se filtró) a 86400. Por omisión 86400 (24 horas). */
7395
- previous_secret_expires_in?: number;
7396
- }
7397
- export interface TestWebhookEndpointParams {
7398
- /** El evento a mandar. Por omisión invoice.stamped. */
7399
- type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "issuer.ready" | "balance.low" | "test_clock.ready";
7400
- }
7401
- /** Los parámetros de GET /v1/events. */
7402
- export interface ListEventsParams {
7403
- /** Cuántos por página, de 1 a 100. Por omisión 10. */
7404
- limit?: number;
7405
- /** El id del último de la página anterior, para la siguiente. */
7406
- starting_after?: string;
7407
- /** Solo de este tipo (invoice.stamped), o todos los de un recurso con un comodín (invoice.*). */
7408
- type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "issuer.ready" | "balance.low" | "test_clock.ready" | "invoice.*" | "invoice_batch.*" | "payroll_batch.*" | "recurring_invoice.*" | "quote.*" | "ticket.*" | "retention.*" | "customer_data_request.*" | "sat_download.*" | "sat_declaration.*" | "issuer.*" | "balance.*" | "test_clock.*";
7409
- /** Solo los de este objeto (inv_…, ret_…, bat_…). */
7410
- object?: string;
7411
- /** false: los que algún webhook no recibió (su último intento falló). true: los que recibieron todos los webhooks a los que se mandaron. */
7412
- delivery_success?: boolean;
7413
- }
7414
- /** Cuenta: fiscalisto.account. */
7415
- export declare class AccountResource {
7416
- #private;
7417
- constructor(client: Client);
7418
- /**
7419
- * Ver la cuenta
7420
- *
7421
- * La cuenta API y la llave con que se hizo la solicitud. Útil para probar la llave.
7422
- *
7423
- * GET /v1/account
7424
- * @see https://fiscalisto.com/docs/api/referencia/cuenta/get-account
7425
- */
7426
- get(options?: RequestOptions): Promise<Account>;
7427
- /**
7428
- * Cambiar la versión de la API
7429
- *
7430
- * Mueve la versión de la API de la cuenta: la que reciben sus solicitudes sin el encabezado Fiscalisto-Version y sus webhooks sin api_version propio. Antes, pruebe la nueva mandando Fiscalisto-Version en sus solicitudes. Con una llave de la cuenta con todos los permisos (no de un entorno de prueba). Queda en Desarrolladores › Actividad.
7431
- *
7432
- * POST /v1/account
7433
- * @see https://fiscalisto.com/docs/api/referencia/cuenta/update-account
7434
- */
7435
- update(params: UpdateAccountParams, options?: RequestOptions): Promise<Account>;
7436
- }
7437
- /** Cuenta: fiscalisto.testData. */
7438
- export declare class TestDataResource {
7825
+ export interface CreateSalesOrderParams {
7826
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
7827
+ issuer?: string;
7828
+ /** Hacerlo de una cotización (quo_…): toma su cliente y sus conceptos, y la cotización queda aceptada. Sin customer ni items. */
7829
+ quote?: string;
7830
+ /** Un cliente de su catálogo (cus_…) o uno con sus datos fiscales (como en POST /v1/invoices: se agrega a sus clientes). */
7831
+ customer?: string | {
7832
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
7833
+ tax_id: string;
7834
+ /** Nombre o razón social tal como está en la constancia de situación fiscal, sin el régimen de capital (sin «S.A. de C.V.»). */
7835
+ legal_name: string;
7836
+ /** Régimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626… */
7837
+ tax_system: string;
7838
+ /** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
7839
+ zip: string;
7840
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
7841
+ email?: string | null;
7842
+ /** Si es extranjero: su país de residencia (ResidenciaFiscal, c_Pais) y su número de registro tributario (NumRegIdTrib), con el RFC genérico XEXX010101000. */
7843
+ foreign?: {
7844
+ /** País de residencia fiscal, clave de 3 letras de c_Pais (USA, CAN…). */
7845
+ country: string;
7846
+ /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
7847
+ tax_id: string;
7848
+ };
7849
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
7850
+ ieps_taxpayer?: boolean;
7851
+ };
7852
+ /** Los conceptos, como en POST /v1/invoices (hasta 200). */
7853
+ items?: {
7854
+ /** Un producto de su catálogo (prd_…): toma su clave, unidad, precio e impuestos. */
7855
+ product?: string;
7856
+ /** Descripción del concepto (Descripcion), hasta 1,000 caracteres. */
7857
+ description?: string;
7858
+ /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
7859
+ product_key?: string;
7860
+ /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
7861
+ unit_key?: string;
7862
+ /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
7863
+ unit_name?: string | null;
7864
+ /** Número de identificación o SKU (NoIdentificacion). */
7865
+ sku?: string | null;
7866
+ /** Cantidad (Cantidad). Por omisión 1. */
7867
+ quantity?: number;
7868
+ /** Precio unitario antes de impuestos (ValorUnitario). */
7869
+ unit_price?: number;
7870
+ /** Descuento (Descuento). */
7871
+ discount?: number;
7872
+ /** Objeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa… */
7873
+ taxability?: "01" | "02" | "03" | "04" | "05" | "06" | "07" | "08";
7874
+ /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
7875
+ iva?: "0" | "0.16" | "0.08" | "exento";
7876
+ /** IEPS trasladado: tasa (0.265…) o cuota en pesos por unidad, según ieps_factor. */
7877
+ ieps?: number;
7878
+ /** Tasa o Cuota (TipoFactor del IEPS). */
7879
+ ieps_factor?: "Tasa" | "Cuota";
7880
+ /** Unidades de IEPS a cuota (litros, cigarros…), si no son la cantidad. */
7881
+ ieps_units?: number;
7882
+ /** Tasa de IVA retenido (por ejemplo 0.106667, dos terceras partes del 16%). */
7883
+ iva_retention?: number;
7884
+ /** Tasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO). */
7885
+ isr_retention?: number;
7886
+ /** Números de cuenta predial (CuentaPredial) en arrendamiento. */
7887
+ predial?: string[];
7888
+ /** Números de pedimento (InformacionAduanera) de mercancía importada. */
7889
+ pedimentos?: string[];
7890
+ /** A cuenta de terceros (ACuentaTerceros): RFC, nombre, régimen y código postal. */
7891
+ third_party?: {
7892
+ /** RFC de a cuenta de quién (RfcACuentaTerceros). */
7893
+ tax_id: string;
7894
+ /** Nombre (NombreACuentaTerceros). */
7895
+ name: string;
7896
+ /** Régimen fiscal (RegimenFiscalACuentaTerceros), c_RegimenFiscal. */
7897
+ tax_system: string;
7898
+ /** Código postal de su domicilio fiscal (DomicilioFiscalACuentaTerceros). */
7899
+ zip: string;
7900
+ };
7901
+ /** Complemento de instituciones educativas privadas (IEDU): alumno, CURP, nivel y RVOE. */
7902
+ iedu?: {
7903
+ /** Nombre del alumno (nombreAlumno). */
7904
+ student_name: string;
7905
+ /** CURP, 18 caracteres. */
7906
+ curp: string;
7907
+ /** Nivel educativo (nivelEducativo). */
7908
+ level: "Preescolar" | "Primaria" | "Secundaria" | "Profesional técnico" | "Bachillerato o su equivalente";
7909
+ /** Reconocimiento de validez oficial de estudios (autRVOE). */
7910
+ rvoe: string;
7911
+ /** RFC de quien paga, si no es el receptor (rfcPago). */
7912
+ payer_tax_id?: string | null;
7913
+ };
7914
+ /** Complemento de vehículo usado. */
7915
+ used_vehicle?: {
7916
+ /** Monto de adquisición (montoAdquisicion). */
7917
+ purchase_amount: number;
7918
+ /** Monto de enajenación (montoEnajenacion). */
7919
+ sale_amount: number;
7920
+ /** Clave vehicular (claveVehicular). */
7921
+ vehicle_key: string;
7922
+ /** Marca (marca). */
7923
+ make: string;
7924
+ /** Tipo o versión (tipo). */
7925
+ type: string;
7926
+ /** Año del modelo (modelo), 4 dígitos. */
7927
+ model: string;
7928
+ /** Número de motor (numeroMotor). */
7929
+ engine_number?: string;
7930
+ /** Número de serie (numeroSerie). */
7931
+ serial_number?: string;
7932
+ /** Número de identificación vehicular (NIV). */
7933
+ niv?: string;
7934
+ /** Valor según la guía EBC o Libro Azul (valor). */
7935
+ guide_value: number;
7936
+ /** Información aduanera de la importación del vehículo (InformacionAduanera). */
7937
+ customs?: {
7938
+ /** Número del documento de importación (numero). */
7939
+ number: string;
7940
+ /** Fecha del documento (fecha), AAAA-MM-DD. */
7941
+ date: string;
7942
+ /** Aduana (aduana). */
7943
+ office?: string;
7944
+ }[];
7945
+ };
7946
+ /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
7947
+ addenda?: Record<string, string>;
7948
+ }[];
7949
+ /** Confirmarlo en el mismo paso (por omisión false: queda en draft). Confirmado, aparta lo pedido en el almacén. */
7950
+ confirm?: boolean;
7951
+ /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
7952
+ currency?: string;
7953
+ /** Tipo de cambio a pesos (TipoCambio). Obligatorio si la moneda no es MXN; use el del DOF del día anterior. */
7954
+ exchange_rate?: number;
7955
+ /** Forma de pago (FormaPago), clave de c_FormaPago: 01 efectivo, 03 transferencia, 04 tarjeta de crédito, 28 débito, 99 por definir… Obligatoria con PUE; con PPD es 99. */
7956
+ payment_form?: string;
7957
+ /** Método de pago (MetodoPago): PUE (una sola exhibición, por omisión) o PPD (en parcialidades o diferido, se cobra con complementos de pago). */
7958
+ payment_method?: "PUE" | "PPD";
7959
+ /** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
7960
+ use?: string;
7961
+ /** Observaciones que aparecen en el PDF (no van en el XML). */
7962
+ notes?: string;
7963
+ /** El número de orden de compra de su cliente (va en la nota de cada factura). */
7964
+ customer_po?: string;
7965
+ /** A dónde mandarle el pedido y sus remisiones (hasta 5 correos, separados por comas). Por omisión, el del cliente. */
7966
+ email?: string;
7967
+ /** Entrega estimada (AAAA-MM-DD). */
7968
+ expected_on?: string;
7969
+ /** Días de crédito (0: de contado). */
7970
+ payment_days?: number;
7971
+ /** Qué se factura: delivered (por omisión), lo ya entregado; ordered, todo lo pedido desde el inicio (por ejemplo con pago por adelantado). */
7972
+ invoice_policy?: "delivered" | "ordered";
7973
+ /** Dónde se entrega. */
7974
+ ship_to?: string;
7975
+ /** Condiciones del pedido. */
7976
+ terms?: string;
7977
+ /** Nota interna (su cliente no la ve). */
7978
+ internal_note?: string;
7979
+ }
7980
+ /** Los parámetros de GET /v1/sales_orders. */
7981
+ export interface ListSalesOrdersParams {
7982
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
7983
+ limit?: number;
7984
+ /** El id del último de la página anterior, para la siguiente. */
7985
+ starting_after?: string;
7986
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7987
+ issuer?: string;
7988
+ /** Solo los que estén en este estado. */
7989
+ status?: "draft" | "confirmed" | "partially_delivered" | "delivered" | "invoiced" | "paid" | "closed" | "canceled";
7990
+ /** Solo los de este RFC. */
7991
+ customer?: string;
7992
+ }
7993
+ export interface UpdateSalesOrderParams {
7994
+ /** Un cliente de su catálogo (cus_…) o uno con sus datos fiscales (como en POST /v1/invoices: se agrega a sus clientes). */
7995
+ customer?: string | {
7996
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
7997
+ tax_id: string;
7998
+ /** Nombre o razón social tal como está en la constancia de situación fiscal, sin el régimen de capital (sin «S.A. de C.V.»). */
7999
+ legal_name: string;
8000
+ /** Régimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626… */
8001
+ tax_system: string;
8002
+ /** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
8003
+ zip: string;
8004
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
8005
+ email?: string | null;
8006
+ /** Si es extranjero: su país de residencia (ResidenciaFiscal, c_Pais) y su número de registro tributario (NumRegIdTrib), con el RFC genérico XEXX010101000. */
8007
+ foreign?: {
8008
+ /** País de residencia fiscal, clave de 3 letras de c_Pais (USA, CAN…). */
8009
+ country: string;
8010
+ /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
8011
+ tax_id: string;
8012
+ };
8013
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
8014
+ ieps_taxpayer?: boolean;
8015
+ };
8016
+ /** Los conceptos, como en POST /v1/invoices (hasta 200). */
8017
+ items?: {
8018
+ /** Un producto de su catálogo (prd_…): toma su clave, unidad, precio e impuestos. */
8019
+ product?: string;
8020
+ /** Descripción del concepto (Descripcion), hasta 1,000 caracteres. */
8021
+ description?: string;
8022
+ /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
8023
+ product_key?: string;
8024
+ /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
8025
+ unit_key?: string;
8026
+ /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
8027
+ unit_name?: string | null;
8028
+ /** Número de identificación o SKU (NoIdentificacion). */
8029
+ sku?: string | null;
8030
+ /** Cantidad (Cantidad). Por omisión 1. */
8031
+ quantity?: number;
8032
+ /** Precio unitario antes de impuestos (ValorUnitario). */
8033
+ unit_price?: number;
8034
+ /** Descuento (Descuento). */
8035
+ discount?: number;
8036
+ /** Objeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa… */
8037
+ taxability?: "01" | "02" | "03" | "04" | "05" | "06" | "07" | "08";
8038
+ /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
8039
+ iva?: "0" | "0.16" | "0.08" | "exento";
8040
+ /** IEPS trasladado: tasa (0.265…) o cuota en pesos por unidad, según ieps_factor. */
8041
+ ieps?: number;
8042
+ /** Tasa o Cuota (TipoFactor del IEPS). */
8043
+ ieps_factor?: "Tasa" | "Cuota";
8044
+ /** Unidades de IEPS a cuota (litros, cigarros…), si no son la cantidad. */
8045
+ ieps_units?: number;
8046
+ /** Tasa de IVA retenido (por ejemplo 0.106667, dos terceras partes del 16%). */
8047
+ iva_retention?: number;
8048
+ /** Tasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO). */
8049
+ isr_retention?: number;
8050
+ /** Números de cuenta predial (CuentaPredial) en arrendamiento. */
8051
+ predial?: string[];
8052
+ /** Números de pedimento (InformacionAduanera) de mercancía importada. */
8053
+ pedimentos?: string[];
8054
+ /** A cuenta de terceros (ACuentaTerceros): RFC, nombre, régimen y código postal. */
8055
+ third_party?: {
8056
+ /** RFC de a cuenta de quién (RfcACuentaTerceros). */
8057
+ tax_id: string;
8058
+ /** Nombre (NombreACuentaTerceros). */
8059
+ name: string;
8060
+ /** Régimen fiscal (RegimenFiscalACuentaTerceros), c_RegimenFiscal. */
8061
+ tax_system: string;
8062
+ /** Código postal de su domicilio fiscal (DomicilioFiscalACuentaTerceros). */
8063
+ zip: string;
8064
+ };
8065
+ /** Complemento de instituciones educativas privadas (IEDU): alumno, CURP, nivel y RVOE. */
8066
+ iedu?: {
8067
+ /** Nombre del alumno (nombreAlumno). */
8068
+ student_name: string;
8069
+ /** CURP, 18 caracteres. */
8070
+ curp: string;
8071
+ /** Nivel educativo (nivelEducativo). */
8072
+ level: "Preescolar" | "Primaria" | "Secundaria" | "Profesional técnico" | "Bachillerato o su equivalente";
8073
+ /** Reconocimiento de validez oficial de estudios (autRVOE). */
8074
+ rvoe: string;
8075
+ /** RFC de quien paga, si no es el receptor (rfcPago). */
8076
+ payer_tax_id?: string | null;
8077
+ };
8078
+ /** Complemento de vehículo usado. */
8079
+ used_vehicle?: {
8080
+ /** Monto de adquisición (montoAdquisicion). */
8081
+ purchase_amount: number;
8082
+ /** Monto de enajenación (montoEnajenacion). */
8083
+ sale_amount: number;
8084
+ /** Clave vehicular (claveVehicular). */
8085
+ vehicle_key: string;
8086
+ /** Marca (marca). */
8087
+ make: string;
8088
+ /** Tipo o versión (tipo). */
8089
+ type: string;
8090
+ /** Año del modelo (modelo), 4 dígitos. */
8091
+ model: string;
8092
+ /** Número de motor (numeroMotor). */
8093
+ engine_number?: string;
8094
+ /** Número de serie (numeroSerie). */
8095
+ serial_number?: string;
8096
+ /** Número de identificación vehicular (NIV). */
8097
+ niv?: string;
8098
+ /** Valor según la guía EBC o Libro Azul (valor). */
8099
+ guide_value: number;
8100
+ /** Información aduanera de la importación del vehículo (InformacionAduanera). */
8101
+ customs?: {
8102
+ /** Número del documento de importación (numero). */
8103
+ number: string;
8104
+ /** Fecha del documento (fecha), AAAA-MM-DD. */
8105
+ date: string;
8106
+ /** Aduana (aduana). */
8107
+ office?: string;
8108
+ }[];
8109
+ };
8110
+ /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
8111
+ addenda?: Record<string, string>;
8112
+ }[];
8113
+ /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
8114
+ currency?: string;
8115
+ /** Tipo de cambio a pesos (TipoCambio). Obligatorio si la moneda no es MXN; use el del DOF del día anterior. */
8116
+ exchange_rate?: number;
8117
+ /** Forma de pago (FormaPago), clave de c_FormaPago: 01 efectivo, 03 transferencia, 04 tarjeta de crédito, 28 débito, 99 por definir… Obligatoria con PUE; con PPD es 99. */
8118
+ payment_form?: string;
8119
+ /** Método de pago (MetodoPago): PUE (una sola exhibición, por omisión) o PPD (en parcialidades o diferido, se cobra con complementos de pago). */
8120
+ payment_method?: "PUE" | "PPD";
8121
+ /** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
8122
+ use?: string;
8123
+ /** Observaciones que aparecen en el PDF (no van en el XML). */
8124
+ notes?: string;
8125
+ /** El número de orden de compra de su cliente (va en la nota de cada factura). */
8126
+ customer_po?: string;
8127
+ /** A dónde mandarle el pedido y sus remisiones (hasta 5 correos, separados por comas). Por omisión, el del cliente. */
8128
+ email?: string;
8129
+ /** Entrega estimada (AAAA-MM-DD). */
8130
+ expected_on?: string;
8131
+ /** Días de crédito (0: de contado). */
8132
+ payment_days?: number;
8133
+ /** Qué se factura: delivered (por omisión), lo ya entregado; ordered, todo lo pedido desde el inicio (por ejemplo con pago por adelantado). */
8134
+ invoice_policy?: "delivered" | "ordered";
8135
+ /** Dónde se entrega. */
8136
+ ship_to?: string;
8137
+ /** Condiciones del pedido. */
8138
+ terms?: string;
8139
+ /** Nota interna (su cliente no la ve). */
8140
+ internal_note?: string;
8141
+ }
8142
+ export interface CreateSalesOrderDeliveryParams {
8143
+ /** Cuánto sale de cada concepto. Por omisión, todo lo que falta por entregar. */
8144
+ items?: {
8145
+ /** El id del concepto (items[].id). */
8146
+ line: number;
8147
+ /** Cantidad (Cantidad). Por omisión 1. */
8148
+ quantity: number;
8149
+ }[];
8150
+ /** Por omisión, hoy. */
8151
+ delivered_on?: string;
8152
+ /** Transporte. */
8153
+ carrier?: string;
8154
+ /** Número de guía. */
8155
+ tracking?: string;
8156
+ /** Una nota en la remisión. */
8157
+ note?: string;
8158
+ /** Quién recibió, si ya lo sabe (si no, su cliente lo firma en url). */
8159
+ received_by?: string;
8160
+ }
8161
+ export interface CancelSalesOrderDeliveryParams {
8162
+ /** Por qué (queda en el historial). */
8163
+ reason?: string;
8164
+ }
8165
+ export interface InvoiceSalesOrderParams {
8166
+ /** Cuánto facturar de cada concepto. Por omisión, lo entregado sin facturar (o todo lo pedido con invoice_policy ordered). */
8167
+ items?: {
8168
+ /** El id del concepto (items[].id). */
8169
+ line: number;
8170
+ /** Cantidad (Cantidad). Por omisión 1. */
8171
+ quantity: number;
8172
+ }[];
8173
+ /** Facturar también lo que aún no se entrega (con invoice_policy delivered). */
8174
+ include_undelivered?: boolean;
8175
+ /** Registrar también la entrega de lo que lleva la factura al timbrarla (venta de mostrador). */
8176
+ deliver?: boolean;
8177
+ }
8178
+ export interface SendSalesOrderParams {
8179
+ /** Mandarlo por correo, con su PDF y url (por omisión true). Con false solo contesta url, para que usted la mande. */
8180
+ send_email?: boolean;
8181
+ /** A quién (hasta 5 correos). Por omisión, el correo del pedido. */
8182
+ to?: string;
8183
+ /** Qué pasó y cómo corregirlo, para una persona. */
8184
+ message?: string;
8185
+ }
8186
+ export interface CloseSalesOrderParams {
8187
+ /** Por qué (queda en el historial). */
8188
+ reason?: string;
8189
+ }
8190
+ export interface CancelSalesOrderParams {
8191
+ /** Por qué (queda en el historial). */
8192
+ reason?: string;
8193
+ }
8194
+ export interface CreateWebhookEndpointParams {
8195
+ /** Dirección https de su servidor que recibe los avisos. */
8196
+ url: string;
8197
+ /** Eventos que quiere recibir, o ["*"] para todos (por omisión). La lista con cuándo llega cada uno: [Tipos de evento](https://fiscalisto.com/docs/api/webhooks#tipos-de-evento). */
8198
+ events?: string[] | null;
8199
+ /** Para qué es, para usted (no se manda en los eventos). */
8200
+ description?: string | null;
8201
+ /** La versión de la API en que llegan sus eventos (por ejemplo 2026-10-24); null o sin mandar: la de la cuenta. Así actualiza un endpoint a la vez. */
8202
+ api_version?: string | null;
8203
+ }
8204
+ /** Los parámetros de GET /v1/webhook_endpoints. */
8205
+ export interface ListWebhookEndpointsParams {
8206
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
8207
+ limit?: number;
8208
+ /** El id del último de la página anterior, para la siguiente. */
8209
+ starting_after?: string;
8210
+ }
8211
+ export interface UpdateWebhookEndpointParams {
8212
+ /** Dirección https de su servidor que recibe los avisos. */
8213
+ url?: string;
8214
+ /** Eventos que quiere recibir, o ["*"] para todos (por omisión). La lista con cuándo llega cada uno: [Tipos de evento](https://fiscalisto.com/docs/api/webhooks#tipos-de-evento). */
8215
+ events?: string[] | null;
8216
+ /** Para qué es, para usted (no se manda en los eventos). */
8217
+ description?: string | null;
8218
+ /** true para apagarlo sin borrarlo. */
8219
+ disabled?: boolean;
8220
+ /** La versión de la API en que llegan sus eventos (por ejemplo 2026-10-24); null o sin mandar: la de la cuenta. Así actualiza un endpoint a la vez. */
8221
+ api_version?: string | null;
8222
+ }
8223
+ export interface RollWebhookSecretParams {
8224
+ /** Segundos que el secreto anterior sigue firmando, de 0 (deja de firmar ya: úselo si se filtró) a 86400. Por omisión 86400 (24 horas). */
8225
+ previous_secret_expires_in?: number;
8226
+ }
8227
+ export interface TestWebhookEndpointParams {
8228
+ /** El evento a mandar. Por omisión invoice.stamped. */
8229
+ type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "issuer.ready" | "balance.low" | "test_clock.ready";
8230
+ }
8231
+ /** Los parámetros de GET /v1/events. */
8232
+ export interface ListEventsParams {
8233
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
8234
+ limit?: number;
8235
+ /** El id del último de la página anterior, para la siguiente. */
8236
+ starting_after?: string;
8237
+ /** Solo de este tipo (invoice.stamped), o todos los de un recurso con un comodín (invoice.*). */
8238
+ type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "issuer.ready" | "balance.low" | "test_clock.ready" | "invoice.*" | "invoice_batch.*" | "payroll_batch.*" | "recurring_invoice.*" | "quote.*" | "sales_order.*" | "ticket.*" | "retention.*" | "customer_data_request.*" | "sat_download.*" | "sat_declaration.*" | "issuer.*" | "balance.*" | "test_clock.*";
8239
+ /** Solo los de este objeto (inv_…, ret_…, bat_…). */
8240
+ object?: string;
8241
+ /** false: los que algún webhook no recibió (su último intento falló). true: los que recibieron todos los webhooks a los que se mandaron. */
8242
+ delivery_success?: boolean;
8243
+ }
8244
+ /** Cuenta: fiscalisto.account. */
8245
+ export declare class AccountResource {
8246
+ #private;
8247
+ constructor(client: Client);
8248
+ /**
8249
+ * Ver la cuenta
8250
+ *
8251
+ * La cuenta API y la llave con que se hizo la solicitud. Útil para probar la llave.
8252
+ *
8253
+ * GET /v1/account
8254
+ * @see https://fiscalisto.com/docs/api/referencia/cuenta/get-account
8255
+ */
8256
+ get(options?: RequestOptions): Promise<Account>;
8257
+ /**
8258
+ * Cambiar la versión de la API
8259
+ *
8260
+ * Mueve la versión de la API de la cuenta: la que reciben sus solicitudes sin el encabezado Fiscalisto-Version y sus webhooks sin api_version propio. Antes, pruebe la nueva mandando Fiscalisto-Version en sus solicitudes. Con una llave de la cuenta con todos los permisos (no de un entorno de prueba). Queda en Desarrolladores › Actividad.
8261
+ *
8262
+ * POST /v1/account
8263
+ * @see https://fiscalisto.com/docs/api/referencia/cuenta/update-account
8264
+ */
8265
+ update(params: UpdateAccountParams, options?: RequestOptions): Promise<Account>;
8266
+ }
8267
+ /** Cuenta: fiscalisto.testData. */
8268
+ export declare class TestDataResource {
7439
8269
  #private;
7440
8270
  constructor(client: Client);
7441
8271
  /**
@@ -8517,6 +9347,120 @@ export declare class CostCentersResource {
8517
9347
  */
8518
9348
  delete(id: string, params?: DeleteCostCenterParams, options?: RequestOptions): Promise<Deleted>;
8519
9349
  }
9350
+ /** Listas de precios: fiscalisto.priceLists. */
9351
+ export declare class PriceListsResource {
9352
+ #private;
9353
+ constructor(client: Client);
9354
+ /**
9355
+ * Crear una lista de precios
9356
+ *
9357
+ * Parte del precio del catálogo (o de base_list, otra lista), lo mueve adjust_percent y lo redondea a round_to; con starts_on y ends_on es una promoción. items le pone precios propios por producto, por presentación (unit, una caja) y desde min_quantity (escalones de mayoreo), cada uno con unit_price o discount_percent. is_default: la tienen los clientes sin otra. Hasta 100.
9358
+ *
9359
+ * POST /v1/price_lists
9360
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/create-price-list
9361
+ */
9362
+ create(params: CreatePriceListParams, options?: RequestOptions): Promise<PriceList>;
9363
+ /**
9364
+ * Listar listas de precios
9365
+ *
9366
+ * Las listas de precios en el orden de la app, con cuántos grupos y clientes la tienen. items viene al ver una.
9367
+ *
9368
+ * GET /v1/price_lists
9369
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/list-price-lists
9370
+ */
9371
+ list(params?: ListPriceListsParams, options?: RequestOptions): List<PriceList>;
9372
+ /**
9373
+ * Ver una lista de precios
9374
+ *
9375
+ * Una lista de precios con sus precios propios (items).
9376
+ *
9377
+ * GET /v1/price_lists/{id}
9378
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/get-price-list
9379
+ */
9380
+ get(id: string, options?: RequestOptions): Promise<PriceList>;
9381
+ /**
9382
+ * Actualizar una lista de precios
9383
+ *
9384
+ * Cambia solo lo que manda; items reemplaza todos sus precios propios. Las facturas, cotizaciones y pedidos ya hechos no cambian.
9385
+ *
9386
+ * POST /v1/price_lists/{id}
9387
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/update-price-list
9388
+ */
9389
+ update(id: string, params?: UpdatePriceListParams, options?: RequestOptions): Promise<PriceList>;
9390
+ /**
9391
+ * Quitar una lista de precios
9392
+ *
9393
+ * La archiva: sus grupos y clientes pasan a la lista que aplica a todos (o al precio del catálogo).
9394
+ *
9395
+ * DELETE /v1/price_lists/{id}
9396
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/delete-price-list
9397
+ */
9398
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
9399
+ }
9400
+ /** Listas de precios: fiscalisto.customerGroups. */
9401
+ export declare class CustomerGroupsResource {
9402
+ #private;
9403
+ constructor(client: Client);
9404
+ /**
9405
+ * Crear un grupo de clientes
9406
+ *
9407
+ * Lo que tienen todos sus clientes: price_list, discount_percent (el descuento de cada concepto en el CFDI), credit_days, min_order (antes de IVA, desde el portal) y portal_ordering. Un cliente entra con group en POST /v1/customers/{id}.
9408
+ *
9409
+ * POST /v1/customer_groups
9410
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/create-customer-group
9411
+ */
9412
+ create(params: CreateCustomerGroupParams, options?: RequestOptions): Promise<CustomerGroup>;
9413
+ /**
9414
+ * Listar grupos de clientes
9415
+ *
9416
+ * Los grupos de clientes, con cuántos clientes tiene cada uno.
9417
+ *
9418
+ * GET /v1/customer_groups
9419
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/list-customer-groups
9420
+ */
9421
+ list(params?: ListCustomerGroupsParams, options?: RequestOptions): List<CustomerGroup>;
9422
+ /**
9423
+ * Ver un grupo de clientes
9424
+ *
9425
+ * Un grupo de clientes.
9426
+ *
9427
+ * GET /v1/customer_groups/{id}
9428
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/get-customer-group
9429
+ */
9430
+ get(id: string, options?: RequestOptions): Promise<CustomerGroup>;
9431
+ /**
9432
+ * Actualizar un grupo de clientes
9433
+ *
9434
+ * Cambia solo lo que manda.
9435
+ *
9436
+ * POST /v1/customer_groups/{id}
9437
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/update-customer-group
9438
+ */
9439
+ update(id: string, params?: UpdateCustomerGroupParams, options?: RequestOptions): Promise<CustomerGroup>;
9440
+ /**
9441
+ * Quitar un grupo de clientes
9442
+ *
9443
+ * Sus clientes se quedan sin grupo.
9444
+ *
9445
+ * DELETE /v1/customer_groups/{id}
9446
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/delete-customer-group
9447
+ */
9448
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
9449
+ }
9450
+ /** Listas de precios: fiscalisto.prices. */
9451
+ export declare class PricesResource {
9452
+ #private;
9453
+ constructor(client: Client);
9454
+ /**
9455
+ * Ver los precios de un cliente
9456
+ *
9457
+ * Lo que un cliente paga por unos productos a una cantidad: el precio por unidad sin IVA de su lista (la suya, la de su grupo o la de todos), su descuento y el siguiente escalón de mayoreo. No guarda nada.
9458
+ *
9459
+ * POST /v1/prices
9460
+ * @see https://fiscalisto.com/docs/api/referencia/listas-de-precios/quote-prices
9461
+ */
9462
+ quote(params: QuotePricesParams, options?: RequestOptions): Promise<PriceQuote>;
9463
+ }
8520
9464
  /** Viáticos y gastos: fiscalisto.expensePeople. */
8521
9465
  export declare class ExpensePeopleResource {
8522
9466
  #private;
@@ -9522,6 +10466,146 @@ export declare class QuotesResource {
9522
10466
  */
9523
10467
  pdf(id: string, options?: RequestOptions): Promise<Uint8Array>;
9524
10468
  }
10469
+ /** Pedidos: fiscalisto.salesOrders. */
10470
+ export declare class SalesOrdersResource {
10471
+ #private;
10472
+ constructor(client: Client);
10473
+ /**
10474
+ * Crear un pedido
10475
+ *
10476
+ * Lo que su cliente le pidió, con los conceptos y las condiciones de pago de una factura (se revisan con las mismas reglas, así que cada factura que sale de él timbra). customer es un cliente de su catálogo o uno con sus datos fiscales (se agrega a sus clientes). Con quote (quo_…) lo hace de una cotización. Queda en draft, o confirmado con confirm: true (llega sales_order.confirmed y se aparta lo pedido en el almacén).
10477
+ *
10478
+ * POST /v1/sales_orders
10479
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/create-sales-order
10480
+ */
10481
+ create(params?: CreateSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10482
+ /**
10483
+ * Listar pedidos
10484
+ *
10485
+ * Los más recientes primero.
10486
+ *
10487
+ * GET /v1/sales_orders
10488
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/list-sales-orders
10489
+ */
10490
+ list(params?: ListSalesOrdersParams, options?: RequestOptions): List<SalesOrder>;
10491
+ /**
10492
+ * Ver un pedido
10493
+ *
10494
+ * Con sus entregas, sus facturas y lo que se ha pagado de ellas.
10495
+ *
10496
+ * GET /v1/sales_orders/{id}
10497
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/get-sales-order
10498
+ */
10499
+ get(id: string, options?: RequestOptions): Promise<SalesOrder>;
10500
+ /**
10501
+ * Cambiar un pedido
10502
+ *
10503
+ * Solo lo que mande cambia. Los conceptos cambian mientras no tengan entregas ni facturas; si no, 400 sales_order_invalid.
10504
+ *
10505
+ * POST /v1/sales_orders/{id}
10506
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/update-sales-order
10507
+ */
10508
+ update(id: string, params?: UpdateSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10509
+ /**
10510
+ * Borrar un pedido
10511
+ *
10512
+ * Solo un borrador. Uno confirmado se cancela con POST /v1/sales_orders/{id}/cancel: 400 sales_order_not_deletable.
10513
+ *
10514
+ * DELETE /v1/sales_orders/{id}
10515
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/delete-sales-order
10516
+ */
10517
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
10518
+ /**
10519
+ * Confirmar un pedido
10520
+ *
10521
+ * Es un pedido en firme: se aparta lo pedido en el almacén y ya se puede entregar y facturar. Llega sales_order.confirmed.
10522
+ *
10523
+ * POST /v1/sales_orders/{id}/confirm
10524
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/confirm-sales-order
10525
+ */
10526
+ confirm(id: string, options?: RequestOptions): Promise<SalesOrder>;
10527
+ /**
10528
+ * Registrar una entrega
10529
+ *
10530
+ * Lo que salió, con su remisión (REM-1, REM-2…): la mercancía sale del almacén con la entrega, no con la factura. Por omisión, todo lo que falta. Si el emisor no vende sin existencias, no sale más de lo que hay (400 sales_order_invalid). Cuando ya salió todo llega sales_order.delivered.
10531
+ *
10532
+ * POST /v1/sales_orders/{id}/deliveries
10533
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/create-sales-order-delivery
10534
+ */
10535
+ deliver(id: string, params?: CreateSalesOrderDeliveryParams, options?: RequestOptions): Promise<SalesOrder>;
10536
+ /**
10537
+ * Cancelar una entrega
10538
+ *
10539
+ * La mercancía regresa al almacén y lo entregado vuelve a quedar pendiente.
10540
+ *
10541
+ * POST /v1/sales_orders/{id}/deliveries/{delivery}/cancel
10542
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/cancel-sales-order-delivery
10543
+ */
10544
+ cancelDelivery(id: string, delivery: string, params?: CancelSalesOrderDeliveryParams, options?: RequestOptions): Promise<SalesOrder>;
10545
+ /**
10546
+ * Facturar un pedido
10547
+ *
10548
+ * Timbra una factura con lo entregado y no facturado (o lo que diga items; con invoice_policy ordered, lo pedido), con los datos fiscales del cliente de hoy y la nota «Pedido PED-…» con su orden de compra. Se factura en varias partes: cada llamada, con su Idempotency-Key, timbra la que sigue. Si no queda nada, 400 sales_order_invalid. Cuando sus facturas se pagan llega sales_order.paid.
10549
+ *
10550
+ * POST /v1/sales_orders/{id}/invoice
10551
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/invoice-sales-order
10552
+ */
10553
+ invoice(id: string, params?: InvoiceSalesOrderParams, options?: RequestOptions): Promise<Invoice>;
10554
+ /**
10555
+ * Mandar un pedido
10556
+ *
10557
+ * Por correo, con su PDF y la liga donde su cliente lo confirma (llega sales_order.customer_confirmed), firma cada entrega y abre sus facturas. Con send_email: false solo contesta url. En borrador, 400 sales_order_draft.
10558
+ *
10559
+ * POST /v1/sales_orders/{id}/send
10560
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/send-sales-order
10561
+ */
10562
+ send(id: string, params?: SendSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10563
+ /**
10564
+ * Ya no entregar lo pendiente
10565
+ *
10566
+ * El pedido se queda con lo ya entregado (lo demás pasa a canceled en cada concepto) y se libera lo apartado.
10567
+ *
10568
+ * POST /v1/sales_orders/{id}/cancel_remaining
10569
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/cancel-sales-order-remaining
10570
+ */
10571
+ cancelRemaining(id: string, options?: RequestOptions): Promise<SalesOrder>;
10572
+ /**
10573
+ * Cerrar un pedido
10574
+ *
10575
+ * Lo da por terminado aunque quede algo pendiente, y libera lo apartado.
10576
+ *
10577
+ * POST /v1/sales_orders/{id}/close
10578
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/close-sales-order
10579
+ */
10580
+ close(id: string, params?: CloseSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10581
+ /**
10582
+ * Cancelar un pedido
10583
+ *
10584
+ * Solo sin entregas ni facturas timbradas (cancele primero las entregas, y las facturas con POST /v1/invoices/{id}/cancel). Borra sus facturas en borrador y libera lo apartado. Llega sales_order.canceled.
10585
+ *
10586
+ * POST /v1/sales_orders/{id}/cancel
10587
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/cancel-sales-order
10588
+ */
10589
+ cancel(id: string, params?: CancelSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10590
+ /**
10591
+ * Reabrir un pedido
10592
+ *
10593
+ * Uno cerrado o cancelado vuelve a estar abierto.
10594
+ *
10595
+ * POST /v1/sales_orders/{id}/reopen
10596
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/reopen-sales-order
10597
+ */
10598
+ reopen(id: string, options?: RequestOptions): Promise<SalesOrder>;
10599
+ /**
10600
+ * Descargar el PDF
10601
+ *
10602
+ * El PDF del pedido, con el diseño de PDF del emisor.
10603
+ *
10604
+ * GET /v1/sales_orders/{id}/pdf
10605
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/get-sales-order-pdf
10606
+ */
10607
+ pdf(id: string, options?: RequestOptions): Promise<Uint8Array>;
10608
+ }
9525
10609
  /** Webhooks: fiscalisto.webhookEndpoints. */
9526
10610
  export declare class WebhookEndpointsResource {
9527
10611
  #private;
@@ -9640,6 +10724,9 @@ export declare class FiscalistoApi extends Core {
9640
10724
  readonly taxIds: TaxIdsResource;
9641
10725
  readonly branches: BranchesResource;
9642
10726
  readonly costCenters: CostCentersResource;
10727
+ readonly priceLists: PriceListsResource;
10728
+ readonly customerGroups: CustomerGroupsResource;
10729
+ readonly prices: PricesResource;
9643
10730
  readonly expensePeople: ExpensePeopleResource;
9644
10731
  readonly expenseReports: ExpenseReportsResource;
9645
10732
  readonly expensePolicy: ExpensePolicyResource;
@@ -9661,6 +10748,7 @@ export declare class FiscalistoApi extends Core {
9661
10748
  readonly storeConnections: StoreConnectionsResource;
9662
10749
  readonly recurringInvoices: RecurringInvoicesResource;
9663
10750
  readonly quotes: QuotesResource;
10751
+ readonly salesOrders: SalesOrdersResource;
9664
10752
  readonly webhookEndpoints: WebhookEndpointsResource;
9665
10753
  readonly events: EventsResource;
9666
10754
  }