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