Skip to content

v2.0.0

Choose a tag to compare

@LcsGrz LcsGrz released this 12 Oct 08:57
ebceea2

Versión mayor: sale de una auditoría del proyecto. Lo que rompe es cómo se escriben algunos valores en los flags:

  • Montos en formato argentino: punto para miles y coma para decimales (15.000, 1.500,50). -m 1500.50 ahora da error; escribí 1500,50.
  • Enteros solo con dígitos: --pv 3a da error en vez de leerse como 3.
  • --dia no se combina con --fecha ni --servicio-hasta.
  • Varias alícuotas: la suma tiene que coincidir exacta con --monto.
  • Un error de red al emitir sale como EMISSION_UNCERTAIN, no como TRANSIENT_ERROR/UNEXPECTED_ERROR.

El resto son correcciones: evitar comprobantes duplicados, fecha argentina en cualquier zona horaria, ImpTotal exacto, PDF escapado, archivos privados y validaciones más estrictas.

Agregado

  • Modo interactivo, estado de ARCA en la barra: la barra de arriba del menú ya no dice "Modo interactivo": muestra ARCA funcionando, con demoras (más de 3 segundos), con problemas (algún servidor no responde OK) o sin respuesta, en color, seguido del entorno (TESTING en naranja, PRODUCCION en celeste). A la izquierda, la razón social del emisor (o el CUIT, si no está configurada) y el punto de venta.
  • Versión debajo del logo (v1.8.0 | LcsGrz), en el modo interactivo y en la ayuda.
  • Mismo ancho para todo: las cajas de la salida en texto, la barra de estado y el logo (ahora centrado) ocupan 92 columnas, o menos si la terminal es más angosta. Antes cada caja medía distinto según su contenido. Los comprobantes (vista previa, resultado de la emisión y consultar) mantienen su ancho de ticket, de 68 a 80 columnas, y van centrados. El JSON no cambia.
  • Modo interactivo, listas de comprobantes: las filas ocupan todo el ancho de la línea punteada que las enmarca.
  • Modo interactivo, actualizar: si hay una versión nueva, la primera opción del menú es Actualizar a la versión X.Y.Z. Muestra tu versión, la nueva y sus novedades, y con Cerrar para actualizar copia npm install -g arcli@latest al portapapeles y cierra el asistente para que lo ejecutes. En el modo interactivo el aviso de nueva versión ya no aparece al salir.

Cambiado

  • Enteros estrictos, y es un cambio que rompe: --pv, --punto-venta, --ar, --apv, --at, --dia y --cantidad aceptan solo dígitos; antes --pv 3a se leía como 3. --cuit, --cuil y --dni aceptan además guiones y puntos (20-11111111-2), como el modo interactivo; antes --cuit 20111111112xyz pasaba.
  • --dia con --fecha o --servicio-hasta da error: antes --dia se ignoraba sin aviso.
  • Montos del JSON con 2 decimales como máximo (la cotización, 6), igual que los flags.
  • Varias alícuotas: la suma tiene que coincidir exacta con --monto; antes se aceptaba un centavo de diferencia, y el ImpTotal enviado podía no coincidir con la suma de sus partes.
  • Montos en formato argentino, y es un cambio que rompe: --monto, --exento, --nogravado, --cotizacion-moneda/--cm, el monto de --alicuota TASA:MONTO y config establecer cotizacion usan punto para miles y coma para decimales. 15.000 es quince mil y 1.500,50 es mil quinientos con cincuenta. Antes -m 15.000 se leía como 15 y -m 1500,50 como 1500, sin aviso. Ahora 1500.50 da error ("use coma para los decimales"), igual que el texto sobrante (12abc) y más de 2 decimales (la cotización acepta hasta 6). El JSON de --cargar no cambia: ahí los montos son números.
  • Modo interactivo: los montos siguen la misma regla. 1500.50 ya no se acepta y más de 2 decimales da error en lugar de redondearse en silencio. El comando equivalente que muestra al final escribe los montos con coma.

