WSFECRED

ARCA FECred

@ramiidv/arca-fecred@0.8.1

SDK para todas las operaciones de WSFECRED: Factura de Crédito Electrónica MiPyME (Ley 27.440). Obligación de recepción, cuentas corrientes, comprobantes, aceptación, rechazo, cancelación total y Agentes de Depósito Colectivo, según el manual del desarrollador v2.0.3.

npm install @ramiidv/arca-fecred@0.8.1
TypeScript
import { readFileSync } from "node:fs";
import { ArcaFecred, FileTicketStorage } from "@ramiidv/arca-fecred";

const fecred = new ArcaFecred({
  cuit: "20-12345678-6",
  // certs/ en el .gitignore: nunca subas la clave
  cert: readFileSync("./certs/certificado.crt", "utf-8"),
  key: readFileSync("./certs/clave.key", "utf-8"),
  ticketStorage: new FileTicketStorage("./.arca-tickets"),
});

// Cuentas corrientes recibidas en octubre (paginado)
const { ctasCtes, hayMas } = await fecred.consultarCtasCtes({
  rol: "Receptor",
  fecha: { tipo: "Emision", desde: "2026-10-01", hasta: "2026-10-31" },
});

// Aceptar una FCE
const r = await fecred.aceptarFECred({
  idCtaCte: { codCtaCte: ctasCtes[0].codCtaCte },
  saldoAceptado: ctasCtes[0].saldo,
  codMoneda: ctasCtes[0].codMoneda,
  cotizacionMonedaUlt: 1,
});
console.log(r.resultado); // "A" o "O" (un rechazo lanza ArcaRechazoError)

Características

Qué incluye FECred

Obligación de recepción

consultarMontoObligadoRecepcion con la fecha de emisión: si la CUIT está obligada y desde qué monto.

Cuentas corrientes y comprobantes

Consultas paginadas por rol, contraparte, estado y rango de fechas. Historial de estados y remitos.

Aceptación y rechazo

aceptarFECred con los opcionales del XSD (retenciones, ajustes, notas DC, CBU) y las reglas del manual entre ellos, y rechazarFECred con motivos. Si ARCA no acepta la operación, lanza ArcaRechazoError.

Cancelación y transferencia

informarCancelacionTotalFECred, modificarOpcionTransferencia y operaciones con Agentes de Depósito Colectivo.

Tablas de parámetros

Tipos de retenciones, formas de cancelación, motivos de rechazo y ajustes de operación.

Operaciones seguras

Las operaciones que cambian estado nunca se reintentan. Validación local según el XSD y el manual antes de pedir el ticket.

Instalá @ramiidv/arca-fecred

TypeScript nativo, Node.js 22.12+, sin librerías SOAP: las únicas dependencias externas son fast-xml-parser y node-forge (vía arca-common). Gratis, open source, MIT.