@ramiidv/arca-sdk 0.1.0 → 0.2.0

package/README.md

@@ -7,7 +7,7 @@ Soporta **todos los tipos de comprobante** de WSFEv1: Facturas, Notas de Débito
 ## Instalación
 
 ```bash
-npm install arca-sdk
+npm install @ramiidv/arca-sdk
 ```
 
 ## Requisitos
@@ -21,7 +21,7 @@ npm install arca-sdk
 
 ```typescript
 import fs from "fs";
-import { Arca, CbteTipo, Concepto, DocTipo, IvaTipo, Moneda } from "arca-sdk";
+import { Arca, CbteTipo, IvaTipo } from "@ramiidv/arca-sdk";
 
 const arca = new Arca({
   cuit: 20123456789,
@@ -30,158 +30,219 @@ const arca = new Arca({
   production: false, // true para producción
 });
 
-// Crear factura B para consumidor final (obtiene el número automáticamente)
-const result = await arca.crearFacturaAuto(1, CbteTipo.FACTURA_B, {
-  Concepto: Concepto.PRODUCTOS,
-  DocTipo: DocTipo.CONSUMIDOR_FINAL,
-  DocNro: 0,
-  CbteFch: Arca.formatDate(new Date()),
-  ImpTotal: 121,
-  ImpTotConc: 0,
-  ImpNeto: 100,
-  ImpOpEx: 0,
-  ImpTrib: 0,
-  ImpIVA: 21,
-  MonId: Moneda.PESOS,
-  MonCotiz: 1,
-  Iva: [{ Id: IvaTipo.IVA_21, BaseImp: 100, Importe: 21 }],
+// Crear factura B para consumidor final
+const result = await arca.facturar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_B,
+  items: [
+    { neto: 1000, iva: IvaTipo.IVA_21 },
+    { neto: 500, iva: IvaTipo.IVA_10_5 },
+  ],
 });
 
-const { approved, cae, caeFchVto } = Arca.extractCAE(result);
-console.log(approved ? `CAE: ${cae}` : "Rechazada");
+if (result.aprobada) {
+  console.log(`CAE: ${result.cae}`);
+  console.log(`Vencimiento: ${result.caeVencimiento}`);
+  console.log(`Comprobante #${result.cbteNro}`);
+  console.log(`Total: $${result.importes.total}`); // 1762.5
+}
 ```
 
-## Tipos de comprobante soportados
+El SDK calcula automáticamente: IVA, totales (neto, IVA, exento, no gravado, tributos), número de comprobante, fecha (timezone Argentina), y agrupa alícuotas de IVA.
 
-| Enum | Código | Descripción |
-| --- | --- | --- |
-| `FACTURA_A` | 1 | Factura A |
-| `NOTA_DEBITO_A` | 2 | Nota de Débito A |
-| `NOTA_CREDITO_A` | 3 | Nota de Crédito A |
-| `RECIBO_A` | 4 | Recibo A |
-| `FACTURA_B` | 6 | Factura B |
-| `NOTA_DEBITO_B` | 7 | Nota de Débito B |
-| `NOTA_CREDITO_B` | 8 | Nota de Crédito B |
-| `RECIBO_B` | 9 | Recibo B |
-| `FACTURA_C` | 11 | Factura C |
-| `NOTA_DEBITO_C` | 12 | Nota de Débito C |
-| `NOTA_CREDITO_C` | 13 | Nota de Crédito C |
-| `RECIBO_C` | 15 | Recibo C |
-| `FACTURA_E` | 19 | Factura de Exportación |
-| `NOTA_DEBITO_E` | 20 | Nota de Débito E |
-| `NOTA_CREDITO_E` | 21 | Nota de Crédito E |
-| `FACTURA_M` | 51 | Factura M |
-| `NOTA_DEBITO_M` | 52 | Nota de Débito M |
-| `NOTA_CREDITO_M` | 53 | Nota de Crédito M |
-| `RECIBO_M` | 54 | Recibo M |
-| `FCE_FACTURA_A` | 201 | Factura de Crédito Electrónica MiPyME A |
-| `FCE_NOTA_DEBITO_A` | 202 | Nota de Débito FCE MiPyME A |
-| `FCE_NOTA_CREDITO_A` | 203 | Nota de Crédito FCE MiPyME A |
-| `FCE_FACTURA_B` | 206 | Factura de Crédito Electrónica MiPyME B |
-| `FCE_NOTA_DEBITO_B` | 207 | Nota de Débito FCE MiPyME B |
-| `FCE_NOTA_CREDITO_B` | 208 | Nota de Crédito FCE MiPyME B |
-| `FCE_FACTURA_C` | 211 | Factura de Crédito Electrónica MiPyME C |
-| `FCE_NOTA_DEBITO_C` | 212 | Nota de Débito FCE MiPyME C |
-| `FCE_NOTA_CREDITO_C` | 213 | Nota de Crédito FCE MiPyME C |
+## Configuración
 
-Tambien se incluyen tipos especiales: `COMPRA_BIENES_USADOS` (49), `CTA_VTA_LIQ_PROD_A/B` (60/61), `LIQUIDACION_A/B` (63/64), y comprobantes RG 1415 (34, 35, 39, 40).
+```typescript
+const arca = new Arca({
+  cuit: 20123456789,          // CUIT sin guiones
+  cert: "...",                 // Certificado X.509 (PEM)
+  key: "...",                  // Clave privada (PEM)
+  production: false,           // Default: false (testing/homologación)
+  tokenTTLMinutes: 720,        // Default: 720 (12 horas)
+  requestTimeoutMs: 30_000,    // Default: 30000 (30 segundos)
+});
+```
 
 ## Ejemplos
 
-### Factura A por servicios
-
-Para servicios (`Concepto.SERVICIOS` o `Concepto.PRODUCTOS_Y_SERVICIOS`), es obligatorio incluir las fechas de servicio y vencimiento de pago.
+### Factura B — Consumidor final (caso más común)
 
 ```typescript
