fiscalisto 0.1.4 → 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/core.d.ts +1 -1
- package/dist/core.js +1 -1
- package/dist/error-codes.d.ts +6 -0
- package/dist/error-codes.js +6 -0
- package/dist/generated.d.ts +855 -22
- package/dist/generated.js +312 -0
- package/dist/mock-routes.gen.js +1 -1
- package/package.json +1 -1
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 {
|
|
@@ -1750,9 +2056,15 @@ export class FiscalistoApi extends Core {
|
|
|
1750
2056
|
payrollReceipts = new PayrollReceiptsResource(this);
|
|
1751
2057
|
invoiceBatches = new InvoiceBatchesResource(this);
|
|
1752
2058
|
taxIds = new TaxIdsResource(this);
|
|
2059
|
+
branches = new BranchesResource(this);
|
|
1753
2060
|
customers = new CustomersResource(this);
|
|
1754
2061
|
customerDataRequests = new CustomerDataRequestsResource(this);
|
|
1755
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);
|
|
1756
2068
|
satCatalogs = new SatCatalogsResource(this);
|
|
1757
2069
|
satLists = new SatListsResource(this);
|
|
1758
2070
|
satDownloads = new SatDownloadsResource(this);
|