arcli 2.0.0 → 2.2.0

package/CHANGELOG.md

@@ -8,6 +8,109 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y e
 
 ## [Sin publicar]
 
+## [2.2.0] - 2026-11-02
+
+Trae la factura de exportación `E` (`arcli fe`) sobre WSFEX: items, país de destino, incoterm y permisos de embarque, con credenciales propias para `wsfex`, PDF con el diseño de exportación y modo interactivo. Es todo agregado: los comandos y flags de A, B, C y FCE siguen igual. Gracias a [Manuel Aller](https://github.com/itManuel), que la trajo en [#67](https://github.com/LcsGrz/arcli/pull/67).
+
+Además suma el autocompletado con Tab, el número del comprobante en el JSON, la validación del dígito verificador de todo CUIT y una ayuda más corta y en español, y corrige varios errores de la revisión del repo.
+
+Dos cambios pueden afectar scripts: los mensajes ahora usan voseo y tildes (si comparás el texto de un error en lugar de `codigo`), y un `montoTotal` con más de 2 decimales en el JSON da error en lugar de redondearse. Ver "Cambiado" y "Corregido".
+
+### Agregado
+
+- **`arcli fe` y `arcli factura e`:** emiten o previsualizan la Factura de exportación `E` (tipo 19) con WSFEX. Obligatorios: `--monto`, `--cliente`, `--domicilio-cliente`, `--pais-destino` (código o nombre), `--numero` y la actividad. Opcionales: `--id-impositivo`, `--cuit-pais`, `--tipo-expo` (`1` bienes, `2` servicios, `4` otros), `--incoterm`, `--incoterms-desc`, `--idioma`, `--forma-pago`, `--permiso` con `--permiso-existente`, `--id-solicitud`, `--fecha-pago`, `--observaciones` y `--obs-comerciales`. No lleva concepto, IVA ni receptor con CUIT/CUIL/DNI. `fe` va en la tabla de atajos de `arcli --ayuda` y en `arcli ejemplos`, y Tab completa la letra `e` en `arcli factura`.
+- **`--numero` obligatorio en la `E`:** WSFEX numera por punto de venta y tipo, pero `@arcasdk/core` todavía no permite consultar el último comprobante E. Pasá el siguiente al último que emitiste (`1` si es el primero).
+- **Actividad de la `E`:** `--actividad` o la clave nueva `exportacion.actividad` (sección "Factura de exportación (E)" de `arcli config`), con un código de la tabla de actividades de WSFEX, que no es la del padrón. No hay default; un código que no está en la tabla es error de validación con los que empiezan igual.
+- **Flags de otra letra en `arcli factura <letra>`:** como `factura` comparte el comando para A, B, C y E, los flags que no aplican a la letra elegida se saltean con un aviso en "Avisos" y en `avisos` del JSON (`factura a --incoterm`, `factura e --alicuota`). Los atajos (`fa`, `fe`…) siguen rechazándolos como opción desconocida.
+- **`--item` con detalle real:** `codigo|descripcion|cantidad|precio|unidad`, repetible; el código y la unidad son opcionales y la unidad puede ser el código de ARCA o su nombre. La suma de los items tiene que dar `--monto` y se valida antes de autenticar en WSAA, porque WSFEX no lo controla.
+- **`--cargar` para `E`:** un objeto, con claves propias (`cliente`, `domicilioCliente`, `paisDestino`, `monto`, `numero`, `actividad`, `items`, `tipoExpo`…). El lote no está soportado: un array es error de entrada.
+- **`exportacion.cert.testing`, `exportacion.cert.produccion`, `exportacion.key.testing`, `exportacion.key.produccion`:** credenciales del servicio `wsfex`, para cuando el certificado general no está autorizado a exportación. Si no están las dos de un entorno, se usan `cert.*`/`key.*`; con la mitad del par configurada el comando corta antes de ir a ARCA. Se muestran en la sección **Certificados** de `arcli config` (también en el modo interactivo), se validan como PEM al guardarlas y `arcli config revisar` las revisa con el resto. Sin autorización a `wsfex`, el error es `WSFEX_SERVICE_NOT_AUTHORIZED`.
+- **Defaults de la `E`:** sin flags, la exportación sale de servicios (`Tipo_expo` `2`), en dólares (`Moneda_Id` `DOL`), con la cotización de aduana que publica ARCA (si la del día todavía no salió, la última, con un aviso) y con forma de pago `Transferencia Internacional`. Las claves `moneda` y `cotizacion` de la config no aplican a exportación.
+- **Salida JSON de exportación:** el mismo resumen que A, B y C (`atajo: "fe"`, `tipoArca: 19`, `comprobante: "Factura de exportación E"`) más un bloque `exportacion` con cliente, destino, domicilio, actividad, incoterm, items y permisos; `solicitud` es el `Cmp` de WSFEX, con los nombres de ARCA. Forma exacta en [entrada y salida](docs/input-output.md#factura-de-exportación-e).
+- **PDF de exportación:** se guarda como `factura-e_<pv>-<numero>.pdf` con el diseño de exportación de `@arcasdk/pdf` y los mismos datos que la E de Comprobantes en línea: título `FACTURA DE EXPORTACIÓN`, items de WSFEX, país de destino, CUIT del país con su tipo de entidad, ID impositivo, divisa con su código ISO (`USD - Dólar Estadounidense`), forma y fecha de pago, incoterm y la leyenda `IVA EXENTO OPERACIÓN DE EXPORTACIÓN`, sin discriminar IVA.
+- **Factura E en el modo interactivo:** se elige en el mismo selector que A, B y C y tiene su propio asistente (cliente, país, tipo, monto, moneda, incoterm en bienes, pago, actividad y número), con vista previa, comando equivalente y PDF. Ver [modo interactivo](docs/modo-interactivo.md#factura-de-exportación-e).
+- **CUIT con dígito verificador y con o sin guiones en todos lados:** `arcli padron`, `arcli fce-obligado`, `--cuit`, `--cuil`, `--acuit`, `comprobanteAsociado.cuit` en el JSON, `config establecer cuit` y el modo interactivo aceptan `20-33333333-4` o `20333333334`, y rechazan un CUIT mal tipeado antes de llegar a ARCA. Antes `arcli padron 20-20179706-4` fallaba y nadie chequeaba el dígito verificador.
+- **Error `ARCA_LAST_VOUCHER_ERROR`:** si ARCA rechaza el pedido del último número (por ejemplo, con un punto de venta no habilitado para web service), la facturación y `arcli ultimos` cortan ahí con el mensaje de ARCA y una sugerencia. No se emite nada.
+- **Esc en las preguntas del CLI:** "¿Querés emitir … ahora?", que aparece sin `--emitir` en una terminal, ahora se cierra con Esc como un "no", igual que en el modo interactivo y en las preguntas del PDF.
+- **`numero` en el JSON de facturación:** el número que le tocó al comprobante emitido (`null` en una previsualización), y `solicitud` lo trae en `CbteDesde`/`CbteHasta`. El panel de texto muestra `Número: 00003-00000125`. Antes el número solo se veía con `--bruto`.
+- **Autocompletado con Tab** para bash, zsh y fish. Se instala con `arcli completado instalar`, que agrega una línea al archivo de inicio del shell (`~/.zshrc`, `~/.bashrc`…), y se saca con `arcli completado desinstalar`; también desde el modo interactivo, en Configuración → Autocompletado. Completa comandos y atajos, flags, valores (`--iva-receptor`, `--concepto`, `--alicuota`, `--moneda`, `--transferencia`, `--ac`), claves de config y sus valores, tablas de `parametros` y letras de las familias; donde va una ruta, archivos. No hay que reinstalarlo al actualizar arcli. Ver [Autocompletado](docs/cli-reference.md#autocompletado).
+
+### Cambiado
+
+- **Ayuda más corta y toda en español.** `arcli --ayuda` pasa de unas 145 líneas a 57: los 18 atajos van en una tabla familia × letra y `storybook` (herramienta de desarrollo) ya no aparece, aunque sigue funcionando. La ayuda de cada comprobante (`arcli fc --ayuda`) pasa de 177 a 79 líneas: muestra solo los flags que aplican a ese comprobante, menciona los alias en la opción principal (`punto de venta (alias: --pv)`) y ya no repite la tabla de parámetros. Los flags ocultos se siguen aceptando igual. "Usage", "Options", `[options]`, `<number>` y la descripción de `--version` ahora están en español.
+- **Errores de uso en español:** opción o comando desconocido, valor faltante y argumentos de más (`opción desconocida '--montoo' (¿quisiste decir --monto?)`). También en el `error` del JSON con `--json`; el `codigo` sigue siendo `INPUT_VALIDATION_ERROR`.
+- **Voseo y tildes en toda la salida:** mensajes, ayuda, modo interactivo y PDF ("Usá", "Revisá", "número", "configuración"). Los flags, claves de config, valores (`produccion`, `cotizacion`) y claves JSON no cambian. Si un script compara el texto de un mensaje de error en lugar de `codigo`, puede necesitar un ajuste.
+
+### Corregido
+
+- **Punto de venta inválido:** la facturación seguía con el número 1 y recién fallaba al emitir con un error confuso, y `arcli ultimos` mostraba que no había comprobantes. Ahora cortan con `ARCA_LAST_VOUCHER_ERROR`.
+- **Lote cortado antes de emitir:** si el lote se cortaba en el login o en el pedido del último número, el comprobante que falló no figuraba en `detalles.sinProcesar` de `BATCH_EMISSION_ERROR`, y reintentar solo esa lista lo perdía. Ahora figura. Si la emisión quedó sin confirmar, sigue en `sinConfirmar` y no en `sinProcesar`, como antes.
+- **IIBB en el PDF:** sin `emisor.iibb`, el PDF decía "Exento"; ahora muestra "-". Si sos exento, configuralo con `arcli config establecer emisor.iibb Exento`. La configuración guiada del modo interactivo ahora lo pregunta junto a los otros datos del emisor.
+- **Números con letras o notación científica:** `config establecer puntoVenta 3a` guardaba `3`, y `arcli consultar fc 1e3` buscaba el 1000. Ahora dan error, igual que en el modo interactivo.
+- **`arcli pdf instalar` colgado:** con un proxy que no responde, npm o la descarga del navegador no terminaban nunca. Ahora se cortan a los 5 y 15 minutos con `PDF_PLUGIN_INSTALL_ERROR`.
+- **`montoTotal` del JSON nunca se redondea:** con más de 2 decimales se redondeaba en silencio antes de validar (`1.005` se emitía por `$1`). Ahora da `INPUT_VALIDATION_ERROR` ("Use hasta 2 decimales"), igual que `--monto` y el resto de los importes.
+- **`consultarPadron false` se respeta siempre:** con un `ivaReceptor` en la config, facturar con `--cuit` igual consultaba el padrón y su condición IVA pisaba la de la config.
+- **Aviso falso en `avisos`:** "--descripcion, --receptor-nombre y --receptor-domicilio solo se usan en el PDF" salía sin haber pasado esos flags, cuando el nombre o el domicilio los había completado el padrón.
+- **Modo interactivo:** al generar el PDF, apretar Enter en el nombre o el domicilio del receptor borraba lo que había traído el padrón; ahora lo propone y Enter lo deja. En una FCE se informa el `aliasCbu` de la config, como con flags. Y si la config tiene una moneda extranjera, el comando equivalente de un comprobante en pesos lleva `--moneda ARS`, así al pegarlo hace lo mismo.
+- **Leyendas obligatorias en el PDF:** los comprobantes B ahora traen el bloque del Régimen de Transparencia Fiscal al Consumidor (Ley 27.743, RG 5614), con el IVA contenido, y los comprobantes A a un monotributista la leyenda de la RG 5003 sobre el crédito fiscal. Salen debajo del CAE. Ver [PDF](docs/pdf.md#leyendas-obligatorias).
+
+### Documentación
+
+- Nueva sección de la `E` en [referencia del CLI](docs/cli-reference.md#factura-de-exportación-e-wsfex) y en [reglas de validación](docs/validation-rules.md#factura-de-exportación-e); credenciales de WSFEX en [configuración](docs/configuration.md#certificados-de-exportación-wsfex); items, JSON y limitaciones (`--numero` obligatorio, sin notas E, sin lote) en [entrada y salida](docs/input-output.md), [PDF](docs/pdf.md) y [limitaciones](docs/limitations.md); el asistente de la `E` en [modo interactivo](docs/modo-interactivo.md) y sus problemas comunes en [troubleshooting](docs/troubleshooting.md).
+
+## [2.1.0] - 2026-10-23
+
+Trae `arcli padron` y el IVA receptor desde el padrón al facturar con `--cuit`, el aviso de vencimiento del certificado y una guía para el punto de venta de web service. Además corrige un montón de cosas que salen de una revisión del repo: el JSON de `--cargar` se valida clave por clave, los errores con `--json` tienen siempre la misma forma, y los ejemplos de la ayuda y de los docs se pueden copiar y andan.
+
+Algunos cambios rompen scripts que dependían del comportamiento anterior. Revisá la sección "Cambiado":
+
+- **Exit code `2`** cuando ARCA rechaza un comprobante (antes, `0`).
+- **Validación estricta del JSON de `--cargar`:** una clave desconocida o con otro tipo ahora es error.
+- **Un array de un elemento en `--cargar`** sale como array.
+- **`--bruto`** agrega `respuesta` en lugar de reemplazar el resumen.
+- **`config revisar`** ya no recibe `--testing` ni `--produccion`.
+- **Los PDFs** se guardan en una subcarpeta por CUIT.
+
+Los comandos, los flags de facturación y las claves de config siguen siendo los mismos.
+
+### Agregado
+
+- **`arcli padron <cuit>`:** nombre o razón social, domicilio fiscal, condición IVA, impuestos, categoría de monotributo y actividad de un CUIT, desde el padrón de ARCA (`ws_sr_constancia_inscripcion`). Con `--json` para scripts.
+- **IVA receptor desde el padrón:** al facturar con `--cuit` y sin `--ir`, ARCLI usa la condición IVA del padrón, antes que el `ivaReceptor` de la config. También completa el nombre y el domicilio del receptor para el PDF. Si el padrón no responde o no la informa, sigue con la config y avisa. El modo interactivo propone la misma condición al cargar un CUIT. Se desactiva con `arcli config establecer consultarPadron false`.
+- **Aviso de vencimiento del certificado:** a menos de 30 días de vencer cualquiera de los certificados configurados (testing o producción, sin importar con cuál estés trabajando), los comandos que van a ARCA (facturación, `ultimos`, `consultar`, `padron`, `fce-obligado`, `parametros`, `estado`) avisan al principio, en stderr: `El certificado de produccion vence el 20/11/2026 (en 10 días)`, con el link a la [guía para renovarlo](docs/obtencion-certificados.md). Con `--json`, stdout queda solo con el JSON y en facturación el aviso va también en `avisos`. En el modo interactivo es un recuadro debajo de la barra de estado. Si vencen los dos, van en el mismo recuadro. Si ya venció el del entorno que se usa, cortan antes de autenticar en ARCA con el error `CERTIFICATE_EXPIRED` (antes fallaba el login en WSAA con un error inesperado).
+- **Punto de venta para web service:** si ARCA rechaza el comprobante porque el punto de venta no es de web service (error `10005`), la `sugerencia` lo dice y apunta a la [guía para crear uno](docs/obtencion-certificados.md#punto-de-venta-para-web-service). `arcli estado` avisa lo mismo cuando el punto de venta configurado no está entre los habilitados. Desde el 1/11/2026 ARCA da de alta de oficio puntos de venta "Factura en línea" a monotributistas (RG 5893/2026), y esos no sirven para arcli.
+
+### Cambiado
+
+- **`--bruto` agrega la respuesta cruda sin quitar el resumen:** con `--json --bruto` ahora salen `cae`, `caeVencimiento`, `estado`, `resultado`, `errores`, `observaciones` y el resto del JSON de siempre, más `respuesta` con la respuesta cruda de ARCA. Antes `--bruto` reemplazaba el resumen y esos campos desaparecían, aunque la documentación decía que agregaba. En texto pasa lo mismo: el resultado se muestra como siempre y el panel `Respuesta bruta` va al final. Vale igual para `bruto=true` en la config.
+- **Un array de un elemento en `--cargar` es un lote:** si el JSON es un array sale un array (con `indice`) y los errores son `BATCH_VALIDATION_ERROR` / `BATCH_EMISSION_ERROR`, tenga uno o muchos elementos. Antes un array de un elemento salía como objeto y con los errores de un comprobante suelto. Un objeto sigue devolviendo un objeto. Si un script leía `[0]` solo cuando había más de uno, ya puede leer siempre el array.
+- **El JSON de `--cargar` se valida clave por clave:** una clave desconocida (`"montototal"`, `"vencimiento"`, `"moneda"`) o un valor con otro tipo (`"puntoVenta": "3"`, `"emitir": "true"`, `null`) ahora es error de entrada (`INPUT_VALIDATION_ERROR`, o `BATCH_VALIDATION_ERROR` con el índice en un lote) que nombra la clave y sugiere la correcta. Antes se ignoraban sin aviso: con `"puntoVenta": "3"` se emitía en el punto de venta de la config. Si un archivo que te funcionaba ahora falla, corregí la clave o sacale las comillas al número; las claves documentadas siguen igual. Un lote vacío (`[]`) también es error: antes se ignoraba el archivo y se usaban solo los flags. La tabla de claves y su flag equivalente está en [entrada y salida](docs/input-output.md#flags-y-claves-del-json).
+- **`config revisar` revisa los dos entornos:** valida el entorno por defecto y cualquier otro que tenga `cert` o `key` configurados, cada uno en su línea (`Validacion testing`, `Validacion produccion`). La línea `Revision activa` del JSON ya no existe. Ya no recibe `--testing` ni `--produccion`: antes los aceptaba pero los ignoraba y revisaba siempre testing.
+- **Exit code `2` cuando ARCA rechaza un comprobante:** antes salía con `0` y había que leer `estado` para enterarse. En un lote, `2` si ARCA rechazó al menos uno. `observado` sigue saliendo con `0`. Si un script trataba cualquier exit distinto de `0` como error de ARCLI, ahora también corta en un rechazo.
+- **PDFs en una subcarpeta por CUIT emisor:** `~/arcli/comprobantes/20123456789/factura-c_0003-00000125.pdf` (en testing, `testing/20123456789/`). Si el archivo ya existe no se pisa: se guarda con `-2`, `-3` y así.
+- **`sugerencia` siempre en el JSON de error:** todos los errores con `--json` traen las mismas cuatro claves (`codigo`, `detalles`, `error`, `sugerencia`), con `sugerencia: null` cuando no hay nada que sugerir. Antes faltaba en los errores sin sugerencia (`CONFIGURATION_ERROR`, `INPUT_VALIDATION_ERROR`…) y era `null` solo en los inesperados. Si un script chequeaba si la clave existe, ahora tiene que chequear si es `null`.
+- **`--bruto` solo en los comandos de facturación:** `padron`, `fce-obligado`, `ultimos`, `consultar`, `parametros`, `estado` e `interactivo` ya no lo declaran (no lo usaban): pasado ahí, el comando corre igual y avisa en stderr que se ignora. Ya no aparece en su ayuda.
+- **`arcli interactivo --json` ya no falla:** el asistente acepta solo `--testing` y `--produccion`; `--json` y `--bruto` se ignoran con un aviso. Sin terminal interactiva sigue fallando, con o sin `--json`.
+- **Comando equivalente del modo interactivo:** siempre lleva `--testing` o `--produccion`. Antes, en testing no llevaba nada, y si la config pasaba a producción el comando pegado emitía ahí.
+
+### Corregido
+
+- **Ejemplos de la ayuda y de los docs que fallaban:** los ejemplos de `--ayuda` de las notas B y C, las B, las FCE y las familias, las NC/ND FCE de `arcli ejemplos` y varios de los docs (`pdf.md`, `usage-patterns.md`, `cli-reference.md`, el JSON de `llms.txt` y de `input-output.md`) daban error al copiarlos: asociado de otra letra, IVA receptor que la letra no admite, FCE sin `--cbu` o con `--acuit` ajeno, fechas fijas viejas o sin IVA receptor. Ahora cada nota asocia una factura de su letra y categoría, y un test pasa todos los ejemplos por el parser y arma la solicitud a ARCA.
+- **"Puede haberse emitido" cuando seguro no se emitió:** un certificado vencido, un fallo de login en WSAA o un error al pedir el último número salían como `EMISSION_UNCERTAIN`, con la sugerencia de verificar con `arcli ultimos` antes de reintentar. En esos casos no llegó nada a ARCA: ahora salen con su error (`UNEXPECTED_ERROR` o `TRANSIENT_ERROR` en el JSON) y se puede reintentar directo. `EMISSION_UNCERTAIN` queda solo para un fallo en la llamada que emite (red, timeout, transacción activa). En un lote, ese caso ya no suma `detalles.sinConfirmar`.
+- **Lote interrumpido, PDFs de los ya emitidos:** si un lote se cortaba a mitad, los comprobantes que ya tenían CAE quedaban sin PDF. Ahora se generan antes de mostrar el error, según `pdf` o `--exportar-pdf` como en un lote completo, y en `--json` cada uno lleva su campo `pdf`. Si falla el PDF, el error que se muestra sigue siendo el de la emisión.
+- **Lote, fallos del padrón o de la cotización con su índice:** si la consulta al padrón (IVA receptor desde `--cuit`) o a la cotización oficial fallaba para un ítem, el lote cortaba con un error que no decía cuál era. Ahora sale en `BATCH_VALIDATION_ERROR`, junto con los demás ítems con problemas y su `#n`, antes de emitir ninguno.
+- **`config.json` con JSON inválido** salía como "Error inesperado", sin decir qué archivo ni qué hacer. Ahora es un error de configuración (`CONFIGURATION_ERROR`) con la ruta del archivo y la sugerencia de corregirlo a mano o renombrarlo y volver a configurar. ARCLI no lo borra ni lo pisa.
+- **`json=true` de la config en todos los comandos:** `pdf` (y sus subcomandos) y `parametros` sin tabla solo salían en JSON con `--json`. Ahora todos los comandos resuelven la salida igual: `--json` o, si no está, la clave `json` de la config. `config ruta` acepta `--json` y devuelve `{"ruta": "..."}`.
+- **Errores de uso en JSON:** una opción desconocida (`arcli fc --montoo 1 --json`), un valor faltante o un comando que no existe salían en texto aunque se pidiera JSON. Ahora, con `--json` o `json=true`, salen como `INPUT_VALIDATION_ERROR` en el mismo formato que el resto de los errores, con exit code `1`. Sin JSON se ven igual que antes.
+- **Opciones globales que no aplican:** `--testing`, `--produccion`, `--json` o `--bruto` en un comando que no las usa (`arcli config ruta --produccion`) se aceptaban sin decir nada. Ahora el comando corre igual y avisa en stderr que la opción se ignora.
+- **`json=true` en `config`:** `config`, `config revisar`, `config establecer` y `config eliminar` respetan `json=true` de la config, como el resto de los comandos.
+- **`--dia` corría un mes de más** a fin de mes: `--dia 15` el 31/03 daba el 15/05 en vez del 15/04, y ARCA lo aceptaba con las fechas de servicio y vencimiento equivocadas. Si el día no existe en ese mes (`--dia 31` con abril), ahora da error.
+- **`--json` con `FORCE_COLOR`:** con `FORCE_COLOR=1` en el entorno, el JSON redirigido a un archivo o a otro programa salía con colores y no se podía parsear. Ahora solo se colorea en una terminal.
+- **`--json` en `config`:** `config`, `config revisar`, `config establecer` y `config eliminar` ignoraban `--json` y salían en texto.
+- **`config --ayuda` listaba la mitad de las claves:** mostraba 15 de 30. Ahora `config --ayuda` y `config establecer --ayuda` listan todas, por sección, con sus valores posibles.
+- **Links de `llms.txt` y del README en el paquete de npm:** apuntaban a `docs/`, que no se publica en npm. Ahora son links a GitHub.
+- **`config establecer` con un valor inválido** (`puntoVenta abc`, `comprobantesPorLista 99`) sale como error de entrada (`INPUT_VALIDATION_ERROR`) y no como error inesperado.
+
 ## [2.0.0] - 2026-10-12
 
 Versión mayor: sale de una auditoría del proyecto. Lo que rompe es cómo se escriben algunos valores en los flags:
@@ -285,7 +388,9 @@ Primera versión publicada en npm.
 - `llms.txt`: referencia condensada para que un agente de IA con acceso a terminal ejecute el CLI.
 - Publicación con npm Trusted Publishers (OIDC).
 
-[Sin publicar]: https://github.com/LcsGrz/arcli/compare/v2.0.0...HEAD
+[Sin publicar]: https://github.com/LcsGrz/arcli/compare/v2.2.0...HEAD
+[2.2.0]: https://github.com/LcsGrz/arcli/compare/v2.1.0...v2.2.0
+[2.1.0]: https://github.com/LcsGrz/arcli/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/LcsGrz/arcli/compare/v1.8.0...v2.0.0
 [1.8.0]: https://github.com/LcsGrz/arcli/compare/v1.7.1...v1.8.0
 [1.7.1]: https://github.com/LcsGrz/arcli/compare/v1.7.0...v1.7.1

package/README.md

@@ -17,9 +17,11 @@ CLI para previsualizar y emitir comprobantes electrónicos de ARCA (ex AFIP) des
 - **Modo interactivo:** `arcli` sin argumentos abre un asistente que guía la emisión, repite facturas anteriores, arma notas de crédito y débito, consulta comprobantes y configura el CLI. Cada paso muestra el comando equivalente.
 - **Vista previa por defecto:** sin `--emitir`, muestra la solicitud y, en una terminal, pregunta antes de emitir.
 - **Comprobantes:** Factura, Nota de Crédito y Nota de Débito A, B y C, y sus versiones de Factura de Crédito Electrónica (FCE), con CBU, transferencia, anulación y consulta del régimen del receptor.
+- **Factura de exportación E:** `arcli fe` emite con WSFEX, con cliente y país de destino, incoterm, items detallados y permisos de embarque; acepta certificado propio con `exportacion.cert.*` / `exportacion.key.*`.
 - **Entrada y salida flexibles:** flags o JSON (incluso lotes); salida legible, `--json` o respuesta bruta de ARCA.
 - **Validaciones locales** basadas en el manual de ARCA, para detectar errores antes de llamar al servicio.
-- **Consultas sin emitir:** últimos comprobantes, detalle de uno, estado de los servidores, tablas de parámetros y cotización oficial.
+- **Consultas sin emitir:** últimos comprobantes, detalle de uno, estado de los servidores, tablas de parámetros, cotización oficial y padrón de un CUIT.
+- **IVA receptor automático:** con `--cuit` y sin `--ir`, toma la condición IVA del padrón de ARCA.
 - **PDF con el QR de ARCA** mediante un plugin que se descarga solo si lo usás.
 
 ## Instalación
@@ -30,9 +32,11 @@ Requiere Node.js 22.22.1 o superior.
 npm install -g arcli
 ```
 
+Opcional: autocompletado con Tab de comandos, flags y valores, en bash, zsh o fish. Se instala con `arcli completado instalar` y se saca con `arcli completado desinstalar` ([detalle](docs/cli-reference.md#autocompletado)).
+
 ## Configuración
 
-Necesitás tu CUIT, un punto de venta y un certificado con su clave privada de ARCA. Si todavía no los tenés, seguí [Cómo obtener los certificados](docs/obtencion-certificados.md).
+Necesitás tu CUIT, un punto de venta y un certificado con su clave privada de ARCA. Si todavía no los tenés, seguí [Cómo obtener los certificados](https://github.com/LcsGrz/arcli/blob/main/docs/obtencion-certificados.md).
 
 Lo más simple es correr `arcli` y seguir la configuración guiada. Para hacerlo por comandos (por ejemplo, en un servidor):
 
@@ -44,7 +48,7 @@ arcli config establecer key.testing /ruta/a/la/clave.key
 arcli config revisar
 ```
 
-`arcli config revisar` verifica que el entorno activo esté listo para emitir. Todas las claves disponibles están en [Configuración](docs/configuration.md).
+`arcli config revisar` verifica que el entorno activo esté listo para emitir. Todas las claves disponibles están en [Configuración](https://github.com/LcsGrz/arcli/blob/main/docs/configuration.md).
 
 ## Uso
 
@@ -53,13 +57,15 @@ arcli fc -m 15000 --cs --consumidor-final --ir-cf            # vista previa de u
 arcli fc -m 15000 --cs --consumidor-final --ir-cf --emitir   # emitir
 arcli fc --cargar ./facturas.json --emitir --json            # lote desde JSON, salida JSON
 arcli fc -m 15000 --cs --consumidor-final --ir-cf --emitir --exportar-pdf
+arcli fe -m 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 203 \
+  --numero 1 --actividad 620100 --previsualizar                             # Factura de exportación E
 ```
 
-Otras consultas: `arcli ultimos`, `arcli consultar`, `arcli estado`, `arcli parametros`, `arcli fce-obligado`. Para ver todos los comprobantes y ejemplos: `arcli --ayuda` y `arcli ejemplos`.
+Otras consultas: `arcli ultimos`, `arcli consultar`, `arcli estado`, `arcli parametros`, `arcli fce-obligado`, `arcli padron`. Para ver todos los comprobantes y ejemplos: `arcli --ayuda` y `arcli ejemplos`.
 
 <p align="center"><img src="https://raw.githubusercontent.com/LcsGrz/arcli/main/docs/assets/demo/comandos.gif" alt="Vista previa de una Factura C y emisión con salida JSON filtrada con jq" width="760"></p>
 
-La prioridad de los valores es `flags > JSON > config > defaults`. Ver el [modelo mental](docs/mental-model.md) y la [referencia del CLI](docs/cli-reference.md).
+La prioridad de los valores es `flags > JSON > config > defaults`. Ver el [modelo mental](https://github.com/LcsGrz/arcli/blob/main/docs/mental-model.md) y la [referencia del CLI](https://github.com/LcsGrz/arcli/blob/main/docs/cli-reference.md).
 
 ### Testing y producción
 
@@ -67,14 +73,14 @@ Por defecto se usa el entorno `testing`, con `cert.testing` y `key.testing`. Par
 
 ## Documentación
 
-El índice completo está en [docs/](docs/README.md). Lo principal:
+El índice completo está en [docs/](https://github.com/LcsGrz/arcli/blob/main/docs/README.md). Lo principal:
 
-- [Modo interactivo](docs/modo-interactivo.md) y [Patrones de uso](docs/usage-patterns.md)
-- [Referencia del CLI](docs/cli-reference.md) y [Configuración](docs/configuration.md)
-- [Entrada y salida](docs/input-output.md): formato del JSON
-- [PDF de comprobantes](docs/pdf.md)
-- [Cómo obtener los certificados](docs/obtencion-certificados.md)
-- [Troubleshooting](docs/troubleshooting.md), [Reglas de validación](docs/validation-rules.md) y [Limitaciones](docs/limitations.md)
+- [Modo interactivo](https://github.com/LcsGrz/arcli/blob/main/docs/modo-interactivo.md) y [Patrones de uso](https://github.com/LcsGrz/arcli/blob/main/docs/usage-patterns.md)
+- [Referencia del CLI](https://github.com/LcsGrz/arcli/blob/main/docs/cli-reference.md) y [Configuración](https://github.com/LcsGrz/arcli/blob/main/docs/configuration.md)
+- [Entrada y salida](https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md): formato del JSON
+- [PDF de comprobantes](https://github.com/LcsGrz/arcli/blob/main/docs/pdf.md)
+- [Cómo obtener los certificados](https://github.com/LcsGrz/arcli/blob/main/docs/obtencion-certificados.md)
+- [Troubleshooting](https://github.com/LcsGrz/arcli/blob/main/docs/troubleshooting.md), [Reglas de validación](https://github.com/LcsGrz/arcli/blob/main/docs/validation-rules.md) y [Limitaciones](https://github.com/LcsGrz/arcli/blob/main/docs/limitations.md)
 - [llms.txt](llms.txt): referencia condensada para agentes de IA con acceso a terminal
 - [Changelog](CHANGELOG.md)
 
@@ -87,16 +93,17 @@ yarn install
 yarn dev --ayuda
 ```
 
-Antes de abrir un PR: `yarn typecheck`, `yarn lint` y `yarn test`. Más en la [guía de desarrollo](docs/development.md) y la [arquitectura](docs/architecture.md).
+Antes de abrir un PR: `yarn typecheck`, `yarn lint` y `yarn test`. Más en la [guía de desarrollo](https://github.com/LcsGrz/arcli/blob/main/docs/development.md) y la [arquitectura](https://github.com/LcsGrz/arcli/blob/main/docs/architecture.md).
 
 ## Contribuir
 
-Leé [CONTRIBUTING.md](CONTRIBUTING.md). Para vulnerabilidades, ver [SECURITY.md](SECURITY.md); no subas certificados, claves ni tokens reales a issues ni PRs.
+Leé [CONTRIBUTING.md](https://github.com/LcsGrz/arcli/blob/main/CONTRIBUTING.md). Para vulnerabilidades, ver [SECURITY.md](https://github.com/LcsGrz/arcli/blob/main/SECURITY.md); no subas certificados, claves ni tokens reales a issues ni PRs.
 
 ## Agradecimientos
 
 - [`@arcasdk/core`](https://github.com/ralcorta/arcasdk) y [`@arcasdk/pdf`](https://www.afipts.com/packages/pdf), de [Rodrigo Alcorta](https://github.com/ralcorta).
 - [Arpit Bhayani](https://github.com/arpitbbhayani), por ceder el nombre `arcli` en npm.
+- [Manuel Aller](https://github.com/itManuel), por la factura de exportación E.
 
 Si el proyecto te resulta útil, podés dejar una estrella o invitarme un [Cafecito](https://cafecito.app/lcsgrz).
 

package/dist/cli/arca-runtime.js

@@ -0,0 +1,41 @@
+import { CERTIFICATE_GUIDE_URL } from '../lib/links.js';
+import { ArcaContextResolver } from '../services/arca/arca-context.resolver.js';
+import { certificateBanner, writeTerminalNotice } from '../ui/index.js';
+/**
+ * Un solo recuadro con todos los certificados por vencer o vencidos, una linea por entorno y el link una vez. En
+ * rojo si alguno vencio. Lo usan los comandos y el modo interactivo.
+ */
+export function renderCertificateNotices(notices) {
+    if (notices.length === 0) {
+        return undefined;
+    }
+    return certificateBanner({
+        expired: notices.some((notice) => notice.expired),
+        guideUrl: CERTIFICATE_GUIDE_URL,
+        summary: notices.map((notice) => notice.summary).join('\n'),
+    });
+}
+/**
+ * Aviso de los certificados por vencer o vencidos, de cualquier entorno, al principio del comando. Va a stderr:
+ * con `--json` stdout queda solo para el JSON. Si vencio el del entorno activo y hay `--json`, no se escribe: el
+ * error JSON de `CERTIFICATE_EXPIRED` (tambien en stderr) ya lo dice, y un texto antes lo romperia.
+ */
+export function writeCertificateNotice(runtime) {
+    if (runtime.certificateExpiry?.expired && runtime.outputJson) {
+        return;
+    }
+    const banner = renderCertificateNotices(runtime.certificateNotices);
+    if (banner) {
+        writeTerminalNotice(banner);
+    }
+}
+/** Lo que se suma a `avisos` en el JSON de facturacion. En texto el aviso ya salio arriba: no se repite. */
+export function certificateWarnings(runtime) {
+    return runtime.outputJson ? runtime.certificateNotices.map((notice) => notice.message) : [];
+}
+/** Config, credenciales y aviso del certificado: el paso comun de los comandos que van a ARCA. */
+export function resolveArcaRuntime(options) {
+    const runtime = new ArcaContextResolver({ options }).resolve();
+    writeCertificateNotice(runtime);
+    return runtime;
+}

package/dist/cli/commands/billing-family.command.js

@@ -1,30 +1,57 @@
 import { InputValidationError } from '../../lib/errors/app-error.js';
 import { getVoucherKindByFamilyAndLetter, VOUCHER_FAMILIES, VOUCHER_KIND_MAP, VOUCHER_LETTERS, } from '../../modules/billing/voucher-kind-map.js';
+import { EXPORT_VOUCHER_KIND } from '../../modules/export/export.types.js';
 import { configureSpanishHelp, createFamilyHelp } from '../help.js';
+import { GLOBAL_OPTION_FLAGS } from '../ignored-global-options.js';
+import { findPassedOptions, formatSkippedOptionsWarning } from '../skipped-options.js';
+import { hideInapplicableBillingOptions } from './billing.command.options.js';
 import { executeBillingCommand, registerBillingCommandOptions } from './billing.command.shared.js';
+import { executeExportCommand } from './export.command.js';
+import { EXPORT_OPTION_FLAGS, registerExportOptions } from './export.command.options.js';
+function skippedWarnings(command, options, voucherLabel) {
+    const flags = findPassedOptions(command, options);
+    return flags.length > 0 ? [formatSkippedOptionsWarning(flags, voucherLabel)] : [];
+}
 export function registerBillingFamilyCommands(program) {
     for (const family of VOUCHER_FAMILIES) {
-        const familyShortcuts = Object.values(VOUCHER_KIND_MAP)
-            .filter((definition) => definition.family === family)
-            .map((definition) => definition.shortcut)
-            .join(', ');
+        const definitions = Object.values(VOUCHER_KIND_MAP).filter((definition) => definition.family === family);
+        const familyShortcuts = definitions.map((definition) => definition.shortcut).join(', ');
+        // La familia `factura` tambien acepta la letra E, que se emite por WSFEX.
+        const supportsExport = family === EXPORT_VOUCHER_KIND.family;
+        const shortcuts = supportsExport ? `${familyShortcuts}, ${EXPORT_VOUCHER_KIND.shortcut}` : familyShortcuts;
         const command = program
-            .command(family)
-            .description(`usar ${family} por letra A, B o C con ejemplos y atajos${familyShortcuts ? ` (${familyShortcuts})` : ''}`)
+            .command(family, { hidden: true })
+            .description(`usar ${family} por letra A, B${supportsExport ? ', C o E' : ' o C'} con ejemplos y atajos${shortcuts ? ` (${shortcuts})` : ''}`)
             .argument('<letra>', 'letra del comprobante', (value) => value.toLowerCase());
         configureSpanishHelp(command);
         registerBillingCommandOptions(command);
+        hideInapplicableBillingOptions(command, {
+            isElectronicCredit: definitions.some((definition) => definition.isElectronicCredit),
+            isNote: definitions.some((definition) => definition.requiresAssociatedVoucher),
+            letters: definitions.map((definition) => definition.letter),
+        });
+        // Un solo comando para A, B, C y E: acepta los flags de todas y saltea con un aviso los que no aplican a la letra.
+        const billingOnlyOptions = command.options.filter((option) => !EXPORT_OPTION_FLAGS.has(option.long ?? '') &&
+            !GLOBAL_OPTION_FLAGS.includes(option.long ?? ''));
+        const exportOnlyOptions = supportsExport ? registerExportOptions(command, { hidden: true }) : [];
         command.action(async (letter) => {
+            if (supportsExport && letter === EXPORT_VOUCHER_KIND.letter) {
+                await executeExportCommand(command, {
+                    extraWarnings: skippedWarnings(command, billingOnlyOptions, EXPORT_VOUCHER_KIND.displayName),
+                });
+                return;
+            }
             if (!VOUCHER_LETTERS.includes(letter)) {
-                throw new InputValidationError(`La letra "${letter}" no es valida. Use a, b o c.`);
+                throw new InputValidationError(`La letra "${letter}" no es válida. Usá a, b${supportsExport ? ', c o e' : ' o c'}.`);
             }
             const definition = getVoucherKindByFamilyAndLetter(family, letter);
             if (!definition) {
                 throw new InputValidationError(`No existe un comprobante para la familia "${family}" y letra "${letter}".`);
             }
-            await executeBillingCommand(command, definition.shortcut);
+            await executeBillingCommand(command, definition.shortcut, {
+                extraWarnings: skippedWarnings(command, exportOnlyOptions, definition.displayName),
+            });
         });
         command.addHelpText('after', createFamilyHelp(family));
     }
 }
-//# sourceMappingURL=billing-family.command.js.map

package/dist/cli/commands/billing-shortcuts.command.js

@@ -1,18 +1,24 @@
 import { VOUCHER_KIND_MAP, VOUCHER_SHORTCUTS } from '../../modules/billing/voucher-kind-map.js';
 import { configureSpanishHelp, createShortcutHelp } from '../help.js';
+import { hideInapplicableBillingOptions } from './billing.command.options.js';
 import { executeBillingCommand, registerBillingCommandOptions } from './billing.command.shared.js';
 export function registerBillingShortcutCommands(program) {
     for (const shortcut of VOUCHER_SHORTCUTS) {
         const definition = VOUCHER_KIND_MAP[shortcut];
+        // Ocultos en la lista de comandos: la ayuda principal los muestra en una tabla por familia y letra.
         const command = program
-            .command(shortcut)
+            .command(shortcut, { hidden: true })
             .description(`${definition.displayName} por shortcut, con ayuda guiada para previsualizar o emitir`);
         configureSpanishHelp(command);
         registerBillingCommandOptions(command);
+        hideInapplicableBillingOptions(command, {
+            isElectronicCredit: definition.isElectronicCredit,
+            isNote: definition.requiresAssociatedVoucher,
+            letters: [definition.letter],
+        });
         command.action(async () => {
             await executeBillingCommand(command, shortcut);
         });
         command.addHelpText('after', createShortcutHelp(shortcut));
     }
 }
-//# sourceMappingURL=billing-shortcuts.command.js.map

package/dist/cli/commands/billing.command.batch.js

@@ -1,28 +1,40 @@
 import { BatchEmissionError, BatchValidationError, describeBatchItemError, } from '../../modules/billing/billing.batch.js';
 /**
- * En un lote, valida todos los comprobantes antes de emitir el primero. `validate` tira si el item es
- * invalido (lectura del JSON o reglas de negocio). Si alguno falla, no se emite ninguno y se informan todos.
+ * Prepara un lote antes de emitir: `resolve` completa cada item con lo que hay que consultar en ARCA (IVA
+ * receptor del padron, cotizacion) y `validate` aplica las reglas de negocio sobre lo resuelto. En un lote
+ * no corta en el primer fallo: junta todos, con su indice, en un solo `BatchValidationError`, y no se emite
+ * ninguno. Con un comprobante suelto (no un array) el error sale tal cual, como siempre.
  */
-export function validateBatchBeforeEmitting(plan, inputs, validate) {
-    if (plan.total === 1) {
-        return;
+export async function prepareBatch(options) {
+    const { inputs, plan, resolve, validate } = options;
+    const resolved = [];
+    if (!plan.isBatch) {
+        // Secuencial a proposito: cada servicio de ARCA reutiliza su ticket WSAA.
+        for (const [position, input] of inputs.entries()) {
+            resolved.push(await resolve(input, position));
+        }
+        return resolved;
     }
     const errors = [...plan.invalidItems];
-    inputs.forEach((input, position) => {
+    for (const [position, input] of inputs.entries()) {
         try {
-            validate(input);
+            const item = await resolve(input, position);
+            validate(item);
+            resolved.push(item);
         }
         catch (error) {
             errors.push({ index: plan.inputIndexes[position] ?? position + 1, message: describeBatchItemError(error) });
         }
-    });
+    }
     if (errors.length > 0) {
         throw new BatchValidationError([...errors].sort((left, right) => left.index - right.index), plan.total);
     }
+    return resolved;
 }
 /**
  * Emite los items en orden. Si uno falla a mitad del lote, entrega lo ya procesado a `onPartialResults`
- * antes de cortar: si no se mostrara, alguien volveria a correr el lote y duplicaria comprobantes.
+ * antes de cortar: si no se mostrara, alguien volveria a correr el lote y duplicaria comprobantes. Se
+ * espera a que termine (puede generar los PDFs de los ya emitidos), y si falla no tapa el error de emision.
  */
 export async function emitBatch(options) {
     const { emit, inputs, onPartialResults, plan } = options;
@@ -32,11 +44,16 @@ export async function emitBatch(options) {
             results.push(await emit(input, position));
         }
         catch (error) {
-            if (plan.total === 1) {
+            if (!plan.isBatch) {
                 throw error;
             }
             if (results.length > 0) {
-                onPartialResults(results);
+                try {
+                    await onPartialResults(results);
+                }
+                catch {
+                    // Lo importante es el error de emision: los ya emitidos se pueden ver con "arcli ultimos".
+                }
             }
             throw new BatchEmissionError({
                 cause: error,
@@ -48,4 +65,3 @@ export async function emitBatch(options) {
     }
     return results;
 }
-//# sourceMappingURL=billing.command.batch.js.map

package/dist/cli/commands/billing.command.interactive-preview.js

@@ -1,15 +1,12 @@
-import select from '@inquirer/select';
 import { writeTerminalOutput } from '../../ui/index.js';
+import { chooseOne } from '../interactive/prompts.js';
 import { formatBillingOutputs } from './billing.command.output.js';
+/** Esc cuenta como no, igual que en el modo interactivo. */
 async function promptForEmission(count, voucherLabel) {
-    return select({
-        choices: [
-            { name: 'Si, emitir ahora', value: true },
-            { name: 'No, dejar sin emitir', value: false },
-        ],
-        default: true,
-        message: count > 1 ? `¿Desea emitir los ${count} comprobantes ahora?` : `¿Desea emitir ${voucherLabel} ahora?`,
-    });
+    return chooseOne(count > 1 ? `¿Querés emitir los ${count} comprobantes ahora?` : `¿Querés emitir ${voucherLabel} ahora?`, [
+        { name: 'Sí, emitir ahora', value: true },
+        { name: 'No, dejar sin emitir', value: false },
+    ], true, { escapeLabel: 'no emitir', escapeValue: false });
 }
 function applyEmitDecision(inputs, shouldEmit) {
     return inputs.map((input) => ({
@@ -33,11 +30,14 @@ export async function runInteractiveBillingPreview(options) {
         };
     }
     const previewGateway = {
-        createNextVoucher: async () => {
-            throw new Error('No deberia ejecutarse la emision real durante la vista previa.');
+        createVoucher: async () => {
+            throw new Error('No debería ejecutarse la emisión real durante la vista previa.');
+        },
+        getNextVoucherNumber: async () => {
+            throw new Error('No debería ejecutarse la emisión real durante la vista previa.');
         },
         getQuotation: async () => {
-            throw new Error('La cotizacion se resuelve antes de la vista previa.');
+            throw new Error('La cotización se resuelve antes de la vista previa.');
         },
     };
     const previewResults = [];
@@ -66,4 +66,3 @@ export async function runInteractiveBillingPreview(options) {
         proceed: true,
     };
 }
-//# sourceMappingURL=billing.command.interactive-preview.js.map