-const result = await arca.crearFacturaAuto(1, CbteTipo.FACTURA_A, {
-  Concepto: Concepto.SERVICIOS,
-  DocTipo: DocTipo.CUIT,
-  DocNro: 30712345678,
-  CbteFch: Arca.formatDate(new Date()),
-  ImpTotal: 60500,
-  ImpTotConc: 0,
-  ImpNeto: 50000,
-  ImpOpEx: 0,
-  ImpTrib: 0,
-  ImpIVA: 10500,
-  MonId: Moneda.PESOS,
-  MonCotiz: 1,
-  FchServDesde: "20260301",
-  FchServHasta: "20260331",
-  FchVtoPago: "20260415",
-  Iva: [{ Id: IvaTipo.IVA_21, BaseImp: 50000, Importe: 10500 }],
+const result = await arca.facturar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_B,
+  items: [{ neto: 100, iva: IvaTipo.IVA_21 }],
+  // DocTipo, DocNro, fecha, moneda, concepto → se completan automáticamente
 });
+// result.importes.total === 121
 ```
 
-### Nota de crédito
+### Factura A — Servicios a otra empresa
 
 ```typescript
-const result = await arca.crearFacturaAuto(1, CbteTipo.NOTA_CREDITO_B, {
-  Concepto: Concepto.PRODUCTOS,
-  DocTipo: DocTipo.CONSUMIDOR_FINAL,
-  DocNro: 0,
-  CbteFch: Arca.formatDate(new Date()),
-  ImpTotal: 121,
-  ImpTotConc: 0,
-  ImpNeto: 100,
-  ImpOpEx: 0,
-  ImpTrib: 0,
-  ImpIVA: 21,
-  MonId: Moneda.PESOS,
-  MonCotiz: 1,
-  Iva: [{ Id: IvaTipo.IVA_21, BaseImp: 100, Importe: 21 }],
-  // Asociar con la factura original
-  CbtesAsoc: [{ Tipo: CbteTipo.FACTURA_B, PtoVta: 1, Nro: 150 }],
+const result = await arca.facturar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_A,
+  docTipo: DocTipo.CUIT,
+  docNro: 30712345678,
+  items: [{ neto: 50000, iva: IvaTipo.IVA_21 }],
+  servicio: {
+    desde: new Date("2026-03-01"),
+    hasta: new Date("2026-03-31"),
+    vtoPago: new Date("2026-04-15"),
+  },
+  // concepto se auto-detecta como SERVICIOS al proveer `servicio`
 });
 ```
 
 ### Factura con múltiples alícuotas de IVA
 
 ```typescript
