fiscalisto 0.1.30 → 0.1.32

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/generated.js CHANGED
@@ -518,6 +518,79 @@ export class ReceivablesResource {
518
518
  return this.#client.list({ path: "/v1/receivables", query: params }, options);
519
519
  }
520
520
  }
521
+ /** Cuentas por cobrar: fiscalisto.customers. */
522
+ export class CustomersResource {
523
+ #client;
524
+ constructor(client) {
525
+ this.#client = client;
526
+ }
527
+ /**
528
+ * Ver cómo paga un cliente
529
+ *
530
+ * Cuántos días tarda en pagar, qué parte llega a tiempo con sus días de crédito, si paga más lento que antes, cómo le paga y cuándo le llegaría lo que debe. De sus facturas a crédito (PPD) de los últimos 12 meses y sus complementos de pago, como «Cómo paga» en la app. No aplica a XAXX010101000 ni XEXX010101000.
531
+ *
532
+ * GET /v1/customers/{id}/payment_behavior
533
+ * @see https://fiscalisto.com/docs/api/referencia/cuentas-por-cobrar/get-customer-payment-behavior
534
+ */
535
+ paymentBehavior(id, options) {
536
+ return this.#client.request({ method: "GET", path: `/v1/customers/${encodeURIComponent(id)}/payment_behavior` }, options);
537
+ }
538
+ /**
539
+ * Crear un cliente
540
+ *
541
+ * Un cliente del catálogo del emisor, con sus datos fiscales como vienen en su constancia. Un RFC que ya está en el catálogo contesta customer_exists.
542
+ *
543
+ * POST /v1/customers
544
+ * @see https://fiscalisto.com/docs/api/referencia/clientes/create-customer
545
+ */
546
+ create(params, options) {
547
+ return this.#client.request({ method: "POST", path: "/v1/customers", body: params, idempotent: true }, options);
548
+ }
549
+ /**
550
+ * Listar clientes
551
+ *
552
+ * Los clientes del emisor, los más recientes primero. Con tax_id, el de ese RFC.
553
+ *
554
+ * GET /v1/customers
555
+ * @see https://fiscalisto.com/docs/api/referencia/clientes/list-customers
556
+ */
557
+ list(params, options) {
558
+ return this.#client.list({ path: "/v1/customers", query: params }, options);
559
+ }
560
+ /**
561
+ * Ver un cliente
562
+ *
563
+ * Un cliente del catálogo.
564
+ *
565
+ * GET /v1/customers/{id}
566
+ * @see https://fiscalisto.com/docs/api/referencia/clientes/get-customer
567
+ */
568
+ get(id, options) {
569
+ return this.#client.request({ method: "GET", path: `/v1/customers/${encodeURIComponent(id)}` }, options);
570
+ }
571
+ /**
572
+ * Actualizar un cliente
573
+ *
574
+ * Cambia solo los campos que manda. Las facturas ya timbradas no cambian.
575
+ *
576
+ * POST /v1/customers/{id}
577
+ * @see https://fiscalisto.com/docs/api/referencia/clientes/update-customer
578
+ */
579
+ update(id, params, options) {
580
+ return this.#client.request({ method: "POST", path: `/v1/customers/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
581
+ }
582
+ /**
583
+ * Borrar un cliente
584
+ *
585
+ * Lo quita del catálogo. Sus facturas timbradas siguen igual.
586
+ *
587
+ * DELETE /v1/customers/{id}
588
+ * @see https://fiscalisto.com/docs/api/referencia/clientes/delete-customer
589
+ */
590
+ delete(id, options) {
591
+ return this.#client.request({ method: "DELETE", path: `/v1/customers/${encodeURIComponent(id)}` }, options);
592
+ }
593
+ }
521
594
  /** Conciliación bancaria: fiscalisto.bankTransactions. */
522
595
  export class BankTransactionsResource {
523
596
  #client;
@@ -1301,66 +1374,267 @@ export class CostCentersResource {
1301
1374
  return this.#client.request({ method: "DELETE", path: `/v1/cost_centers/${encodeURIComponent(id)}`, query: params }, options);
1302
1375
  }
1303
1376
  }
