fiscalisto 0.1.32 → 0.1.33

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.
@@ -3177,6 +3177,158 @@ export interface Quote {
3177
3177
  /** Cuándo se creó. */
3178
3178
  created_at: string | null;
3179
3179
  }
3180
+ /** Un pedido de venta: lo que su cliente pidió, cómo se entrega (remisiones) y cómo se factura y se cobra. */
3181
+ export interface SalesOrder {
3182
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3183
+ id: string;
3184
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
3185
+ livemode: boolean;
3186
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3187
+ object: "sales_order";
3188
+ /** El emisor (iss_…). */
3189
+ issuer: string;
3190
+ /** Su serie y folio (PED-12). */
3191
+ number: string;
3192
+ /** 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. */
3193
+ status: "draft" | "confirmed" | "partially_delivered" | "delivered" | "invoiced" | "paid" | "closed" | "canceled";
3194
+ /** La etapa del negocio en que va («Por empacar», «En ruta»…), o null. Se elige en la app. */
3195
+ stage: string | null;
3196
+ /** 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. */
3197
+ url: string | null;
3198
+ /** El cliente: su RFC, nombre, correo y su id en su catálogo. */
3199
+ customer: {
3200
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
3201
+ tax_id: string | null;
3202
+ /** Nombre. */
3203
+ name: string | null;
3204
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
3205
+ email: string | null;
3206
+ /** El cliente (cus_…) en su catálogo, o null si no está en él. */
3207
+ catalog_id: string | null;
3208
+ };
3209
+ /** El número de orden de compra de su cliente, o null. */
3210
+ customer_po: string | null;
3211
+ /** La cotización (quo_…) de donde salió, o null. */
3212
+ quote: string | null;
3213
+ /** La moneda. */
3214
+ currency: string;
3215
+ /** 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. */
3216
+ items: {
3217
+ /** El id del concepto en el pedido: con él entrega o factura una parte (line). */
3218
+ id: number;
3219
+ /** Descripción del concepto (Descripcion), hasta 1,000 caracteres. */
3220
+ description: string;
3221
+ /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
3222
+ product_key: string | null;
3223
+ /** Cantidad (Cantidad). Por omisión 1. */
3224
+ quantity: number;
3225
+ /** La unidad, como la ve el cliente. */
3226
+ unit: string | null;
3227
+ /** Precio unitario antes de impuestos (ValorUnitario). */
3228
+ unit_price: number;
3229
+ /** El descuento del concepto, en dinero. */
3230
+ discount: number;
3231
+ /** El importe del concepto, sin impuestos. */
3232
+ amount: number;
3233
+ /** true si sale del almacén con cada entrega; false si es un servicio (solo se factura). */
3234
+ goods: boolean;
3235
+ /** Cuánto ya se entregó. */
3236
+ delivered: number;
3237
+ /** Cuánto ya se facturó. */
3238
+ invoiced: number;
3239
+ /** Cuánto ya no se entregará (POST /v1/sales_orders/{id}/cancel_remaining). */
3240
+ canceled: number;
3241
+ }[];
3242
+ /** El subtotal, sin impuestos. */
3243
+ subtotal: number;
3244
+ /** El total con impuestos. */
3245
+ total: number;
3246
+ /** La suma de sus facturas timbradas (sin las canceladas). */
3247
+ invoiced_total: number;
3248
+ /** Lo que ya se pagó de esas facturas. */
3249
+ paid_total: number;
3250
+ /** La entrega estimada (AAAA-MM-DD), o null. */
3251
+ expected_on: string | null;
3252
+ /** Días de crédito: cada factura vence esos días después de su fecha. */
3253
+ payment_days: number;
3254
+ /** delivered: cada factura lleva lo ya entregado; ordered: se factura lo pedido, entregado o no. */
3255
+ invoice_policy: "delivered" | "ordered";
3256
+ /** Dónde se entrega, o null. */
3257
+ ship_to: string | null;
3258
+ /** Las condiciones impresas en el pedido, o null. */
3259
+ terms: string | null;
3260
+ /** Las notas, como las de una factura. */
3261
+ notes: string | null;
3262
+ /** La nota interna (su cliente no la ve), o null. */
3263
+ internal_note: string | null;
3264
+ /** Sus entregas, cada una con su remisión. */
3265
+ deliveries: SalesOrderDelivery[];
3266
+ /** Sus facturas timbradas (inv_…), con lo que falta por pagar de cada una (balance). */
3267
+ invoices: {
3268
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3269
+ id: string;
3270
+ /** stamped, o canceled (lo que llevaba se puede volver a facturar). */
3271
+ status: "stamped" | "canceled";
3272
+ /** El total de la factura. */
3273
+ total: number;
3274
+ /** Lo que falta por pagar de esa factura, o null si aún no se sabe. */
3275
+ balance: number | null;
3276
+ }[];
3277
+ /** Cuándo su cliente lo confirmó en su liga, o null. */
3278
+ customer_confirmed_at: string | null;
3279
+ /** Cuándo se mandó, o null. */
3280
+ sent_at: string | null;
3281
+ /** Cuándo su cliente abrió la liga por primera vez, o null. */
3282
+ viewed_at: string | null;
3283
+ /** Cuándo se confirmó, o null. */
3284
+ confirmed_at: string | null;
3285
+ /** Cuándo quedó todo entregado, o null. */
3286
+ delivered_at: string | null;
3287
+ /** Cuándo quedó todo facturado, o null. */
3288
+ invoiced_at: string | null;
3289
+ /** Cuándo quedaron pagadas sus facturas, o null. */
3290
+ paid_at: string | null;
3291
+ /** Cuándo se cerró, o null. */
3292
+ closed_at: string | null;
3293
+ /** Cuándo se canceló, o null. */
3294
+ canceled_at: string | null;
3295
+ /** Por qué se canceló, o null. */
3296
+ cancel_reason: string | null;
3297
+ /** Cuándo se creó. */
3298
+ created_at: string | null;
3299
+ }
3300
+ /** Una entrega del pedido, con su remisión (REM-1): lo que salió del almacén. */
3301
+ export interface SalesOrderDelivery {
3302
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3303
+ id: string;
3304
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3305
+ object: "sales_order_delivery";
3306
+ /** Su remisión (REM-1). */
3307
+ number: string;
3308
+ /** delivered, o canceled (la mercancía regresó al almacén). */
3309
+ status: "delivered" | "canceled";
3310
+ /** El día en que salió (AAAA-MM-DD). */
3311
+ delivered_on: string;
3312
+ /** El transporte, o null. */
3313
+ carrier: string | null;
3314
+ /** El número de guía, o null. */
3315
+ tracking: string | null;
3316
+ /** Una nota, o null. */
3317
+ note: string | null;
3318
+ /** Quién recibió (lo firmó en la liga o lo anotó usted), o null. */
3319
+ received_by: string | null;
3320
+ /** Cuándo se recibió, o null. */
3321
+ received_at: string | null;
3322
+ /** Cuánto salió de cada concepto (line es items[].id del pedido). */
3323
+ items: {
3324
+ /** El concepto del pedido (su items[].id). */
3325
+ line: number;
3326
+ /** Cuánto salió de él. */
3327
+ quantity: number;
3328
+ }[];
3329
+ /** Cuándo se registró. */
3330
+ created_at: string | null;
3331
+ }
3180
3332
  /** Lo que un cliente le debe a un emisor en una moneda, de sus facturas abiertas. */
