fiscalisto 0.1.3 → 0.1.5

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
@@ -272,6 +272,83 @@ export class IssuersResource {
272
272
  createOnboardingLink(id, params, options) {
273
273
  return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/onboarding_links`, body: params, idempotent: true }, options);
274
274
  }
275
+ /**
276
+ * Ver la opinión de cumplimiento (32-D)
277
+ *
278
+ * La última opinión que trajo del SAT: positiva, negativa (con sus motivos), sin obligaciones o en suspensión. result es null hasta la primera consulta. No usa timbres.
279
+ *
280
+ * GET /v1/issuers/{id}/compliance_opinion
281
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/get-compliance-opinion
282
+ */
283
+ complianceOpinion(id, options) {
284
+ return this.#client.request({ method: "GET", path: `/v1/issuers/${encodeURIComponent(id)}/compliance_opinion` }, options);
285
+ }
286
+ /**
287
+ * Pedir la opinión de cumplimiento al SAT
288
+ *
289
+ * La pide al SAT ahora con la e.firma guardada del emisor (POST /v1/issuers/{id}/efirma con keep_for_downloads: true). 1 timbre en producción, una vez cada 10 minutos; regresa si el SAT no contesta. Si el SAT tarda, contesta status processing y el resultado llega a GET /v1/issuers/{id}/compliance_opinion. En pruebas da una positiva de ejemplo.
290
+ *
291
+ * POST /v1/issuers/{id}/compliance_opinion/refresh
292
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/refresh-compliance-opinion
293
+ */
294
+ refreshComplianceOpinion(id, options) {
295
+ return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/compliance_opinion/refresh`, idempotent: true }, options);
296
+ }
297
+ /**
298
+ * Descargar el PDF de la opinión de cumplimiento
299
+ *
300
+ * El PDF de la última opinión, como lo da el SAT. No usa timbres.
301
+ *
302
+ * GET /v1/issuers/{id}/compliance_opinion/pdf
303
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/get-compliance-opinion-pdf
304
+ */
305
+ complianceOpinionPdf(id, options) {
306
+ return this.#client.request({ method: "GET", path: `/v1/issuers/${encodeURIComponent(id)}/compliance_opinion/pdf`, as: "bytes" }, options);
307
+ }
308
+ /**
309
+ * Ver la constancia de situación fiscal
310
+ *
311
+ * Lo que dice la última constancia generada: razón social, regímenes, código postal, estatus en el padrón e idCIF. No usa timbres.
312
+ *
313
+ * GET /v1/issuers/{id}/tax_status_certificate
314
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/get-tax-status-certificate
315
+ */
316
+ taxStatusCertificate(id, options) {
317
+ return this.#client.request({ method: "GET", path: `/v1/issuers/${encodeURIComponent(id)}/tax_status_certificate` }, options);
318
+ }
319
+ /**
320
+ * Generar la constancia de situación fiscal en el SAT
321
+ *
322
+ * Genera una constancia nueva con la e.firma guardada del emisor. 1 timbre en producción, una vez cada 10 minutos; regresa si el SAT no contesta. En pruebas hace una con los datos del emisor.
323
+ *
324
+ * POST /v1/issuers/{id}/tax_status_certificate/refresh
325
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/refresh-tax-status-certificate
326
+ */
327
+ refreshTaxStatusCertificate(id, options) {
328
+ return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/tax_status_certificate/refresh`, idempotent: true }, options);
329
+ }
330
+ /**
331
+ * Descargar el PDF de la constancia
332
+ *
333
+ * El PDF de la última constancia, como lo da el SAT. No usa timbres.
334
+ *
335
+ * GET /v1/issuers/{id}/tax_status_certificate/pdf
336
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/get-tax-status-certificate-pdf
337
+ */
338
+ taxStatusCertificatePdf(id, options) {
339
+ return this.#client.request({ method: "GET", path: `/v1/issuers/${encodeURIComponent(id)}/tax_status_certificate/pdf`, as: "bytes" }, options);
340
+ }
341
+ /**
342
+ * Revisar el buzón tributario en el SAT
343
+ *
344
+ * Lee los avisos del buzón tributario del emisor ahora, con su e.firma guardada; nunca abre notificaciones (abrirlas firma el acuse y corren los plazos). 1 timbre en producción, una vez cada 10 minutos. En pruebas deja dos avisos de ejemplo.
345
+ *
346
+ * POST /v1/issuers/{id}/sat_mailbox/refresh
347
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/refresh-sat-mailbox
348
+ */
349
+ refreshSatMailbox(id, options) {
350
+ return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/sat_mailbox/refresh`, idempotent: true }, options);
351
+ }
275
352
  /**
276
353
  * Ver el portal de autofactura de un emisor
277
354
  *
@@ -812,6 +889,68 @@ export class TaxIdsResource {
812
889
  return this.#client.request({ method: "POST", path: "/v1/tax_ids/validate", body: params, idempotent: true }, options);
813
890
  }
814
891
  }
892
+ /** Sucursales: fiscalisto.branches. */
893
+ export class BranchesResource {
894
+ #client;
895
+ constructor(client) {
896
+ this.#client = client;
897
+ }
898
+ /**
899
+ * Crear una sucursal
900
+ *
901
+ * Otro lugar desde donde factura el emisor, con su propio código postal: sus facturas llevan ese CP en LugarExpedicion (y su zona horaria en la Fecha, y el IVA 8 % si es de la franja fronteriza), su dirección en el PDF y, si las da, sus propias series. Un CP que ya tiene otra sucursal contesta branch_exists; el del domicilio fiscal del emisor no es sucursal (es la Matriz). Hasta 200 por emisor.
902
+ *
903
+ * POST /v1/branches
904
+ * @see https://fiscalisto.com/docs/api/referencia/sucursales/create-branch
905
+ */
906
+ create(params, options) {
907
+ return this.#client.request({ method: "POST", path: "/v1/branches", body: params, idempotent: true }, options);
908
+ }
909
+ /**
910
+ * Listar sucursales
911
+ *
912
+ * Las sucursales del emisor, las más recientes primero. Las archivadas solo con include_archived=true.
913
+ *
914
+ * GET /v1/branches
915
+ * @see https://fiscalisto.com/docs/api/referencia/sucursales/list-branches
916
+ */
917
+ list(params, options) {
918
+ return this.#client.list({ path: "/v1/branches", query: params }, options);
919
+ }
920
+ /**
921
+ * Ver una sucursal
922
+ *
923
+ * Una sucursal del emisor.
924
+ *
925
+ * GET /v1/branches/{id}
926
+ * @see https://fiscalisto.com/docs/api/referencia/sucursales/get-branch
927
+ */
928
+ get(id, options) {
929
+ return this.#client.request({ method: "GET", path: `/v1/branches/${encodeURIComponent(id)}` }, options);
930
+ }
931
+ /**
932
+ * Actualizar una sucursal
933
+ *
934
+ * Cambia solo los campos que manda; una serie en null vuelve a la del emisor. archived: true la archiva (ya no se factura desde ella y sus facturas la siguen nombrando), false la restaura. El código postal de una sucursal que ya facturó no cambia: si se mudó, archívela y cree otra.
935
+ *
936
+ * POST /v1/branches/{id}
937
+ * @see https://fiscalisto.com/docs/api/referencia/sucursales/update-branch
938
+ */
939
+ update(id, params, options) {
940
+ return this.#client.request({ method: "POST", path: `/v1/branches/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
941
+ }
942
+ /**
943
+ * Borrar una sucursal
944
+ *
945
+ * Solo una que nunca facturó; con facturas contesta branch_has_invoices: archívela con archived: true.
946
+ *
947
+ * DELETE /v1/branches/{id}
948
+ * @see https://fiscalisto.com/docs/api/referencia/sucursales/delete-branch
949
+ */
950
+ delete(id, options) {
951
+ return this.#client.request({ method: "DELETE", path: `/v1/branches/${encodeURIComponent(id)}` }, options);
952
+ }
953
+ }
815
954
  /** Clientes: fiscalisto.customers. */
