fiscalisto 0.1.50 → 0.1.53

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
@@ -239,6 +239,50 @@ export class IssuersResource {
239
239
  uploadCertificate(id, params, options) {
240
240
  return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/certificates`, body: params, idempotent: true }, options);
241
241
  }
242
+ /**
243
+ * Ver el diseño del PDF
244
+ *
245
+ * Cómo se ven los documentos del emisor: su nombre comercial, el estilo y el color del PDF y su logo. Es lo mismo que Ajustes › Marca y documentos en la app.
246
+ *
247
+ * GET /v1/issuers/{id}/branding
248
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/get-issuer-branding
249
+ */
250
+ getBranding(id, options) {
251
+ return this.#client.request({ method: "GET", path: `/v1/issuers/${encodeURIComponent(id)}/branding` }, options);
252
+ }
253
+ /**
254
+ * Cambiar el diseño del PDF
255
+ *
256
+ * Cambia el nombre comercial, el estilo (clasico, moderno, compacto o minimalista) y el color del PDF de las facturas, notas, pagos, recibos y cotizaciones del emisor, y de sus correos. Lo que no mande se queda como está; null vuelve al de omisión. Se ve en el siguiente PDF que pida, también de lo ya timbrado. Una sucursal puede tener el suyo (POST /v1/branches/{id}).
257
+ *
258
+ * POST /v1/issuers/{id}/branding
259
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/update-issuer-branding
260
+ */
261
+ updateBranding(id, params, options) {
262
+ return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/branding`, body: params, idempotent: true }, options);
263
+ }
264
+ /**
265
+ * Subir el logo
266
+ *
267
+ * El logo del emisor (PNG o JPG de hasta 1 MB, en base64): va en sus PDF, sus correos y la página de la factura que ve su cliente. Reemplaza el anterior.
268
+ *
269
+ * POST /v1/issuers/{id}/logo
270
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/upload-issuer-logo
271
+ */
272
+ uploadLogo(id, params, options) {
273
+ return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/logo`, body: params, idempotent: true }, options);
274
+ }
275
+ /**
276
+ * Quitar el logo
277
+ *
278
+ * Sus PDF y correos van sin logo, con su nombre.
279
+ *
280
+ * DELETE /v1/issuers/{id}/logo
281
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/delete-issuer-logo
282
+ */
283
+ deleteLogo(id, options) {
284
+ return this.#client.request({ method: "DELETE", path: `/v1/issuers/${encodeURIComponent(id)}/logo` }, options);
285
+ }
242
286
  /**
243
287
  * Firmar el contrato con el PAC
244
288
  *
@@ -400,6 +444,17 @@ export class InvoicesResource {
400
444
  list(params, options) {
401
445
  return this.#client.list({ path: "/v1/invoices", query: params }, options);
402
446
  }
447
+ /**
448
+ * Revisar una factura sin timbrar
449
+ *
450
+ * El mismo cuerpo y las mismas revisiones que POST /v1/invoices, sin timbrar ni usar timbres: devuelve la factura como se timbraría ahora (con los datos fiscales del emisor, el siguiente folio, el subtotal, los impuestos y el total que calcula Fiscalisto), los avisos (un cliente en las listas del SAT, un duplicado) y el XML sin sellar (unsigned_xml). Úsela para mostrar el total antes de cobrar o para validar en su sistema; si algo falla, invoice_invalid como al timbrar. No pide Idempotency-Key y sirve con una llave de solo lectura.
451
+ *
452
+ * POST /v1/invoices/preview
453
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/preview-invoice
454
+ */
455
+ preview(params, options) {
456
+ return this.#client.request({ method: "POST", path: "/v1/invoices/preview", body: params, idempotent: true }, options);
457
+ }
403
458
  /**
404
459
  * Ver una factura
405
460
  *
@@ -444,6 +499,17 @@ export class InvoicesResource {
444
499
  xml(id, params, options) {
445
500
  return this.#client.request({ method: "GET", path: `/v1/invoices/${encodeURIComponent(id)}/xml`, query: params, as: "text" }, options);
446
501
  }
502
+ /**
503
+ * Descargar el acuse de cancelación
504
+ *
505
+ * El acuse de cancelación del SAT (XML firmado por el SAT) de una factura cancelada: la prueba de que el SAT la canceló y cuándo. Antes de que el SAT la cancele (status valid o pending), 409 invoice_not_canceled.
506
+ *
507
+ * GET /v1/invoices/{id}/cancellation_receipt
508
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice-cancellation-receipt
509
+ */
510
+ cancellationReceipt(id, params, options) {
511
+ return this.#client.request({ method: "GET", path: `/v1/invoices/${encodeURIComponent(id)}/cancellation_receipt`, query: params, as: "text" }, options);
512
+ }
447
513
  /**
448
514
  * Enviar por correo
449
515
  *
@@ -2124,6 +2190,24 @@ export class SatListsResource {
2124
2190
  return this.#client.request({ method: "POST", path: "/v1/sat_lists/check", body: params, idempotent: true }, options);
2125
2191
  }
2126
2192
  }
2193
+ /** Verificar comprobantes: fiscalisto.cfdiVerifications. */
2194
+ export class CfdiVerificationsResource {
2195
+ #client;
2196
+ constructor(client) {
2197
+ this.#client = client;
2198
+ }
2199
+ /**
2200
+ * Verificar un CFDI en el SAT
2201
+ *
2202
+ * Si cualquier CFDI (suyo, de un proveedor o de un cliente) existe en el SAT y está vigente o cancelado, si se puede cancelar, y si su emisor y su receptor están en las listas del SAT. Mande su XML, el texto de su QR, o el UUID con los dos RFC y el total. Consulta el servicio público del SAT, sin e.firma. No usa timbres. En pruebas también consulta el SAT real: los comprobantes de prueba no están ahí y responden not_found.
2203
+ *
2204
+ * POST /v1/cfdi_verifications
2205
+ * @see https://fiscalisto.com/docs/api/referencia/verificar-comprobantes/verify-cfdi
2206
+ */
2207
+ create(params, options) {
2208
+ return this.#client.request({ method: "POST", path: "/v1/cfdi_verifications", body: params, idempotent: true }, options);
2209
+ }
2210
+ }
2127
2211
  /** Descargas del SAT: fiscalisto.satDownloads. */
2128
2212
  export class SatDownloadsResource {
2129
2213
  #client;
@@ -3149,6 +3233,17 @@ export class WebhookEndpointsResource {
3149
3233
  test(id, params, options) {
3150
3234
  return this.#client.request({ method: "POST", path: `/v1/webhook_endpoints/${encodeURIComponent(id)}/test`, body: params, idempotent: true }, options);
3151
3235
  }
3236
+ /**
3237
+ * Listar entregas
3238
+ *
3239
+ * Qué pasó con cada evento en este webhook, el más reciente primero: una fila por evento con su último intento, cuántos lleva y cuándo va el siguiente reintento. Con succeeded=false ve los que su servidor no recibió, para reenviarlos con POST /v1/events/{id}/resend.
3240
+ *
3241
+ * GET /v1/webhook_endpoints/{id}/deliveries
3242
+ * @see https://fiscalisto.com/docs/api/referencia/webhooks/list-webhook-deliveries
3243
+ */
3244
+ listDeliveries(id, params, options) {
3245
+ return this.#client.list({ path: `/v1/webhook_endpoints/${encodeURIComponent(id)}/deliveries`, query: params }, options);
3246
+ }
3152
3247
  }
3153
3248
  /** Eventos: fiscalisto.events. */
3154
3249
  export class EventsResource {
@@ -3178,6 +3273,17 @@ export class EventsResource {
3178
3273
  get(id, options) {
3179
3274
  return this.#client.request({ method: "GET", path: `/v1/events/${encodeURIComponent(id)}` }, options);
3180
3275
  }
3276
+ /**
3277
+ * Reenviar un evento
3278
+ *
3279
+ * Manda otra vez, ahora, un evento de los últimos 30 días: a un webhook (endpoint) o a todos los encendidos que escuchan ese tipo. Es un intento aparte, firmado con el mismo webhook-id: no cambia los reintentos automáticos, y si llega, ya no se reintenta. Úselo después de arreglar su servidor, con GET /v1/events?delivery_success=false.
3280
+ *
3281
+ * POST /v1/events/{id}/resend
3282
+ * @see https://fiscalisto.com/docs/api/referencia/eventos/resend-event
3283
+ */
3284
+ resend(id, params, options) {
3285
+ return this.#client.request({ method: "POST", path: `/v1/events/${encodeURIComponent(id)}/resend`, body: params, idempotent: true }, options);
3286
+ }
3181
3287
  }
3182
3288
  /** Cada recurso de la API. Úselo por medio de Fiscalisto (index.ts). */
3183
3289
  export class FiscalistoApi extends Core {
@@ -3222,6 +3328,7 @@ export class FiscalistoApi extends Core {
3222
3328
  stockAdjustments = new StockAdjustmentsResource(this);
3223
3329
  satCatalogs = new SatCatalogsResource(this);
3224
3330
  satLists = new SatListsResource(this);
3331
+ cfdiVerifications = new CfdiVerificationsResource(this);
3225
3332
  satDownloads = new SatDownloadsResource(this);
3226
3333
  satInvoices = new SatInvoicesResource(this);
3227
3334
  satRetentions = new SatRetentionsResource(this);