@ramiidv/arca-mtxca 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,211 @@
+export type { AccessTicket, ArcaEvent, ServerStatus, SoapCallOptions } from '@ramiidv/arca-common';
+import type { ArcaEvent } from '@ramiidv/arca-common';
+export interface ArcaMtxcaConfig {
+    /** Contenido del certificado X.509 en formato PEM */
+    cert: string;
+    /** Contenido de la clave privada en formato PEM */
+    key: string;
+    /** CUIT del contribuyente (sin guiones) */
+    cuit: number;
+    /** Usar entorno de produccion (default: false = testing/homologacion) */
+    production?: boolean;
+    /** Timeout para requests HTTP en milisegundos (default: 30000) */
+    timeout?: number;
+    /** Cantidad de reintentos en caso de error transitorio (default: 1) */
+    retries?: number;
+    /** Delay inicial entre reintentos en milisegundos, se duplica con cada intento (default: 1000) */
+    retryDelayMs?: number;
+    /** Callback para eventos del SDK (auth, requests, retries) */
+    onEvent?: (event: ArcaEvent) => void;
+}
+export interface MtxcaAuth {
+    Token: string;
+    Sign: string;
+    Cuit: number;
+}
+export interface MtxcaItem {
+    /** Codigo/Barcode del producto (EAN, interno, etc.) */
+    codigo?: string;
+    /** Descripcion del producto/servicio */
+    descripcion: string;
+    /** Cantidad */
+    cantidad: number;
+    /** Codigo de unidad de medida (consultarUnidadesMedida) */
+    unidadMedida: number;
+    /** Precio unitario */
+    precioUnitario: number;
+    /** Importe total del item (cantidad * precioUnitario - bonificacion) */
+    importeItem: number;
+    /** Codigo de condicion de IVA del item (usar enum CodigoCondicionIVA) */
+    codigoCondicionIVA: number;
+    /** Importe de IVA del item */
+    importeIVA: number;
+    /** Importe de bonificacion/descuento. Default: 0 */
+    importeBonificacion?: number;
+}
+export interface SubtotalIVA {
+    /** Codigo de condicion de IVA */
+    codigo: number;
+    /** Base imponible */
+    baseImponible: number;
+    /** Importe de IVA */
+    importe: number;
+}
+export interface MtxcaComprobanteAsociado {
+    /** Tipo de comprobante asociado */
+    codigoTipoComprobante: number;
+    /** Punto de venta del comprobante asociado */
+    numeroPuntoVenta: number;
+    /** Numero de comprobante asociado */
+    numeroComprobante: number;
+    /** CUIT del emisor */
+    cuit?: number;
+}
+export interface MtxcaTributo {
+    /** Codigo del tributo */
+    codigoTributo: number;
+    /** Descripcion del tributo */
+    descripcion?: string;
+    /** Base imponible */
+    baseImponible: number;
+    /** Alicuota del tributo */
+    alicuota?: number;
+    /** Importe del tributo */
+    importe: number;
+}
+export interface MtxcaInvoice {
+    /** Concepto: 1=Productos, 2=Servicios, 3=Productos y Servicios */
+    concepto: number;
+    /** Tipo de documento del receptor */
+    docTipo: number;
+    /** Numero de documento del receptor */
+    docNro: number;
+    /** Fecha del comprobante (formato YYYY-MM-DD) */
+    cbteFch: string;
+    /** Items / articulos del comprobante */
+    items: MtxcaItem[];
+    /** Codigo de moneda (usar enum Moneda). Default: PES */
+    codigoMoneda?: string;
+    /** Cotizacion de la moneda (1 para pesos) */
+    cotizacionMoneda?: number;
+    /** Importe gravado */
+    importeGravado?: number;
+    /** Importe no gravado */
+    importeNoGravado?: number;
+    /** Importe exento */
+    importeExento?: number;
+    /** Subtotales de IVA */
+    subtotalesIVA?: SubtotalIVA[];
+    /** Importe total de tributos */
+    importeOtrosTributos?: number;
+    /** Detalle de tributos */
+    otrosTributos?: MtxcaTributo[];
+    /** Importe total del comprobante */
+    importeTotal: number;
+    /** Comprobantes asociados (para NC/ND) */
+    comprobanteAsociado?: MtxcaComprobanteAsociado[];
+    /** Fecha desde del servicio (formato YYYY-MM-DD, requerido para servicios) */
+    fechaDesde?: string;
+    /** Fecha hasta del servicio (formato YYYY-MM-DD, requerido para servicios) */
+    fechaHasta?: string;
+    /** Fecha de vencimiento de pago (formato YYYY-MM-DD, requerido para servicios) */
+    fechaVtoPago?: string;
+    /** Observaciones */
+    observaciones?: string;
+}
+export interface MtxcaObservacion {
+    code: number;
+    msg: string;
+}
+export interface MtxcaInvoiceResult {
+    /** Resultado: "A" = Aprobado, "R" = Rechazado */
+    resultado: string;
+    /** CAE otorgado (solo si aprobado) */
+    cae?: string;
+    /** Fecha de vencimiento del CAE (YYYY-MM-DD) */
+    caeFchVto?: string;
+    /** Numero de comprobante asignado */
+    cbteNro: number;
+    /** Observaciones de ARCA */
+    observaciones: MtxcaObservacion[];
+    /** Errores de ARCA */
+    errores: MtxcaObservacion[];
+}
+export interface AutorizarRequest {
+    /** Punto de venta */
+    ptoVta: number;
+    /** Tipo de comprobante (usar enum CbteTipo) */
+    cbteTipo: number;
+    /** Detalle del comprobante con articulos */
+    invoice: MtxcaInvoice;
+}
+export interface MtxcaComprobante {
+    codigoTipoComprobante: number;
+    numeroPuntoVenta: number;
+    numeroComprobante: number;
+    fechaEmision: string;
+    codigoTipoDocumento: number;
+    numeroDocumento: number;
+    importeTotal: number;
+    importeNoGravado: number;
+    importeGravado: number;
+    importeExento: number;
+    importeOtrosTributos: number;
+    importeSubtotal: number;
+    codigoMoneda: string;
+    cotizacionMoneda: number;
+    resultado: string;
+    codigoAutorizacion?: string;
+    fechaVencimiento?: string;
+    observaciones: MtxcaObservacion[];
+    items: MtxcaItem[];
+}
+export interface ParamItem {
+    /** ID numerico del parametro */
+    Id: number;
+    /** Descripcion */
+    Desc: string;
+    /** Fecha vigencia desde */
+    FchDesde?: string;
+    /** Fecha vigencia hasta */
+    FchHasta?: string;
+}
+export interface MonedaItem {
+    /** Codigo de moneda (ej: "PES", "DOL") */
+    Id: string;
+    /** Descripcion */
+    Desc: string;
+    /** Fecha vigencia desde */
+    FchDesde?: string;
+    /** Fecha vigencia hasta */
+    FchHasta?: string;
+}
+export interface UnidadMedidaItem {
+    /** Codigo de unidad de medida */
+    Id: number;
+    /** Descripcion */
+    Desc: string;
+    /** Fecha vigencia desde */
+    FchDesde?: string;
+    /** Fecha vigencia hasta */
+    FchHasta?: string;
+}
+export interface PtoVentaItem {
+    /** Numero de punto de venta */
+    Nro: number;
+    /** Tipo de emision (CAE/CAEA) */
+    EmisionTipo: string;
+    /** Si esta bloqueado */
+    Bloqueado: string;
+    /** Fecha de baja */
+    FchBaja: string;
+}
+export interface CotizacionResult {
+    /** Codigo de moneda */
+    monedaId: string;
+    /** Cotizacion */
+    cotizacion: number;
+    /** Fecha de cotizacion */
+    fechaCotizacion: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,14 @@
+import type { AutorizarRequest, MtxcaItem } from './types.js';
+/**
+ * Validates a single MTXCA item (line-level detail).
+ *
+ * @throws ArcaValidationError if any field is invalid
+ */
+export declare function validateMtxcaItem(item: MtxcaItem, index?: number): void;
+/**
+ * Validates the full autorizar request (ptoVta, cbteTipo, invoice fields, and items).
+ *
+ * @throws ArcaValidationError if any field is invalid
+ */
+export declare function validateAutorizarRequest(request: AutorizarRequest): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CA0CvE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA2ExE"}

package/dist/validation.js

@@ -0,0 +1,111 @@
+import { ArcaValidationError } from '@ramiidv/arca-common';
+/**
+ * Validates a single MTXCA item (line-level detail).
+ *
+ * @throws ArcaValidationError if any field is invalid
+ */
+export function validateMtxcaItem(item, index) {
+    const errors = [];
+    const prefix = index != null ? `items[${index}].` : '';
+    if (!item.descripcion) {
+        errors.push({
+            field: `${prefix}descripcion`,
+            message: 'descripcion es requerido',
+            value: item.descripcion,
+        });
+    }
+    if (item.cantidad == null || item.cantidad <= 0) {
+        errors.push({
+            field: `${prefix}cantidad`,
+            message: 'cantidad debe ser > 0',
+            value: item.cantidad,
+        });
+    }
+    if (item.precioUnitario == null || item.precioUnitario < 0) {
+        errors.push({
+            field: `${prefix}precioUnitario`,
+            message: 'precioUnitario debe ser >= 0',
+            value: item.precioUnitario,
+        });
+    }
+    if (item.unidadMedida == null || item.unidadMedida <= 0) {
+        errors.push({
+            field: `${prefix}unidadMedida`,
+            message: 'unidadMedida debe ser > 0',
+            value: item.unidadMedida,
+        });
+    }
+    if (errors.length > 0) {
+        throw new ArcaValidationError(`Validacion de item fallida: ${errors.map((e) => e.message).join('; ')}`, errors);
+    }
+}
+/**
+ * Validates the full autorizar request (ptoVta, cbteTipo, invoice fields, and items).
+ *
+ * @throws ArcaValidationError if any field is invalid
+ */
+export function validateAutorizarRequest(request) {
+    const errors = [];
+    if (request.ptoVta == null || request.ptoVta <= 0) {
+        errors.push({
+            field: 'ptoVta',
+            message: 'ptoVta debe ser > 0',
+            value: request.ptoVta,
+        });
+    }
+    if (request.cbteTipo == null || request.cbteTipo <= 0) {
+        errors.push({
+            field: 'cbteTipo',
+            message: 'cbteTipo debe ser > 0',
+            value: request.cbteTipo,
+        });
+    }
+    if (!request.invoice) {
+        errors.push({
+            field: 'invoice',
+            message: 'invoice es requerido',
+            value: request.invoice,
+        });
+        // Cannot validate further without invoice
+        throw new ArcaValidationError(`Validacion de AutorizarRequest fallida: ${errors.map((e) => e.message).join('; ')}`, errors);
+    }
+    const inv = request.invoice;
+    if (!inv.cbteFch) {
+        errors.push({
+            field: 'invoice.cbteFch',
+            message: 'cbteFch es requerido',
+            value: inv.cbteFch,
+        });
+    }
+    if (inv.importeTotal == null || inv.importeTotal < 0) {
+        errors.push({
+            field: 'invoice.importeTotal',
+            message: 'importeTotal debe ser >= 0',
+            value: inv.importeTotal,
+        });
+    }
+    if (!inv.items || inv.items.length === 0) {
+        errors.push({
+            field: 'invoice.items',
+            message: 'items no puede estar vacio',
+            value: inv.items,
+        });
+    }
+    else {
+        // Validate each item, collecting errors
+        for (let i = 0; i < inv.items.length; i++) {
+            try {
+                validateMtxcaItem(inv.items[i], i);
+            }
+            catch (e) {
+                if (e instanceof ArcaValidationError) {
+                    errors.push(...e.details);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new ArcaValidationError(`Validacion de AutorizarRequest fallida: ${errors.map((e) => e.message).join('; ')}`, errors);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,186 @@
+# @ramiidv/arca-mtxca
+
+> TypeScript SDK para el web service WSMTXCA de ARCA (ex AFIP) - Facturacion electronica con detalle de articulos
+
+## Instalacion
+
+```bash
+npm install @ramiidv/arca-mtxca
+```
+
+Requisitos: Node.js >= 18 (fetch nativo). ESM only.
+
+## Configuracion
+
+```typescript
+import { ArcaMtxca } from '@ramiidv/arca-mtxca';
+
+const mtxca = new ArcaMtxca({
+  cert: string,          // PEM X.509 certificate
+  key: string,           // PEM RSA private key
+  cuit: number,          // CUIT del contribuyente (ej: 20123456789)
+  production?: boolean,  // default: false (homologacion)
+  timeout?: number,      // default: 30000
+  retries?: number,      // default: 1
+  retryDelayMs?: number, // default: 1000
+  onEvent?: (event: ArcaEvent) => void,
+});
+```
+
+## WSMTXCA vs WSFEv1
+
+WSMTXCA: facturacion con detalle de articulos (arrayItems con codigo, descripcion, cantidad, precioUnitario, importeItem, codigoCondicionIVA, importeIVA por linea). Fechas en formato YYYY-MM-DD. Soporta tipos A, B, M. Protocolo SOAP Java.
+WSFEv1: facturacion sin detalle de items (solo subtotales globales de IVA). Fechas en formato YYYYMMDD. Soporta A, B, C, E, M, FCE. Protocolo SOAP .NET.
+
+## Metodos principales
+
+### autorizar(request: AutorizarRequest): Promise<MtxcaInvoiceResult>
+Autoriza un comprobante con detalle de articulos. Retorna CAE si aprobado. El request contiene ptoVta, cbteTipo, y un objeto invoice con concepto, docTipo, docNro, cbteFch (YYYY-MM-DD), importeTotal, items[], y campos opcionales (subtotalesIVA, otrosTributos, comprobanteAsociado, fechas de servicio).
+
+### ultimoComprobante(ptoVta: number, cbteTipo: number): Promise<number>
+Ultimo numero de comprobante autorizado.
+
+### siguienteComprobante(ptoVta: number, cbteTipo: number): Promise<number>
+Siguiente numero de comprobante (ultimo + 1).
+
+### consultarComprobante(cbteTipo: number, ptoVta: number, cbteNro: number): Promise<MtxcaComprobante>
+Consulta un comprobante previamente autorizado, incluyendo detalle de items.
+
+### status(): Promise<ServerStatus>
+Health check. No requiere autenticacion.
+
+### Parametros
+- getTiposComprobante(): Promise<ParamItem[]>
+- getTiposDocumento(): Promise<ParamItem[]>
+- getAlicuotasIVA(): Promise<ParamItem[]>
+- getCondicionesIVA(): Promise<ParamItem[]>
+- getMonedas(): Promise<MonedaItem[]>
+- getUnidadesMedida(): Promise<UnidadMedidaItem[]>
+- getPuntosVenta(): Promise<PtoVentaItem[]>
+- getPuntosVentaCAE(): Promise<PtoVentaItem[]>
+- getPuntosVentaCAEA(): Promise<PtoVentaItem[]>
+- getCotizacionMoneda(monedaId: string): Promise<CotizacionResult>
+
+## Tipos principales
+
+```typescript
+interface MtxcaItem {
+  codigo?: string;
+  descripcion: string;
+  cantidad: number;
+  unidadMedida: number;
+  precioUnitario: number;
+  importeItem: number;
+  codigoCondicionIVA: number;
+  importeIVA: number;
+  importeBonificacion?: number;
+}
+
+interface SubtotalIVA {
+  codigo: number;
+  baseImponible: number;
+  importe: number;
+}
+
+interface MtxcaInvoice {
+  concepto: number;
+  docTipo: number;
+  docNro: number;
+  cbteFch: string; // YYYY-MM-DD
+  items: MtxcaItem[];
+  importeTotal: number;
+  codigoMoneda?: string;
+  cotizacionMoneda?: number;
+  importeGravado?: number;
+  importeNoGravado?: number;
+  importeExento?: number;
+  subtotalesIVA?: SubtotalIVA[];
+  importeOtrosTributos?: number;
+  otrosTributos?: MtxcaTributo[];
+  comprobanteAsociado?: MtxcaComprobanteAsociado[];
+  fechaDesde?: string;
+  fechaHasta?: string;
+  fechaVtoPago?: string;
+  observaciones?: string;
+}
+
+interface AutorizarRequest {
+  ptoVta: number;
+  cbteTipo: number;
+  invoice: MtxcaInvoice;
+}
+
+interface MtxcaInvoiceResult {
+  resultado: string; // "A" or "R"
+  cae?: string;
+  caeFchVto?: string;
+  cbteNro: number;
+  observaciones: MtxcaObservacion[];
+  errores: MtxcaObservacion[];
+}
+
+interface MtxcaComprobante {
+  codigoTipoComprobante: number;
+  numeroPuntoVenta: number;
+  numeroComprobante: number;
+  fechaEmision: string;
+  codigoTipoDocumento: number;
+  numeroDocumento: number;
+  importeTotal: number;
+  importeNoGravado: number;
+  importeGravado: number;
+  importeExento: number;
+  importeOtrosTributos: number;
+  importeSubtotal: number;
+  codigoMoneda: string;
+  cotizacionMoneda: number;
+  resultado: string;
+  codigoAutorizacion?: string;
+  fechaVencimiento?: string;
+  observaciones: MtxcaObservacion[];
+  items: MtxcaItem[];
+}
+
+interface MtxcaObservacion { code: number; msg: string; }
+interface MtxcaTributo { codigoTributo: number; descripcion?: string; baseImponible: number; alicuota?: number; importe: number; }
+interface MtxcaComprobanteAsociado { codigoTipoComprobante: number; numeroPuntoVenta: number; numeroComprobante: number; cuit?: number; }
+interface ServerStatus { appserver: string; dbserver: string; authserver: string; }
+interface ParamItem { Id: number; Desc: string; FchDesde?: string; FchHasta?: string; }
+interface MonedaItem { Id: string; Desc: string; FchDesde?: string; FchHasta?: string; }
+interface UnidadMedidaItem { Id: number; Desc: string; FchDesde?: string; FchHasta?: string; }
+interface PtoVentaItem { Nro: number; EmisionTipo: string; Bloqueado: string; FchBaja: string; }
+interface CotizacionResult { monedaId: string; cotizacion: number; fechaCotizacion: string; }
+```
+
+## Errores
+
+4-class hierarchy from @ramiidv/arca-common:
+- ArcaError: base class
+- ArcaAuthError: WSAA authentication failures
+- ArcaServiceError: business errors from ARCA (has errors: {code: number, msg: string}[])
+- ArcaSoapError: HTTP/transport errors (has statusCode?: number)
+
+Note: autorizar() may return resultado="R" with errores/observaciones without throwing. Always check result.resultado.
+
+## Eventos
+
+Discriminated union types: auth:login, auth:cache-hit, request:start, request:end, request:retry, request:error.
+
+## Enums
+
+- CbteTipo: FACTURA_A=1, NOTA_DEBITO_A=2, NOTA_CREDITO_A=3, FACTURA_B=6, NOTA_DEBITO_B=7, NOTA_CREDITO_B=8, FACTURA_M=51, NOTA_DEBITO_M=52, NOTA_CREDITO_M=53
+- Concepto: PRODUCTOS=1, SERVICIOS=2, PRODUCTOS_Y_SERVICIOS=3
+- CodigoCondicionIVA: NO_GRAVADO=1, EXENTO=2, IVA_0=3, IVA_10_5=4, IVA_21=5, IVA_27=6, GRAVADO=7, IVA_5=8, IVA_2_5=9
+- Moneda: PESOS="PES", DOLARES="DOL", EUROS="060", etc.
+
+## Clientes de bajo nivel
+
+Accesibles como propiedades publicas: mtxca.wsaa (WsaaClient), mtxca.client (MtxcaClient).
+
+## SOAP details
+
+WSAA service name: wsmtxca
+Production: https://serviciosjava.afip.gob.ar/wsmtxca/services/MTXCAService
+Homologation: https://fwshomo.afip.gov.ar/wsmtxca/services/MTXCAService
+Namespace: http://impl.service.wsmtxca.afip.gov.ar/
+Auth params use lowercase keys: token, sign, cuitRepresentada (wrapped in authRequest object).

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@ramiidv/arca-mtxca",
+  "version": "0.1.0",
+  "description": "TypeScript SDK para el web service WSMTXCA de ARCA (ex AFIP) - Facturacion electronica con detalle de articulos",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "llms.txt",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "arca",
+    "afip",
+    "wsmtxca",
+    "facturacion",
+    "factura-electronica",
+    "argentina",
+    "sdk",
+    "typescript",
+    "cae",
+    "caea",
+    "articulos",
+    "items",
+    "soap",
+    "invoice"
+  ],
+  "author": "ramiidv",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ramiidv/arca-mtxca.git"
+  },
+  "homepage": "https://github.com/ramiidv/arca-mtxca#readme",
+  "bugs": {
+    "url": "https://github.com/ramiidv/arca-mtxca/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@ramiidv/arca-common": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.4"
+  }
+}