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.
- package/dist/cli.js +100 -11
- package/dist/core.d.ts +18 -1
- package/dist/core.js +32 -4
- package/dist/error-codes.d.ts +15 -3
- package/dist/error-codes.js +15 -3
- package/dist/generated.d.ts +540 -19
- package/dist/generated.js +110 -5
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/mock-routes.gen.d.ts +2 -0
- package/dist/mock-routes.gen.js +3 -0
- package/dist/mock.d.ts +7 -0
- package/dist/mock.js +237 -0
- package/dist/webhooks.d.ts +1 -1
- package/dist/webhooks.js +4 -1
- package/package.json +7 -2
package/dist/generated.d.ts
CHANGED
|
@@ -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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
1385
|
+
/** El documento, su folio y la contraparte. */
|
|
1256
1386
|
description: string;
|
|
1257
|
-
/** La factura (inv_…) si la timbró este emisor; null
|
|
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
|
|
1262
|
-
tax_id: string;
|
|
1263
|
-
/** El total del
|
|
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
|
|
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
|
|
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).
|
|
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).
|
|
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.
|
|
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
|
-
*
|
|
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;
|