facturas 0.4.0

package/dist/wsfe.d.ts

@@ -0,0 +1,228 @@
+import { A as ArcaClientConfig } from './types-SloiIQkT.js';
+import { W as WsaaAuthModule, S as SoapTransport } from './index-BLq3d6xg.js';
+
+/** Accepted public date inputs for WSFE request fields. */
+type WsfeDateInput = `${number}${number}${number}${number}-${number}${number}-${number}${number}` | `${number}${number}${number}${number}${number}${number}${number}${number}`;
+/** An associated voucher referenced by a WSFE invoice request. */
+type WsfeAssociatedVoucher = {
+    type: number;
+    salesPoint: number;
+    number: number;
+    taxId?: string;
+    voucherDate?: WsfeDateInput;
+};
+/** An associated period used by WSFE credit/debit notes without associated vouchers. */
+type WsfeAssociatedPeriod = {
+    startDate: WsfeDateInput;
+    endDate: WsfeDateInput;
+};
+/** A tax (tributo) item in a WSFE invoice request. */
+type WsfeTax = {
+    id: number;
+    description?: string;
+    baseAmount: number;
+    rate: number;
+    amount: number;
+};
+/** A VAT rate (alícuota IVA) item in a WSFE invoice request. */
+type WsfeVatRate = {
+    id: number;
+    baseAmount: number;
+    amount: number;
+};
+/** An optional field (campo opcional) in a WSFE invoice request. */
+type WsfeOptionalField = {
+    id: string;
+    value: string;
+};
+/** A buyer (comprador) in a WSFE invoice request. */
+type WsfeBuyer = {
+    documentType: number;
+    documentNumber: number;
+    percentage: number;
+};
+/** An activity associated with a WSFE invoice request. */
+type WsfeActivity = {
+    id: number;
+};
+/** Input data for creating a new WSFE voucher via {@link WsfeService.createNextVoucher}. */
+type WsfeVoucherInput = {
+    salesPoint: number;
+    voucherType: number;
+    concept: number;
+    documentType: number;
+    documentNumber: number;
+    receiverVatConditionId?: number;
+    voucherDate: WsfeDateInput;
+    totalAmount: number;
+    nonTaxableAmount: number;
+    netAmount: number;
+    exemptAmount: number;
+    taxAmount: number;
+    vatAmount: number;
+    currencyId: string;
+    exchangeRate: number;
+    sameCurrencyForeignCancellation?: "S" | "N";
+    serviceStartDate?: WsfeDateInput;
+    serviceEndDate?: WsfeDateInput;
+    paymentDueDate?: WsfeDateInput;
+    associatedVouchers?: WsfeAssociatedVoucher[];
+    associatedPeriod?: WsfeAssociatedPeriod;
+    taxes?: WsfeTax[];
+    vatRates?: WsfeVatRate[];
+    optionalFields?: WsfeOptionalField[];
+    buyers?: WsfeBuyer[];
+    activities?: WsfeActivity[];
+};
+/** Result of a successful WSFE voucher authorization. */
+type WsfeAuthorizationResult = {
+    cae: string;
+    caeExpiry: string;
+    voucherNumber: number;
+    raw: Record<string, unknown>;
+};
+/** A point-of-sale entry returned by {@link WsfeService.getSalesPoints}. */
+type WsfeSalesPoint = {
+    number: number;
+    emissionType?: string;
+    blocked?: string;
+    deletedSince?: string;
+};
+/** Voucher details returned by {@link WsfeService.getVoucherInfo}. */
+type WsfeVoucherInfo = {
+    voucherNumber: number;
+    voucherDate?: string;
+    salesPoint?: number;
+    voucherType?: number;
+    totalAmount?: number;
+    result?: string;
+    cae?: string;
+    caeExpiry?: string;
+    raw: Record<string, unknown>;
+};
+type WsfeCatalogEntry = {
+    id: number;
+    description: string;
+};
+type WsfeActivityType = WsfeCatalogEntry & {
+    order: number;
+};
+type WsfeReceiverVatCondition = WsfeCatalogEntry & {
+    voucherClass: string;
+};
+type WsfeCurrencyType = {
+    id: string;
+    description: string;
+    validFrom: string;
+    validTo: string;
+};
+type WsfeServerStatus = {
+    appServer: string;
+    dbServer: string;
+    authServer: string;
+};
+type WsfeQuotation = {
+    currencyId: string;
+    rate: number;
+    date: string;
+};
+/** WSFE electronic invoicing service. */
+type WsfeService = {
+    /** Authorizes a new voucher by fetching the next number and requesting a CAE. */
+    createNextVoucher(input: {
+        representedTaxId?: number | string;
+        data: WsfeVoucherInput;
+    }): Promise<WsfeAuthorizationResult>;
+    /** Returns the next available voucher number for the given sales point and type. */
+    getNextVoucherNumber(input: {
+        representedTaxId?: number | string;
+        salesPoint: number;
+        voucherType: number;
+        forceAuthRefresh?: boolean;
+    }): Promise<number>;
+    /**
+     * @deprecated Use `getNextVoucherNumber()` instead.
+     * Returns the next available voucher number, not the last authorized one.
+     */
+    getLastVoucher(input: {
+        representedTaxId?: number | string;
+        salesPoint: number;
+        voucherType: number;
+        forceAuthRefresh?: boolean;
+    }): Promise<number>;
+    /** Lists all configured points of sale for the taxpayer. */
+    getSalesPoints(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeSalesPoint[]>;
+    /** Lists voucher types accepted by WSFE. */
+    getVoucherTypes(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeCatalogEntry[]>;
+    /** Lists document types accepted by WSFE. */
+    getDocumentTypes(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeCatalogEntry[]>;
+    /** Lists concept types accepted by WSFE. */
+    getConceptTypes(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeCatalogEntry[]>;
+    /** Lists supported currency types. */
+    getCurrencyTypes(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeCurrencyType[]>;
+    /** Lists VAT rates accepted by WSFE. */
+    getVatRates(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeCatalogEntry[]>;
+    /** Lists tax types accepted by WSFE. */
+    getTaxTypes(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeCatalogEntry[]>;
+    /** Lists optional field types accepted by WSFE. */
+    getOptionalTypes(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeCatalogEntry[]>;
+    /** Lists activities enabled for the taxpayer. */
+    getActivities(input: {
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeActivityType[]>;
+    /** Lists receiver VAT condition values accepted by WSFE. */
+    getReceiverVatConditions(input: {
+        representedTaxId?: number | string;
+        voucherClass?: string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeReceiverVatCondition[]>;
+    /** Reports WSFE backend status without requiring taxpayer authorization. */
+    getServerStatus(): Promise<WsfeServerStatus>;
+    /** Returns the exchange rate for a given currency. */
+    getQuotation(input: {
+        currencyId: string;
+        representedTaxId?: number | string;
+        forceAuthRefresh?: boolean;
+    }): Promise<WsfeQuotation>;
+    /** Retrieves details for a specific voucher. Returns `null` if not found. */
+    getVoucherInfo(input: {
+        representedTaxId?: number | string;
+        number: number;
+        salesPoint: number;
+        voucherType: number;
+    }): Promise<WsfeVoucherInfo | null>;
+};
+type CreateWsfeServiceOptions = {
+    config: ArcaClientConfig;
+    auth: WsaaAuthModule;
+    soap: SoapTransport;
+};
+/** Creates a WSFE service instance wired with authentication and SOAP transport. */
+declare function createWsfeService(options: CreateWsfeServiceOptions): WsfeService;
+
+export { type CreateWsfeServiceOptions, type WsfeActivity, type WsfeActivityType, type WsfeAssociatedPeriod, type WsfeAssociatedVoucher, type WsfeAuthorizationResult, type WsfeBuyer, type WsfeCatalogEntry, type WsfeCurrencyType, type WsfeDateInput, type WsfeOptionalField, type WsfeQuotation, type WsfeReceiverVatCondition, type WsfeSalesPoint, type WsfeServerStatus, type WsfeService, type WsfeTax, type WsfeVatRate, type WsfeVoucherInfo, type WsfeVoucherInput, createWsfeService };