fiscalisto 0.1.22 → 0.1.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/core.d.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * llamar.
5
5
  */
6
6
  import type { ErrorCode } from "./error-codes.js";
7
- export declare const VERSION = "0.1.22";
7
+ export declare const VERSION = "0.1.23";
8
8
  /**
9
9
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
10
10
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
package/dist/core.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * errores y las listas que se recorren solas. Los recursos (generated.ts) solo dicen qué ruta
4
4
  * llamar.
5
5
  */
6
- export const VERSION = "0.1.22";
6
+ export const VERSION = "0.1.23";
7
7
  /**
8
8
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
9
9
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
@@ -29,6 +29,10 @@ export declare const ErrorCode: {
29
29
  readonly CertificateRequired: "certificate_required";
30
30
  /** No se pudo conectar con la API (connection_error). */
31
31
  readonly ConnectionFailed: "connection_failed";
32
+ /** El emisor ya tiene un centro de costo con ese nombre (sin importar mayúsculas). Si está archivado, restáurelo con archived: false. */
33
+ readonly CostCenterExists: "cost_center_exists";
34
+ /** El emisor llegó a 500 centros de costo: archive o borre los que ya no use. */
35
+ readonly CostCenterLimit: "cost_center_limit";
32
36
  /** Ya hay un cliente con ese RFC en el catálogo del emisor (o un producto con ese SKU). */
33
37
  readonly CustomerExists: "customer_exists";
34
38
  /** Llegó al tope del día de algo que no se paga con timbres: comprobantes en pruebas (1,000), RFC revisados en las listas del SAT o constancias consultadas. Retry-After dice cuántos segundos faltan para la medianoche de la Ciudad de México. */
