arcli 2.0.0 → 2.2.0

package/dist/modules/config/config.schemas.js

@@ -22,16 +22,16 @@ export const arcliDefaultCurrencySchema = z
     .length(3)
     .transform((value) => value.toUpperCase());
 export const arcliPdfModeSchema = z.enum(['siempre', 'preguntar', 'nunca']);
+/** Rutas de certificado o clave por entorno; no se leen al parsear la config. */
+const certificatePathsSchema = z.object({
+    produccion: z.string().trim().min(1).optional(),
+    testing: z.string().trim().min(1).optional(),
+});
 // Misma normalizacion que --alicuota ("10,5", "10.5%").
 export const arcliDefaultIvaRateSchema = billingIvaRateSchema;
 export const arcliConfigSchema = z.object({
     alicuotaPorDefecto: arcliDefaultIvaRateSchema.optional(),
-    cert: z
-        .object({
-        produccion: z.string().trim().min(1).optional(),
-        testing: z.string().trim().min(1).optional(),
-    })
-        .default({}),
+    cert: certificatePathsSchema.default({}),
     cuit: z
         .string()
         .trim()
@@ -45,7 +45,7 @@ export const arcliConfigSchema = z.object({
     aliasCbu: z
         .string()
         .trim()
-        .regex(/^[A-Za-z0-9.-]{6,20}$/, 'El alias debe tener entre 6 y 20 caracteres (letras, numeros, punto o guion)')
+        .regex(/^[A-Za-z0-9.-]{6,20}$/, 'El alias debe tener entre 6 y 20 caracteres (letras, números, punto o guion)')
         .optional(),
     conceptoPorDefecto: arcliDefaultConceptSchema.optional(),
     ivaReceptorPorDefecto: arcliDefaultIvaConditionSchema.optional(),
@@ -67,12 +67,16 @@ export const arcliConfigSchema = z.object({
     })
         .default({}),
     entornoPorDefecto: arcliEnvironmentSchema.default('testing'),
-    key: z
+    /** WSFEX (factura de exportacion) usa su propio certificado, autorizado al servicio wsfex. */
+    exportacion: z
         .object({
-        produccion: z.string().trim().min(1).optional(),
-        testing: z.string().trim().min(1).optional(),
+        /** Codigo de la tabla de actividades de WSFEX que va en `Actividades` de la factura E. */
+        actividad: z.number().int().positive().optional(),
+        cert: certificatePathsSchema.default({}),
+        key: certificatePathsSchema.default({}),
     })
-        .default({}),
+        .optional(),
+    key: certificatePathsSchema.default({}),
     output: z
         .object({
         emitirPorDefecto: z.boolean().default(false),
@@ -87,8 +91,14 @@ export const arcliConfigSchema = z.object({
     comprobantesPorLista: z.number().int().min(1).max(MAX_RECENT_VOUCHERS).optional(),
     puntoVentaPorDefecto: z.number().int().positive().optional(),
     ticketPath: z.string().trim().min(1).optional(),
+    /** Completar el IVA receptor desde el padron al facturar con --cuit. Sin definir, si. */
+    consultarPadron: z.boolean().optional(),
     verificarFce: z.boolean().optional(),
 });
+/** El entorno como se lee en un texto; el valor (`produccion`) sigue igual en flags, claves y JSON. */
+export function formatEnvironmentLabel(environment) {
+    return environment === 'produccion' ? 'producción' : environment;
+}
 export const CONFIG_DEFAULTS = {
     cert: {},
     emisor: {},
@@ -120,6 +130,11 @@ export const configPublicKeySchema = z.enum([
     'emisor.razonSocial',
     'entorno',
     'emitir',
+    'exportacion.actividad',
+    'exportacion.cert.produccion',
+    'exportacion.cert.testing',
+    'exportacion.key.produccion',
+    'exportacion.key.testing',
     'ivaReceptor',
     'json',
     'key.produccion',
@@ -132,5 +147,5 @@ export const configPublicKeySchema = z.enum([
     'puntoVenta',
     'ticketPath',
     'verificarFce',
+    'consultarPadron',
 ]);
-//# sourceMappingURL=config.schemas.js.map

package/dist/modules/config/config.sections.js

@@ -6,11 +6,26 @@ export const CONFIG_SECTIONS = [
     { id: 'cuenta', keys: ['cuit', 'puntoVenta', 'entorno'], label: 'Cuenta' },
     {
         id: 'certificados',
-        keys: ['cert.testing', 'key.testing', 'cert.produccion', 'key.produccion', 'ticketPath'],
+        keys: [
+            'cert.testing',
+            'key.testing',
+            'cert.produccion',
+            'key.produccion',
+            'exportacion.cert.testing',
+            'exportacion.key.testing',
+            'exportacion.cert.produccion',
+            'exportacion.key.produccion',
+            'ticketPath',
+        ],
         label: 'Certificados',
     },
-    { id: 'facturacion', keys: ['concepto', 'ivaReceptor', 'alicuota', 'moneda', 'cotizacion'], label: 'Al facturar' },
-    { id: 'fce', keys: ['cbu', 'aliasCbu', 'verificarFce'], label: 'Factura de credito electronica (FCE)' },
+    {
+        id: 'facturacion',
+        keys: ['concepto', 'ivaReceptor', 'consultarPadron', 'alicuota', 'moneda', 'cotizacion'],
+        label: 'Al facturar',
+    },
+    { id: 'fce', keys: ['cbu', 'aliasCbu', 'verificarFce'], label: 'Factura de crédito electrónica (FCE)' },
+    { id: 'exportacion', keys: ['exportacion.actividad'], label: 'Factura de exportación (E)' },
     {
         id: 'emisor',
         keys: [
@@ -28,27 +43,32 @@ export const CONFIG_SECTIONS = [
 ];
 /** Nombre de cada dato, igual en `arcli config` y en el modo interactivo. */
 export const CONFIG_LABELS = {
-    alicuota: 'Alicuota de IVA (A y B)',
+    alicuota: 'Alícuota de IVA (A y B)',
     aliasCbu: 'Alias del CBU',
     bruto: 'Salida bruta',
     cbu: 'CBU',
-    'cert.produccion': 'Certificado de produccion',
+    'cert.produccion': 'Certificado de producción',
     'cert.testing': 'Certificado de testing',
     comprobantesPorLista: 'Comprobantes por lista',
     concepto: 'Concepto',
-    cotizacion: 'Cotizacion',
+    cotizacion: 'Cotización',
     cuit: 'CUIT del emisor',
-    'emisor.condicionIva': 'Condicion de IVA',
+    'emisor.condicionIva': 'Condición de IVA',
     'emisor.domicilio': 'Domicilio comercial',
     'emisor.iibb': 'Ingresos Brutos',
     'emisor.inicioActividades': 'Inicio de actividades',
     'emisor.logo': 'Logo (PNG o JPG)',
-    'emisor.razonSocial': 'Razon social',
+    'emisor.razonSocial': 'Razón social',
     emitir: 'Emitir sin --emitir',
     entorno: 'Entorno',
+    'exportacion.actividad': 'Actividad de exportación (WSFEX)',
+    'exportacion.cert.produccion': 'Certificado de exportación (producción)',
+    'exportacion.cert.testing': 'Certificado de exportación (testing)',
+    'exportacion.key.produccion': 'Clave de exportación (producción)',
+    'exportacion.key.testing': 'Clave de exportación (testing)',
     ivaReceptor: 'IVA del receptor',
     json: 'Salida JSON',
-    'key.produccion': 'Clave privada de produccion',
+    'key.produccion': 'Clave privada de producción',
     'key.testing': 'Clave privada de testing',
     moneda: 'Moneda',
     pdf: 'Cuando generar el PDF',
@@ -56,6 +76,6 @@ export const CONFIG_LABELS = {
     pdfNavegador: 'Navegador para PDFs',
     puntoVenta: 'Punto de venta',
     ticketPath: 'Carpeta de tickets WSAA',
-    verificarFce: 'Verificar regimen FCE del receptor',
+    verificarFce: 'Verificar régimen FCE del receptor',
+    consultarPadron: 'IVA del receptor desde el padrón',
 };
-//# sourceMappingURL=config.sections.js.map

package/dist/modules/config/config.service.js

@@ -1,6 +1,7 @@
 import Conf from 'conf';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
+import { ConfigurationError } from '../../lib/errors/app-error.js';
 import { arcliConfigSchema, CONFIG_DEFAULTS, configPublicKeySchema, } from './config.schemas.js';
 import { parseConfigValue } from './config-value-parser.js';
 const CONFIG_KEY_ALIASES = {
@@ -21,6 +22,11 @@ const CONFIG_KEY_ALIASES = {
     'emisor.razonSocial': 'emisor.razonSocial',
     entorno: 'entornoPorDefecto',
     emitir: 'output.emitirPorDefecto',
+    'exportacion.actividad': 'exportacion.actividad',
+    'exportacion.cert.produccion': 'exportacion.cert.produccion',
+    'exportacion.cert.testing': 'exportacion.cert.testing',
+    'exportacion.key.produccion': 'exportacion.key.produccion',
+    'exportacion.key.testing': 'exportacion.key.testing',
     ivaReceptor: 'ivaReceptorPorDefecto',
     json: 'output.jsonPorDefecto',
     'key.produccion': 'key.produccion',
@@ -33,22 +39,46 @@ const CONFIG_KEY_ALIASES = {
     puntoVenta: 'puntoVentaPorDefecto',
     ticketPath: 'ticketPath',
     verificarFce: 'verificarFce',
+    consultarPadron: 'consultarPadron',
 };
 /** Valida un valor como lo haria `arcli config establecer`, sin guardarlo. Lanza un Error con el motivo. */
 export function validateConfigValue(publicKey, rawValue) {
     parseConfigValue(CONFIG_KEY_ALIASES[publicKey], rawValue);
 }
+function storeLocation(options) {
+    return {
+        configName: options.configName ?? 'config',
+        cwd: options.cwd,
+        projectName: options.projectName ?? 'arcli',
+        projectSuffix: '',
+    };
+}
+/**
+ * Ruta del config.json sin leerlo: `Conf` la calcula al construirse, pero tambien lee el archivo. Sin defaults y
+ * con un deserializador que no parsea, no hay nada que escribir y el archivo queda como esta.
+ */
+function resolveStorePath(options) {
+    return new Conf({ ...storeLocation(options), deserialize: () => ({}) }).path;
+}
+function invalidConfigFileError(path) {
+    return new ConfigurationError('El archivo de configuración tiene JSON inválido y no se puede leer.', { path }, 'Corregilo a mano, o renombralo (por ejemplo, a config.json.bak) y volve a cargar los datos con `arcli config establecer` o desde "Configuracion" en `arcli`. ARCLI no lo borra ni lo pisa.');
+}
 export class ConfigService {
     store;
     constructor(options = {}) {
-        this.store = new Conf({
-            clearInvalidConfig: false,
-            configName: options.configName ?? 'config',
-            cwd: options.cwd,
-            defaults: CONFIG_DEFAULTS,
-            projectName: options.projectName ?? 'arcli',
-            projectSuffix: '',
-        });
+        try {
+            this.store = new Conf({
+                ...storeLocation(options),
+                clearInvalidConfig: false,
+                defaults: CONFIG_DEFAULTS,
+            });
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                throw invalidConfigFileError(resolveStorePath(options));
+            }
+            throw error;
+        }
     }
     close() {
         this.store._closeWatcher();
@@ -128,4 +158,3 @@ function deleteAtPath(target, path) {
         delete parent[last];
     }
 }
-//# sourceMappingURL=config.service.js.map

package/dist/modules/examples/examples.js

@@ -1,7 +1,8 @@
 import { toArgentineCalendarDate } from '../../lib/dates/arca-date.js';
 import { badge, renderLogo, sectionHeading, toneText } from '../../ui/index.js';
 import { VOUCHER_FAMILIES, VOUCHER_KIND_MAP, VOUCHER_SHORTCUTS } from '../billing/voucher-kind-map.js';
-const ISSUER_HINT = 'Estos ejemplos asumen que ya resolviste cuit emisor, credenciales y, en la version minima, tambien punto de venta por config.';
+import { EXPORT_VOUCHER_KIND } from '../export/export.types.js';
+const ISSUER_HINT = 'Estos ejemplos asumen que ya resolviste cuit emisor, credenciales y, en la versión mínima, también punto de venta por config.';
 function resolveAmount(definition) {
     if (definition.letter === 'a') {
         return 1;
@@ -23,22 +24,23 @@ function resolveIdentityShort(definition) {
     }
     return ['--cfinal', '--ir-cf'];
 }
+/** Una nota asocia una factura de su misma letra y categoria: `nca` -> `fa`, `ndeb` -> `fceb`. */
 function resolveAssociatedShortcut(definition) {
+    return `${definition.isElectronicCredit ? 'fce' : 'f'}${definition.letter}`;
+}
+const EXAMPLE_CBU = '0110599520000012345678';
+/** En NC/ND FCE el asociado tiene que ser del CUIT emisor: `--acuit` se omite y se toma de la config. */
+function resolveAssociatedFlags(definition, form) {
     if (!definition.requiresAssociatedVoucher) {
-        return '';
-    }
-    if (definition.family === 'nota-credito') {
-        return `f${definition.letter}`;
-    }
-    if (definition.family === 'nota-debito') {
-        return `f${definition.letter}`;
-    }
-    if (definition.family === 'nota-credito-electronica') {
-        return `fce${definition.letter}`;
+        return [];
     }
-    return `fce${definition.letter}`;
+    return [
+        `--ac ${resolveAssociatedShortcut(definition)}`,
+        form === 'long' ? '--asociado-punto-venta 3' : '--apv 3',
+        '--ar 120',
+        ...(definition.isElectronicCredit ? [] : ['--acuit 20333333334']),
+    ];
 }
-const EXAMPLE_CBU = '0110599520000012345678';
 function formatExampleDate(value) {
     const day = String(value.getDate()).padStart(2, '0');
     const month = String(value.getMonth() + 1).padStart(2, '0');
@@ -78,19 +80,15 @@ function buildMinimalLong(definition, dates) {
         '--concepto servicios',
     ];
     command.push(...resolveIdentityLong(definition));
-    if (definition.requiresAssociatedVoucher) {
-        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--asociado-punto-venta 3', '--ar 120', '--acuit 20409509763');
-    }
-    command.push(...resolveElectronicCreditFlags(definition, dates, 'minimal'), '--previsualizar');
+    command.push(...resolveAssociatedFlags(definition, 'long'));
+    command.push(...resolveElectronicCreditFlags(definition, dates, 'minimal'));
     return command.join(' ');
 }
 function buildMinimalShort(definition, dates) {
     const command = [`arcli ${definition.shortcut}`, `-m ${resolveAmount(definition)}`, '--cs'];
     command.push(...resolveIdentityShort(definition));
-    if (definition.requiresAssociatedVoucher) {
-        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--apv 3', '--ar 120', '--acuit 20409509763');
-    }
-    command.push(...resolveElectronicCreditFlags(definition, dates, 'minimal'), '--previsualizar');
+    command.push(...resolveAssociatedFlags(definition, 'short'));
+    command.push(...resolveElectronicCreditFlags(definition, dates, 'minimal'));
     return command.join(' ');
 }
 function buildFullLong(definition, dates) {
@@ -109,9 +107,7 @@ function buildFullLong(definition, dates) {
         command.push(`--vencimiento ${dates.paymentDue}`);
     }
     command.push(...resolveIdentityLong(definition));
-    if (definition.requiresAssociatedVoucher) {
-        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--asociado-punto-venta 3', '--ar 120', '--acuit 20409509763');
-    }
+    command.push(...resolveAssociatedFlags(definition, 'long'));
     command.push(...resolveElectronicCreditFlags(definition, dates, 'full'), '--previsualizar');
     return command.join(' ');
 }
@@ -131,9 +127,7 @@ function buildFullShort(definition, dates) {
         command.push(`--vto ${dates.paymentDue}`);
     }
     command.push(...resolveIdentityShort(definition));
-    if (definition.requiresAssociatedVoucher) {
-        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--apv 3', '--ar 120', '--acuit 20409509763');
-    }
+    command.push(...resolveAssociatedFlags(definition, 'short'));
     command.push(...resolveElectronicCreditFlags(definition, dates, 'full'), '--previsualizar');
     return command.join(' ');
 }
@@ -141,11 +135,11 @@ function formatVoucherExample(definition, dates) {
     return [
         sectionHeading(definition.displayName),
         '',
-        `${badge('MINIMA LARGA', 'info')}`,
-        `${buildMinimalLong(definition, dates)}`,
+        `${badge('MÍNIMA LARGA', 'info')}`,
+        `${buildMinimalLong(definition, dates)} --previsualizar`,
         '',
-        `${badge('MINIMA CORTA', 'success')}`,
-        `${buildMinimalShort(definition, dates)}`,
+        `${badge('MÍNIMA CORTA', 'success')}`,
+        `${buildMinimalShort(definition, dates)} --previsualizar`,
         '',
         `${badge('FULL LARGA', 'warning')}`,
         `${buildFullLong(definition, dates)}`,
@@ -160,26 +154,67 @@ function renderFamilyExamples(family, dates) {
         .map((definition) => formatVoucherExample(definition, dates))
         .join('\n\n\n');
 }
+const EXPORT_CLIENT = '--cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 212 --numero 1';
+/** El comando minimo de la factura E por shortcut, sin modo de ejecucion. Lo usa tambien la ayuda de `fe`. */
+export const EXPORT_MINIMAL_EXAMPLE = `arcli ${EXPORT_VOUCHER_KIND.shortcut} -m 1500 ${EXPORT_CLIENT} --actividad 620100`;
+/** La E no comparte flags de receptor ni de IVA con A, B y C: sus ejemplos se arman aparte. */
+function formatExportExample() {
+    const { family, letter, shortcut } = EXPORT_VOUCHER_KIND;
+    const fullFlags = [
+        '--id-impositivo "12-3456789"',
+        '--tipo-expo 2',
+        '--item "001|Servicios de consultoría|10|150|unidades"',
+        '--fecha-pago 15/11',
+        '--forma-pago "Transferencia Internacional"',
+        '--obs-comerciales "Orden de compra 778"',
+    ];
+    return [
+        sectionHeading(EXPORT_VOUCHER_KIND.displayName),
+        '',
+        `${badge('MÍNIMA LARGA', 'info')}`,
+        `arcli ${family} ${letter} --monto 1500 ${EXPORT_CLIENT} --actividad 620100 --previsualizar`,
+        '',
+        `${badge('MÍNIMA CORTA', 'success')}`,
+        `${EXPORT_MINIMAL_EXAMPLE} --previsualizar`,
+        '',
+        `${badge('FULL LARGA', 'warning')}`,
+        `arcli ${family} ${letter} --monto 1500 ${EXPORT_CLIENT} --actividad 620100 ${fullFlags.join(' ')} --moneda USD --misma-moneda --previsualizar`,
+        '',
+        `${badge('FULL CORTA', 'debug')}`,
+        `arcli ${shortcut} -m 1500 ${EXPORT_CLIENT} --actividad 620100 ${fullFlags.join(' ')} --mda USD --misma-moneda --previsualizar`,
+    ].join('\n');
+}
+/** El comando minimo por shortcut (`arcli nca -m 1 --cs ...`), sin modo de ejecucion. Lo usa tambien la ayuda. */
+export function buildMinimalShortcutExample(definition, today = new Date()) {
+    return buildMinimalShort(definition, resolveExampleDates(today));
+}
+/** El comando minimo por familia y letra (`arcli nota-credito a --monto 1 ...`), sin modo de ejecucion. */
+export function buildMinimalFamilyExample(definition, today = new Date()) {
+    return buildMinimalLong(definition, resolveExampleDates(today));
+}
 export function renderExamples(today = new Date()) {
     const dates = resolveExampleDates(today);
     return [
         renderLogo().trim(),
         '',
-        `${badge('MINIMA', 'info')} datos esenciales`,
-        `${badge('FULL', 'warning')} mas campos explicitados`,
+        `${badge('MÍNIMA', 'info')} datos esenciales`,
+        `${badge('FULL', 'warning')} más campos explicitados`,
         `${badge('LARGA', 'success')} comando largo`,
         `${badge('CORTA', 'debug')} shortcut y aliases`,
         '',
         toneText('SEGURIDAD', 'warning'),
         'Todos usan --previsualizar para evitar emisiones reales por error.',
-        'Si queres emitir de verdad, reemplaza --previsualizar por --emitir.',
-        'Para emitir en produccion necesitas --produccion junto con --emitir.',
+        'Si querés emitir de verdad, reemplaza --previsualizar por --emitir.',
+        'Para emitir en producción necesitas --produccion junto con --emitir.',
         'Para guardar el PDF con el QR, agrega --exportar-pdf al emitir (ver docs/pdf.md).',
         '',
         ISSUER_HINT,
         '',
-        ...VOUCHER_FAMILIES.flatMap((family) => [renderFamilyExamples(family, dates), '']),
+        ...VOUCHER_FAMILIES.flatMap((family) => [
+            renderFamilyExamples(family, dates),
+            ...(family === EXPORT_VOUCHER_KIND.family ? ['', '', formatExportExample()] : []),
+            '',
+        ]),
         '',
     ].join('\n');
 }
-//# sourceMappingURL=examples.js.map

package/dist/modules/export/export.items.js

@@ -0,0 +1,149 @@
+import Big from 'big.js';
+import { InputValidationError } from '../../lib/errors/app-error.js';
+import { parseArgentineAmount } from '../../lib/numbers/argentine-amount.js';
+import { DEFAULT_EXPORT_UNIT_CODE, } from './export.types.js';
+export const DEFAULT_EXPORT_ITEM_DESCRIPTION = 'Según detalle';
+const ITEM_FORMAT_HINT = 'Usá --item "codigo|descripcion|cantidad|precio|unidad" (el código y la unidad son opcionales).';
+function parseItemAmount(part, field, raw) {
+    const parsed = parseArgentineAmount(part, { maxDecimals: 6 });
+    if (!parsed.ok) {
+        throw new InputValidationError(`El ${field} del item "${raw}" no es válido: ${parsed.reason}.`);
+    }
+    return parsed.value;
+}
+/**
+ * Un item por flag. Se separa con `|` para no pelear con las comas de los importes:
+ * `001|Servicio de consultoria|1|1000|unidad`. Con cuatro partes se omite el codigo y con tres la unidad.
+ */
+export function parseExportItemArgument(raw) {
+    const parts = raw.split('|').map((part) => part.trim());
+    if (parts.length < 3 || parts.length > 5) {
+        throw new InputValidationError(`El item "${raw}" no es válido. ${ITEM_FORMAT_HINT}`);
+    }
+    const [codeOrDescription, ...rest] = parts;
+    const description = parts.length === 5 ? rest.shift() : codeOrDescription;
+    const [quantityPart, pricePart, unitPart] = rest;
+    if (!description || !quantityPart || !pricePart) {
+        throw new InputValidationError(`El item "${raw}" no es válido: falta la descripción, la cantidad o el precio.`);
+    }
+    return {
+        code: parts.length === 5 ? codeOrDescription : undefined,
+        description,
+        quantity: parseItemAmount(quantityPart, 'la cantidad', raw),
+        unit: unitPart ? resolveExportItemUnit(unitPart) : DEFAULT_EXPORT_UNIT_CODE,
+        unitPrice: parseItemAmount(pricePart, 'el precio', raw),
+    };
+}
+/** La unidad del item puede ser el codigo de ARCA (`7`) o el nombre de la tabla (`unidad`). */
+export function resolveExportItemUnit(unit) {
+    if (typeof unit === 'number') {
+        return unit;
+    }
+    const trimmed = unit.trim();
+    if (!trimmed) {
+        throw new InputValidationError('La unidad del item no puede estar vacía. Usá --item sin la última parte para usar "unidad".');
+    }
+    return /^\d+$/.test(trimmed) ? Number(trimmed) : trimmed;
+}
+/**
+ * La tabla de ARCA escribe las unidades en plural ("unidades", "kilogramos") y los ejemplos del CLI en singular
+ * ("unidad"): se aceptan las dos formas, sin inventar codigos para nombres que no estan en la tabla.
+ */
+function singularUnitName(value) {
+    if (/[dlrnz]es$/.test(value)) {
+        return value.slice(0, -2);
+    }
+    return value.endsWith('s') ? value.slice(0, -1) : value;
+}
+function findUnitByName(units, normalized) {
+    const exact = units.find((entry) => entry.name.trim().toLowerCase() === normalized);
+    if (exact) {
+        return exact;
+    }
+    const singular = singularUnitName(normalized);
+    const matches = units.filter((entry) => singularUnitName(entry.name.trim().toLowerCase()) === singular);
+    return matches.length === 1 ? matches[0] : undefined;
+}
+/**
+ * Codigo de ARCA de la unidad: si viene un nombre se busca en la tabla de WSFEX. Un nombre desconocido
+ * es un error, no un default silencioso.
+ */
+export function resolveUnitCode(unit, units) {
+    if (typeof unit === 'number') {
+        const known = units.find((entry) => entry.id === unit);
+        if (units.length > 0 && !known) {
+            throw new InputValidationError(`La unidad ${unit} no existe en la tabla de ARCA.`);
+        }
+        return unit;
+    }
+    if (typeof unit === 'string') {
+        const match = findUnitByName(units, unit.trim().toLowerCase());
+        if (match) {
+            return match.id;
+        }
+        throw new InputValidationError(`La unidad "${unit}" no existe en la tabla de ARCA. Usá el nombre tal como lo informa ARCA o el código numérico.`);
+    }
+    return DEFAULT_EXPORT_UNIT_CODE;
+}
+function roundAmount(value) {
+    return value.round(2, Big.roundHalfUp).toNumber();
+}
+function assertSameTotal(total, amount) {
+    if (!total.eq(new Big(amount).round(2, Big.roundHalfUp))) {
+        throw new InputValidationError(`La suma de los items (${roundAmount(total).toFixed(2)}) no coincide con --monto (${amount.toFixed(2)}).`);
+    }
+}
+/** Se valida antes de consultar ARCA: un total que no cierra no tiene por que autenticar en WSAA. */
+export function assertExportItemsTotal(inputs, amount) {
+    if (!inputs || inputs.length === 0) {
+        return;
+    }
+    const total = inputs.reduce((sum, item) => sum.plus(new Big(item.quantity).times(item.unitPrice).round(2, Big.roundHalfUp)), new Big(0));
+    assertSameTotal(total, amount);
+}
+/**
+ * Un item sin `--item` resume el comprobante en un renglon con el total. Con items, la suma tiene que dar
+ * el monto: ARCA no valida `Imp_total` contra los items, asi que se valida aca.
+ */
+export function buildExportItems(inputs, amount, units, defaultDescription) {
+    if (!inputs || inputs.length === 0) {
+        return {
+            items: [
+                {
+                    Pro_bonificacion: 0,
+                    Pro_codigo: '',
+                    Pro_ds: defaultDescription,
+                    Pro_precio_uni: amount,
+                    Pro_qty: 1,
+                    Pro_total_item: roundAmount(new Big(amount)),
+                    Pro_umed: DEFAULT_EXPORT_UNIT_CODE,
+                },
+            ],
+            total: roundAmount(new Big(amount)),
+        };
+    }
+    const items = inputs.map((item) => {
+        if (!item.description.trim()) {
+            throw new InputValidationError('Cada item necesita una descripción.');
+        }
+        const quantity = new Big(item.quantity);
+        if (quantity.lte(0)) {
+            throw new InputValidationError(`La cantidad del item "${item.description}" tiene que ser mayor a 0.`);
+        }
+        if (!(item.unitPrice > 0)) {
+            throw new InputValidationError(`El precio del item "${item.description}" tiene que ser mayor a 0.`);
+        }
+        return {
+            Pro_bonificacion: 0,
+            Pro_codigo: item.code?.trim() ?? '',
+            Pro_ds: item.description.trim(),
+            Pro_precio_uni: item.unitPrice,
+            Pro_qty: quantity.toNumber(),
+            Pro_total_item: roundAmount(quantity.times(item.unitPrice)),
+            Pro_umed: resolveUnitCode(item.unit, units),
+        };
+    });
+    const total = items.reduce((sum, item) => sum.plus(item.Pro_total_item), new Big(0));
+    assertSameTotal(total, amount);
+    return { items, total: roundAmount(total) };
+}

package/dist/modules/export/export.json-input.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { InputValidationError } from '../../lib/errors/app-error.js';
+const itemJsonSchema = z
+    .object({
+    cantidad: z.number(),
+    codigo: z.string().optional(),
+    descripcion: z.string(),
+    precioUnitario: z.number(),
+    unidad: z.union([z.string(), z.number()]).optional(),
+})
+    .strict();
+/**
+ * Forma del JSON de `--cargar`: solo tipos y claves. Los valores (importes, pais, incoterm) los valida el
+ * servicio igual que si vinieran por flags. Es `.strict()` para que un typo no se ignore en silencio.
+ */
+export const exportJsonInputSchema = z
+    .object({
+    actividad: z.number().optional(),
+    cliente: z.string().optional(),
+    codigoMoneda: z.string().optional(),
+    cotizacionMoneda: z.number().optional(),
+    cuitPais: z.number().optional(),
+    descripcion: z.string().optional(),
+    descripcionIncoterm: z.string().optional(),
+    domicilioCliente: z.string().optional(),
+    emitir: z.boolean().optional(),
+    fechaComprobante: z.string().optional(),
+    fechaPago: z.string().optional(),
+    formaPago: z.string().optional(),
+    idImpositivo: z.string().optional(),
+    idSolicitud: z.number().optional(),
+    idioma: z.number().optional(),
+    incoterm: z.string().optional(),
+    items: z.array(itemJsonSchema).optional(),
+    mismaMoneda: z.boolean().optional(),
+    monto: z.number().optional(),
+    numero: z.number().optional(),
+    observaciones: z.string().optional(),
+    observacionesComerciales: z.string().optional(),
+    paisDestino: z.union([z.string(), z.number()]).optional(),
+    pdf: z.boolean().optional(),
+    permisoExistente: z.boolean().optional(),
+    permisos: z.array(z.string()).optional(),
+    puntoVenta: z.number().optional(),
+    previsualizar: z.boolean().optional(),
+    tipoExpo: z.union([z.literal(1), z.literal(2), z.literal(4)]).optional(),
+})
+    .strict();
+const TYPE_LABELS = {
+    array: 'un array',
+    boolean: 'true o false',
+    number: 'un número',
+    object: 'un objeto',
+    string: 'un texto',
+};
+function describeIssue(issue) {
+    const path = issue.path.map(String).join('.');
+    if (issue.code === 'unrecognized_keys') {
+        return `La clave "${issue.keys.join('", "')}" no existe en el JSON de --cargar.`;
+    }
+    if (issue.code === 'invalid_type' && issue.input === undefined) {
+        return `Falta "${path}".`;
+    }
+    if (issue.code === 'invalid_type') {
+        return `"${path}" tiene que ser ${TYPE_LABELS[issue.expected] ?? issue.expected}.`;
+    }
+    return path ? `"${path}": ${issue.message}.` : `${issue.message}.`;
+}
+export function parseExportJsonInput(value) {
+    const result = exportJsonInputSchema.safeParse(value, { reportInput: true });
+    if (result.success) {
+        return result.data;
+    }
+    throw new InputValidationError(`En el JSON de --cargar: ${result.error.issues.map((issue) => describeIssue(issue)).join(' ')}`);
+}
+/** `--cargar` toma un solo comprobante; el lote de exportacion queda para mas adelante. */
+export function readExportJsonInput(source) {
+    if (Array.isArray(source)) {
+        throw new InputValidationError('El JSON de --cargar de la factura E tiene que ser un objeto con un comprobante, no un array.');
+    }
+    return parseExportJsonInput(source);
+}
+export function mapExportJsonItems(items) {
+    return items?.map((item) => ({
+        code: item.codigo,
+        description: item.descripcion,
+        quantity: item.cantidad,
+        unit: item.unidad,
+        unitPrice: item.precioUnitario,
+    }));
+}