factuplan 0.10.0 → 0.15.0

package/dist/index.d.mts

@@ -9,7 +9,7 @@ interface PaginatedResponse<T> {
 }
 interface Customer {
     id: string;
-    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER' | 'EXTERIOR';
     identification: string;
     legalName: string;
     email?: string;
@@ -20,7 +20,7 @@ interface Customer {
     updatedAt: string;
 }
 interface CreateCustomerInput {
-    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER' | 'EXTERIOR';
     identification: string;
     legalName: string;
     email?: string;
@@ -85,7 +85,7 @@ interface ProductListParams {
     search?: string;
 }
 interface InvoiceCustomer {
-    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER' | 'EXTERIOR';
     identification: string;
     legalName: string;
     email?: string;
@@ -95,6 +95,8 @@ interface InvoiceCustomer {
 }
 interface InvoiceItem {
     code: string;
+    /** Auxiliary code (SRI codigoAuxiliar). Optional — defaults to `code`. */
+    auxiliaryCode?: string;
     description: string;
     quantity: number;
     unitPrice: number;
@@ -110,6 +112,16 @@ interface InvoicePayment {
     term?: number;
     timeUnit?: PaymentTimeUnit;
 }
+interface InvoiceRetencion {
+    /** SRI Tabla 22 code (1 digit). '2' = IVA presuntivo, '4' = combustibles/renta */
+    codigo: string;
+    /** SRI Tabla 23 percentage code (1–3 digits) */
+    codigoPorcentaje: string;
+    /** Retention rate (e.g. 0.20) */
+    tarifa: number;
+    /** Retained amount (e.g. 0.13) */
+    valor: number;
+}
 interface CreateInvoiceInput {
     /** UUID of the emission point. Optional if using establishment + emissionPoint codes, or if the taxpayer has a single active emission point. */
     emissionPointId?: string;
@@ -127,6 +139,11 @@ interface CreateInvoiceInput {
      * @default true
      */
     sendEmail?: boolean;
+    /**
+     * In-invoice withholdings. Applies to petroleum product distributors (Tabla 22 code 4)
+     * and presumptive IVA retention for newspaper/magazine editors and distributors (code 2).
+     */
+    retenciones?: InvoiceRetencion[];
 }
 interface ImportByAccessKeyInput {
     /** 49-digit SRI access key (claveAcceso) of an already-authorized invoice */
@@ -139,6 +156,34 @@ interface Invoice {
     status: string;
     total: number | string;
 }
+interface InvoiceListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by invoice status: DRAFT | PENDING | PROCESSING | AUTHORIZED | REJECTED | VOIDED */
+    status?: string;
+    /** Start date (ISO 8601, e.g. "2025-01-01") */
+    dateFrom?: string;
+    /** End date (ISO 8601, e.g. "2025-12-31") */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface InvoiceListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
 interface InvoiceStatus {
     id: string;
     status: string;
@@ -155,6 +200,177 @@ interface DownloadUrlResponse {
      */
     previewUrl?: string;
 }
+interface DebitNoteListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by status: DRAFT | PENDING | PROCESSING | AUTHORIZED | REJECTED | VOIDED */
+    status?: string;
+    /** Start date (ISO 8601, e.g. "2025-01-01") */
+    dateFrom?: string;
+    /** End date (ISO 8601, e.g. "2025-12-31") */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface DebitNoteListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
+interface DebitNoteReason {
+    /** Description of the charge or adjustment */
+    description: string;
+    /** Amount of this charge */
+    amount: number;
+    /**
+     * Tax type for this charge.
+     * `IVA` = IVA at the current rate · `IVA_0` = IVA 0% · `NO_TAX` = not taxable ·
+     * `ICE` = ICE · `IRBPNR` = IRBPNR · `IVA_EXEMPT` = exempt from IVA
+     */
+    taxType: 'IVA' | 'IVA_0' | 'NO_TAX' | 'ICE' | 'IRBPNR' | 'IVA_EXEMPT';
+}
+interface CreateDebitNoteInput {
+    /** 49-digit SRI access key (claveAcceso) of the original authorized invoice */
+    invoiceAccessKey: string;
+    /** Reasons / charges for the debit note (at least one required) */
+    reasons: DebitNoteReason[];
+    additionalInfo?: Record<string, string>;
+    /** UUID of the emission point. Optional if taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+}
+interface DebitNote {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+}
+interface CreditNoteListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by status: DRAFT | PENDING | PROCESSING | AUTHORIZED | REJECTED | VOIDED */
+    status?: string;
+    /** Start date (ISO 8601, e.g. "2025-01-01") */
+    dateFrom?: string;
+    /** End date (ISO 8601, e.g. "2025-12-31") */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface CreditNoteListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
+interface CreateCreditNoteInput {
+    /** 49-digit SRI access key (claveAcceso) of the original authorized invoice */
+    invoiceAccessKey: string;
+    /** Reason for the credit note */
+    reason: string;
+    items: InvoiceItem[];
+    payments?: InvoicePayment[];
+    additionalInfo?: Record<string, string>;
+    /** UUID of the emission point. Optional if taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+}
+interface CreditNote {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+}
+interface WithholdingTaxInput {
+    /** Tax type: RENTA (income) | IVA (VAT) | ISD (foreign exchange) */
+    taxType: 'RENTA' | 'IVA' | 'ISD';
+    /** SRI rate code (codigoPorcentaje), e.g. "303" */
+    taxRateCode: string;
+    /** Tax rate percentage (0–100), e.g. 10 */
+    taxRate: number;
+    /** Tax base amount (baseImponible), must be > 0 */
+    taxBase: number;
+    /** Fiscal period MM/YYYY (defaults to current month) */
+    fiscalPeriod?: string;
+}
+interface CreateWithholdingInput {
+    /** 49-digit SRI access key (claveAcceso) of the original authorized invoice */
+    invoiceAccessKey: string;
+    /** Withholding tax lines (at least one required) */
+    taxes: WithholdingTaxInput[];
+    additionalInfo?: Record<string, string>;
+    /** UUID of the emission point. Optional if taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+}
+interface WithholdingListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by status */
+    status?: string;
+    /** Start date (ISO 8601) */
+    dateFrom?: string;
+    /** End date (ISO 8601) */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface WithholdingListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
+interface Withholding {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    totalWithheld: number | string;
+    invoiceId: string;
+}
 interface SignAndAuthorizeInput {
     /** Unsigned XML string */
     xml: string;
@@ -235,6 +451,18 @@ interface UpdateSequentialResponse {
     invoiceSequential: number;
     updatedAt: string;
 }
+interface UpdateCreditNoteSequentialResponse {
+    branchCode: string;
+    emissionCode: string;
+    creditNoteSequential: number;
+    updatedAt: string;
+}
+interface UpdateDebitNoteSequentialResponse {
+    branchCode: string;
+    emissionCode: string;
+    debitNoteSequential: number;
+    updatedAt: string;
+}
 interface CertificateUploadResponse {
     hasCertificate: boolean;
     isExpired?: boolean;
@@ -282,10 +510,10 @@ interface QueryExternalByAccessKeyResponse {
     xmlBase64: string;
 }
 
-type Requester$4 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$7 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class CertificatesResource {
     private request;
-    constructor(request: Requester$4);
+    constructor(request: Requester$7);
     /**
      * Get the certificate status for the current taxpayer (requires x-taxpayer-ruc header).
      */
@@ -302,10 +530,24 @@ declare class CertificatesResource {
     upload(file: Uint8Array | Blob, password: string): Promise<CertificateUploadResponse>;
 }
 
-type Requester$3 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$6 = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class CreditNotesResource {
+    private request;
+    constructor(request: Requester$6);
+    list(params?: CreditNoteListParams): Promise<PaginatedResponse<CreditNoteListItem>>;
+    create(input: CreateCreditNoteInput): Promise<CreditNote>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    void(id: string, reason: string): Promise<VoidInvoiceResponse>;
+    updateSequential(branchCode: string, emissionCode: string, creditNoteSequential: number): Promise<UpdateCreditNoteSequentialResponse>;
+}
+
+type Requester$5 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class CustomersResource {
     private request;
-    constructor(request: Requester$3);
+    constructor(request: Requester$5);
     create(input: CreateCustomerInput): Promise<Customer>;
     list(params?: CustomerListParams): Promise<PaginatedResponse<Customer>>;
     get(id: string): Promise<Customer>;
@@ -313,10 +555,25 @@ declare class CustomersResource {
     delete(id: string): Promise<void>;
 }
 
-type Requester$2 = (method: string, path: string, body?: unknown) => Promise<unknown>;
+type Requester$4 = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class DebitNotesResource {
+    private request;
+    constructor(request: Requester$4);
+    list(params?: DebitNoteListParams): Promise<PaginatedResponse<DebitNoteListItem>>;
+    create(input: CreateDebitNoteInput): Promise<DebitNote>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    void(id: string, reason: string): Promise<VoidInvoiceResponse>;
+    updateSequential(branchCode: string, emissionCode: string, debitNoteSequential: number): Promise<UpdateDebitNoteSequentialResponse>;
+}
+
+type Requester$3 = (method: string, path: string, body?: unknown) => Promise<unknown>;
 declare class InvoicesResource {
     private request;
-    constructor(request: Requester$2);
+    constructor(request: Requester$3);
+    list(params?: InvoiceListParams): Promise<PaginatedResponse<InvoiceListItem>>;
     create(input: CreateInvoiceInput): Promise<Invoice>;
     signAndAuthorize(input: SignAndAuthorizeInput): Promise<SignAndAuthorizeResponse>;
     signOnly(input: SignOnlyInput): Promise<SignOnlyResponse>;
@@ -332,10 +589,10 @@ declare class InvoicesResource {
     updateSequential(branchCode: string, emissionCode: string, invoiceSequential: number): Promise<UpdateSequentialResponse>;
 }
 
-type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$2 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class ProductsResource {
     private request;
-    constructor(request: Requester$1);
+    constructor(request: Requester$2);
     create(input: CreateProductInput): Promise<Product>;
     list(params?: ProductListParams): Promise<PaginatedResponse<Product>>;
     get(id: string): Promise<Product>;
@@ -343,10 +600,10 @@ declare class ProductsResource {
     delete(id: string): Promise<void>;
 }
 
-type Requester = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class WebhooksResource {
     private readonly request;
-    constructor(requester: Requester);
+    constructor(requester: Requester$1);
     /**
      * Verify that a receipt (document) exists in the API.
      * This is a second layer of verification beyond signature checking.
@@ -357,16 +614,32 @@ declare class WebhooksResource {
     verifyReceipt(receiptId: string): Promise<Record<string, unknown> | null>;
 }
 
+type Requester = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class WithholdingsResource {
+    private request;
+    constructor(request: Requester);
+    create(input: CreateWithholdingInput): Promise<Withholding>;
+    list(params?: WithholdingListParams): Promise<PaginatedResponse<WithholdingListItem>>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    void(id: string, reason: string): Promise<VoidInvoiceResponse>;
+}
+
 declare class Factuplan {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly timeout;
     private readonly options;
     readonly certificates: CertificatesResource;
+    readonly creditNotes: CreditNotesResource;
+    readonly debitNotes: DebitNotesResource;
     readonly customers: CustomersResource;
     readonly products: ProductsResource;
     readonly invoices: InvoicesResource;
     readonly webhooks: WebhooksResource;
+    readonly withholdings: WithholdingsResource;
     static readonly webhooks: typeof WebhooksResource;
     constructor(apiKey: string, options?: FactuplanOptions);
     usage(): Promise<UsageResponse>;
@@ -386,4 +659,4 @@ declare class RateLimitError extends FactuplanError {
     constructor(message?: string);
 }
 
-export { AuthenticationError, type CertificateStatus, type CertificateUploadResponse, CertificatesResource, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type ImportByAccessKeyInput, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, type QueryExternalByAccessKeyInput, type QueryExternalByAccessKeyResponse, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCustomerInput, type UpdateProductInput, type UpdateSequentialResponse, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type VoidInvoiceResponse, type WebhookEvent, type WebhookReceiptData };
+export { AuthenticationError, type CertificateStatus, type CertificateUploadResponse, CertificatesResource, type CreateCreditNoteInput, type CreateCustomerInput, type CreateDebitNoteInput, type CreateInvoiceInput, type CreateProductInput, type CreateWithholdingInput, type CreditNote, type CreditNoteListItem, type CreditNoteListParams, CreditNotesResource, type Customer, type CustomerListParams, type DebitNote, type DebitNoteListItem, type DebitNoteListParams, type DebitNoteReason, DebitNotesResource, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type ImportByAccessKeyInput, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceListItem, type InvoiceListParams, type InvoiceRetencion, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, type QueryExternalByAccessKeyInput, type QueryExternalByAccessKeyResponse, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCreditNoteSequentialResponse, type UpdateCustomerInput, type UpdateDebitNoteSequentialResponse, type UpdateProductInput, type UpdateSequentialResponse, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type VoidInvoiceResponse, type WebhookEvent, type WebhookReceiptData, type Withholding, type WithholdingListItem, type WithholdingListParams, type WithholdingTaxInput, WithholdingsResource };

package/dist/index.d.ts

@@ -9,7 +9,7 @@ interface PaginatedResponse<T> {
 }
 interface Customer {
     id: string;
-    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER' | 'EXTERIOR';
     identification: string;
     legalName: string;
     email?: string;
@@ -20,7 +20,7 @@ interface Customer {
     updatedAt: string;
 }
 interface CreateCustomerInput {
-    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER' | 'EXTERIOR';
     identification: string;
     legalName: string;
     email?: string;
@@ -85,7 +85,7 @@ interface ProductListParams {
     search?: string;
 }
 interface InvoiceCustomer {
-    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER' | 'EXTERIOR';
     identification: string;
     legalName: string;
     email?: string;
@@ -95,6 +95,8 @@ interface InvoiceCustomer {
 }
 interface InvoiceItem {
     code: string;
+    /** Auxiliary code (SRI codigoAuxiliar). Optional — defaults to `code`. */
+    auxiliaryCode?: string;
     description: string;
     quantity: number;
     unitPrice: number;
@@ -110,6 +112,16 @@ interface InvoicePayment {
     term?: number;
     timeUnit?: PaymentTimeUnit;
 }
+interface InvoiceRetencion {
+    /** SRI Tabla 22 code (1 digit). '2' = IVA presuntivo, '4' = combustibles/renta */
+    codigo: string;
+    /** SRI Tabla 23 percentage code (1–3 digits) */
+    codigoPorcentaje: string;
+    /** Retention rate (e.g. 0.20) */
+    tarifa: number;
+    /** Retained amount (e.g. 0.13) */
+    valor: number;
+}
 interface CreateInvoiceInput {
     /** UUID of the emission point. Optional if using establishment + emissionPoint codes, or if the taxpayer has a single active emission point. */
     emissionPointId?: string;
@@ -127,6 +139,11 @@ interface CreateInvoiceInput {
      * @default true
      */
     sendEmail?: boolean;
+    /**
+     * In-invoice withholdings. Applies to petroleum product distributors (Tabla 22 code 4)
+     * and presumptive IVA retention for newspaper/magazine editors and distributors (code 2).
+     */
+    retenciones?: InvoiceRetencion[];
 }
 interface ImportByAccessKeyInput {
     /** 49-digit SRI access key (claveAcceso) of an already-authorized invoice */
@@ -139,6 +156,34 @@ interface Invoice {
     status: string;
     total: number | string;
 }
+interface InvoiceListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by invoice status: DRAFT | PENDING | PROCESSING | AUTHORIZED | REJECTED | VOIDED */
+    status?: string;
+    /** Start date (ISO 8601, e.g. "2025-01-01") */
+    dateFrom?: string;
+    /** End date (ISO 8601, e.g. "2025-12-31") */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface InvoiceListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
 interface InvoiceStatus {
     id: string;
     status: string;
@@ -155,6 +200,177 @@ interface DownloadUrlResponse {
      */
     previewUrl?: string;
 }
+interface DebitNoteListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by status: DRAFT | PENDING | PROCESSING | AUTHORIZED | REJECTED | VOIDED */
+    status?: string;
+    /** Start date (ISO 8601, e.g. "2025-01-01") */
+    dateFrom?: string;
+    /** End date (ISO 8601, e.g. "2025-12-31") */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface DebitNoteListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
+interface DebitNoteReason {
+    /** Description of the charge or adjustment */
+    description: string;
+    /** Amount of this charge */
+    amount: number;
+    /**
+     * Tax type for this charge.
+     * `IVA` = IVA at the current rate · `IVA_0` = IVA 0% · `NO_TAX` = not taxable ·
+     * `ICE` = ICE · `IRBPNR` = IRBPNR · `IVA_EXEMPT` = exempt from IVA
+     */
+    taxType: 'IVA' | 'IVA_0' | 'NO_TAX' | 'ICE' | 'IRBPNR' | 'IVA_EXEMPT';
+}
+interface CreateDebitNoteInput {
+    /** 49-digit SRI access key (claveAcceso) of the original authorized invoice */
+    invoiceAccessKey: string;
+    /** Reasons / charges for the debit note (at least one required) */
+    reasons: DebitNoteReason[];
+    additionalInfo?: Record<string, string>;
+    /** UUID of the emission point. Optional if taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+}
+interface DebitNote {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+}
+interface CreditNoteListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by status: DRAFT | PENDING | PROCESSING | AUTHORIZED | REJECTED | VOIDED */
+    status?: string;
+    /** Start date (ISO 8601, e.g. "2025-01-01") */
+    dateFrom?: string;
+    /** End date (ISO 8601, e.g. "2025-12-31") */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface CreditNoteListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
+interface CreateCreditNoteInput {
+    /** 49-digit SRI access key (claveAcceso) of the original authorized invoice */
+    invoiceAccessKey: string;
+    /** Reason for the credit note */
+    reason: string;
+    items: InvoiceItem[];
+    payments?: InvoicePayment[];
+    additionalInfo?: Record<string, string>;
+    /** UUID of the emission point. Optional if taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+}
+interface CreditNote {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+}
+interface WithholdingTaxInput {
+    /** Tax type: RENTA (income) | IVA (VAT) | ISD (foreign exchange) */
+    taxType: 'RENTA' | 'IVA' | 'ISD';
+    /** SRI rate code (codigoPorcentaje), e.g. "303" */
+    taxRateCode: string;
+    /** Tax rate percentage (0–100), e.g. 10 */
+    taxRate: number;
+    /** Tax base amount (baseImponible), must be > 0 */
+    taxBase: number;
+    /** Fiscal period MM/YYYY (defaults to current month) */
+    fiscalPeriod?: string;
+}
+interface CreateWithholdingInput {
+    /** 49-digit SRI access key (claveAcceso) of the original authorized invoice */
+    invoiceAccessKey: string;
+    /** Withholding tax lines (at least one required) */
+    taxes: WithholdingTaxInput[];
+    additionalInfo?: Record<string, string>;
+    /** UUID of the emission point. Optional if taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+}
+interface WithholdingListParams {
+    /** Filter by customer RUC or cédula */
+    ruc?: string;
+    /** Filter by status */
+    status?: string;
+    /** Start date (ISO 8601) */
+    dateFrom?: string;
+    /** End date (ISO 8601) */
+    dateTo?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Results per page (default: 20, max: 100) */
+    limit?: number;
+}
+interface WithholdingListItem {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+    issueDate: string;
+    createdAt: string;
+    customer: {
+        identification: string;
+        identificationType: string;
+        legalName: string;
+    };
+}
+interface Withholding {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    totalWithheld: number | string;
+    invoiceId: string;
+}
 interface SignAndAuthorizeInput {
     /** Unsigned XML string */
     xml: string;
@@ -235,6 +451,18 @@ interface UpdateSequentialResponse {
     invoiceSequential: number;
     updatedAt: string;
 }
+interface UpdateCreditNoteSequentialResponse {
+    branchCode: string;
+    emissionCode: string;
+    creditNoteSequential: number;
+    updatedAt: string;
+}
+interface UpdateDebitNoteSequentialResponse {
+    branchCode: string;
+    emissionCode: string;
+    debitNoteSequential: number;
+    updatedAt: string;
+}
 interface CertificateUploadResponse {
     hasCertificate: boolean;
     isExpired?: boolean;
@@ -282,10 +510,10 @@ interface QueryExternalByAccessKeyResponse {
     xmlBase64: string;
 }
 
-type Requester$4 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$7 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class CertificatesResource {
     private request;
-    constructor(request: Requester$4);
+    constructor(request: Requester$7);
     /**
      * Get the certificate status for the current taxpayer (requires x-taxpayer-ruc header).
      */
@@ -302,10 +530,24 @@ declare class CertificatesResource {
     upload(file: Uint8Array | Blob, password: string): Promise<CertificateUploadResponse>;
 }
 
-type Requester$3 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$6 = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class CreditNotesResource {
+    private request;
+    constructor(request: Requester$6);
+    list(params?: CreditNoteListParams): Promise<PaginatedResponse<CreditNoteListItem>>;
+    create(input: CreateCreditNoteInput): Promise<CreditNote>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    void(id: string, reason: string): Promise<VoidInvoiceResponse>;
+    updateSequential(branchCode: string, emissionCode: string, creditNoteSequential: number): Promise<UpdateCreditNoteSequentialResponse>;
+}
+
+type Requester$5 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class CustomersResource {
     private request;
-    constructor(request: Requester$3);
+    constructor(request: Requester$5);
     create(input: CreateCustomerInput): Promise<Customer>;
     list(params?: CustomerListParams): Promise<PaginatedResponse<Customer>>;
     get(id: string): Promise<Customer>;
@@ -313,10 +555,25 @@ declare class CustomersResource {
     delete(id: string): Promise<void>;
 }
 
-type Requester$2 = (method: string, path: string, body?: unknown) => Promise<unknown>;
+type Requester$4 = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class DebitNotesResource {
+    private request;
+    constructor(request: Requester$4);
+    list(params?: DebitNoteListParams): Promise<PaginatedResponse<DebitNoteListItem>>;
+    create(input: CreateDebitNoteInput): Promise<DebitNote>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    void(id: string, reason: string): Promise<VoidInvoiceResponse>;
+    updateSequential(branchCode: string, emissionCode: string, debitNoteSequential: number): Promise<UpdateDebitNoteSequentialResponse>;
+}
+
+type Requester$3 = (method: string, path: string, body?: unknown) => Promise<unknown>;
 declare class InvoicesResource {
     private request;
-    constructor(request: Requester$2);
+    constructor(request: Requester$3);
+    list(params?: InvoiceListParams): Promise<PaginatedResponse<InvoiceListItem>>;
     create(input: CreateInvoiceInput): Promise<Invoice>;
     signAndAuthorize(input: SignAndAuthorizeInput): Promise<SignAndAuthorizeResponse>;
     signOnly(input: SignOnlyInput): Promise<SignOnlyResponse>;
@@ -332,10 +589,10 @@ declare class InvoicesResource {
     updateSequential(branchCode: string, emissionCode: string, invoiceSequential: number): Promise<UpdateSequentialResponse>;
 }
 
-type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$2 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class ProductsResource {
     private request;
-    constructor(request: Requester$1);
+    constructor(request: Requester$2);
     create(input: CreateProductInput): Promise<Product>;
     list(params?: ProductListParams): Promise<PaginatedResponse<Product>>;
     get(id: string): Promise<Product>;
@@ -343,10 +600,10 @@ declare class ProductsResource {
     delete(id: string): Promise<void>;
 }
 
-type Requester = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
 declare class WebhooksResource {
     private readonly request;
-    constructor(requester: Requester);
+    constructor(requester: Requester$1);
     /**
      * Verify that a receipt (document) exists in the API.
      * This is a second layer of verification beyond signature checking.
@@ -357,16 +614,32 @@ declare class WebhooksResource {
     verifyReceipt(receiptId: string): Promise<Record<string, unknown> | null>;
 }
 
+type Requester = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class WithholdingsResource {
+    private request;
+    constructor(request: Requester);
+    create(input: CreateWithholdingInput): Promise<Withholding>;
+    list(params?: WithholdingListParams): Promise<PaginatedResponse<WithholdingListItem>>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+    void(id: string, reason: string): Promise<VoidInvoiceResponse>;
+}
+
 declare class Factuplan {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly timeout;
     private readonly options;
     readonly certificates: CertificatesResource;
+    readonly creditNotes: CreditNotesResource;
+    readonly debitNotes: DebitNotesResource;
     readonly customers: CustomersResource;
     readonly products: ProductsResource;
     readonly invoices: InvoicesResource;
     readonly webhooks: WebhooksResource;
+    readonly withholdings: WithholdingsResource;
     static readonly webhooks: typeof WebhooksResource;
     constructor(apiKey: string, options?: FactuplanOptions);
     usage(): Promise<UsageResponse>;
@@ -386,4 +659,4 @@ declare class RateLimitError extends FactuplanError {
     constructor(message?: string);
 }
 
-export { AuthenticationError, type CertificateStatus, type CertificateUploadResponse, CertificatesResource, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type ImportByAccessKeyInput, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, type QueryExternalByAccessKeyInput, type QueryExternalByAccessKeyResponse, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCustomerInput, type UpdateProductInput, type UpdateSequentialResponse, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type VoidInvoiceResponse, type WebhookEvent, type WebhookReceiptData };
+export { AuthenticationError, type CertificateStatus, type CertificateUploadResponse, CertificatesResource, type CreateCreditNoteInput, type CreateCustomerInput, type CreateDebitNoteInput, type CreateInvoiceInput, type CreateProductInput, type CreateWithholdingInput, type CreditNote, type CreditNoteListItem, type CreditNoteListParams, CreditNotesResource, type Customer, type CustomerListParams, type DebitNote, type DebitNoteListItem, type DebitNoteListParams, type DebitNoteReason, DebitNotesResource, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type ImportByAccessKeyInput, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceListItem, type InvoiceListParams, type InvoiceRetencion, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, type QueryExternalByAccessKeyInput, type QueryExternalByAccessKeyResponse, RateLimitError, type SignAndAuthorizeInput, type SignAndAuthorizeResponse, type SignOnlyInput, type SignOnlyResponse, type UpdateCreditNoteSequentialResponse, type UpdateCustomerInput, type UpdateDebitNoteSequentialResponse, type UpdateProductInput, type UpdateSequentialResponse, type UsageResponse, type ValidateXmlInput, type ValidateXmlResponse, type VerifyResponse, type VoidInvoiceResponse, type WebhookEvent, type WebhookReceiptData, type Withholding, type WithholdingListItem, type WithholdingListParams, type WithholdingTaxInput, WithholdingsResource };

package/dist/index.js

@@ -22,9 +22,12 @@ var index_exports = {};
 __export(index_exports, {
   AuthenticationError: () => AuthenticationError,
   CertificatesResource: () => CertificatesResource,
+  CreditNotesResource: () => CreditNotesResource,
+  DebitNotesResource: () => DebitNotesResource,
   Factuplan: () => Factuplan,
   FactuplanError: () => FactuplanError,
-  RateLimitError: () => RateLimitError
+  RateLimitError: () => RateLimitError,
+  WithholdingsResource: () => WithholdingsResource
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -80,6 +83,49 @@ var CertificatesResource = class {
   }
 };
 
+// src/resources/credit-notes.ts
+var CreditNotesResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/credit-notes${qs ? `?${qs}` : ""}`);
+  }
+  async create(input) {
+    return this.request("POST", "/developer/credit-notes", input);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+  async void(id, reason) {
+    return this.request("POST", `/developer/receipts/${id}/void`, { reason });
+  }
+  async updateSequential(branchCode, emissionCode, creditNoteSequential) {
+    return this.request(
+      "PATCH",
+      "/developer/credit-notes/sequential",
+      { branchCode, emissionCode, creditNoteSequential }
+    );
+  }
+};
+
 // src/resources/customers.ts
 var CustomersResource = class {
   constructor(request) {
@@ -102,11 +148,65 @@ var CustomersResource = class {
   }
 };
 
+// src/resources/debit-notes.ts
+var DebitNotesResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/debit-notes${qs ? `?${qs}` : ""}`);
+  }
+  async create(input) {
+    return this.request("POST", "/developer/debit-notes", input);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+  async void(id, reason) {
+    return this.request("POST", `/developer/receipts/${id}/void`, { reason });
+  }
+  async updateSequential(branchCode, emissionCode, debitNoteSequential) {
+    return this.request(
+      "PATCH",
+      "/developer/debit-notes/sequential",
+      { branchCode, emissionCode, debitNoteSequential }
+    );
+  }
+};
+
 // src/resources/invoices.ts
 var InvoicesResource = class {
   constructor(request) {
     this.request = request;
   }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/invoices${qs ? `?${qs}` : ""}`);
+  }
   async create(input) {
     return this.request("POST", "/developer/invoices", input);
   }
@@ -204,6 +304,42 @@ var WebhooksResource = class {
   }
 };
 
+// src/resources/withholdings.ts
+var WithholdingsResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/withholdings", input);
+  }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/withholdings${qs ? `?${qs}` : ""}`);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+  async void(id, reason) {
+    return this.request("POST", `/developer/receipts/${id}/void`, { reason });
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api-rest.factuplan.com.ec/v1";
 var DEFAULT_TIMEOUT = 3e4;
@@ -216,10 +352,13 @@ var Factuplan = class {
     this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
     const requester = this.request.bind(this);
     this.certificates = new CertificatesResource(requester);
+    this.creditNotes = new CreditNotesResource(requester);
+    this.debitNotes = new DebitNotesResource(requester);
     this.customers = new CustomersResource(requester);
     this.products = new ProductsResource(requester);
     this.invoices = new InvoicesResource(requester);
     this.webhooks = new WebhooksResource(requester);
+    this.withholdings = new WithholdingsResource(requester);
   }
   async usage() {
     return this.request("GET", "/developer/usage");
@@ -289,7 +428,10 @@ Factuplan.webhooks = WebhooksResource;
 0 && (module.exports = {
   AuthenticationError,
   CertificatesResource,
+  CreditNotesResource,
+  DebitNotesResource,
   Factuplan,
   FactuplanError,
-  RateLimitError
+  RateLimitError,
+  WithholdingsResource
 });

package/dist/index.mjs

@@ -50,6 +50,49 @@ var CertificatesResource = class {
   }
 };
 
+// src/resources/credit-notes.ts
+var CreditNotesResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/credit-notes${qs ? `?${qs}` : ""}`);
+  }
+  async create(input) {
+    return this.request("POST", "/developer/credit-notes", input);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+  async void(id, reason) {
+    return this.request("POST", `/developer/receipts/${id}/void`, { reason });
+  }
+  async updateSequential(branchCode, emissionCode, creditNoteSequential) {
+    return this.request(
+      "PATCH",
+      "/developer/credit-notes/sequential",
+      { branchCode, emissionCode, creditNoteSequential }
+    );
+  }
+};
+
 // src/resources/customers.ts
 var CustomersResource = class {
   constructor(request) {
@@ -72,11 +115,65 @@ var CustomersResource = class {
   }
 };
 
+// src/resources/debit-notes.ts
+var DebitNotesResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/debit-notes${qs ? `?${qs}` : ""}`);
+  }
+  async create(input) {
+    return this.request("POST", "/developer/debit-notes", input);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+  async void(id, reason) {
+    return this.request("POST", `/developer/receipts/${id}/void`, { reason });
+  }
+  async updateSequential(branchCode, emissionCode, debitNoteSequential) {
+    return this.request(
+      "PATCH",
+      "/developer/debit-notes/sequential",
+      { branchCode, emissionCode, debitNoteSequential }
+    );
+  }
+};
+
 // src/resources/invoices.ts
 var InvoicesResource = class {
   constructor(request) {
     this.request = request;
   }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/invoices${qs ? `?${qs}` : ""}`);
+  }
   async create(input) {
     return this.request("POST", "/developer/invoices", input);
   }
@@ -174,6 +271,42 @@ var WebhooksResource = class {
   }
 };
 
+// src/resources/withholdings.ts
+var WithholdingsResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/withholdings", input);
+  }
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.ruc) query.set("ruc", params.ruc);
+    if (params?.status) query.set("status", params.status);
+    if (params?.dateFrom) query.set("dateFrom", params.dateFrom);
+    if (params?.dateTo) query.set("dateTo", params.dateTo);
+    if (params?.page != null) query.set("page", String(params.page));
+    if (params?.limit != null) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    return this.request("GET", `/developer/withholdings${qs ? `?${qs}` : ""}`);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+  async void(id, reason) {
+    return this.request("POST", `/developer/receipts/${id}/void`, { reason });
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api-rest.factuplan.com.ec/v1";
 var DEFAULT_TIMEOUT = 3e4;
@@ -186,10 +319,13 @@ var Factuplan = class {
     this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
     const requester = this.request.bind(this);
     this.certificates = new CertificatesResource(requester);
+    this.creditNotes = new CreditNotesResource(requester);
+    this.debitNotes = new DebitNotesResource(requester);
     this.customers = new CustomersResource(requester);
     this.products = new ProductsResource(requester);
     this.invoices = new InvoicesResource(requester);
     this.webhooks = new WebhooksResource(requester);
+    this.withholdings = new WithholdingsResource(requester);
   }
   async usage() {
     return this.request("GET", "/developer/usage");
@@ -258,7 +394,10 @@ Factuplan.webhooks = WebhooksResource;
 export {
   AuthenticationError,
   CertificatesResource,
+  CreditNotesResource,
+  DebitNotesResource,
   Factuplan,
   FactuplanError,
-  RateLimitError
+  RateLimitError,
+  WithholdingsResource
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factuplan",
-  "version": "0.10.0",
+  "version": "0.15.0",
   "description": "Official Factuplan SDK for JavaScript & TypeScript — Create electronic invoices for Ecuador (SRI)",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",