Facturación Electrónica

El servicio electronicBillingService permite la gestión completa de comprobantes electrónicos (Facturas, Notas de Crédito, Débito, etc.) a través del Web Service de Facturación Electrónica (WSFE).

Documentación Oficial

Manual del Desarrollador - ARCA (PDF)

Crear Comprobante (CAE)

El método principal para generar una factura y obtener el CAE.

Parámetros de `createVoucher`

Parámetro	Tipo	Descripción
`CantReg`	number	Cantidad de registros (normalmente `1`)
`PtoVta`	number	Punto de venta (1-9999)
`CbteTipo`	number	Tipo de comprobante (ver tabla)
`Concepto`	number	Tipo de concepto (ver tabla)
`DocTipo`	number	Tipo de documento del receptor (ver tabla)
`DocNro`	number	Nro de documento (`0` para Consumidor Final)
`CbteDesde`	number	Número de comprobante desde
`CbteHasta`	number	Número de comprobante hasta
`CbteFch`	string	Fecha en formato `YYYYMMDD`
`ImpTotal`	number	Importe total
`ImpNeto`	number	Importe neto gravado
`ImpIVA`	number	Importe IVA total
`ImpTotConc`	number	Importe no gravado
`ImpOpEx`	number	Importe operaciones exentas
`ImpTrib`	number	Importe de tributos
`MonId`	string	Moneda (`PES`, `DOL`, etc.)
`MonCotiz`	number	Cotización de la moneda
`Iva`	IVA[]	Alícuotas de IVA aplicadas
`Tributos`	Tributo[]	(opcional) Tributos adicionales
`CbtesAsoc`	CbteAsoc[]	(opcional) Comprobantes asociados (NC/ND)

Tipos de Comprobante (`CbteTipo`)

Código	Descripción
1	Factura A
2	Nota de Débito A
3	Nota de Crédito A
6	Factura B
7	Recibo B
8	Nota de Débito B
9	Nota de Crédito B
11	Factura C
12	Recibo C
13	Nota de Débito C
14	Nota de Crédito C
51	Factura M
81	Tique Factura A
82	Tique Factura B
83	Tique
91	Remito R
118	Tique Factura T
201	Factura de Crédito MiPyMEs (FCE) A
206	Factura de Crédito MiPyMEs (FCE) B
211	Factura de Crédito MiPyMEs (FCE) C

Tipos de Documento (`DocTipo`)

Código	Descripción
80	CUIT
86	CUIL
87	DNI
89	Libreta Cívica (LC)
90	Extranjeros
91	Pasaporte
92	Documento Mercosur
99	Consumidor Final

Conceptos (`Concepto`)

Código	Descripción
1	Productos
2	Servicios
3	Productos y Servicios

Códigos de Alícuota IVA (`Iva[].Id`)

ID	Tasa
3	0%
4	10.5%
5	21%
6	27%
7	5%
8	2.5%

Respuesta

{
  CAE: string; // Código de Autorización Electrónica
  CAEFchVto: string; // Vencimiento del CAE (YYYYMMDD)
  Resultado: "A" | "R" | "P"; // Aceptado, Rechazado, Parcial
  Reproceso: "S" | "N";
  PtoVta: number;
  CbteTipo: number;
}

Ejemplo Básico

const invoice = await arca.electronicBillingService.createVoucher({
  CantReg: 1,
  PtoVta: 1,
  CbteTipo: 6, // Factura B
  Concepto: 1, // Productos
  DocTipo: 99, // Consumidor Final
  DocNro: 0,
  CbteDesde: 1,
  CbteHasta: 1,
  CbteFch: "20240101", // String en formato YYYYMMDD
  ImpTotal: 121,
  ImpTotConc: 0,
  ImpNeto: 100,
  ImpOpEx: 0,
  ImpIVA: 21,
  ImpTrib: 0,
  MonId: "PES",
  MonCotiz: 1,
  Iva: [
    {
      Id: 5, // 21%
      BaseImp: 100,
      Importe: 21,
    },
  ],
});

Ver respuesta completa

json

{
  "CAE": "74154876254185",
  "CAEFchVto": "20240111",
  "Resultado": "A",
  "Reproceso": "N",
  "PtoVta": 1,
  "CbteTipo": 6
}

Siguiente Comprobante Automático

createNextVoucher combina getLastVoucher + createVoucher en un solo paso. No requiere CbteDesde ni CbteHasta.

const invoice = await arca.electronicBillingService.createNextVoucher({
  CantReg: 1,
  PtoVta: 1,
  CbteTipo: 6,
  Concepto: 1,
  DocTipo: 99,
  DocNro: 0,
  CbteFch: "20240501",
  ImpTotal: 121,
  ImpTotConc: 0,
  ImpNeto: 100,
  ImpOpEx: 0,
  ImpIVA: 21,
  ImpTrib: 0,
  MonId: "PES",
  MonCotiz: 1,
  Iva: [{ Id: 5, BaseImp: 100, Importe: 21 }],
});

Consultar Último Comprobante

Obtiene el número del último comprobante autorizado para un punto de venta y tipo específico.

const lastVoucher = await arca.electronicBillingService.getLastVoucher(1, 6);
console.log(`Último comprobante: ${lastVoucher}`);

Información de Comprobante

Recupera los datos de un comprobante ya emitido.

const voucherInfo = await arca.electronicBillingService.getVoucherInfo(1, 1, 6);
// getVoucherInfo(nroComprobante, puntoVenta, tipoComprobante)

if (voucherInfo) {
  console.log("Datos del comprobante:", voucherInfo);
} else {
  console.log("El comprobante no existe.");
}

Tablas de Referencia

Métodos auxiliares para obtener los códigos y tipos disponibles en ARCA.

const salesPoints = await arca.electronicBillingService.getSalesPoints();

const voucherTypes = await arca.electronicBillingService.getVoucherTypes();

const conceptTypes = await arca.electronicBillingService.getConceptTypes();

const documentTypes = await arca.electronicBillingService.getDocumentTypes();

const aliquotTypes = await arca.electronicBillingService.getAliquotTypes();

const currencies = await arca.electronicBillingService.getCurrenciesTypes();

const taxTypes = await arca.electronicBillingService.getTaxTypes();

Estado del Servidor

Verifica si los servicios de ARCA están operativos.

const status = await arca.electronicBillingService.getServerStatus();
console.log(status);

Facturación Electrónica ​

Crear Comprobante (CAE) ​

Parámetros de createVoucher ​

Tipos de Comprobante (CbteTipo) ​

Tipos de Documento (DocTipo) ​

Conceptos (Concepto) ​

Códigos de Alícuota IVA (Iva[].Id) ​

Respuesta ​

Ejemplo Básico ​

Siguiente Comprobante Automático ​

Consultar Último Comprobante ​

Información de Comprobante ​

Tablas de Referencia ​

Estado del Servidor ​