1304
- /** Clientes: fiscalisto.customers. */
1305
- export class CustomersResource {
1377
+ /** Viáticos y gastos: fiscalisto.expensePeople. */
1378
+ export class ExpensePeopleResource {
1306
1379
  #client;
1307
1380
  constructor(client) {
1308
1381
  this.#client = client;
1309
1382
  }
1310
1383
  /**
1311
- * Crear un cliente
1384
+ * Agregar a una persona
1312
1385
  *
1313
- * Un cliente del catálogo del emisor, con sus datos fiscales como vienen en su constancia. Un RFC que ya está en el catálogo contesta customer_exists.
1386
+ * Alguien que viaja o gasta por el emisor: un empleado (employee, emp_…: sus anticipos y reembolsos «En la nómina» van en su siguiente recibo) o alguien por honorarios (name y tax_id). Con email, Fiscalisto le puede mandar su enlace.
1314
1387
  *
1315
- * POST /v1/customers
1316
- * @see https://fiscalisto.com/docs/api/referencia/clientes/create-customer
1388
+ * POST /v1/expense_people
1389
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/create-expense-person
1317
1390
  */
1318
1391
  create(params, options) {
1319
- return this.#client.request({ method: "POST", path: "/v1/customers", body: params, idempotent: true }, options);
1392
+ return this.#client.request({ method: "POST", path: "/v1/expense_people", body: params, idempotent: true }, options);
1320
1393
  }
1321
1394
  /**
1322
- * Listar clientes
1395
+ * Listar personas
1323
1396
  *
1324
- * Los clientes del emisor, los más recientes primero. Con tax_id, el de ese RFC.
1397
+ * Las personas que comprueban gastos del emisor, las más recientes primero. Las archivadas solo con include_archived=true.
1325
1398
  *
1326
- * GET /v1/customers
1327
- * @see https://fiscalisto.com/docs/api/referencia/clientes/list-customers
1399
+ * GET /v1/expense_people
1400
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/list-expense-people
1328
1401
  */
1329
1402
  list(params, options) {
1330
- return this.#client.list({ path: "/v1/customers", query: params }, options);
1403
+ return this.#client.list({ path: "/v1/expense_people", query: params }, options);
1331
1404
  }
1332
1405
  /**
1333
- * Ver un cliente
1406
+ * Ver una persona
1334
1407
  *
1335
- * Un cliente del catálogo.
1408
+ * Una persona que comprueba gastos del emisor.
1336
1409
  *
1337
- * GET /v1/customers/{id}
1338
- * @see https://fiscalisto.com/docs/api/referencia/clientes/get-customer
1410
+ * GET /v1/expense_people/{id}
1411
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/get-expense-person
1339
1412
  */
1340
1413
  get(id, options) {
1341
- return this.#client.request({ method: "GET", path: `/v1/customers/${encodeURIComponent(id)}` }, options);
1414
+ return this.#client.request({ method: "GET", path: `/v1/expense_people/${encodeURIComponent(id)}` }, options);
1342
1415
  }
1343
1416
  /**
1344
- * Actualizar un cliente
1417
+ * Actualizar una persona
1345
1418
  *
1346
- * Cambia solo los campos que manda. Las facturas ya timbradas no cambian.
1419
+ * Cambia solo lo que manda. archived: true la archiva (ya no se le abren comprobaciones y su enlace deja de funcionar), false la restaura.
1347
1420
  *
1348
- * POST /v1/customers/{id}
1349
- * @see https://fiscalisto.com/docs/api/referencia/clientes/update-customer
1421
+ * POST /v1/expense_people/{id}
1422
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/update-expense-person
1350
1423
  */
1351
1424
  update(id, params, options) {
1352
- return this.#client.request({ method: "POST", path: `/v1/customers/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
1425
+ return this.#client.request({ method: "POST", path: `/v1/expense_people/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
1353
1426
  }
1354
1427
  /**
1355
- * Borrar un cliente
1428
+ * Dar su enlace a una persona
1356
1429
  *
1357
- * Lo quita del catálogo. Sus facturas timbradas siguen igual.
1430
+ * El enlace donde la persona ve solo sus comprobaciones y sube sus facturas desde el teléfono, sin cuenta. Con renew: true le da uno nuevo y el anterior deja de funcionar.
1358
1431
  *
1359
- * DELETE /v1/customers/{id}
1360
- * @see https://fiscalisto.com/docs/api/referencia/clientes/delete-customer
1432
+ * POST /v1/expense_people/{id}/link
1433
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/create-expense-person-link
1434
+ */
1435
+ createLink(id, params, options) {
1436
+ return this.#client.request({ method: "POST", path: `/v1/expense_people/${encodeURIComponent(id)}/link`, body: params, idempotent: true }, options);
1437
+ }
1438
+ /**
1439
+ * Apagar el enlace de una persona
1440
+ *
1441
+ * Su enlace deja de funcionar (url: null). Puede darle uno nuevo después con POST /v1/expense_people/{id}/link.
1442
+ *
1443
+ * DELETE /v1/expense_people/{id}/link
1444
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/delete-expense-person-link
1445
+ */
1446
+ deleteLink(id, options) {
1447
+ return this.#client.request({ method: "DELETE", path: `/v1/expense_people/${encodeURIComponent(id)}/link` }, options);
1448
+ }
1449
+ }
1450
+ /** Viáticos y gastos: fiscalisto.expenseReports. */
1451
+ export class ExpenseReportsResource {
1452
+ #client;
1453
+ constructor(client) {
1454
+ this.#client = client;
1455
+ }
1456
+ /**
1457
+ * Abrir una comprobación
1458
+ *
1459
+ * Una por viaje (kind viaje) o una por periodo de gastos de oficina que la empresa reembolsa (kind gastos). Queda abierta (draft): se le agregan gastos y anticipos, y se envía con POST /v1/expense_reports/{id}/submit.
1460
+ *
1461
+ * POST /v1/expense_reports
1462
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/create-expense-report
1463
+ */
1464
+ create(params, options) {
1465
+ return this.#client.request({ method: "POST", path: "/v1/expense_reports", body: params, idempotent: true }, options);
1466
+ }
1467
+ /**
1468
+ * Listar comprobaciones
1469
+ *
1470
+ * Las comprobaciones del emisor, las más recientes primero, con sus gastos y movimientos.
1471
+ *
1472
+ * GET /v1/expense_reports
1473
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/list-expense-reports
1474
+ */
1475
+ list(params, options) {
1476
+ return this.#client.list({ path: "/v1/expense_reports", query: params }, options);
1477
+ }
1478
+ /**
1479
+ * Ver una comprobación
1480
+ *
1481
+ * Una comprobación con sus gastos, lo deducible de cada uno, sus avisos (issues) contra la ley y la política, y su saldo.
1482
+ *
1483
+ * GET /v1/expense_reports/{id}
1484
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/get-expense-report
1485
+ */
1486
+ get(id, options) {
1487
+ return this.#client.request({ method: "GET", path: `/v1/expense_reports/${encodeURIComponent(id)}` }, options);
1488
+ }
1489
+ /**
1490
+ * Actualizar una comprobación
1491
+ *
1492
+ * Cambia solo lo que manda: su nombre, el propósito, el destino y las fechas. Mientras no esté aprobada.
1493
+ *
1494
+ * POST /v1/expense_reports/{id}
1495
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/update-expense-report
1496
+ */
1497
+ update(id, params, options) {
1498
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
1499
+ }
1500
+ /**
1501
+ * Borrar una comprobación
1502
+ *
1503
+ * Una que no esté aprobada y no tenga anticipos ni pagos (quítelos antes). No se puede deshacer.
1504
+ *
1505
+ * DELETE /v1/expense_reports/{id}
1506
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/delete-expense-report
1361
1507
  */
1362
1508
  delete(id, options) {
1363
- return this.#client.request({ method: "DELETE", path: `/v1/customers/${encodeURIComponent(id)}` }, options);
1509
+ return this.#client.request({ method: "DELETE", path: `/v1/expense_reports/${encodeURIComponent(id)}` }, options);
1510
+ }
1511
+ /**
1512
+ * Enviar a aprobar
1513
+ *
1514
+ * La persona termina: pasa a submitted (por aprobar). Contesta expense_report_invalid si un gasto tiene un error (issues con level error).
1515
+ *
1516
+ * POST /v1/expense_reports/{id}/submit
1517
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/submit-expense-report
1518
+ */
1519
+ submit(id, options) {
1520
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}/submit`, idempotent: true }, options);
1521
+ }
1522
+ /**
1523
+ * Aprobar una comprobación
1524
+ *
1525
+ * Pasa a approved (por liquidar): sus facturas se deducen en los impuestos del emisor y entra en las pólizas contra 107.01 Funcionarios y empleados. Con el saldo en cero se cierra sola; si no, liquide con un reembolso o una devolución.
1526
+ *
1527
+ * POST /v1/expense_reports/{id}/approve
1528
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/approve-expense-report
1529
+ */
1530
+ approve(id, params, options) {
1531
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}/approve`, body: params, idempotent: true }, options);
1532
+ }
1533
+ /**
1534
+ * Devolver para corregir
1535
+ *
1536
+ * Regresa a la persona (rejected, «Devuelta») con una nota de qué corregir. La corrige y la vuelve a enviar.
1537
+ *
1538
+ * POST /v1/expense_reports/{id}/return
1539
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/return-expense-report
1540
+ */
1541
+ sendBack(id, params, options) {
1542
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}/return`, body: params, idempotent: true }, options);
1543
+ }
1544
+ /**
1545
+ * Reabrir una comprobación
1546
+ *
1547
+ * Una aprobada vuelve a abierta: sus facturas dejan de deducirse y sale de las pólizas. No si ya se reportó en la nómina.
1548
+ *
1549
+ * POST /v1/expense_reports/{id}/reopen
1550
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/reopen-expense-report
1551
+ */
1552
+ reopen(id, options) {
1553
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}/reopen`, idempotent: true }, options);
1554
+ }
1555
+ /**
1556
+ * Agregar un gasto
1557
+ *
1558
+ * Con uuid, una factura recibida del emisor (GET /v1/sat_invoices): la fecha, el monto y el proveedor salen de ella. Sin uuid, un gasto con su category, date y amount (un ticket, un comprobante del extranjero). Contesta la comprobación revisada.
1559
+ *
1560
+ * POST /v1/expense_reports/{id}/items
1561
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/create-expense-item
1562
+ */
1563
+ createItem(id, params, options) {
1564
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}/items`, body: params, idempotent: true }, options);
1565
+ }
1566
+ /**
1567
+ * Actualizar un gasto
1568
+ *
1569
+ * Cambia solo lo que manda. Al revisarla, rejected: true con reject_reason rechaza el gasto (no se paga ni se deduce) y false lo vuelve a incluir.
1570
+ *
1571
+ * POST /v1/expense_reports/{id}/items/{item}
1572
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/update-expense-item
1573
+ */
1574
+ updateItem(id, item, params, options) {
1575
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}/items/${encodeURIComponent(item)}`, body: params, idempotent: true }, options);
1576
+ }
1577
+ /**
1578
+ * Quitar un gasto
1579
+ *
1580
+ * Lo quita de la comprobación mientras no esté aprobada. Contesta la comprobación.
1581
+ *
1582
+ * DELETE /v1/expense_reports/{id}/items/{item}
1583
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/delete-expense-item
1584
+ */
1585
+ deleteItem(id, item, options) {
1586
+ return this.#client.request({ method: "DELETE", path: `/v1/expense_reports/${encodeURIComponent(id)}/items/${encodeURIComponent(item)}` }, options);
1587
+ }
1588
+ /**
1589
+ * Registrar dinero dado o devuelto
1590
+ *
1591
+ * Un anticipo (antes de aprobarla), un reembolso o una devolución (ya aprobada). Con method nomina va en el siguiente recibo de nómina del empleado. Con el saldo en cero, una aprobada se cierra.
1592
+ *
1593
+ * POST /v1/expense_reports/{id}/movements
1594
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/create-expense-movement
1595
+ */
1596
+ createMovement(id, params, options) {
1597
+ return this.#client.request({ method: "POST", path: `/v1/expense_reports/${encodeURIComponent(id)}/movements`, body: params, idempotent: true }, options);
1598
+ }
1599
+ /**
1600
+ * Deshacer un movimiento
1601
+ *
1602
+ * Lo quita (una cerrada vuelve a por liquidar). No uno que ya se pagó en la nómina.
1603
+ *
1604
+ * DELETE /v1/expense_reports/{id}/movements/{movement}
1605
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/delete-expense-movement
1606
+ */
1607
+ deleteMovement(id, movement, options) {
1608
+ return this.#client.request({ method: "DELETE", path: `/v1/expense_reports/${encodeURIComponent(id)}/movements/${encodeURIComponent(movement)}` }, options);
1609
+ }
1610
+ }
1611
+ /** Viáticos y gastos: fiscalisto.expensePolicy. */
1612
+ export class ExpensePolicyResource {
1613
+ #client;
1614
+ constructor(client) {
1615
+ this.#client = client;
1616
+ }
1617
+ /**
1618
+ * Ver la política
1619
+ *
1620
+ * La política de viáticos y gastos del emisor: topes por categoría, hasta cuánto sin factura y los días para comprobar.
1621
+ *
1622
+ * GET /v1/expense_policy
1623
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/get-expense-policy
1624
+ */
1625
+ get(params, options) {
1626
+ return this.#client.request({ method: "GET", path: "/v1/expense_policy", query: params }, options);
1627
+ }
1628
+ /**
1629
+ * Cambiar la política
1630
+ *
1631
+ * Cambia solo lo que manda; en limits, una categoría con null deja de tener tope. Un gasto que pasa un tope no se rechaza: se marca para quien aprueba.
1632
+ *
1633
+ * POST /v1/expense_policy
1634
+ * @see https://fiscalisto.com/docs/api/referencia/viaticos-y-gastos/update-expense-policy
1635
+ */
1636
+ update(params, options) {
1637
+ return this.#client.request({ method: "POST", path: "/v1/expense_policy", body: params, idempotent: true }, options);
1364
1638
  }
1365
1639
  }
