@timbrix/sdk 1.1.0 → 1.3.0

package/dist/index.d.mts

@@ -455,6 +455,8 @@ interface InvoiceTaxInput {
     rate?: string;
     base?: number;
     amount?: number;
+    /** true = retención, false/omitted = traslado */
+    withholding?: boolean;
 }
 interface InvoiceItemInput {
     quantity: number;
@@ -476,6 +478,8 @@ interface InvoiceItemInput {
 interface CreateInvoiceInput {
     /** Ingreso, Egreso, or Traslado — default: I */
     type?: "I" | "E" | "T";
+    /** Required when type is "E" — UUID fiscal of the original Ingreso CFDI */
+    relatedInvoiceUuid?: string;
     series: string;
     folioNumber: string;
     date: string;
@@ -507,6 +511,8 @@ interface Invoice {
     id: string;
     uuid: string;
     status: "valid";
+    /** I = Ingreso, E = Egreso, T = Traslado */
+    type: "I" | "E" | "T";
     series: string;
     folioNumber: string;
     total: number;
@@ -519,6 +525,10 @@ interface ListInvoicesParams {
     page?: number;
     /** Results per page (1-100). Default: 20 */
     limit?: number;
+    /** Filter by tipo de comprobante */
+    type?: "I" | "E" | "T";
+    /** Filter by status */
+    status?: "vigente" | "cancelado";
 }
 interface InvoiceListItem {
     id: string;
@@ -634,6 +644,24 @@ declare class InvoicesResource {
      * scope), same rules as `create`.
      */
     list(organizationId: string, params?: ListInvoicesParams): Promise<ListInvoicesResponse>;
+    /**
+     * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+     * either a Supabase bearer session or an API key (requires the
+     * `read:invoices` scope).
+     */
+    get(uuid: string): Promise<Invoice>;
+    /**
+     * Download the timbrado XML for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getXml(uuid: string): Promise<Blob>;
+    /**
+     * Download the PDF representation for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getPdf(uuid: string): Promise<Blob>;
 }
 
 declare class OAuthResource {

package/dist/index.d.ts

@@ -455,6 +455,8 @@ interface InvoiceTaxInput {
     rate?: string;
     base?: number;
     amount?: number;
+    /** true = retención, false/omitted = traslado */
+    withholding?: boolean;
 }
 interface InvoiceItemInput {
     quantity: number;
@@ -476,6 +478,8 @@ interface InvoiceItemInput {
 interface CreateInvoiceInput {
     /** Ingreso, Egreso, or Traslado — default: I */
     type?: "I" | "E" | "T";
+    /** Required when type is "E" — UUID fiscal of the original Ingreso CFDI */
+    relatedInvoiceUuid?: string;
     series: string;
     folioNumber: string;
     date: string;
@@ -507,6 +511,8 @@ interface Invoice {
     id: string;
     uuid: string;
     status: "valid";
+    /** I = Ingreso, E = Egreso, T = Traslado */
+    type: "I" | "E" | "T";
     series: string;
     folioNumber: string;
     total: number;
@@ -519,6 +525,10 @@ interface ListInvoicesParams {
     page?: number;
     /** Results per page (1-100). Default: 20 */
     limit?: number;
+    /** Filter by tipo de comprobante */
+    type?: "I" | "E" | "T";
+    /** Filter by status */
+    status?: "vigente" | "cancelado";
 }
 interface InvoiceListItem {
     id: string;
@@ -634,6 +644,24 @@ declare class InvoicesResource {
      * scope), same rules as `create`.
      */
     list(organizationId: string, params?: ListInvoicesParams): Promise<ListInvoicesResponse>;
+    /**
+     * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+     * either a Supabase bearer session or an API key (requires the
+     * `read:invoices` scope).
+     */
+    get(uuid: string): Promise<Invoice>;
+    /**
+     * Download the timbrado XML for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getXml(uuid: string): Promise<Blob>;
+    /**
+     * Download the PDF representation for an invoice. Works with either a
+     * Supabase bearer session or an API key (requires the `read:invoices`
+     * scope).
+     */
+    getPdf(uuid: string): Promise<Blob>;
 }
 
 declare class OAuthResource {

package/dist/index.js

@@ -232,10 +232,36 @@ var InvoicesResource = class {
     const searchParams = {};
     if (params?.page !== void 0) searchParams.page = String(params.page);
     if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    if (params?.type !== void 0) searchParams.type = params.type;
+    if (params?.status !== void 0) searchParams.status = params.status;
     return this.http.get(`organizations/${organizationId}/invoices`, {
       searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
     }).json();
   }
+  /**
+   * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+   * either a Supabase bearer session or an API key (requires the
+   * `read:invoices` scope).
+   */
+  async get(uuid) {
+    return this.http.get(`invoices/${uuid}`).json();
+  }
+  /**
+   * Download the timbrado XML for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getXml(uuid) {
+    return this.http.get(`invoices/${uuid}/xml`).blob();
+  }
+  /**
+   * Download the PDF representation for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getPdf(uuid) {
+    return this.http.get(`invoices/${uuid}/pdf`).blob();
+  }
 };
 
 // src/resources/oauth.ts

package/dist/index.mjs

@@ -184,10 +184,36 @@ var InvoicesResource = class {
     const searchParams = {};
     if (params?.page !== void 0) searchParams.page = String(params.page);
     if (params?.limit !== void 0) searchParams.limit = String(params.limit);
+    if (params?.type !== void 0) searchParams.type = params.type;
+    if (params?.status !== void 0) searchParams.status = params.status;
     return this.http.get(`organizations/${organizationId}/invoices`, {
       searchParams: Object.keys(searchParams).length > 0 ? searchParams : void 0
     }).json();
   }
+  /**
+   * Get a single CFDI 4.0 invoice by its folio fiscal (UUID). Works with
+   * either a Supabase bearer session or an API key (requires the
+   * `read:invoices` scope).
+   */
+  async get(uuid) {
+    return this.http.get(`invoices/${uuid}`).json();
+  }
+  /**
+   * Download the timbrado XML for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getXml(uuid) {
+    return this.http.get(`invoices/${uuid}/xml`).blob();
+  }
+  /**
+   * Download the PDF representation for an invoice. Works with either a
+   * Supabase bearer session or an API key (requires the `read:invoices`
+   * scope).
+   */
+  async getPdf(uuid) {
+    return this.http.get(`invoices/${uuid}/pdf`).blob();
+  }
 };
 
 // src/resources/oauth.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timbrix/sdk",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "TypeScript SDK for Timbrix API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",