816
955
  export class CustomersResource {
817
956
  #client;
@@ -986,6 +1125,173 @@ export class ProductsResource {
986
1125
  delete(id, options) {
987
1126
  return this.#client.request({ method: "DELETE", path: `/v1/products/${encodeURIComponent(id)}` }, options);
988
1127
  }
1128
+ /**
1129
+ * Ver las existencias de un producto
1130
+ *
1131
+ * Lo que hay del producto en cada almacén del emisor (también en 0), apartado por cotizaciones y disponible.
1132
+ *
1133
+ * GET /v1/products/{id}/stock
1134
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/get-product-stock
1135
+ */
1136
+ stock(id, options) {
1137
+ return this.#client.request({ method: "GET", path: `/v1/products/${encodeURIComponent(id)}/stock` }, options);
1138
+ }
1139
+ }
1140
+ /** Cumplimiento SAT: fiscalisto.satMailboxMessages. */
1141
+ export class SatMailboxMessagesResource {
1142
+ #client;
1143
+ constructor(client) {
1144
+ this.#client = client;
1145
+ }
1146
+ /**
1147
+ * Listar avisos del buzón tributario
1148
+ *
1149
+ * Los avisos que trajo del buzón del emisor, los más recientes primero. No usa timbres.
1150
+ *
1151
+ * GET /v1/sat_mailbox_messages
1152
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/list-sat-mailbox-messages
1153
+ */
1154
+ list(params, options) {
1155
+ return this.#client.list({ path: "/v1/sat_mailbox_messages", query: params }, options);
1156
+ }
1157
+ /**
1158
+ * Ver un aviso del buzón tributario
1159
+ *
1160
+ * Un aviso del buzón, con su urgencia y si pide hacer algo.
1161
+ *
1162
+ * GET /v1/sat_mailbox_messages/{id}
1163
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/get-sat-mailbox-message
1164
+ */
1165
+ get(id, options) {
1166
+ return this.#client.request({ method: "GET", path: `/v1/sat_mailbox_messages/${encodeURIComponent(id)}` }, options);
1167
+ }
1168
+ }
1169
+ /** Cumplimiento SAT: fiscalisto.satFindings. */
1170
+ export class SatFindingsResource {
1171
+ #client;
1172
+ constructor(client) {
1173
+ this.#client = client;
1174
+ }
1175
+ /**
1176
+ * Listar hallazgos en los CFDI
1177
+ *
1178
+ * Lo que Fiscalisto encontró en los CFDI del emisor (los suyos y los descargados del SAT) y nadie ha revisado, por tipo y del más grave al más leve: proveedores en la lista 69-B, CFDI cancelados, pagos en efectivo de más de $2,000, errores de CFDI 4.0. Todos en una página. No usa timbres.
1179
+ *
1180
+ * GET /v1/sat_findings
1181
+ * @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/list-sat-findings
1182
+ */
1183
+ list(params, options) {
1184
+ return this.#client.request({ method: "GET", path: "/v1/sat_findings", query: params }, options);
1185
+ }
1186
+ }
1187
+ /** Inventario: fiscalisto.warehouses. */
1188
+ export class WarehousesResource {
1189
+ #client;
1190
+ constructor(client) {
1191
+ this.#client = client;
1192
+ }
1193
+ /**
1194
+ * Listar almacenes
1195
+ *
1196
+ * Los almacenes del emisor, los más recientes primero: el de la Matriz y uno por sucursal se crean solos. Todos en una página.
1197
+ *
1198
+ * GET /v1/warehouses
1199
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/list-warehouses
1200
+ */
1201
+ list(params, options) {
1202
+ return this.#client.request({ method: "GET", path: "/v1/warehouses", query: params }, options);
1203
+ }
1204
+ /**
1205
+ * Ver un almacén
1206
+ *
1207
+ * Un almacén del emisor.
1208
+ *
1209
+ * GET /v1/warehouses/{id}
1210
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/get-warehouse
1211
+ */
1212
+ get(id, options) {
1213
+ return this.#client.request({ method: "GET", path: `/v1/warehouses/${encodeURIComponent(id)}` }, options);
1214
+ }
1215
+ /**
1216
+ * Ver las existencias de un almacén
1217
+ *
1218
+ * Lo que hay de cada producto en el almacén, el producto más reciente primero. Solo los que tienen existencias, salvo con include_empty=true (todos los que llevan track_stock).
1219
+ *
1220
+ * GET /v1/warehouses/{id}/stock
1221
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/list-warehouse-stock
1222
+ */
1223
+ stock(id, params, options) {
1224
+ return this.#client.list({ path: `/v1/warehouses/${encodeURIComponent(id)}/stock`, query: params }, options);
1225
+ }
1226
+ }
1227
+ /** Inventario: fiscalisto.stockMovements. */
1228
+ export class StockMovementsResource {
1229
+ #client;
1230
+ constructor(client) {
1231
+ this.#client = client;
1232
+ }
1233
+ /**
1234
+ * Listar movimientos (kárdex)
1235
+ *
1236
+ * Cada entrada y salida de existencias, la más reciente primero: ventas (de sus facturas), compras, ajustes, traspasos y lo que deshizo una cancelación.
1237
+ *
1238
+ * GET /v1/stock_movements
1239
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/list-stock-movements
1240
+ */
1241
+ list(params, options) {
1242
+ return this.#client.list({ path: "/v1/stock_movements", query: params }, options);
1243
+ }
1244
+ /**
1245
+ * Ver un movimiento
1246
+ *
1247
+ * Una entrada o salida de existencias, con lo que la causó (source).
1248
+ *
1249
+ * GET /v1/stock_movements/{id}
1250
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/get-stock-movement
1251
+ */
1252
+ get(id, options) {
1253
+ return this.#client.request({ method: "GET", path: `/v1/stock_movements/${encodeURIComponent(id)}` }, options);
1254
+ }
1255
+ }
1256
+ /** Inventario: fiscalisto.stockAdjustments. */
1257
+ export class StockAdjustmentsResource {
1258
+ #client;
1259
+ constructor(client) {
1260
+ this.#client = client;
1261
+ }
1262
+ /**
1263
+ * Ajustar existencias
1264
+ *
1265
+ * Mete o saca existencias de un almacén con su motivo: el inventario inicial, una merma, un robo, un sobrante. Las entradas valen su unit_cost (o el costo promedio), las salidas el costo del emisor (promedio o PEPS). Los productos deben llevar track_stock: true. Se aplica al momento (status applied).
1266
+ *
1267
+ * POST /v1/stock_adjustments
1268
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/create-stock-adjustment
1269
+ */
1270
+ create(params, options) {
1271
+ return this.#client.request({ method: "POST", path: "/v1/stock_adjustments", body: params, idempotent: true }, options);
1272
+ }
1273
+ /**
1274
+ * Listar ajustes
1275
+ *
1276
+ * Los ajustes del emisor, los más recientes primero.
1277
+ *
1278
+ * GET /v1/stock_adjustments
1279
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/list-stock-adjustments
1280
+ */
1281
+ list(params, options) {
1282
+ return this.#client.list({ path: "/v1/stock_adjustments", query: params }, options);
1283
+ }
1284
+ /**
1285
+ * Ver un ajuste
1286
+ *
1287
+ * Un ajuste de existencias, con sus líneas.
1288
+ *
1289
+ * GET /v1/stock_adjustments/{id}
1290
+ * @see https://fiscalisto.com/docs/api/referencia/inventario/get-stock-adjustment
1291
+ */
1292
+ get(id, options) {
1293
+ return this.#client.request({ method: "GET", path: `/v1/stock_adjustments/${encodeURIComponent(id)}` }, options);
1294
+ }
989
1295
  }
990
1296
  /** Catálogos del SAT: fiscalisto.satCatalogs. */
991
1297
  export class SatCatalogsResource {
@@ -1299,6 +1605,17 @@ export class AccountingResource {
1299
1605
  crossChecks(params, options) {
1300
1606
  return this.#client.request({ method: "GET", path: "/v1/accounting/cross_checks", query: params }, options);
1301
1607
  }
1608
+ /**
1609
+ * Ver los CFDI de una cifra del cruce
1610
+ *
1611
+ * Los CFDI que forman lo facturado (invoiced) de una cifra del cruce de un mes, con los mismos cálculos de Impuestos: cada factura PUE o nota de crédito en su mes y cada factura PPD por lo que se pagó en el mes, con lo que aporta. La suma de cfdi más adjustment es invoiced. Sirve para ver por qué una cifra differs. Gratis: no consulta al SAT.
1612
+ *
1613
+ * GET /v1/accounting/cross_checks/cfdi
1614
+ * @see https://fiscalisto.com/docs/api/referencia/contabilidad/get-cross-check-cfdi
1615
+ */
1616
+ crossCheckCfdi(params, options) {
1617
+ return this.#client.request({ method: "GET", path: "/v1/accounting/cross_checks/cfdi", query: params }, options);
1618
+ }
1302
1619
  /**
1303
1620
  * Ver el catálogo de cuentas
1304
1621
  *
@@ -1739,9 +2056,15 @@ export class FiscalistoApi extends Core {
1739
2056
  payrollReceipts = new PayrollReceiptsResource(this);
1740
2057
  invoiceBatches = new InvoiceBatchesResource(this);
1741
2058
  taxIds = new TaxIdsResource(this);
2059
+ branches = new BranchesResource(this);
1742
2060
  customers = new CustomersResource(this);
1743
2061
  customerDataRequests = new CustomerDataRequestsResource(this);
1744
2062
  products = new ProductsResource(this);
2063
+ satMailboxMessages = new SatMailboxMessagesResource(this);
2064
+ satFindings = new SatFindingsResource(this);
2065
+ warehouses = new WarehousesResource(this);
2066
+ stockMovements = new StockMovementsResource(this);
2067
+ stockAdjustments = new StockAdjustmentsResource(this);
1745
2068
  satCatalogs = new SatCatalogsResource(this);
1746
2069
  satLists = new SatListsResource(this);
1747
2070
  satDownloads = new SatDownloadsResource(this);