-const result = await arca.crearFacturaAuto(1, CbteTipo.FACTURA_A, {
-  Concepto: Concepto.PRODUCTOS,
-  DocTipo: DocTipo.CUIT,
-  DocNro: 30712345678,
-  CbteFch: Arca.formatDate(new Date()),
-  ImpTotal: 1352.5,
-  ImpTotConc: 0,
-  ImpNeto: 1100, // 1000 + 100
-  ImpOpEx: 0,
-  ImpTrib: 0,
-  ImpIVA: 252.5, // 210 + 42.5 (nota: no incluye el IVA 0%)
-  MonId: Moneda.PESOS,
-  MonCotiz: 1,
-  Iva: [
-    { Id: IvaTipo.IVA_21, BaseImp: 1000, Importe: 210 },
-    { Id: IvaTipo.IVA_10_5, BaseImp: 100, Importe: 10.5 },
-    // Para incluir items al 0%, se debe declarar también:
-    // { Id: IvaTipo.IVA_0, BaseImp: 500, Importe: 0 },
+const result = await arca.facturar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_A,
+  docTipo: DocTipo.CUIT,
+  docNro: 30712345678,
+  items: [
+    { neto: 1000, iva: IvaTipo.IVA_21 },   // IVA: 210
+    { neto: 500, iva: IvaTipo.IVA_10_5 },   // IVA: 52.5
+    { neto: 200, iva: IvaTipo.IVA_0 },      // IVA: 0 (gravado al 0%)
+    { neto: 300, exento: true },             // Exento (ImpOpEx)
+    { neto: 150 },                           // No gravado (ImpTotConc)
   ],
 });
+// result.importes:
+//   neto: 1700, iva: 262.5, exento: 300, noGravado: 150, total: 2412.5
+```
+
+### Factura C — Monotributista
+
+Para comprobantes tipo C, el SDK no discrimina IVA automáticamente.
+
+```typescript
+const result = await arca.facturar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_C,
+  items: [{ neto: 5000 }],
+});
+// ImpNeto: 5000, ImpIVA: 0, ImpTotal: 5000
+```
+
+### Nota de crédito
+
+El tipo de NC se infiere automáticamente del comprobante original (FACTURA_B → NOTA_CREDITO_B).
+
+```typescript
+const result = await arca.notaCredito({
+  ptoVta: 1,
+  comprobanteOriginal: {
+    tipo: CbteTipo.FACTURA_B,
+    ptoVta: 1,
+    nro: 150,
+  },
+  items: [{ neto: 100, iva: IvaTipo.IVA_21 }],
+});
+```
+
+### Nota de débito
+
+```typescript
+const result = await arca.notaDebito({
+  ptoVta: 1,
+  comprobanteOriginal: {
+    tipo: CbteTipo.FACTURA_A,
+    ptoVta: 1,
+    nro: 200,
+    fecha: "20260301",
+  },
+  docTipo: DocTipo.CUIT,
+  docNro: 30712345678,
+  items: [{ neto: 500, iva: IvaTipo.IVA_21 }],
+});
 ```
 
 ### Factura MiPyME (FCE)
 
 ```typescript
