facturas 0.17.0 → 0.18.0

package/dist/{client-DFRttmTZ.d.ts → client-COK5u3oz.d.ts}

@@ -1,6 +1,6 @@
 import { h as ArcaEnvironment, A as ArcaClientOptions } from './types-Su7QwloQ.js';
 import { PadronService } from './padron.js';
-import { e as ArcaAuthorizationOutcome, I as IssuanceService, h as ArcaFiscalIssue, o as ArcaSafeErrorMetadata } from './fiscal-evidence-Cecw1s05.js';
+import { e as ArcaAuthorizationOutcome, I as IssuanceService, h as ArcaFiscalIssue, o as ArcaSafeErrorMetadata } from './fiscal-evidence-B6UTFGmY.js';
 import { WsfeVoucherInput, WsfeVoucherInfo, WsfeDateInput, WsfeService } from './wsfe.js';
 import { VoucherClass, ReceiverCondition, IssuerCondition } from './constants.js';
 import { WsmtxcaService } from './wsmtxca.js';
@@ -281,11 +281,13 @@ type ServiceFor<O extends IssueOptions> = "service" extends keyof O ? "wsmtxca"
 type IssueRequest<S extends IssuanceService = "wsfe"> = S extends "wsmtxca" ? WsmtxcaIssueRequest : WsfeVoucherInput;
 /**
  * What issue() would send, derived with zero I/O. The voucher number is absent
- * because it is only known when the number is reserved at issuance.
+ * because it is only known when the number is reserved at issuance. `date` is
+ * the voucher date as `YYYY-MM-DD`, the same value issue() returns.
  */
 type IssuePreview<S extends IssuanceService = "wsfe"> = {
     voucherClass: VoucherClass;
     voucherType: number;
+    date: string;
     header: FiscalHeader;
     amounts: IssueAmounts;
     request: IssueRequest<S>;
@@ -507,6 +509,12 @@ type NotePreview<S extends IssuanceService = "wsfe"> = IssuePreview<S> & {
 };
 type RecoveryOptions = Pick<IssueOptions, "representedTaxId" | "forceRefresh" | "include" | "abortSignal">;
 type VouchersService = {
+    /**
+     * Consults one authorized voucher by its coordinates, the same shape a
+     * credit note's `for` takes. Returns `null` when ARCA has no such voucher and
+     * throws on any other provider error. Reads only: no store and no reserve.
+     */
+    lookup(voucher: VoucherCoordinates, options?: PreviewOptions): Promise<VoucherSummary | null>;
     /** Consults a durable reservation. Never allocates or authorizes a voucher. */
     recover<O extends RecoveryOptions = {
         include?: never;
@@ -602,6 +610,8 @@ type ArcaClient = {
     previewCreditNote: VouchersService["previewCreditNote"];
     /** Derives a debit note; reads the original but reserves no number. */
     previewDebitNote: VouchersService["previewDebitNote"];
+    /** Consults one authorized voucher; `null` when ARCA has no such voucher. */
+    lookup: VouchersService["lookup"];
     wsfe: WsfeService;
     wsmtxca: WsmtxcaService;
     padron: PadronService;
@@ -610,8 +620,8 @@ type ArcaClient = {
  * Creates an ARCA client from the given configuration.
  * Validates the config, wires WSAA authentication and SOAP transport,
  * and returns an object with `issue()`, `preview()`, `issueCreditNote()`,
- * `issueDebitNote()`, `previewCreditNote()`, `previewDebitNote()`, `recover()`
- * and the `.wsfe`, `.wsmtxca`, and `.padron` service modules.
+ * `issueDebitNote()`, `previewCreditNote()`, `previewDebitNote()`, `recover()`,
+ * `lookup()` and the `.wsfe`, `.wsmtxca`, and `.padron` service modules.
  *
  * @throws {ArcaConfigurationError} When the config is missing or invalid.
  */

package/dist/errors.d.ts

@@ -1,2 +1,2 @@
 import './types-Su7QwloQ.js';
-export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, c as ArcaAuthenticationReason, f as ArcaConfigurationError, g as ArcaError, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaSafeErrorMetadata, p as ArcaServiceError, q as ArcaSoapFaultError, r as ArcaTransportError, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-Cecw1s05.js';
+export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, c as ArcaAuthenticationReason, f as ArcaConfigurationError, g as ArcaError, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaSafeErrorMetadata, p as ArcaServiceError, q as ArcaSoapFaultError, r as ArcaTransportError, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-B6UTFGmY.js';

package/dist/errors.mjs

@@ -9,7 +9,7 @@ import {
   ArcaTransportError,
   isArcaAuthenticationError,
   toArcaSafeErrorMetadata
-} from "./chunk-BYEP3ABS.mjs";
+} from "./chunk-EZ4HA3LC.mjs";
 export {
   ArcaAuthenticationError,
   ArcaConfigurationError,

package/dist/{fiscal-evidence-Cecw1s05.d.ts → fiscal-evidence-B6UTFGmY.d.ts}

@@ -110,12 +110,29 @@ declare class ArcaServiceError extends ArcaError {
         issues?: readonly ArcaFiscalIssue[];
     });
 }
-/** Narrow error evidence: never includes a cause, raw response or stack. */
+/**
+ * Narrow error evidence, safe to log or store: the typed fields the error
+ * classes declare, never a cause, stack, raw response, response body preview,
+ * endpoint URL, fiscal issues or CAE.
+ */
 type ArcaSafeErrorMetadata = {
     name: string;
     message: string;
     code?: string;
     statusCode?: number;
+    contentType?: string;
+    service?: ArcaServiceName;
+    operation?: string;
+    /** ArcaAuthenticationError's stable reason. */
+    reason?: ArcaAuthenticationReason;
+    providerCode?: string | number;
+    faultCode?: string;
+    field?: string;
+    expected?: string;
+    /** ArcaServiceError's provider code, always as a string. */
+    serviceCode?: string;
+    result?: string;
+    resultLevel?: ArcaFiscalResultLevel;
 };
 declare function toArcaSafeErrorMetadata(error: unknown): ArcaSafeErrorMetadata;
 

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-export { a as AmountItem, A as ArcaClient, b as ArcaClientConfigView, C as CreditNoteInput, D as DebitNoteInput, F as FceOptions, c as FiscalHeader, I as InvoiceFamily, d as IssuanceFields, e as IssueAmounts, f as IssueCommon, g as IssueInput, h as IssueOptions, i as IssueOutcome, j as IssuePreview, k as IssueRequest, l as IssuedVoucher, m as ItemLine, N as NotePreview, P as PeriodNoteInput, n as PreviewOptions, R as Receiver, o as RecoveryOptions, T as Tribute, V as VatItem, p as VatRate, q as VoucherAmounts, r as VoucherCoordinates, s as VoucherSummary, t as VouchersService, W as WsfeIdentityMatch, u as WsmtxcaIssueRequest, v as WsmtxcaLine, w as createArcaClient, x as matchWsfeVoucherIdentity } from './client-DFRttmTZ.js';
+export { a as AmountItem, A as ArcaClient, b as ArcaClientConfigView, C as CreditNoteInput, D as DebitNoteInput, F as FceOptions, c as FiscalHeader, I as InvoiceFamily, d as IssuanceFields, e as IssueAmounts, f as IssueCommon, g as IssueInput, h as IssueOptions, i as IssueOutcome, j as IssuePreview, k as IssueRequest, l as IssuedVoucher, m as ItemLine, N as NotePreview, P as PeriodNoteInput, n as PreviewOptions, R as Receiver, o as RecoveryOptions, T as Tribute, V as VatItem, p as VatRate, q as VoucherAmounts, r as VoucherCoordinates, s as VoucherSummary, t as VouchersService, W as WsfeIdentityMatch, u as WsmtxcaIssueRequest, v as WsmtxcaLine, w as createArcaClient, x as matchWsfeVoucherIdentity } from './client-COK5u3oz.js';
 import { h as ArcaEnvironment, a as ArcaClientConfig, i as ArcaStore, j as ArcaWsaaSessionStore } from './types-Su7QwloQ.js';
 export { g as ArcaAuthCredentials, f as ArcaAuthOptions, A as ArcaClientConfig, k as ArcaLogLevel, l as ArcaLoggerConfig, m as ArcaPadronServiceName, n as ArcaRepresentedTaxId, b as ArcaServiceName, o as ArcaServiceTarget, e as ArcaWsaaServiceId, p as ArcaWsaaSessionKey } from './types-Su7QwloQ.js';
 export { ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS, ARCA_INVOICE_CLASS_BY_ISSUER, ARCA_ISSUER_CONDITION_IDS, ARCA_RECEIVER_CONDITION_IDS, IssuerCondition, ReceiverCondition, VoucherClass } from './constants.js';
-export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, b as ArcaAuthenticationEvidence, c as ArcaAuthenticationReason, d as ArcaAuthorizationIndeterminateReason, e as ArcaAuthorizationOutcome, f as ArcaConfigurationError, g as ArcaError, h as ArcaFiscalIssue, i as ArcaFiscalResultLevel, j as ArcaFiscalResults, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaSafeErrorMetadata, p as ArcaServiceError, q as ArcaSoapFaultError, r as ArcaTransportError, s as ArcaVoucherLookupResult, I as IssuanceService, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-Cecw1s05.js';
-export { CreatePadronServiceOptions, PadronService, PadronTax, PadronTaxIdLookupResult, PadronTaxpayerResult, createPadronService } from './padron.js';
+export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, b as ArcaAuthenticationEvidence, c as ArcaAuthenticationReason, d as ArcaAuthorizationIndeterminateReason, e as ArcaAuthorizationOutcome, f as ArcaConfigurationError, g as ArcaError, h as ArcaFiscalIssue, i as ArcaFiscalResultLevel, j as ArcaFiscalResults, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaSafeErrorMetadata, p as ArcaServiceError, q as ArcaSoapFaultError, r as ArcaTransportError, s as ArcaVoucherLookupResult, I as IssuanceService, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-B6UTFGmY.js';
+export { CreatePadronServiceOptions, PadronActivity, PadronAddress, PadronService, PadronTax, PadronTaxIdLookupResult, PadronTaxpayerResult, createPadronService } from './padron.js';
 export { CreateWsfeServiceOptions, WsfeActivity, WsfeActivityType, WsfeAssociatedPeriod, WsfeAssociatedVoucher, WsfeAuthorizationOutcome, WsfeBuyer, WsfeCatalogEntry, WsfeCurrencyType, WsfeDateInput, WsfeIssueInput, WsfeOptionalField, WsfeQuotation, WsfeReceiverVatCondition, WsfeSalesPoint, WsfeServerStatus, WsfeService, WsfeTax, WsfeVatRate, WsfeVoucherInfo, WsfeVoucherInput, WsfeVoucherLookupResult, createWsfeService } from './wsfe.js';
-export { CreateWsmtxcaServiceOptions, WsmtxcaAuthorizationOutcome, WsmtxcaIssueInput, WsmtxcaLastAuthorizedVoucherResult, WsmtxcaSalesPoint, WsmtxcaSalesPointsResult, WsmtxcaService, WsmtxcaVoucherInfo, WsmtxcaVoucherLookupOutcome, WsmtxcaVoucherLookupResult, createWsmtxcaService } from './wsmtxca.js';
+export { CreateWsmtxcaServiceOptions, WsmtxcaAuthorizationOutcome, WsmtxcaIssueInput, WsmtxcaLastAuthorizedVoucherResult, WsmtxcaSalesPoint, WsmtxcaSalesPointsResult, WsmtxcaService, WsmtxcaVoucherInfo, WsmtxcaVoucherLookupOutcome, createWsmtxcaService } from './wsmtxca.js';
 import './index-DAC3edtw.js';
 
 /** Valid ARCA environment names. */

package/dist/index.mjs

@@ -13,7 +13,7 @@ import {
   matchWsfeVoucherIdentity,
   storeCall,
   withLease
-} from "./chunk-BNZECHTS.mjs";
+} from "./chunk-JP5IBMVI.mjs";
 import {
   ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS,
   ARCA_INVOICE_CLASS_BY_ISSUER,
@@ -22,14 +22,14 @@ import {
 } from "./chunk-DHN6OQJP.mjs";
 import {
   createPadronService
-} from "./chunk-EXECWJEC.mjs";
+} from "./chunk-MRBFLBWX.mjs";
 import {
   createWsfeService
-} from "./chunk-KD2WT535.mjs";
+} from "./chunk-OORNZFI5.mjs";
 import {
   createWsmtxcaService
-} from "./chunk-MS4SSSYU.mjs";
-import "./chunk-PHXH34L6.mjs";
+} from "./chunk-4RD5VQWC.mjs";
+import "./chunk-WPHD2GQJ.mjs";
 import {
   ArcaAuthenticationError,
   ArcaConfigurationError,
@@ -41,7 +41,7 @@ import {
   ArcaTransportError,
   isArcaAuthenticationError,
   toArcaSafeErrorMetadata
-} from "./chunk-BYEP3ABS.mjs";
+} from "./chunk-EZ4HA3LC.mjs";
 
 // src/store/memory.ts
 function createMemoryStore() {

package/dist/padron.d.ts

@@ -10,11 +10,32 @@ type PadronTax = {
     state?: string;
     regime: "general" | "monotributo";
 };
+/** The domicilio fiscal. A field ARCA omits is absent. */
+type PadronAddress = {
+    street?: string;
+    city?: string;
+    postalCode?: string;
+    /** ARCA's province code, the one invoices and IIBB registrations use. */
+    provinceId?: number;
+    province?: string;
+};
+/** One economic activity registered under a regime. */
+type PadronActivity = {
+    /** The six-digit NAES code, zero-padded, such as `011211`. */
+    id: string;
+    description?: string;
+    /** ARCA's ordering; `1` is the main activity. */
+    order?: number;
+    /** The period the activity starts, as `YYYY-MM`. */
+    since?: string;
+    regime: "general" | "monotributo";
+};
 /** Result of a taxpayer lookup via Padron A5. */
 type PadronTaxpayerResult = {
     taxId: string;
     personType?: string;
     name?: string;
+    address?: PadronAddress;
     /**
      * The receiver condition to invoice this taxpayer under, derived from its
      * active IVA registrations: 30 is responsable inscripto, 20 monotributo, 32
@@ -24,6 +45,12 @@ type PadronTaxpayerResult = {
      */
     condition?: ReceiverCondition;
     taxes: PadronTax[];
+    activities: PadronActivity[];
+    /**
+     * The constancia's own errors, such as an unresolved domicilio. Empty when
+     * there are none. A taxpayer with errors has no `condition`.
+     */
+    errors: string[];
     raw: Record<string, unknown>;
 };
 /** Result of a tax ID lookup by document number via Padron A13. */
@@ -46,4 +73,4 @@ type CreatePadronServiceOptions = {
 /** Creates a Padron service instance wired with authentication and SOAP transport. */
 declare function createPadronService(options: CreatePadronServiceOptions): PadronService;
 
-export { type CreatePadronServiceOptions, type PadronService, type PadronTax, type PadronTaxIdLookupResult, type PadronTaxpayerResult, createPadronService };
+export { type CreatePadronServiceOptions, type PadronActivity, type PadronAddress, type PadronService, type PadronTax, type PadronTaxIdLookupResult, type PadronTaxpayerResult, createPadronService };

package/dist/padron.mjs

@@ -1,7 +1,7 @@
 import {
   createPadronService
-} from "./chunk-EXECWJEC.mjs";
-import "./chunk-BYEP3ABS.mjs";
+} from "./chunk-MRBFLBWX.mjs";
+import "./chunk-EZ4HA3LC.mjs";
 export {
   createPadronService
 };

package/dist/wsfe.d.ts

@@ -1,6 +1,6 @@
 import { a as ArcaClientConfig } from './types-Su7QwloQ.js';
 import { W as WsaaAuthModule, S as SoapTransport } from './index-DAC3edtw.js';
-import { e as ArcaAuthorizationOutcome, s as ArcaVoucherLookupResult } from './fiscal-evidence-Cecw1s05.js';
+import { e as ArcaAuthorizationOutcome, s as ArcaVoucherLookupResult } from './fiscal-evidence-B6UTFGmY.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}`;
@@ -86,14 +86,18 @@ type WsfeIssueInput = {
 };
 /** Structured evidence from one exact WSFE authorization attempt. */
 type WsfeAuthorizationOutcome = ArcaAuthorizationOutcome<"wsfe">;
-/** A point-of-sale entry returned by {@link WsfeService.getSalesPoints}. */
+/**
+ * A point-of-sale entry returned by {@link WsfeService.getSalesPoints}, in the
+ * same shape as a WSMTXCA one. `deletedAt` is `YYYY-MM-DD` and absent while the
+ * point is active.
+ */
 type WsfeSalesPoint = {
     number: number;
     emissionType?: string;
-    blocked?: string;
-    deletedSince?: string;
+    blocked: boolean;
+    deletedAt?: string;
 };
-/** Voucher details returned by {@link WsfeService.getVoucherInfo}. */
+/** Voucher details returned by {@link WsfeService.lookupVoucher}. */
 type WsfeVoucherInfo = {
     voucherNumber: number;
     voucherDate?: string;
@@ -230,14 +234,6 @@ type WsfeService = {
         representedTaxId?: number | string;
         forceRefresh?: 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;
-        forceRefresh?: boolean;
-    }): Promise<WsfeVoucherInfo | null>;
     /** Consults one exact voucher and normalizes WSFE error 602 to `not_found`. */
     lookupVoucher(input: {
         representedTaxId?: number | string;

package/dist/wsfe.mjs

@@ -1,8 +1,8 @@
 import {
   createWsfeService
-} from "./chunk-KD2WT535.mjs";
-import "./chunk-PHXH34L6.mjs";
-import "./chunk-BYEP3ABS.mjs";
+} from "./chunk-OORNZFI5.mjs";
+import "./chunk-WPHD2GQJ.mjs";
+import "./chunk-EZ4HA3LC.mjs";
 export {
   createWsfeService
 };

package/dist/wsmtxca.d.ts

@@ -1,6 +1,6 @@
 import { n as ArcaRepresentedTaxId, a as ArcaClientConfig } from './types-Su7QwloQ.js';
 import { W as WsaaAuthModule, S as SoapTransport } from './index-DAC3edtw.js';
-import { e as ArcaAuthorizationOutcome, s as ArcaVoucherLookupResult } from './fiscal-evidence-Cecw1s05.js';
+import { e as ArcaAuthorizationOutcome, s as ArcaVoucherLookupResult } from './fiscal-evidence-B6UTFGmY.js';
 
 /** Input for {@link WsmtxcaService.issue}: one WSMTXCA voucher request. */
 type WsmtxcaIssueInput = {
@@ -53,13 +53,6 @@ type WsmtxcaVoucherInfo = {
 };
 /** Typed exact-voucher consultation result for WSMTXCA. */
 type WsmtxcaVoucherLookupOutcome = ArcaVoucherLookupResult<WsmtxcaVoucherInfo, "wsmtxca">;
-/** Result of looking up a specific WSMTXCA voucher. */
-type WsmtxcaVoucherLookupResult = {
-    invoiceDate: string;
-    voucher: Record<string, unknown>;
-    messages: string[];
-    raw: Record<string, unknown>;
-};
 /** WSMTXCA electronic invoicing service (Factura de Crédito Electrónica). */
 type WsmtxcaService = {
     /**
@@ -89,14 +82,6 @@ type WsmtxcaService = {
         forceRefresh?: boolean;
         abortSignal?: AbortSignal;
     }): Promise<WsmtxcaVoucherLookupOutcome>;
-    /** Retrieves details for a specific voucher. */
-    getVoucher(input: {
-        representedTaxId?: ArcaRepresentedTaxId;
-        voucherType: number;
-        salesPoint: number;
-        voucherNumber: number;
-        forceRefresh?: boolean;
-    }): Promise<WsmtxcaVoucherLookupResult>;
 };
 type CreateWsmtxcaServiceOptions = {
     config: ArcaClientConfig;
@@ -106,4 +91,4 @@ type CreateWsmtxcaServiceOptions = {
 /** Creates a WSMTXCA service instance wired with authentication and SOAP transport. */
 declare function createWsmtxcaService(options: CreateWsmtxcaServiceOptions): WsmtxcaService;
 
-export { type CreateWsmtxcaServiceOptions, type WsmtxcaAuthorizationOutcome, type WsmtxcaIssueInput, type WsmtxcaLastAuthorizedVoucherResult, type WsmtxcaSalesPoint, type WsmtxcaSalesPointsResult, type WsmtxcaService, type WsmtxcaVoucherInfo, type WsmtxcaVoucherLookupOutcome, type WsmtxcaVoucherLookupResult, createWsmtxcaService };
+export { type CreateWsmtxcaServiceOptions, type WsmtxcaAuthorizationOutcome, type WsmtxcaIssueInput, type WsmtxcaLastAuthorizedVoucherResult, type WsmtxcaSalesPoint, type WsmtxcaSalesPointsResult, type WsmtxcaService, type WsmtxcaVoucherInfo, type WsmtxcaVoucherLookupOutcome, createWsmtxcaService };

package/dist/wsmtxca.mjs

@@ -1,8 +1,8 @@
 import {
   createWsmtxcaService
-} from "./chunk-MS4SSSYU.mjs";
-import "./chunk-PHXH34L6.mjs";
-import "./chunk-BYEP3ABS.mjs";
+} from "./chunk-4RD5VQWC.mjs";
+import "./chunk-WPHD2GQJ.mjs";
+import "./chunk-EZ4HA3LC.mjs";
 export {
   createWsmtxcaService
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "facturas",
-  "version": "0.17.0",
-  "description": "SDK de facturación electrónica con ARCA / AFIP para Node.js: facturas, notas de crédito y débito, y Padrón con una sola API.",
+  "version": "0.18.0",
+  "description": "SDK de TypeScript para facturación electrónica con ARCA / AFIP: facturas, notas de crédito y débito, y Padrón con una sola API.",
   "type": "module",
   "license": "Apache-2.0",
   "author": "LaPyme",