Skip to content

v2.1.0

Choose a tag to compare

@LcsGrz LcsGrz released this 23 Oct 04:56
· 70 commits to main since this release
f32b32c

Trae arcli padron y el IVA receptor desde el padrón al facturar con --cuit, el aviso de vencimiento del certificado y una guía para el punto de venta de web service. Además corrige un montón de cosas que salen de una revisión del repo: el JSON de --cargar se valida clave por clave, los errores con --json tienen siempre la misma forma, y los ejemplos de la ayuda y de los docs se pueden copiar y andan.

Algunos cambios rompen scripts que dependían del comportamiento anterior. Revisá la sección "Cambiado":

  • Exit code 2 cuando ARCA rechaza un comprobante (antes, 0).
  • Validación estricta del JSON de --cargar: una clave desconocida o con otro tipo ahora es error.
  • Un array de un elemento en --cargar sale como array.
  • --bruto agrega respuesta en lugar de reemplazar el resumen.
  • config revisar ya no recibe --testing ni --produccion.
  • Los PDFs se guardan en una subcarpeta por CUIT.

Los comandos, los flags de facturación y las claves de config siguen siendo los mismos.

Agregado

  • arcli padron <cuit>: nombre o razón social, domicilio fiscal, condición IVA, impuestos, categoría de monotributo y actividad de un CUIT, desde el padrón de ARCA (ws_sr_constancia_inscripcion). Con --json para scripts.
  • IVA receptor desde el padrón: al facturar con --cuit y sin --ir, ARCLI usa la condición IVA del padrón, antes que el ivaReceptor de la config. También completa el nombre y el domicilio del receptor para el PDF. Si el padrón no responde o no la informa, sigue con la config y avisa. El modo interactivo propone la misma condición al cargar un CUIT. Se desactiva con arcli config establecer consultarPadron false.
  • Aviso de vencimiento del certificado: a menos de 30 días de vencer cualquiera de los certificados configurados (testing o producción, sin importar con cuál estés trabajando), los comandos que van a ARCA (facturación, ultimos, consultar, padron, fce-obligado, parametros, estado) avisan al principio, en stderr: El certificado de produccion vence el 20/11/2026 (en 10 días), con el link a la guía para renovarlo. Con --json, stdout queda solo con el JSON y en facturación el aviso va también en avisos. En el modo interactivo es un recuadro debajo de la barra de estado. Si vencen los dos, van en el mismo recuadro. Si ya venció el del entorno que se usa, cortan antes de autenticar en ARCA con el error CERTIFICATE_EXPIRED (antes fallaba el login en WSAA con un error inesperado).
  • Punto de venta para web service: si ARCA rechaza el comprobante porque el punto de venta no es de web service (error 10005), la sugerencia lo dice y apunta a la guía para crear uno. arcli estado avisa lo mismo cuando el punto de venta configurado no está entre los habilitados. Desde el 1/11/2026 ARCA da de alta de oficio puntos de venta "Factura en línea" a monotributistas (RG 5893/2026), y esos no sirven para arcli.

Cambiado

  • --bruto agrega la respuesta cruda sin quitar el resumen: con --json --bruto ahora salen cae, caeVencimiento, estado, resultado, errores, observaciones y el resto del JSON de siempre, más respuesta con la respuesta cruda de ARCA. Antes --bruto reemplazaba el resumen y esos campos desaparecían, aunque la documentación decía que agregaba. En texto pasa lo mismo: el resultado se muestra como siempre y el panel Respuesta bruta va al final. Vale igual para bruto=true en la config.
  • Un array de un elemento en --cargar es un lote: si el JSON es un array sale un array (con indice) y los errores son BATCH_VALIDATION_ERROR / BATCH_EMISSION_ERROR, tenga uno o muchos elementos. Antes un array de un elemento salía como objeto y con los errores de un comprobante suelto. Un objeto sigue devolviendo un objeto. Si un script leía [0] solo cuando había más de uno, ya puede leer siempre el array.
  • El JSON de --cargar se valida clave por clave: una clave desconocida ("montototal", "vencimiento", "moneda") o un valor con otro tipo ("puntoVenta": "3", "emitir": "true", null) ahora es error de entrada (INPUT_VALIDATION_ERROR, o BATCH_VALIDATION_ERROR con el índice en un lote) que nombra la clave y sugiere la correcta. Antes se ignoraban sin aviso: con "puntoVenta": "3" se emitía en el punto de venta de la config. Si un archivo que te funcionaba ahora falla, corregí la clave o sacale las comillas al número; las claves documentadas siguen igual. Un lote vacío ([]) también es error: antes se ignoraba el archivo y se usaban solo los flags. La tabla de claves y su flag equivalente está en entrada y salida.
  • config revisar revisa los dos entornos: valida el entorno por defecto y cualquier otro que tenga cert o key configurados, cada uno en su línea (Validacion testing, Validacion produccion). La línea Revision activa del JSON ya no existe. Ya no recibe --testing ni --produccion: antes los aceptaba pero los ignoraba y revisaba siempre testing.
  • Exit code 2 cuando ARCA rechaza un comprobante: antes salía con 0 y había que leer estado para enterarse. En un lote, 2 si ARCA rechazó al menos uno. observado sigue saliendo con 0. Si un script trataba cualquier exit distinto de 0 como error de ARCLI, ahora también corta en un rechazo.
  • PDFs en una subcarpeta por CUIT emisor: ~/arcli/comprobantes/20123456789/factura-c_0003-00000125.pdf (en testing, testing/20123456789/). Si el archivo ya existe no se pisa: se guarda con -2, -3 y así.
  • sugerencia siempre en el JSON de error: todos los errores con --json traen las mismas cuatro claves (codigo, detalles, error, sugerencia), con sugerencia: null cuando no hay nada que sugerir. Antes faltaba en los errores sin sugerencia (CONFIGURATION_ERROR, INPUT_VALIDATION_ERROR…) y era null solo en los inesperados. Si un script chequeaba si la clave existe, ahora tiene que chequear si es null.
  • --bruto solo en los comandos de facturación: padron, fce-obligado, ultimos, consultar, parametros, estado e interactivo ya no lo declaran (no lo usaban): pasado ahí, el comando corre igual y avisa en stderr que se ignora. Ya no aparece en su ayuda.
  • arcli interactivo --json ya no falla: el asistente acepta solo --testing y --produccion; --json y --bruto se ignoran con un aviso. Sin terminal interactiva sigue fallando, con o sin --json.
  • Comando equivalente del modo interactivo: siempre lleva --testing o --produccion. Antes, en testing no llevaba nada, y si la config pasaba a producción el comando pegado emitía ahí.

