fiscalisto 0.1.0 → 0.1.2

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.
@@ -9,6 +9,10 @@ export interface Account {
9
9
  object: "account";
10
10
  /** El nombre de la cuenta API. */
11
11
  name: string;
12
+ /** La versión de la API de la cuenta (la de sus solicitudes sin Fiscalisto-Version). Ver Versiones. */
13
+ api_version: string;
14
+ /** La versión más reciente de la API. */
15
+ latest_api_version: string;
12
16
  /** La llave con que se hizo la solicitud: id, nombre y emisores a los que se limita. */
13
17
  key: {
14
18
  /** Id de la llave. */
@@ -524,6 +528,8 @@ export interface Customer {
524
528
  } | null;
525
529
  /** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
526
530
  ieps_taxpayer: boolean;
531
+ /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
532
+ created_at: string;
527
533
  /** Cuándo cambió por última vez, ISO 8601 (-06:00). */
528
534
  updated_at: string | null;
529
535
  }
@@ -551,6 +557,8 @@ export interface Product {
551
557
  sku: string | null;
552
558
  /** Precio unitario antes de impuestos (ValorUnitario). */
553
559
  unit_price: number;
560
+ /** Precio abierto: el producto no tiene precio fijo y cada concepto con él manda su unit_price. */
561
+ open_price: boolean;
554
562
  /** Objeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa… */
555
563
  taxability: string;
556
564
  /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
@@ -563,6 +571,17 @@ export interface Product {
563
571
  iva_retention: number;
564
572
  /** Tasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO). */
565
573
  isr_retention: number;
574
+ /** Impuestos locales (complemento implocal): traslados y retenciones estatales. */
575
+ local_taxes: {
576
+ /** true si es una retención local; false si es un traslado. */
577
+ retention: boolean;
578
+ /** Nombre del impuesto local (ImpLocTrasladado o ImpLocRetenido), como ISH. */
579
+ name: string;
580
+ /** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
581
+ rate: number;
582
+ }[];
583
+ /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
584
+ created_at: string;
566
585
  /** Cuándo cambió por última vez, ISO 8601 (-06:00). */
567
586
  updated_at: string | null;
568
587
  }
@@ -620,6 +639,8 @@ export interface Employee {
620
639
  position: string | null;
621
640
  /** Lo que el SAT podría observar de sus datos, antes de timbrar. */
622
641
  warnings: string[];
642
+ /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
643
+ created_at: string;
623
644
  }
624
645
  /** El recibo como se timbraría: percepciones, deducciones (ISR, IMSS), otros pagos (subsidio) y el neto. */
625
646
  export interface PayrollReceiptPreview {
@@ -1108,6 +1129,113 @@ export interface SatInvoice {
1108
1129
  /** Cuándo llegó. */
1109
1130
  downloaded_at: string | null;
1110
1131
  }
1132
+ /** Una declaración que el emisor presentó ante el SAT (provisional o definitiva, anual o del servicio anterior Declaraciones y pagos), con sus cifras y sus archivos. */
1133
+ export interface SatDeclaration {
1134
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, evt_, whe_). */
1135
+ id: string;
1136
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1137
+ livemode: boolean;
1138
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1139
+ object: "sat_declaration";
1140
+ /** El emisor que la presentó. */
1141
+ issuer: string;
1142
+ /** monthly (provisional o definitiva, desde 2022), annual (la anual de persona moral) o dyp (el servicio anterior Declaraciones y pagos, 2021 y antes). */
1143
+ source: "monthly" | "annual" | "dyp";
1144
+ /** El ejercicio. */
1145
+ year: number;
1146
+ /** El mes (1 a 12), o null en la anual y otros periodos. */
1147
+ month: number | null;
1148
+ /** El periodo como lo nombra el SAT: «Enero», «Del Ejercicio»… */
1149
+ period: string;
1150
+ /** normal o complementary (complementaria). */
1151
+ type: "normal" | "complementary";
1152
+ /** El tipo de complementaria como lo dice el SAT («Modificación de obligaciones»…), o null. */
1153
+ complementary_type: string | null;
1154
+ /** El número de operación que le dio el SAT. */
1155
+ operation_number: string;
1156
+ /** La línea de captura, si hubo algo a pagar. */
1157
+ payment_line: string | null;
1158
+ /** Cuándo se presentó (AAAA-MM-DD). */
1159
+ filed_on: string | null;
1160
+ /** El coeficiente de utilidad que aplicó (ISR de personas morales), o null. */
1161
+ profit_coefficient: number | null;
1162
+ /** El ISR a cargo, según el acuse. */
1163
+ isr_due: number | null;
1164
+ /** El IVA a cargo, según el acuse. */
1165
+ vat_due: number | null;
1166
+ /** El total a pagar, según el acuse. */
1167
+ total_due: number | null;
1168
+ /** Las cifras de la declaración por impuesto (tax), cada una con su texto como lo imprime el SAT (label) y su valor. Vacío en las de Declaraciones y pagos (su PDF trae dos columnas que no se leen con certeza) o si el PDF aún no llega. */
1169
+ sections: {
1170
+ /** Impuesto: isr, iva o ieps (ImpuestoRet 001, 002, 003). */
1171
+ tax: string;
1172
+ /** Los renglones del impuesto, en el orden del PDF. */
1173
+ fields: {
1174
+ /** El renglón como lo imprime el SAT. */
1175
+ label: string;
1176
+ /** Valor de la mercancía (ValorMercancia); obligatorio en transporte aéreo. */
1177
+ value: number | string;
1178
+ }[];
1179
+ }[];
1180
+ /** Lo que dice el acuse: cada concepto con su cantidad a cargo y a pagar, el total, la línea de captura y su vigencia. null si el acuse aún no llega. */
1181
+ receipt: {
1182
+ /** Cada impuesto del acuse. */
1183
+ concepts: {
1184
+ /** Concepto del pago (ConceptoPago), c_TipoContribuyenteSujetoRetencion. */
1185
+ concept: string;
1186
+ /** Lo que resultó a cargo. */
1187
+ due: number | null;
1188
+ /** La cantidad a cargo. */
1189
+ amount_due: number | null;
1190
+ /** La cantidad a pagar. */
1191
+ amount_to_pay: number | null;
1192
+ }[];
1193
+ /** Total en la moneda del comprobante (Total). */
1194
+ total: number | null;
1195
+ /** La línea de captura del acuse. */
1196
+ payment_line: string | null;
1197
+ /** Hasta cuándo sirve la línea de captura (AAAA-MM-DD). */
1198
+ valid_until: string | null;
1199
+ } | null;
1200
+ /** Qué archivos ya tiene: pdf (GET …/pdf), receipt (GET …/receipt) y financial_statements (GET …/financial_statements, solo en la anual de persona moral). */
1201
+ files: {
1202
+ /** Si ya tiene la declaración en PDF (GET …/pdf). */
1203
+ pdf: boolean;
1204
+ /** Si ya tiene el acuse (GET …/receipt). */
1205
+ receipt: boolean;
1206
+ /** Si ya tiene el Excel de estados financieros (GET …/financial_statements), solo en la anual de persona moral. */
1207
+ financial_statements: boolean;
1208
+ };
1209
+ /** Por qué falta un archivo, como lo dijo el SAT (por ejemplo «No se puede generar el archivo»). Se vuelve a pedir en la siguiente consulta. */
1210
+ files_error: string | null;
1211
+ /** Cuándo se trajo por primera vez. */
1212
+ created_at: string | null;
1213
+ /** Cuándo cambió por última vez. */
1214
+ updated_at: string | null;
1215
+ }
1216
+ /** Lo que trajo una consulta de las declaraciones del emisor en el SAT. */
1217
+ export interface SatDeclarationsRefresh {
1218
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1219
+ object: "sat_declarations_refresh";
1220
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1221
+ livemode: boolean;
1222
+ /** El emisor consultado. */
1223
+ issuer: string;
1224
+ /** completed (ya bajó todo) o processing (queda algo por bajar: sigue solo en la siguiente hora, sin otro timbre). */
1225
+ status: "completed" | "processing";
1226
+ /** Cuántas declaraciones listó el SAT en los años consultados. */
1227
+ found: number;
1228
+ /** Cuántos archivos bajó en esta consulta. */
1229
+ downloaded: number;
1230
+ /** Cuántas declaraciones quedan con archivos por bajar. */
1231
+ pending: number;
1232
+ /** Si una parte del SAT falló (por ejemplo, la anual), lo que dijo; lo demás sí se trajo. null si todo salió. */
1233
+ warning: string | null;
1234
+ /** Cuándo se consultó. */
1235
+ refreshed_at: string;
1236
+ /** Desde cuándo se puede volver a consultar este emisor (10 minutos después). */
1237
+ next_refresh_at: string;
1238
+ }
1111
1239
  /** Una venta que su comprador puede facturar él mismo en el portal del emisor (autofactura). */
1112
1240
  export interface Ticket {
1113
1241
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, evt_, whe_). */
@@ -1240,7 +1368,7 @@ export interface RecurringInvoice {
1240
1368
  /** Cuándo se creó. */
1241
1369
  created_at: string | null;
1242
1370
  }
1243
- /** La póliza de diario de un CFDI: sus cargos y abonos, que siempre cuadran. */
1371
+ /** Una póliza de diario (de un CFDI, un pago, un recibo de nómina o la depreciación del mes): sus cargos y abonos, que siempre cuadran. */
1244
1372
  export interface JournalEntry {
1245
1373
  /** El número de la póliza: D-AAAAMM-NNNNN, en orden de fecha dentro del mes. */
1246
1374
  id: string;
@@ -1250,19 +1378,21 @@ export interface JournalEntry {
1250
1378
  object: "journal_entry";
1251
1379
  /** El emisor. */
1252
1380
  issuer: string;
1253
- /** La fecha del CFDI. */
1381
+ /** De qué es: invoice (un CFDI de ingreso o egreso), payment_received o payment_made (un pago de un complemento), payroll (un recibo de nómina) o depreciation (la depreciación del mes de los activos fijos). */
1382
+ type: "invoice" | "payment_received" | "payment_made" | "payroll" | "depreciation";
1383
+ /** La fecha del CFDI o del pago; en la depreciación, el último día del mes. */
1254
1384
  date: string;
1255
- /** Factura o nota de crédito, su folio y la contraparte. */
1385
+ /** El documento, su folio y la contraparte. */
1256
1386
  description: string;
1257
- /** La factura (inv_…) si la timbró este emisor; null si la recibió. */
1387
+ /** La factura (inv_…) si es la póliza de un CFDI que timbró este emisor; null en los demás casos. */
1258
1388
  invoice: string | null;
1259
- /** El folio fiscal del CFDI. */
1260
- uuid: string;
1261
- /** El RFC de la contraparte (cliente o proveedor). */
1262
- tax_id: string;
1263
- /** El total del CFDI, en su moneda. */
1389
+ /** El folio fiscal del CFDI (o del complemento de pago); null en la depreciación. */
1390
+ uuid: string | null;
1391
+ /** El RFC de la contraparte (cliente, proveedor o empleado); null en la depreciación. */
1392
+ tax_id: string | null;
1393
+ /** El total del documento, en su moneda. */
1264
1394
  total: number;
1265
- /** La moneda del CFDI. */
1395
+ /** La moneda del documento. */
1266
1396
  currency: string;
1267
1397
  /** El tipo de cambio, si no es en pesos; null si es en pesos. */
1268
1398
  exchange_rate: number | null;
@@ -1334,6 +1464,237 @@ export interface TrialBalance {
1334
1464
  credit: number;
1335
1465
  };
1336
1466
  }
1467
+ /** El estado de resultados y el balance general de un mes, leídos de su balanza. */
1468
+ export interface FinancialStatements {
1469
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1470
+ object: "financial_statements";
1471
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1472
+ livemode: boolean;
1473
+ /** El emisor. */
1474
+ issuer: string;
1475
+ /** El mes (AAAA-MM). */
1476
+ month: string;
1477
+ /** El estado de resultados del mes (month) y del año hasta ese mes (year_to_date). Cada sección suma en positivo lo que aumenta la utilidad (ingresos) y en negativo lo que la reduce (costos y gastos). */
1478
+ income_statement: {
1479
+ /** El estado de resultados del mes. */
1480
+ month: {
1481
+ /** Ingresos, costos, gastos, financiamiento y otros, cada uno con su total. */
1482
+ sections: {
1483
+ /** El archivo .key en base64 (puede traer el prefijo data:). */
1484
+ key: "ingresos" | "costos" | "gastos" | "financiamiento" | "otros";
1485
+ /** Nombre. */
1486
+ name: string;
1487
+ /** Total en la moneda del comprobante (Total). */
1488
+ total: number;
1489
+ /** Su monto por el primer nivel del código agrupador. */
1490
+ groups: {
1491
+ /** El primer nivel del código agrupador (401, 601…). */
1492
+ grouping_code: string;
1493
+ /** Nombre. */
1494
+ name: string;
1495
+ /** Importe. */
1496
+ amount: number;
1497
+ /** Las cuentas del grupo con su monto. */
1498
+ accounts: {
1499
+ /** Número de empleado (NumEmpleado). */
1500
+ number: string;
1501
+ /** Nombre. */
1502
+ name: string;
1503
+ /** Importe. */
1504
+ amount: number;
1505
+ }[];
1506
+ }[];
1507
+ }[];
1508
+ /** La utilidad (o pérdida, negativa) antes de impuestos del mes. */
1509
+ net_income: number;
1510
+ };
1511
+ /** El estado de resultados de enero al mes. */
1512
+ year_to_date: {
1513
+ /** Ingresos, costos, gastos, financiamiento y otros, cada uno con su total. */
1514
+ sections: {
1515
+ /** El archivo .key en base64 (puede traer el prefijo data:). */
1516
+ key: "ingresos" | "costos" | "gastos" | "financiamiento" | "otros";
1517
+ /** Nombre. */
1518
+ name: string;
1519
+ /** Total en la moneda del comprobante (Total). */
1520
+ total: number;
1521
+ /** Su monto por el primer nivel del código agrupador. */
1522
+ groups: {
1523
+ /** El primer nivel del código agrupador (401, 601…). */
1524
+ grouping_code: string;
1525
+ /** Nombre. */
1526
+ name: string;
1527
+ /** Importe. */
1528
+ amount: number;
1529
+ /** Las cuentas del grupo con su monto. */
1530
+ accounts: {
1531
+ /** Número de empleado (NumEmpleado). */
1532
+ number: string;
1533
+ /** Nombre. */
1534
+ name: string;
1535
+ /** Importe. */
1536
+ amount: number;
1537
+ }[];
1538
+ }[];
1539
+ }[];
1540
+ /** La utilidad (o pérdida, negativa) antes de impuestos de enero al mes. */
1541
+ net_income: number;
1542
+ };
1543
+ };
1544
+ /** El balance general al cierre del mes, agrupado por el primer nivel del código agrupador. difference es activo menos pasivo y capital: 0 cuando los libros cuadran. */
1545
+ balance_sheet: {
1546
+ /** El activo: su total y sus grupos. */
1547
+ assets: {
1548
+ /** Total en la moneda del comprobante (Total). */
1549
+ total: number;
1550
+ /** Su monto por el primer nivel del código agrupador. */
1551
+ groups: {
1552
+ /** El primer nivel del código agrupador (401, 601…). */
1553
+ grouping_code: string;
1554
+ /** Nombre. */
1555
+ name: string;
1556
+ /** Importe. */
1557
+ amount: number;
1558
+ /** Las cuentas del grupo con su monto. */
1559
+ accounts: {
1560
+ /** Número de empleado (NumEmpleado). */
1561
+ number: string;
1562
+ /** Nombre. */
1563
+ name: string;
1564
+ /** Importe. */
1565
+ amount: number;
1566
+ }[];
1567
+ }[];
1568
+ };
1569
+ /** El pasivo: su total y sus grupos. */
1570
+ liabilities: {
1571
+ /** Total en la moneda del comprobante (Total). */
1572
+ total: number;
1573
+ /** Su monto por el primer nivel del código agrupador. */
1574
+ groups: {
1575
+ /** El primer nivel del código agrupador (401, 601…). */
1576
+ grouping_code: string;
1577
+ /** Nombre. */
1578
+ name: string;
1579
+ /** Importe. */
1580
+ amount: number;
1581
+ /** Las cuentas del grupo con su monto. */
1582
+ accounts: {
1583
+ /** Número de empleado (NumEmpleado). */
1584
+ number: string;
1585
+ /** Nombre. */
1586
+ name: string;
1587
+ /** Importe. */
1588
+ amount: number;
1589
+ }[];
1590
+ }[];
1591
+ };
1592
+ /** El capital contable sin el resultado del ejercicio: su total y sus grupos. */
1593
+ equity: {
1594
+ /** Total en la moneda del comprobante (Total). */
1595
+ total: number;
1596
+ /** Su monto por el primer nivel del código agrupador. */
1597
+ groups: {
1598
+ /** El primer nivel del código agrupador (401, 601…). */
1599
+ grouping_code: string;
1600
+ /** Nombre. */
1601
+ name: string;
1602
+ /** Importe. */
1603
+ amount: number;
1604
+ /** Las cuentas del grupo con su monto. */
1605
+ accounts: {
1606
+ /** Número de empleado (NumEmpleado). */
1607
+ number: string;
1608
+ /** Nombre. */
1609
+ name: string;
1610
+ /** Importe. */
1611
+ amount: number;
1612
+ }[];
1613
+ }[];
1614
+ };
1615
+ /** El resultado del ejercicio hasta el mes, parte del capital. */
1616
+ net_income_year_to_date: number;
1617
+ /** Pasivo más capital más el resultado del ejercicio. */
1618
+ liabilities_and_equity: number;
1619
+ /** Activo menos pasivo y capital: 0 cuando los libros cuadran. */
1620
+ difference: number;
1621
+ };
1622
+ /** Cuántas pólizas tuvo el mes. */
1623
+ journal_entries: number;
1624
+ /** Desde qué fecha cuentan los saldos iniciales capturados en la app; null si no hay. */
1625
+ opening_balances_date: string | null;
1626
+ /** Pagos que se refieren a facturas que no están en Fiscalisto y no se registraron. */
1627
+ missing_invoices: number;
1628
+ }
1629
+ /** Lo que el emisor declaró cada mes contra lo que dicen sus CFDI, el IVA a favor y el régimen con que factura. */
1630
+ export interface CrossChecks {
1631
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1632
+ object: "cross_checks";
1633
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1634
+ livemode: boolean;
1635
+ /** El emisor. */
1636
+ issuer: string;
1637
+ /** El ejercicio. */
1638
+ year: number;
1639
+ /** Cada mes cuya declaración mensual ya venció (el día 17 del mes siguiente), con sus cruces. Un mes con complementaria toma, por impuesto, la más reciente que lo trae. */
1640
+ months: {
1641
+ /** El mes (AAAA-MM). */
1642
+ month: string;
1643
+ /** El peor de sus cruces: differs (no coincide), unreadable (una cifra no se pudo leer), not_filed (sin declaración mensual) o matches. */
1644
+ status: "matches" | "differs" | "not_filed" | "unreadable";
1645
+ /** Un cruce por cifra. */
1646
+ checks: {
1647
+ /** Qué cifra: vat_charged (IVA trasladado), vat_creditable (IVA acreditable), vat_withheld (IVA que le retuvieron) o isr_income (ingresos para ISR: nominales en persona moral, cobrados en los demás). */
1648
+ key: "vat_charged" | "vat_creditable" | "vat_withheld" | "isr_income";
1649
+ /** matches (hasta $2 de diferencia), differs, not_filed (no hay declaración del mes) o unreadable (la declaración no trae la cifra en un renglón reconocible). */
1650
+ status: "matches" | "differs" | "not_filed" | "unreadable";
1651
+ /** Lo declarado, en pesos; null si no hay declaración o no se pudo leer. */
1652
+ declared: number | null;
1653
+ /** Lo que dicen los CFDI del mes, con los mismos cálculos de Impuestos. */
1654
+ invoiced: number;
1655
+ /** declared menos invoiced; null si declared es null. */
1656
+ difference: number | null;
1657
+ /** El número de operación de la declaración de donde salió la cifra. */
1658
+ operation_number: string | null;
1659
+ }[];
1660
+ }[];
1661
+ /** El IVA a favor que muestran las declaraciones del año y lo que meses posteriores acreditaron. Una estimación con las declaraciones leídas, no la cuenta del SAT. */
1662
+ vat_balance_in_favor: {
1663
+ /** Cada mes con IVA a favor. */
1664
+ periods: {
1665
+ /** El mes cuya declaración muestra el IVA a favor. */
1666
+ month: string;
1667
+ /** El IVA a favor de ese mes. */
1668
+ amount: number;
1669
+ /** El número de operación de esa declaración. */
1670
+ operation_number: string;
1671
+ }[];
1672
+ /** La suma del IVA a favor del año. */
1673
+ total: number;
1674
+ /** Lo que las declaraciones del año acreditaron de saldos a favor de periodos anteriores. */
1675
+ credited: number;
1676
+ /** total menos credited, nunca menos de 0: lo que quedaría por acreditar o pedir en devolución. */
1677
+ remaining: number;
1678
+ };
1679
+ /** Los regímenes del emisor (registered, de su constancia) y con cuáles facturó en el año. */
1680
+ tax_regimes: {
1681
+ /** Los regímenes de su constancia (c_RegimenFiscal), capturados en la app. */
1682
+ registered: string[];
1683
+ /** Cada régimen con que facturó en el año (RegimenFiscal del emisor). */
1684
+ invoiced: {
1685
+ /** El régimen (c_RegimenFiscal). */
1686
+ tax_regime: string;
1687
+ /** Cuántos CFDI lo llevan (ingreso, egreso y pago, sin cancelados). */
1688
+ invoices: number;
1689
+ /** La fecha del primero (AAAA-MM-DD). */
1690
+ first_date: string;
1691
+ /** La fecha del último (AAAA-MM-DD). */
1692
+ last_date: string;
1693
+ /** Si el régimen está en su constancia; null si no se capturaron los regímenes de la constancia. */
1694
+ registered: boolean | null;
1695
+ }[];
1696
+ };
1697
+ }
1337
1698
  /** La DIOT de un mes: lo pagado a cada proveedor, por tipo de operación. */
1338
1699
  export interface Diot {
1339
1700
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -1664,6 +2025,8 @@ export interface WebhookEndpoint {
1664
2025
  failing_since?: string | null;
1665
2026
  /** Hasta cuándo el secreto anterior también firma (después de cambiarlo), o null. */
1666
2027
  previous_secret_expires_at: string | null;
2028
+ /** La versión de la API de sus eventos; null: la de la cuenta. */
2029
+ api_version: string | null;
1667
2030
  /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
1668
2031
  created_at: string | null;
1669
2032
  /** Secreto de firma (whsec_…). Solo viene al crearlo o al cambiarlo: guárdelo para verificar las firmas. */
@@ -1735,6 +2098,8 @@ export interface ApiError {
1735
2098
  param?: string;
1736
2099
  /** Código del SAT o del PAC (CFDI40xxx). */
1737
2100
  sat_code?: string;
2101
+ /** Con Accept-Language: en, el mensaje original en español cuando message solo dice en inglés qué significa el código. */
2102
+ message_es?: string;
1738
2103
  /** La explicación de este código en la documentación. */
1739
2104
  doc_url: string;
1740
2105
  /** El id de la solicitud (req_…). Inclúyalo si nos escribe. */
@@ -1901,6 +2266,16 @@ export interface SatInvoiceList {
1901
2266
  /** La ruta de esta lista. */
1902
2267
  url: string;
1903
2268
  }
2269
+ export interface SatDeclarationList {
2270
+ /** Qué tipo de objeto es («invoice», «customer»…). */
2271
+ object: "list";
2272
+ /** Los objetos de esta página. */
2273
+ data: SatDeclaration[];
2274
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
2275
+ has_more: boolean;
2276
+ /** La ruta de esta lista. */
2277
+ url: string;
2278
+ }
1904
2279
  export interface TicketList {
1905
2280
  /** Qué tipo de objeto es («invoice», «customer»…). */
1906
2281
  object: "list";
@@ -2785,6 +3160,10 @@ export interface InvoiceCreate {
2785
3160
  /** Sus propios datos: hasta 50 llaves de 40 caracteres con valores de texto de hasta 500. No van al CFDI; vuelven en el objeto y en los webhooks. */
2786
3161
  metadata?: Record<string, string>;
2787
3162
  }
3163
+ export interface UpdateAccountParams {
3164
+ /** La versión de la API de la cuenta: la que reciben sus solicitudes sin Fiscalisto-Version y sus webhooks sin api_version propio. Pruebe antes la nueva con el encabezado. */
3165
+ api_version: string;
3166
+ }
2788
3167
  export interface ResetTestDataParams {
2789
3168
  /** true (por omisión) para dejarle a cada emisor de pruebas 3 clientes y 3 productos de ejemplo. false para dejarlo vacío. */
2790
3169
  seed?: boolean;
@@ -2878,7 +3257,7 @@ export interface ListInvoicesParams {
2878
3257
  status?: "valid" | "pending" | "canceled" | "rejected" | "processing";
2879
3258
  /** I, E, P, T o N. */
2880
3259
  type?: "I" | "E" | "P" | "T" | "N";
2881
- /** RFC del cliente. */
3260
+ /** RFC del cliente o su id (cus_…). */
2882
3261
  customer?: string;
2883
3262
  /** Facturas de ingreso por lo que deben: unpaid, partial, open (unpaid o partial) o paid. */
2884
3263
  payment_status?: "unpaid" | "partial" | "open" | "paid";
@@ -2924,7 +3303,7 @@ export interface ListReceivablesParams {
2924
3303
  starting_after?: string;
2925
3304
  /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
2926
3305
  issuer?: string;
2927
- /** Solo este RFC. */
3306
+ /** Solo este cliente: su RFC o su id (cus_…). */
2928
3307
  customer?: string;
2929
3308
  }
2930
3309
  export interface CreateBankTransactionsParams {
@@ -3074,7 +3453,7 @@ export interface CreateAdvanceParams {
3074
3453
  export interface ListAdvancesParams {
3075
3454
  /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
3076
3455
  issuer?: string;
3077
- /** RFC del cliente. */
3456
+ /** RFC del cliente o su id (cus_…). */
3078
3457
  customer?: string;
3079
3458
  }
3080
3459
  /** El cuerpo de POST /v1/invoices (la factura de lo vendido) con method y remainder. */
@@ -3501,7 +3880,9 @@ export interface CreateProductParams {
3501
3880
  /** Número de identificación o SKU (NoIdentificacion). */
3502
3881
  sku?: string | null;
3503
3882
  /** Precio unitario antes de impuestos (ValorUnitario). */
3504
- unit_price: number;
3883
+ unit_price?: number;
3884
+ /** Precio abierto: sin precio fijo (una noche de hotel que cambia cada día); cada factura manda su unit_price. */
3885
+ open_price?: boolean;
3505
3886
  /** Objeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa… */
3506
3887
  taxability?: "01" | "02" | "03" | "04" | "05" | "06" | "07" | "08";
3507
3888
  /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
@@ -3514,6 +3895,15 @@ export interface CreateProductParams {
3514
3895
  iva_retention?: number;
3515
3896
  /** Tasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO). */
3516
3897
  isr_retention?: number;
3898
+ /** Impuestos locales que lleva, como el ISH 3% de hospedaje: van en cada factura con él, sobre sus conceptos. */
3899
+ local_taxes?: {
3900
+ /** true si es una retención local; false si es un traslado. */
3901
+ retention: boolean;
3902
+ /** Nombre del impuesto local (ImpLocTrasladado o ImpLocRetenido), como ISH. */
3903
+ name: string;
3904
+ /** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
3905
+ rate: number;
3906
+ }[];
3517
3907
  }
3518
3908
  /** Los parámetros de GET /v1/products. */
3519
3909
  export interface ListProductsParams {
@@ -3543,6 +3933,8 @@ export interface UpdateProductParams {
3543
3933
  sku?: string | null;
3544
3934
  /** Precio unitario antes de impuestos (ValorUnitario). */
3545
3935
  unit_price?: number;
3936
+ /** Precio abierto: sin precio fijo (una noche de hotel que cambia cada día); cada factura manda su unit_price. */
3937
+ open_price?: boolean;
3546
3938
  /** Objeto de impuesto (ObjetoImp), c_ObjetoImp: 01 no objeto, 02 sí objeto (por omisión), 03 sin desglose, 04 no causa… */
3547
3939
  taxability?: "01" | "02" | "03" | "04" | "05" | "06" | "07" | "08";
3548
3940
  /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
@@ -3555,6 +3947,15 @@ export interface UpdateProductParams {
3555
3947
  iva_retention?: number;
3556
3948
  /** Tasa de ISR retenido (por ejemplo 0.10 honorarios, 0.0125 RESICO). */
3557
3949
  isr_retention?: number;
3950
+ /** Impuestos locales que lleva, como el ISH 3% de hospedaje: van en cada factura con él, sobre sus conceptos. */
3951
+ local_taxes?: {
3952
+ /** true si es una retención local; false si es un traslado. */
3953
+ retention: boolean;
3954
+ /** Nombre del impuesto local (ImpLocTrasladado o ImpLocRetenido), como ISH. */
3955
+ name: string;
3956
+ /** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
3957
+ rate: number;
3958
+ }[];
3558
3959
  }
3559
3960
  /** Los parámetros de GET /v1/sat_catalogs/{name}. */
3560
3961
  export interface GetSatCatalogParams {
@@ -3611,6 +4012,23 @@ export interface ListSatInvoicesParams {
3611
4012
  /** Con fecha hasta este día (AAAA-MM-DD), incluido. */
3612
4013
  date_lte?: string;
3613
4014
  }
4015
+ export interface RefreshSatDeclarationsParams {
4016
+ /** El emisor (iss_…). Por omisión, su único emisor. */
4017
+ issuer?: string;
4018
+ }
4019
+ /** Los parámetros de GET /v1/sat_declarations. */
4020
+ export interface ListSatDeclarationsParams {
4021
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
4022
+ limit?: number;
4023
+ /** El id del último de la página anterior, para la siguiente. */
4024
+ starting_after?: string;
4025
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
4026
+ issuer?: string;
4027
+ /** Solo las de un ejercicio, como 2025. */
4028
+ year?: number;
4029
+ /** monthly (provisionales o definitivas), annual (la anual) o dyp (Declaraciones y pagos). */
4030
+ source?: "monthly" | "annual" | "dyp";
4031
+ }
3614
4032
  export interface CreateTicketParams {
3615
4033
  /** El emisor (iss_…) que vendió. Por omisión, su único emisor. */
3616
4034
  issuer?: string;
@@ -3676,6 +4094,20 @@ export interface GetTrialBalanceParams {
3676
4094
  /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
3677
4095
  issuer?: string;
3678
4096
  }
4097
+ /** Los parámetros de GET /v1/accounting/financial_statements. */
4098
+ export interface GetFinancialStatementsParams {
4099
+ /** El mes (AAAA-MM). */
4100
+ month: string;
4101
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
4102
+ issuer?: string;
4103
+ }
4104
+ /** Los parámetros de GET /v1/accounting/cross_checks. */
4105
+ export interface GetCrossChecksParams {
4106
+ /** El ejercicio. Por omisión, el actual. */
4107
+ year?: number;
4108
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
4109
+ issuer?: string;
4110
+ }
3679
4111
  /** Los parámetros de GET /v1/accounting/accounts. */
3680
4112
  export interface ListLedgerAccountsParams {
3681
4113
  /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
@@ -4164,6 +4596,8 @@ export interface CreateWebhookEndpointParams {
4164
4596
  events?: string[] | null;
4165
4597
  /** Para qué es, para usted (no se manda en los eventos). */
4166
4598
  description?: string | null;
4599
+ /** 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. */
4600
+ api_version?: string | null;
4167
4601
  }
4168
4602
  /** Los parámetros de GET /v1/webhook_endpoints. */
4169
4603
  export interface ListWebhookEndpointsParams {
@@ -4181,6 +4615,8 @@ export interface UpdateWebhookEndpointParams {
4181
4615
  description?: string | null;
4182
4616
  /** true para apagarlo sin borrarlo. */
4183
4617
  disabled?: boolean;
4618
+ /** 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. */
4619
+ api_version?: string | null;
4184
4620
  }
4185
4621
  export interface RollWebhookSecretParams {
4186
4622
  /** 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). */
@@ -4214,6 +4650,15 @@ export declare class AccountResource {
4214
4650
  * @see https://fiscalisto.com/docs/api/referencia/cuenta/get-account
4215
4651
  */
4216
4652
  get(options?: RequestOptions): Promise<Account>;
4653
+ /**
4654
+ * Cambiar la versión de la API
4655
+ *
4656
+ * 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.
4657
+ *
4658
+ * POST /v1/account
4659
+ * @see https://fiscalisto.com/docs/api/referencia/cuenta/update-account
4660
+ */
4661
+ update(params: UpdateAccountParams, options?: RequestOptions): Promise<Account>;
4217
4662
  }
4218
4663
  /** Cuenta: fiscalisto.testData. */
4219
4664
  export declare class TestDataResource {
@@ -4476,7 +4921,7 @@ export declare class InvoicesResource {
4476
4921
  /**
4477
4922
  * Cancelar una factura
4478
4923
  *
4479
- * Pide la cancelación al SAT. Si el cliente debe aceptarla queda en pending (escuche invoice.canceled o invoice.cancellation_rejected). Usa un timbre la primera vez que el SAT acepta la solicitud; repetirla, o pedirla otra vez después de un rechazo, no. Nunca se niega por falta de timbres.
4924
+ * Pide la cancelación al SAT. Si el cliente debe aceptarla queda en pending (escuche invoice.canceled o invoice.cancellation_rejected). No usa timbres.
4480
4925
  *
4481
4926
  * POST /v1/invoices/{id}/cancel
4482
4927
  * @see https://fiscalisto.com/docs/api/referencia/facturas/cancel-invoice
@@ -4688,7 +5133,7 @@ export declare class RetentionsResource {
4688
5133
  /**
4689
5134
  * Cancelar una constancia
4690
5135
  *
4691
- * Se cancela en el momento (no espera aceptación). Usa un timbre.
5136
+ * Se cancela en el momento (no espera aceptación). No usa timbres.
4692
5137
  *
4693
5138
  * POST /v1/retentions/{id}/cancel
4694
5139
  * @see https://fiscalisto.com/docs/api/referencia/retenciones/cancel-retention
@@ -4963,7 +5408,7 @@ export declare class SatDownloadsResource {
4963
5408
  /**
4964
5409
  * Pedirle al SAT las facturas de un emisor
4965
5410
  *
4966
- * La descarga masiva del SAT: las facturas que el emisor recibió (o emitió) en un periodo de hasta un año, con su XML. Contesta 202 de inmediato; el SAT tarda de minutos a horas y al terminar llega sat_download.completed (o sat_download.failed) y las facturas quedan en GET /v1/sat_invoices. En producción necesita la e.firma guardada del emisor; en pruebas no se le pregunta al SAT: la descarga trae facturas de ejemplo al instante. No usa timbres.
5411
+ * La descarga masiva del SAT: las facturas que el emisor recibió (o emitió) en un periodo de hasta un año, con su XML. Contesta 202 de inmediato; el SAT tarda de minutos a horas y al terminar llega sat_download.completed (o sat_download.failed) y las facturas quedan en GET /v1/sat_invoices. En producción necesita la e.firma guardada del emisor; en pruebas no se le pregunta al SAT: la descarga trae facturas de ejemplo al instante. En producción usa 1 timbre por cada 100 CFDI que trae (al menos 1).
4967
5412
  *
4968
5413
  * POST /v1/sat_downloads
4969
5414
  * @see https://fiscalisto.com/docs/api/referencia/descargas-del-sat/create-sat-download
@@ -5014,6 +5459,63 @@ export declare class SatInvoicesResource {
5014
5459
  */
5015
5460
  xml(id: string, options?: RequestOptions): Promise<string>;
5016
5461
  }
5462
+ /** Declaraciones del SAT: fiscalisto.satDeclarations. */
5463
+ export declare class SatDeclarationsResource {
5464
+ #private;
5465
+ constructor(client: Client);
5466
+ /**
5467
+ * Consultar las declaraciones de un emisor en el SAT
5468
+ *
5469
+ * Entra al SAT con la e.firma guardada del emisor y trae las declaraciones que presentó: provisionales o definitivas (desde 2022), la anual de persona moral (desde 2019) y las del servicio anterior Declaraciones y pagos, con su PDF, su acuse y sus cifras. La primera consulta trae todos los años que el SAT conserva; las siguientes, este año y el anterior. Solo consulta: nunca presenta ni firma nada. En producción usa 1 timbre por consulta (regresa si el SAT no contesta) y se puede hacer una vez cada 10 minutos por emisor. Contesta en menos de un minuto; si queda algo por bajar (status processing), sigue solo en la siguiente hora sin otro timbre. En pruebas no se le pregunta al SAT: trae declaraciones de ejemplo al instante.
5470
+ *
5471
+ * POST /v1/sat_declarations/refresh
5472
+ * @see https://fiscalisto.com/docs/api/referencia/declaraciones-del-sat/refresh-sat-declarations
5473
+ */
5474
+ refresh(params?: RefreshSatDeclarationsParams, options?: RequestOptions): Promise<SatDeclarationsRefresh>;
5475
+ /**
5476
+ * Listar declaraciones del SAT
5477
+ *
5478
+ * Las declaraciones que trajeron sus consultas, del ejercicio y mes más recientes a los más antiguos (la anual antes de los meses de su año). No usa timbres.
5479
+ *
5480
+ * GET /v1/sat_declarations
5481
+ * @see https://fiscalisto.com/docs/api/referencia/declaraciones-del-sat/list-sat-declarations
5482
+ */
5483
+ list(params?: ListSatDeclarationsParams, options?: RequestOptions): List<SatDeclaration>;
5484
+ /**
5485
+ * Ver una declaración del SAT
5486
+ *
5487
+ * GET /v1/sat_declarations/{id}
5488
+ * @see https://fiscalisto.com/docs/api/referencia/declaraciones-del-sat/get-sat-declaration
5489
+ */
5490
+ get(id: string, options?: RequestOptions): Promise<SatDeclaration>;
5491
+ /**
5492
+ * Descargar el PDF de una declaración
5493
+ *
5494
+ * La declaración como la da el SAT. No usa timbres.
5495
+ *
5496
+ * GET /v1/sat_declarations/{id}/pdf
5497
+ * @see https://fiscalisto.com/docs/api/referencia/declaraciones-del-sat/get-sat-declaration-pdf
5498
+ */
5499
+ pdf(id: string, options?: RequestOptions): Promise<Uint8Array>;
5500
+ /**
5501
+ * Descargar el acuse de una declaración
5502
+ *
5503
+ * El acuse de recibo, con la línea de captura si hay algo a pagar. No usa timbres.
5504
+ *
5505
+ * GET /v1/sat_declarations/{id}/receipt
5506
+ * @see https://fiscalisto.com/docs/api/referencia/declaraciones-del-sat/get-sat-declaration-receipt
5507
+ */
5508
+ receipt(id: string, options?: RequestOptions): Promise<Uint8Array>;
5509
+ /**
5510
+ * Descargar los estados financieros de una anual
5511
+ *
5512
+ * El Excel de estados financieros de la anual de persona moral, como lo da el SAT. No usa timbres.
5513
+ *
5514
+ * GET /v1/sat_declarations/{id}/financial_statements
5515
+ * @see https://fiscalisto.com/docs/api/referencia/declaraciones-del-sat/get-sat-declaration-financial-statements
5516
+ */
5517
+ financialStatements(id: string, options?: RequestOptions): Promise<string>;
5518
+ }
5017
5519
  /** Autofactura: fiscalisto.tickets. */
5018
5520
  export declare class TicketsResource {
5019
5521
  #private;
@@ -5060,7 +5562,7 @@ export declare class AccountingResource {
5060
5562
  /**
5061
5563
  * Listar las pólizas de un mes
5062
5564
  *
5063
- * Una póliza de diario por cada CFDI de ingreso o egreso vigente del mes, emitido o recibido (los recibidos con la categoría de su gasto), con sus cuentas y código agrupador del SAT. En pesos; un CFDI en otra moneda sin tipo de cambio no se registra. Es un punto de partida para su contador: no incluye bancos, nómina ni depreciaciones.
5565
+ * Las pólizas de diario del mes, con sus cuentas y código agrupador del SAT: una por cada CFDI de ingreso o egreso vigente, emitido o recibido (los recibidos con la categoría de su gasto); una por cada pago de un complemento; una por cada recibo de nómina, y una con la depreciación de los activos fijos. Un PUE se registra cobrado o pagado según su forma de pago. En pesos; un CFDI en otra moneda sin tipo de cambio no se registra. No incluye movimientos de banco sin CFDI ni provisiones.
5064
5566
  *
5065
5567
  * GET /v1/accounting/journal_entries
5066
5568
  * @see https://fiscalisto.com/docs/api/referencia/contabilidad/list-journal-entries
@@ -5069,12 +5571,30 @@ export declare class AccountingResource {
5069
5571
  /**
5070
5572
  * Ver la balanza de comprobación
5071
5573
  *
5072
- * Saldo inicial, cargos, abonos y saldo final de cada cuenta en el mes. Los saldos iniciales se acumulan desde el primer CFDI (las de resultados, desde enero), y los resultados de cada año anterior se cierran a capital.
5574
+ * Saldo inicial, cargos, abonos y saldo final de cada cuenta en el mes. Los saldos iniciales se acumulan desde el primer CFDI, o desde los saldos iniciales capturados en la app (las de resultados, desde enero), y los resultados de cada año anterior se cierran a capital.
5073
5575
  *
5074
5576
  * GET /v1/accounting/trial_balance
5075
5577
  * @see https://fiscalisto.com/docs/api/referencia/contabilidad/get-trial-balance
5076
5578
  */
5077
5579
  trialBalance(params: GetTrialBalanceParams, options?: RequestOptions): Promise<TrialBalance>;
5580
+ /**
5581
+ * Ver los estados financieros
5582
+ *
5583
+ * El estado de resultados (del mes y del año hasta ese mes) y el balance general al cierre del mes, leídos de la misma balanza, así que siempre suman las mismas pólizas.
5584
+ *
5585
+ * GET /v1/accounting/financial_statements
5586
+ * @see https://fiscalisto.com/docs/api/referencia/contabilidad/get-financial-statements
5587
+ */
5588
+ financialStatements(params: GetFinancialStatementsParams, options?: RequestOptions): Promise<FinancialStatements>;
5589
+ /**
5590
+ * Cruzar lo declarado con lo facturado
5591
+ *
5592
+ * Cada mes ya vencido del año: el IVA trasladado, acreditable y retenido y los ingresos para ISR que el emisor declaró (de GET /v1/sat_declarations, después de POST /v1/sat_declarations/refresh) contra lo que dicen sus CFDI. Hasta $2 de diferencia es redondeo (las declaraciones van en pesos enteros). Una cifra que la declaración no trae en un renglón reconocible es unreadable con declared null, nunca 0. También el IVA a favor y el régimen con que factura. Gratis: no consulta al SAT.
5593
+ *
5594
+ * GET /v1/accounting/cross_checks
5595
+ * @see https://fiscalisto.com/docs/api/referencia/contabilidad/get-cross-checks
5596
+ */
5597
+ crossChecks(params?: GetCrossChecksParams, options?: RequestOptions): Promise<CrossChecks>;
5078
5598
  /**
5079
5599
  * Ver el catálogo de cuentas
5080
5600
  *
@@ -5428,6 +5948,7 @@ export declare class FiscalistoApi extends Core {
5428
5948
  readonly satLists: SatListsResource;
5429
5949
  readonly satDownloads: SatDownloadsResource;
5430
5950
  readonly satInvoices: SatInvoicesResource;
5951
+ readonly satDeclarations: SatDeclarationsResource;
5431
5952
  readonly tickets: TicketsResource;
5432
5953
  readonly accounting: AccountingResource;
5433
5954
  readonly storeConnections: StoreConnectionsResource;