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