-const result = await arca.crearFacturaAuto(1, CbteTipo.FCE_FACTURA_A, {
-  Concepto: Concepto.PRODUCTOS,
-  DocTipo: DocTipo.CUIT,
-  DocNro: 30712345678,
-  CbteFch: Arca.formatDate(new Date()),
-  ImpTotal: 121000,
-  ImpTotConc: 0,
-  ImpNeto: 100000,
-  ImpOpEx: 0,
-  ImpTrib: 0,
-  ImpIVA: 21000,
-  MonId: Moneda.PESOS,
-  MonCotiz: 1,
-  Iva: [{ Id: IvaTipo.IVA_21, BaseImp: 100000, Importe: 21000 }],
-  // Dato obligatorio para FCE: CBU del emisor
-  Opcionales: [{ Id: "2101", Valor: "0110012345678901234567" }],
+const result = await arca.facturar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FCE_FACTURA_A,
+  docTipo: DocTipo.CUIT,
+  docNro: 30712345678,
+  items: [{ neto: 100000, iva: IvaTipo.IVA_21 }],
+  opcionales: [{ Id: "2101", Valor: "0110012345678901234567" }], // CBU obligatorio
+});
+```
+
+### Previsualizar totales sin enviar
+
+```typescript
+const { importes, iva } = Arca.calcularTotales([
+  { neto: 1000, iva: IvaTipo.IVA_21 },
+  { neto: 500, iva: IvaTipo.IVA_10_5 },
+]);
+console.log(importes);
+// { total: 1762.5, neto: 1500, iva: 262.5, exento: 0, noGravado: 0, tributos: 0 }
+```
+
+### Factura en moneda extranjera
+
+```typescript
+const cotiz = await arca.getCotizacion(Moneda.DOLARES);
+
+const result = await arca.facturar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_A,
+  docTipo: DocTipo.CUIT,
+  docNro: 30712345678,
+  items: [{ neto: 1000, iva: IvaTipo.IVA_21 }],
+  moneda: Moneda.DOLARES,
+  cotizacion: cotiz.MonCotiz,
 });
 ```
 
+## Manejo de errores
+
+El SDK provee clases de error específicas para catch granular:
+
+```typescript
+import {
+  Arca,
+  ArcaAuthError,
+  ArcaWSFEError,
+  ArcaSoapError,
+} from "@ramiidv/arca-sdk";
+
+try {
+  const result = await arca.facturar({ ... });
+} catch (e) {
+  if (e instanceof ArcaAuthError) {
+    // Error de autenticación WSAA (certificado inválido, expirado, etc.)
+    console.error("Auth error:", e.message);
+    arca.clearAuthCache(); // Limpiar cache e intentar de nuevo
+  }
+
+  if (e instanceof ArcaWSFEError) {
+    // Error de WSFE con códigos de ARCA
+    for (const err of e.errors) {
+      console.error(`[${err.code}] ${err.msg}`);
+    }
+  }
+
+  if (e instanceof ArcaSoapError) {
+    // Error HTTP/SOAP (timeout, servidor caído, etc.)
+    console.error("HTTP status:", e.statusCode);
+  }
+}
+```
+
+| Clase | Cuándo se lanza |
+| --- | --- |
+| `ArcaAuthError` | Falla en login WSAA, respuesta inesperada, token/sign inválidos |
+| `ArcaWSFEError` | Error devuelto por WSFE (campos inválidos, CUIT no autorizado, etc.). Contiene `errors: { code, msg }[]` |
+| `ArcaSoapError` | Error HTTP, timeout, SOAP Fault. Contiene `statusCode?: number` |
+| `ArcaError` | Clase base para todos los errores del SDK |
+
 ## Consultas
 
 ```typescript
@@ -200,32 +261,46 @@ const ptosVenta = await arca.getPuntosVenta();
 // Cotización del dólar
 const cotiz = await arca.getCotizacion(Moneda.DOLARES);
 
-// Tipos de comprobante, documento, IVA, monedas, tributos
+// Tipos disponibles
 const tiposCbte = await arca.getTiposComprobante();
+const tiposConcepto = await arca.getTiposConcepto();
 const tiposDoc = await arca.getTiposDocumento();
 const tiposIva = await arca.getTiposIva();
 const monedas = await arca.getMonedas();
 const tiposTrib = await arca.getTiposTributo();