1366
1640
  /** Clientes: fiscalisto.customerDataRequests. */
@@ -1995,6 +2269,17 @@ export class AccountingResource {
1995
2269
  crossChecks(params, options) {
1996
2270
  return this.#client.request({ method: "GET", path: "/v1/accounting/cross_checks", query: params }, options);
1997
2271
  }
2272
+ /**
2273
+ * Ver el IVA a favor y preparar su devolución
2274
+ *
2275
+ * El IVA a favor de cada mes de los últimos cinco años (de las declaraciones leídas con POST /v1/sat_declarations/refresh o, sin ellas, de sus CFDI, con estimated en true), cuánto se acreditó después (del saldo más antiguo primero), cuánto queda, qué está en devolución y cuándo prescribe. Con `month`, la revisión de ese mes antes de pedirlo en el SAT: declaración, cruce con CFDI, DIOT, opinión de cumplimiento, Buzón Tributario, e.firma, listas del SAT, CFDI de proveedores con hallazgos y CLABE, con el monto a pedir. No presenta nada en el SAT. Gratis.
2276
+ *
2277
+ * GET /v1/accounting/vat_refund
2278
+ * @see https://fiscalisto.com/docs/api/referencia/contabilidad/get-vat-refund
2279
+ */
2280
+ vatRefund(params, options) {
2281
+ return this.#client.request({ method: "GET", path: "/v1/accounting/vat_refund", query: params }, options);
2282
+ }
1998
2283
  /**
1999
2284
  * Ver los CFDI de una cifra del cruce
2000
2285
  *
@@ -2459,6 +2744,7 @@ export class FiscalistoApi extends Core {
2459
2744
  issuers = new IssuersResource(this);
2460
2745
  invoices = new InvoicesResource(this);
2461
2746
  receivables = new ReceivablesResource(this);
2747
+ customers = new CustomersResource(this);
2462
2748
  bankTransactions = new BankTransactionsResource(this);
2463
2749
  purchaseReceipts = new PurchaseReceiptsResource(this);
2464
2750
  payments = new PaymentsResource(this);
@@ -2475,7 +2761,9 @@ export class FiscalistoApi extends Core {
2475
2761
  taxIds = new TaxIdsResource(this);
2476
2762
  branches = new BranchesResource(this);
2477
2763
  costCenters = new CostCentersResource(this);
2478
- customers = new CustomersResource(this);
2764
+ expensePeople = new ExpensePeopleResource(this);
2765
+ expenseReports = new ExpenseReportsResource(this);
2766
+ expensePolicy = new ExpensePolicyResource(this);
2479
2767
  customerDataRequests = new CustomerDataRequestsResource(this);
2480
2768
  products = new ProductsResource(this);
2481
2769
  satMailboxMessages = new SatMailboxMessagesResource(this);