Skip to content

v2.4.0

Choose a tag to compare

@LcsGrz LcsGrz released this 08 Nov 21:24
· 5 commits to main since this release
405f104

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, estado del --json pasa de "observado" a "previsualizacion".
  • fe --cargar con "previsualizar": false ya no emite por sí solo (como A, B y C).
  • --moneda USD sin --cm ya no da error: usa la cotización oficial de ARCA.
  • Cambian textos de error, sugerencia y avisos (opciones entre backticks, tildes), no sus claves ni los códigos.
  • El certificado sin autorizar a facturar sale como WSFE_SERVICE_NOT_AUTHORIZED en lugar de UNEXPECTED_ERROR.

Hay deprecaciones para la 3.0.0: ver "Deprecado".

Cambiado

  • estado de la vista previa en el --json: pasa de "observado" a "previsualizacion", en A, B, C y la E. Antes parecía que ARCA había observado algo, pero no se emitió nada. previsualizacion: true sigue igual. Un script que compara estado === "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 USD sin --cm ni --misma-moneda usa la cotización oficial de ARCA y lo avisa en "Avisos" (y en avisos del JSON). Antes daba error "Falta la cotización". --cm sigue pisándola y --cm 1 sigue siendo error.
  • Un solo formato para los importes: la salida en terminal muestra los pesos como $ 1.500 o $ 1.500,50, con el espacio que usa el PDF y sin ,00 si no hay centavos. Antes convivían 1.500$, $1.500 y $ 1.500,00. En moneda extranjera todos los comprobantes muestran el código ISO en lugar del $ (1.500,50 USD), y el error de fe cuando los ítems no suman --monto deja de usar punto decimal (1.500,50 en lugar de 1500.50). Los textos de errores y avisos toman el mismo formato, también en el --json. El PDF no cambia y los importes del --json siguen 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 como 00001-00001234, también el asociado y la factura E; cotización con dos decimales o más (1.250,50, 1.250,123456) y porcentajes con coma (10,5%); fechas dd/mm/aaaa; N/D para lo que ARCA no informa y sin configurar para la config. El vencimiento del certificado se calcula siempre en hora de Argentina. El --json no 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 como Falta 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 dice Emitiendo la factura B en ARCA.... En la ayuda, --previsualizar ya no dice que muestra algo "antes de emitir" (no emite), los alias nombran su flag y los ejemplos dicen COMPLETA en lugar de FULL. El modo interactivo de config muestra etiquetas (Responsable inscripto, 21%) en lugar de valores crudos; lo que se guarda no cambia. Son textos: pueden cambiar error, sugerencia y avisos en 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 avisa No 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ían La factura b, La recibo c y Últimas Factura B. Son textos: también cambian dentro de error en el --json, pero la clave comprobante y 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 Receptor en lugar de tres. Lo que tiene valor se sigue mostrando, venga de una flag, de la config o de un default. consultar tampoco muestra Importe IVA en cero. El --json y --bruto siguen 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 lista Observaciones, Eventos ni Errores en 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 en error con --json. El panel ya no repite la palabra Error. El mensaje de CUIT, certificado o clave faltante no repite arcli config revisar, que queda en la sugerencia del panel (cambia el texto de error y detalle en 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 de parametros). Son textos: cambian error, sugerencias y avisos en 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 --json tampoco.
  • config revisar no repite el CUIT: si falta, la terminal muestra una sola fila en rojo, en Cuenta, en lugar de un aviso y un error. El --json sigue 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 ni a lo 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 deprecado con qué usar. Code/Msg (A, B y C) y code/message (E) en errores y eventos pasan a codigo/mensaje, que ya están. detalles.errors pasa a detalles.errores. En estado, puntoVenta será un número: el detalle ya está en puntoVentaDetalle. En padron y fce-obligado, cuit será texto. En --cargar de fe, monto pasa a montoTotal, que ya se acepta; mandar las dos es un error. La tabla está en Entrada y salida.
  • La clave cotizacion de 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 de 1), cada factura en moneda extranjera sin --cm la usa y avisa que está deprecada, y config establecer cotizacion avisa lo mismo. Para dejar de usarla, arcli config eliminar cotizacion. config --json sigue trayendo cotizacion.

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 el arcli instalado y lo informa en usaArcliInstalado. Si no encuentra un arcli instalado, el ícono lo dice y muestra cómo instalarlo, en lugar de "command not found".
  • Más datos en el JSON de las emisiones: entorno y puntoVenta en todos los comprobantes, y numero en 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 venta 10005/11002), sugerencias dice 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 add o bun 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 revisar revisa 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, como arcli pdf estado. Con pdf=siempre avisa si falta; con preguntar (por defecto) solo lo revisa si está instalado, así ok no pasa a false para quien no genera PDFs; con nunca no lo revisa.
  • Todas las monedas de ARCA con su código ISO: --moneda, codigoMoneda del JSON y la clave moneda de la config aceptan el código ISO o el de ARCA, indistinto: ARS o PES, USD o DOL, UYU o 011, CLP o 033, GBP o 021, y así con todas las de la tabla de ARCA que tienen ISO. Antes solo se traducían ARS, USD, EUR y BRL, y otro ISO se mandaba tal cual y ARCA lo rechazaba. La vista previa y consultar muestran el nombre con el ISO (Pesos uruguayos (UYU)), el PDF de la E muestra el ISO de cualquier moneda y el autocompletado de --moneda ofrece todos los ISO. Un código que no está en la tabla se sigue mandando tal cual.

Corregido

  • EMISSION_UNCERTAIN sugiere verificar en el entorno en que se emitió: antes arcli ultimos consultaba el de la config, y emitido con --produccion con 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 la E, "pdf" del archivo se ignoraba, --exportar-pdf con --sin-pdf no 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 todo comprobanteAsociado del archivo; ahora se combinan. importeExento e importeNoGravado en 0 cuentan 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-final después de --consumidor-final, que lo implica.
  • Mensajes que confundían: --moneda USD --cm 1 decí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 --cargar con "previsualizar": false emitía sin preguntar: en A, B y C eso no emite y decide la config (en una terminal pregunta); ahora la E hace lo mismo. Para emitir desde el archivo, "emitir": true. "emitir" y "previsualizar" en true a 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.log guardaba códigos de color en el archivo, y con arcli ... | jq el 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=1 cubre 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 parametros y ultimos dicen PRODUCCIÓN en lugar de PRODUCCION, y estado, config, config revisar y los errores de comprobante o CUIT no encontrado dicen producción. El --json conserva entorno: "produccion"; solo cambia el texto de error y detalle.
  • arcli config muestra el CUIT con guiones: 20-33333333-4, igual que el resto de los comandos. config --json no cambia.
  • Textos: tildes que faltaban en sí, automático, Cuándo generar el PDF, puntos críticos y Estás utilizando el entorno de TESTING. La ayuda de --moneda dice etc. 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 small en producción: en sistemas con OpenSSL en SECLEVEL=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 como EMISSION_UNCERTAIN, igual que A, B y C, en lugar de un error inesperado que invitaba a reintentar. detalles trae numero e idSolicitud, 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: --numero decía "por defecto el siguiente de ARCA", pero es obligatorio. Ahora la ayuda lo dice.
  • Certificado vencido: la sugerencia de CERTIFICATE_EXPIRED manda a renovarlo con arcli certificado generar e importar, en lugar de cargar las rutas a mano con arcli config establecer.