Novedades de cada versión
Todos los cambios relevantes de ARCLI se documentan acá.
El formato sigue Keep a Changelog y el proyecto usa versionado semántico. Como el contrato del CLI es público (comandos, flags, claves de config y JSON), cada entrada aclara qué cambia para quien ya lo usa.
17/11/2026
Completa lo que trajo la 2: las notas de crédito y débito de la factura de exportación E, el modo interactivo al nivel del CLI (consultas, opcionales, repetir la E, el PDF al confirmar) y el sitio de documentación en arcli.com.ar. Puede afectar scripts:
- Una nota de crédito A, B, C o FCE mayor que su factura ahora frena antes de ir a ARCA con
INPUT_VALIDATION_ERROR. --afechaen las notas FCE y--numeroenfe,ndeyncedejan de ser obligatorios: sin ellos, ARCLI los toma de ARCA.arcli config --jsontraefilasPorListay, mientras dure la deprecación, tambiéncomprobantesPorListaydeprecado.- En
arcli certificado generar --json,guiaapunta a arcli.com.ar.
No cambian los nombres de comandos, flags ni claves existentes, ni las claves del --json y de --cargar, ni los codigo de error. Hay deprecaciones para la 3.0.0: ver “Deprecado”.
Agregado
Sección titulada «Agregado»- Clave de config
filasPorLista(1 a 50, por defecto 15): reemplaza acomprobantesPorLista, que ya no cuenta solo comprobantes sino también las filas de las tablas de ARCA y la lista de monedas del modo interactivo. Hace lo mismo: cuántas filas muestranarcli ultimos(sin--cantidad) y las listas del modo interactivo.arcli config establecer filasPorLista 25. - Consultas en el modo interactivo: “Consultar comprobantes” pasa a ser Consultas, con todo lo que el CLI consulta: Mis comprobantes (lo de antes), Datos de un CUIT (
arcli padron), Si un cliente recibe FCE (arcli fce-obligado, con la fecha de hoy), Cotización de una moneda y Tablas de ARCA (las nueve dearcli parametros). Después del padrón, Emitir una factura a este CUIT arranca la factura con el CUIT, el nombre, el domicilio y la condición IVA ya cargados. Las tablas largas y la lista de monedas se filtran escribiendo (eur,060ousd) y se desplazan con las flechas; las filas por página son las defilasPorLista. Un error de ARCA vuelve a Consultas en lugar de al menú. Configuración suma Dónde está la config (arcli config ruta). - Encabezado y ayuda en
arcli parametros <tabla>: el listado tiene una fila de encabezado (CÓDIGO, la descripción y, eniva-receptorypuntos-venta, una tercera columna) y al pie para qué sirve el código en ARCLI. Es salida humana: el--jsonno cambia. - Repetir una factura E en el modo interactivo: “Repetir un comprobante anterior” ahora ofrece la factura de exportación
E. Copia de la factura que devuelve ARCA el cliente, el destino, la moneda, el incoterm, los ítems, la forma de pago, el idioma y la actividad; sale con fecha de hoy y la cotización del día, y pregunta el monto, los permisos de embarque y la fecha de pago. Si algún ítem tiene bonificación o no suman el total, avisa y sale un renglón con el monto total. - Alias del CBU y guardar el CBU escrito a mano: si en una FCE del modo interactivo el CBU se escribe porque no está en la config, también pide el alias cuando falta
aliasCbu(Enter lo omite, como sin--alias), y al final ofrece guardar los dos (cbuyaliasCbu), como ya pasaba con la actividad de laE. - La E completa en el modo interactivo: la factura
Ey sus notas terminan con “¿Agregamos algún opcional?”, como A, B y C: ítems (descripción, cantidad, precio y unidad, uno por uno), idioma, observaciones y observaciones comerciales, descripción del incoterm y cotización a mano. La factura también deja elegir el CUIT del país y, si ARCA no publica uno para el destino, lo pide (se escribe o se busca el país por nombre): antes el asistente no tenía salida. Las notasEahora pueden ajustar otra notaE, no solo la factura. El comando equivalente incluye los flags nuevos (--item,--idioma,--cuit-pais,--observaciones,--obs-comerciales,--incoterms-desc,--cmy--ac). Sin marcar nada, todo sigue igual. - Más opciones en el modo interactivo: el paso de opcionales suma la fecha del comprobante (
--fecha), en facturas, recibos, notas y al repetir, con la misma ventana de días que el CLI según el concepto: sirve, por ejemplo, para facturar con fecha de fin de mes. El receptor se puede identificar por CUIL (en B y C), y la moneda extranjera ofrece euros y el resto de las monedas de ARCA, con la cotización acordada o la oficial. Las notas de crédito y débito tienen ahora sus opcionales: fechas de servicio y vencimiento (--sd,--sh,--vto), exento y no gravado en las parciales, y moneda en las de período. El comando equivalente incluye todos esos flags. - La E en “Consultar comprobantes” del modo interactivo: la lista de tipos ahora incluye la factura de exportación
Ey sus notas de crédito y débito (fe,nce,nde), con los últimos emitidos, Cargar más…, Ingresar el número a mano… y el mismo detalle quearcli consultar fe. Antes solo estaban los 19 tipos de A, B y C. - Permisos de embarque en el modo interactivo: la factura
Ede bienes pregunta los permisos de embarque ya existentes (opcional, separados por coma), igual que--permisocon--permiso-existente. Las notasEsobre una factura de bienes también los preguntan. ultimosyconsultarcon la E:arcli ultimos fe(tambiénndeynce) lista los últimos comprobantes de exportación yarcli consultar fe <numero>muestra uno, con cliente, destino, moneda, total y comprobante asociado. El JSON de la E tiene sus propias claves (cliente,destino,moneda,total,comprobanteAsociado), porque no tiene receptor con documento ni IVA.ARCLI_CONFIG_DIR: una variable de entorno para usar otra carpeta de config, con suconfig.json, tickets, plugins y certificados. Sirve para tener una config aparte sin tocar la de siempre. Sin la variable, todo sigue igual.- Notas de crédito y débito de exportación E:
arcli nceyarcli nde(tambiénarcli nota-credito eyarcli nota-debito e) ajustan una Factura de exportaciónEya emitida. Alcanza con el monto, el asociado (--ar, y--apvsi es de otro punto de venta) y--numero: el cliente, el destino, la moneda, la cotización y la actividad salen de la factura, que ARCLI consulta en ARCA. En las de bienes, los permisos de embarque son opcionales y van con--permiso, sin--permiso-existente. Antes de emitir valida lo que ARCA va a controlar contra el asociado: que exista, que la nota no sea anterior, que una nota de crédito no lo supere y, en servicios, el mismo destino, moneda y cotización. En--cargar,comprobanteAsociado; en el--json,exportacion.comprobanteAsociado(nullen la factura). También en el modo interactivo, al elegir la factura de exportación como comprobante original de una nota. No cambia nada de la facturaEni de A, B y C.
Cambiado
Sección titulada «Cambiado»- El PDF se elige al confirmar la emisión: cuando ARCLI pregunta “¿Emitimos…?” antes de emitir (sin
--emitir, en una terminal), en el CLI y en el modo interactivo, las opciones son siempre Sí, emitir ahora, Sí, emitir y generar el PDF y No, dejar sin emitir, diga lo que diga la configpdf, y lo elegido decide. Conpdf preguntar(el valor por defecto) ya no hay una segunda pregunta, “¿Generamos el PDF del comprobante?”, después de emitir. Conpdf siemprese puede emitir sin PDF (el cursor arranca en la opción con PDF), y conpdf nuncaaparece la opción para generarlo esa vez. Con--exportar-pdfo--sin-pdfel PDF ya está decidido y la pregunta solo ofrece emitir o no. Al emitir sin confirmar (--emitir,emitir true,--jsono sin terminal) todo sigue igual: decide la config. Vale para todos los comprobantes, también laE, sus notas y el Recibo C. - Una nota de crédito mayor que su factura ya no se emite: en una NC A, B, C o FCE, ARCLI consulta en ARCA el comprobante asociado antes de la vista previa y, si la nota supera su total (en la misma moneda), frena con un error de validación (
INPUT_VALIDATION_ERROR) que sugiere el--montopara anularla entera. Antes la mandaba igual y decidía ARCA. Es el mismo control que ya tenían las notasEy el modo interactivo, y ahora los tres dicen lo mismo:La nota de crédito por $ 150.000 no puede superar el total de la factura C 00003-00000045, de $ 120.000.La consulta es una por nota y se reusa al emitir. En un lote, el error sale con su índice antes de preguntar si se emite. Solo se consulta un asociado tuyo; con--acuitde otro CUIT no se controla, y si ARCA no responde la nota sigue con un aviso. --afechadeja de ser obligatoria en las notas FCE: enncea…ndec, sin--afecha, ARCLI toma la fecha del asociado de ARCA, como en las notasE, y la vista previa ya la muestra. Si la pasás, se sigue usando la tuya. Si ARCA no tiene el asociado o no responde, frena y sugiere pasar--afecha.--numerodeja de ser obligatorio enfe,ndeynce: sin el flag, ARCLI consulta en ARCA el último número de ese tipo en el punto de venta y usa el siguiente, también en la vista previa.--numero(onumeroen--cargar) sigue andando para fijarlo a mano. El modo interactivo ya no lo pregunta. Si una emisión de la E queda sin confirmar (EMISSION_UNCERTAIN), la sugerencia ahora también manda a verificarla conarcli consultar.- Mismos botones al emitir en el modo interactivo y en el CLI: el asistente pregunta “¿Emitimos…?” con Sí, emitir ahora y No, dejar sin emitir, como los comandos con flags (antes, “Emitir ahora” y “Cancelar”). En producción sigue pidiendo una segunda confirmación, ahora con Sí, emitir en producción y No, dejar sin emitir. El CLI con flags sigue preguntando una sola vez.
- El modo interactivo pide el punto de venta al empezar si la config no tiene uno: factura, recibo, factura
E, notas, repetir y consultar lo preguntan antes del primer paso, en lugar de completar todo y frenar al final con un error que hablaba de flags del CLI. El comando equivalente lo lleva con--pv. Con un punto de venta en la config, no cambia nada. - Listas del modo interactivo sin el atajo del comando: al elegir el comprobante (al emitir, en las notas y en Consultas) dice “Factura C” en lugar de “Factura C (fc)”. El comando se sigue mostrando al final, en el comando equivalente.
- Los links del CLI llevan al sitio de documentación: las guías que nombran los mensajes (certificado, punto de venta para web service, problemas frecuentes y novedades) abren su página en arcli.com.ar en lugar del archivo en GitHub. El aviso de un certificado de producción por vencer lleva a cómo renovarlo.
arcli --ayudasumaDocumentación: https://arcli.com.ar, y el modo interactivo lo muestra al empezar la configuración guiada y al salir. Enarcli certificado generar --json, el campoguiatrae la URL nueva; los campos no cambian.
Deprecado
Sección titulada «Deprecado»comprobantesPorLista, ahorafilasPorLista; se saca en la 3.0.0. Hasta entonces se sigue leyendo del archivo de config (si están las dos, ganafilasPorLista),arcli config establecer comprobantesPorLista Navisa y guardafilasPorLista(y saca la vieja), yarcli config --jsontrae las dos con el mismo valor, másdeprecado.
Arreglado
Sección titulada «Arreglado»- Datos vacíos del receptor en el PDF: a un consumidor final sin identificar, el PDF muestra
Documento: -en lugar deDocumento: - -, y sin domicilio,Domicilio: -. Lo mismo con el nombre de un receptor identificado que no lo tiene cargado. Vale para A, B, C y el Recibo C. - El comando equivalente del modo interactivo saca el mismo PDF: con un CUIT, ahora lleva el nombre y el domicilio que trajo el padrón (
--receptor-nombrey--receptor-domicilio). Como siempre lleva--ir, el CLI no consultaba el padrón y el comando pegado generaba el PDF sin esos datos. - El modo interactivo usa los defaults de la config, como el CLI: la factura y el recibo arrancan en la moneda de la config (
moneda) en lugar de siempre en pesos; con una extranjera, sin tocar nada, va con la cotización oficial de ARCA (o la guardada encotizacion), igual que sin--moneda. Las notas de crédito y débito proponen el IVA receptor de la config (ivaReceptor), la alícuota (alicuota) cuando no sale de la factura y, en las de período, el concepto (concepto) y la moneda. Al repetir un comprobante se sigue usando la moneda del original. - Configuración guiada en el entorno activo: pide el certificado y la clave del entorno en que se va a emitir (
entorno, oarcli interactivo --produccion/--testing), no siempre los de testing. Conentorno produccion, el asistente proponía la guiada al abrir pero nunca completaba lo que faltaba. El chequeo al abrir también respeta--produccion/--testing. - Repetir un comprobante en moneda extranjera: en el modo interactivo, repetir una factura o un recibo en dólares, euros u otra moneda ahora sale en la moneda del original y solo pregunta la cotización (la acordada o la oficial de ARCA). Antes arrancaba en pesos: si se desmarcaba “Moneda extranjera”, el monto en dólares se emitía como si fueran pesos, y uno en euros no se podía repetir. Si ARCA no tiene la cotización oficial, no se emite.
- El modo interactivo avisa lo mismo que los comandos con flags: en moneda extranjera, que usa la cotización oficial de ARCA. Antes ese aviso solo salía con flags. La preparación de la emisión ahora es una sola para los dos.
Documentación
Sección titulada «Documentación»- Docs por tema: una página por comprobante (¿qué comprobante me toca?), con un ejemplo y sus opciones en Obligatorio, Opcional y Al ejecutar, cada flag con su largo, su corto y sus valores; las notas de crédito y débito por separado. Formas de uso (asistente, comandos y con IA), el certificado de testing y de producción en pasos cortos con las capturas plegadas, cómo funciona, un índice de comandos y el PDF en corto, cada uno con link a su guía completa. Suman cambiar de entorno, consultas, notas, FCE, exportación y lotes y JSON. Los links viejos siguen andando:
obtencion-certificados.mdyusage-patterns.mdquedan como índice. El sitio publica ademásllms-full.txt, con toda la documentación en un archivo para asistentes de IA. - Certificados: la guía para obtenerlos, el README y la resolución de problemas muestran las dos formas de cargar el certificado:
arcli certificado generareimportar(la recomendada, con la que ya no hay que configurar nada) o, si la clave se hizo con openssl, las rutas a mano conarcli config establecer. - Sitio de documentación: arcli.com.ar, con menú por tarea (Empezar, Formas de uso, Comprobantes, Más, Referencia, Ayuda), buscador, problemas frecuentes que se filtran mientras escribís, tema claro u oscuro según el sistema y buena lectura en el celular. Tiene las mismas guías que
docs/y se actualiza con cada versión. Cada página tiene su descripción para los buscadores y para la vista previa al compartir el link, y el ícono de ARCLI se ve también en la pantalla de inicio del celular. Cuenta las visitas con Cloudflare Web Analytics, que no usa cookies ni sigue a nadie entre sitios. - Instalar o actualizar con IA: el README trae un prompt corto, listo para copiar en un asistente de IA (Claude, ChatGPT, Gemini, Copilot…), que revisa Node, instala o actualiza ARCLI, lo verifica y crea el acceso directo la primera vez. Si el asistente no puede ejecutar comandos, te guía paso a paso.
08/11/2026
Trae el acceso directo con doble clic, una salida en terminal más prolija y pareja, y arreglos para quien empieza sin saber de terminal. Puede afectar scripts:
- En la vista previa,
estadodel--jsonpasa de"observado"a"previsualizacion". fe --cargarcon"previsualizar": falseya no emite por sí solo (como A, B y C).--moneda USDsin--cmya no da error: usa la cotización oficial de ARCA.- Cambian textos de
error,sugerenciayavisos(opciones entre backticks, tildes), no sus claves ni los códigos. - El certificado sin autorizar a facturar sale como
WSFE_SERVICE_NOT_AUTHORIZEDen lugar deUNEXPECTED_ERROR.
Hay deprecaciones para la 3.0.0: ver “Deprecado”.
Cambiado
Sección titulada «Cambiado»estadode la vista previa en el--json: pasa de"observado"a"previsualizacion", en A, B, C y laE. Antes parecía que ARCA había observado algo, pero no se emitió nada.previsualizacion: truesigue igual. Un script que comparaestado === "aprobado"no cambia; uno que trate cualquier otro valor como observado tiene que sumar el nuevo.- Cotización oficial por defecto en moneda extranjera:
arcli fc --moneda USDsin--cmni--misma-monedausa la cotización oficial de ARCA y lo avisa en “Avisos” (y enavisosdel JSON). Antes daba error “Falta la cotización”.--cmsigue pisándola y--cm 1sigue siendo error. - Un solo formato para los importes: la salida en terminal muestra los pesos como
$ 1.500o$ 1.500,50, con el espacio que usa el PDF y sin,00si no hay centavos. Antes convivían1.500$,$1.500y$ 1.500,00. En moneda extranjera todos los comprobantes muestran el código ISO en lugar del$(1.500,50 USD), y el error defecuando los ítems no suman--montodeja de usar punto decimal (1.500,50en lugar de1500.50). Los textos de errores y avisos toman el mismo formato, también en el--json. El PDF no cambia y los importes del--jsonsiguen siendo números. - Los datos se muestran igual en todos lados: CUIT con guiones (
20-33333333-4) y DNI con puntos (12.345.678) en los paneles; comprobantes como00001-00001234, también el asociado y la facturaE; cotización con dos decimales o más (1.250,50,1.250,123456) y porcentajes con coma (10,5%); fechasdd/mm/aaaa;N/Dpara lo que ARCA no informa ysin configurarpara la config. El vencimiento del certificado se calcula siempre en hora de Argentina. El--jsonno cambia, salvo el texto de los avisos que nombran la cotización. - Textos más parejos: tildes y voseo en toda la salida (
¿A quién le facturás?,22 dígitos,Usá), comandos siempre entre backticks y el mismo texto en los errores que se repiten. El dato faltante sale comoFalta el dato: monto.. Fechas inválidas dicen qué formatos sirven. “Monto” al pedir y en errores, “importe” al mostrar; “comprobante” donde también puede ser un recibo. Mientras se emite, el progreso diceEmitiendo la factura B en ARCA.... En la ayuda,--previsualizarya no dice que muestra algo “antes de emitir” (no emite), los alias nombran su flag y los ejemplos dicenCOMPLETAen lugar deFULL. El modo interactivo de config muestra etiquetas (Responsable inscripto,21%) en lugar de valores crudos; lo que se guarda no cambia. Son textos: pueden cambiarerror,sugerenciayavisosen el--json, no sus claves ni los códigos de error. - La pregunta antes de emitir dice el entorno: con flags ahora es
¿Emitimos la factura B en PRODUCCIÓN?, igual que en el modo interactivo, y si respondés que no avisaNo se emitió nada.. La doble confirmación en producción sigue siendo solo del modo interactivo. - La letra del comprobante siempre va en mayúscula y las frases concuerdan:
La factura B no admite…,El recibo C no lleva…,Últimas facturas B,No hay recibos C emitidos. Antes salíanLa factura b,La recibo cyÚltimas Factura B. Son textos: también cambian dentro deerroren el--json, pero la clavecomprobantey los códigos de error no. Los atajos siguen en minúscula (fb,rc). - Vista previa más corta: los importes en cero que nadie cargó (IVA, tributos, exento, no gravado) no se muestran, y la cotización solo en moneda extranjera. A consumidor final sin identificar, una sola fila
Receptoren lugar de tres. Lo que tiene valor se sigue mostrando, venga de una flag, de la config o de un default.consultartampoco muestraImporte IVAen cero. El--jsony--brutosiguen trayendo todo. - Rechazos de ARCA legibles: los paneles de errores y eventos muestran una lista (
1. 502: mensaje) en lugar de JSON crudo. El panel de resultado ya no listaObservaciones,EventosniErroresen cero. - Errores de uso en panel: un comando u opción desconocida se muestra en el mismo panel que el resto de los errores, con la sugerencia de ayuda. Comandos, opciones y argumentos van entre backticks (
opción desconocida `--montoo`), también enerrorcon--json. El panel ya no repite la palabraError. El mensaje de CUIT, certificado o clave faltante no repitearcli config revisar, que queda en la sugerencia del panel (cambia el texto deerrorydetalleen el--json, no las claves ni los códigos). - Terminales angostas: si una fila de una tabla no entra, todas las de esa columna ponen la etiqueta arriba y el valor debajo, las etiquetas ya no se cortan a mitad de palabra y la barra de estado pasa a dos líneas en lugar de romperse. En listas, una línea partida sigue alineada al texto.
- Opciones entre backticks en todos los mensajes: errores, avisos, sugerencias y paneles citan las opciones como
`--monto`o`--pv <numero>`, igual que los comandos (`arcli padron`en la lista de servicios del certificado, el paso para importarlo y el pie deparametros). Son textos: cambianerror,sugerenciasyavisosen el--json, no sus claves ni los códigos de error. La ayuda (--ayuda) y los ejemplos para copiar no cambian. - Fichas con los valores en la misma columna: padrón, plugin de PDF, régimen FCE y certificados ponen la columna de etiquetas en el mismo lugar (antes cada una usaba un ancho distinto), y en el pedido y la importación de un certificado todas las secciones quedan alineadas con la lista de servicios. Los comprobantes y la config no cambian. El
--jsontampoco. config revisarno repite el CUIT: si falta, la terminal muestra una sola fila en rojo, en Cuenta, en lugar de un aviso y un error. El--jsonsigue trayendo los dos chequeos.arcli ejemplos: el logo sale alineado y con la versión.- Selección múltiple: el cursor deja un espacio antes del círculo (
❯ ◯), como en las demás listas del modo interactivo. “Volver” es un botón común: no lleva círculo, ni espacio nialo marcan, y Enter sobre él vuelve al paso anterior.
Deprecado
Sección titulada «Deprecado»- Claves del JSON que se sacan en la 3.0.0: siguen funcionando, y la respuesta suma
deprecadocon qué usar.Code/Msg(A, B y C) ycode/message(E) enerroresyeventospasan acodigo/mensaje, que ya están.detalles.errorspasa adetalles.errores. Enestado,puntoVentaserá un número: el detalle ya está enpuntoVentaDetalle. Enpadronyfce-obligado,cuitserá texto. En--cargardefe,montopasa amontoTotal, que ya se acepta; mandar las dos es un error. La tabla está en Entrada y salida. - La clave
cotizacionde la config se saca en la 3.0.0: una cotización guardada queda vieja en días y factura con un tipo de cambio viejo sin que te enteres. Mientras tanto sigue andando: si está guardada (distinta de1), cada factura en moneda extranjera sin--cmla usa y avisa que está deprecada, yconfig establecer cotizacionavisa lo mismo. Para dejar de usarla,arcli config eliminar cotizacion.config --jsonsigue trayendocotizacion.
Agregado
Sección titulada «Agregado»WSFE_SERVICE_NOT_AUTHORIZED: el certificado sin autorizar a facturar, el error más común la primera vez, ahora dice qué hacer en ARCA en lugar de salir como error inesperado con el texto de WSAA.- Opciones nuevas marcadas en el modo interactivo: lo que se sumó en las últimas versiones lleva
(nuevo)al final (Emitir recibo, Recibo C en las notas, y Certificados de ARCA y Acceso directo en Configuración, que también lo lleva). La marca se va sola dos versiones menores después. Ver modo interactivo. arcli acceso-directo [ruta]: crea un ícono para abrir ARCLI con doble clic en macOS, Windows y Linux, en el escritorio o en la carpeta que indiques. También está en el modo interactivo, en Configuración. Creado desde el código fuente (yarn dev), abre elarcliinstalado y lo informa enusaArcliInstalado. Si no encuentra unarcliinstalado, el ícono lo dice y muestra cómo instalarlo, en lugar de “command not found”.- Más datos en el JSON de las emisiones:
entornoypuntoVentaen todos los comprobantes, ynumeroen la factura E, también en la vista previa. - Sugerencias para los rechazos de ARCA más comunes: cuando ARCA rechaza o deja una observación con un código conocido (
10016,10152,10243,10174,10119,10038,10017/10217, además del punto de venta10005/11002),sugerenciasdice qué pasó, qué hacer y el link a la guía. Antes solo se reconocían unos pocos mensajes, y los códigos que venían en las observaciones no se miraban. La tabla completa está en Troubleshooting. La forma del JSON no cambia. - Comando para actualizar según el gestor: el aviso de versión nueva, la ayuda y “Cerrar para actualizar” del modo interactivo muestran el comando del gestor con que instalaste ARCLI (
npm install -g,pnpm add -g,yarn global addobun add -g), deducido de la carpeta donde está instalado. Si no lo reconoce, sigue siendo el de npm. El plugin de PDF se sigue instalando con npm. config revisarrevisa el plugin de PDF: un chequeo “Plugin de PDF” en la sección PDF dice si está instalado, si es la versión que usa ARCLI y si encontró un navegador, comoarcli pdf estado. Conpdf=siempreavisa si falta; conpreguntar(por defecto) solo lo revisa si está instalado, asíokno pasa afalsepara quien no genera PDFs; connuncano lo revisa.- Todas las monedas de ARCA con su código ISO:
--moneda,codigoMonedadel JSON y la clavemonedade la config aceptan el código ISO o el de ARCA, indistinto:ARSoPES,USDoDOL,UYUo011,CLPo033,GBPo021, y así con todas las de la tabla de ARCA que tienen ISO. Antes solo se traducíanARS,USD,EURyBRL, y otro ISO se mandaba tal cual y ARCA lo rechazaba. La vista previa yconsultarmuestran el nombre con el ISO (Pesos uruguayos (UYU)), el PDF de laEmuestra el ISO de cualquier moneda y el autocompletado de--monedaofrece todos los ISO. Un código que no está en la tabla se sigue mandando tal cual.
Corregido
Sección titulada «Corregido»EMISSION_UNCERTAINsugiere verificar en el entorno en que se emitió: antesarcli ultimosconsultaba el de la config, y emitido con--produccioncon la config en testing, el comprobante “no figuraba” y reintentar lo duplicaba. También el aviso del lote, que ahora trae el comando completo.--cargar: en laE,"pdf"del archivo se ignoraba,--exportar-pdfcon--sin-pdfno era error y un monto con más de 2 decimales se redondeaba sin avisar. En las notas, un flag del asociado (por ejemplo, solo--acuit) descartaba todocomprobanteAsociadodel archivo; ahora se combinan.importeExentoeimporteNoGravadoen0cuentan como ausentes.- La cotización deprecada de la config ya no se aplica a otra moneda extranjera (la de USD no vale para EUR).
- Modo interactivo: la configuración guiada ya no dice “Ya podés emitir” con el certificado pendiente; “Cerrar para actualizar” dice dónde pegar el comando y espera, para leerlo al abrir ARCLI con el acceso directo; las rutas aceptan un archivo arrastrado; la barra se actualiza al volver de Configuración; pide el certificado del entorno activo y no siempre el de testing; sin punto de venta, dice dónde cargarlo. El comando equivalente ya no repite
--ir consumidor-finaldespués de--consumidor-final, que lo implica. - Mensajes que confundían:
--moneda USD --cm 1decía “Falta la cotización” y ahora explica que 1 es la cotización del peso. Una nota con período (--periodo-desde/--periodo-hasta) y parte de un comprobante asociado (--apv,--acuit) pedía el comprobante completo y ahora dice que se usa uno o el otro. arcli fe --cargarcon"previsualizar": falseemitía sin preguntar: en A, B y C eso no emite y decide la config (en una terminal pregunta); ahora laEhace lo mismo. Para emitir desde el archivo,"emitir": true."emitir"y"previsualizar"entruea la vez son un error, como en el resto.- Modo interactivo: la barra con la razón social y las respuestas ya respondidas pasan por el mismo filtro que el resto de la salida, así un dato externo no puede meter secuencias de terminal.
- Colores de los errores: dependían de stdout aunque los errores se escriben en stderr.
arcli ... 2> errores.logguardaba códigos de color en el archivo, y conarcli ... | jqel error salía sin color en la terminal. Ahora dependen de stderr. También vale para los avisos de nueva versión y de certificado. ARCLI_ASCII=1cubre toda la salida: también cambia los símbolos (✓,•,·,…,→) y lo que dibuja el modo interactivo (✔,❯,↑↓,⏎,←,┈, el spinner). Antes solo cambiaba los bordes. Las tildes y lañse mantienen.- Entorno con tilde: los títulos de
parametrosyultimosdicenPRODUCCIÓNen lugar dePRODUCCION, yestado,config,config revisary los errores de comprobante o CUIT no encontrado dicenproducción. El--jsonconservaentorno: "produccion"; solo cambia el texto deerrorydetalle. arcli configmuestra el CUIT con guiones:20-33333333-4, igual que el resto de los comandos.config --jsonno cambia.- Textos: tildes que faltaban en
sí,automático,Cuándo generar el PDF,puntos críticosyEstás utilizando el entorno de TESTING. La ayuda de--monedadiceetc.en lugar de…. Tildes y voseo en mensajes que habían quedado sin corregir (fecha fuera de rango, instalación del plugin de PDF, emisión sin confirmar,coe.alreadyAuthenticated). Los códigos de error y la forma del JSON no cambian. dh key too smallen producción: en sistemas con OpenSSL enSECLEVEL=2, como Debian 13, las llamadas a WSFE y WSFEX de producción fallaban con ese error aunque el certificado, la clave y el punto de venta fueran correctos. Ahora ARCLI no ofrece DHE en producción, sin aflojar el resto de la seguridad de la conexión. Testing no cambia. Ya no hace falta el wrapper con--tls-cipher-list.- PDF de la factura E en el modo interactivo: si faltan datos del emisor, los pide y ofrece guardarlos, como en el resto de los comprobantes. Antes el PDF no se generaba.
- Emisión incierta en la factura E: si falla la llamada que emite una
fe(red, timeout), sale comoEMISSION_UNCERTAIN, igual que A, B y C, en lugar de un error inesperado que invitaba a reintentar.detallestraenumeroeidSolicitud, y la sugerencia es reintentar con esos mismos valores: ARCA no autoriza dos comprobantes con el mismo número, así que no se duplica. - Ayuda de
arcli fe:--numerodecía “por defecto el siguiente de ARCA”, pero es obligatorio. Ahora la ayuda lo dice. - Certificado vencido: la sugerencia de
CERTIFICATE_EXPIREDmanda a renovarlo conarcli certificado generareimportar, en lugar de cargar las rutas a mano conarcli config establecer.
04/11/2026
Trae el Recibo C (rc), arcli certificado generar e importar para sacar el certificado de ARCA sin openssl, y la condición de venta en el PDF. Gracias a Guillermo Britos y a Kevin Tea, que trajeron el recibo y la condición de venta.
Un cambio puede afectar scripts: --dia está deprecado y ya no fija el período del servicio, solo el vencimiento. Sigue andando con un aviso. Ver “Cambiado”.
Agregado
Sección titulada «Agregado»arcli certificado generareimportar: arman la clave y el CSR para ARCA sinopenssl(también en Windows) y cargan el certificado que devuelve ARCA.importardeduce el entorno del certificado, valida CUIT, vencimiento y clave, lo guarda encertificados/<CUIT>/junto a la config y configuracert.*/key.*. Para renovar, la clave nueva queda pendiente hasta importar, así que se sigue facturando con el certificado actual. Las rutas configuradas a mano siguen andando. En el modo interactivo: Configuración → Certificados de ARCA, y la configuración guiada ofrece sacarlo si no tenés uno.- Recibo C (
rc,arcli recibo c): emite o previsualiza un Recibo C (tipo ARCA 15) con los mismos flags y validaciones que la Factura C. La familiarecibosolo tiene la letra C:arcli recibo ada error y el autocompletado ofrece soloc. Las notas de crédito y débito C pueden asociarse a un Recibo C (arcli ncc --ac rc ...). En el modo interactivo tiene su propia opción, Emitir recibo, y se puede elegir como comprobante original de una nota. “Repetir una factura anterior” pasa a llamarse Repetir un comprobante anterior y deja elegir entre una factura y un recibo. El PDF lleva el títuloRECIBO C,COD.15y el QR de ARCA con el tipo 15, y se guarda comorecibo-c_<pv>-<numero>.pdf. Gracias a Guillermo Britos, que lo trajo en #78. - Condición de venta en el PDF de A, B y C:
--condicion-venta(alias--cv),condicionVentaen el JSON de--cargary la clavecondicionVentade la config como default.--sin-condicion-ventay"condicionVenta": nullpermiten omitir ese default para un comprobante. Aceptacontado,tarjeta-debito,tarjeta-credito,cuenta-corriente,cheque,transferencia,otros-medios-electronicosyotra, que se imprimen con su nombre, o un texto libre que se imprime tal cual. El modo interactivo la pregunta con una lista y la de la config marcada; “Omitir” la suprime y “Otra” pide el texto. Es un dato exclusivo del PDF: WSFE no lo recibe. Gracias a Kevin Tea, que la trajo en #74.
Cambiado
Sección titulada «Cambiado»- Rutas clickeables: en terminales que soportan links (VS Code, iTerm2, Windows Terminal, Kitty, WezTerm, Ghostty), las rutas de
arcli config,arcli pdf, el PDF guardado yarcli certificadose abren con un clic.FORCE_HYPERLINK=0los apaga.arcli configmuestra además la carpeta de certificados. arcli config revisarmás fácil de leer: los chequeos van agrupados por sección (Cuenta, Al facturar, Certificados, Salida, PDF y Validaciones), con lo que falta en color, y los avisos de certificados sugierenarcli certificado generar. El JSON no cambia de forma.--consumidor-final(--cfinal) implica IVA receptor consumidor final: ya no hace falta sumar--ir-cf, y anda aunque la config tenga otroivaReceptor, que antes daba error. Lo mismotipoDocumento: "consumidor-final"en el JSON de--cargar. Un IVA explícito distinto (--cfinal --ir-rm) sigue siendo error.--diaestá deprecado y fija solo el vencimiento: antes también ponía el período del servicio en ese día (--dia 10facturaba un servicio “del 10/11 al 10/11”). Ahora el período es el de--servicio-desde/--servicio-hastao, sin ellos, la fecha del comprobante, como sin--dia. Se puede combinar con--fechay--servicio-hasta, y da error junto con--vencimiento/--vto. Sigue andando con un aviso; usá--vencimientoo--vto. Lo mismo la clavediadel JSON de--cargar.
Corregido
Sección titulada «Corregido»- Fechas sin año en el cambio de año: se tomaba siempre el año actual, así que el 5/1/2027
--sd 1/12era diciembre de 2027. Ahora se toma la fecha más cercana a hoy: diciembre de 2026, y el 28/12--vto 10/1es enero que viene. --moneda EURyBRLse mandaban tal cual y ARCA las rechazaba: ahora se traducen a sus códigos (060y012) enfc/fb/fa,feyparametros cotizacion.--misma-monedacon--fechafutura llegaba a ARCA y fallaba con el error 10038: ahora pide que la fecha sea la de hoy, porque ARCA solo publica la cotización vigente.- Repetir una factura con montos chicos podía deducir mal la alícuota de IVA (por ejemplo, 2,5% en vez de 21%).
Seguridad
Sección titulada «Seguridad»- Publicación en npm más estricta: el paquete se publica desde el tag de la release de GitHub (antes, desde lo último de
main) y el release falla si el tag no coincide con la versión. Se arma en un job sin permiso para publicar, sin cache y sin scripts de dependencias, y antes de publicarlo se instala y se prueba que arranque.
Versiones anteriores
Sección titulada «Versiones anteriores»2.2.103/11/2026
Corrige arcli pdf instalar en Windows y suma lo necesario para recibir contribuciones: plantillas de issue y de PR, código de conducta, Discussions para preguntas, y un CI que también corre en Windows, macOS y Node 26. No cambian comandos, flags, claves de config ni el --json.
Corregido
arcli pdf instalaren Windows: la descarga del navegador pasaba porcmd.exe, que corta las rutas con espacios (comoC:\Users\Nombre Apellido), y fallaba. Ahora la shell se usa solo para corrernpm.cmd.
Documentación
- El README explica cómo instalar con pnpm y Yarn además de npm, cómo probarlo con
npxy cómo actualizar, y suma las secciones “Ayuda y soporte” (preguntas en Discussions, bugs en issues) y “Estabilidad” (qué es contrato público y qué puede cambiar entre versiones). - Plantillas de issue y de PR, y código de conducta.
- El CI corre también en Windows, macOS y Node 26.
2.2.002/11/2026
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, que la trajo en #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 feyarcli factura e: emiten o previsualizan la Factura de exportaciónE(tipo 19) con WSFEX. Obligatorios:--monto,--cliente,--domicilio-cliente,--pais-destino(código o nombre),--numeroy la actividad. Opcionales:--id-impositivo,--cuit-pais,--tipo-expo(1bienes,2servicios,4otros),--incoterm,--incoterms-desc,--idioma,--forma-pago,--permisocon--permiso-existente,--id-solicitud,--fecha-pago,--observacionesy--obs-comerciales. No lleva concepto, IVA ni receptor con CUIT/CUIL/DNI.feva en la tabla de atajos dearcli --ayuday enarcli ejemplos, y Tab completa la letraeenarcli factura.--numeroobligatorio en laE: WSFEX numera por punto de venta y tipo, pero@arcasdk/coretodavía no permite consultar el último comprobante E. Pasá el siguiente al último que emitiste (1si es el primero).- Actividad de la
E:--actividado la clave nuevaexportacion.actividad(sección “Factura de exportación (E)” dearcli 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>: comofacturacomparte 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 enavisosdel JSON (factura a --incoterm,factura e --alicuota). Los atajos (fa,fe…) siguen rechazándolos como opción desconocida. --itemcon 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--montoy se valida antes de autenticar en WSAA, porque WSFEX no lo controla.--cargarparaE: 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 serviciowsfex, para cuando el certificado general no está autorizado a exportación. Si no están las dos de un entorno, se usancert.*/key.*; con la mitad del par configurada el comando corta antes de ir a ARCA. Se muestran en la sección Certificados dearcli config(también en el modo interactivo), se validan como PEM al guardarlas yarcli config revisarlas revisa con el resto. Sin autorización awsfex, el error esWSFEX_SERVICE_NOT_AUTHORIZED.- Defaults de la
E: sin flags, la exportación sale de servicios (Tipo_expo2), en dólares (Moneda_IdDOL), 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 pagoTransferencia Internacional. Las clavesmonedaycotizacionde 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 bloqueexportacioncon cliente, destino, domicilio, actividad, incoterm, items y permisos;solicitudes elCmpde WSFEX, con los nombres de ARCA. Forma exacta en entrada y salida. - PDF de exportación: se guarda como
factura-e_<pv>-<numero>.pdfcon el diseño de exportación de@arcasdk/pdfy los mismos datos que la E de Comprobantes en línea: títuloFACTURA 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 leyendaIVA 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.
- CUIT con dígito verificador y con o sin guiones en todos lados:
arcli padron,arcli fce-obligado,--cuit,--cuil,--acuit,comprobanteAsociado.cuiten el JSON,config establecer cuity el modo interactivo aceptan20-33333333-4o20333333334, y rechazan un CUIT mal tipeado antes de llegar a ARCA. Antesarcli padron 20-20179706-4fallaba 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 yarcli ultimoscortan 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
--emitiren una terminal, ahora se cierra con Esc como un “no”, igual que en el modo interactivo y en las preguntas del PDF. numeroen el JSON de facturación: el número que le tocó al comprobante emitido (nullen una previsualización), ysolicitudlo trae enCbteDesde/CbteHasta. El panel de texto muestraNú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 conarcli 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 deparametrosy letras de las familias; donde va una ruta, archivos. No hay que reinstalarlo al actualizar ARCLI. Ver Autocompletado.
Cambiado
- Ayuda más corta y toda en español.
arcli --ayudapasa de unas 145 líneas a 57: los 18 atajos van en una tabla familia × letra ystorybook(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--versionahora 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 elerrordel JSON con--json; elcodigosigue siendoINPUT_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 decodigo, 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 ultimosmostraba que no había comprobantes. Ahora cortan conARCA_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.sinProcesardeBATCH_EMISSION_ERROR, y reintentar solo esa lista lo perdía. Ahora figura. Si la emisión quedó sin confirmar, sigue ensinConfirmary no ensinProcesar, como antes. - IIBB en el PDF: sin
emisor.iibb, el PDF decía “Exento”; ahora muestra “-”. Si sos exento, configuralo conarcli 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 3aguardaba3, yarcli consultar fc 1e3buscaba el 1000. Ahora dan error, igual que en el modo interactivo. arcli pdf instalarcolgado: con un proxy que no responde, npm o la descarga del navegador no terminaban nunca. Ahora se cortan a los 5 y 15 minutos conPDF_PLUGIN_INSTALL_ERROR.montoTotaldel JSON nunca se redondea: con más de 2 decimales se redondeaba en silencio antes de validar (1.005se emitía por$1). Ahora daINPUT_VALIDATION_ERROR(“Use hasta 2 decimales”), igual que--montoy el resto de los importes.consultarPadron falsese respeta siempre: con univaReceptoren la config, facturar con--cuitigual 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
aliasCbude 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.
Documentación
- Nueva sección de la
Een referencia del CLI y en reglas de validación; credenciales de WSFEX en configuración; items, JSON y limitaciones (--numeroobligatorio, sin notas E, sin lote) en entrada y salida, PDF y limitaciones; el asistente de laEen modo interactivo y sus problemas comunes en troubleshooting.
2.1.023/10/2026
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
2cuando 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
--cargarsale como array. --brutoagregarespuestaen lugar de reemplazar el resumen.config revisarya no recibe--testingni--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--jsonpara scripts.- IVA receptor desde el padrón: al facturar con
--cuity sin--ir, ARCLI usa la condición IVA del padrón, antes que elivaReceptorde 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 conarcli 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. Con--json, stdout queda solo con el JSON y en facturación el aviso va también enavisos. 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 errorCERTIFICATE_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), lasugerencialo dice y apunta a la guía para crear uno.arcli estadoavisa 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
--brutoagrega la respuesta cruda sin quitar el resumen: con--json --brutoahora salencae,caeVencimiento,estado,resultado,errores,observacionesy el resto del JSON de siempre, másrespuestacon la respuesta cruda de ARCA. Antes--brutoreemplazaba 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 panelRespuesta brutava al final. Vale igual parabruto=trueen la config.- Un array de un elemento en
--cargares un lote: si el JSON es un array sale un array (conindice) y los errores sonBATCH_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
--cargarse 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, oBATCH_VALIDATION_ERRORcon 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. config revisarrevisa los dos entornos: valida el entorno por defecto y cualquier otro que tengacertokeyconfigurados, cada uno en su línea (Validacion testing,Validacion produccion). La líneaRevision activadel JSON ya no existe. Ya no recibe--testingni--produccion: antes los aceptaba pero los ignoraba y revisaba siempre testing.- Exit code
2cuando ARCA rechaza un comprobante: antes salía con0y había que leerestadopara enterarse. En un lote,2si ARCA rechazó al menos uno.observadosigue saliendo con0. Si un script trataba cualquier exit distinto de0como 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,-3y así. sugerenciasiempre en el JSON de error: todos los errores con--jsontraen las mismas cuatro claves (codigo,detalles,error,sugerencia), consugerencia: nullcuando no hay nada que sugerir. Antes faltaba en los errores sin sugerencia (CONFIGURATION_ERROR,INPUT_VALIDATION_ERROR…) y eranullsolo en los inesperados. Si un script chequeaba si la clave existe, ahora tiene que chequear si esnull.--brutosolo en los comandos de facturación:padron,fce-obligado,ultimos,consultar,parametros,estadoeinteractivoya 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 --jsonya no falla: el asistente acepta solo--testingy--produccion;--jsony--brutose ignoran con un aviso. Sin terminal interactiva sigue fallando, con o sin--json.- Comando equivalente del modo interactivo: siempre lleva
--testingo--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
--ayudade las notas B y C, las B, las FCE y las familias, las NC/ND FCE dearcli ejemplosy varios de los docs (pdf.md,usage-patterns.md,cli-reference.md, el JSON dellms.txty deinput-output.md) daban error al copiarlos: asociado de otra letra, IVA receptor que la letra no admite, FCE sin--cbuo con--acuitajeno, 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 conarcli ultimosantes de reintentar. En esos casos no llegó nada a ARCA: ahora salen con su error (UNEXPECTED_ERRORoTRANSIENT_ERRORen el JSON) y se puede reintentar directo.EMISSION_UNCERTAINqueda solo para un fallo en la llamada que emite (red, timeout, transacción activa). En un lote, ese caso ya no sumadetalles.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
pdfo--exportar-pdfcomo en un lote completo, y en--jsoncada uno lleva su campopdf. 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 enBATCH_VALIDATION_ERROR, junto con los demás ítems con problemas y su#n, antes de emitir ninguno. config.jsoncon 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=truede la config en todos los comandos:pdf(y sus subcomandos) yparametrossin tabla solo salían en JSON con--json. Ahora todos los comandos resuelven la salida igual:--jsono, si no está, la clavejsonde la config.config rutaacepta--jsony 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--jsonojson=true, salen comoINPUT_VALIDATION_ERRORen el mismo formato que el resto de los errores, con exit code1. Sin JSON se ven igual que antes. - Opciones globales que no aplican:
--testing,--produccion,--jsono--brutoen 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=trueenconfig:config,config revisar,config estableceryconfig eliminarrespetanjson=truede la config, como el resto de los comandos.--diacorría un mes de más a fin de mes:--dia 15el 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 31con abril), ahora da error.--jsonconFORCE_COLOR: conFORCE_COLOR=1en 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.--jsonenconfig:config,config revisar,config estableceryconfig eliminarignoraban--jsony salían en texto.config --ayudalistaba la mitad de las claves: mostraba 15 de 30. Ahoraconfig --ayudayconfig establecer --ayudalistan todas, por sección, con sus valores posibles.- Links de
llms.txty del README en el paquete de npm: apuntaban adocs/, que no se publica en npm. Ahora son links a GitHub. config establecercon un valor inválido (puntoVenta abc,comprobantesPorLista 99) sale como error de entrada (INPUT_VALIDATION_ERROR) y no como error inesperado.
2.0.012/10/2026
Versión mayor: sale de una auditoría del proyecto. Lo que rompe es cómo se escriben algunos valores en los flags:
- Montos en formato argentino: punto para miles y coma para decimales (
15.000,1.500,50).-m 1500.50ahora da error; escribí1500,50. - Enteros solo con dígitos:
--pv 3ada error en vez de leerse como 3. --diano se combina con--fechani--servicio-hasta.- Varias alícuotas: la suma tiene que coincidir exacta con
--monto. - Un error de red al emitir sale como
EMISSION_UNCERTAIN, no comoTRANSIENT_ERROR/UNEXPECTED_ERROR.
El resto son correcciones: evitar comprobantes duplicados, fecha argentina en cualquier zona horaria, ImpTotal exacto, PDF escapado, archivos privados y validaciones más estrictas.
Agregado
- Modo interactivo, estado de ARCA en la barra: la barra de arriba del menú ya no dice “Modo interactivo”: muestra ARCA funcionando, con demoras (más de 3 segundos), con problemas (algún servidor no responde OK) o sin respuesta, en color, seguido del entorno (
TESTINGen naranja,PRODUCCIONen celeste). A la izquierda, la razón social del emisor (o el CUIT, si no está configurada) y el punto de venta. - Versión debajo del logo (
v1.8.0 | LcsGrz), en el modo interactivo y en la ayuda. - Mismo ancho para todo: las cajas de la salida en texto, la barra de estado y el logo (ahora centrado) ocupan 92 columnas, o menos si la terminal es más angosta. Antes cada caja medía distinto según su contenido. Los comprobantes (vista previa, resultado de la emisión y
consultar) mantienen su ancho de ticket, de 68 a 80 columnas, y van centrados. El JSON no cambia. - Modo interactivo, listas de comprobantes: las filas ocupan todo el ancho de la línea punteada que las enmarca.
- Modo interactivo, actualizar: si hay una versión nueva, la primera opción del menú es Actualizar a la versión X.Y.Z. Muestra tu versión, la nueva y sus novedades, y con Cerrar para actualizar copia
npm install -g arcli@latestal portapapeles y cierra el asistente para que lo ejecutes. En el modo interactivo el aviso de nueva versión ya no aparece al salir.
Cambiado
- Enteros estrictos, y es un cambio que rompe:
--pv,--punto-venta,--ar,--apv,--at,--diay--cantidadaceptan solo dígitos; antes--pv 3ase leía como 3.--cuit,--cuily--dniaceptan además guiones y puntos (20-11111111-2), como el modo interactivo; antes--cuit 20111111112xyzpasaba. --diacon--fechao--servicio-hastada error: antes--diase ignoraba sin aviso.- Montos del JSON con 2 decimales como máximo (la cotización, 6), igual que los flags.
- Varias alícuotas: la suma tiene que coincidir exacta con
--monto; antes se aceptaba un centavo de diferencia, y elImpTotalenviado podía no coincidir con la suma de sus partes. - Montos en formato argentino, y es un cambio que rompe:
--monto,--exento,--nogravado,--cotizacion-moneda/--cm, el monto de--alicuota TASA:MONTOyconfig establecer cotizacionusan punto para miles y coma para decimales.15.000es quince mil y1.500,50es mil quinientos con cincuenta. Antes-m 15.000se leía como 15 y-m 1500,50como 1500, sin aviso. Ahora1500.50da error (“use coma para los decimales”), igual que el texto sobrante (12abc) y más de 2 decimales (la cotización acepta hasta 6). El JSON de--cargarno cambia: ahí los montos son números. - Modo interactivo: los montos siguen la misma regla.
1500.50ya no se acepta y más de 2 decimales da error en lugar de redondearse en silencio. El comando equivalente que muestra al final escribe los montos con coma.
Corregido
- Modo interactivo, notas y repetir factura copian más de la original:
- Una NC o ND sobre una factura en dólares va en dólares, con la cotización de la factura; antes salía en pesos.
- “Anular el total” copia también exento y no gravado.
- “Repetir factura” copia exento y no gravado.
- Si la factura tiene varias alícuotas o tributos, ARCA no devuelve el detalle para reproducirla. En ese caso se avisa, no se ofrece “anular el total” ni “mismo monto”, y se pide elegir la alícuota.
- Salida de terminal sin secuencias de control: observaciones de ARCA, datos del JSON o errores de npm ya no pueden mover el cursor, borrar la pantalla, pisar una línea ni meter hipervínculos. Solo pasan colores, saltos de línea y tabs.
--jsonno cambia. - Rutas absolutas en la config:
cert.*,key.*yticketPathse guardan resueltas, comopdfCarpeta. Antes una ruta relativa dependía de la carpeta desde donde se corría ARCLI. - Clave privada cifrada:
config establecer key.*la rechaza con un mensaje claro y cómo descifrarla. Antes se aceptaba y fallaba recién al hablar con ARCA. - PDF: textos escapados. La plantilla de
@arcasdk/pdfno escapa HTML y Chromium la renderiza con JavaScript: una razón social o descripción con<script>(por ejemplo, de un JSON de terceros) se ejecutaba, y un&legítimo se veía mal. Ahora todos los textos se escapan antes de generar el PDF. - Tickets de ARCA y config solo para tu usuario: ARCLI crea sus archivos con permisos
0600/0700(umask077), incluidos los tickets que escribe el SDK, y deja en0700la carpeta de config y la de tickets que ya existían. Antes quedaban0644/0755, y en Linux otro usuario del equipo podía leer un ticket y usarlo para emitir durante su validez. Los PDFs nuevos también quedan solo para tu usuario. config establecerya no guarda valores inválidos: antesconfig establecer cuit abclo guardaba igual y dejaba el CLI inutilizable, inclusoconfig eliminar. Ahora se valida antes de guardar, y una config que ya estaba rota se arregla conconfig estableceroconfig eliminarde la clave que falla.- Fecha argentina siempre: en un equipo con otra zona horaria (por ejemplo un servidor en UTC), entre las 21 y las 24 h la fecha del comprobante salía con el día siguiente. Ahora “hoy” es siempre el día en Argentina.
ImpTotalexacto: se calcula como la suma de no gravado, exento, neto e IVA con aritmética decimal. Con varias alícuotas, el total ya no sale como300.29999999999995.--atse valida como--ac: una NC A ya no puede asociar una factura B por código; sitipoyatajovienen juntos tienen que coincidir.ayudacomo valor de un flag (--descripcion ayuda) ya no abre la ayuda.- Emisión sin confirmar: si falla la llamada que emite en ARCA (red, timeout, transacción activa), el error ahora es
EMISSION_UNCERTAINy avisa que el comprobante puede haberse emitido igual, con elarcli ultimos <tipo> --pv <n>para verificarlo antes de reintentar. Antes salía comoTRANSIENT_ERRORoUNEXPECTED_ERRORy sugería reintentar, lo que podía duplicarlo. En un lote,BATCH_EMISSION_ERRORsumadetalles.sinConfirmar. - Ctrl+C en las preguntas del PDF, que llegan después de emitir: el modo interactivo decía “Cancelado. No se emitio nada.” aunque el comprobante ya estaba emitido, y el comando terminaba en “Error inesperado” con exit 1. Ahora se toma como “no generar el PDF” y se avisa que el comprobante quedó emitido.
- Un flag escrito siempre gana:
--previsualizarya no choca conemitir=trueen la config o"emitir": trueen el JSON, y--emitirgana a"previsualizar": true. Lo mismo con--alicuota TASAsobre lasalicuotasdel JSON,--cmsobre"mismaMoneda"y--misma-monedasobre"cotizacionMoneda". El error de “ambos a la vez” queda solo si los dos vienen del mismo lugar. - Errores en JSON con
json=trueen la config: antes solo salían en JSON con el flag--json. caeycaeVencimientosonnullen un comprobante rechazado, como dice la documentación; antes venían como"".- Los errores con sugerencia la incluyen en
sugerenciatambién en JSON (antes solo los del PDF). - Documentación de la emisión en producción: decía que emitir en producción exige
--produccion --emitir. En realidad el entorno sale deconfig.entornoy la emisión deconfig.emitircuando no pasás flags: conentorno produccionyemitir truese emite en producción sin flags. El comportamiento no cambió; se corrigieron SECURITY.md, README,llms.txt, la ayuda y los docs.
1.8.009/10/2026
Suma la clave comprobantesPorLista y sube a 15 el default de arcli ultimos; el resto son cambios del modo interactivo. Ningún flag ni formato JSON cambia.
Agregado
- Modo interactivo, elegir factura: en notas de crédito/débito, en “Repetir factura” y en “Consultar comprobantes”, la lista ahora muestra los últimos 15, con el formato de
arcli ultimos, y tiene Cargar más… para traer los anteriores e Ingresar el número a mano…, que pide punto de venta y número. Así se puede hacer una nota sobre una factura vieja o emitida desde otro punto de venta. - Nueva clave de config
comprobantesPorLista(1 a 50, por defecto 15): cuántos comprobantes muestranarcli ultimosy las listas del modo interactivo.arcli config establecer comprobantesPorLista 25.
Cambiado
arcli ultimosmuestra 15 comprobantes por defecto (antes 10), o los deconfig.comprobantesPorLista.--cantidadsigue mandando. Si un script dependía de que vinieran 10, agregá--cantidad 10.- Modo interactivo: “Nota de crédito o débito sobre una factura” se separó en Emitir nota de crédito y Emitir nota de débito, así el flujo ya no pregunta cuál.
- Modo interactivo: “Ver últimos comprobantes” y “Consultar un comprobante” se unificaron en Consultar comprobantes: elegís el tipo, la lista muestra los últimos y al elegir uno ves el detalle y volvés a la lista.
- Modo interactivo: Esc vuelve al paso anterior, en listas y en preguntas de texto (antes había que escribir
<, que sigue funcionando). La pregunta abandonada no queda en pantalla. La ayuda de teclas de las listas pasó a castellano. arcli configpor secciones: cuenta, certificados, al facturar, FCE, datos del emisor, PDF, y salida y listados. Cambia solo la salida en texto;arcli config --jsonqueda igual.- Modo interactivo, configuración: nueva opción Ver configuración. “Cambiar un dato” pasó a llamarse Modificar configuración: usa las mismas secciones que
arcli config, suma moneda, cotización y carpeta de tickets, y vuelve a la lista después de cada cambio. - Docs: GIF del modo interactivo regrabado y uno nuevo de “Consultar comprobantes” en la guía del modo interactivo.
scripts/demo/record.shacepta los guiones a grabar. README con el logo en alta resolución y los chips centrados. - Modo interactivo: Esc en el menú principal cierra el asistente. Más aire entre preguntas: dos líneas arriba de la activa, una debajo de la pregunta y otra entre la descripción y la ayuda de teclas.
- Modo interactivo: la pregunta activa tiene una línea en blanco arriba, así se distingue de las ya respondidas, que quedan juntas. “← Volver” queda separado de las opciones por una línea en blanco.
1.7.106/10/2026
Versión de documentación. No cambia ningún comando, flag, clave de config ni JSON.
Cambiado
- Documentación reorganizada: nuevo índice en
docs/README.mdy nueva guía de arquitectura. El README quedó más corto, con instalación, configuración y uso mínimos. Se eliminaron secciones duplicadas entre documentos y el checklist manual de UI, que usaba comandos que ya no existen. - Seguridad:
SECURITY.mdapunta al reporte privado de vulnerabilidades de GitHub.
Corregido
- Docs: el glosario decía que la alícuota de IVA era fija al 21%; la referencia del CLI citaba claves de config inexistentes;
llms.txtdocumentaba un campo JSON (confirmarProduccion) que no existe; faltaban en la guía de configuraciónNO_UPDATE_NOTIFIERyPUPPETEER_EXECUTABLE_PATH.
1.7.005/10/2026
Esta versión completa el modo interactivo: configuración guiada la primera vez, cambiar cualquier dato desde un menú, repetir una factura anterior con fechas nuevas, consultar un comprobante y ver el estado de ARCA. También corrige el PDF de la Factura B, enlaza la guía de certificados desde la configuración y suma GIF e imágenes al README. No se rompe ningún comando, flag ni JSON existente.
Corregido
- PDF de la Factura B: el renglón y el subtotal mostraban el importe neto y el total con IVA, sin el IVA en ningún lado, así que no cerraba. Ahora los renglones y el subtotal de la B van con IVA incluido, como corresponde a una B. La A y la C no cambian.
Agregado
- Modo interactivo:
- Repetir una factura anterior: copia receptor, concepto, monto y alícuota de una de las últimas emitidas, con fecha de hoy y el período que elijas (este mes, el mes pasado, hoy u otro).
- Configuración: submenú con revisar, configuración guiada (CUIT, certificado, punto de venta y defaults, más los datos del PDF), cambiar un dato de una lista con su valor actual, y el plugin de PDF. Si falta algo obligatorio, el asistente ofrece la configuración guiada al abrirse.
- Consultar un comprobante por tipo y número, y Estado de ARCA con la cotización del dólar.
Cambiado
- Guía de certificados en la configuración: el asistente de configuración y
arcli config revisarahora muestran el link a Cómo obtener los certificados de ARCA: en el mensaje inicial, justo antes de pedir el certificado de testing si todavía no hay uno cargado, y en el aviso de credenciales de testing faltantes. Antes el asistente apuntaba a una ruta relativa que no existe al instalar desde npm.
1.6.005/10/2026
Esta versión suma arcli estado y arcli parametros para consultar ARCA sin emitir, y simplifica la factura del modo interactivo: primero lo requerido y después todos los opcionales en una sola pregunta. No se rompe ningún comando, flag ni JSON existente.
Agregado
arcli estado: muestra si los servidores de ARCA responden, cuánto tardan y si el punto de venta configurado está habilitado para tu CUIT (en producción; en testing ARCA no informa puntos de venta). Con--json,listodice si se puede emitir.arcli parametros <tabla>: consulta las tablas de ARCA vigentes (puntos-venta,comprobantes,documentos,alicuotas,iva-receptor,monedas,conceptos,opcionalesytributos).arcli parametros cotizacion USDmuestra la cotización oficial. Sin tabla, lista las disponibles.
Cambiado
- Modo interactivo: la factura pregunta primero solo lo requerido y después, en una sola pregunta, todos los opcionales: se marcan con espacio y Enter sigue. Sin marcar nada se usan los valores por defecto. La alícuota de IVA (A y B) y la modalidad de transferencia (FCE) pasan a ser opcionales: antes se preguntaban siempre, aunque casi siempre quedaban en 21% y SCA. Las opciones avanzadas ya no son un menú que se recorre de a una.
1.5.004/10/2026
Esta versión suma el PDF del comprobante con el QR de ARCA, para mandarle al cliente. El PDF lo genera un plugin que se descarga solo si lo usás, así que ARCLI no pesa más para quien no quiere PDFs. No se rompe ningún comando, flag ni JSON existente: todo lo nuevo es opcional, y el JSON suma la clave pdf solo cuando se intenta generar el PDF.
Agregado
- PDF del comprobante con el QR de ARCA, para mandarle al cliente. Ver PDF de comprobantes.
--exportar-pdf(alias--pdf) lo genera después de emitir y--sin-pdfno. Sin flag decide la configpdf:preguntar(por defecto),siempreonunca. Conpreguntar, sin terminal o con--jsonno se genera.- Datos que solo van en el PDF, porque ARCA no los guarda:
--descripcion,--receptor-nombrey--receptor-domicilio, y en el JSON de--cargar,pdf,descripcion,receptorNombreyreceptorDomicilio. - Claves de config nuevas:
pdf,pdfCarpeta(por defecto~/arcli/comprobantes),pdfNavegadory los datos del emisor:emisor.razonSocial,emisor.domicilio,emisor.inicioActividades,emisor.iibb,emisor.condicionIvayemisor.logo. - El archivo se llama
factura-c_0003-00000125.pdf. Los de testing van a la subcarpetatesting/con un pie que dice que no tienen validez fiscal. - En JSON, cada resultado suma la clave
pdf({ ruta }o{ error }) solo si se intentó generar. Un error del PDF no cambia el código de salida, porque el comprobante ya está emitido. - El modo interactivo pregunta si generar el PDF después de emitir, y pide los datos del emisor que falten (ofrece guardarlos).
arcli pdf(estado,instalar,desinstalar): el PDF lo genera@arcasdk/pdf, que no viene con ARCLI porque pesa unos 160 MB (más un navegador de unos 200 MB si no hay Chrome, Chromium o Edge instalado). Se descarga recién cuando alguien quiere PDFs: en una terminal, ARCLI lo ofrece la primera vez; sin terminal nunca se descarga solo.config revisaravisa sipdfessiemprey faltan datos del emisor.
1.4.002/10/2026
Esta versión suma dos comandos para ver lo emitido (ultimos y consultar), facturas con varias alícuotas de IVA y un modo interactivo más completo. Los lotes ahora se validan enteros antes de emitir. No se rompe ningún comando, flag ni JSON existente: --alicuota con un solo número funciona igual que antes.
Agregado
- Modo interactivo:
- Volver al paso anterior con “← Volver” en las opciones o
<en los textos. - Opciones avanzadas antes de la vista previa: moneda extranjera (incluida la cotización oficial si te pagan en dólares), exento y no gravado, período del servicio y vencimiento del pago.
- Las notas comunes se pueden asociar a un período en lugar de a una factura.
- Volver al paso anterior con “← Volver” en las opciones o
- Varias alícuotas por comprobante: repetí
--alicuota TASA:MONTOcon el monto IVA incluido de cada una, por ejemplo--alicuota general:1210 --alicuota reducida:552.50. El total se calcula solo y se envía una entrada de IVA por alícuota. En JSON:alicuotas: [{tasa, monto}]. - Alias de alícuotas:
general(21),reducida(10.5),incrementada(27) ycero(0). Se aceptan igual que el número en--alicuota,alicuotaIvayconfig alicuota. arcli ultimos <tipo>: lista los últimos comprobantes emitidos en ARCA (--cantidadde 1 a 50, por defecto 10).arcli consultar <tipo> <numero>: muestra el detalle de un comprobante emitido, con CAE, vencimiento, importes y receptor.- Los dos tienen
--jsony--pv. Antes esto solo se podía ver desde el modo interactivo.
Cambiado
- Lotes (
--cargarcon un array):- Se validan todos los comprobantes antes de emitir el primero. Si alguno es inválido, no se emite ninguno y el error
BATCH_VALIDATION_ERRORlos lista a todos con su índice. - Antes, las reglas de negocio se validaban mientras se emitía: si el #3 era inválido, el #1 y el #2 ya estaban emitidos y sus resultados no se mostraban.
- Si la emisión se corta a mitad (red, ARCA), se muestran los comprobantes ya procesados y después el error
BATCH_EMISSION_ERROR, con el ítem que falló y los que quedaron sin procesar.
- Se validan todos los comprobantes antes de emitir el primero. Si alguno es inválido, no se emite ninguno y el error
Corregido
- El comando equivalente del modo interactivo no incluía la moneda extranjera (
--moneda,--cm,--misma-moneda). - La salida
--jsontraía códigos de color ANSI cuando se redirigía (arcli ... --json | jqfallaba conparse error). Ahora solo hay colores si la salida es una terminal real.FORCE_COLOR=1los fuerza yNO_COLORlos apaga. - En el modo interactivo, el logo ahora tiene 3 líneas en blanco abajo, igual que arriba. Antes la barra de estado quedaba pegada.
1.3.002/10/2026
Esta versión suma el modo interactivo para quien factura de vez en cuando y renueva la salida de la terminal: bordes según el tipo de panel, paneles que se ajustan a ventanas angostas y varios bugs de color corregidos. No se rompe ningún comando, flag ni JSON existente. El único cambio de comportamiento es que arcli sin argumentos, en una terminal interactiva, abre el asistente en lugar de la ayuda.
Agregado
ARCLI_ASCII=1dibuja los paneles con ASCII puro, para terminales que no muestran caracteres de caja.- Modo interactivo.
arclisin argumentos en una terminal interactiva abre un asistente paso a paso (tambiénarcli interactivo):- Emitir facturas A, B o C, comunes o FCE.
- Notas de crédito y débito eligiendo la factura de una lista de las últimas emitidas, consultadas a ARCA.
- Ver los últimos comprobantes y revisar la configuración.
- Antes de emitir muestra la vista previa y el comando equivalente. En producción pide una segunda confirmación.
- Usa las mismas validaciones y la misma emisión que los comandos con flags. Ver Modo interactivo.
Cambiado
- Bordes según el tipo de panel, para reconocerlo antes de leerlo:
- Comprobantes: la línea antes del estado ahora es de puntos y llega al borde (
├┄┄┤). - Errores del CLI y de ARCA:
╭─╮, con una franja gruesa┃a la izquierda. - Observaciones y avisos del régimen FCE: la misma forma, con la franja a trazos
╏. Sugerencias: franja fina┆. - Configuración y régimen FCE: ficha
┌─┐con el título a la izquierda. - Revisión de configuración:
╓─╖con el veredicto en el pie (╟──╢). - Últimos comprobantes (modo interactivo): solo reglas
══arriba y abajo, sin costados. - Avisos simples (“No se emitió nada”): solo las esquinas
┌ ┐ └ ┘. - Banner de TESTING:
┌╌┐. Aviso de nueva versión:╭─╮. JSON y respuestas crudas:┌┈┐. - Encabezado del modo interactivo: una barra de estado de una línea (
━━ MODO INTERACTIVO ━━ testing · PV 3 ━━). - Títulos de
arcli ejemplos: una línea de sección (── FACTURA C ──) en lugar de una caja. - “Esto equivale a:” del modo interactivo: solo
▎a la izquierda, sin borde derecho, para que el comando se copie limpio. arcli storybook bordesmuestra cada estilo con el panel donde se usa.
- Comprobantes: la línea antes del estado ahora es de puntos y llega al borde (
- Las etiquetas de las tablas, los pies de los paneles y el “CLI” del logo usan el color por defecto de la terminal en lugar de blanco fijo, que casi no se leía en terminales con fondo claro.
- Los títulos de los paneles de JSON, respuesta bruta y eventos pasan de celeste a gris, para que no compitan con los paneles informativos.
- Los errores muestran Detalles en cian y Sugerencia en amarillo, como dice la paleta. Antes estaban al revés. El panel “Sugerencias” de la respuesta también pasa a amarillo.
arclisin argumentos en una terminal interactiva abre el asistente en lugar de la ayuda. Sin terminal (pipes, CI, agentes) o con--jsonsigue mostrando la ayuda.arcli ayudayarcli --ayudano cambian.
Corregido
- Los títulos de los paneles ignoraban el color pedido desde la primera versión. Ahora el comprobante sale verde si fue aprobado, amarillo si quedó observado y rojo si fue rechazado; los errores, en rojo.
- El texto atenuado dejaba el atenuado prendido y apagaba lo que se imprimía después: el comando del “Esto equivale a:” y el comienzo del panel siguiente hasta el título.
- En terminales angostas los paneles medían al menos 68 columnas y se rompían. Ahora se ajustan al ancho de la ventana: las filas etiqueta/valor parten el valor debajo de su columna y, si no hay lugar, apilan etiqueta y valor. El logo se reemplaza por el nombre si no entra.
- El README decía que alcanzaba con Node.js 20. El mínimo es Node.js 22.22.1, como pide
engines.
Dependencias
boxen8 → 9,zod4.4 → 4.6 y@inquirer/select5.2.2 → 5.2.5. No cambia la salida de la terminal.- Herramientas de desarrollo:
vitesty@vitest/coverage-v84 → 5 (ahora requierenvitecomo dependencia explícita),eslint,typescript-eslint,prettier,lint-stagedytsx. - Se mantienen
typescript6, porquetypescript-eslinttodavía no soporta TypeScript 7, y@types/node22, para no usar APIs que no existen en Node 22, la versión mínima soportada.
1.2.002/10/2026
Esta versión revisa el payload que ARCLI envía a ARCA contra el manual de WSFEv1 y corrige los casos en que ARCA rechazaba el comprobante. Además completa el soporte de Factura de Crédito Electrónica (FCE) y suma alícuotas, importes exentos y no gravados, y período asociado.
⚠️ Puede afectar comandos o scripts existentes
Ninguno de estos cambios quita flags. Todos convierten en un error local, con el motivo en castellano, algo que antes llegaba a ARCA y ARCA rechazaba:
- Moneda extranjera sin cotización:
--moneda USDsin--cotizacion-monedada error. Antes se enviaba cotización1. En pesos, una cotización distinta de1también da error. - IVA receptor según la letra:
facon--ir-cf, ofbcon--ir-ri, da error y sugiere la letra correcta. Se usa la tabla deFEParamGetCondicionIvaReceptor. - Consumidor final desde $10.000.000:
--consumidor-finalda error desde ese monto (RG 5700/2025). Hay que identificar al receptor con--dni,--cuito--cuil. - Fecha del comprobante:
--fechafuera de la ventana de ARCA da error. La ventana es ±5 días en productos, ±10 en servicios y de −5 a +1 en FCE. En productos y FCE, una fecha futura tiene que caer en el mes actual. - FCE: las facturas FCE sin CBU, y las NC/ND FCE sin
--afecha, dan error. - Flags de FCE fuera de FCE:
--cbu,--alias,--transferenciay--anulaciondan error en comprobantes que no son FCE. - Salida JSON: la salida de facturación suma el campo
avisos(siempre presente, vacío si no hay avisos).
Agregado
--misma-monedapara comprobantes en moneda extranjera que se cobran en esa moneda. Consulta la cotización oficial a ARCA y envíaCanMisMonExt = S. Clave JSON:mismaMoneda.--vencimiento <fecha>(alias--vto) para separar el vencimiento de pago del período de servicio. Clave JSON:vencimientoPago.- Soporte completo de FCE:
- Facturas:
--cbu,--aliasy--transferencia sca|adc. - NC/ND:
--anulaciony--afecha. El CUIT del asociado se toma del emisor. - Claves de config
cbuyaliasCbu, aplicadas solo a facturas FCE. - Claves JSON
cbu,aliasCbu,transferencia,anulacionycomprobanteAsociado.fecha.
- Facturas:
--afechatambién disponible, opcional, en notas comunes.--alicuota 0|2.5|5|10.5|21|27para letras A y B, y la clave de configalicuotapara fijarla por defecto. Clave JSON:alicuotaIva.--exento <monto>y--nogravado <monto>: reparten el total en importe exento (ImpOpEx) y no gravado (ImpTotConc). Claves JSON:importeExentoeimporteNoGravado.--periodo-desde/--periodo-hasta(alias--pd/--ph): período asociado en notas comunes, como alternativa a--ac. Clave JSON:periodoAsociado.- Comando
arcli fce-obligado <cuit>: consulta en ARCA (wsfecred) si un receptor está obligado a recibir FCE y desde qué monto. - Clave de config
verificarFce(opt-in): hace esa consulta en cada factura con CUIT y avisa si corresponde FCE en lugar de factura común, o al revés. No frena la emisión. - La vista previa muestra CBU, transferencia, anulación, fecha y período asociado, alícuota, importe no gravado y avisos.
- Los errores de valores no soportados listan los valores válidos.
Corregido
- Dólar se enviaba como
USD; ahora se envíaDOL, el código de ARCA. - La factura A a un receptor que no era responsable inscripto salía sin IVA discriminado. Ahora A y B siempre discriminan IVA.
- Las facturas FCE de productos no enviaban
FchVtoPago, y las NC/ND FCE lo enviaban cuando no correspondía. - Un servicio facturado después de su fin enviaba un vencimiento de pago anterior a la fecha del comprobante. Ahora nunca es anterior.
- La fecha por defecto del comprobante se calculaba en UTC: después de las 21 hs en Argentina salía con el día siguiente.
arcli ejemplosusaba fechas fijas que quedaban fuera de la ventana de ARCA. Ahora son relativas a hoy e incluyen los datos de FCE.- Con
config cotizacionconfigurada, las facturas en pesos ya no toman esa cotización.
Dependencias
@arcasdk/core2.0.0 → 2.0.2. La 2.0.0 validaba el total sin sumar exento ni no gravado (ralcorta/arcasdk#190). La 2.0.2 además exponewsfecredy tipaPeriodoAsoc.
Documentación
- Secciones nuevas en reglas de validación: moneda y cotización, IVA receptor por letra, vencimiento de pago, fecha del comprobante, crédito electrónico (FCE) y régimen FCE del receptor.
- La guía de certificados explica cómo autorizar
wsfecred. - Se actualizaron la referencia del CLI, entrada y salida, configuración, patrones de uso (con uno de FCE), troubleshooting, glosario, checklist de testing y
llms.txt.
1.1.024/08/2026
Primera versión publicada en npm.
- Facturas, notas de crédito y notas de débito A, B y C, comunes y de crédito electrónica, por shortcut (
fc,nca…) o por familia y letra (factura c…). - Configuración persistente (
arcli config), revisión del entorno (arcli config revisar) ytestingcomo entorno por defecto. - Vista previa antes de emitir, carga desde JSON (
--cargar, también por lotes) y salida humana,--jsono--bruto. arcli ejemploscon comandos listos para copiar.llms.txt: referencia condensada para que un agente de IA con acceso a terminal ejecute el CLI.- Publicación con npm Trusted Publishers (OIDC).