@@ -30,6 +30,10 @@ export const ErrorCode = {
30
30
  CertificateRequired: "certificate_required",
31
31
  /** No se pudo conectar con la API (connection_error). */
32
32
  ConnectionFailed: "connection_failed",
33
+ /** El emisor ya tiene un centro de costo con ese nombre (sin importar mayúsculas). Si está archivado, restáurelo con archived: false. */
34
+ CostCenterExists: "cost_center_exists",
35
+ /** El emisor llegó a 500 centros de costo: archive o borre los que ya no use. */
36
+ CostCenterLimit: "cost_center_limit",
33
37
  /** Ya hay un cliente con ese RFC en el catálogo del emisor (o un producto con ese SKU). */
34
38
  CustomerExists: "customer_exists",
35
39
  /** Llegó al tope del día de algo que no se paga con timbres: comprobantes en pruebas (1,000), RFC revisados en las listas del SAT o constancias consultadas. Retry-After dice cuántos segundos faltan para la medianoche de la Ciudad de México. */
@@ -347,6 +347,8 @@ export interface Invoice {
347
347
  issuer: string;
348
348
  /** La sucursal (brn_…) desde donde se timbró, o null (el domicilio fiscal del emisor). Sus pagos y notas de crédito la siguen. */
349
349
  branch: string | null;
350
+ /** Su centro de costo (ccn_…), o null. El que mandó al crearla, o el que le puso o cambió después con POST /v1/invoices/{id}. */
351
+ cost_center: string | null;
350
352
  /** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
351
353
  type: "I" | "E" | "P" | "T" | "N";
352
354
  /** processing: el PAC no ha contestado (se resuelve sola; escuche invoice.stamped). valid: timbrada. pending: timbrada con una cancelación en espera del cliente. rejected: el SAT o el PAC no la aceptaron (ver error). canceled: cancelada. */
@@ -1582,6 +1584,8 @@ export interface SatInvoice {
1582
1584
  };
1583
1585
  /** Su estado en el SAT cuando se revisó: active (vigente) o canceled. null si aún no se revisa. */
1584
1586
  sat_status: "active" | "canceled" | null;
1587
+ /** Su centro de costo (ccn_…), o null. Póngalo o cámbielo con POST /v1/sat_invoices/{id}. */
1588
+ cost_center: string | null;
1585
1589
  /** La descarga (sdl_…) que la trajo, o null. */
1586
1590
  sat_download: string | null;
1587
1591
  /** Cuándo llegó. */
@@ -1794,6 +1798,29 @@ export interface Branch {
1794
1798
  /** Cuándo cambió por última vez. */
1795
1799
  updated_at: string | null;
1796
1800
  }
1801
+ /** Un centro de costo del emisor: una obra, proyecto, sucursal o área por la que separa sus ingresos y gastos. */
1802
+ export interface CostCenter {
1803
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1804
+ id: string;
1805
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1806
+ livemode: boolean;
1807
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1808
+ object: "cost_center";
1809
+ /** El emisor del centro de costo. */
1810
+ issuer: string;
1811
+ /** Cómo lo llama su equipo, por ejemplo «Obra Norte». */
1812
+ name: string;
1813
+ /** Su clave (por ejemplo «CC-01»), o null. */
1814
+ code: string | null;
1815
+ /** true si está archivado: ya no se ponen facturas en él, pero las suyas lo conservan. */
1816
+ archived: boolean;
1817
+ /** Cuántas facturas tiene, emitidas y recibidas. */
1818
+ invoices: number;
1819
+ /** Cuándo se creó. */
1820
+ created_at: string | null;
1821
+ /** Cuándo cambió por última vez. */
1822
+ updated_at: string | null;
1823
+ }
1797
1824
  /** Un almacén del emisor: el de la Matriz y uno por sucursal se crean solos; cada factura saca existencias del de su sucursal. */
1798
1825
  export interface Warehouse {
1799
1826
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -3233,6 +3260,16 @@ export interface BranchList {
3233
3260
  /** La ruta de esta lista. */
3234
3261
  url: string;
3235
3262
  }
3263
+ export interface CostCenterList {
3264
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3265
+ object: "list";
3266
+ /** Los objetos de esta página. */
3267
+ data: CostCenter[];
3268
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3269
+ has_more: boolean;
3270
+ /** La ruta de esta lista. */
3271
+ url: string;
3272
+ }
3236
3273
  export interface CustomerList {
3237
3274
  /** Qué tipo de objeto es («invoice», «customer»…). */
3238
3275
  object: "list";
@@ -3469,6 +3506,8 @@ export interface InvoiceCreate {
3469
3506
  issuer?: string;
3470
3507
  /** Sucursal (brn_…) desde donde se factura: su código postal va en LugarExpedicion, su dirección en el PDF y, si las tiene, sus series. Sin ella, el domicilio fiscal del emisor (la Matriz). */
3471
3508
  branch?: string;
3509
+ /** Su centro de costo (ccn_…): la obra, proyecto, sucursal o área a la que pertenece, para ver ingresos y gastos por centro en Reportes. No cambia el CFDI. Sus notas de crédito lo toman solas. */
3510
+ cost_center?: string;
3472
3511
  /** Almacén (whs_…) de donde salen sus productos con track_stock. Por omisión, el de su sucursal (o el de la Matriz). */
3473
3512
  warehouse?: string;
3474
3513
  /** Cliente (Receptor): el id de uno de su catálogo (cus_…) o sus datos en un objeto. */
@@ -4601,6 +4640,8 @@ export interface ListInvoicesParams {
4601
4640
  created_gte?: string;
4602
4641
  /** Creadas hasta, en ISO 8601. Un día solo (2026-10-31) incluye el día completo en hora de la Ciudad de México. */
4603
4642
  created_lte?: string;
4643
+ /** Solo las de este centro de costo (ccn_…), o none para las que no tienen. */
4644
+ cost_center?: string;
4604
4645
  }
4605
4646
  /** Los parámetros de GET /v1/invoices/{id}. */
4606
4647
  export interface GetInvoiceParams {
@@ -4609,6 +4650,10 @@ export interface GetInvoiceParams {
4609
4650
  /** true para preguntar su estado al SAT ahora (cancelaciones en espera). */
4610
4651
  refresh?: boolean;
4611
4652
  }
4653
+ export interface UpdateInvoiceParams {
4654
+ /** Su centro de costo (ccn_…), o null para quitárselo. Solo facturas, notas de crédito y recibos de nómina timbrados. */
4655
+ cost_center?: string | null;
4656
+ }
4612
4657
  /** Los parámetros de GET /v1/invoices/{id}/pdf. */
4613
4658
  export interface GetInvoicePdfParams {
4614
4659
  /** Con un UUID en vez del id, el emisor (iss_…) si la cuenta tiene varios. */
@@ -5619,6 +5664,38 @@ export interface UpdateBranchParams {
5619
5664
  /** true la archiva: ya no se puede facturar desde ella, y sus facturas la siguen nombrando. false la restaura. */
5620
5665
  archived?: boolean;
5621
5666
  }
5667
+ export interface CreateCostCenterParams {
5668
+ /** El emisor (iss_…). Por omisión, su único emisor. */
5669
+ issuer?: string;
5670
+ /** Cómo lo llama su equipo, por ejemplo «Obra Norte». No se repite en el emisor (sin importar mayúsculas). */
5671
+ name: string;
5672
+ /** Su clave, si su contabilidad usa claves (por ejemplo «CC-01»). */
5673
+ code?: string | null;
5674
+ }
5675
+ /** Los parámetros de GET /v1/cost_centers. */
5676
+ export interface ListCostCentersParams {
5677
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
5678
+ limit?: number;
5679
+ /** El id del último de la página anterior, para la siguiente. */
5680
+ starting_after?: string;
5681
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
5682
+ issuer?: string;
5683
+ /** true para incluir los archivados. */
5684
+ include_archived?: boolean;
5685
+ }
5686
+ export interface UpdateCostCenterParams {
5687
+ /** Cómo lo llama su equipo, por ejemplo «Obra Norte». No se repite en el emisor (sin importar mayúsculas). */
5688
+ name?: string;
5689
+ /** Su clave, si su contabilidad usa claves (por ejemplo «CC-01»). */
5690
+ code?: string | null;
5691
+ /** true lo archiva: ya no se pueden poner facturas en él, pero las suyas lo conservan. false lo restaura. */
5692
+ archived?: boolean;
5693
+ }
5694
+ /** Los parámetros de DELETE /v1/cost_centers/{id}. */
5695
+ export interface DeleteCostCenterParams {
5696
+ /** Otro centro de costo (ccn_…) que se queda con sus facturas. */
5697
+ move_to?: string;
5698
+ }
5622
5699
  export interface CreateCustomerParams {
5623
5700
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5624
5701
  issuer?: string;
@@ -5976,6 +6053,12 @@ export interface ListSatInvoicesParams {
5976
6053
  date_gte?: string;
5977
6054
  /** Con fecha hasta este día (AAAA-MM-DD), incluido. */
5978
6055
  date_lte?: string;
6056
+ /** Solo las de este centro de costo (ccn_…), o none para las que no tienen. */
6057
+ cost_center?: string;
6058
+ }
6059
+ export interface UpdateSatInvoiceParams {
6060
+ /** Su centro de costo (ccn_…), o null para quitárselo. Los complementos de pago y los traslados no llevan. */
6061
+ cost_center?: string | null;
5979
6062
  }
5980
6063
  export interface RefreshSatDeclarationsParams {
5981
6064
  /** El emisor (iss_…). Por omisión, su único emisor. */
@@ -7002,6 +7085,15 @@ export declare class InvoicesResource {
7002
7085
  * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice
7003
7086
  */
7004
7087
  get(id: string, params?: GetInvoiceParams, options?: RequestOptions): Promise<Invoice>;
7088
+ /**
7089
+ * Actualizar una factura
7090
+ *
7091
+ * Lo que se puede cambiar de una factura timbrada sin tocar el CFDI: su centro de costo (cost_center, o null para quitárselo). Los complementos de pago y los traslados no llevan.
7092
+ *
7093
+ * POST /v1/invoices/{id}
7094
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/update-invoice
7095
+ */
7096
+ update(id: string, params?: UpdateInvoiceParams, options?: RequestOptions): Promise<Invoice>;
7005
7097
  /**
7006
7098
  * Descargar el PDF
7007
7099
  *
@@ -7668,6 +7760,56 @@ export declare class BranchesResource {
7668
7760
  */
7669
7761
  delete(id: string, options?: RequestOptions): Promise<Deleted>;
7670
7762
  }
7763
+ /** Centros de costo: fiscalisto.costCenters. */
7764
+ export declare class CostCentersResource {
7765
+ #private;
7766
+ constructor(client: Client);
7767
+ /**
7768
+ * Crear un centro de costo
7769
+ *
7770
+ * Una parte del negocio del emisor que quiere ver por separado: una obra, un proyecto, una sucursal, un área. Sus facturas lo toman con cost_center al crearlas, o después con POST /v1/invoices/{id} y POST /v1/sat_invoices/{id}. Un nombre que ya existe contesta cost_center_exists. Hasta 500 por emisor.
7771
+ *
7772
+ * POST /v1/cost_centers
7773
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/create-cost-center
7774
+ */
7775
+ create(params: CreateCostCenterParams, options?: RequestOptions): Promise<CostCenter>;
7776
+ /**
7777
+ * Listar centros de costo
7778
+ *
7779
+ * Los centros de costo del emisor, los más recientes primero, con cuántas facturas tiene cada uno. Los archivados solo con include_archived=true.
7780
+ *
7781
+ * GET /v1/cost_centers
7782
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/list-cost-centers
7783
+ */
7784
+ list(params?: ListCostCentersParams, options?: RequestOptions): List<CostCenter>;
7785
+ /**
7786
+ * Ver un centro de costo
7787
+ *
7788
+ * Un centro de costo del emisor.
7789
+ *
7790
+ * GET /v1/cost_centers/{id}
7791
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/get-cost-center
7792
+ */
7793
+ get(id: string, options?: RequestOptions): Promise<CostCenter>;
7794
+ /**
7795
+ * Actualizar un centro de costo
7796
+ *
7797
+ * Cambia solo lo que manda. archived: true lo archiva (ya no se ponen facturas en él y las suyas lo conservan), false lo restaura.
7798
+ *
7799
+ * POST /v1/cost_centers/{id}
7800
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/update-cost-center
7801
+ */
7802
+ update(id: string, params?: UpdateCostCenterParams, options?: RequestOptions): Promise<CostCenter>;
7803
+ /**
7804
+ * Borrar un centro de costo
7805
+ *
7806
+ * Sus facturas pasan a move_to (así junta dos en uno) o se quedan sin centro de costo. No se puede deshacer; para dejar de usarlo sin tocar sus facturas, archívelo.
7807
+ *
7808
+ * DELETE /v1/cost_centers/{id}
7809
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/delete-cost-center
7810
+ */
7811
+ delete(id: string, params?: DeleteCostCenterParams, options?: RequestOptions): Promise<Deleted>;
7812
+ }
7671
7813
  /** Clientes: fiscalisto.customers. */
7672
7814
  export declare class CustomersResource {
7673
7815
  #private;
@@ -8047,6 +8189,15 @@ export declare class SatInvoicesResource {
8047
8189
  * @see https://fiscalisto.com/docs/api/referencia/descargas-del-sat/get-sat-invoice
8048
8190
  */
8049
8191
  get(id: string, options?: RequestOptions): Promise<SatInvoice>;
8192
+ /**
8193
+ * Actualizar una factura del SAT
8194
+ *
8195
+ * Lo que se puede cambiar de un CFDI del SAT sin tocarlo: su centro de costo (cost_center, o null para quitárselo), para ver sus gastos por obra, proyecto o área.
8196
+ *
8197
+ * POST /v1/sat_invoices/{id}
8198
+ * @see https://fiscalisto.com/docs/api/referencia/descargas-del-sat/update-sat-invoice
8199
+ */
8200
+ update(id: string, params?: UpdateSatInvoiceParams, options?: RequestOptions): Promise<SatInvoice>;
8050
8201
  /**
8051
8202
  * Descargar el XML de una factura del SAT
8052
8203
  *
@@ -8608,6 +8759,7 @@ export declare class FiscalistoApi extends Core {
8608
8759
  readonly invoiceBatches: InvoiceBatchesResource;
8609
8760
  readonly taxIds: TaxIdsResource;
8610
8761
  readonly branches: BranchesResource;
8762
+ readonly costCenters: CostCentersResource;
8611
8763
  readonly customers: CustomersResource;
8612
8764
  readonly customerDataRequests: CustomerDataRequestsResource;
8613
8765
  readonly products: ProductsResource;
package/dist/generated.js CHANGED
@@ -411,6 +411,17 @@ export class InvoicesResource {
411
411
  get(id, params, options) {
412
412
  return this.#client.request({ method: "GET", path: `/v1/invoices/${encodeURIComponent(id)}`, query: params }, options);
413
413
  }
414
+ /**
415
+ * Actualizar una factura
416
+ *
417
+ * Lo que se puede cambiar de una factura timbrada sin tocar el CFDI: su centro de costo (cost_center, o null para quitárselo). Los complementos de pago y los traslados no llevan.
418
+ *
419
+ * POST /v1/invoices/{id}
420
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/update-invoice
421
+ */
422
+ update(id, params, options) {
423
+ return this.#client.request({ method: "POST", path: `/v1/invoices/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
424
+ }
414
425
  /**
415
426
  * Descargar el PDF
416
427
  *
@@ -1239,6 +1250,68 @@ export class BranchesResource {
1239
1250
  return this.#client.request({ method: "DELETE", path: `/v1/branches/${encodeURIComponent(id)}` }, options);
1240
1251
  }
1241
1252
  }
1253
+ /** Centros de costo: fiscalisto.costCenters. */
1254
+ export class CostCentersResource {
1255
+ #client;
1256
+ constructor(client) {
1257
+ this.#client = client;
1258
+ }
1259
+ /**
1260
+ * Crear un centro de costo
1261
+ *
1262
+ * Una parte del negocio del emisor que quiere ver por separado: una obra, un proyecto, una sucursal, un área. Sus facturas lo toman con cost_center al crearlas, o después con POST /v1/invoices/{id} y POST /v1/sat_invoices/{id}. Un nombre que ya existe contesta cost_center_exists. Hasta 500 por emisor.
1263
+ *
1264
+ * POST /v1/cost_centers
1265
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/create-cost-center
1266
+ */
1267
+ create(params, options) {
1268
+ return this.#client.request({ method: "POST", path: "/v1/cost_centers", body: params, idempotent: true }, options);
1269
+ }
1270
+ /**
1271
+ * Listar centros de costo
1272
+ *
1273
+ * Los centros de costo del emisor, los más recientes primero, con cuántas facturas tiene cada uno. Los archivados solo con include_archived=true.
1274
+ *
1275
+ * GET /v1/cost_centers
1276
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/list-cost-centers
1277
+ */
1278
+ list(params, options) {
1279
+ return this.#client.list({ path: "/v1/cost_centers", query: params }, options);
1280
+ }
1281
+ /**
1282
+ * Ver un centro de costo
1283
+ *
1284
+ * Un centro de costo del emisor.
1285
+ *
1286
+ * GET /v1/cost_centers/{id}
1287
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/get-cost-center
1288
+ */
1289
+ get(id, options) {
1290
+ return this.#client.request({ method: "GET", path: `/v1/cost_centers/${encodeURIComponent(id)}` }, options);
1291
+ }
1292
+ /**
1293
+ * Actualizar un centro de costo
1294
+ *
1295
+ * Cambia solo lo que manda. archived: true lo archiva (ya no se ponen facturas en él y las suyas lo conservan), false lo restaura.
1296
+ *
1297
+ * POST /v1/cost_centers/{id}
1298
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/update-cost-center
1299
+ */
1300
+ update(id, params, options) {
1301
+ return this.#client.request({ method: "POST", path: `/v1/cost_centers/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
1302
+ }
1303
+ /**
1304
+ * Borrar un centro de costo
1305
+ *
1306
+ * Sus facturas pasan a move_to (así junta dos en uno) o se quedan sin centro de costo. No se puede deshacer; para dejar de usarlo sin tocar sus facturas, archívelo.
1307
+ *
1308
+ * DELETE /v1/cost_centers/{id}
1309
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/delete-cost-center
1310
+ */
1311
+ delete(id, params, options) {
1312
+ return this.#client.request({ method: "DELETE", path: `/v1/cost_centers/${encodeURIComponent(id)}`, query: params }, options);
1313
+ }
1314
+ }
1242
1315
  /** Clientes: fiscalisto.customers. */
1243
1316
  export class CustomersResource {
1244
1317
  #client;
@@ -1714,6 +1787,17 @@ export class SatInvoicesResource {
1714
1787
  get(id, options) {
1715
1788
  return this.#client.request({ method: "GET", path: `/v1/sat_invoices/${encodeURIComponent(id)}` }, options);
1716
1789
  }
1790
+ /**
1791
+ * Actualizar una factura del SAT
1792
+ *
1793
+ * Lo que se puede cambiar de un CFDI del SAT sin tocarlo: su centro de costo (cost_center, o null para quitárselo), para ver sus gastos por obra, proyecto o área.
1794
+ *
1795
+ * POST /v1/sat_invoices/{id}
1796
+ * @see https://fiscalisto.com/docs/api/referencia/descargas-del-sat/update-sat-invoice
1797
+ */
1798
+ update(id, params, options) {
1799
+ return this.#client.request({ method: "POST", path: `/v1/sat_invoices/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
1800
+ }
1717
1801
  /**
1718
1802
  * Descargar el XML de una factura del SAT
1719
1803
  *
@@ -2401,6 +2485,7 @@ export class FiscalistoApi extends Core {
2401
2485
  invoiceBatches = new InvoiceBatchesResource(this);
2402
2486
  taxIds = new TaxIdsResource(this);
2403
2487
  branches = new BranchesResource(this);
2488
+ costCenters = new CostCentersResource(this);
2404
2489
  customers = new CustomersResource(this);
2405
2490
  customerDataRequests = new CustomerDataRequestsResource(this);
2406
2491
  products = new ProductsResource(this);