+const tiposOpc = await arca.getTiposOpcional();
+const maxRegs = await arca.getCantMaxRegistros();
 ```
 
 ## API
 
 ### `new Arca(config)`
 
-| Parámetro | Tipo | Descripción |
-| --- | --- | --- |
-| `cuit` | `number` | CUIT del contribuyente (sin guiones) |
-| `cert` | `string` | Contenido del certificado X.509 (PEM) |
-| `key` | `string` | Contenido de la clave privada (PEM) |
-| `production` | `boolean` | `false` = testing (default), `true` = producción |
-| `tokenTTLMinutes` | `number` | TTL del token en minutos (default: 720 = 12h) |
+| Parámetro | Tipo | Default | Descripción |
+| --- | --- | --- | --- |
+| `cuit` | `number` | — | CUIT del contribuyente (sin guiones) |
+| `cert` | `string` | — | Contenido del certificado X.509 (PEM) |
+| `key` | `string` | — | Contenido de la clave privada (PEM) |
+| `production` | `boolean` | `false` | Entorno de producción |
+| `tokenTTLMinutes` | `number` | `720` | TTL del token en minutos |
+| `requestTimeoutMs` | `number` | `30000` | Timeout HTTP en milisegundos |
+
+### Facturación — API simplificada
+
+| Método | Descripción |
+| --- | --- |
+| `facturar(opts)` | Crea un comprobante con cálculo automático de IVA y totales |
+| `notaCredito(opts)` | Crea nota de crédito asociada (tipo NC inferido automáticamente) |
+| `notaDebito(opts)` | Crea nota de débito asociada (tipo ND inferido automáticamente) |
 
-### Facturación
+Retornan `FacturaResult` con: `aprobada`, `cae`, `caeVencimiento`, `cbteNro`, `importes`, `observaciones`, `raw`.
+
+### Facturación — API raw
 
 | Método | Descripción |
 | --- | --- |
-| `crearFactura(request)` | Solicita CAE para uno o más comprobantes |
-| `crearFacturaAuto(ptoVta, cbteTipo, invoice)` | Obtiene el número automáticamente y crea la factura |
+| `crearFactura(request)` | Solicita CAE para uno o más comprobantes (sin auto-cálculo) |
+| `crearFacturaAuto(ptoVta, cbteTipo, invoice)` | Como `crearFactura` pero obtiene el número automáticamente |
 | `ultimoComprobante(ptoVta, cbteTipo)` | Último número autorizado |
 | `siguienteComprobante(ptoVta, cbteTipo)` | Siguiente número (último + 1) |
 | `consultarComprobante(cbteTipo, ptoVta, cbteNro)` | Consulta un comprobante existente |
@@ -236,6 +311,7 @@ const tiposTrib = await arca.getTiposTributo();
 | --- | --- |
 | `serverStatus()` | Estado de los servidores |
 | `getTiposComprobante()` | Lista de tipos de comprobante |
+| `getTiposConcepto()` | Lista de tipos de concepto |
 | `getTiposDocumento()` | Lista de tipos de documento |
 | `getTiposIva()` | Lista de alícuotas de IVA |
 | `getMonedas()` | Lista de monedas |
@@ -249,17 +325,56 @@ const tiposTrib = await arca.getTiposTributo();
 
 | Método | Descripción |
 | --- | --- |
-| `Arca.extractCAE(result)` | Extrae CAE y estado del resultado |
-| `Arca.formatDate(date)` | Formatea `Date` a `YYYYMMDD` |
+| `Arca.calcularTotales(items, opts?)` | Calcula importes e IVA sin enviar a ARCA |
+| `Arca.extractCAE(result)` | Extrae CAE del resultado raw |
+| `Arca.formatDate(date)` | Formatea `Date` a `YYYYMMDD` (timezone Argentina) |
+
+## Tipos de comprobante soportados
+
+| Enum | Código | Descripción |
+| --- | --- | --- |
+| `FACTURA_A` | 1 | Factura A |
+| `NOTA_DEBITO_A` | 2 | Nota de Débito A |
+| `NOTA_CREDITO_A` | 3 | Nota de Crédito A |
+| `RECIBO_A` | 4 | Recibo A |
+| `FACTURA_B` | 6 | Factura B |
+| `NOTA_DEBITO_B` | 7 | Nota de Débito B |
+| `NOTA_CREDITO_B` | 8 | Nota de Crédito B |
+| `RECIBO_B` | 9 | Recibo B |
+| `FACTURA_C` | 11 | Factura C |
+| `NOTA_DEBITO_C` | 12 | Nota de Débito C |
+| `NOTA_CREDITO_C` | 13 | Nota de Crédito C |
+| `RECIBO_C` | 15 | Recibo C |
+| `FACTURA_E` | 19 | Factura de Exportación |
+| `NOTA_DEBITO_E` | 20 | Nota de Débito E |
+| `NOTA_CREDITO_E` | 21 | Nota de Crédito E |
+| `FACTURA_M` | 51 | Factura M |
+| `NOTA_DEBITO_M` | 52 | Nota de Débito M |
+| `NOTA_CREDITO_M` | 53 | Nota de Crédito M |
+| `RECIBO_M` | 54 | Recibo M |
+| `FCE_FACTURA_A` | 201 | Factura de Crédito Electrónica MiPyME A |
+| `FCE_NOTA_DEBITO_A` | 202 | Nota de Débito FCE MiPyME A |
+| `FCE_NOTA_CREDITO_A` | 203 | Nota de Crédito FCE MiPyME A |
+| `FCE_FACTURA_B` | 206 | Factura de Crédito Electrónica MiPyME B |
+| `FCE_NOTA_DEBITO_B` | 207 | Nota de Débito FCE MiPyME B |
+| `FCE_NOTA_CREDITO_B` | 208 | Nota de Crédito FCE MiPyME B |
+| `FCE_FACTURA_C` | 211 | Factura de Crédito Electrónica MiPyME C |
+| `FCE_NOTA_DEBITO_C` | 212 | Nota de Débito FCE MiPyME C |
+| `FCE_NOTA_CREDITO_C` | 213 | Nota de Crédito FCE MiPyME C |
+
+Tambien se incluyen tipos especiales: `COMPRA_BIENES_USADOS` (49), `CTA_VTA_LIQ_PROD_A/B` (60/61), `LIQUIDACION_A/B` (63/64), y comprobantes RG 1415 (34, 35, 39, 40).
 
 ## Enums disponibles
 
 - `CbteTipo` — Tipos de comprobante
 - `Concepto` — Tipos de concepto (Productos, Servicios, Ambos)
-- `DocTipo` — Tipos de documento (CUIT, DNI, etc.)
+- `DocTipo` — Tipos de documento (CUIT, DNI, Consumidor Final, etc.)
 - `IvaTipo` — Alícuotas de IVA (0%, 2.5%, 5%, 10.5%, 21%, 27%)
+- `IVA_RATES` — Record que mapea IvaTipo a su porcentaje numérico
 - `Moneda` — Códigos de moneda (PES, DOL, EUR, etc.)
 - `TributoTipo` — Tipos de tributo
+- `NOTA_CREDITO_MAP` — Mapeo de tipo factura → tipo nota de crédito
+- `NOTA_DEBITO_MAP` — Mapeo de tipo factura → tipo nota de débito
 
 ## Entornos
 

package/dist/arca.d.ts

@@ -1,4 +1,4 @@
-import type { ArcaConfig, InvoiceRequest, InvoiceDetail, FECAESolicitarResult, FECAEDetResponse, FECompConsultarResult, ServerStatus, ParamItem, MonedaItem, PtoVentaItem, CotizacionResult } from "./types.js";
+import type { ArcaConfig, InvoiceRequest, InvoiceDetail, FECAESolicitarResult, FECAEDetResponse, FECompConsultarResult, ServerStatus, ParamItem, MonedaItem, PtoVentaItem, CotizacionResult, FacturarOpts, NotaCreditoOpts, NotaDebitoOpts, FacturaResult, LineItem, Importes } from "./types.js";
 export declare class Arca {
     private wsaa;
     private wsfe;
@@ -52,6 +52,67 @@ export declare class Arca {
      * Simplifica el flujo más común: obtener número → crear factura.
      */
     crearFacturaAuto(ptoVta: number, cbteTipo: number, invoice: Omit<InvoiceDetail, "CbteDesde" | "CbteHasta">): Promise<FECAESolicitarResult>;
+    /**
+     * Crea una factura con API simplificada.
+     * Calcula automáticamente IVA, totales, y número de comprobante.
+     *
+     * @example
+     * ```ts
+     * const result = await arca.facturar({
+     *   ptoVta: 1,
+     *   cbteTipo: CbteTipo.FACTURA_B,
+     *   items: [
+     *     { neto: 1000, iva: IvaTipo.IVA_21 },
+     *     { neto: 500, iva: IvaTipo.IVA_10_5 },
+     *   ],
+     * });
+     *
+     * if (result.aprobada) {
+     *   console.log(`CAE: ${result.cae}, Cbte: ${result.cbteNro}`);
+     * }
+     * ```
+     */
+    facturar(opts: FacturarOpts): Promise<FacturaResult>;
+    /**
+     * Crea una nota de crédito asociada a un comprobante original.
+     * El tipo de NC se infiere automáticamente del tipo del comprobante original.
+     *
+     * @example
+     * ```ts
+     * const result = await arca.notaCredito({
+     *   ptoVta: 1,
+     *   comprobanteOriginal: {
+     *     tipo: CbteTipo.FACTURA_B,
+     *     ptoVta: 1,
+     *     nro: 5,
+     *   },
+     *   items: [{ neto: 500, iva: IvaTipo.IVA_21 }],
+     * });
+     * ```
+     */
+    notaCredito(opts: NotaCreditoOpts): Promise<FacturaResult>;
+    /**
+     * Crea una nota de débito asociada a un comprobante original.
+     * El tipo de ND se infiere automáticamente del tipo del comprobante original.
+     *
+     * @example
+     * ```ts
+     * const result = await arca.notaDebito({
+     *   ptoVta: 1,
+     *   comprobanteOriginal: {
+     *     tipo: CbteTipo.FACTURA_A,
+     *     ptoVta: 1,
+     *     nro: 10,
+     *     fecha: "20260301",
+     *   },
+     *   docTipo: DocTipo.CUIT,
+     *   docNro: 20123456789,
+     *   items: [{ neto: 200, iva: IvaTipo.IVA_21 }],
+     * });
+     * ```
+     */
+    notaDebito(opts: NotaDebitoOpts): Promise<FacturaResult>;
+    private facturarConAsociado;
     /**
      * Consulta un comprobante previamente autorizado.
      */
@@ -63,6 +124,8 @@ export declare class Arca {
     serverStatus(): Promise<ServerStatus>;
     /** Obtiene los tipos de comprobante disponibles. */
     getTiposComprobante(): Promise<ParamItem[]>;
+    /** Obtiene los tipos de concepto disponibles (Productos, Servicios, Productos y Servicios). */
+    getTiposConcepto(): Promise<ParamItem[]>;
     /** Obtiene los tipos de documento disponibles. */
     getTiposDocumento(): Promise<ParamItem[]>;
     /** Obtiene los tipos de IVA disponibles. */
@@ -91,8 +154,31 @@ export declare class Arca {
     };
     /**
      * Formatea una fecha Date a formato YYYYMMDD requerido por ARCA.
+     * Usa timezone America/Argentina/Buenos_Aires.
      */
-    static formatDate(date: Date): string;
+    static formatDate(date: Date | string): string;
+    /**
+     * Calcula los importes de una factura a partir de line items.
+     * Útil para previsualizar totales antes de enviar a ARCA.
+     *
+     * @example
+     * ```ts
+     * const { importes } = Arca.calcularTotales([
+     *   { neto: 1000, iva: IvaTipo.IVA_21 },
+     *   { neto: 500, iva: IvaTipo.IVA_10_5 },
+     * ]);
+     * console.log(importes.total); // 1762.5
+     * ```
+     */
+    static calcularTotales(items: LineItem[], opts?: {
+        tributos?: {
+            Importe: number;
+        }[];
+        tipoC?: boolean;
+    }): {
+        importes: Importes;
+        iva: import("./types.js").AlicuotaIva[];
+    };
     /**
      * Invalida los tickets de acceso cacheados.
      */

package/dist/arca.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arca.d.ts","sourceRoot":"","sources":["../src/arca.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB,qBAAa,IAAI;IACf,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAU;gBAEhB,MAAM,EAAE,UAAU;IAkB9B;;OAEG;YACW,OAAO;IAarB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAK1E;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAKlB;;;OAGG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,GACtD,OAAO,CAAC,oBAAoB,CAAC;IAgBhC;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IASjC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAI3C,oDAAoD;IAC9C,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjD,kDAAkD;IAC5C,iBAAiB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK/C,4CAA4C;IACtC,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKzC,uCAAuC;IACjC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKzC,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK7C,yDAAyD;IACnD,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK9C,+CAA+C;IACzC,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK/C,2CAA2C;IACrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKhE,2DAA2D;IACrD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAS5C;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG;QAC/C,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAgBD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAOrC;;OAEG;IACH,cAAc,IAAI,IAAI;CAGvB"}
+{"version":3,"file":"arca.d.ts","sourceRoot":"","sources":["../src/arca.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,QAAQ,EACT,MAAM,YAAY,CAAC;AAWpB,qBAAa,IAAI;IACf,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAU;gBAEhB,MAAM,EAAE,UAAU;IAoB9B;;OAEG;YACW,OAAO;IAarB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAK1E;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAKlB;;;OAGG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,GACtD,OAAO,CAAC,oBAAoB,CAAC;IAoBhC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAa1D;;;;;;;;;;;;;;;;OAgBG;IACG,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAUhE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAUhD,mBAAmB;IAiCjC;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IASjC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAI3C,oDAAoD;IAC9C,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjD,+FAA+F;IACzF,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK9C,kDAAkD;IAC5C,iBAAiB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK/C,4CAA4C;IACtC,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKzC,uCAAuC;IACjC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKzC,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK7C,yDAAyD;IACnD,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK9C,+CAA+C;IACzC,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK/C,2CAA2C;IACrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKhE,2DAA2D;IACrD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAS5C;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG;QAC/C,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAgBD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM;IAI9C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;;;;IAK9D;;OAEG;IACH,cAAc,IAAI,IAAI;CAGvB"}