facturahub-arca

Factura electrónica ARCA (ex AFIP) por API, en dos llamadas. Emití comprobantes con CAE y QR — Factura A, B o Factura C de monotributo — desde Node.js, sin pelearte con los web services de ARCA ni con certificados a mano.

Cliente TypeScript de la API de FacturaHub: la plataforma gratis de facturación con IA para monotributistas, freelancers y comercios en Argentina.

Instalación

npm install facturahub-arca

Uso

import { FacturaHubArca } from 'facturahub-arca';

const fh = new FacturaHubArca({ apiKey: process.env.FACTURAHUB_API_KEY! });

// 1) Crear la factura (Factura C de monotributo por defecto)
const invoice = await fh.createInvoice({
  clientName: 'Acme SRL',
  clientTaxId: '30-11222333-9', // CUIT — o DNI, o nada (consumidor final)
  items: [{ description: 'Desarrollo web', quantity: 1, unitPrice: 250000 }],
  currency: 'ARS', // o 'USD' para clientes del exterior
});

// 2) Emitirla en ARCA → CAE + QR + PDF fiscal
const result = await fh.emit(invoice._id);
console.log(result.fiscalId);  // CAE (o id del comprobante simulado en demo)
console.log(result.qrData);    // URL del QR de AFIP
console.log(result.pdfUrl);    // PDF fiscal (A4)

Factura A / B (Responsable Inscripto, con IVA)

await fh.createInvoice({
  clientName: 'Distribuidora Norte SA',
  clientTaxId: '30-55666777-8',
  items: [{ description: 'Consultoría', quantity: 10, unitPrice: 50000 }],
  invoiceType: 'factura_a',
  taxRate: 21, // IVA 21% (también 10.5 o 27)
});

Modo demo (sin riesgo)

Tu cuenta arranca en modo de prueba: los comprobantes salen en estado simulado — recorren el flujo completo (cliente, ítems, PDF) sin validez fiscal, para que integres y pruebes tranquilo. Cuando estés listo, activamos tu producción (CUIT, certificado digital y punto de venta) y los comprobantes salen con CAE real de ARCA.

Qué resuelve

• CAE automático: FacturaHub pide la autorización a ARCA al emitir. Sin clave fiscal, sin SOAP.
• Tipos de comprobante: Factura A, B y C; las notas de crédito se emiten referenciando el comprobante original (ARCA no permite anular).
• Idempotencia: reemitir la misma factura no duplica comprobantes.
• Reintentos: si ARCA se cae, el comprobante en error se puede reintentar.
• Pesos y dólares: emití en ARS o USD según el cliente.

Obtener tu API key

1. Creá tu cuenta gratis en facturahub.com (sin tarjeta).
2. En Ajustes → API copiá tu API key.
3. Listo — el plan gratuito incluye facturas ilimitadas.

Más

• Factura electrónica ARCA — guía
• Facturación para monotributistas
• ¿Qué es el CAE?

MIT © FacturaHub