facturas 0.5.2 → 0.6.0

package/dist/padron.d.ts

@@ -1,5 +1,5 @@
-import { f as ArcaClientConfig } from './types-CKKe1Oo4.js';
-import { W as WsaaAuthModule, S as SoapTransport } from './index-CqXVyU0E.js';
+import { f as ArcaClientConfig } from './types-Cup-oevW.js';
+import { W as WsaaAuthModule, S as SoapTransport } from './index-3fdgJ3c2.js';
 
 /** Result of a taxpayer lookup via Padron A5. */
 type PadronTaxpayerResult = {

package/dist/padron.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/services/padron.ts"],"sourcesContent":["import type { ArcaServiceName } from \"./internal/types\";\n\n/** Base error class for all ARCA-related errors. */\nexport class ArcaError extends Error {\n  readonly code: string;\n  override readonly name: string = \"ArcaError\";\n\n  constructor(message: string, code = \"ARCA_ERROR\", options?: ErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** Thrown when the ARCA client configuration is missing or invalid. */\nexport class ArcaConfigurationError extends ArcaError {\n  override readonly name: string = \"ArcaConfigurationError\";\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"ARCA_CONFIGURATION_ERROR\", options);\n  }\n}\n\n/** Thrown when caller-provided input data is missing or invalid. */\nexport class ArcaInputError extends ArcaError {\n  override readonly name: string = \"ArcaInputError\";\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_INPUT_ERROR\", options);\n    this.detail = options?.detail;\n  }\n}\n\n/** Thrown when an HTTP request to an ARCA endpoint fails at the transport level. */\nexport class ArcaTransportError extends ArcaError {\n  override readonly name: string = \"ArcaTransportError\";\n  readonly statusCode?: number;\n  readonly contentType?: string;\n  readonly responseBody?: string;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      statusCode?: number;\n      contentType?: string;\n      responseBody?: string;\n    }\n  ) {\n    super(message, \"ARCA_TRANSPORT_ERROR\", options);\n    this.statusCode = options?.statusCode;\n    this.contentType = options?.contentType;\n    this.responseBody = options?.responseBody;\n  }\n}\n\n/** Thrown when the SOAP response contains a Fault element. */\nexport class ArcaSoapFaultError extends ArcaError {\n  override readonly name: string = \"ArcaSoapFaultError\";\n  readonly faultCode?: string;\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      faultCode?: string;\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SOAP_FAULT\", options);\n    this.faultCode = options?.faultCode;\n    this.detail = options?.detail;\n  }\n}\n\n/** Thrown when a response cannot be parsed as a valid SOAP envelope. */\nexport class ArcaInvalidSoapResponseError extends ArcaError {\n  override readonly name: string = \"ArcaInvalidSoapResponseError\";\n  readonly service?: ArcaServiceName;\n  readonly operation?: string;\n  readonly endpointUrl?: string;\n  readonly statusCode?: number;\n  readonly contentType?: string;\n  readonly responseBodyLength?: number;\n  readonly responseBodyPreview?: string;\n  readonly parsedDetail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      service?: ArcaServiceName;\n      operation?: string;\n      endpointUrl?: string;\n      statusCode?: number;\n      contentType?: string;\n      responseBodyLength?: number;\n      responseBodyPreview?: string;\n      parsedDetail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_INVALID_SOAP_RESPONSE\", options);\n    this.service = options?.service;\n    this.operation = options?.operation;\n    this.endpointUrl = options?.endpointUrl;\n    this.statusCode = options?.statusCode;\n    this.contentType = options?.contentType;\n    this.responseBodyLength = options?.responseBodyLength;\n    this.responseBodyPreview = options?.responseBodyPreview;\n    this.parsedDetail = options?.parsedDetail;\n  }\n}\n\n/** Thrown when an ARCA service (WSFE, WSMTXCA, Padron) returns a domain-level error. */\nexport class ArcaServiceError extends ArcaError {\n  override readonly name: string = \"ArcaServiceError\";\n  readonly serviceCode?: string | number;\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      serviceCode?: string | number;\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SERVICE_ERROR\", options);\n    this.serviceCode = options?.serviceCode;\n    this.detail = options?.detail;\n  }\n}\n","import { ArcaSoapFaultError } from \"../errors\";\nimport type {\n  ArcaClientConfig,\n  ArcaPadronServiceName,\n} from \"../internal/types\";\nimport type { SoapTransport } from \"../soap\";\nimport type { WsaaAuthModule } from \"../wsaa\";\n\n/** Result of a taxpayer lookup via Padron A5. */\nexport type PadronTaxpayerResult = {\n  taxId: string;\n  personType?: string;\n  name?: string;\n  raw: Record<string, unknown>;\n};\n\n/** Result of a tax ID lookup by document number via Padron A13. */\nexport type PadronTaxIdLookupResult = {\n  taxIds: string[];\n  raw: Record<string, unknown>;\n};\n\n/** Padron taxpayer registry service. */\nexport type PadronService = {\n  /** Looks up taxpayer details by CUIT. Returns `null` if the taxpayer does not exist. */\n  getTaxpayerDetails(\n    taxId: number | string\n  ): Promise<PadronTaxpayerResult | null>;\n  /** Looks up CUITs associated with a document number. Returns `null` if not found. */\n  getTaxIdByDocument(\n    documentNumber: number | string\n  ): Promise<PadronTaxIdLookupResult | null>;\n};\n\nexport type CreatePadronServiceOptions = {\n  config: ArcaClientConfig;\n  auth: WsaaAuthModule;\n  soap: SoapTransport;\n};\n\n/** Creates a Padron service instance wired with authentication and SOAP transport. */\nexport function createPadronService(\n  options: CreatePadronServiceOptions\n): PadronService {\n  return {\n    async getTaxpayerDetails(taxId) {\n      const raw = await executePadronOperation(\n        options,\n        \"padron-a5\",\n        \"getPersona_v2\",\n        {\n          idPersona: Number.parseInt(String(taxId), 10),\n        }\n      );\n      if (!raw) {\n        return null;\n      }\n      const record = raw as Record<string, unknown>;\n      const datosGenerales = record.datosGenerales as\n        | Record<string, unknown>\n        | undefined;\n      return {\n        taxId: String(record.idPersona ?? \"\"),\n        ...(record.tipoPersona === undefined\n          ? {}\n          : { personType: String(record.tipoPersona) }),\n        ...(datosGenerales ? { name: extractPadronName(datosGenerales) } : {}),\n        raw: record,\n      };\n    },\n    async getTaxIdByDocument(documentNumber) {\n      const raw = await executePadronOperation(\n        options,\n        \"padron-a13\",\n        \"getIdPersonaListByDocumento\",\n        {\n          documento: String(documentNumber),\n        }\n      );\n      if (!raw) {\n        return null;\n      }\n      const record = raw as Record<string, unknown>;\n      const idPersona = record.idPersona;\n      const taxIds = Array.isArray(idPersona)\n        ? idPersona.map(String)\n        : idPersona === undefined\n          ? []\n          : [String(idPersona)];\n      return {\n        taxIds,\n        raw: record,\n      };\n    },\n  };\n}\n\nfunction extractPadronName(\n  datosGenerales: Record<string, unknown>\n): string | undefined {\n  if (typeof datosGenerales.razonSocial === \"string\") {\n    return datosGenerales.razonSocial;\n  }\n  const nombre = datosGenerales.nombre;\n  const apellido = datosGenerales.apellido;\n  if (typeof apellido === \"string\" && typeof nombre === \"string\") {\n    return `${apellido} ${nombre}`.trim();\n  }\n  if (typeof apellido === \"string\") {\n    return apellido;\n  }\n  if (typeof nombre === \"string\") {\n    return nombre;\n  }\n  return undefined;\n}\n\nasync function executePadronOperation(\n  options: CreatePadronServiceOptions,\n  service: ArcaPadronServiceName,\n  operation: string,\n  body: Record<string, unknown>\n) {\n  const auth = await options.auth.login(\n    service === \"padron-a5\"\n      ? \"ws_sr_constancia_inscripcion\"\n      : \"ws_sr_padron_a13\"\n  );\n\n  try {\n    const response = await options.soap.execute<\n      Record<string, unknown>,\n      Record<string, unknown>\n    >({\n      service,\n      operation,\n      bodyElementNamespaceMode: \"prefix\",\n      body: {\n        token: auth.token,\n        sign: auth.sign,\n        cuitRepresentada: Number.parseInt(options.config.taxId, 10),\n        ...body,\n      },\n    });\n\n    const operationResponse = response.result as Record<string, unknown>;\n\n    if (operation === \"getPersona_v2\") {\n      return operationResponse.personaReturn ?? null;\n    }\n\n    if (operation === \"getIdPersonaListByDocumento\") {\n      return operationResponse.idPersonaListReturn ?? null;\n    }\n\n    return operationResponse.return ?? null;\n  } catch (error) {\n    if (\n      error instanceof ArcaSoapFaultError &&\n      // Public Padron A5/A13 WSDLs expose only a generic validation fault, so\n      // there is no documented not-found-specific fault code to match here.\n      // Keep the current message fallback, but treat it as fragile.\n      error.message.toLowerCase().includes(\"no existe\")\n    ) {\n      return null;\n    }\n\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/services/padron.ts"],"sourcesContent":["import type { ArcaServiceName } from \"./internal/types\";\nimport type {\n  ArcaFiscalIssue,\n  ArcaFiscalResultLevel,\n  ArcaFiscalResults,\n} from \"./services/fiscal-evidence\";\n\n/** Base error class for all ARCA-related errors. */\nexport class ArcaError extends Error {\n  readonly code: string;\n  override readonly name: string = \"ArcaError\";\n\n  constructor(message: string, code = \"ARCA_ERROR\", options?: ErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** Thrown when the ARCA client configuration is missing or invalid. */\nexport class ArcaConfigurationError extends ArcaError {\n  override readonly name: string = \"ArcaConfigurationError\";\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"ARCA_CONFIGURATION_ERROR\", options);\n  }\n}\n\n/** Thrown when caller-provided input data is missing or invalid. */\nexport class ArcaInputError extends ArcaError {\n  override readonly name: string = \"ArcaInputError\";\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_INPUT_ERROR\", options);\n    this.detail = options?.detail;\n  }\n}\n\n/** Thrown when an HTTP request to an ARCA endpoint fails at the transport level. */\nexport class ArcaTransportError extends ArcaError {\n  override readonly name: string = \"ArcaTransportError\";\n  readonly statusCode?: number;\n  readonly contentType?: string;\n  readonly responseBody?: string;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      statusCode?: number;\n      contentType?: string;\n      responseBody?: string;\n    }\n  ) {\n    super(message, \"ARCA_TRANSPORT_ERROR\", options);\n    this.statusCode = options?.statusCode;\n    this.contentType = options?.contentType;\n    this.responseBody = options?.responseBody;\n  }\n}\n\n/** Thrown when the SOAP response contains a Fault element. */\nexport class ArcaSoapFaultError extends ArcaError {\n  override readonly name: string = \"ArcaSoapFaultError\";\n  readonly faultCode?: string;\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      faultCode?: string;\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SOAP_FAULT\", options);\n    this.faultCode = options?.faultCode;\n    this.detail = options?.detail;\n  }\n}\n\n/** Thrown when a response cannot be parsed as a valid SOAP envelope. */\nexport class ArcaInvalidSoapResponseError extends ArcaError {\n  override readonly name: string = \"ArcaInvalidSoapResponseError\";\n  readonly service?: ArcaServiceName;\n  readonly operation?: string;\n  readonly endpointUrl?: string;\n  readonly statusCode?: number;\n  readonly contentType?: string;\n  readonly responseBodyLength?: number;\n  readonly responseBodyPreview?: string;\n  readonly parsedDetail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      service?: ArcaServiceName;\n      operation?: string;\n      endpointUrl?: string;\n      statusCode?: number;\n      contentType?: string;\n      responseBodyLength?: number;\n      responseBodyPreview?: string;\n      parsedDetail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_INVALID_SOAP_RESPONSE\", options);\n    this.service = options?.service;\n    this.operation = options?.operation;\n    this.endpointUrl = options?.endpointUrl;\n    this.statusCode = options?.statusCode;\n    this.contentType = options?.contentType;\n    this.responseBodyLength = options?.responseBodyLength;\n    this.responseBodyPreview = options?.responseBodyPreview;\n    this.parsedDetail = options?.parsedDetail;\n  }\n}\n\n/** Thrown when an ARCA service (WSFE, WSMTXCA, Padron) returns a domain-level error. */\nexport class ArcaServiceError extends ArcaError {\n  override readonly name: string = \"ArcaServiceError\";\n  readonly serviceCode?: string | number;\n  readonly service?: ArcaServiceName;\n  readonly operation?: string;\n  readonly result?: string;\n  readonly resultLevel?: ArcaFiscalResultLevel;\n  readonly results?: ArcaFiscalResults;\n  readonly cae?: string;\n  readonly issues?: readonly ArcaFiscalIssue[];\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      serviceCode?: string | number;\n      service?: ArcaServiceName;\n      operation?: string;\n      result?: string;\n      resultLevel?: ArcaFiscalResultLevel;\n      results?: ArcaFiscalResults;\n      cae?: string;\n      issues?: readonly ArcaFiscalIssue[];\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SERVICE_ERROR\", options);\n    this.serviceCode = options?.serviceCode;\n    this.service = options?.service;\n    this.operation = options?.operation;\n    this.result = options?.result;\n    this.resultLevel = options?.resultLevel;\n    this.results = options?.results;\n    this.cae = options?.cae;\n    this.issues = options?.issues;\n    this.detail = options?.detail;\n  }\n}\n","import { ArcaSoapFaultError } from \"../errors\";\nimport type {\n  ArcaClientConfig,\n  ArcaPadronServiceName,\n} from \"../internal/types\";\nimport type { SoapTransport } from \"../soap\";\nimport type { WsaaAuthModule } from \"../wsaa\";\n\n/** Result of a taxpayer lookup via Padron A5. */\nexport type PadronTaxpayerResult = {\n  taxId: string;\n  personType?: string;\n  name?: string;\n  raw: Record<string, unknown>;\n};\n\n/** Result of a tax ID lookup by document number via Padron A13. */\nexport type PadronTaxIdLookupResult = {\n  taxIds: string[];\n  raw: Record<string, unknown>;\n};\n\n/** Padron taxpayer registry service. */\nexport type PadronService = {\n  /** Looks up taxpayer details by CUIT. Returns `null` if the taxpayer does not exist. */\n  getTaxpayerDetails(\n    taxId: number | string\n  ): Promise<PadronTaxpayerResult | null>;\n  /** Looks up CUITs associated with a document number. Returns `null` if not found. */\n  getTaxIdByDocument(\n    documentNumber: number | string\n  ): Promise<PadronTaxIdLookupResult | null>;\n};\n\nexport type CreatePadronServiceOptions = {\n  config: ArcaClientConfig;\n  auth: WsaaAuthModule;\n  soap: SoapTransport;\n};\n\n/** Creates a Padron service instance wired with authentication and SOAP transport. */\nexport function createPadronService(\n  options: CreatePadronServiceOptions\n): PadronService {\n  return {\n    async getTaxpayerDetails(taxId) {\n      const raw = await executePadronOperation(\n        options,\n        \"padron-a5\",\n        \"getPersona_v2\",\n        {\n          idPersona: Number.parseInt(String(taxId), 10),\n        }\n      );\n      if (!raw) {\n        return null;\n      }\n      const record = raw as Record<string, unknown>;\n      const datosGenerales = record.datosGenerales as\n        | Record<string, unknown>\n        | undefined;\n      return {\n        taxId: String(record.idPersona ?? \"\"),\n        ...(record.tipoPersona === undefined\n          ? {}\n          : { personType: String(record.tipoPersona) }),\n        ...(datosGenerales ? { name: extractPadronName(datosGenerales) } : {}),\n        raw: record,\n      };\n    },\n    async getTaxIdByDocument(documentNumber) {\n      const raw = await executePadronOperation(\n        options,\n        \"padron-a13\",\n        \"getIdPersonaListByDocumento\",\n        {\n          documento: String(documentNumber),\n        }\n      );\n      if (!raw) {\n        return null;\n      }\n      const record = raw as Record<string, unknown>;\n      const idPersona = record.idPersona;\n      const taxIds = Array.isArray(idPersona)\n        ? idPersona.map(String)\n        : idPersona === undefined\n          ? []\n          : [String(idPersona)];\n      return {\n        taxIds,\n        raw: record,\n      };\n    },\n  };\n}\n\nfunction extractPadronName(\n  datosGenerales: Record<string, unknown>\n): string | undefined {\n  if (typeof datosGenerales.razonSocial === \"string\") {\n    return datosGenerales.razonSocial;\n  }\n  const nombre = datosGenerales.nombre;\n  const apellido = datosGenerales.apellido;\n  if (typeof apellido === \"string\" && typeof nombre === \"string\") {\n    return `${apellido} ${nombre}`.trim();\n  }\n  if (typeof apellido === \"string\") {\n    return apellido;\n  }\n  if (typeof nombre === \"string\") {\n    return nombre;\n  }\n  return undefined;\n}\n\nasync function executePadronOperation(\n  options: CreatePadronServiceOptions,\n  service: ArcaPadronServiceName,\n  operation: string,\n  body: Record<string, unknown>\n) {\n  const auth = await options.auth.login(\n    service === \"padron-a5\"\n      ? \"ws_sr_constancia_inscripcion\"\n      : \"ws_sr_padron_a13\"\n  );\n\n  try {\n    const response = await options.soap.execute<\n      Record<string, unknown>,\n      Record<string, unknown>\n    >({\n      service,\n      operation,\n      bodyElementNamespaceMode: \"prefix\",\n      body: {\n        token: auth.token,\n        sign: auth.sign,\n        cuitRepresentada: Number.parseInt(options.config.taxId, 10),\n        ...body,\n      },\n    });\n\n    const operationResponse = response.result as Record<string, unknown>;\n\n    if (operation === \"getPersona_v2\") {\n      return operationResponse.personaReturn ?? null;\n    }\n\n    if (operation === \"getIdPersonaListByDocumento\") {\n      return operationResponse.idPersonaListReturn ?? null;\n    }\n\n    return operationResponse.return ?? null;\n  } catch (error) {\n    if (\n      error instanceof ArcaSoapFaultError &&\n      // Public Padron A5/A13 WSDLs expose only a generic validation fault, so\n      // there is no documented not-found-specific fault code to match here.\n      // Keep the current message fallback, but treat it as fragile.\n      error.message.toLowerCase().includes(\"no existe\")\n    ) {\n      return null;\n    }\n\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{types-CKKe1Oo4.d.ts → types-Cup-oevW.d.ts}

@@ -57,6 +57,8 @@ type ArcaAuthOptions = {
 type ArcaSoapExecutionOptions<TBody> = {
     service: ArcaServiceName;
     operation: string;
+    /** Overrides client-level retries for this operation. Use zero for fiscal authorization. */
+    retries?: number;
     bodyElementName?: string;
     bodyElementNamespaceMode?: "default" | "prefix";
     body: TBody;

package/dist/types.d.ts

@@ -1 +1 @@
-export { e as ArcaAuthCredentials, d as ArcaAuthOptions, f as ArcaClientConfig, g as ArcaEnvironment, i as ArcaLogLevel, j as ArcaLoggerConfig, k as ArcaPadronServiceName, l as ArcaRepresentedTaxId, A as ArcaServiceName, m as ArcaServiceTarget, c as ArcaWsaaServiceId, n as ArcaWsaaSessionKey, h as ArcaWsaaSessionStore } from './types-CKKe1Oo4.js';
+export { e as ArcaAuthCredentials, d as ArcaAuthOptions, f as ArcaClientConfig, g as ArcaEnvironment, i as ArcaLogLevel, j as ArcaLoggerConfig, k as ArcaPadronServiceName, l as ArcaRepresentedTaxId, A as ArcaServiceName, m as ArcaServiceTarget, c as ArcaWsaaServiceId, n as ArcaWsaaSessionKey, h as ArcaWsaaSessionStore } from './types-Cup-oevW.js';

package/dist/wsfe.d.ts

@@ -1,5 +1,6 @@
-import { f as ArcaClientConfig } from './types-CKKe1Oo4.js';
-import { W as WsaaAuthModule, S as SoapTransport } from './index-CqXVyU0E.js';
+import { f as ArcaClientConfig } from './types-Cup-oevW.js';
+import { W as WsaaAuthModule, S as SoapTransport } from './index-3fdgJ3c2.js';
+import { d as ArcaAuthorizationOutcome, f as ArcaVoucherLookupResult } from './fiscal-evidence-DbbFH74x.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}`;
@@ -88,6 +89,8 @@ type WsfeAuthorizationResult = {
     voucherNumber: number;
     raw: Record<string, unknown>;
 };
+/** Structured evidence from one exact WSFE authorization attempt. */
+type WsfeAuthorizationOutcome = ArcaAuthorizationOutcome<"wsfe">;
 /** A point-of-sale entry returned by {@link WsfeService.getSalesPoints}. */
 type WsfeSalesPoint = {
     number: number;
@@ -101,12 +104,25 @@ type WsfeVoucherInfo = {
     voucherDate?: string;
     salesPoint?: number;
     voucherType?: number;
+    concept?: number;
+    documentType?: number;
+    documentNumber?: string;
+    receiverVatConditionId?: number;
     totalAmount?: number;
+    nonTaxableAmount?: number;
+    netAmount?: number;
+    exemptAmount?: number;
+    taxAmount?: number;
+    vatAmount?: number;
+    currencyId?: string;
+    exchangeRate?: number;
     result?: string;
     cae?: string;
     caeExpiry?: string;
     raw: Record<string, unknown>;
 };
+/** Typed exact-voucher consultation result for WSFE. */
+type WsfeVoucherLookupResult = ArcaVoucherLookupResult<WsfeVoucherInfo, "wsfe">;
 type WsfeCatalogEntry = {
     id: number;
     description: string;
@@ -135,6 +151,11 @@ type WsfeQuotation = {
 };
 /** WSFE electronic invoicing service. */
 type WsfeService = {
+    /**
+     * Attempts one exact authorization without transport retries and returns
+     * structured provider evidence instead of flattening the result to throw/success.
+     */
+    authorizeVoucherOutcome(input: WsfeAuthorizeVoucherInput): Promise<WsfeAuthorizationOutcome>;
     /** Authorizes a voucher with the explicit number sent as `CbteDesde` and `CbteHasta`. */
     authorizeVoucher(input: WsfeAuthorizeVoucherInput): Promise<WsfeAuthorizationResult>;
     /** Authorizes a new voucher by fetching the next number and requesting a CAE. */
@@ -227,6 +248,14 @@ type WsfeService = {
         voucherType: number;
         forceRefresh?: boolean;
     }): Promise<WsfeVoucherInfo | null>;
+    /** Consults one exact voucher and normalizes WSFE error 602 to `not_found`. */
+    lookupVoucher(input: {
+        representedTaxId?: number | string;
+        number: number;
+        salesPoint: number;
+        voucherType: number;
+        forceRefresh?: boolean;
+    }): Promise<WsfeVoucherLookupResult>;
 };
 type CreateWsfeServiceOptions = {
     config: ArcaClientConfig;
@@ -236,4 +265,4 @@ type CreateWsfeServiceOptions = {
 /** 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 WsfeAuthorizeVoucherInput, 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 };
+export { type CreateWsfeServiceOptions, type WsfeActivity, type WsfeActivityType, type WsfeAssociatedPeriod, type WsfeAssociatedVoucher, type WsfeAuthorizationOutcome, type WsfeAuthorizationResult, type WsfeAuthorizeVoucherInput, 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, type WsfeVoucherLookupResult, createWsfeService };