Repository navigation
v2.0.0
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.50ahora da error; escribí1500,50. - Enteros solo con dígitos:
--pv 3ada error en vez de leerse como 3. --diano se combina con--fechani--servicio-hasta.- Varias alícuotas: la suma tiene que coincidir exacta con
--monto. - Un error de red al emitir sale como
EMISSION_UNCERTAIN, no comoTRANSIENT_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 (
TESTINGen naranja,PRODUCCIONen 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@latestal 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,--diay--cantidadaceptan solo dígitos; antes--pv 3ase leía como 3.--cuit,--cuily--dniaceptan además guiones y puntos (20-11111111-2), como el modo interactivo; antes--cuit 20111111112xyzpasaba. --diacon--fechao--servicio-hastada error: antes--diase 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 elImpTotalenviado 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:MONTOyconfig establecer cotizacionusan punto para miles y coma para decimales.15.000es quince mil y1.500,50es mil quinientos con cincuenta. Antes-m 15.000se leía como 15 y-m 1500,50como 1500, sin aviso. Ahora1500.50da 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--cargarno cambia: ahí los montos son números. - Modo interactivo: los montos siguen la misma regla.
1500.50ya 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.
--jsonno cambia. - Rutas absolutas en la config:
cert.*,key.*yticketPathse guardan resueltas, comopdfCarpeta. 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/pdfno 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(umask077), incluidos los tickets que escribe el SDK, y deja en0700la carpeta de config y la de tickets que ya existían. Antes quedaban0644/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 establecerya no guarda valores inválidos: antesconfig establecer cuit abclo guardaba igual y dejaba el CLI inutilizable, inclusoconfig eliminar. Ahora se valida antes de guardar, y una config que ya estaba rota se arregla conconfig estableceroconfig eliminarde 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.
ImpTotalexacto: 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 como300.29999999999995.--atse valida como--ac: una NC A ya no puede asociar una factura B por código; sitipoyatajovienen juntos tienen que coincidir.ayudacomo 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_UNCERTAINy avisa que el comprobante puede haberse emitido igual, con elarcli ultimos <tipo> --pv <n>para verificarlo antes de reintentar. Antes salía comoTRANSIENT_ERRORoUNEXPECTED_ERRORy sugería reintentar, lo que podía duplicarlo. En un lote,BATCH_EMISSION_ERRORsumadetalles.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:
--previsualizarya no choca conemitir=trueen la config o"emitir": trueen el JSON, y--emitirgana a"previsualizar": true. Lo mismo con--alicuota TASAsobre lasalicuotasdel JSON,--cmsobre"mismaMoneda"y--misma-monedasobre"cotizacionMoneda". El error de "ambos a la vez" queda solo si los dos vienen del mismo lugar. - Errores en JSON con
json=trueen la config: antes solo salían en JSON con el flag--json. caeycaeVencimientosonnullen un comprobante rechazado, como dice la documentación; antes venían como"".- Los errores con sugerencia la incluyen en
sugerenciatambié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 deconfig.entornoy la emisión deconfig.emitircuando no pasás flags: conentorno produccionyemitir truese emite en producción sin flags. El comportamiento no cambió; se corrigieron SECURITY.md, README,llms.txt, la ayuda y los docs.