Métodos directos de ARCA

Para la emisión habitual usá issue(). Los métodos de esta página sirven cuando tu aplicación ya reservó un número, necesita un campo de ARCA que issue() no recibe o tiene que consultar directamente WSFE, WSMTXCA o Padrón.

Control manual de la numeración

Este bloque es examples/factura-b-consumidor-final.ts:

import { buildFacturaB, createArcaClient } from "facturas";
import {
  ARCA_CONCEPT_TYPES,
  ARCA_DOCUMENT_TYPES,
  ARCA_RECEIVER_VAT_CONDITIONS,
} from "facturas/constants";

const environment = process.env.ARCA_ENVIRONMENT;
if (environment !== "test" && environment !== "production") {
  throw new Error("ARCA_ENVIRONMENT debe ser test o production");
}

const client = createArcaClient({
  taxId: process.env.ARCA_TAX_ID,
  certificatePem: process.env.ARCA_CERTIFICATE_PEM,
  privateKeyPem: process.env.ARCA_PRIVATE_KEY_PEM,
  environment,
});

async function main() {
  const data = buildFacturaB({
    salesPoint: 1,
    concept: ARCA_CONCEPT_TYPES.PRODUCTOS,
    documentType: ARCA_DOCUMENT_TYPES.CONSUMIDOR_FINAL,
    documentNumber: 0,
    receiverVatConditionId: ARCA_RECEIVER_VAT_CONDITIONS.CONSUMIDOR_FINAL,
    voucherDate: "2026-09-02",
    taxableAmount: 10_000,
    vatRate: 21,
  });

  // Reservá el número y emitilo una sola vez.
  const voucherNumber = await client.wsfe.getNextVoucherNumber({
    salesPoint: data.salesPoint,
    voucherType: data.voucherType,
  });
  const issued = await client.wsfe.issue({ voucherNumber, data });

  if (issued.kind === "authorized") {
    console.log(issued.cae, issued.caeExpiry, issued.voucherNumber);
  } else {
    console.error(issued.kind, issued);
  }
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

buildFacturaB() deriva el tipo Factura B, el neto, el detalle de IVA, el importe de IVA, los campos en cero y el total, sin aritmética fiscal de punto flotante. buildFacturaC() arma aparte la forma de la Factura C con IVA cero. Las dos funciones aceptan enteros en centavos de la moneda y soportan las ISO ARS (la de por defecto) y USD. Factura B requiere un taxableAmount positivo. Cuando vatRate es positivo, el importe tiene que producir al menos un centavo de IVA después del redondeo. El IVA usa el criterio Round Half Even documentado por ARCA, así que un medio centavo exacto se redondea al centavo par. Para una factura en USD, pasá el tipo de cambio como string decimal:

const usdData = buildFacturaB({
  salesPoint: 1,
  concept: ARCA_CONCEPT_TYPES.PRODUCTOS,
  documentType: ARCA_DOCUMENT_TYPES.CONSUMIDOR_FINAL,
  documentNumber: 0,
  receiverVatConditionId: ARCA_RECEIVER_VAT_CONDITIONS.CONSUMIDOR_FINAL,
  voucherDate: "2026-09-02",
  taxableAmount: 10_000, // USD 100.00.
  vatRate: 21,
  currency: "USD",
  exchangeRate: "1095.500000",
});

Métodos por servicio

`client.wsfe`

Facturación electrónica WSFE. Los inputs usan nombres habituales en JS y el SDK los mapea internamente a los campos SOAP de AFIP / ARCA.

Los campos de fecha aceptan YYYY-MM-DD o YYYYMMDD.
Armá facturas A/B/C desde afirmaciones explícitas con client.issue().
Emití facturas y notas de crédito con los métodos directos de WSFE.
issue({ voucherNumber, data }) manda un pedido de autorización y devuelve evidencia authorized, rejected o indeterminate.
getNextVoucherNumber({ salesPoint, voucherType }) lee el próximo número a reservar.
getVoucherInfo({ number, salesPoint, voucherType }) devuelve el detalle del comprobante o null.
Consultá números y detalles de comprobantes.
Leé los catálogos de ARCA con métodos como getVoucherTypes() y getVatRates(). Hay métodos de catálogo disponibles para datos de referencia en vivo cuando no querés valores fijos en el código.
Verificá el estado del servidor con getServerStatus().
Los métodos autenticados aceptan forceRefresh: true para descartar el TA WSAA cacheado y pedir un Token Authorization nuevo para el mismo servicio.

`client.padron`

getTaxpayerDetails(taxId) devuelve los datos del contribuyente o null.
getTaxIdByDocument(documentNumber) resuelve CUIT candidatos a partir de un número de documento, o null.

El manejo de “no encontrado” en Padrón depende hoy del texto del mensaje del SOAP fault de ARCA, así que es más frágil que los flujos de WSFE basados en códigos.

`client.wsmtxca`

issue({ data })
getLastAuthorizedVoucher({ voucherType, salesPoint })
getVoucher({ voucherType, salesPoint, voucherNumber })
Los métodos autenticados aceptan forceRefresh: true para renovar el TA WSAA de WSMTXCA antes de la llamada.

client.issue() también emite por WSMTXCA, con detalle de ítems, cuando pasás { service: "wsmtxca" }. La guía de WSMTXCA explica ese flujo. Para armar el request completo, llamá directamente a issue, getLastAuthorizedVoucher, lookupVoucher, getVoucher o getSalesPoints.

Emitir un pedido armado por tu aplicación

client.issue() deriva el pedido de WSFE, reserva el número y recupera después de una caída por vos. Cuando necesitás algo que no deriva (una nota en otra moneda o a otro receptor, o cualquier campo fuera de la entrada de issue()) o la numeración es de tu aplicación, usá client.wsfe.issue(...). Este método manda un FECAESolicitar para un número de comprobante que reservaste vos de forma persistente. Devuelve si ese intento quedó autorizado, rechazado o indeterminado. Preserva cada error y observación estructurados con su servicio, operación, código, origen y nivel de resultado.

const outcome = await client.wsfe.issue({
  voucherNumber: reservedVoucherNumber,
  data,
});

if (outcome.kind === "authorized") {
  console.log(outcome.cae, outcome.voucherNumber);
} else if (outcome.kind === "rejected") {
  console.error(outcome.errors, outcome.observations);
} else {
  if (outcome.reason === "authentication_rejected") {
    console.error(outcome.authentication?.reason);
  }
  // Consultá el mismo número antes de volver a intentar una autorización.
  const lookup = await client.wsfe.lookupVoucher({
    number: reservedVoucherNumber,
    salesPoint: data.salesPoint,
    voucherType: data.voucherType,
  });
  console.log(lookup.kind);
}

wsfe.issue() y wsmtxca.issue() fuerzan un único intento de transporte SOAP, incluso cuando el cliente tiene configurados reintentos generales de transporte. Nunca refrescan credenciales ni reenvían de forma automática. Un rechazo de autenticación explícito del proveedor vuelve como reason: "authentication_rejected" con evidencia tipada y segura en authentication. Un timeout, una falla de conexión, una respuesta inválida o un resultado incompleto o contradictorio quedan indeterminados y sin reenvío. Así se evita que un trabajo fiscal incierto provoque una segunda autorización oculta. Las operaciones autenticadas de lectura, catálogo y consulta pueden repetirse una vez con un refresco forzado de credenciales después de un rechazo de autenticación explícito y tipado. Pasar forceRefresh: true desactiva cualquier otro intento de recuperación de autenticación. La ausencia en las consultas directas depende de la operación:

WSFE FECompConsultar código 602 devuelve not_found.
WSFE FEParamGetPtosVenta código 602 devuelve una lista vacía: ARCA responde así cuando el contribuyente no tiene puntos de venta para web services.
WSMTXCA consultarComprobante código 1503 devuelve not_found.
WSMTXCA consultarUltimoComprobanteAutorizado código 1502 devuelve el número de comprobante 0.
El código 602 de WSMTXCA no es ausencia de comprobante exacto y sigue siendo un error.

El SDK normaliza solamente la evidencia de protocolo del proveedor. Tu aplicación sigue siendo responsable de guardar el pedido enviado, de ser dueña de su secuencia o carril, y de decidir cuándo un reintento es seguro. Para los campos fiscales que issue() no recibe, usá WsfeVoucherInput. También soporta exenciones, importes no gravados y varias alícuotas de IVA. Sus importes son números en unidades mayores, se validan localmente y se serializan como strings canónicos de dos decimales:

import type { WsfeVoucherInput } from "facturas/wsfe";
import {
  ARCA_CONCEPT_TYPES,
  ARCA_CURRENCY_IDS,
  ARCA_DOCUMENT_TYPES,
  ARCA_RECEIVER_VAT_CONDITIONS,
  ARCA_VAT_RATES,
  ARCA_VOUCHER_TYPES,
} from "facturas/constants";

const data: WsfeVoucherInput = {
  salesPoint: 1,
  voucherType: ARCA_VOUCHER_TYPES.FACTURA_B,
  concept: ARCA_CONCEPT_TYPES.PRODUCTOS,
  documentType: ARCA_DOCUMENT_TYPES.CONSUMIDOR_FINAL,
  documentNumber: 0,
  receiverVatConditionId: ARCA_RECEIVER_VAT_CONDITIONS.CONSUMIDOR_FINAL,
  voucherDate: "2026-09-02",
  totalAmount: 121,
  nonTaxableAmount: 0,
  netAmount: 100,
  exemptAmount: 0,
  taxAmount: 0,
  vatAmount: 21,
  currencyId: ARCA_CURRENCY_IDS.ARS,
  exchangeRate: "1",
  vatRates: [{ id: ARCA_VAT_RATES.IVA_21, baseAmount: 100, amount: 21 }],
};

Importes y monedas

client.issue(), buildFacturaB() y buildFacturaC() reciben enteros en centavos y monedas ISO ARS o USD. WsfeVoucherInput usa valores decimales en unidades mayores e identificadores de ARCA como PES y DOL.

Empezar

Guías

Referencia

Métodos directos de ARCA

Control manual de la numeración

Métodos por servicio

`client.wsfe`

`client.padron`

`client.wsmtxca`

Emitir un pedido armado por tu aplicación

Importes y monedas

​Control manual de la numeración

​Métodos por servicio

​client.wsfe

​client.padron

​client.wsmtxca

​Emitir un pedido armado por tu aplicación

​Importes y monedas

Control manual de la numeración

Métodos por servicio

`client.wsfe`

`client.padron`

`client.wsmtxca`

Emitir un pedido armado por tu aplicación

Importes y monedas