fiscalisto 0.1.19 → 0.1.21

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
@@ -580,6 +580,123 @@ export class BankTransactionsResource {
580
580
  return this.#client.request({ method: "POST", path: `/v1/bank_transactions/${encodeURIComponent(id)}/reopen`, idempotent: true }, options);
581
581
  }
582
582
  }
583
+ /** Tickets de compra: fiscalisto.purchaseReceipts. */
584
+ export class PurchaseReceiptsResource {
585
+ #client;
586
+ constructor(client) {
587
+ this.#client = client;
588
+ }
589
+ /**
590
+ * Guardar un ticket de compra
591
+ *
592
+ * La foto o el PDF de un ticket que el emisor pagó sin factura, en base64. La IA lee la tienda, su RFC, la fecha, el total, la forma de pago, el folio, los datos que pide su portal y la liga de facturación; lo que usted mande gana a lo que se lea. El mismo archivo dos veces devuelve el ticket que ya estaba, sin leerlo otra vez. Si llega una factura de esa tienda por el mismo total con las descargas del SAT, el ticket queda invoiced solo.
593
+ *
594
+ * POST /v1/purchase_receipts
595
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/create-purchase-receipt
596
+ */
597
+ create(params, options) {
598
+ return this.#client.request({ method: "POST", path: "/v1/purchase_receipts", body: params, idempotent: true }, options);
599
+ }
600
+ /**
601
+ * Listar tickets de compra
602
+ *
603
+ * Los más recientes primero.
604
+ *
605
+ * GET /v1/purchase_receipts
606
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/list-purchase-receipts
607
+ */
608
+ list(params, options) {
609
+ return this.#client.list({ path: "/v1/purchase_receipts", query: params }, options);
610
+ }
611
+ /**
612
+ * Ver un ticket de compra
613
+ *
614
+ * Con la factura recibida que lo cubre, si ya llegó.
615
+ *
616
+ * GET /v1/purchase_receipts/{id}
617
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/get-purchase-receipt
618
+ */
619
+ get(id, options) {
620
+ return this.#client.request({ method: "GET", path: `/v1/purchase_receipts/${encodeURIComponent(id)}` }, options);
621
+ }
622
+ /**
623
+ * Corregir un ticket de compra
624
+ *
625
+ * Corrige o llena sus datos; solo cambia lo que mande (null borra un dato). Con store_tax_id y total corregidos se vuelve a buscar su factura.
626
+ *
627
+ * POST /v1/purchase_receipts/{id}
628
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/update-purchase-receipt
629
+ */
630
+ update(id, params, options) {
631
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
632
+ }
633
+ /**
634
+ * Borrar un ticket de compra
635
+ *
636
+ * El ticket y su archivo, para siempre.
637
+ *
638
+ * DELETE /v1/purchase_receipts/{id}
639
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/delete-purchase-receipt
640
+ */
641
+ delete(id, options) {
642
+ return this.#client.request({ method: "DELETE", path: `/v1/purchase_receipts/${encodeURIComponent(id)}` }, options);
643
+ }
644
+ /**
645
+ * Leer el ticket de nuevo
646
+ *
647
+ * La IA vuelve a leer el archivo y llena solo los datos que siguen vacíos. Cuenta en el límite diario de tickets de compra.
648
+ *
649
+ * POST /v1/purchase_receipts/{id}/read
650
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/read-purchase-receipt
651
+ */
652
+ read(id, options) {
653
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/read`, idempotent: true }, options);
654
+ }
655
+ /**
656
+ * Pedir la factura a la tienda
657
+ *
658
+ * fiscalisto: la tienda factura con Fiscalisto (store.on_fiscalisto), se timbra al momento con los datos fiscales del emisor y el ticket queda invoiced. email: le manda a la tienda los datos fiscales y la foto; las respuestas van a reply_to. portal o manual: usted la pidió, solo queda requested. Pide el uso de use (G03 por omisión).
659
+ *
660
+ * POST /v1/purchase_receipts/{id}/request
661
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/request-purchase-receipt-invoice
662
+ */
663
+ requestInvoice(id, params, options) {
664
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/request`, body: params, idempotent: true }, options);
665
+ }
666
+ /**
667
+ * Ya llegó la factura
668
+ *
669
+ * Para una factura que llegó por otro lado. Con invoice (sat_… o UUID), la factura recibida que lo cubre; una factura cubre un solo ticket.
670
+ *
671
+ * POST /v1/purchase_receipts/{id}/mark_invoiced
672
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-invoiced
673
+ */
674
+ markInvoiced(id, params, options) {
675
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/mark_invoiced`, body: params, idempotent: true }, options);
676
+ }
677
+ /**
678
+ * Marcar como no deducible
679
+ *
680
+ * La tienda no dio factura: el gasto queda como no deducible.
681
+ *
682
+ * POST /v1/purchase_receipts/{id}/mark_non_deductible
683
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-non-deductible
684
+ */
685
+ markNonDeductible(id, options) {
686
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/mark_non_deductible`, idempotent: true }, options);
687
+ }
688
+ /**
689
+ * Volver a pedir la factura
690
+ *
691
+ * Deshace mark_non_deductible o mark_invoiced: vuelve a requested si ya se había pedido, si no a pending.
692
+ *
693
+ * POST /v1/purchase_receipts/{id}/reopen
694
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/reopen-purchase-receipt
695
+ */
696
+ reopen(id, options) {
697
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/reopen`, idempotent: true }, options);
698
+ }
699
+ }
583
700
  /** Pagos y notas de crédito: fiscalisto.payments. */
584
701
  export class PaymentsResource {
585
702
  #client;
@@ -1761,7 +1878,7 @@ export class StoreConnectionsResource {
1761
1878
  /**
1762
1879
  * Conectar una tienda
1763
1880
  *
1764
- * Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. Mercado Libre: queda pending hasta que el vendedor autorice en authorize_url. Desde entonces cada pedido pagado es un ticket (folio SHOP-1001 o ML-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.
1881
+ * Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. WooCommerce: con la dirección de la tienda y una llave de su API REST de Lectura/Escritura, igual. Mercado Libre, Tiendanube y Amazon: queda pending hasta que el vendedor autorice en authorize_url (Amazon no tiene webhooks: sus pedidos se leen cada hora). Desde entonces cada pedido pagado es un ticket (folio SHOP-1001, WEB-1001, TN-1001, ML-… o AMZ-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.
1765
1882
  *
1766
1883
  * POST /v1/store_connections
1767
1884
  * @see https://fiscalisto.com/docs/api/referencia/tiendas-en-linea/create-store-connection
@@ -2161,6 +2278,7 @@ export class FiscalistoApi extends Core {
2161
2278
  invoices = new InvoicesResource(this);
2162
2279
  receivables = new ReceivablesResource(this);
2163
2280
  bankTransactions = new BankTransactionsResource(this);
2281
+ purchaseReceipts = new PurchaseReceiptsResource(this);
2164
2282
  payments = new PaymentsResource(this);
2165
2283
  creditNotes = new CreditNotesResource(this);
2166
2284
  advances = new AdvancesResource(this);