Corregido

  • Modo interactivo, notas y repetir factura copian más de la original:
    • Una NC o ND sobre una factura en dólares va en dólares, con la cotización de la factura; antes salía en pesos.
    • "Anular el total" copia también exento y no gravado.
    • "Repetir factura" copia exento y no gravado.
    • Si la factura tiene varias alícuotas o tributos, ARCA no devuelve el detalle para reproducirla. En ese caso se avisa, no se ofrece "anular el total" ni "mismo monto", y se pide elegir la alícuota.
  • Salida de terminal sin secuencias de control: observaciones de ARCA, datos del JSON o errores de npm ya no pueden mover el cursor, borrar la pantalla, pisar una línea ni meter hipervínculos. Solo pasan colores, saltos de línea y tabs. --json no cambia.
  • Rutas absolutas en la config: cert.*, key.* y ticketPath se guardan resueltas, como pdfCarpeta. Antes una ruta relativa dependía de la carpeta desde donde se corría ARCLI.
  • Clave privada cifrada: config establecer key.* la rechaza con un mensaje claro y cómo descifrarla. Antes se aceptaba y fallaba recién al hablar con ARCA.
  • PDF: textos escapados. La plantilla de @arcasdk/pdf no escapa HTML y Chromium la renderiza con JavaScript: una razón social o descripción con <script> (por ejemplo, de un JSON de terceros) se ejecutaba, y un & legítimo se veía mal. Ahora todos los textos se escapan antes de generar el PDF.
  • Tickets de ARCA y config solo para tu usuario: ARCLI crea sus archivos con permisos 0600/0700 (umask 077), incluidos los tickets que escribe el SDK, y deja en 0700 la carpeta de config y la de tickets que ya existían. Antes quedaban 0644/0755, y en Linux otro usuario del equipo podía leer un ticket y usarlo para emitir durante su validez. Los PDFs nuevos también quedan solo para tu usuario.
  • config establecer ya no guarda valores inválidos: antes config establecer cuit abc lo guardaba igual y dejaba el CLI inutilizable, incluso config eliminar. Ahora se valida antes de guardar, y una config que ya estaba rota se arregla con config establecer o config eliminar de la clave que falla.
  • Fecha argentina siempre: en un equipo con otra zona horaria (por ejemplo un servidor en UTC), entre las 21 y las 24 h la fecha del comprobante salía con el día siguiente. Ahora "hoy" es siempre el día en Argentina.
  • ImpTotal exacto: se calcula como la suma de no gravado, exento, neto e IVA con aritmética decimal. Con varias alícuotas, el total ya no sale como 300.29999999999995.
  • --at se valida como --ac: una NC A ya no puede asociar una factura B por código; si tipo y atajo vienen juntos tienen que coincidir.
  • ayuda como valor de un flag (--descripcion ayuda) ya no abre la ayuda.
  • Emisión sin confirmar: si falla la llamada que emite en ARCA (red, timeout, transacción activa), el error ahora es EMISSION_UNCERTAIN y avisa que el comprobante puede haberse emitido igual, con el arcli ultimos <tipo> --pv <n> para verificarlo antes de reintentar. Antes salía como TRANSIENT_ERROR o UNEXPECTED_ERROR y sugería reintentar, lo que podía duplicarlo. En un lote, BATCH_EMISSION_ERROR suma detalles.sinConfirmar.
  • Ctrl+C en las preguntas del PDF, que llegan después de emitir: el modo interactivo decía "Cancelado. No se emitio nada." aunque el comprobante ya estaba emitido, y el comando terminaba en "Error inesperado" con exit 1. Ahora se toma como "no generar el PDF" y se avisa que el comprobante quedó emitido.
  • Un flag escrito siempre gana: --previsualizar ya no choca con emitir=true en la config o "emitir": true en el JSON, y --emitir gana a "previsualizar": true. Lo mismo con --alicuota TASA sobre las alicuotas del JSON, --cm sobre "mismaMoneda" y --misma-moneda sobre "cotizacionMoneda". El error de "ambos a la vez" queda solo si los dos vienen del mismo lugar.
  • Errores en JSON con json=true en la config: antes solo salían en JSON con el flag --json.
  • cae y caeVencimiento son null en un comprobante rechazado, como dice la documentación; antes venían como "".
  • Los errores con sugerencia la incluyen en sugerencia también en JSON (antes solo los del PDF).
  • Documentación de la emisión en producción: decía que emitir en producción exige --produccion --emitir. En realidad el entorno sale de config.entorno y la emisión de config.emitir cuando no pasás flags: con entorno produccion y emitir true se emite en producción sin flags. El comportamiento no cambió; se corrigieron SECURITY.md, README, llms.txt, la ayuda y los docs.