Skip to content

v2.5.0

Latest

Choose a tag to compare

@LcsGrz LcsGrz released this 17 Nov 13:36
· 3 commits to main since this release
0cd207d

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.
  • --afecha en las notas FCE y --numero en fe, nde y nce dejan de ser obligatorios: sin ellos, ARCLI los toma de ARCA.
  • arcli config --json trae filasPorLista y, mientras dure la deprecación, también comprobantesPorLista y deprecado.
  • En arcli certificado generar --json, guia apunta 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

  • Clave de config filasPorLista (1 a 50, por defecto 15): reemplaza a comprobantesPorLista, 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 muestran arcli 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 de arcli 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, 060 o usd) y se desplazan con las flechas; las filas por página son las de filasPorLista. 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, en iva-receptor y puntos-venta, una tercera columna) y al pie para qué sirve el código en ARCLI. Es salida humana: el --json no 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 (cbu y aliasCbu), como ya pasaba con la actividad de la E.
  • La E completa en el modo interactivo: la factura E y 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 notas E ahora pueden ajustar otra nota E, no solo la factura. El comando equivalente incluye los flags nuevos (--item, --idioma, --cuit-pais, --observaciones, --obs-comerciales, --incoterms-desc, --cm y --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 E y 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 que arcli consultar fe. Antes solo estaban los 19 tipos de A, B y C.
  • Permisos de embarque en el modo interactivo: la factura E de bienes pregunta los permisos de embarque ya existentes (opcional, separados por coma), igual que --permiso con --permiso-existente. Las notas E sobre una factura de bienes también los preguntan.
  • ultimos y consultar con la E: arcli ultimos fe (también nde y nce) lista los últimos comprobantes de exportación y arcli 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 su config.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 nce y arcli nde (también arcli nota-credito e y arcli nota-debito e) ajustan una Factura de exportación E ya emitida. Alcanza con el monto, el asociado (--ar, y --apv si 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 (null en 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 factura E ni de A, B y C.

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 config pdf, y lo elegido decide. Con pdf preguntar (el valor por defecto) ya no hay una segunda pregunta, "¿Generamos el PDF del comprobante?", después de emitir. Con pdf siempre se puede emitir sin PDF (el cursor arranca en la opción con PDF), y con pdf nunca aparece la opción para generarlo esa vez. Con --exportar-pdf o --sin-pdf el PDF ya está decidido y la pregunta solo ofrece emitir o no. Al emitir sin confirmar (--emitir, emitir true, --json o sin terminal) todo sigue igual: decide la config. Vale para todos los comprobantes, también la E, 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 --monto para anularla entera. Antes la mandaba igual y decidía ARCA. Es el mismo control que ya tenían las notas E y 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 --acuit de otro CUIT no se controla, y si ARCA no responde la nota sigue con un aviso.
  • --afecha deja de ser obligatoria en las notas FCE: en ncea…ndec, sin --afecha, ARCLI toma la fecha del asociado de ARCA, como en las notas E, 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.
  • --numero deja de ser obligatorio en fe, nde y nce: 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 (o numero en --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 con arcli 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 --ayuda suma Documentación: https://arcli.com.ar, y el modo interactivo lo muestra al empezar la configuración guiada y al salir. En arcli certificado generar --json, el campo guia trae la URL nueva; los campos no cambian.

Deprecado

  • comprobantesPorLista, ahora filasPorLista; se saca en la 3.0.0. Hasta entonces se sigue leyendo del archivo de config (si están las dos, gana filasPorLista), arcli config establecer comprobantesPorLista N avisa y guarda filasPorLista (y saca la vieja), y arcli config --json trae las dos con el mismo valor, más deprecado.

Arreglado

  • Datos vacíos del receptor en el PDF: a un consumidor final sin identificar, el PDF muestra Documento: - en lugar de Documento: - -, 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-nombre y --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 en cotizacion), 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, o arcli interactivo --produccion/--testing), no siempre los de testing. Con entorno 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

  • 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.md y usage-patterns.md quedan como índice. El sitio publica además llms-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 generar e importar (la recomendada, con la que ya no hay que configurar nada) o, si la clave se hizo con openssl, las rutas a mano con arcli 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.