Corregido

  • Ejemplos de la ayuda y de los docs que fallaban: los ejemplos de --ayuda de las notas B y C, las B, las FCE y las familias, las NC/ND FCE de arcli ejemplos y varios de los docs (pdf.md, usage-patterns.md, cli-reference.md, el JSON de llms.txt y de input-output.md) daban error al copiarlos: asociado de otra letra, IVA receptor que la letra no admite, FCE sin --cbu o con --acuit ajeno, fechas fijas viejas o sin IVA receptor. Ahora cada nota asocia una factura de su letra y categoría, y un test pasa todos los ejemplos por el parser y arma la solicitud a ARCA.
  • "Puede haberse emitido" cuando seguro no se emitió: un certificado vencido, un fallo de login en WSAA o un error al pedir el último número salían como EMISSION_UNCERTAIN, con la sugerencia de verificar con arcli ultimos antes de reintentar. En esos casos no llegó nada a ARCA: ahora salen con su error (UNEXPECTED_ERROR o TRANSIENT_ERROR en el JSON) y se puede reintentar directo. EMISSION_UNCERTAIN queda solo para un fallo en la llamada que emite (red, timeout, transacción activa). En un lote, ese caso ya no suma detalles.sinConfirmar.
  • Lote interrumpido, PDFs de los ya emitidos: si un lote se cortaba a mitad, los comprobantes que ya tenían CAE quedaban sin PDF. Ahora se generan antes de mostrar el error, según pdf o --exportar-pdf como en un lote completo, y en --json cada uno lleva su campo pdf. Si falla el PDF, el error que se muestra sigue siendo el de la emisión.
  • Lote, fallos del padrón o de la cotización con su índice: si la consulta al padrón (IVA receptor desde --cuit) o a la cotización oficial fallaba para un ítem, el lote cortaba con un error que no decía cuál era. Ahora sale en BATCH_VALIDATION_ERROR, junto con los demás ítems con problemas y su #n, antes de emitir ninguno.
  • config.json con JSON inválido salía como "Error inesperado", sin decir qué archivo ni qué hacer. Ahora es un error de configuración (CONFIGURATION_ERROR) con la ruta del archivo y la sugerencia de corregirlo a mano o renombrarlo y volver a configurar. ARCLI no lo borra ni lo pisa.
  • json=true de la config en todos los comandos: pdf (y sus subcomandos) y parametros sin tabla solo salían en JSON con --json. Ahora todos los comandos resuelven la salida igual: --json o, si no está, la clave json de la config. config ruta acepta --json y devuelve {"ruta": "..."}.
  • Errores de uso en JSON: una opción desconocida (arcli fc --montoo 1 --json), un valor faltante o un comando que no existe salían en texto aunque se pidiera JSON. Ahora, con --json o json=true, salen como INPUT_VALIDATION_ERROR en el mismo formato que el resto de los errores, con exit code 1. Sin JSON se ven igual que antes.
  • Opciones globales que no aplican: --testing, --produccion, --json o --bruto en un comando que no las usa (arcli config ruta --produccion) se aceptaban sin decir nada. Ahora el comando corre igual y avisa en stderr que la opción se ignora.
  • json=true en config: config, config revisar, config establecer y config eliminar respetan json=true de la config, como el resto de los comandos.
  • --dia corría un mes de más a fin de mes: --dia 15 el 31/03 daba el 15/05 en vez del 15/04, y ARCA lo aceptaba con las fechas de servicio y vencimiento equivocadas. Si el día no existe en ese mes (--dia 31 con abril), ahora da error.
  • --json con FORCE_COLOR: con FORCE_COLOR=1 en el entorno, el JSON redirigido a un archivo o a otro programa salía con colores y no se podía parsear. Ahora solo se colorea en una terminal.
  • --json en config: config, config revisar, config establecer y config eliminar ignoraban --json y salían en texto.
  • config --ayuda listaba la mitad de las claves: mostraba 15 de 30. Ahora config --ayuda y config establecer --ayuda listan todas, por sección, con sus valores posibles.
  • Links de llms.txt y del README en el paquete de npm: apuntaban a docs/, que no se publica en npm. Ahora son links a GitHub.
  • config establecer con un valor inválido (puntoVenta abc, comprobantesPorLista 99) sale como error de entrada (INPUT_VALIDATION_ERROR) y no como error inesperado.