3181
3333
  export interface Receivable {
3182
3334
  /** El RFC y la moneda (RFC:MXN): para starting_after. */
@@ -3491,14 +3643,14 @@ export interface WebhookTest {
3491
3643
  };
3492
3644
  }
3493
3645
  /** 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";
3646
+ 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
3647
  /** Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks). */
3496
3648
  export interface EventBase<T extends EventType = EventType, O = unknown> {
3497
3649
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3498
3650
  id: string;
3499
3651
  /** Qué tipo de objeto es («invoice», «customer»…). */
3500
3652
  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. */
3653
+ /** 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
3654
  type: T;
3503
3655
  /** Versión de la API con que se armó el objeto. */
3504
3656
  api_version: string;
@@ -3512,7 +3664,7 @@ export interface EventBase<T extends EventType = EventType, O = unknown> {
3512
3664
  };
3513
3665
  }
3514
3666
  /** 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>;
3667
+ 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
3668
  /** Confirmación de que se borró. */
3517
3669
  export interface Deleted {
3518
3670
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -3914,6 +4066,16 @@ export interface QuoteList {
3914
4066
  /** La ruta de esta lista. */
3915
4067
  url: string;
3916
4068
  }
4069
+ export interface SalesOrderList {
4070
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4071
+ object: "list";
4072
+ /** Los objetos de esta página. */
4073
+ data: SalesOrder[];
4074
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4075
+ has_more: boolean;
4076
+ /** La ruta de esta lista. */
4077
+ url: string;
4078
+ }
3917
4079
  export interface WebhookEndpointList {
3918
4080
  /** Qué tipo de objeto es («invoice», «customer»…). */
3919
4081
  object: "list";
@@ -7361,6 +7523,375 @@ export interface RejectQuoteParams {
7361
7523
  /** Por qué (queda en customer_comment; el cliente no la ve). */
7362
7524
  note?: string;
7363
7525
  }
7526
+ export interface CreateSalesOrderParams {
7527
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
7528
+ issuer?: string;
7529
+ /** Hacerlo de una cotización (quo_…): toma su cliente y sus conceptos, y la cotización queda aceptada. Sin customer ni items. */
7530
+ quote?: string;
7531
+ /** Un cliente de su catálogo (cus_…) o uno con sus datos fiscales (como en POST /v1/invoices: se agrega a sus clientes). */
7532
+ customer?: string | {
7533
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
7534
+ tax_id: string;
7535
+ /** 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.»). */
7536
+ legal_name: string;
7537
+ /** Régimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626… */
7538
+ tax_system: string;
7539
+ /** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
7540
+ zip: string;
7541
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
7542
+ email?: string | null;
7543
+ /** 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. */
7544
+ foreign?: {
7545
+ /** País de residencia fiscal, clave de 3 letras de c_Pais (USA, CAN…). */
7546
+ country: string;
7547
+ /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
7548
+ tax_id: string;
7549
+ };
7550
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
7551
+ ieps_taxpayer?: boolean;
7552
+ };
7553
+ /** Los conceptos, como en POST /v1/invoices (hasta 200). */
7554
+ items?: {
7555
+ /** Un producto de su catálogo (prd_…): toma su clave, unidad, precio e impuestos. */
7556
+ product?: string;
7557
+ /** Descripción del concepto (Descripcion), hasta 1,000 caracteres. */
7558
+ description?: string;
7559
+ /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
7560
+ product_key?: string;
7561
+ /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
7562
+ unit_key?: string;
7563
+ /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
7564
+ unit_name?: string | null;
7565
+ /** Número de identificación o SKU (NoIdentificacion). */
7566
+ sku?: string | null;
7567
+ /** Cantidad (Cantidad). Por omisión 1. */
7568
+ quantity?: number;
7569
+ /** Precio unitario antes de impuestos (ValorUnitario). */
7570
+ unit_price?: number;
7571
+ /** Descuento (Descuento). */
7572
+ discount?: number;
7573
+ /** Objeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa… */
7574
+ taxability?: "01" | "02" | "03" | "04" | "05" | "06" | "07" | "08";
7575
+ /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
7576
+ iva?: "0" | "0.16" | "0.08" | "exento";
7577
+ /** IEPS trasladado: tasa (0.265…) o cuota en pesos por unidad, según ieps_factor. */
7578
+ ieps?: number;
7579
+ /** Tasa o Cuota (TipoFactor del IEPS). */
7580
+ ieps_factor?: "Tasa" | "Cuota";
7581
+ /** Unidades de IEPS a cuota (litros, cigarros…), si no son la cantidad. */
7582
+ ieps_units?: number;
7583
+ /** Tasa de IVA retenido (por ejemplo 0.106667, dos terceras partes del 16%). */
7584
+ iva_retention?: number;
7585
+ /** Tasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO). */
7586
+ isr_retention?: number;
7587
+ /** Números de cuenta predial (CuentaPredial) en arrendamiento. */
7588
+ predial?: string[];
7589
+ /** Números de pedimento (InformacionAduanera) de mercancía importada. */
7590
+ pedimentos?: string[];
7591
+ /** A cuenta de terceros (ACuentaTerceros): RFC, nombre, régimen y código postal. */
7592
+ third_party?: {
7593
+ /** RFC de a cuenta de quién (RfcACuentaTerceros). */
7594
+ tax_id: string;
7595
+ /** Nombre (NombreACuentaTerceros). */
7596
+ name: string;
7597
+ /** Régimen fiscal (RegimenFiscalACuentaTerceros), c_RegimenFiscal. */
7598
+ tax_system: string;
7599
+ /** Código postal de su domicilio fiscal (DomicilioFiscalACuentaTerceros). */
7600
+ zip: string;
7601
+ };
7602
+ /** Complemento de instituciones educativas privadas (IEDU): alumno, CURP, nivel y RVOE. */
7603
+ iedu?: {
7604
+ /** Nombre del alumno (nombreAlumno). */
7605
+ student_name: string;
7606
+ /** CURP, 18 caracteres. */
7607
+ curp: string;
7608
+ /** Nivel educativo (nivelEducativo). */
7609
+ level: "Preescolar" | "Primaria" | "Secundaria" | "Profesional técnico" | "Bachillerato o su equivalente";
7610
+ /** Reconocimiento de validez oficial de estudios (autRVOE). */
7611
+ rvoe: string;
7612
+ /** RFC de quien paga, si no es el receptor (rfcPago). */
7613
+ payer_tax_id?: string | null;
7614
+ };
7615
+ /** Complemento de vehículo usado. */
7616
+ used_vehicle?: {
7617
+ /** Monto de adquisición (montoAdquisicion). */
7618
+ purchase_amount: number;
7619
+ /** Monto de enajenación (montoEnajenacion). */
7620
+ sale_amount: number;
7621
+ /** Clave vehicular (claveVehicular). */
7622
+ vehicle_key: string;
7623
+ /** Marca (marca). */
7624
+ make: string;
7625
+ /** Tipo o versión (tipo). */
7626
+ type: string;
7627
+ /** Año del modelo (modelo), 4 dígitos. */
7628
+ model: string;
7629
+ /** Número de motor (numeroMotor). */
7630
+ engine_number?: string;
7631
+ /** Número de serie (numeroSerie). */
7632
+ serial_number?: string;
7633
+ /** Número de identificación vehicular (NIV). */
7634
+ niv?: string;
7635
+ /** Valor según la guía EBC o Libro Azul (valor). */
7636
+ guide_value: number;
7637
+ /** Información aduanera de la importación del vehículo (InformacionAduanera). */
7638
+ customs?: {
7639
+ /** Número del documento de importación (numero). */
7640
+ number: string;
7641
+ /** Fecha del documento (fecha), AAAA-MM-DD. */
7642
+ date: string;
7643
+ /** Aduana (aduana). */
7644
+ office?: string;
7645
+ }[];
7646
+ };
7647
+ /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
7648
+ addenda?: Record<string, string>;
7649
+ }[];
7650
+ /** Confirmarlo en el mismo paso (por omisión false: queda en draft). Confirmado, aparta lo pedido en el almacén. */
7651
+ confirm?: boolean;
7652
+ /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
7653
+ currency?: string;
7654
+ /** Tipo de cambio a pesos (TipoCambio). Obligatorio si la moneda no es MXN; use el del DOF del día anterior. */
7655
+ exchange_rate?: number;
7656
+ /** 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. */
7657
+ payment_form?: string;
7658
+ /** 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). */
7659
+ payment_method?: "PUE" | "PPD";
7660
+ /** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
7661
+ use?: string;
7662
+ /** Observaciones que aparecen en el PDF (no van en el XML). */
7663
+ notes?: string;
7664
+ /** El número de orden de compra de su cliente (va en la nota de cada factura). */
7665
+ customer_po?: string;
7666
+ /** A dónde mandarle el pedido y sus remisiones (hasta 5 correos, separados por comas). Por omisión, el del cliente. */
7667
+ email?: string;
7668
+ /** Entrega estimada (AAAA-MM-DD). */
7669
+ expected_on?: string;
7670
+ /** Días de crédito (0: de contado). */
7671
+ payment_days?: number;
7672
+ /** Qué se factura: delivered (por omisión), lo ya entregado; ordered, todo lo pedido desde el inicio (por ejemplo con pago por adelantado). */
7673
+ invoice_policy?: "delivered" | "ordered";
7674
+ /** Dónde se entrega. */
7675
+ ship_to?: string;
7676
+ /** Condiciones del pedido. */
7677
+ terms?: string;
7678
+ /** Nota interna (su cliente no la ve). */
7679
+ internal_note?: string;
7680
+ }
7681
+ /** Los parámetros de GET /v1/sales_orders. */
7682
+ export interface ListSalesOrdersParams {
7683
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
7684
+ limit?: number;
7685
+ /** El id del último de la página anterior, para la siguiente. */
7686
+ starting_after?: string;
7687
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7688
+ issuer?: string;
7689
+ /** Solo los que estén en este estado. */
7690
+ status?: "draft" | "confirmed" | "partially_delivered" | "delivered" | "invoiced" | "paid" | "closed" | "canceled";
7691
+ /** Solo los de este RFC. */
7692
+ customer?: string;
7693
+ }
7694
+ export interface UpdateSalesOrderParams {
7695
+ /** Un cliente de su catálogo (cus_…) o uno con sus datos fiscales (como en POST /v1/invoices: se agrega a sus clientes). */
7696
+ customer?: string | {
7697
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
7698
+ tax_id: string;
7699
+ /** 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.»). */
7700
+ legal_name: string;
7701
+ /** Régimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626… */
7702
+ tax_system: string;
7703
+ /** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
7704
+ zip: string;
7705
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
7706
+ email?: string | null;
7707
+ /** 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. */
7708
+ foreign?: {
7709
+ /** País de residencia fiscal, clave de 3 letras de c_Pais (USA, CAN…). */
7710
+ country: string;
7711
+ /** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
7712
+ tax_id: string;
7713
+ };
7714
+ /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
7715
+ ieps_taxpayer?: boolean;
7716
+ };
7717
+ /** Los conceptos, como en POST /v1/invoices (hasta 200). */
7718
+ items?: {
7719
+ /** Un producto de su catálogo (prd_…): toma su clave, unidad, precio e impuestos. */
7720
+ product?: string;
7721
+ /** Descripción del concepto (Descripcion), hasta 1,000 caracteres. */
7722
+ description?: string;
7723
+ /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
7724
+ product_key?: string;
7725
+ /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
7726
+ unit_key?: string;
7727
+ /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
7728
+ unit_name?: string | null;
7729
+ /** Número de identificación o SKU (NoIdentificacion). */
7730
+ sku?: string | null;
7731
+ /** Cantidad (Cantidad). Por omisión 1. */
7732
+ quantity?: number;
7733
+ /** Precio unitario antes de impuestos (ValorUnitario). */
7734
+ unit_price?: number;
7735
+ /** Descuento (Descuento). */
7736
+ discount?: number;
7737
+ /** Objeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa… */
7738
+ taxability?: "01" | "02" | "03" | "04" | "05" | "06" | "07" | "08";
7739
+ /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
7740
+ iva?: "0" | "0.16" | "0.08" | "exento";
7741
+ /** IEPS trasladado: tasa (0.265…) o cuota en pesos por unidad, según ieps_factor. */
7742
+ ieps?: number;
7743
+ /** Tasa o Cuota (TipoFactor del IEPS). */
7744
+ ieps_factor?: "Tasa" | "Cuota";
7745
+ /** Unidades de IEPS a cuota (litros, cigarros…), si no son la cantidad. */
7746
+ ieps_units?: number;
7747
+ /** Tasa de IVA retenido (por ejemplo 0.106667, dos terceras partes del 16%). */
7748
+ iva_retention?: number;
7749
+ /** Tasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO). */
7750
+ isr_retention?: number;
7751
+ /** Números de cuenta predial (CuentaPredial) en arrendamiento. */
7752
+ predial?: string[];
7753
+ /** Números de pedimento (InformacionAduanera) de mercancía importada. */
7754
+ pedimentos?: string[];
7755
+ /** A cuenta de terceros (ACuentaTerceros): RFC, nombre, régimen y código postal. */
7756
+ third_party?: {
7757
+ /** RFC de a cuenta de quién (RfcACuentaTerceros). */
7758
+ tax_id: string;
7759
+ /** Nombre (NombreACuentaTerceros). */
7760
+ name: string;
7761
+ /** Régimen fiscal (RegimenFiscalACuentaTerceros), c_RegimenFiscal. */
7762
+ tax_system: string;
7763
+ /** Código postal de su domicilio fiscal (DomicilioFiscalACuentaTerceros). */
7764
+ zip: string;
7765
+ };
7766
+ /** Complemento de instituciones educativas privadas (IEDU): alumno, CURP, nivel y RVOE. */
7767
+ iedu?: {
7768
+ /** Nombre del alumno (nombreAlumno). */
7769
+ student_name: string;
7770
+ /** CURP, 18 caracteres. */
7771
+ curp: string;
7772
+ /** Nivel educativo (nivelEducativo). */
7773
+ level: "Preescolar" | "Primaria" | "Secundaria" | "Profesional técnico" | "Bachillerato o su equivalente";
7774
+ /** Reconocimiento de validez oficial de estudios (autRVOE). */
7775
+ rvoe: string;
7776
+ /** RFC de quien paga, si no es el receptor (rfcPago). */
7777
+ payer_tax_id?: string | null;
7778
+ };
7779
+ /** Complemento de vehículo usado. */
7780
+ used_vehicle?: {
7781
+ /** Monto de adquisición (montoAdquisicion). */
7782
+ purchase_amount: number;
7783
+ /** Monto de enajenación (montoEnajenacion). */
7784
+ sale_amount: number;
7785
+ /** Clave vehicular (claveVehicular). */
7786
+ vehicle_key: string;
7787
+ /** Marca (marca). */
7788
+ make: string;
7789
+ /** Tipo o versión (tipo). */
7790
+ type: string;
7791
+ /** Año del modelo (modelo), 4 dígitos. */
7792
+ model: string;
7793
+ /** Número de motor (numeroMotor). */
7794
+ engine_number?: string;
7795
+ /** Número de serie (numeroSerie). */
7796
+ serial_number?: string;
7797
+ /** Número de identificación vehicular (NIV). */
7798
+ niv?: string;
7799
+ /** Valor según la guía EBC o Libro Azul (valor). */
7800
+ guide_value: number;
7801
+ /** Información aduanera de la importación del vehículo (InformacionAduanera). */
7802
+ customs?: {
7803
+ /** Número del documento de importación (numero). */
7804
+ number: string;
7805
+ /** Fecha del documento (fecha), AAAA-MM-DD. */
7806
+ date: string;
7807
+ /** Aduana (aduana). */
7808
+ office?: string;
7809
+ }[];
7810
+ };
7811
+ /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
7812
+ addenda?: Record<string, string>;
7813
+ }[];
7814
+ /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
7815
+ currency?: string;
7816
+ /** Tipo de cambio a pesos (TipoCambio). Obligatorio si la moneda no es MXN; use el del DOF del día anterior. */
7817
+ exchange_rate?: number;
7818
+ /** 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. */
7819
+ payment_form?: string;
7820
+ /** 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). */
7821
+ payment_method?: "PUE" | "PPD";
7822
+ /** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
7823
+ use?: string;
7824
+ /** Observaciones que aparecen en el PDF (no van en el XML). */
7825
+ notes?: string;
7826
+ /** El número de orden de compra de su cliente (va en la nota de cada factura). */
7827
+ customer_po?: string;
7828
+ /** A dónde mandarle el pedido y sus remisiones (hasta 5 correos, separados por comas). Por omisión, el del cliente. */
7829
+ email?: string;
7830
+ /** Entrega estimada (AAAA-MM-DD). */
7831
+ expected_on?: string;
7832
+ /** Días de crédito (0: de contado). */
7833
+ payment_days?: number;
7834
+ /** Qué se factura: delivered (por omisión), lo ya entregado; ordered, todo lo pedido desde el inicio (por ejemplo con pago por adelantado). */
7835
+ invoice_policy?: "delivered" | "ordered";
7836
+ /** Dónde se entrega. */
7837
+ ship_to?: string;
7838
+ /** Condiciones del pedido. */
7839
+ terms?: string;
7840
+ /** Nota interna (su cliente no la ve). */
7841
+ internal_note?: string;
7842
+ }
7843
+ export interface CreateSalesOrderDeliveryParams {
7844
+ /** Cuánto sale de cada concepto. Por omisión, todo lo que falta por entregar. */
7845
+ items?: {
7846
+ /** El id del concepto (items[].id). */
7847
+ line: number;
7848
+ /** Cantidad (Cantidad). Por omisión 1. */
7849
+ quantity: number;
7850
+ }[];
7851
+ /** Por omisión, hoy. */
7852
+ delivered_on?: string;
7853
+ /** Transporte. */
7854
+ carrier?: string;
7855
+ /** Número de guía. */
7856
+ tracking?: string;
7857
+ /** Una nota en la remisión. */
7858
+ note?: string;
7859
+ /** Quién recibió, si ya lo sabe (si no, su cliente lo firma en url). */
7860
+ received_by?: string;
7861
+ }
7862
+ export interface CancelSalesOrderDeliveryParams {
7863
+ /** Por qué (queda en el historial). */
7864
+ reason?: string;
7865
+ }
7866
+ export interface InvoiceSalesOrderParams {
7867
+ /** Cuánto facturar de cada concepto. Por omisión, lo entregado sin facturar (o todo lo pedido con invoice_policy ordered). */
7868
+ items?: {
7869
+ /** El id del concepto (items[].id). */
7870
+ line: number;
7871
+ /** Cantidad (Cantidad). Por omisión 1. */
7872
+ quantity: number;
7873
+ }[];
7874
+ /** Facturar también lo que aún no se entrega (con invoice_policy delivered). */
7875
+ include_undelivered?: boolean;
7876
+ /** Registrar también la entrega de lo que lleva la factura al timbrarla (venta de mostrador). */
7877
+ deliver?: boolean;
7878
+ }
7879
+ export interface SendSalesOrderParams {
7880
+ /** Mandarlo por correo, con su PDF y url (por omisión true). Con false solo contesta url, para que usted la mande. */
7881
+ send_email?: boolean;
7882
+ /** A quién (hasta 5 correos). Por omisión, el correo del pedido. */
7883
+ to?: string;
7884
+ /** Qué pasó y cómo corregirlo, para una persona. */
7885
+ message?: string;
7886
+ }
7887
+ export interface CloseSalesOrderParams {
7888
+ /** Por qué (queda en el historial). */
7889
+ reason?: string;
7890
+ }
7891
+ export interface CancelSalesOrderParams {
7892
+ /** Por qué (queda en el historial). */
7893
+ reason?: string;
7894
+ }
7364
7895
  export interface CreateWebhookEndpointParams {
7365
7896
  /** Dirección https de su servidor que recibe los avisos. */
7366
7897
  url: string;
@@ -7396,7 +7927,7 @@ export interface RollWebhookSecretParams {
7396
7927
  }
7397
7928
  export interface TestWebhookEndpointParams {
7398
7929
  /** 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";
7930
+ 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";
7400
7931
  }
7401
7932
  /** Los parámetros de GET /v1/events. */
7402
7933
  export interface ListEventsParams {
@@ -7405,7 +7936,7 @@ export interface ListEventsParams {
7405
7936
  /** El id del último de la página anterior, para la siguiente. */
7406
7937
  starting_after?: string;
7407
7938
  /** 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.*";
7939
+ 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.*";
7409
7940
  /** Solo los de este objeto (inv_…, ret_…, bat_…). */
7410
7941
  object?: string;
7411
7942
  /** false: los que algún webhook no recibió (su último intento falló). true: los que recibieron todos los webhooks a los que se mandaron. */
@@ -9522,6 +10053,146 @@ export declare class QuotesResource {
9522
10053
  */
9523
10054
  pdf(id: string, options?: RequestOptions): Promise<Uint8Array>;
9524
10055
  }
10056
+ /** Pedidos: fiscalisto.salesOrders. */
10057
+ export declare class SalesOrdersResource {
10058
+ #private;
10059
+ constructor(client: Client);
10060
+ /**
10061
+ * Crear un pedido
10062
+ *
10063
+ * 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).
10064
+ *
10065
+ * POST /v1/sales_orders
10066
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/create-sales-order
10067
+ */
10068
+ create(params?: CreateSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10069
+ /**
10070
+ * Listar pedidos
10071
+ *
10072
+ * Los más recientes primero.
10073
+ *
10074
+ * GET /v1/sales_orders
10075
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/list-sales-orders
10076
+ */
10077
+ list(params?: ListSalesOrdersParams, options?: RequestOptions): List<SalesOrder>;
10078
+ /**
10079
+ * Ver un pedido
10080
+ *
10081
+ * Con sus entregas, sus facturas y lo que se ha pagado de ellas.
10082
+ *
10083
+ * GET /v1/sales_orders/{id}
10084
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/get-sales-order
10085
+ */
10086
+ get(id: string, options?: RequestOptions): Promise<SalesOrder>;
10087
+ /**
10088
+ * Cambiar un pedido
10089
+ *
10090
+ * Solo lo que mande cambia. Los conceptos cambian mientras no tengan entregas ni facturas; si no, 400 sales_order_invalid.
10091
+ *
10092
+ * POST /v1/sales_orders/{id}
10093
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/update-sales-order
10094
+ */
10095
+ update(id: string, params?: UpdateSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10096
+ /**
10097
+ * Borrar un pedido
10098
+ *
10099
+ * Solo un borrador. Uno confirmado se cancela con POST /v1/sales_orders/{id}/cancel: 400 sales_order_not_deletable.
10100
+ *
10101
+ * DELETE /v1/sales_orders/{id}
10102
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/delete-sales-order
10103
+ */
10104
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
10105
+ /**
10106
+ * Confirmar un pedido
10107
+ *
10108
+ * Es un pedido en firme: se aparta lo pedido en el almacén y ya se puede entregar y facturar. Llega sales_order.confirmed.
10109
+ *
10110
+ * POST /v1/sales_orders/{id}/confirm
10111
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/confirm-sales-order
10112
+ */
10113
+ confirm(id: string, options?: RequestOptions): Promise<SalesOrder>;
10114
+ /**
10115
+ * Registrar una entrega
10116
+ *
10117
+ * 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.
10118
+ *
10119
+ * POST /v1/sales_orders/{id}/deliveries
10120
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/create-sales-order-delivery
10121
+ */
10122
+ deliver(id: string, params?: CreateSalesOrderDeliveryParams, options?: RequestOptions): Promise<SalesOrder>;
10123
+ /**
10124
+ * Cancelar una entrega
10125
+ *
10126
+ * La mercancía regresa al almacén y lo entregado vuelve a quedar pendiente.
10127
+ *
10128
+ * POST /v1/sales_orders/{id}/deliveries/{delivery}/cancel
10129
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/cancel-sales-order-delivery
10130
+ */
10131
+ cancelDelivery(id: string, delivery: string, params?: CancelSalesOrderDeliveryParams, options?: RequestOptions): Promise<SalesOrder>;
10132
+ /**
10133
+ * Facturar un pedido
10134
+ *
10135
+ * 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.
10136
+ *
10137
+ * POST /v1/sales_orders/{id}/invoice
10138
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/invoice-sales-order
10139
+ */
10140
+ invoice(id: string, params?: InvoiceSalesOrderParams, options?: RequestOptions): Promise<Invoice>;
10141
+ /**
10142
+ * Mandar un pedido
10143
+ *
10144
+ * 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.
10145
+ *
10146
+ * POST /v1/sales_orders/{id}/send
10147
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/send-sales-order
10148
+ */
10149
+ send(id: string, params?: SendSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10150
+ /**
10151
+ * Ya no entregar lo pendiente
10152
+ *
10153
+ * El pedido se queda con lo ya entregado (lo demás pasa a canceled en cada concepto) y se libera lo apartado.
10154
+ *
10155
+ * POST /v1/sales_orders/{id}/cancel_remaining
10156
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/cancel-sales-order-remaining
10157
+ */
10158
+ cancelRemaining(id: string, options?: RequestOptions): Promise<SalesOrder>;
10159
+ /**
10160
+ * Cerrar un pedido
10161
+ *
10162
+ * Lo da por terminado aunque quede algo pendiente, y libera lo apartado.
10163
+ *
10164
+ * POST /v1/sales_orders/{id}/close
10165
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/close-sales-order
10166
+ */
10167
+ close(id: string, params?: CloseSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10168
+ /**
10169
+ * Cancelar un pedido
10170
+ *
10171
+ * 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.
10172
+ *
10173
+ * POST /v1/sales_orders/{id}/cancel
10174
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/cancel-sales-order
10175
+ */
10176
+ cancel(id: string, params?: CancelSalesOrderParams, options?: RequestOptions): Promise<SalesOrder>;
10177
+ /**
10178
+ * Reabrir un pedido
10179
+ *
10180
+ * Uno cerrado o cancelado vuelve a estar abierto.
10181
+ *
10182
+ * POST /v1/sales_orders/{id}/reopen
10183
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/reopen-sales-order
10184
+ */
10185
+ reopen(id: string, options?: RequestOptions): Promise<SalesOrder>;
10186
+ /**
10187
+ * Descargar el PDF
10188
+ *
10189
+ * El PDF del pedido, con el diseño de PDF del emisor.
10190
+ *
10191
+ * GET /v1/sales_orders/{id}/pdf
10192
+ * @see https://fiscalisto.com/docs/api/referencia/pedidos/get-sales-order-pdf
10193
+ */
10194
+ pdf(id: string, options?: RequestOptions): Promise<Uint8Array>;
10195
+ }
9525
10196
  /** Webhooks: fiscalisto.webhookEndpoints. */
9526
10197
  export declare class WebhookEndpointsResource {
9527
10198
  #private;
@@ -9661,6 +10332,7 @@ export declare class FiscalistoApi extends Core {
9661
10332
  readonly storeConnections: StoreConnectionsResource;
9662
10333
  readonly recurringInvoices: RecurringInvoicesResource;
9663
10334
  readonly quotes: QuotesResource;
10335
+ readonly salesOrders: SalesOrdersResource;
9664
10336
  readonly webhookEndpoints: WebhookEndpointsResource;
9665
10337
  readonly events: EventsResource;
9666
10338
  }