Repository navigation
v2.1.0
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.