# arcli: documentación completa Todas las páginas de https://arcli.com.ar/ en un solo archivo. El resumen para agentes está en https://arcli.com.ar/llms.txt. # Instalar y configurar ARCLI Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/instalar.md En unos minutos tenés ARCLI instalado, con un ícono en el escritorio, listo para emitir tu primera factura de prueba. > [!TIP] > **La forma más fácil:** si usás un asistente de IA que puede manejar tu computadora (Claude, ChatGPT, Gemini, Copilot), copiale el [prompt de instalación](#con-un-asistente-de-ia): hace todo por vos. ## Instalar a mano Elegí tu sistema. ### Windows 1. **Instalá Node.js.** Bajá la versión **LTS** de [nodejs.org](https://nodejs.org/es/download) y abrí el instalador. Siguiente, siguiente, finalizar. 2. **Abrí PowerShell.** Menú Inicio, escribí `PowerShell` y Enter. 3. **Instalá ARCLI.** Con npm (si usás otro gestor: `pnpm add -g arcli` o `yarn global add arcli`): ```powershell npm install -g arcli ``` 4. **Creá el ícono en el escritorio:** ```powershell arcli acceso-directo ``` > [!WARNING] > **"La ejecución de scripts está deshabilitada":** es una protección de PowerShell. La solución está en [problemas frecuentes](troubleshooting.md#powershell-dice-la-ejecución-de-scripts-está-deshabilitada). ### macOS 1. **Instalá Node.js.** Bajá la versión **LTS** de [nodejs.org](https://nodejs.org/es/download) (el instalador `.pkg`) y abrilo. 2. **Abrí la Terminal.** Cmd + Espacio, escribí `Terminal` y Enter. 3. **Instalá ARCLI.** Con npm (si usás otro gestor: `pnpm add -g arcli` o `yarn global add arcli`): ```bash npm install -g arcli ``` 4. **Creá el ícono en el escritorio:** ```bash arcli acceso-directo ``` > [!WARNING] > **Error `EACCES` al instalar:** no uses `sudo`. Mirá cómo resolverlo en [problemas frecuentes](troubleshooting.md#npm-install--g-arcli-falla-con-eacces-macos-o-linux). ### Linux 1. **Instalá Node.js 22.22.1 o superior,** con el gestor de tu distribución o con `nvm`, que evita problemas de permisos. 2. **Instalá ARCLI.** Con npm (si usás otro gestor: `pnpm add -g arcli` o `yarn global add arcli`): ```bash npm install -g arcli ``` 3. **Creá el acceso directo:** ```bash arcli acceso-directo ``` ## Con un asistente de IA Copiá esto y pegáselo a tu asistente. Sirve para instalar y para actualizar. El texto para copiar está en el [README](../README.md#empezar), en "Que lo instale tu IA". ## Configurar Abrí ARCLI con doble clic en el ícono. La primera vez, la **configuración guiada** te pide: - tu **CUIT**, - el **punto de venta** para web service, - y el **certificado** de ARCA. Si no lo tenés, lo sacás ahí mismo: [certificado de testing](certificado-testing.md). > [!NOTE] > **Todo empieza en testing.** Los comprobantes de testing no tienen validez fiscal. Producción se activa a propósito, cuando estés seguro: [cambiar de entorno](entornos.md). ## Actualizar Cuando sale una versión nueva, ARCLI te avisa con el comando exacto para el gestor con el que lo instalaste. Es el mismo de la instalación, con `@latest`: ```bash npm install -g arcli@latest ``` Con pnpm, `pnpm add -g arcli@latest`; con yarn, `yarn global add arcli@latest`. O pegale otra vez el [prompt de instalación](#con-un-asistente-de-ia) a tu asistente de IA: sirve también para actualizar. > [!NOTE] > **Yarn 2 o superior** no instala paquetes globales: usá npm o pnpm. --- # Certificado de testing Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/certificado-testing.md Para probar ARCLI sin validez fiscal. Son 4 pasos y tardás unos 15 minutos. Necesitás tu clave fiscal nivel 3. > [!TIP] > **También desde el asistente:** abrí ARCLI → Configuración → Certificados de ARCA y seguí los pasos. Te va diciendo qué hacer en ARCA. ## Pasos ### 1. Habilitá el administrador de certificados Una sola vez. Con tu clave fiscal, en el **Administrador de Relaciones de Clave Fiscal**: Adherir Servicio → ARCA → Servicios Interactivos → **Administración de Certificados Digitales**, y confirmá.
Ver capturas (5) 1. Buscá el Administrador de Relaciones de Clave Fiscal ![Buscador de ARCA con el Administrador de Relaciones](assets/certificados/arca-buscar-administrador-relaciones.png) 2. Elegí el contribuyente: en pruebas, vos ![Selección del contribuyente](assets/certificados/arca-seleccionar-contribuyente.png) 3. Tocá "Adherir Servicio" ![Botón Adherir Servicio](assets/certificados/arca-adherir-servicio.png) 4. Elegí Administración de Certificados Digitales ![Servicio Administración de Certificados Digitales](assets/certificados/arca-elegir-administracion-certificados.png) 5. Confirmá la relación ![Confirmación de la adhesión](assets/certificados/arca-confirmar-adhesion.png)
### 2. Generá el pedido con ARCLI ```bash arcli certificado generar --testing ``` Te muestra un texto (el CSR) para copiar. La clave privada queda guardada en tu computadora. ### 3. Pegalo en WSASS y bajá el certificado Entrá a **WSASS - Autoservicio de Acceso a WebServices** desde el escritorio de ARCA. En "Nuevo Certificado", pegá el CSR, creá el certificado y guardalo en un archivo. Después cargalo: ```bash arcli certificado importar testing.crt ```
Ver capturas (2) 1. Formulario "Crear DN y certificado" ![Formulario para crear el certificado en WSASS](assets/certificados/testing-wsass-nuevo-certificado-form.png) 2. CSR pegado y certificado generado ![Certificado generado en WSASS](assets/certificados/testing-wsass-crear-certificado.png)
### 4. Autorizalo a los servicios que vas a usar En WSASS, "Crear autorización a servicio": elegí tu certificado y un servicio. Repetilo por cada servicio de [la tabla](#qué-servicios-autorizar) que necesites.
Ver capturas (3) 1. Formulario "Crear autorización" ![Formulario para crear la autorización](assets/certificados/testing-crear-autorizacion-form.png) 2. Autorización creada para wsfe ![Autorización creada](assets/certificados/testing-crear-autorizacion-resultado.png) 3. La lista de autorizaciones con la nueva ![Lista de autorizaciones](assets/certificados/testing-autorizaciones-lista.png)
Para revisar que quedó todo bien: ```bash arcli estado --testing ``` Si dice que ARCA responde, ya podés emitir en testing. Un servicio que falte se suma después, repitiendo solo este paso. ## Qué servicios autorizar | Para | Servicio | ¿Lo necesitás? | | ---------------------------------------------------- | ------------------------------ | -------------- | | Facturas y notas A, B y C, y FCE | `wsfe` | Sí, siempre | | El IVA del receptor desde el padrón y `arcli padron` | `ws_sr_constancia_inscripcion` | Recomendado | | Saber si el receptor está obligado a FCE | `wsfecred` | Si emitís FCE | | Factura de exportación E y sus notas | `wsfex` | Si exportás | ## ¿Preferís openssl? Si generás la clave a mano en vez de usar `arcli certificado`, los comandos están en la [versión completa de esta guía](certificado-testing-completa.md), con cada pantalla de ARCA. ## Siguiente paso Emití tu primera factura en testing desde el [asistente](formas-de-uso/asistente.md). Cuando quieras facturar de verdad, seguí con el [certificado de producción](certificado-produccion.md). --- # Certificado de producción Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/certificado-produccion.md Para facturar con validez fiscal. Son los mismos pasos que en testing; cambian el lugar donde se baja el certificado y cómo se autoriza. Tardás unos 20 minutos y necesitás tu clave fiscal nivel 3. > [!TIP] > **También desde el asistente:** abrí ARCLI → Configuración → Certificados de ARCA → Sacar o renovar un certificado → Producción. Te va diciendo qué hacer en ARCA. ## Pasos ### 1. Habilitá el administrador de certificados Una sola vez: si ya lo hiciste para testing, salteá este paso. Si no, con tu clave fiscal, en el **Administrador de Relaciones de Clave Fiscal**: Adherir Servicio → ARCA → Servicios Interactivos → **Administración de Certificados Digitales**, y confirmá.
Ver capturas (5) 1. Buscá el Administrador de Relaciones de Clave Fiscal ![Buscador de ARCA con el Administrador de Relaciones](assets/certificados/arca-buscar-administrador-relaciones.png) 2. Elegí el contribuyente ![Selección del contribuyente](assets/certificados/arca-seleccionar-contribuyente.png) 3. Tocá "Adherir Servicio" ![Botón Adherir Servicio](assets/certificados/arca-adherir-servicio.png) 4. Elegí Administración de Certificados Digitales ![Servicio Administración de Certificados Digitales](assets/certificados/arca-elegir-administracion-certificados.png) 5. Confirmá la relación ![Confirmación de la adhesión](assets/certificados/arca-confirmar-adhesion.png)
### 2. Generá el pedido con ARCLI ```bash arcli certificado generar --produccion ``` Te dice dónde quedó el pedido (el CSR). La clave privada queda guardada en tu computadora. ### 3. Subilo en Administración de Certificados Digitales y bajá el certificado Entrá desde el escritorio de ARCA y elegí **Agregar alias**. Poné un alias, subí el CSR con **Examinar…** y confirmá. En la lista, tocá **Ver** en tu alias y descargá el certificado. Después cargalo: ```bash arcli certificado importar produccion.crt ```
Ver capturas (4) 1. Agregar alias ![Botón Agregar alias](assets/certificados/produccion-agregar-alias.png) 2. El alias y el CSR para subir ![Formulario del alias con el CSR](assets/certificados/produccion-agregar-alias-formulario.png) 3. Ver el certificado en la lista ![Lista de certificados](assets/certificados/produccion-certificados-lista.png) 4. Descargarlo (estado VALIDO) ![Descarga del certificado](assets/certificados/produccion-certificado-descargar.png)
### 4. Autorizalo a los servicios que vas a usar En producción no se hace en WSASS sino en el **Administrador de Relaciones**: **Nueva Relación** → Buscar servicio → ARCA → Web Services → el servicio. En Representante, elegí el **Computador Fiscal** de tu certificado y confirmá. Una relación por cada servicio de [esta tabla](certificado-testing.md#qué-servicios-autorizar) que necesites.
Ver capturas (5) 1. Nueva Relación: buscar el servicio ![Buscar el servicio](assets/certificados/produccion-autorizar-buscar-servicio.png) 2. Elegir el web service ![Elegir el web service](assets/certificados/produccion-autorizar-elegir-webservice.png) 3. Buscar el representante ![Buscar el representante](assets/certificados/produccion-autorizar-buscar-representante.png) 4. Elegir el Computador Fiscal ![Elegir el Computador Fiscal](assets/certificados/produccion-autorizar-elegir-representante.png) 5. Confirmar la relación ![Confirmar la relación](assets/certificados/produccion-autorizar-confirmar.png)
### 5. Creá un punto de venta para web service Fijate si ya tenés uno: ```bash arcli parametros puntos-venta --produccion ``` Si la lista está vacía, crealo en **Administración de puntos de venta y domicilios** → A/B/M de puntos de venta → Agregar. En Sistema elegí **Factura Electrónica - Monotributo - Webservices** o, si sos responsable inscripto, **RI IVA - Aplicativo y Webservices**. Después guardalo: ```bash arcli config establecer puntoVenta 2 ``` > [!WARNING] > **El de Factura en línea no sirve.** Cada sistema usa sus propios puntos de venta: con uno de Comprobantes en línea, ARCA rechaza con el error `10005`. La Factura E necesita además uno del sistema WSFEX. ## Revisar que quedó bien ```bash arcli estado --produccion ``` Si dice que ARCA responde y el punto de venta está habilitado, ya podés emitir con validez fiscal. ## Renovar el certificado Es el mismo camino: `generar` deja la clave nueva aparte y seguís facturando con la actual hasta que `importar` carga el certificado nuevo. Si usás un alias nuevo, repetí el paso 4. ## ¿Preferís openssl? Los comandos para generar la clave a mano, el detalle del punto de venta y las fuentes están en la [versión completa de esta guía](certificado-produccion-completa.md). ## Siguiente paso Antes de la primera factura real, repasá [cambiar de entorno](entornos.md). --- # Certificado de testing Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/certificado-testing-completa.md Para probar ARCLI sin validez fiscal necesitás un certificado de **testing** (homologación) y su clave privada. Esta guía muestra cada pantalla del portal de ARCA. Cuando quieras facturar de verdad, seguí con el [certificado de producción](certificado-produccion-completa.md). **En resumen**, en la web de ARCA vas a habilitar el servicio, crear el certificado con el pedido que arma ARCLI y autorizarlo a facturar (`wsfe`). Desde ARCLI se hace con `arcli certificado generar` e `importar`, o en el asistente: Configuración → Certificados de ARCA. > Contenido adaptado de los tutoriales de [afipts.com](https://www.afipts.com) (ver > [fuentes](#fuentes) al final). Las capturas son de ese sitio; los pasos y comandos > están reescritos y verificados para esta guía. ## Antes de empezar - Necesitás tu Clave Fiscal (nivel de seguridad 3) para entrar al portal de ARCA. - Solo si generás la clave a mano en vez de usar `arcli certificado`, necesitás `openssl`. En Linux y macOS ya viene instalado; en Windows lo bajás de [slproweb.com/products/Win32OpenSSL.html](https://slproweb.com/products/Win32OpenSSL.html) y agregás la carpeta `bin` a tu `PATH` (o abrís la consola directamente desde ahí). - El flujo de **habilitar el administrador de certificados** es idéntico en testing y en producción — lo único que cambia es a qué aplicación te lleva al final. Si ya lo hiciste para un entorno, repetís los mismos pasos eligiendo el otro servicio. ### Qué servicios autorizar El certificado no alcanza: en el paso 3 lo autorizás a cada servicio web que vayas a usar, y algunos comandos usan uno distinto de `wsfe`. Si falta la autorización, ARCA rechaza el pedido aunque el certificado sea válido. Autorizá desde el principio lo que vayas a necesitar: | Para usar | Servicio que autorizás | Punto de venta en producción | | ------------------------------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | Facturas y notas `A`, `B`, `C` y FCE | `wsfe` (Facturación Electrónica) | uno de web service ([ver cómo](certificado-produccion-completa.md#punto-de-venta-para-web-service)) | | `arcli padron` y el IVA del receptor desde el padrón | `ws_sr_constancia_inscripcion` (Constancia de inscripción) | no usa | | `arcli fce-obligado` y el aviso de FCE (`verificarFce`) | `wsfecred` (Factura de Crédito Electrónica MiPyMEs) | no usa | | `arcli fe`, la factura de exportación `E` | `wsfex` (Factura Electrónica de Exportación) | uno del sistema WSFEX, distinto del de `wsfe` | Se puede sumar un servicio después, repitiendo solo el paso 3 con el mismo certificado. --- ## 1. Habilitar el administrador de certificados 1. Entrá al portal de ARCA con tu Clave Fiscal y buscá **"Administrador de Relaciones de Clave Fiscal"**. ![Buscar el Administrador de Relaciones de Clave Fiscal](assets/certificados/arca-buscar-administrador-relaciones.png) 2. Elegí el contribuyente a administrar. En pruebas, usá tu propio usuario para no confundirte con datos de otra persona. ![Seleccionar el contribuyente a administrar](assets/certificados/arca-seleccionar-contribuyente.png) 3. Elegí **"Adherir Servicio"**. ![Adherir servicio](assets/certificados/arca-adherir-servicio.png) 4. Buscá **ARCA → Servicios Interactivos → Administración de Certificados Digitales** en la lista y seleccionalo. ![Elegir Administración de Certificados Digitales en la lista de servicios](assets/certificados/arca-elegir-administracion-certificados.png) 5. Confirmá la relación. ![Confirmar la adhesión del servicio](assets/certificados/arca-confirmar-adhesion.png) ## 2. Generar la clave y el certificado **Con ARCLI (recomendado).** Desde el modo interactivo: `arcli` → Configuración → Certificados de ARCA. O por comandos, con el CUIT ya configurado (`arcli config establecer cuit `): ```bash arcli certificado generar --testing ``` Crea la clave privada y el CSR en la carpeta de config de ARCLI (no necesitás `openssl`, tampoco en Windows) y te muestra el CSR para pegar en WSASS. Seguí con "Ahora entrá a WSASS" más abajo y, cuando tengas el certificado en un archivo, cargalo: ```bash arcli certificado importar testing.crt ``` `importar` valida el certificado, lo guarda junto a la clave y configura `cert.testing` y `key.testing`: en el paso 4 solo queda revisar. Te dice qué cargó (entorno, CUIT, alias y vencimiento). **Con openssl.** Generá la clave privada (2048 bits como mínimo) y guardala en un lugar seguro — es la "contraseña" del certificado, si la perdés tenés que empezar de nuevo: ```bash openssl genrsa -out testing.key 2048 ``` Con esa clave, generá el CSR (Certificate Signing Request). Reemplazá `[empresa]`, `[nombre]` y `[CUIT]` por tus datos (en pruebas, podés usar los tuyos): ```bash openssl req -new -key testing.key -subj "/C=AR/O=[empresa]/CN=[nombre]/serialNumber=CUIT [CUIT]" -out testing.csr ``` Ahora entrá a **WSASS - Autoservicio de Acceso a WebServices (Testing/Homologación)** desde el escritorio de ARCA (llegaste ahí en el paso anterior) y elegí **"Nuevo Certificado"**: ![Formulario "Crear DN y certificado" en WSASS](assets/certificados/testing-wsass-nuevo-certificado-form.png) Completá: 1. **Nombre simbólico del DN**: un alias para identificar este certificado. Con `arcli certificado generar` es el alias que muestra (por defecto `arcli`); con openssl, el que hayas puesto (ej. `Test1`). 2. **CUIT del contribuyente**: ya viene completo. 3. **Solicitud de certificado**: pegá el CSR que te mostró `arcli certificado generar` o, con openssl, el contenido completo de `testing.csr` (abrilo con un editor de texto). Presioná **"Crear DN y obtener certificado"** y copiá el certificado que aparece en el recuadro de resultado a un archivo (ej. `testing.crt`): ![CSR pegado y certificado generado en WSASS](assets/certificados/testing-wsass-crear-certificado.png) Con ARCLI, importalo como se explicó arriba. Con openssl, ya no necesitás el CSR y podés borrarlo: guardá `testing.key` y `testing.crt`, que son los que vas a usar en ARCLI. ## 3. Autorizar el servicio web El certificado por sí solo no alcanza: hay que autorizarlo explícitamente a usar el servicio web que te interesa (por ejemplo `wsfe`, facturación electrónica). Dentro de WSASS, elegí **"Crear autorización a servicio"**: ![Formulario "Crear autorización" en WSASS](assets/certificados/testing-crear-autorizacion-form.png) Completá: 1. **Nombre simbólico del DN a autorizar**: el alias que creaste antes (por defecto `arcli`). 2. **CUIT representado**: en pruebas, tu propio CUIT. 3. **Servicio al que deseas acceder**: `wsfe` para facturación electrónica. > Repetí este paso con cada servicio de [Qué servicios autorizar](#qué-servicios-autorizar) que vayas a usar: `ws_sr_constancia_inscripcion`, `wsfecred` o `wsfex`. Presioná **"Crear autorización de acceso"** — deberías ver un mensaje `OK. Autorización fue creada`: ![Autorización creada para wsfe](assets/certificados/testing-crear-autorizacion-resultado.png) Podés verificarlo entrando a la sección **"Autorizaciones"**: ![Lista de autorizaciones con la nueva entrada](assets/certificados/testing-autorizaciones-lista.png) ## 4. Configurar ARCLI Hay dos formas, según cómo generaste la clave en el paso 2: - **Con `arcli certificado` (recomendada):** si usaste `generar` e `importar`, ya está: `importar` guardó el certificado junto a la clave y configuró `cert.testing` y `key.testing`. Solo falta revisar. - **Con openssl:** cargá a mano las rutas del certificado y de la clave: ```bash arcli config establecer cert.testing /ruta/a/testing.crt arcli config establecer key.testing /ruta/a/testing.key ``` En los dos casos, revisá la config y probá la conexión con ARCA: ```bash arcli config revisar arcli estado --testing ``` --- ## Siguiente paso Configurá el CUIT y el punto de venta, o corré `arcli` para la [configuración guiada](instalar.md#configurar), y emití tu primera factura en testing. Cuando quieras facturar de verdad: [certificado de producción](certificado-produccion-completa.md) y [cambiar de entorno](entornos.md). --- ## Fuentes Tutoriales originales de afipts.com en los que se basa esta guía: - [Habilitar certificados de testing](https://www.afipts.com/tutorial/enable_testing_certificates.html) - [Obtener certificado de testing](https://www.afipts.com/tutorial/obtain-testing-certificate.html) - [Autorizar servicio web de testing](https://www.afipts.com/tutorial/authorize-test-web-service.html) --- # Certificado de producción Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/certificado-produccion-completa.md Para emitir comprobantes con validez fiscal necesitás un certificado de **producción**, distinto del de testing, y un punto de venta para web service. Si todavía no probaste en testing, empezá por el [certificado de testing](certificado-testing-completa.md): los pasos son casi los mismos. > Contenido adaptado de los tutoriales de [afipts.com](https://www.afipts.com) (ver > [fuentes](#fuentes) al final). Las capturas son de ese sitio; los pasos y comandos > están reescritos y verificados para esta guía. Repetí el mismo flujo del [certificado de testing](certificado-testing-completa.md), con dos diferencias: la aplicación para generar el certificado no es WSASS sino **"Administración de Certificados Digitales"**, y la autorización del servicio web se hace desde el Administrador de Relaciones en vez de WSASS. ## 1. Habilitar el administrador de certificados Son los mismos 5 pasos que en el [certificado de testing](certificado-testing-completa.md#1-habilitar-el-administrador-de-certificados), eligiendo el mismo servicio **Administración de Certificados Digitales** para tu usuario en producción. ## 2. Generar la clave y obtener el certificado **Con ARCLI (recomendado).** Generá el pedido: ```bash arcli certificado generar --produccion ``` Subí el CSR como se muestra abajo y, con el `.crt` descargado, cargalo: ```bash arcli certificado importar produccion.crt ``` Configura `cert.produccion` y `key.produccion`, así que en el paso 4 solo queda revisar. **Para renovar** un certificado que está por vencer, es el mismo flujo: `generar` deja la clave nueva pendiente y no toca la actual, así que seguís facturando hasta que `importar` carga el certificado nuevo. Acordate de volver a crear las relaciones del paso 3 si usás un alias nuevo. **Con openssl.** Mismos comandos que en testing, con un archivo distinto: ```bash openssl genrsa -out produccion.key 2048 openssl req -new -key produccion.key -subj "/C=AR/O=[empresa]/CN=[nombre]/serialNumber=CUIT [CUIT]" -out produccion.csr ``` Entrá a **"Administración de Certificados Digitales"** desde el escritorio de ARCA y elegí **"Agregar alias"**: ![Agregar alias en Administración de Certificados Digitales](assets/certificados/produccion-agregar-alias.png) Completá el **Alias** y subí el CSR con **"Examinar..."**: con ARCLI, el archivo que te indicó `generar`; con openssl, `produccion.csr`: ![Formulario de alias con CSR para subir](assets/certificados/produccion-agregar-alias-formulario.png) Confirmá con **"Agregar Alias"**. En la lista de certificados, hacé clic en **"Ver"** para tu alias: ![Lista de certificados con la opción Ver](assets/certificados/produccion-certificados-lista.png) Y descargá el certificado desde el ícono de descarga (columna **Descargar**, estado `VALIDO`): ![Detalle del certificado con el boton de descarga](assets/certificados/produccion-certificado-descargar.png) El CSR ya no es necesario después de este paso, podés borrarlo. ## 3. Autorizar el servicio web En producción esto se hace desde el **Administrador de Relaciones**, no desde WSASS. Elegí **"Nueva Relación"** y presioná **"Buscar"** junto a Servicio: ![Buscar el servicio a autorizar](assets/certificados/produccion-autorizar-buscar-servicio.png) Navegá a **ARCA → Web Services** y elegí el servicio que necesitás (ej. `wsfe`). Creá una relación por cada servicio de [Qué servicios autorizar](certificado-testing.md#qué-servicios-autorizar) que vayas a usar: ![Elegir el web service de la lista](assets/certificados/produccion-autorizar-elegir-webservice.png) Presioná **"Buscar"** junto a Representante: ![Buscar el representante (computador fiscal)](assets/certificados/produccion-autorizar-buscar-representante.png) Elegí el **Computador Fiscal** asociado a tu certificado y confirmá: ![Elegir el computador fiscal y confirmar](assets/certificados/produccion-autorizar-elegir-representante.png) Por último, confirmá la relación completa: ![Confirmar la autorización final](assets/certificados/produccion-autorizar-confirmar.png) ## 4. Configurar ARCLI Hay dos formas, según cómo generaste la clave en el paso 2: - **Con `arcli certificado` (recomendada):** si usaste `generar` e `importar`, ya está: `importar` guardó el certificado junto a la clave y configuró `cert.produccion` y `key.produccion`. Solo falta revisar. - **Con openssl:** cargá a mano las rutas del certificado y de la clave: ```bash arcli config establecer cert.produccion /ruta/a/produccion.crt arcli config establecer key.produccion /ruta/a/produccion.key ``` En los dos casos, revisá la config y probá la conexión con ARCA: ```bash arcli config revisar arcli estado --produccion ``` Para emitir de verdad en producción, pasá además `--produccion --emitir` en el comando de facturación: ver [cambiar de entorno](entornos.md). ## Punto de venta para web service Para emitir en producción también necesitás un punto de venta dado de alta para **web service**. No sirve cualquiera: ARCA rechaza el comprobante (error `10005`, "El punto de venta informado debe estar dado de alta y ser del tipo RECE") si el número que configurás en ARCLI es de otro sistema, como los de **Comprobantes en línea** ("Factura en línea"), Facturador o talonarios manuales. Cada sistema usa sus propios puntos de venta: si ya facturás desde la web de ARCA, creá uno nuevo para ARCLI. > **Monotributistas, desde el 1/11/2026:** con la > [RG 5893/2026](https://www.boletinoficial.gob.ar/detalleAviso/primera/346598/20260831), > si no tenés un punto de venta electrónico habilitado, ARCA te da de alta uno de oficio > para **Comprobantes en línea**, con la opción "Factura en línea - Monotributo". Ese > punto de venta no sirve para ARCLI: creá otro para web service. En testing no hace falta: ARCA no controla el punto de venta y cualquier número sirve. > En producción, la factura de exportación (`arcli fe`) usa **WSFEX - Factura Electrónica de Exportación**, que es un sistema de puntos de venta distinto del de facturación (`wsfe`): un punto de venta habilitado solo para facturación electrónica no sirve para exportación. Dalo de alta con ese sistema si vas a emitir comprobantes `E`. ### 1. Ver si ya tenés uno Con el certificado de producción configurado: ```bash arcli parametros puntos-venta --produccion ``` La lista trae solo los puntos de venta de web service (CAE o CAEA); los bloqueados o dados de baja salen marcados. Si el tuyo no aparece, o la lista está vacía, seguí con el paso 2. `arcli estado --produccion` también avisa si el punto de venta configurado no está entre los habilitados. ### 2. Crearlo en ARCA 1. Entrá al portal de ARCA con tu Clave Fiscal y abrí el servicio **"Administración de puntos de venta y domicilios"**. Si no lo ves, adherilo desde el Administrador de Relaciones, como hiciste con el de certificados. 2. Elegí tu CUIT y entrá a **"A/B/M de puntos de venta"**. 3. Presioná **"Agregar"** (o "Alta") y completá: - **Número:** uno que no uses en ningún otro sistema (por ejemplo `2` si el `1` es de Comprobantes en línea). - **Sistema:** el de web services que corresponde a tu condición. Según la tabla de ARCA, **"Factura Electrónica - Monotributo - Webservices"** si sos monotributista, o **"Factura Electrónica - RI IVA - Aplicativo y Webservices"** si sos responsable inscripto. En algunas pantallas aparece como "RECE para aplicativo y web services". No elijas una opción que diga "Comprobantes en Línea" ni "Factuweb". - **Domicilio:** el domicilio desde el que facturás. 4. Confirmá. Después, revisá que aparezca y guardalo en ARCLI: ```bash arcli parametros puntos-venta --produccion arcli config establecer puntoVenta 2 arcli estado --produccion ``` ## Renovar el certificado ### Cuándo usarlo Cuando `arcli config revisar` o el aviso de cada comando dicen que el certificado vence pronto, o para sacar el primero. ### Comando ```bash arcli certificado generar --produccion # en ARCA: subís el CSR que muestra y bajás el .crt arcli certificado importar produccion.crt ``` ### Resultado esperado - hasta importar seguís facturando con el certificado actual: `generar` no toca la clave activa - `importar` dice qué cargó (entorno, CUIT, alias y vencimiento) y deja el par anterior como `.anterior.*` ### Errores comunes - importar el `.crt` de otro CSR (`CERTIFICATE_KEY_MISMATCH`): usá el del último `generar` - olvidar autorizar los servicios web si cambiaste de alias ## Siguiente paso Revisá todo con el checklist de [cambiar de entorno](entornos.md#antes-de-la-primera-factura-real) antes de emitir la primera factura real. --- ## Fuentes Tutoriales originales de afipts.com en los que se basa esta guía: - [Habilitar administrador de certificados de producción](https://www.afipts.com/tutorial/enable-production-certificate-manager.html) - [Obtener certificado de producción](https://www.afipts.com/tutorial/obtain-production-certificate.html) - [Autorizar servicio web de producción](https://www.afipts.com/tutorial/authorize-web-production-service.html) Punto de venta para web service: - [Puntos de venta: para qué se utiliza cada sistema](https://www.afip.gob.ar/facturacion/documentos/puntos-de-venta.pdf) (ARCA) - [Acciones a realizar para consumir un web service de factura electrónica](https://www.afip.gob.ar/fe/documentos/AccionesarealizarparaconsumirunWebservicedeFacturaElectr.pdf) (ARCA) - [Manual del desarrollador de WSFEv1](https://www.afip.gob.ar/ws/documentacion/manuales/manual-desarrollador-ARCA-COMPG.pdf) (ARCA, error `10005` y `FEParamGetPtosVenta`) - [RG 5893/2026](https://www.boletinoficial.gob.ar/detalleAviso/primera/346598/20260831) (Boletín Oficial) --- # Cambiar de entorno Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/entornos.md ARCLI trabaja con dos entornos de ARCA. **Testing** es para probar sin validez fiscal; **producción** emite comprobantes reales. Cada uno tiene su propio certificado. | | Testing | Producción | | ------------------ | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | | **Para qué** | Probar todo lo que quieras | Facturar de verdad | | **Validez fiscal** | No | Sí: no se borra, se compensa con una nota de crédito | | **Certificado** | El de testing ([cómo sacarlo](certificado-testing.md)) | Otro, el de producción ([cómo sacarlo](certificado-produccion.md)) | | **Punto de venta** | Cualquier número | Uno dado de alta [para web service](certificado-produccion-completa.md#punto-de-venta-para-web-service) | | **Cómo se elige** | `--testing` (por defecto) | `--produccion` | ## Elegir el entorno en cada comando Sin flag, ARCLI usa el entorno de la config, que arranca en testing. Un flag lo cambia solo para ese comando: ```bash arcli fc -m 1000 --cs --consumidor-final --testing # sin validez fiscal arcli fc -m 1000 --cs --consumidor-final --produccion # real ``` Sin `--emitir`, los dos muestran la vista previa y, en una terminal, preguntan antes de emitir: en producción, `¿Emitimos la factura C en PRODUCCIÓN?`. En el [modo interactivo](modo-interactivo.md) el entorno se cambia en Configuración, la barra de estado muestra en cuál estás y en producción pide una segunda confirmación. ## Cambiar el entorno por defecto Si ya facturás de verdad todos los días, dejá producción como entorno de la config. Para volver, lo mismo con `testing`: ```bash arcli config establecer entorno produccion ``` > [!CAUTION] > Con `entorno produccion` y `emitir true` en la config, los comandos emiten en producción sin preguntar. Sirve para automatizar, pero pensalo dos veces si lo usás a mano. ## Antes de la primera factura real > [!WARNING] > Un comprobante emitido en producción no se borra: si te equivocás, se compensa con una nota de crédito. 1. **Certificado de producción.** Es otro, distinto del de testing: `arcli certificado generar --produccion` y después `importar` ([guía](certificado-produccion.md)). 2. **Autorizado a facturar.** En ARCA, el certificado de producción tiene que estar autorizado a `wsfe`. 3. **Punto de venta para web service.** Uno de Factura en línea no sirve. Revisalo con `arcli parametros puntos-venta --produccion`. 4. **La conexión responde.** `arcli estado --produccion` dice que ARCA responde y que el punto de venta está habilitado. 5. **Primera factura, con vista previa.** Emití una de monto chico y revisá el PDF antes de mandarla. --- # Cómo funciona Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/mental-model.md Con el asistente, con un comando o desde tu IA, el comprobante pasa por los mismos pasos. Nada llega a ARCA sin que lo veas antes. ## Del dato al CAE ### 1. Juntás los datos Lo que escribís, un JSON con `--cargar` o tu config. Lo que no pasás sale de la config o de un valor por defecto. ### 2. ARCLI los revisa Formatos, combinaciones y las reglas de ARCA que se pueden chequear antes. Si algo falta o no va, te dice qué y cómo arreglarlo, sin llamar a ARCA. ```text Error Falta el monto. Usá -m 15000. ``` ### 3. Te muestra la vista previa El comprobante tal como se va a pedir. Puede consultar a ARCA para completarlo (el padrón del receptor o la cotización), pero no emite. ```text Factura C · vista previa Importe total $ 15.000 Receptor Consumidor final ``` ### 4. Emite en ARCA Solo si confirmás o pasaste `--emitir`. La decisión es de ARCA: aprueba con un CAE, aprueba con observaciones o rechaza. Con `--previsualizar` no emite nunca; con `--json` o sin terminal, tampoco sin `--emitir`. ### 5. Recibís el resultado y el PDF El CAE en pantalla o en JSON, y el [PDF](pdf.md) con el QR si lo pediste. Si el PDF falla, el comprobante ya está emitido: no lo vuelvas a emitir. ## Si un dato está en dos lugares Gana el más cercano a lo que escribiste en ese momento. | Orden | De dónde sale | Ejemplo | | ----- | ----------------------------- | ----------------- | | 1 | Un flag en el comando | `--pv 4` | | 2 | Un JSON con `--cargar` | `"puntoVenta": 4` | | 3 | Tu config | `puntoVenta 3` | | 4 | El valor por defecto de ARCLI | Entorno `testing` | Con `--pv 4` y la config en 3, va el 4. Sin el flag, el 3. ## Tres formas, el mismo camino Las tres arman la misma entrada y pasan por las mismas validaciones. | Si querés | Escribís | Forma | | ------------------------------ | --------------------------- | --------------------------------------- | | Que me guíe paso a paso | `arcli` | [Asistente](formas-de-uso/asistente.md) | | En una línea o desde un script | `arcli fc -m 15000 --cs` | [Comandos](formas-de-uso/comandos.md) | | Con mi asistente preferido | "Facturale $ 15.000 a Juan" | [Con IA](formas-de-uso/con-ia.md) | ## Qué te devuelve | Salida | Para qué | ¿Puede cambiar? | | ---------------------------- | ---------------------------------------------------- | ---------------------------- | | En la terminal (por defecto) | Leer: paneles con la vista previa y el resultado | Sí, entre versiones | | `--json` | Scripts e IAs | No sin aviso: es el contrato | | `--bruto` | Revisar un problema: suma la respuesta cruda de ARCA | Depende de ARCA | El detalle de cada formato, en [entrada y salida](input-output.md#diferencias-entre-modos). > [!WARNING] > **ARCLI no reemplaza a ARCA.** Ordena el camino y revisa lo que puede antes, pero la última palabra es de ARCA: un comprobante bien armado igual puede salir observado o rechazado. Qué hacer en cada caso, en [problemas frecuentes](troubleshooting.md). ¿Un término que no conocés, como CAE o punto de venta? Están en el [glosario](glossary.md). --- # Asistente Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/formas-de-uso/asistente.md ARCLI sin nada más abre un asistente que te pregunta paso a paso. Es para quien factura de vez en cuando y no quiere acordarse de flags. ![El asistente emitiendo una Factura C en testing: comprobante, receptor, monto, vista previa y CAE](../assets/demo/interactivo.gif) ## Cómo se abre Con doble clic en el ícono de ARCLI del escritorio, o escribiendo en la terminal: ```bash arcli ``` ## Qué podés hacer | Opción del menú | Para qué | | ------------------------- | ------------------------------------------------------------------------ | | Emitir factura | A, B, C, FCE o E: [¿qué comprobante me toca?](../comprobantes/README.md) | | Emitir recibo | [Recibo C](../comprobantes/recibo-c.md) | | Notas de crédito y débito | Elegís la factura de una lista | | Repetir un comprobante | Mismo receptor y monto, con fecha de hoy | | Consultar comprobantes | Los últimos emitidos y su detalle | | Configuración | Guiada, certificados, PDF y acceso directo | ## Cómo te movés | Tecla | Qué hace | | -------- | ---------------------------------------------------------------- | | ↑ ↓ | Elegir una opción | | Enter | Confirmar | | Espacio | Marcar los opcionales | | Esc | Volver al paso anterior; si tu terminal no lo manda, escribí `<` | | Ctrl + C | Cancelar y volver al menú; en el menú, salir | ## Antes de emitir Siempre ves la vista previa y el **comando equivalente**: copialo y la próxima vez lo hacés en una línea. Nada se emite hasta que confirmás, y en producción pide una segunda confirmación.
Ver cómo es consultar comprobantes ![Consultar los últimos comprobantes y el detalle de uno desde el asistente](../assets/demo/consultar.gif)
Cada pantalla del asistente, paso por paso, en la [guía completa del modo interactivo](../modo-interactivo.md). --- # Comandos Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/formas-de-uso/comandos.md Lo mismo que el asistente, en una línea. Conviene si facturás seguido, si querés repetir siempre lo mismo o para automatizar. ![Una Factura C emitida con un comando: vista previa, confirmación y CAE](../assets/demo/comandos.gif) ## Cómo se arma `arcli fc -m 15000 --cs --cfinal`, por partes: | Parte | Qué es | | ---------- | -------------- | | `arcli fc` | El comprobante | | `-m 15000` | El monto | | `--cs` | Servicios | | `--cfinal` | A quién | Cada comprobante tiene su atajo (`fc`, `fa`, `ncc`…) y su página con todos los flags: empezá por [¿qué comprobante me toca?](../comprobantes/README.md). ## Vista previa y emisión | Con | Qué pasa | | ----------------- | -------------------------------------------- | | Nada | Muestra la vista previa y pregunta si emitir | | `--previsualizar` | Solo la vista previa, sin preguntar | | `--emitir` | Emite sin preguntar | ## Los más usados ```bash arcli fc -m 15000 --cs --cfinal arcli ultimos fc arcli consultar fc 142 arcli padron 20201797064 arcli estado ``` ## Ayuda en la terminal `arcli --ayuda` lista todos los comandos, y `arcli fc --ayuda` los flags de uno. Con el [autocompletado](../cli-reference.md#autocompletado), Tab completa atajos, flags y valores. Todo junto, en la [referencia del CLI](../cli-reference.md). Para scripts, [lotes y JSON](../lotes-y-json.md). --- # Con IA Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/formas-de-uso/con-ia.md Le pedís la factura a tu asistente de IA en tus palabras. El asistente usa ARCLI, que corre en tu computadora, te muestra la vista previa y emite cuando le confirmás. > **Vos:** Facturale $ 150.000 a Juan Pérez, consumidor final, por el desarrollo de octubre. En testing. > > **Tu asistente:** Es una Factura C de $ 150.000 a consumidor final, por servicios. ¿La emito? > > **Vos:** Sí. > > **Tu asistente:** Listo: **Factura C 00003-00000118**, aprobada. CAE 86451064378488. ## Qué necesitás Un asistente que pueda usar la terminal de tu computadora, como Claude Code, Codex, Gemini CLI o Copilot en VS Code, y ARCLI [instalado y configurado](../instalar.md). ## Cómo pedirlo La primera vez, decile que lea la guía para asistentes: ```text title="Pedido" frame="terminal" wrap Usá arcli para emitir una Factura C de $ 15.000 por servicios a consumidor final, en testing. Leé primero https://arcli.com.ar/llms.txt, mostrame la vista previa y esperá que te confirme antes de emitir. ``` ## Qué hace el asistente - Primero arma la vista previa; emite solo cuando confirmás ese comprobante. - Siempre dice el entorno: testing o producción. - En producción no emite sin tu confirmación: una factura emitida no se borra. Códigos de salida y lo que leen los asistentes, en la [guía completa](../automatizar-con-ia.md). --- # Modo interactivo Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/modo-interactivo.md `arcli` sin argumentos abre un asistente que pregunta paso a paso qué querés emitir. Está pensado para quien factura de vez en cuando y no quiere recordar flags. Arma, valida y emite con el mismo código que los comandos con flags y muestra la misma vista previa. La diferencia es cuándo avisa: cada respuesta se valida en su paso, antes de seguir (por ejemplo, el monto de una nota de crédito que supera a su factura), en lugar de todo junto al final. Antes de emitir muestra el **comando equivalente**, así podés copiarlo y la próxima vez hacerlo directo. ```bash arcli # en una terminal interactiva abre el asistente arcli interactivo # lo mismo, explícito ``` ## Cuándo se abre y cuándo no | Situación | Qué pasa | | ------------------------------------------------------ | ------------------------------------------------------- | | `arcli` en una terminal (stdin y stdout son TTY) | Se abre el asistente | | `arcli interactivo` | Se abre el asistente; sin terminal interactiva da error | | `arcli` sin terminal (pipe, CI, agente) o con `--json` | Muestra la ayuda | | Cualquier comando con flags (`arcli fc -m 1000 …`) | Sin cambios: el asistente nunca se mete en esos flujos | El modo interactivo no agrega comandos de emisión ni cambia flags, claves de config ni el JSON. Es una capa encima del CLI. ## Menú principal 1. **Emitir factura** 2. **Emitir recibo** 3. **Repetir un comprobante anterior** 4. **Emitir nota de crédito** 5. **Emitir nota de débito** 6. **Consultas** 7. **Estado de ARCA** 8. **Configuración** 9. **Salir** Si hay una versión nueva de ARCLI, el menú suma arriba de todo **Actualizar a la versión X.Y.Z** (ver [Actualizar](#actualizar)). **Opciones nuevas.** Lo que se sumó en las últimas versiones lleva `(nuevo)` al final, en color: Emitir recibo, Consultas y sus consultas nuevas, Certificados de ARCA, Acceso directo en el escritorio y Dónde está la config en Configuración, Recibo C y Factura de exportación E al elegir sobre qué comprobante va una nota. Configuración también lo lleva mientras tenga alguna opción nueva adentro. La marca se va sola dos versiones menores después de la que trajo la opción. Debajo del logo va la versión de ARCLI. Arriba del menú, la barra de estado muestra a la izquierda quién emite (la razón social de `emisor.razonSocial` o, si no está, el CUIT) y el punto de venta, y a la derecha cómo está ARCA y el entorno (`TESTING` en naranja o `PRODUCCIÓN` en celeste): | Estado | Cuándo | | ---------------------- | -------------------------------------------------------------------------------- | | **ARCA funcionando** | Los servidores de facturación (app, base de datos y autenticación) responden OK | | **ARCA con demoras** | Responden OK, pero tardaron más de 3 segundos | | **ARCA con problemas** | Alguno de los servidores no responde OK | | **ARCA sin respuesta** | Error de red, o ARCA no contestó en 5 segundos | | **ARCA sin verificar** | Falta completar la configuración o el certificado venció, así que no se consulta | La consulta es la misma de `arcli estado` sin el punto de venta (no pide autenticación) y se hace al abrir el asistente. **Si falta algo obligatorio** (CUIT, certificado y clave del entorno activo o punto de venta), al abrir el asistente propone hacer la [configuración guiada](#configuración). El entorno activo es el de la config, o el de `arcli interactivo --produccion` o `--testing`. **Certificado por vencer.** Si a alguno de los certificados configurados (de testing o de producción, sin importar el entorno activo) le quedan menos de 30 días, debajo de la barra va un recuadro amarillo, con una línea por certificado, la fecha, los días que faltan y el link a la [guía para renovarlo](obtencion-certificados.md). Queda arriba de todo lo que hagas en la sesión. Si alguno ya venció, el recuadro es rojo. Si es el del entorno activo, además la barra dice `certificado vencido` y `ARCA SIN VERIFICAR`, y emitir o consultar muestra el error `Certificado vencido` sin llegar a ARCA. La configuración sigue disponible para cargar el certificado nuevo. ## Actualizar Al abrir el asistente se consulta npm por una versión nueva (no aparece con `CI` ni `NO_UPDATE_NOTIFIER`). Si hay, **Actualizar a la versión X.Y.Z** es la primera opción del menú, en naranja. Adentro muestra tu versión, la nueva y las novedades de cada versión intermedia (de las 3 más nuevas, sacadas del [CHANGELOG](../CHANGELOG.md)), y el comando para actualizar. - **Cerrar para actualizar**: copia el comando para actualizar al portapapeles, dice dónde pegarlo (una terminal nueva: Terminal en Mac, PowerShell en Windows) y espera a que confirmes antes de cerrar el asistente, así se lee aunque lo hayas abierto con el acceso directo. El comando es el del gestor con que instalaste ARCLI: `npm install -g arcli@latest`, `pnpm add -g arcli@latest`, `yarn global add arcli@latest` o `bun add -g arcli@latest` (lo deduce de la carpeta donde está instalado; si no lo reconoce, npm). ARCLI no se actualiza solo porque no puede reemplazarse mientras corre. Si no puede copiar (en Linux usa `wl-copy`, `xclip` o `xsel`), muestra el comando para escribirlo. - **← Volver**: vuelve al menú. Con el asistente, el aviso de nueva versión no se repite al salir. En los comandos con flags aparece al final. ## Emitir factura **Punto de venta.** Factura, recibo, factura E, notas, repetir y consultar usan el punto de venta de la config sin preguntar. Si la config no tiene uno, lo piden antes del primer paso (Esc vuelve al menú) y el comando equivalente lo lleva con `--pv`. Para no escribirlo cada vez, cargalo en Configuración → Modificar configuración → Punto de venta. Primero pregunta solo lo **requerido**: | Paso | Pregunta | Detalle | | ---- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Comprobante | Factura A, B o C, comunes o de crédito electrónica (FCE), o la de exportación E ([abajo](#factura-de-exportación-e)) | | 2 | Receptor | Consumidor final, CUIT, DNI o CUIL, y el número. En la A solo CUIT, porque la A no admite consumidor final | | 3 | IVA del receptor | Solo las condiciones válidas para la letra elegida. Con consumidor final no se pregunta | | 4 | Concepto | Servicios, productos o ambos. Arranca en `config.concepto` si está configurado | | 5 | Monto total | Acepta `150000`, `150.000`, `1500,50` o `1.500,50` (punto para miles, coma para decimales) | | 6 | CBU | Solo en facturas FCE y si no hay `config.cbu`. Si tampoco hay `aliasCbu`, pide el alias (Enter lo omite). Después de la confirmación ofrece guardarlos en la config | Después, **una sola pregunta con todos los opcionales** (ver abajo). Enter sin marcar nada sigue con los valores por defecto. Después muestra la vista previa (la misma de `--previsualizar`), el comando equivalente y pregunta si emitir, con los mismos botones que los comandos con flags: **Sí, emitir ahora**, **Sí, emitir y generar el PDF** (ver [PDF](#pdf)) o **No, dejar sin emitir**. En **producción** pide una segunda confirmación (**Sí, emitir en producción** o **No, dejar sin emitir**); el CLI con flags pregunta una sola vez. ### Factura de exportación (E) La `E` se elige en el mismo selector, pero tiene su propio asistente porque no lleva receptor argentino, concepto ni IVA. Valida y emite igual que `arcli fe`: | Paso | Pregunta | Detalle | | ---- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Cliente | Nombre o razón social del cliente del exterior | | 2 | Domicilio | Domicilio del cliente | | 3 | País de destino | Nombre o código de la tabla de WSFEX (`ESTADOS UNIDOS` o `212`). Argentina no se acepta | | 4 | CUIT del país | Solo si ARCA no publica un CUIT para el destino: escribís el CUIT o buscás el país por nombre y lo elegís de la lista (`--cuit-pais`) | | 5 | ID impositivo | Opcional (Enter para omitirlo) | | 6 | Qué exportás | Servicios (por defecto), bienes u otros | | 7 | Monto total | Igual que en la factura común | | 8 | Descripción | Opcional; por defecto "Según detalle" | | 9 | Moneda | Dólares (`DOL`, con la cotización de aduana que publica ARCA) o pesos (`PES`) | | 10 | ¿Te pagan en dólares? | Solo en dólares: si sí, ARCA lo registra como cancelación en la misma moneda (`--misma-moneda`) | | 11 | Incoterm | Solo en bienes, de la tabla de WSFEX, o sin incoterm | | 12 | Permisos de embarque | Solo en bienes, opcional: los ya existentes en ARCA, separados por coma (`--permiso` con `--permiso-existente`) | | 13 | Forma de pago | Por defecto "Transferencia Internacional" | | 14 | Fecha de pago | Opcional; por defecto la del comprobante | | 15 | Actividad | Solo si no está `exportacion.actividad`; se valida contra la tabla de WSFEX y después ofrece guardarla en la config | | 16 | Opcionales | Una sola pregunta, como en A, B y C ([abajo](#opcionales-de-la-e)) | Después muestra la vista previa, el comando `arcli fe` equivalente y pregunta si emitir (dos veces en producción). El PDF sigue la misma regla que el resto. Volver desde el primer paso vuelve al selector de comprobantes. #### Opcionales de la E La factura y las notas E terminan con **"¿Agregamos algún opcional?"**, que funciona igual que [los de A, B y C](#opcionales): se marca con espacio, Enter sigue y después pregunta solo lo marcado. Se valida igual que con los flags. | Opción | Qué pregunta | Cuándo aparece | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | Ítems | Uno por uno: descripción, cantidad, precio unitario y unidad (de la tabla de WSFEX). Enter en la descripción termina; si la suma no da el monto total, avisa y sigue pidiendo (`--item`) | Siempre. Sin ítems va un renglón con el monto total | | Idioma | Español, inglés o portugués, de la tabla de WSFEX (`--idioma`) | Siempre. Por defecto español; en las notas, el del asociado | | CUIT del país | El CUIT o el país por nombre, de la tabla de ARCA; tiene que ser el del destino (`--cuit-pais`) | Factura | | Observaciones | Las observaciones y las observaciones comerciales (`--observaciones` y `--obs-comerciales`) | Siempre | | Descripción del incoterm | El texto, con la descripción de la tabla de ARCA como valor por defecto (`--incoterms-desc`) | Si hay incoterm | | Cotización | La cotización a mano, en lugar de la de aduana que publica ARCA o la del asociado (`--cm`) | En moneda extranjera. En las notas, salvo en servicios | ### PDF El PDF se elige en la pregunta **"¿Emitimos…?"**, que siempre tiene tres opciones: **Sí, emitir ahora**, **Sí, emitir y generar el PDF** y **No, dejar sin emitir**. Lo elegido decide, diga lo que diga `config.pdf`: después de emitir no se pregunta nada más del PDF. La config solo elige dónde arranca el cursor: con `siempre`, en **Sí, emitir y generar el PDF**; con `preguntar` (el valor por defecto) o `nunca`, en **Sí, emitir ahora**. Lo mismo vale para las notas de crédito y débito, el recibo y la `E`. En producción, la segunda confirmación es la misma y el PDF se respeta. Es la misma pregunta que hacen los comandos con flags: ver [PDF de comprobantes](pdf.md#cuándo-se-genera). Si elegís el PDF, pregunta cuatro datos opcionales que solo van en el PDF: la descripción, el nombre y el domicilio del receptor, y la condición de venta. Para esta última muestra una lista (Omitir, Contado, Tarjeta de Débito, Tarjeta de Crédito, Cuenta Corriente, Cheque, Transferencia Bancaria, Otros medios de pago electrónico, Otra) con la de la config (`condicionVenta`) marcada, así que Enter la mantiene. "Omitir" también evita que reaparezca el valor configurado; "Otra" pide el texto: Enter deja "Otra", o el texto libre que tenía la config. Si faltan datos del emisor (razón social, domicilio, inicio de actividades), los pregunta una vez y ofrece guardarlos en la config. Si falta el plugin, ofrece instalarlo. Ver [PDF de comprobantes](pdf.md). El comando equivalente se muestra antes de emitir, así que no incluye la descripción ni la condición de venta del PDF. Siempre lleva el entorno (`--testing` o `--produccion`): si después cambiás el entorno en la config, el comando pegado sigue emitiendo donde lo armaste. Con un CUIT, lleva el nombre y el domicilio que trajo el padrón (`--receptor-nombre` y `--receptor-domicilio`): como también lleva `--ir`, el CLI no vuelve a consultar el padrón y sin esos flags el PDF saldría sin ellos. ### Opcionales Antes de la vista previa aparece **"¿Agregamos algún opcional?"**: una lista donde marcás con **espacio** lo que querés cambiar y confirmás con **Enter**. Cada opción muestra el valor que se va a usar si no la marcás. Después pregunta solo lo que marcaste, en orden. | Opción | Qué pregunta | Cuándo aparece | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | Fecha del comprobante | La fecha (`--fecha`), por ejemplo para facturar con fecha de fin de mes. Por defecto hoy. Acepta lo mismo que el CLI: hasta 10 días antes o después de hoy en servicios, 5 en productos, y en FCE 5 antes y 1 después; las fechas futuras de productos y FCE, dentro del mes | Siempre | | Alícuota de IVA | La alícuota. Por defecto `config.alicuota` o 21% | A y B | | Moneda extranjera | Pesos, dólares, euros u otra de la tabla de ARCA (`arcli parametros monedas`). En otra moneda, si te pagan en pesos (ingresás la cotización) o en esa moneda (se usa la cotización oficial de ARCA, `--misma-moneda`). Arranca en `config.moneda`, como el CLI sin `--moneda`: sin marcarla, una moneda extranjera de la config va con la cotización oficial de ARCA (o `config.cotizacion`, deprecada) | Siempre | | Importe exento o no gravado | La parte exenta y la no gravada del monto total | A y B | | Período del servicio | Desde y hasta | Si el concepto no es solo productos | | Vencimiento del pago | La fecha | En servicios y en facturas FCE | | Modalidad de transferencia | SCA (por defecto) o ADC | Facturas FCE | "Volver" en una de esas preguntas vuelve a la lista, con lo marcado y lo ya respondido. "← Volver" en la lista vuelve al monto. Lo que no se elige usa los valores por defecto, igual que el CLI sin esos flags. ## Emitir recibo Emite un Recibo C (`rc`), el comprobante de un cobro. Sigue los mismos pasos que una Factura C, sin elegir el comprobante: receptor, IVA del receptor, concepto ("¿Qué estás cobrando?"), monto y opcionales, y después la vista previa con el comando `arcli rc` equivalente. El PDF sale con el título `RECIBO C`. ## Nota de crédito o débito Se elige desde el menú: **Emitir nota de crédito** (descuento, devolución o anulación) o **Emitir nota de débito** (cargo adicional). Las dos siguen los mismos pasos. | Paso | Pregunta | Detalle | | ---- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 1 | Comprobante original | Factura A, B o C, comunes o FCE, Recibo C o la de exportación E ([abajo](#nota-de-crédito-o-débito-e)) | | 2 | A qué la asociamos | En notas comunes, a un comprobante (una factura o un recibo) o a un período. Las notas FCE siempre van sobre una factura, porque ARCA no acepta período en ellas | | 3 | Factura | Sobre un comprobante: lista las últimas 15 facturas de ese tipo emitidas en el punto de venta configurado (la cantidad se cambia con `config.filasPorLista`), consultadas a ARCA, con número, fecha, receptor, total y CAE. Abajo de la lista: **Cargar más…** trae las anteriores, e **Ingresar el número a mano…** pide punto de venta y número (sirve para una factura vieja o de otro punto de venta) | | 3 | Período | Sobre un período: desde y hasta (`--periodo-desde` y `--periodo-hasta`) | | 4 | Receptor | Solo sobre un período: consumidor final, CUIT, DNI o CUIL, y el número, como en "Emitir factura" | | 5 | Concepto | Solo sobre un período. Arranca en `config.concepto` si está configurado | | 6 | Monto | En crédito sobre un comprobante: anular el total o ingresar un monto parcial, que no puede superar el total (si la factura tiene varias alícuotas o tributos, solo parcial). En débito o sobre un período: el monto | | 7 | IVA del receptor | Si no es consumidor final, filtrada por la letra. Sobre un comprobante se pregunta porque ARCA no devuelve la condición IVA. Con un CUIT propone la del padrón | | 8 | Alícuota de IVA | Solo en A y B. Sobre un comprobante, solo si no se puede deducir de sus importes; sobre un período, siempre. Arranca en la deducida o, si no hay, en `config.alicuota` o 21% | | 9 | Anulación | Solo en NC/ND FCE: si la factura fue rechazada por el comprador | | 10 | Opcionales | La misma selección múltiple de "Emitir factura", con lo que aplica a una nota: fecha del comprobante, período del servicio y vencimiento del pago (estos dos como en la factura; las notas FCE no llevan vencimiento), importe exento o no gravado (A y B, salvo que anule el total, porque ahí se copian de la factura) y moneda (solo en las notas por período: las de una factura van en su moneda). La alícuota no está: tiene su paso | La nota hereda de la factura el concepto, el receptor (tipo y número de documento), la moneda y la alícuota de IVA cuando se puede deducir de los importes. El comprobante asociado se completa solo: tipo, punto de venta (el de la factura, aunque sea otro que el configurado), número, CUIT del emisor y fecha. Lo que no sale de la factura arranca en los defaults de la config, como en el CLI: el IVA del receptor en `config.ivaReceptor` (salvo que el padrón diga otro), la alícuota (si no se deduce de la factura) en `config.alicuota` o 21%, y en las de período, el concepto en `config.concepto` y la moneda en `config.moneda`. ### Nota de crédito o débito E Al elegir **Factura de exportación E** como comprobante original, la nota sigue estos pasos: | Paso | Pregunta | Detalle | | ---- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Sobre qué va la nota | La factura E (por defecto, Enter) u otra nota de débito o crédito E (`--ac nde` o `--ac nce`) | | 2 | Punto de venta del asociado | Por defecto, el configurado | | 3 | Número del asociado | Lo busca en ARCA y muestra a quién y por cuánto fue. Si no existe, o si la nota no puede ajustarlo (en servicios, una nota de débito solo ajusta una factura), avisa y vuelve a preguntar | | 4 | Monto | En la moneda del asociado. En crédito no puede superar su total, salvo que ajuste otra nota de crédito | | 5 | Detalle | Opcional; por defecto "Según detalle" | | 6 | Permisos de embarque | Solo si el asociado es de bienes, opcional: van con `--permiso`, sin `--permiso-existente` | | 7 | Opcionales | Ítems, idioma, observaciones, descripción del incoterm y cotización ([arriba](#opcionales-de-la-e)) | Cliente, destino, moneda, cotización, idioma, incoterm y actividad salen del asociado, y el número de la nota, del último que tiene ARCA. Después muestra la vista previa y el comando equivalente (`arcli nce …` o `arcli nde …`), y pregunta antes de emitir, como la factura E. ## Repetir un comprobante anterior Para quien factura o cobra lo mismo seguido. Elegís si es una factura, un Recibo C o una factura de exportación `E` ([abajo](#repetir-una-factura-e)) y uno de los últimos 15 emitidos, y se copian el receptor, el concepto, el monto y la alícuota (cuando se puede deducir de los importes). **Las fechas no se copian:** el comprobante sale con fecha de hoy, salvo que elijas otra en los opcionales. | Paso | Pregunta | Detalle | | ---- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Tipo de comprobante | Factura A, B o C, comunes o FCE, Recibo C o factura de exportación E | | 2 | Comprobante | Uno de los últimos emitidos en el punto de venta configurado. Como en las notas, se pueden cargar más o ingresar el número a mano | | 3 | IVA del receptor | Solo si no era consumidor final: ARCA no devuelve la condición IVA de la factura | | 4 | Monto | El mismo o uno nuevo, en la moneda del original. Si tiene varias alícuotas o tributos, pide el monto directamente | | 5 | ¿Cómo te pagan? | Solo si el original era en moneda extranjera (dólares, euros u otra): el nuevo sale en esa moneda y la cotización se vuelve a cargar. En pesos ingresás la cotización acordada; en la moneda del comprobante se usa la oficial de ARCA (`--misma-moneda`) | | 6 | Período del servicio | Este mes, el mes pasado, solo hoy u otro. No se pregunta si el concepto es solo productos | | 7 | CBU | Solo en FCE sin `config.cbu`, con el alias si no hay `aliasCbu`; después de la confirmación ofrece guardarlos en la config, como en "Emitir factura" | | 8 | Opcionales | La misma selección múltiple de "Emitir factura". Si el original era en moneda extranjera, no ofrece cambiar la moneda: el monto está en esa moneda. En A y B, si no se pudo deducir la alícuota, esa opción arranca marcada | Después sigue igual que una factura nueva: vista previa, comando equivalente y confirmación. ### Repetir una factura E Elegís una de las últimas facturas `E` (con **Cargar más…** e **Ingresar el número a mano…**, como en [Mis comprobantes](#mis-comprobantes)) y se copian de lo que ARCA devuelve de ella (`FEXGetCMP`): el cliente, su domicilio e ID impositivo, el destino y su CUIT, el tipo de exportación, la moneda y si se cobró en esa moneda, el incoterm y su descripción, los ítems, la forma de pago, el idioma y la actividad. **No se copian** las fechas (sale con la de hoy), la cotización (la de aduana del día, salvo que cargues otra en los opcionales), los permisos de embarque ni las observaciones. | Paso | Pregunta | Detalle | | ---- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 1 | Comprobante | Una de las últimas facturas `E` del punto de venta | | 2 | Monto | El mismo o uno nuevo, en la moneda del original. Con otro monto los ítems copiados no suman, así que sale un renglón con el total: los podés cargar de nuevo | | 3 | ¿Te pagan en…? | Solo si ARCA no devolvió si se cobró en la misma moneda | | 4 | CUIT del país | Solo si la factura no lo trae y ARCA no publica uno para el destino | | 5 | Permisos de embarque | Solo en bienes, opcional: son de cada embarque | | 6 | Fecha de pago | Opcional; por defecto la del comprobante | | 7 | Actividad | Solo si la factura no la trae y no está `exportacion.actividad` | | 8 | Opcionales | Los [de la E](#opcionales-de-la-e), con lo copiado ya cargado | Un solo renglón por el total se repite como descripción (`--descripcion`) y varios, como `--item`. Si algún ítem tiene bonificación, que el asistente no informa, o los ítems no suman el total, avisa y sale un renglón con el monto total. Después muestra la vista previa, el comando `arcli fe` equivalente y pregunta si emitir, como una factura `E` nueva. ## Consultas Lo que el CLI consulta con `ultimos`, `consultar`, `padron`, `fce-obligado` y `parametros`, sin escribir comandos. Un error de ARCA (por ejemplo, sin conexión) se muestra y vuelve a este menú. | Opción | Qué hace | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Mis comprobantes | Los últimos emitidos de cada tipo, o uno por número ([abajo](#mis-comprobantes)) | | Datos de un CUIT | Pide el CUIT y muestra lo mismo que `arcli padron`. Después ofrece **Emitir una factura a este CUIT** | | Si un cliente recibe FCE | Pide el CUIT y muestra lo mismo que `arcli fce-obligado`, con la fecha de hoy (para otra fecha, `arcli fce-obligado --fecha`) | | Cotización de una moneda | Elegís la moneda de la tabla de ARCA (el dólar primero) y muestra la cotización oficial, como `arcli parametros cotizacion`. Después vuelve a la lista | | Tablas de ARCA | Las nueve de `arcli parametros`: puntos de venta, comprobantes, documentos, alícuotas, IVA del receptor, monedas, conceptos, opcionales y tributos ([abajo](#tablas-de-arca)) | **Emitir una factura a este CUIT** arranca "Emitir factura" con el CUIT, el nombre, el domicilio y la condición frente al IVA del padrón ya cargados: no pregunta a quién le facturás y pasa directo al comprobante, el concepto y el monto. La condición IVA se pregunta solo si el padrón no la informa o no sirve para la letra elegida (por ejemplo, un responsable inscripto en una factura B). Volver desde el primer paso vuelve a la pregunta; al terminar, vuelve al menú principal. ### Tablas de ARCA La lista muestra el nombre de cada tabla, y la línea de abajo, para qué sirve su código en ARCLI. Cada tabla se muestra con una fila de encabezado (`CÓDIGO` o `NÚMERO`, la descripción y, si la tabla tiene, una tercera columna, como las letras que admite cada condición IVA) y esa misma ayuda. - **Si entra en una página**, va en un recuadro, igual que `arcli parametros `. - **Si no entra**, va en una lista que se filtra escribiendo y se desplaza con las flechas. Enter o Esc vuelven a la lista de tablas. Las filas por página son las de `filasPorLista` (15 por defecto). La lista de monedas de **Cotización de una moneda** es la misma: se filtra por nombre, código de ARCA o ISO (`eur`, `060` o `usd`) y se elige con Enter. ### Mis comprobantes ![Mis comprobantes: lista, cargar más y detalle de una Factura C](assets/demo/consultar.gif) Elegís el tipo (cualquiera de los 19 de A, B y C, o la factura de exportación `E` y sus notas de crédito y débito) y aparece la lista de los últimos 15 emitidos en el punto de venta configurado, con el mismo formato que `arcli ultimos`: número, fecha, receptor, total y CAE. En la `E` va el nombre del cliente en lugar del receptor. Igual que al elegir la factura de una nota, abajo están **Cargar más…** e **Ingresar el número a mano…** (punto de venta y número). Al elegir uno se muestra lo mismo que `arcli consultar`: CAE, vencimiento, importes y receptor. En la `E`, cliente, destino, tipo de exportación, moneda, total y, en las notas, la factura que ajustan. Después vuelve a la lista, con lo que ya estaba cargado, para ver otro. **Esc** o **"← Volver"** vuelve a Consultas. ## Configuración | Opción | Qué hace | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ver configuración | Todos los datos guardados, igual que `arcli config` | | Revisar configuración | Lo mismo que `arcli config revisar`: defaults, credenciales y validación contra ARCA | | Configuración guiada | Pregunta CUIT, certificado y clave del entorno activo (`config.entorno`, o el de `arcli interactivo --produccion` o `--testing`), punto de venta, concepto e IVA del receptor por defecto, y si querés, los datos del emisor para el PDF. Propone lo que ya está guardado. Si no tenés certificado de ese entorno, ofrece sacarlo ahí mismo (como "Certificados de ARCA") y no pide la clave | | Modificar configuración | Lista los datos con las mismas secciones y el mismo orden que `arcli config` (cuenta, certificados, al facturar, FCE, factura de exportación, datos del emisor, PDF y salida), con el valor actual abajo del marcado. No incluye `emitir`, `json` ni `bruto`, que solo cambian el CLI con flags. Elegís uno y lo cambiás; en los de texto, `-` lo borra. Después vuelve a la lista, hasta "← Volver" | | Certificados de ARCA | Una caja por entorno, con el título en su color: alias, vencimiento (con los días que faltan), certificado, clave y si hay un pedido sin importar. "Sacar o renovar un certificado" pide entorno y alias, muestra el CSR y los pasos en ARCA como `arcli certificado generar`; si ya hay un pedido pendiente, ofrece verlo de nuevo o descartarlo. "Cargar el certificado (.crt)" pide la ruta (podés arrastrar el archivo a la terminal), lo valida y lo configura como `arcli certificado importar`; si ya había otro, pregunta antes de reemplazarlo | | Plugin de PDF | Estado del plugin; instalarlo, actualizarlo o desinstalarlo | | Autocompletado | Si está instalado el autocompletado con Tab; instalarlo o desinstalarlo (como `arcli completado`) | | Acceso directo en el escritorio | Crea o actualiza el ícono para abrir ARCLI con doble clic (como `arcli acceso-directo`) | | Dónde está la config | El archivo de configuración y su carpeta (con los certificados, los tickets y el plugin de PDF), como `arcli config ruta` | Cada respuesta se valida igual que en `arcli config establecer` y se guarda en el momento: si cortás a mitad, lo ya respondido queda guardado. En las rutas del certificado y de la clave podés arrastrar el archivo a la terminal. Si en la guiada dejás el certificado para después, al terminar te dice que falta cargarlo y dónde. Al volver al menú, la barra se actualiza con lo que cambiaste. ## Pasar a producción 1. Configuración → Certificados de ARCA → Sacar o renovar un certificado → Producción, y seguí los pasos en ARCA. 2. En ARCA, autorizá el certificado a facturar (`wsfe`) desde el Administrador de Relaciones de Clave Fiscal. 3. Creá un punto de venta para web service (no sirve el de Factura en línea) y cargalo en Modificar configuración → Punto de venta. 4. Modificar configuración → Entorno → produccion. Desde ahí, lo que emitís tiene validez fiscal, y antes de emitir el asistente pide una segunda confirmación. Guía completa: [Cómo obtener los certificados](obtencion-certificados.md). ## Estado de ARCA Muestra lo mismo que `arcli estado` (servidores, tiempo de respuesta y punto de venta) y la cotización oficial del dólar. ## Volver, cancelar y salir - **Volver al paso anterior:** **Esc**, en las listas y en las preguntas de texto. En las listas también está la opción **"← Volver"**, y en las de texto escribir **`<`** hace lo mismo, por si la terminal no manda Esc. Si volvés desde la primera pregunta, volvés al menú. Al volver se descarta lo que respondiste después, así un cambio de camino (por ejemplo, de CUIT a consumidor final) no deja datos viejos. - `Ctrl+C` durante una pregunta cancela el flujo actual y vuelve al menú. Nada se emite hasta confirmar en el último paso. - **Esc** o `Ctrl+C` en el menú principal, o elegir **Salir**, cierra el asistente. ## Qué no hace (todavía) - Varias alícuotas en un mismo comprobante: se resuelven con el comando equivalente y `--alicuota TASA:MONTO`. Por lo mismo, una nota sobre una factura con varias alícuotas solo puede ser parcial, y al repetirla hay que elegir la alícuota. - Facturas por lote: siguen siendo `--cargar` con un JSON. - Monedas que ARCA publica solo con un código numérico (`002`, dólar libre, y `049`, oro): van con `--moneda` en el CLI. - Una factura `E` en otra moneda que dólares o pesos: el asistente ofrece solo esas dos, y el resto va con `arcli fe --moneda`, por ejemplo `--moneda EUR`. ## Ver también - [Arquitectura](architecture.md#decisiones-de-diseño): por qué es un asistente y no una pantalla completa. - [Referencia del CLI](cli-reference.md): los comandos equivalentes. --- # Automatizar con IA Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/automatizar-con-ia.md ARCLI está pensado para que un asistente con acceso a la terminal (Claude, ChatGPT, Copilot) pueda emitir por vos, con reglas claras y una salida `--json` que no cambia de forma. ## Qué leerle al asistente - **[`llms.txt`](../llms.txt):** referencia condensada de comandos, flags y reglas, en un solo archivo. Es el punto de partida. - **`llms-full.txt`:** toda la documentación junta, para el asistente que quiera leer todo. Está en el [sitio de documentación](https://arcli.com.ar/llms-full.txt). ## Las reglas que siguen los agentes - Siempre `--json` y el entorno explícito: `--testing` o `--produccion`. - Primero la vista previa; `--emitir` solo cuando la persona confirmó ese comprobante. - En producción, emitir es irreversible: nunca sin confirmación explícita. - Se emitió si y solo si `previsualizacion` es `false` y `cae` no es `null`. ## Códigos de salida | Código | Qué significa | | ------ | ---------------------------------------------------------------------------------------- | | `0` | Todo bien: aprobado, observado o vista previa | | `1` | Error del comando: mirar `codigo` en el JSON ([tabla](input-output.md#códigos-de-error)) | | `2` | ARCA rechazó el comprobante | ## Un pedido de ejemplo ```text Usá arcli para emitir una Factura C de $ 15.000 por servicios a consumidor final, en testing. Leé primero https://arcli.com.ar/llms.txt, mostrame la vista previa y esperá que te confirme antes de emitir. ``` Para lotes y scripts sin asistente, ver [lotes, JSON y automatización](lotes-y-json.md). --- # ¿Qué comprobante me toca? Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/README.md Depende de tu condición frente al IVA y de a quién le facturás. Cada comprobante tiene su página con un ejemplo y todos sus flags. | Sos | Le facturás a | Comprobante | | --- | --- | --- | | Monotributo | Cualquiera | [Factura C](factura-c.md) \| [Recibo C](recibo-c.md) | | Monotributo | Una empresa obligada a FCE | [FCE C](fce-c.md) | | Responsable inscripto | Otro responsable inscripto | [Factura A](factura-a.md) | | Responsable inscripto | Consumidor final, monotributo o exento | [Factura B](factura-b.md) | | Responsable inscripto | Una empresa obligada a FCE | [FCE A](fce-a.md) \| [FCE B](fce-b.md) | | Cualquiera | Un cliente del exterior | [Factura E](factura-e.md) | ## ¿Y para corregir una factura? Una **nota de crédito** resta (un descuento, una devolución, una factura mal hecha) y una **nota de débito** suma. Van con la misma letra que la factura: sobre una Factura C, una [nota de crédito C](nota-credito-c.md) o una [nota de débito C](nota-debito-c.md). Cómo funcionan, en [notas de crédito y débito](../notas-credito-debito.md). > [!TIP] > **¿No sabés tu condición?** Con tu CUIT: `arcli padron `. O en la constancia de inscripción de ARCA. ## Todos los comprobantes Un atajo por comprobante, cada uno con su página: la fila es el tipo y la columna, la letra. | Comprobante | A | B | C | E | | --- | --- | --- | --- | --- | | Factura | [`fa`](factura-a.md) | [`fb`](factura-b.md) | [`fc`](factura-c.md) | [`fe`](factura-e.md) | | Nota de crédito | [`nca`](nota-credito-a.md) | [`ncb`](nota-credito-b.md) | [`ncc`](nota-credito-c.md) | [`nce`](nota-credito-e.md) | | Nota de débito | [`nda`](nota-debito-a.md) | [`ndb`](nota-debito-b.md) | [`ndc`](nota-debito-c.md) | [`nde`](nota-debito-e.md) | | Recibo | – | – | [`rc`](recibo-c.md) | – | | FCE | [`fcea`](fce-a.md) | [`fceb`](fce-b.md) | [`fcec`](fce-c.md) | – | | Nota de crédito FCE | [`ncea`](nota-credito-fce-a.md) | [`nceb`](nota-credito-fce-b.md) | [`ncec`](nota-credito-fce-c.md) | – | | Nota de débito FCE | [`ndea`](nota-debito-fce-a.md) | [`ndeb`](nota-debito-fce-b.md) | [`ndec`](nota-debito-fce-c.md) | – | Para entender cada uno: [notas de crédito y débito](../notas-credito-debito.md), [Factura de Crédito Electrónica](../fce.md) y [exportación paso a paso](../exportacion.md). --- # Factura C Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/factura-c.md Monotributo a cualquier receptor: consumidor final, empresas u otro monotributista. No discrimina IVA. `arcli fc` | `arcli factura c` ## Ejemplo ```bash arcli fc -m 15000 --cs --cfinal ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Condición IVA del receptor Cómo está inscripto a quien le facturás. `--ir` es el corto de `--iva-receptor`. Con `--cuit` sale sola del padrón de ARCA; si no, va una de estas o la de la config (`ivaReceptor`). | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor consumidor-final` | `--ir-cf` | Consumidor final | | `--iva-receptor responsable-inscripto` | `--ir-ri` | Responsable inscripto | | `--iva-receptor responsable-monotributo` | `--ir-rm` | Monotributo | | `--iva-receptor sujeto-exento` | `--ir-se` | Exento | | `--iva-receptor sujeto-no-categorizado` | `--ir-snc` | Sujeto no categorizado | | `--iva-receptor monotributista-social` | `--ir-ms` | Monotributista social | | `--iva-receptor monotributo-trabajador-independiente-promovido` | `--ir-mtip` | Monotributo trabajador independiente promovido | | `--iva-receptor cliente-del-exterior` | `--ir-ce` | Cliente del exterior | | `--iva-receptor proveedor-del-exterior` | `--ir-pe` | Proveedor del exterior | | `--iva-receptor iva-liberado` | `--ir-il` | IVA liberado | | `--iva-receptor iva-no-alcanzado` | `--ir-ina` | IVA no alcanzado | Ej.: `--ir-cf` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Receptor A quién le facturás. Sin ninguno, consumidor final. Desde $ 10.000.000 hay que identificarlo. | Largo | Corto | Qué es | | --- | --- | --- | | `--consumidor-final` | `--cfinal` | Consumidor final, sin identificar | | `--cuit ` | | Con CUIT: la condición IVA sale del padrón | | `--cuil ` | | Con CUIL | | `--dni ` | | Con DNI | Ej.: `--cuit 20168598204` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - Si el receptor es una empresa obligada a recibir FCE por el monto, ARCLI te avisa (con `verificarFce` en la config). ## No aplica Estos flags no van en este comprobante: `--ac`, `--alicuota`, `--exento`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de crédito C Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-credito-c.md Resta sobre una Factura C o un Recibo C: un descuento, una devolución o una anulación. `arcli ncc` | `arcli nota-credito c` ## Ejemplo ```bash arcli ncc -m 5000 --cs --cfinal --ac fc --apv 3 --ar 142 --acuit 20333333334 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Condición IVA del receptor Cómo está inscripto a quien le facturás. `--ir` es el corto de `--iva-receptor`. Con `--cuit` sale sola del padrón de ARCA; si no, va una de estas o la de la config (`ivaReceptor`). | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor consumidor-final` | `--ir-cf` | Consumidor final | | `--iva-receptor responsable-inscripto` | `--ir-ri` | Responsable inscripto | | `--iva-receptor responsable-monotributo` | `--ir-rm` | Monotributo | | `--iva-receptor sujeto-exento` | `--ir-se` | Exento | | `--iva-receptor sujeto-no-categorizado` | `--ir-snc` | Sujeto no categorizado | | `--iva-receptor monotributista-social` | `--ir-ms` | Monotributista social | | `--iva-receptor monotributo-trabajador-independiente-promovido` | `--ir-mtip` | Monotributo trabajador independiente promovido | | `--iva-receptor cliente-del-exterior` | `--ir-ce` | Cliente del exterior | | `--iva-receptor proveedor-del-exterior` | `--ir-pe` | Proveedor del exterior | | `--iva-receptor iva-liberado` | `--ir-il` | IVA liberado | | `--iva-receptor iva-no-alcanzado` | `--ir-ina` | IVA no alcanzado | Ej.: `--ir-cf` ### Comprobante que ajusta Atajo, punto de venta y número del comprobante. O un período entero, con `--pd` y `--ph`. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | Atajo del comprobante: fc, rc, fa… | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--acuit ` | | El CUIT del emisor: el tuyo | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fc --apv 3 --ar 142 --acuit 20333333334` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Período, en vez de un comprobante Para ajustar un período entero, por ejemplo un descuento sobre el mes. No va con `--ac`. | Largo | Corto | Qué es | | --- | --- | --- | | `--periodo-desde ` | `--pd` | Inicio del período | | `--periodo-hasta ` | `--ph` | Fin del período | Ej.: `--pd 1/9 --ph 30/9` ### Receptor A quién le facturás. Sin ninguno, consumidor final. Desde $ 10.000.000 hay que identificarlo. | Largo | Corto | Qué es | | --- | --- | --- | | `--consumidor-final` | `--cfinal` | Consumidor final, sin identificar | | `--cuit ` | | Con CUIT: la condición IVA sale del padrón | | `--cuil ` | | Con CUIL | | `--dni ` | | Con DNI | Ej.: `--cuit 20168598204` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de crédito no puede superar el total del comprobante que ajusta, si van en la misma moneda: ARCLI lo revisa antes de emitir. - El comprobante que ajusta también puede ser un Recibo C: `--ac rc`. - Con un período (`--pd` y `--ph`) en vez de un comprobante, el período no puede terminar después de la fecha de la nota. ## No aplica Estos flags no van en este comprobante: `--cbu`, `--alicuota`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de débito C Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-debito-c.md Suma sobre una Factura C o un Recibo C: un cargo que faltó, intereses o una diferencia de precio. `arcli ndc` | `arcli nota-debito c` ## Ejemplo ```bash arcli ndc -m 5000 --cs --cfinal --ac fc --apv 3 --ar 142 --acuit 20333333334 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Condición IVA del receptor Cómo está inscripto a quien le facturás. `--ir` es el corto de `--iva-receptor`. Con `--cuit` sale sola del padrón de ARCA; si no, va una de estas o la de la config (`ivaReceptor`). | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor consumidor-final` | `--ir-cf` | Consumidor final | | `--iva-receptor responsable-inscripto` | `--ir-ri` | Responsable inscripto | | `--iva-receptor responsable-monotributo` | `--ir-rm` | Monotributo | | `--iva-receptor sujeto-exento` | `--ir-se` | Exento | | `--iva-receptor sujeto-no-categorizado` | `--ir-snc` | Sujeto no categorizado | | `--iva-receptor monotributista-social` | `--ir-ms` | Monotributista social | | `--iva-receptor monotributo-trabajador-independiente-promovido` | `--ir-mtip` | Monotributo trabajador independiente promovido | | `--iva-receptor cliente-del-exterior` | `--ir-ce` | Cliente del exterior | | `--iva-receptor proveedor-del-exterior` | `--ir-pe` | Proveedor del exterior | | `--iva-receptor iva-liberado` | `--ir-il` | IVA liberado | | `--iva-receptor iva-no-alcanzado` | `--ir-ina` | IVA no alcanzado | Ej.: `--ir-cf` ### Comprobante que ajusta Atajo, punto de venta y número del comprobante. O un período entero, con `--pd` y `--ph`. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | Atajo del comprobante: fc, rc, fa… | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--acuit ` | | El CUIT del emisor: el tuyo | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fc --apv 3 --ar 142 --acuit 20333333334` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Período, en vez de un comprobante Para ajustar un período entero, por ejemplo un descuento sobre el mes. No va con `--ac`. | Largo | Corto | Qué es | | --- | --- | --- | | `--periodo-desde ` | `--pd` | Inicio del período | | `--periodo-hasta ` | `--ph` | Fin del período | Ej.: `--pd 1/9 --ph 30/9` ### Receptor A quién le facturás. Sin ninguno, consumidor final. Desde $ 10.000.000 hay que identificarlo. | Largo | Corto | Qué es | | --- | --- | --- | | `--consumidor-final` | `--cfinal` | Consumidor final, sin identificar | | `--cuit ` | | Con CUIT: la condición IVA sale del padrón | | `--cuil ` | | Con CUIL | | `--dni ` | | Con DNI | Ej.: `--cuit 20168598204` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de débito suma: no tiene tope. - El comprobante que ajusta también puede ser un Recibo C: `--ac rc`. - Con un período (`--pd` y `--ph`) en vez de un comprobante, el período no puede terminar después de la fecha de la nota. ## No aplica Estos flags no van en este comprobante: `--cbu`, `--alicuota`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Recibo C Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/recibo-c.md Para documentar un cobro. Se arma como una Factura C: sin IVA discriminado. `arcli rc` | `arcli recibo c` ## Ejemplo ```bash arcli rc -m 15000 --cs --cfinal ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Condición IVA del receptor Cómo está inscripto a quien le facturás. `--ir` es el corto de `--iva-receptor`. Con `--cuit` sale sola del padrón de ARCA; si no, va una de estas o la de la config (`ivaReceptor`). | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor consumidor-final` | `--ir-cf` | Consumidor final | | `--iva-receptor responsable-inscripto` | `--ir-ri` | Responsable inscripto | | `--iva-receptor responsable-monotributo` | `--ir-rm` | Monotributo | | `--iva-receptor sujeto-exento` | `--ir-se` | Exento | | `--iva-receptor sujeto-no-categorizado` | `--ir-snc` | Sujeto no categorizado | | `--iva-receptor monotributista-social` | `--ir-ms` | Monotributista social | | `--iva-receptor monotributo-trabajador-independiente-promovido` | `--ir-mtip` | Monotributo trabajador independiente promovido | | `--iva-receptor cliente-del-exterior` | `--ir-ce` | Cliente del exterior | | `--iva-receptor proveedor-del-exterior` | `--ir-pe` | Proveedor del exterior | | `--iva-receptor iva-liberado` | `--ir-il` | IVA liberado | | `--iva-receptor iva-no-alcanzado` | `--ir-ina` | IVA no alcanzado | Ej.: `--ir-cf` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Receptor A quién le facturás. Sin ninguno, consumidor final. Desde $ 10.000.000 hay que identificarlo. | Largo | Corto | Qué es | | --- | --- | --- | | `--consumidor-final` | `--cfinal` | Consumidor final, sin identificar | | `--cuit ` | | Con CUIT: la condición IVA sale del padrón | | `--cuil ` | | Con CUIL | | `--dni ` | | Con DNI | Ej.: `--cuit 20168598204` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - El PDF sale con el título RECIBO C. ## No aplica Estos flags no van en este comprobante: `--ac`, `--cbu`, `--alicuota`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # FCE C Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/fce-c.md Factura de Crédito Electrónica C: monotributo a una empresa obligada a recibirla. `arcli fcec` | `arcli factura-credito-electronica c` ## Ejemplo ```bash arcli fcec -m 1500000 --cs --cuit 30546689979 --cbu 0110599520000012345678 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### CBU Donde te pagan. Una vez guardado en la config, no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--cbu <22 dígitos>` | | Tu CBU | Ej.: `--cbu 0110599520000012345678` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Cobro Datos extra del cobro de la FCE. | Largo | Corto | Qué es | | --- | --- | --- | | `--alias ` | | Alias del CBU | | `--transferencia ` | | Modalidad de transferencia; por defecto sca | Ej.: `--transferencia adc` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - Para saber si el receptor está obligado: `arcli fce-obligado `. ## No aplica Estos flags no van en este comprobante: `--pd`, `--ph`, `--ac`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de crédito FCE C Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-credito-fce-c.md Resta sobre una FCE C: un descuento, una devolución o una anulación. `arcli ncec` | `arcli nota-credito-electronica c` ## Ejemplo ```bash arcli ncec -m 50000 --cs --cuit 30546689979 --ac fcec --apv 3 --ar 15 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Factura que ajusta `--acuit` no va: toma tu CUIT. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | fcec, fcea o fceb | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fcec --apv 3 --ar 15` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Datos de la FCE | Largo | Corto | Qué es | | --- | --- | --- | | `--afecha ` | | Fecha de la factura; sin el flag, ARCLI la consulta en ARCA | | `--anulacion` | | Anula una factura que el comprador rechazó | Ej.: `--anulacion` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de crédito no puede superar el total del comprobante que ajusta, si van en la misma moneda: ARCLI lo revisa antes de emitir. - No aceptan un período: siempre ajustan una factura. ## No aplica Estos flags no van en este comprobante: `--acuit`, `--pd`, `--ph`, `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de débito FCE C Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-debito-fce-c.md Suma sobre una FCE C: un cargo que faltó, intereses o una diferencia de precio. `arcli ndec` | `arcli nota-debito-electronica c` ## Ejemplo ```bash arcli ndec -m 50000 --cs --cuit 30546689979 --ac fcec --apv 3 --ar 15 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Factura que ajusta `--acuit` no va: toma tu CUIT. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | fcec, fcea o fceb | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fcec --apv 3 --ar 15` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Datos de la FCE | Largo | Corto | Qué es | | --- | --- | --- | | `--afecha ` | | Fecha de la factura; sin el flag, ARCLI la consulta en ARCA | | `--anulacion` | | Anula una factura que el comprador rechazó | Ej.: `--anulacion` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de débito suma: no tiene tope. - No aceptan un período: siempre ajustan una factura. ## No aplica Estos flags no van en este comprobante: `--acuit`, `--pd`, `--ph`, `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Factura A Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/factura-a.md Responsable inscripto a otro responsable inscripto. Discrimina IVA. `arcli fa` | `arcli factura a` ## Ejemplo ```bash arcli fa -m 121000 --cs --cuit 20168598204 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Condición IVA del receptor Sale sola del padrón de ARCA con el CUIT. Usala solo si querés indicarla vos. | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor responsable-inscripto` | `--ir-ri` | Responsable inscripto | | `--iva-receptor responsable-monotributo` | `--ir-rm` | Monotributo | | `--iva-receptor monotributista-social` | `--ir-ms` | Monotributista social | | `--iva-receptor monotributo-trabajador-independiente-promovido` | `--ir-mtip` | Monotributo trabajador independiente promovido | Ej.: `--ir-ri` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - El monto es el total con IVA: ARCLI calcula el neto y el IVA. ## No aplica Estos flags no van en este comprobante: `--cfinal`, `--dni`, `--ac`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de crédito A Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-credito-a.md Resta sobre una Factura A: un descuento, una devolución o una anulación. `arcli nca` | `arcli nota-credito a` ## Ejemplo ```bash arcli nca -m 1210 --cs --cuit 20168598204 --ac fa --apv 3 --ar 6 --acuit 20333333334 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Comprobante que ajusta Atajo, punto de venta y número del comprobante. O un período entero, con `--pd` y `--ph`. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | Atajo del comprobante: fc, rc, fa… | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--acuit ` | | El CUIT del emisor: el tuyo | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fc --apv 3 --ar 142 --acuit 20333333334` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Período, en vez de un comprobante Para ajustar un período entero, por ejemplo un descuento sobre el mes. No va con `--ac`. | Largo | Corto | Qué es | | --- | --- | --- | | `--periodo-desde ` | `--pd` | Inicio del período | | `--periodo-hasta ` | `--ph` | Fin del período | Ej.: `--pd 1/9 --ph 30/9` ### Condición IVA del receptor Sale sola del padrón de ARCA con el CUIT. Usala solo si querés indicarla vos. | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor responsable-inscripto` | `--ir-ri` | Responsable inscripto | | `--iva-receptor responsable-monotributo` | `--ir-rm` | Monotributo | | `--iva-receptor monotributista-social` | `--ir-ms` | Monotributista social | | `--iva-receptor monotributo-trabajador-independiente-promovido` | `--ir-mtip` | Monotributo trabajador independiente promovido | Ej.: `--ir-ri` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de crédito no puede superar el total del comprobante que ajusta, si van en la misma moneda: ARCLI lo revisa antes de emitir. - Con un período (`--pd` y `--ph`) en vez de un comprobante, el período no puede terminar después de la fecha de la nota. ## No aplica Estos flags no van en este comprobante: `--cbu`, `--cfinal`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de débito A Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-debito-a.md Suma sobre una Factura A: un cargo que faltó, intereses o una diferencia de precio. `arcli nda` | `arcli nota-debito a` ## Ejemplo ```bash arcli nda -m 1210 --cs --cuit 20168598204 --ac fa --apv 3 --ar 6 --acuit 20333333334 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Comprobante que ajusta Atajo, punto de venta y número del comprobante. O un período entero, con `--pd` y `--ph`. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | Atajo del comprobante: fc, rc, fa… | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--acuit ` | | El CUIT del emisor: el tuyo | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fc --apv 3 --ar 142 --acuit 20333333334` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Período, en vez de un comprobante Para ajustar un período entero, por ejemplo un descuento sobre el mes. No va con `--ac`. | Largo | Corto | Qué es | | --- | --- | --- | | `--periodo-desde ` | `--pd` | Inicio del período | | `--periodo-hasta ` | `--ph` | Fin del período | Ej.: `--pd 1/9 --ph 30/9` ### Condición IVA del receptor Sale sola del padrón de ARCA con el CUIT. Usala solo si querés indicarla vos. | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor responsable-inscripto` | `--ir-ri` | Responsable inscripto | | `--iva-receptor responsable-monotributo` | `--ir-rm` | Monotributo | | `--iva-receptor monotributista-social` | `--ir-ms` | Monotributista social | | `--iva-receptor monotributo-trabajador-independiente-promovido` | `--ir-mtip` | Monotributo trabajador independiente promovido | Ej.: `--ir-ri` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de débito suma: no tiene tope. - Con un período (`--pd` y `--ph`) en vez de un comprobante, el período no puede terminar después de la fecha de la nota. ## No aplica Estos flags no van en este comprobante: `--cbu`, `--cfinal`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # FCE A Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/fce-a.md Factura de Crédito Electrónica A, a una empresa obligada a recibirla. `arcli fcea` | `arcli factura-credito-electronica a` ## Ejemplo ```bash arcli fcea -m 1210000 --cs --cuit 30546689979 --cbu 0110599520000012345678 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### CBU Donde te pagan. Una vez guardado en la config, no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--cbu <22 dígitos>` | | Tu CBU | Ej.: `--cbu 0110599520000012345678` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Cobro Datos extra del cobro de la FCE. | Largo | Corto | Qué es | | --- | --- | --- | | `--alias ` | | Alias del CBU | | `--transferencia ` | | Modalidad de transferencia; por defecto sca | Ej.: `--transferencia adc` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## No aplica Estos flags no van en este comprobante: `--pd`, `--ph`, `--ac`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de crédito FCE A Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-credito-fce-a.md Resta sobre una FCE A: un descuento, una devolución o una anulación. `arcli ncea` | `arcli nota-credito-electronica a` ## Ejemplo ```bash arcli ncea -m 121000 --cs --cuit 30546689979 --ac fcea --apv 3 --ar 6 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Factura que ajusta `--acuit` no va: toma tu CUIT. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | fcec, fcea o fceb | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fcec --apv 3 --ar 15` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Datos de la FCE | Largo | Corto | Qué es | | --- | --- | --- | | `--afecha ` | | Fecha de la factura; sin el flag, ARCLI la consulta en ARCA | | `--anulacion` | | Anula una factura que el comprador rechazó | Ej.: `--anulacion` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de crédito no puede superar el total del comprobante que ajusta, si van en la misma moneda: ARCLI lo revisa antes de emitir. - No aceptan un período: siempre ajustan una factura. ## No aplica Estos flags no van en este comprobante: `--acuit`, `--pd`, `--ph`, `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de débito FCE A Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-debito-fce-a.md Suma sobre una FCE A: un cargo que faltó, intereses o una diferencia de precio. `arcli ndea` | `arcli nota-debito-electronica a` ## Ejemplo ```bash arcli ndea -m 121000 --cs --cuit 30546689979 --ac fcea --apv 3 --ar 6 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Factura que ajusta `--acuit` no va: toma tu CUIT. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | fcec, fcea o fceb | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fcec --apv 3 --ar 15` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Datos de la FCE | Largo | Corto | Qué es | | --- | --- | --- | | `--afecha ` | | Fecha de la factura; sin el flag, ARCLI la consulta en ARCA | | `--anulacion` | | Anula una factura que el comprador rechazó | Ej.: `--anulacion` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de débito suma: no tiene tope. - No aceptan un período: siempre ajustan una factura. ## No aplica Estos flags no van en este comprobante: `--acuit`, `--pd`, `--ph`, `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Factura B Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/factura-b.md Responsable inscripto a consumidor final, monotributista o exento. `arcli fb` | `arcli factura b` ## Ejemplo ```bash arcli fb -m 12100 --cs --cfinal ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Condición IVA del receptor Cómo está inscripto a quien le facturás. `--ir` es el corto de `--iva-receptor`. Con `--cuit` sale sola del padrón de ARCA; si no, va una de estas o la de la config (`ivaReceptor`). | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor consumidor-final` | `--ir-cf` | Consumidor final | | `--iva-receptor sujeto-exento` | `--ir-se` | Exento | | `--iva-receptor sujeto-no-categorizado` | `--ir-snc` | Sujeto no categorizado | | `--iva-receptor cliente-del-exterior` | `--ir-ce` | Cliente del exterior | | `--iva-receptor proveedor-del-exterior` | `--ir-pe` | Proveedor del exterior | | `--iva-receptor iva-liberado` | `--ir-il` | IVA liberado | | `--iva-receptor iva-no-alcanzado` | `--ir-ina` | IVA no alcanzado | Ej.: `--ir-cf` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Receptor A quién le facturás. Sin ninguno, consumidor final. Desde $ 10.000.000 hay que identificarlo. | Largo | Corto | Qué es | | --- | --- | --- | | `--consumidor-final` | `--cfinal` | Consumidor final, sin identificar | | `--cuit ` | | Con CUIT: la condición IVA sale del padrón | | `--cuil ` | | Con CUIL | | `--dni ` | | Con DNI | Ej.: `--cuit 20168598204` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - El IVA va incluido en el total y no se muestra discriminado en el PDF. ## No aplica Estos flags no van en este comprobante: `--ac`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de crédito B Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-credito-b.md Resta sobre una Factura B: un descuento, una devolución o una anulación. `arcli ncb` | `arcli nota-credito b` ## Ejemplo ```bash arcli ncb -m 1210 --cs --cfinal --ac fb --apv 3 --ar 9 --acuit 20333333334 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Condición IVA del receptor Cómo está inscripto a quien le facturás. `--ir` es el corto de `--iva-receptor`. Con `--cuit` sale sola del padrón de ARCA; si no, va una de estas o la de la config (`ivaReceptor`). | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor consumidor-final` | `--ir-cf` | Consumidor final | | `--iva-receptor sujeto-exento` | `--ir-se` | Exento | | `--iva-receptor sujeto-no-categorizado` | `--ir-snc` | Sujeto no categorizado | | `--iva-receptor cliente-del-exterior` | `--ir-ce` | Cliente del exterior | | `--iva-receptor proveedor-del-exterior` | `--ir-pe` | Proveedor del exterior | | `--iva-receptor iva-liberado` | `--ir-il` | IVA liberado | | `--iva-receptor iva-no-alcanzado` | `--ir-ina` | IVA no alcanzado | Ej.: `--ir-cf` ### Comprobante que ajusta Atajo, punto de venta y número del comprobante. O un período entero, con `--pd` y `--ph`. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | Atajo del comprobante: fc, rc, fa… | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--acuit ` | | El CUIT del emisor: el tuyo | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fc --apv 3 --ar 142 --acuit 20333333334` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Período, en vez de un comprobante Para ajustar un período entero, por ejemplo un descuento sobre el mes. No va con `--ac`. | Largo | Corto | Qué es | | --- | --- | --- | | `--periodo-desde ` | `--pd` | Inicio del período | | `--periodo-hasta ` | `--ph` | Fin del período | Ej.: `--pd 1/9 --ph 30/9` ### Receptor A quién le facturás. Sin ninguno, consumidor final. Desde $ 10.000.000 hay que identificarlo. | Largo | Corto | Qué es | | --- | --- | --- | | `--consumidor-final` | `--cfinal` | Consumidor final, sin identificar | | `--cuit ` | | Con CUIT: la condición IVA sale del padrón | | `--cuil ` | | Con CUIL | | `--dni ` | | Con DNI | Ej.: `--cuit 20168598204` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de crédito no puede superar el total del comprobante que ajusta, si van en la misma moneda: ARCLI lo revisa antes de emitir. - Con un período (`--pd` y `--ph`) en vez de un comprobante, el período no puede terminar después de la fecha de la nota. ## No aplica Estos flags no van en este comprobante: `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de débito B Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-debito-b.md Suma sobre una Factura B: un cargo que faltó, intereses o una diferencia de precio. `arcli ndb` | `arcli nota-debito b` ## Ejemplo ```bash arcli ndb -m 1210 --cs --cfinal --ac fb --apv 3 --ar 9 --acuit 20333333334 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Condición IVA del receptor Cómo está inscripto a quien le facturás. `--ir` es el corto de `--iva-receptor`. Con `--cuit` sale sola del padrón de ARCA; si no, va una de estas o la de la config (`ivaReceptor`). | Largo | Corto | Qué es | | --- | --- | --- | | `--iva-receptor consumidor-final` | `--ir-cf` | Consumidor final | | `--iva-receptor sujeto-exento` | `--ir-se` | Exento | | `--iva-receptor sujeto-no-categorizado` | `--ir-snc` | Sujeto no categorizado | | `--iva-receptor cliente-del-exterior` | `--ir-ce` | Cliente del exterior | | `--iva-receptor proveedor-del-exterior` | `--ir-pe` | Proveedor del exterior | | `--iva-receptor iva-liberado` | `--ir-il` | IVA liberado | | `--iva-receptor iva-no-alcanzado` | `--ir-ina` | IVA no alcanzado | Ej.: `--ir-cf` ### Comprobante que ajusta Atajo, punto de venta y número del comprobante. O un período entero, con `--pd` y `--ph`. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | Atajo del comprobante: fc, rc, fa… | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--acuit ` | | El CUIT del emisor: el tuyo | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fc --apv 3 --ar 142 --acuit 20333333334` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Período, en vez de un comprobante Para ajustar un período entero, por ejemplo un descuento sobre el mes. No va con `--ac`. | Largo | Corto | Qué es | | --- | --- | --- | | `--periodo-desde ` | `--pd` | Inicio del período | | `--periodo-hasta ` | `--ph` | Fin del período | Ej.: `--pd 1/9 --ph 30/9` ### Receptor A quién le facturás. Sin ninguno, consumidor final. Desde $ 10.000.000 hay que identificarlo. | Largo | Corto | Qué es | | --- | --- | --- | | `--consumidor-final` | `--cfinal` | Consumidor final, sin identificar | | `--cuit ` | | Con CUIT: la condición IVA sale del padrón | | `--cuil ` | | Con CUIL | | `--dni ` | | Con DNI | Ej.: `--cuit 20168598204` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de débito suma: no tiene tope. - Con un período (`--pd` y `--ph`) en vez de un comprobante, el período no puede terminar después de la fecha de la nota. ## No aplica Estos flags no van en este comprobante: `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # FCE B Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/fce-b.md Factura de Crédito Electrónica B, a una empresa obligada a recibirla. `arcli fceb` | `arcli factura-credito-electronica b` ## Ejemplo ```bash arcli fceb -m 1210000 --cs --cuit 30546689979 --cbu 0110599520000012345678 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### CBU Donde te pagan. Una vez guardado en la config, no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--cbu <22 dígitos>` | | Tu CBU | Ej.: `--cbu 0110599520000012345678` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Cobro Datos extra del cobro de la FCE. | Largo | Corto | Qué es | | --- | --- | --- | | `--alias ` | | Alias del CBU | | `--transferencia ` | | Modalidad de transferencia; por defecto sca | Ej.: `--transferencia adc` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## No aplica Estos flags no van en este comprobante: `--pd`, `--ph`, `--ac`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de crédito FCE B Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-credito-fce-b.md Resta sobre una FCE B: un descuento, una devolución o una anulación. `arcli nceb` | `arcli nota-credito-electronica b` ## Ejemplo ```bash arcli nceb -m 121000 --cs --cuit 30546689979 --ac fceb --apv 3 --ar 4 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Factura que ajusta `--acuit` no va: toma tu CUIT. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | fcec, fcea o fceb | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fcec --apv 3 --ar 15` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Datos de la FCE | Largo | Corto | Qué es | | --- | --- | --- | | `--afecha ` | | Fecha de la factura; sin el flag, ARCLI la consulta en ARCA | | `--anulacion` | | Anula una factura que el comprador rechazó | Ej.: `--anulacion` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de crédito no puede superar el total del comprobante que ajusta, si van en la misma moneda: ARCLI lo revisa antes de emitir. - No aceptan un período: siempre ajustan una factura. ## No aplica Estos flags no van en este comprobante: `--acuit`, `--pd`, `--ph`, `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de débito FCE B Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-debito-fce-b.md Suma sobre una FCE B: un cargo que faltó, intereses o una diferencia de precio. `arcli ndeb` | `arcli nota-debito-electronica b` ## Ejemplo ```bash arcli ndeb -m 121000 --cs --cuit 30546689979 --ac fceb --apv 3 --ar 4 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Concepto Qué facturás. `-c` es el corto de `--concepto`. Si lo guardás en la config (`concepto`), no hace falta. | Largo | Corto | Qué es | | --- | --- | --- | | `--concepto servicios` | `--cs` | Servicios | | `--concepto productos` | `--cp` | Productos | | `--concepto productos-servicios` | `--csp` | Productos y servicios | Ej.: `--cs` ### Receptor Su condición IVA sale del padrón de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--cuit ` | | El CUIT del receptor | Ej.: `--cuit 20168598204` ### Factura que ajusta `--acuit` no va: toma tu CUIT. | Largo | Corto | Qué es | | --- | --- | --- | | `--ac ` | | fcec, fcea o fceb | | `--asociado-punto-venta ` | `--apv` | Su punto de venta | | `--ar ` | | Su número | | `--at ` | | Tipo ARCA, en vez de --ac | Ej.: `--ac fcec --apv 3 --ar 15` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Datos de la FCE | Largo | Corto | Qué es | | --- | --- | --- | | `--afecha ` | | Fecha de la factura; sin el flag, ARCLI la consulta en ARCA | | `--anulacion` | | Anula una factura que el comprador rechazó | Ej.: `--anulacion` ### IVA El monto es el total con IVA: ARCLI calcula el neto y el IVA. | Largo | Corto | Qué es | | --- | --- | --- | | `--alicuota ` | | general (21, por defecto), reducida (10.5), incrementada (27), cero (0), 5 o 2.5. Varias: TASA:MONTO | | `--exento ` | | La parte exenta del total | | `--nogravado ` | | La parte no gravada del total | Ej.: `--alicuota 10.5` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Período del servicio Solo con servicios. Sin estos flags, el mes en curso. | Largo | Corto | Qué es | | --- | --- | --- | | `--servicio-desde ` | `--sd` | Inicio del servicio | | `--servicio-hasta ` | `--sh` | Fin del servicio | | `--vencimiento ` | `--vto` | Vencimiento del pago; por defecto, el fin del servicio | Ej.: `--sd 1/10 --sh 31/10` ### Moneda extranjera Sin `--cm`, la cotización oficial de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización, por ejemplo 1.452,50 | | `--misma-moneda` | | Te pagan en esa misma moneda | Ej.: `--moneda USD` ### Datos del PDF Solo cambian el PDF, no lo que se informa a ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--descripcion ` | | Detalle; por defecto, "Según detalle" | | `--condicion-venta ` | `--cv` | contado, transferencia, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, otros-medios-electronicos, otra o un texto | | `--sin-condicion-venta` | | Sin condición de venta, aunque esté en la config | | `--receptor-nombre ` | | Nombre o razón social del receptor | | `--receptor-domicilio ` | | Domicilio del receptor | Ej.: `--cv transferencia` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de débito suma: no tiene tope. - No aceptan un período: siempre ajustan una factura. ## No aplica Estos flags no van en este comprobante: `--acuit`, `--pd`, `--ph`, `--cbu`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Factura E Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/factura-e.md Bienes o servicios a un cliente del exterior. Usa el servicio wsfex, con su propio certificado y punto de venta. `arcli fe` | `arcli factura e` ## Ejemplo ```bash arcli fe -m 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 212 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Cliente del exterior | Largo | Corto | Qué es | | --- | --- | --- | | `--cliente ` | | Nombre o razón social | | `--domicilio-cliente ` | | Domicilio en el exterior | Ej.: `--cliente "ACME LLC"` ### País de destino El CUIT del país sale solo de la tabla de ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--pais-destino ` | | Por código (203) o nombre (Brasil) | Ej.: `--pais-destino Brasil` ### Actividad Mejor guardarla en la config (`exportacion.actividad`). | Largo | Corto | Qué es | | --- | --- | --- | | `--actividad ` | | Código de la tabla de actividades de WSFEX | Ej.: `--actividad 620100` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Tipo de exportación | Largo | Corto | Qué es | | --- | --- | --- | | `--tipo-expo 1` | | Bienes | | `--tipo-expo 2` | | Servicios (por defecto) | | `--tipo-expo 4` | | Otros | Ej.: `--tipo-expo 1` ### Ítems Repetible. La suma tiene que dar el monto. Sin ítems, va un renglón con `--descripcion`. | Largo | Corto | Qué es | | --- | --- | --- | | `--item ` | | "código\|descripción\|cantidad\|precio\|unidad" | | `--descripcion ` | | Detalle cuando no hay ítems | Ej.: `--item "001|Servicio|1|1500|7"` ### Más datos del cliente | Largo | Corto | Qué es | | --- | --- | --- | | `--id-impositivo ` | | Su ID impositivo en su país | | `--cuit-pais ` | | CUIT del país, si no querés el de la tabla | Ej.: `--id-impositivo 12-3456789` ### Datos del comprobante | Largo | Corto | Qué es | | --- | --- | --- | | `--incoterm ` | | En bienes, por ejemplo FOB | | `--incoterms-desc ` | | Descripción del incoterm | | `--idioma <1\|2\|3>` | | Español (por defecto), inglés o portugués | | `--forma-pago ` | | Por defecto, "Transferencia Internacional" | | `--observaciones ` | | Observaciones | | `--obs-comerciales ` | | Observaciones comerciales | Ej.: `--idioma 2` ### Permisos de embarque Solo en bienes (`--tipo-expo 1`). Repetible. | Largo | Corto | Qué es | | --- | --- | --- | | `--permiso ` | | Un permiso de embarque | | `--permiso-existente` | | El permiso ya existe en ARCA | Ej.: `--permiso 26001EC01000123A` ### Moneda Por defecto, dólares. Sin `--cm`, la cotización de aduana que publica ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--moneda ` | `--mda` | ISO (USD, EUR) o de ARCA (DOL, 060) | | `--cotizacion-moneda ` | `--cm` | Cotización | | `--misma-moneda` | | Te pagan en esa misma moneda | | `--fecha-pago ` | | Fecha de pago; por defecto, la del comprobante | Ej.: `--moneda EUR` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Numeración Por defecto, la que sigue en ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--numero ` | | Número del comprobante | | `--id-solicitud ` | | ID de la solicitud | Ej.: `--numero 12` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - El CUIT del país de destino sale solo de la tabla de ARCA. - Sin `--numero`, ARCLI toma el que sigue en ARCA para ese punto de venta. ## No aplica Estos flags no van en este comprobante: `--cuit`, `--ir`, `--concepto`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de crédito E Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-credito-e.md Resta sobre una Factura E: un descuento, una devolución o una anulación. Cliente, destino, moneda y actividad salen de la factura, que ARCLI consulta en ARCA. `arcli nce` | `arcli nota-credito e` ## Ejemplo ```bash arcli nce -m 500 --ar 1 --apv 4 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Factura que ajusta Cliente, destino, moneda y actividad salen de ella. | Largo | Corto | Qué es | | --- | --- | --- | | `--ar ` | | Su número | | `--asociado-punto-venta ` | `--apv` | Su punto de venta; por defecto, el de la nota | | `--ac ` | | fe (por defecto), nde o nce | | `--at ` | | Tipo ARCA: 19, 20 o 21 | Ej.: `--ar 1 --apv 4` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Permisos de embarque Solo si la factura es de bienes. Repetible. | Largo | Corto | Qué es | | --- | --- | --- | | `--permiso ` | | Un permiso de embarque | Ej.: `--permiso 26001EC01000123A` ### Ítems Repetible. La suma tiene que dar el monto. Sin ítems, va un renglón con `--descripcion`. | Largo | Corto | Qué es | | --- | --- | --- | | `--item ` | | "código\|descripción\|cantidad\|precio\|unidad" | | `--descripcion ` | | Detalle cuando no hay ítems | Ej.: `--item "001|Servicio|1|1500|7"` ### Datos del comprobante | Largo | Corto | Qué es | | --- | --- | --- | | `--incoterm ` | | En bienes, por ejemplo FOB | | `--incoterms-desc ` | | Descripción del incoterm | | `--idioma <1\|2\|3>` | | Español (por defecto), inglés o portugués | | `--forma-pago ` | | Por defecto, "Transferencia Internacional" | | `--observaciones ` | | Observaciones | | `--obs-comerciales ` | | Observaciones comerciales | Ej.: `--idioma 2` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Numeración Por defecto, la que sigue en ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--numero ` | | Número del comprobante | | `--id-solicitud ` | | ID de la solicitud | Ej.: `--numero 12` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de crédito no puede superar el total del comprobante que ajusta, si van en la misma moneda: ARCLI lo revisa antes de emitir. - Los permisos de embarque van solo si la factura es de bienes (`--tipo-expo 1`). ## No aplica Estos flags no van en este comprobante: `--fecha-pago`, `--misma-moneda`, `--permiso-existente`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Nota de débito E Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comprobantes/nota-debito-e.md Suma sobre una Factura E: un cargo que faltó, intereses o una diferencia de precio. Cliente, destino, moneda y actividad salen de la factura, que ARCLI consulta en ARCA. `arcli nde` | `arcli nota-debito e` ## Ejemplo ```bash arcli nde -m 500 --ar 1 --apv 4 ``` Sin `--emitir` muestra la vista previa y pregunta antes de emitir. También se emite desde el [asistente](../modo-interactivo.md), sin recordar flags. ## Obligatorio Sin esto no se puede emitir. Lo que guardaste en la config no hace falta repetirlo. ### Importe El total del comprobante, en formato argentino: punto para miles y coma para decimales. | Largo | Corto | Qué es | | --- | --- | --- | | `--monto ` | `-m` | 15000, 15.000 o 1.500,50 | Ej.: `-m 15000` ### Factura que ajusta Cliente, destino, moneda y actividad salen de ella. | Largo | Corto | Qué es | | --- | --- | --- | | `--ar ` | | Su número | | `--asociado-punto-venta ` | `--apv` | Su punto de venta; por defecto, el de la nota | | `--ac ` | | fe (por defecto), nde o nce | | `--at ` | | Tipo ARCA: 19, 20 o 21 | Ej.: `--ar 1 --apv 4` ## Opcional Más datos del comprobante, o cambiar lo que viene de la config. ### Permisos de embarque Solo si la factura es de bienes. Repetible. | Largo | Corto | Qué es | | --- | --- | --- | | `--permiso ` | | Un permiso de embarque | Ej.: `--permiso 26001EC01000123A` ### Ítems Repetible. La suma tiene que dar el monto. Sin ítems, va un renglón con `--descripcion`. | Largo | Corto | Qué es | | --- | --- | --- | | `--item ` | | "código\|descripción\|cantidad\|precio\|unidad" | | `--descripcion ` | | Detalle cuando no hay ítems | Ej.: `--item "001|Servicio|1|1500|7"` ### Datos del comprobante | Largo | Corto | Qué es | | --- | --- | --- | | `--incoterm ` | | En bienes, por ejemplo FOB | | `--incoterms-desc ` | | Descripción del incoterm | | `--idioma <1\|2\|3>` | | Español (por defecto), inglés o portugués | | `--forma-pago ` | | Por defecto, "Transferencia Internacional" | | `--observaciones ` | | Observaciones | | `--obs-comerciales ` | | Observaciones comerciales | Ej.: `--idioma 2` ### Punto de venta Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--punto-venta ` | `--pv` | Un punto de venta para web service | Ej.: `--pv 3` ### Fecha Si no es hoy. | Largo | Corto | Qué es | | --- | --- | --- | | `--fecha ` | `-f` | D, D/M, D/M/AA o D/M/AAAA | Ej.: `-f 31/10` ### Numeración Por defecto, la que sigue en ARCA. | Largo | Corto | Qué es | | --- | --- | --- | | `--numero ` | | Número del comprobante | | `--id-solicitud ` | | ID de la solicitud | Ej.: `--numero 12` ## Al ejecutar No cambian el comprobante: cómo corre ARCLI esta vez. Son los mismos en todos los comprobantes. ### Vista previa o emisión Sin ninguno, muestra la vista previa y pregunta antes de emitir. | Largo | Corto | Qué es | | --- | --- | --- | | `--previsualizar` | | Solo la vista previa: no emite | | `--emitir` | | Emite sin preguntar | Ej.: `--emitir` ### Entorno Si no es el de la config. | Largo | Corto | Qué es | | --- | --- | --- | | `--testing` | | Homologación: no vale fiscalmente | | `--produccion` | | Comprobantes reales | Ej.: `--produccion` ### PDF Aunque la config diga otra cosa. | Largo | Corto | Qué es | | --- | --- | --- | | `--exportar-pdf` | `--pdf` | Genera el PDF | | `--sin-pdf` | | No lo genera | Ej.: `--pdf` ### Salida | Largo | Corto | Qué es | | --- | --- | --- | | `--json` | | JSON, para scripts e IAs | | `--bruto` | | Suma la respuesta cruda de ARCA | Ej.: `--json` ### Desde un archivo | Largo | Corto | Qué es | | --- | --- | --- | | `--cargar ` | | Los datos desde un JSON, también varios comprobantes | Ej.: `--cargar facturas.json` ## Para tener en cuenta - La nota de débito suma: no tiene tope. - Los permisos de embarque van solo si la factura es de bienes (`--tipo-expo 1`). ## No aplica Estos flags no van en este comprobante: `--fecha-pago`, `--misma-moneda`, `--permiso-existente`. Todas las reglas, en [reglas de validación](../validation-rules.md); todos los flags, en la [referencia del CLI](../cli-reference.md). --- # Notas de crédito y débito Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/notas-credito-debito.md Una nota de crédito resta y una de débito suma sobre un comprobante ya emitido (el **asociado**), o sobre un período. Vale para las letras A, B y C con los atajos `nca`, `ncb`, `ncc`, `nda`, `ndb` y `ndc`, y para FCE (`ncea`…`ndec`). Las notas de la factura de exportación están en [exportación](exportacion.md). En el [modo interactivo](modo-interactivo.md) elegís la factura de una lista y la nota toma de ahí el receptor, la moneda y la alícuota. ## Nota de crédito con comprobante asociado ### Cuándo usarlo Cuando necesitás anular o ajustar una factura previa. ### Requisitos - datos completos del asociado - misma letra que la factura referenciada - asociado del tipo factura o Recibo C, no otra nota ### Comando ```bash arcli nca -m 5000 --cs --cuit 20168598204 --ir-ri \ --ac fa \ --apv 3 \ --ar 120 \ --acuit 20333333334 ``` ### Resultado esperado - payload con `CbtesAsoc` - validación previa del asociado - emisión normal si agregás `--emitir` ### Errores comunes - faltan `--apv`, `--ar` o `--acuit` - usar `--ac` y `--at` juntos - referenciar otra nota en lugar de una factura --- # Factura de Crédito Electrónica (FCE) Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/fce.md La Factura de Crédito Electrónica MiPyMEs corresponde cuando le facturás a una empresa obligada a recibirla y el monto supera el mínimo que fija ARCA. `arcli fce-obligado ` te dice si el receptor está obligado y desde qué monto; con `verificarFce` en la config, ARCLI lo revisa solo al facturar. Atajos: `fcea`, `fceb`, `fcec` y sus notas `ncea`…`ndec`. ## Factura de crédito electrónica (FCE) ### Cuándo usarlo Cuando vendés a una empresa grande dentro del régimen FCE MiPyMEs y el comprobante tiene que ser de crédito electrónica. ### Requisitos - CBU del emisor, por flag o configurado una vez - receptor identificado con CUIT y IVA receptor válido para la letra ### Comando ```bash arcli config establecer cbu 0110599520000012345678 arcli fcea -m 1500000 --cs --cuit 30546689979 --ir-ri \ --vto 25 \ --transferencia sca ``` Si después el comprador rechaza la factura, la nota de crédito de anulación es: ```bash arcli ncea -m 1500000 --cs --cuit 30546689979 --ir-ri \ --ac fcea --apv 3 --ar 15 --afecha 01-10-2026 \ --anulacion ``` ### Resultado esperado - la factura lleva `Opcionales` con CBU (`2101`) y transferencia (`27`), además de `FchVtoPago` - la nota lleva `Opcionales` con anulación (`22`) y `CbtesAsoc` con la fecha del asociado: sin `--afecha`, ARCLI la toma de ARCA y la vista previa ya la muestra - el CUIT del asociado se toma del emisor configurado ### Errores comunes - falta el CBU en la factura - la nota de crédito supera el total de la factura: ARCLI lo frena desde la vista previa - pasar `--cbu` o `--transferencia` en una nota FCE: solo van en la factura --- # Exportación: Factura E y sus notas Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/exportacion.md La factura de exportación **E** usa otro servicio de ARCA (`wsfex`), con su propio certificado autorizado y su propio punto de venta. Lleva cliente y país de destino en vez de receptor con CUIT, y no discrimina IVA. | Comprobante | Atajo | Familia | | ----------------- | ----- | ---------------------- | | Factura E | `fe` | `arcli factura e` | | Nota de crédito E | `nce` | `arcli nota-credito e` | | Nota de débito E | `nde` | `arcli nota-debito e` | Todos los flags están en la [referencia del CLI](cli-reference.md#factura-de-exportación-e-wsfex) y las reglas en [validaciones](validation-rules.md#factura-de-exportación-e). ## Factura de exportación E ### Cuándo usarlo Cuando le vendés servicios o bienes a un cliente del exterior. Va por el servicio `wsfex`, que hay que autorizar en ARCA aparte de `wsfe`. ### Requisitos - certificado autorizado a `wsfex` (ver [certificados](obtencion-certificados.md)) - la actividad de la tabla de WSFEX, por flag o en `exportacion.actividad` ### Comando ```bash arcli fe -m 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 203 \ --actividad 620100 --item "001|Servicios de consultoría|1|1500|unidad" ``` ### Resultado esperado - va en dólares (`DOL`) con la cotización de aduana que publica ARCA, salvo `--moneda` o `--cotizacion-moneda` - la vista previa muestra cliente, destino, ítems y la solicitud de WSFEX ### Errores comunes - la suma de los `--item` no da `--monto` - la actividad no está en la tabla de WSFEX (no es la del padrón) Detalle de flags: [Factura de exportación `E`](cli-reference.md#factura-de-exportación-e-wsfex). ## Nota de crédito o débito E ### Cuándo usarlo Para ajustar una factura de exportación ya emitida: un descuento o una devolución (`nce`) o un cargo adicional (`nde`). ### Requisitos - el número de la factura E (y su punto de venta, si es otro que el de la nota) ### Comando ```bash arcli nce -m 500 --ar 1 --apv 4 ``` ### Resultado esperado - cliente, destino, moneda, cotización y actividad salen de la factura, que ARCLI consulta en ARCA - la vista previa muestra la factura asociada con su fecha y su total ### Errores comunes - ARCA no tiene la factura: revisá `--ar` y `--apv` - la nota de crédito supera el total de la factura - en servicios, otra cotización, moneda o destino que la factura: ARCA los rechaza Detalle: [Notas de crédito y débito de exportación](cli-reference.md#notas-de-crédito-y-débito-de-exportación-e). --- # Consultas sin emitir Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/consultas.md Comandos de solo lectura: no emiten nada y se pueden correr en testing o en producción. Todos aceptan `--json`. ## Comprobantes emitidos ```bash arcli ultimos fb # últimas 15 facturas B del punto de venta configurado arcli consultar fb 14 # detalle de la factura B número 14 ``` `ultimos` acepta `--cantidad` (hasta 50) y los dos, `--pv` para otro punto de venta. También con la factura de exportación (`fe`, `nce`, `nde`). Detalle en la [referencia](cli-reference.md#consultar-comprobantes-emitidos). ## Estado de ARCA y tablas ```bash arcli estado # si ARCA responde y si el punto de venta está habilitado arcli parametros alicuotas # una tabla de ARCA arcli parametros cotizacion USD # la cotización oficial del día ``` Tablas disponibles y lo que devuelve cada una: [estado y parámetros](cli-reference.md#comandos-arcli-estado-y-arcli-parametros). ## Datos de un CUIT ```bash arcli padron 20201797064 # nombre, domicilio y condición frente al IVA arcli fce-obligado 30546689979 # si está obligado a recibir FCE y desde qué monto ``` Los dos necesitan autorizar servicios aparte de `wsfe` ([cuáles](certificado-testing.md#qué-servicios-autorizar)). Detalle: [padrón](cli-reference.md#consultar-el-padrón) y [régimen FCE](cli-reference.md#consultar-el-régimen-fce). --- # PDF de comprobantes Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/pdf-en-corto.md ARCLI arma el PDF de cada comprobante emitido, con el código QR de ARCA y tus datos, y lo guarda en tu computadora. PDF de una Factura C generado por ARCLI, con el código QR de ARCA ## Cómo se activa ### 1. Instalá el plugin Una sola vez. Se descarga aparte para que ARCLI siga siendo liviano. ```bash arcli pdf instalar ``` ### 2. Cargá tus datos de emisor ARCA no los guarda, así que el PDF los toma de tu config. ```bash arcli config establecer emisor.razonSocial "Tu Nombre o Empresa" arcli config establecer emisor.domicilio "Calle 123, Ciudad" arcli config establecer emisor.inicioActividades 1/03/2020 ``` ### 3. Emití Al confirmar, elegí **Sí, emitir y generar el PDF**. Con un comando, sumá `--pdf`. ## Cuándo se genera | `pdf` en la config | Qué pasa | | ------------------------- | ------------------------------------ | | `preguntar` (por defecto) | Te lo ofrece al confirmar la emisión | | `siempre` | Lo genera con cada comprobante | | `nunca` | No lo genera; `--pdf` lo pide igual | ## Dónde queda En una carpeta por CUIT, con el tipo y el número en el nombre: ```text ~/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdf ``` Los de testing van dentro de `testing/`, para no mezclarlos con los reales. > [!NOTE] > **Si el PDF falla, el comprobante ya está emitido.** El PDF se arma después de que ARCA aprueba: si falla, el comprobante sigue siendo válido y no hay que volver a emitirlo. Qué hacer, en [problemas frecuentes](troubleshooting.md#pdf). Leyendas obligatorias, datos opcionales, la factura E y la salida en JSON, en la [guía completa del PDF](pdf.md). --- # PDF de comprobantes Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/pdf.md ARCLI puede generar el PDF de cada comprobante que emitís, con el QR de ARCA. Es el archivo que le mandás al cliente. ## Ejemplo: factura con PDF ### Cuándo usarlo Cuando además de emitir querés el PDF con el QR de ARCA para mandarle al cliente. ### Requisitos - datos del emisor en la config: `emisor.razonSocial`, `emisor.domicilio` y `emisor.inicioActividades` - el plugin de PDF (`arcli pdf instalar`, o aceptar la descarga la primera vez en una terminal) ### Comando ```bash arcli fc -m 150000 --cs --cfinal --emitir --exportar-pdf \ --descripcion "Servicios de septiembre" --condicion-venta contado --receptor-nombre "Cliente SA" ``` Si siempre querés el PDF, guardalo en la config y no hace falta el flag: ```bash arcli config establecer pdf siempre ``` ### Resultado esperado - el comprobante emitido, con su CAE - debajo, `PDF guardado en ~/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdf` (una subcarpeta por CUIT; en testing, dentro de `testing/`) - con `--json`, la clave `pdf` con la `ruta` ### Errores comunes - faltan datos del emisor (`PDF_ISSUER_INCOMPLETE`): el comprobante se emite igual, sin PDF - falta el plugin con `--json` o en un script (`PDF_PLUGIN_MISSING`): instalalo antes con `arcli pdf instalar` - pasar `--descripcion` sin `--emitir`: en la vista previa no hay PDF Detalle completo en [PDF de comprobantes](pdf.md). ## Resumen ```bash # Una sola vez: datos del emisor que ARCA no guarda arcli config establecer emisor.razonSocial "Tu Nombre o Empresa" arcli config establecer emisor.domicilio "Calle 123, Ciudad" arcli config establecer emisor.inicioActividades 1/03/2020 # Emitir y generar el PDF arcli fc -m 150000 --cs --cfinal --emitir --exportar-pdf --descripcion "Servicios de septiembre" ``` La primera vez, ARCLI ofrece descargar el plugin de PDF. El archivo queda en `~/arcli/comprobantes/testing/20123456786/factura-c_0003-00000125.pdf` (en producción, sin la carpeta `testing/`). ## El plugin de PDF El PDF lo arma [`@arcasdk/pdf`](https://www.afipts.com/packages/pdf), que usa un navegador sin ventana (Chrome) para dibujarlo. Como pesa bastante, **no viene con ARCLI**: se descarga recién cuando alguien lo necesita. Si nunca generás un PDF, ARCLI sigue pesando lo mismo. ```bash arcli pdf # estado: instalado o no, versión, navegador arcli pdf instalar # descargar el plugin arcli pdf desinstalar # borrar el plugin y el navegador descargado ``` - **Tamaño:** unos 160 MB. Si no tenés Chrome, Chromium o Edge instalado, se descarga un navegador y se suman unos 200 MB. - **Navegador:** ARCLI busca, en este orden, la config `pdfNavegador`, la variable `PUPPETEER_EXECUTABLE_PATH`, un Chrome, Chromium o Edge instalado en el sistema y, por último, el navegador que descargó el plugin. - **Dónde se instala:** en `plugins/pdf/`, junto al archivo de configuración (ver `arcli config ruta`). `arcli pdf desinstalar` borra esa carpeta entera. - **Con qué se instala:** con `npm`, aunque hayas instalado ARCLI con pnpm, Yarn o bun: npm viene con Node, y así el plugin queda en una carpeta `node_modules` común que ARCLI sabe cargar. - **Cuándo se descarga solo:** solo en una terminal interactiva, y siempre preguntando antes. Con `--json` o sin terminal (scripts, CI, agentes) **nunca** se descarga solo: el comprobante sale con el error `PDF_PLUGIN_MISSING` en `pdf.error` y hay que correr `arcli pdf instalar` antes. - **Versión:** ARCLI usa una versión fija del plugin, probada con ARCLI. Si cambia en una versión nueva de ARCLI, `arcli pdf` lo indica y `arcli pdf instalar` la actualiza. ## Cuándo se genera Los flags ganan siempre: - `--exportar-pdf` (alias `--pdf`): genera el PDF. - `--sin-pdf`: no lo genera. Sin flags, depende de si confirmás la emisión a mano. ### Si confirmás antes de emitir Sin `--emitir` ni `--previsualizar` (y sin `emitir true` en la config), en una terminal ARCLI muestra la vista previa y pregunta "¿Emitimos la factura C en testing?" con tres opciones, diga lo que diga la config `pdf`: - **Sí, emitir ahora**: emite sin PDF. - **Sí, emitir y generar el PDF**: emite y genera el PDF. - **No, dejar sin emitir**. Lo que elegís decide: después de emitir no se pregunta nada más del PDF. Con `pdf siempre` la opción marcada al empezar es **Sí, emitir y generar el PDF**; con `preguntar` o `nunca`, **Sí, emitir ahora**. Con `--exportar-pdf` o `--sin-pdf` el PDF ya está decidido y la pregunta solo ofrece **Sí, emitir ahora** y **No, dejar sin emitir**. Vale para todos los comprobantes y también en el [modo interactivo](modo-interactivo.md#pdf). ### Si se emite sin confirmar Con `--emitir`, con `emitir true` en la config, con `--json` o sin terminal, decide la config `pdf`: | `pdf` | En una terminal | Con `--json` o sin terminal | | ------------------------- | -------------------------- | --------------------------- | | `preguntar` (por defecto) | Pregunta después de emitir | No genera | | `siempre` | Genera | Genera | | `nunca` | No genera | No genera | ```bash arcli config establecer pdf siempre ``` Nunca se genera un PDF de una vista previa (sin `--emitir`) ni de un comprobante rechazado, porque no tienen CAE. Un comprobante **observado** sí tiene CAE y sí lleva PDF. En un lote (`--cargar` con un array) se genera un PDF por comprobante. La respuesta a "¿Emitimos?", o a la pregunta del PDF después de emitir, vale para todo el lote. Cada ítem del JSON puede traer `"pdf": true` o `"pdf": false`, que le gana a esa respuesta. ## Si el PDF falla, el comprobante ya está emitido El PDF se arma **después** de emitir. Si algo falla (falta el plugin, faltan datos del emisor, el navegador no arranca), el comprobante igual queda emitido: se muestra con su CAE, seguido de un aviso con el error y cómo resolverlo. No lo vuelvas a emitir para obtener el PDF: quedaría duplicado en ARCA. El código de salida no cambia. En JSON, el error va en `pdf.error`. ## Datos que ARCA no guarda ARCA solo guarda números: no tiene el nombre del emisor, ni el del cliente, ni el detalle de lo que vendiste. Para el PDF hacen falta algunos datos más. ### Del emisor (config) | Clave | Obligatoria | Nota | | -------------------------- | ----------- | ---------------------------------------------------------------------------------------------- | | `emisor.razonSocial` | sí | Nombre o razón social | | `emisor.domicilio` | sí | Domicilio comercial | | `emisor.inicioActividades` | sí | Fecha con año, por ejemplo `1/03/2020` | | `emisor.iibb` | no | Número de Ingresos Brutos, o `Exento`. Si falta, sale "-" | | `emisor.condicionIva` | no | Por defecto sale de la letra: `A` y `B` → responsable inscripto, `C` → responsable monotributo | | `emisor.logo` | no | Ruta a una imagen PNG o JPG | El CUIT es el de siempre (`cuit`). Si falta algún dato obligatorio, el PDF no se genera y el error `PDF_ISSUER_INCOMPLETE` lista los comandos para completarlos. En el modo interactivo se preguntan y se ofrece guardarlos. ### Del comprobante (flags opcionales) | Flag | En el JSON de `--cargar` | Si no se pasa | | ----------------------------------- | ------------------------ | ------------------------------------------------------ | | `--descripcion ` | `descripcion` | "Según detalle" | | `--condicion-venta ` (`--cv`) | `condicionVenta` | `condicionVenta` de la config; sin ella, no se muestra | | `--sin-condicion-venta` | `condicionVenta: null` | Omite también el valor de la config | | `--receptor-nombre ` | `receptorNombre` | "Consumidor Final" o `- -` | | `--receptor-domicilio ` | `receptorDomicilio` | `- -` | Al facturar con `--cuit` y sin `--ir` (con `consultarPadron` activo, como viene por defecto), el nombre y el domicilio del receptor que no pases salen del padrón de ARCA. Con `--ir` explícito no se consulta el padrón y valen los de la tabla. Estos datos **solo van en el PDF**: ARCA no los recibe. Si los pasás y al final no se genera ningún PDF, ARCLI avisa que no quedaron en ningún lado. La condición de venta es `contado`, `tarjeta-debito`, `tarjeta-credito`, `cuenta-corriente`, `cheque`, `transferencia`, `otros-medios-electronicos` u `otra`, que se imprimen con su nombre, o cualquier otro texto, que se imprime tal cual: así no se limitan automatizaciones ni valores que ARCA no cataloga. Para no pasarla siempre: `arcli config establecer condicionVenta contado`. Para omitir ese default en un comprobante, usá `--sin-condicion-venta` o `"condicionVenta": null` en el JSON. En el modo interactivo se elige de una lista con la de la config marcada. Va en el renglón de la condición frente al IVA del receptor ("Cond. Venta: Contado"), seguida del vencimiento del pago si lo hay. Con la plantilla actual del plugin, el vencimiento solo se imprime junto a la condición de venta. `--vencimiento` viaja a ARCA en la solicitud; `--condicion-venta`, no. El detalle del PDF tiene un renglón por alícuota de IVA con la descripción y su importe neto, o un solo renglón en las facturas `C`. Exento y no gravado van en renglones aparte. El Recibo C usa la misma plantilla que la Factura C con el título `RECIBO C`, `COD.15` y el QR con el tipo 15. No es el formato de recibo del portal de ARCA. ### Factura de exportación (E) La `E` usa el diseño de exportación de `@arcasdk/pdf`, con los mismos datos que la E de Comprobantes en línea, y no discrimina IVA. Imprime: - los ítems que viajaron a WSFEX (código, descripción con su unidad, cantidad, precio unitario y total); - el título `FACTURA DE EXPORTACIÓN`, `NOTA DE CRÉDITO DE EXPORTACIÓN` o `NOTA DE DÉBITO DE EXPORTACIÓN`; - en las notas, el comprobante asociado; - el cliente con su domicilio, el CUIT del país con su descripción de ARCA (`55000004242 (POLONIA - Persona Jurídica)`) y el ID impositivo; - la divisa con su código ISO y su nombre (`USD - Dólar Estadounidense`; WSFEX la llama `DOL`) y el destino del comprobante; - una tabla con la forma de pago, la fecha de pago (las notas no la llevan) y el incoterm; - el tipo de cambio y el importe total en la moneda del comprobante; - la leyenda `IVA EXENTO OPERACIÓN DE EXPORTACIÓN` debajo de la condición frente al IVA del emisor; - las observaciones comerciales y las observaciones, debajo del CAE; - el QR de ARCA, con el CUIT del país como documento del receptor. - El nombre y el domicilio del cliente no son datos solo del PDF: salen de `--cliente` y `--domicilio-cliente` y ARCA los guarda. `--receptor-nombre` y `--receptor-domicilio` no existen en `fe`. - `--descripcion` es la descripción del renglón único que arma ARCLI cuando no pasás `--item` (por defecto "Según detalle"). Con ítems, los renglones son los `--item`. - `emisor.condicionIva` sin configurar sale como "Responsable Inscripto", igual que en `A` y `B`. ## Leyendas obligatorias ARCLI agrega al PDF las leyendas que pide la normativa y que la plantilla de `@arcasdk/pdf` no trae. Salen debajo del CAE, en la línea de "Observaciones": - **Comprobantes B (RG 5614, Ley 27.743):** "Régimen de Transparencia Fiscal al Consumidor (Ley 27.743)", con el **IVA Contenido** del comprobante y **Otros Impuestos Nacionales Indirectos** en `$ 0,00` (ARCLI no informa tributos). - **Comprobantes A a un monotributista (RG 5003):** "El crédito fiscal discriminado en el presente comprobante, sólo podrá ser computado a efectos del Régimen de Sostenimiento e Inclusión Fiscal para Pequeños Contribuyentes de la Ley Nº 27.618". Aplica si la condición IVA del receptor es responsable monotributo, monotributista social o monotributo trabajador independiente promovido. Las facturas C no llevan ninguna de las dos. ## Carpeta y nombre del archivo - **Carpeta:** la config `pdfCarpeta`. Por defecto es `~/arcli/comprobantes`, una ruta fija para que los PDFs no queden repartidos según desde dónde corriste el comando. - **Una subcarpeta por CUIT emisor:** `~/arcli/comprobantes/20123456786/`. Así dos emisores con el mismo punto de venta y número no se pisan. - **Testing:** los PDFs de testing van a `testing//` y llevan al pie "COMPROBANTE DE PRUEBA - SIN VALIDEZ FISCAL". - **Nombre:** `-_-.pdf`, con el punto de venta en 4 dígitos y el número en 8. Por ejemplo, `factura-c_0003-00000125.pdf`, `nota-credito-a_0003-00000007.pdf`, `recibo-c_0003-00000003.pdf`, `factura-e_0003-00000012.pdf` o `nota-credito-e_0004-00000001.pdf`. - **Nunca se pisa un PDF:** si el archivo ya existe, el nuevo se guarda como `factura-c_0003-00000125-2.pdf`, `-3` y así. ```bash arcli config establecer pdfCarpeta ~/Documentos/facturas ``` ## Salida En la terminal, debajo del comprobante: ```text PDF guardado en /Users/vos/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdf ``` En JSON, el resultado suma la clave `pdf` **solo si se intentó generar** el PDF: ```json { "pdf": { "ruta": "/Users/vos/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdf" } } ``` ```json { "pdf": { "error": { "codigo": "PDF_PLUGIN_MISSING", "mensaje": "Para generar PDFs falta instalar el plugin de PDF.", "sugerencia": "Instalalo con `arcli pdf instalar`." } } } ``` Códigos posibles: `PDF_PLUGIN_MISSING`, `PDF_PLUGIN_INSTALL_ERROR`, `PDF_ISSUER_INCOMPLETE` y `PDF_GENERATION_ERROR`. Ver [Troubleshooting](troubleshooting.md#pdf). ## Qué no hace (todavía) - **Regenerar el PDF de un comprobante ya emitido.** La consulta de ARCA que usa el SDK no devuelve el detalle de IVA, los comprobantes asociados ni las fechas de servicio, así que el PDF saldría incompleto. Por ahora el PDF se genera al emitir. - Ítems detallados en A, B y C (cantidad × precio unitario). La factura de exportación `E` sí los imprime porque WSFEX los recibe y los devuelve en la respuesta. - Duplicado y triplicado, plantilla propia y envío por mail. - Completar los datos del emisor desde el padrón de ARCA (los del receptor sí se completan; ver [Del comprobante](#del-comprobante-flags-opcionales)). --- # Lotes, JSON y automatización Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/lotes-y-json.md Para emitir desde un script, una planilla o un sistema propio: datos en JSON con `--cargar`, varios comprobantes en un lote y salida `--json` estable. El formato completo está en [entrada y salida](input-output.md). Si lo usás con un asistente de IA, ver [automatizar con IA](automatizar-con-ia.md). ## Carga desde JSON ### Cuándo usarlo Cuando ya tenés los datos preparados en un archivo o querés reutilizar payloads de prueba. ### Requisitos - archivo JSON válido - estructura compatible con el comando elegido ### Comando ```bash arcli fc --cargar ./voucher.json ``` ### Resultado esperado - ARCLI mezcla flags, JSON y config usando esta prioridad: - flags - JSON - config - defaults internos ### Errores comunes - nombres de campos incompatibles con el contrato JSON - tipos inválidos - lote con un ítem inválido que corta toda la ejecución ## Batch con JSON ### Cuándo usarlo Cuando querés procesar varios comprobantes del mismo comando en una sola corrida. ### Requisitos - archivo con un array JSON (un array de un solo elemento también es un lote) - cada ítem debe ser válido ### Comando ```bash arcli fc --cargar ./voucher-batch.json --json --bruto ``` ### Resultado esperado - en texto: un bloque por ítem - en JSON: un array de resultados con `indice`, `comprobante` y `atajo` (también con un solo elemento); con `--bruto`, cada uno suma `respuesta` ### Errores comunes - un ítem inválido hace fallar el lote completo - asumir que hay resultados parciales cuando la validación corta antes ## Caso de automatización ### Cuándo usarlo Cuando querés consumir ARCLI desde un script o pipeline. ### Requisitos - salida estructurada - un formato fácil de parsear ### Comando ```bash arcli fb -m 1 --cs --consumidor-final --emitir --json --bruto ``` ### Ejemplo con `jq` Cuando querés encadenar la salida con otros scripts, lo más práctico es combinar `--json` con `jq`: ```bash arcli fb -m 1 --cs --consumidor-final --emitir --json \ | jq '{estado, cae, comprobante, atajo, solicitud}' ``` ### Resultado esperado - JSON estable para scripts - acceso directo a campos como `estado`, `cae`, `atajo` o `solicitud` ### Errores comunes - intentar parsear la salida humana - asumir que `--json` devuelve exactamente lo mismo que el modo texto --- # Comandos y flags Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/comandos.md Todos los comandos de ARCLI. Cada uno tiene su ayuda en la terminal: `arcli --ayuda`. ## Facturar Un atajo por comprobante: `arcli fc` es lo mismo que `arcli factura c`. Cada uno lleva a su página, con todas sus opciones. | Familia | A | B | C | E | | ----------------------------- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- | --------------------------------------- | | `factura` | [`fa`](comprobantes/factura-a.md) | [`fb`](comprobantes/factura-b.md) | [`fc`](comprobantes/factura-c.md) | [`fe`](comprobantes/factura-e.md) | | `nota-credito` | [`nca`](comprobantes/nota-credito-a.md) | [`ncb`](comprobantes/nota-credito-b.md) | [`ncc`](comprobantes/nota-credito-c.md) | [`nce`](comprobantes/nota-credito-e.md) | | `nota-debito` | [`nda`](comprobantes/nota-debito-a.md) | [`ndb`](comprobantes/nota-debito-b.md) | [`ndc`](comprobantes/nota-debito-c.md) | [`nde`](comprobantes/nota-debito-e.md) | | `factura-credito-electronica` | [`fcea`](comprobantes/fce-a.md) | [`fceb`](comprobantes/fce-b.md) | [`fcec`](comprobantes/fce-c.md) | – | | `nota-credito-electronica` | [`ncea`](comprobantes/nota-credito-fce-a.md) | [`nceb`](comprobantes/nota-credito-fce-b.md) | [`ncec`](comprobantes/nota-credito-fce-c.md) | – | | `nota-debito-electronica` | [`ndea`](comprobantes/nota-debito-fce-a.md) | [`ndeb`](comprobantes/nota-debito-fce-b.md) | [`ndec`](comprobantes/nota-debito-fce-c.md) | – | | `recibo` | – | – | [`rc`](comprobantes/recibo-c.md) | – | ¿No sabés cuál? [¿Qué comprobante me toca?](comprobantes/README.md) ## Consultar No emiten nada. | Comando | Qué hace | | --------------------------------- | ---------------------------------------------------- | | `arcli ultimos ` | Los últimos comprobantes emitidos en ARCA | | `arcli consultar ` | El detalle de un comprobante emitido | | `arcli padron ` | Nombre, domicilio y condición IVA de un CUIT | | `arcli fce-obligado ` | Si un receptor está obligado a recibir FCE | | `arcli estado` | Si ARCA responde y tu punto de venta está habilitado | | `arcli parametros [tabla]` | Tablas de ARCA: puntos de venta, monedas, cotización | Con ejemplos, en [consultas sin emitir](consultas.md). ## Preparar Se usan una vez, o cada tanto. | Comando | Qué hace | | ---------------------- | -------------------------------------------------------------------------------------------- | | `arcli config` | Guardar valores por defecto y revisar si está todo listo ([configuración](configuration.md)) | | `arcli certificado` | Pedir el certificado de ARCA y cargarlo ([certificado de testing](certificado-testing.md)) | | `arcli pdf` | Instalar o revisar el plugin de PDF ([PDF](pdf-en-corto.md)) | | `arcli acceso-directo` | Un ícono para abrir ARCLI con doble clic | | `arcli completado` | Autocompletado con Tab en bash, zsh o fish | ## Ayuda | Comando | Qué hace | | ------------------- | -------------------------------------------------------------------------------- | | `arcli interactivo` | El [asistente](formas-de-uso/asistente.md) paso a paso; también con `arcli` solo | | `arcli ejemplos` | Ejemplos listos para copiar de todos los comprobantes | | `arcli ayuda` | Todos los comandos; `--ayuda` en cualquiera | ## Al ejecutar Sirven en casi todos los comandos. | Flags | Qué hacen | | ------------------------------- | ---------------------------------------------------------------------------------- | | `--previsualizar` \| `--emitir` | Solo la vista previa, o emitir sin preguntar. Sin ninguno, vista previa y pregunta | | `--testing` \| `--produccion` | El entorno, si no es el de la config | | `--json` \| `--bruto` | Salida en JSON para scripts e IAs; `--bruto` suma la respuesta cruda de ARCA | Todos los flags en un solo lugar, con sus valores y reglas, en la [referencia completa del CLI](cli-reference.md). --- # Referencia del CLI Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/cli-reference.md ## TL;DR Si solo querés un ejemplo mínimo funcional para arrancar: ```bash arcli fc -m 300000 --cs --consumidor-final ``` Eso crea una `Factura C` con: - monto - concepto `servicios` - receptor consumidor final - IVA receptor consumidor final Asume que ya configuraste CUIT, credenciales y punto de venta (`arcli config revisar` lo verifica). Sin `--emitir` (y con `emitir` en `false` en la config, el valor por defecto) solo muestra la vista previa. ¿Preferís que te pregunte paso a paso? Corré `arcli` sin argumentos y se abre el [modo interactivo](modo-interactivo.md). Antes de emitir te muestra el comando equivalente. Si querés entender más, este orden sirve: [Cómo pensar los comprobantes](#cómo-pensar-los-comprobantes-en-arcli) → [Parámetros por familia](#parámetros-por-familia-de-comprobantes) → [Cómo funcionan los flags](#cómo-funcionan-los-flags) → [Ejemplos útiles](#ejemplos-útiles). Si ya conocés el CLI, las tablas de flags sirven como referencia rápida. ## Cómo pensar rápido un comando Si querés armar un comando sin perderte, este orden suele funcionar bien: 1. elegí el comprobante: `fc`, `fa`, `nca`, `ndb`, `fcec`, etc 2. definí el monto: `--monto` 3. elegí el concepto: `--cs`, `--cp`, `--csp` o `--concepto` 4. definí la identidad del receptor: `--cuit`, `--cuil`, `--dni`, `--consumidor-final` 5. definí el IVA receptor: `--ir-*`, `--ir` o `--iva-receptor` Con eso ya tenés la base. Después sumás fechas de servicio, JSON, salida estructurada o asociado solo si ese caso lo necesita. ## Cómo pensar los comprobantes en ARCLI ARCLI trabaja con dos ideas al mismo tiempo: - **familias**, como `factura` o `nota-credito` - **letras**, como `a`, `b` o `c` Entonces: - `arcli factura c` y `arcli fc` representan el mismo comprobante - `arcli nota-credito a` y `arcli nca` también Los shortcuts existen para escribir menos. Las familias existen para que el comando sea más explícito o más fácil de descubrir. En todos los casos, la estructura base se parece bastante: - importe - concepto - identidad del receptor - IVA del receptor - punto de venta - modo de ejecución Después cambian algunas cosas según la familia: - las **facturas** no usan comprobante asociado - las **notas** sí lo usan - las **electrónicas** mantienen la misma forma general, pero cambian el tipo ARCA ### Familias | Comando | Argumentos | Descripción | | ----------------------------- | -------------- | ------------------------------------------------------------------ | | `factura` | `` | Emite o previsualiza Factura A, B, C o la de exportación E (WSFEX) | | `nota-credito` | `` | Emite o previsualiza Nota de crédito A, B, C o la de exportación E | | `nota-debito` | `` | Emite o previsualiza Nota de débito A, B, C o la de exportación E | | `factura-credito-electronica` | `` | Emite o previsualiza Factura de crédito electrónica A, B o C | | `nota-credito-electronica` | `` | Emite o previsualiza Nota de crédito electrónica A, B o C | | `nota-debito-electronica` | `` | Emite o previsualiza Nota de débito electrónica A, B o C | | `recibo` | `` | Emite o previsualiza Recibo C (solo letra C) | ### Shortcuts | Shortcut | Comando largo | | -------- | ------------------------------- | | `fa` | `factura a` | | `fb` | `factura b` | | `fc` | `factura c` | | `nca` | `nota-credito a` | | `ncb` | `nota-credito b` | | `ncc` | `nota-credito c` | | `nda` | `nota-debito a` | | `ndb` | `nota-debito b` | | `ndc` | `nota-debito c` | | `fe` | `factura e` | | `nce` | `nota-credito e` | | `nde` | `nota-debito e` | | `fcea` | `factura-credito-electronica a` | | `fceb` | `factura-credito-electronica b` | | `fcec` | `factura-credito-electronica c` | | `ncea` | `nota-credito-electronica a` | | `nceb` | `nota-credito-electronica b` | | `ncec` | `nota-credito-electronica c` | | `ndea` | `nota-debito-electronica a` | | `ndeb` | `nota-debito-electronica b` | | `ndec` | `nota-debito-electronica c` | | `rc` | `recibo c` | `arcli factura e` y `arcli fe` son la misma Factura de exportación `E`: la letra `E` de la familia `factura` se resuelve por WSFEX, con sus propios flags (ver [Factura de exportación](#factura-de-exportación-e-wsfex)). Lo mismo pasa con `nota-credito e` (`nce`) y `nota-debito e` (`nde`): ver [Notas de crédito y débito de exportación](#notas-de-crédito-y-débito-de-exportación-e). ## Cómo funcionan los flags Antes de ver parámetro por parámetro, hay cuatro reglas que te conviene tener presentes: - **prioridad:** `flags > JSON > config > defaults` - **los flags pisan todo**: si algo viene por CLI, manda eso - **hay flags excluyentes**: no todo se puede combinar - **`--json` y `--bruto` cambian la salida, no el sentido del comprobante** Ejemplo simple de prioridad: - si en config guardaste `puntoVenta = 3` - en `voucher.json` mandás `puntoVenta = 5` - y en CLI ejecutás `--pv 7` ARCLI usa `7`, porque el flag explícito siempre pisa JSON y config. ### Exclusividades importantes Hay varias combinaciones de flags que no podés usar juntas (entorno, modo de ejecución, concepto, IVA receptor, identidad del receptor, tipo de asociado). El detalle completo vive en [Flags mutuamente excluyentes](validation-rules.md#flags-mutuamente-excluyentes). ## Flags globales Usalos cuando necesitás controlar el entorno, la salida o el modo de inspección del resultado. Cada comando acepta solo los que usa: | Comando | Flags globales que acepta | | --------------------------------------------------------------------------------------- | ------------------------------------------------ | | comprobantes (`fa`, `fc`, `nca`, `factura`, ...) | `--testing`, `--produccion`, `--json`, `--bruto` | | `padron`, `fce-obligado`, `ultimos`, `consultar`, `parametros`, `estado` | `--testing`, `--produccion`, `--json` | | `certificado generar`, `certificado importar` | `--testing`, `--produccion`, `--json` | | `interactivo` | `--testing`, `--produccion` | | `config` (y sus subcomandos), `pdf` (y sus subcomandos), `completado`, `acceso-directo` | `--json` | ### Emisión en producción El entorno y la decisión de emitir son independientes: - **Entorno:** `--testing` o `--produccion`; sin flag, `config.entorno` (`testing` por defecto). - **Emitir:** `--emitir` o `--previsualizar`; sin flag, `emitir`/`previsualizar` del JSON de `--cargar`; si tampoco, `config.emitir` (`false` por defecto). Si nada pide emitir, en una terminal se muestra la vista previa y se pregunta, nombrando el entorno: `¿Emitimos la factura B en PRODUCCIÓN?`, con las opciones **Sí, emitir ahora**, **Sí, emitir y generar el PDF** y **No, dejar sin emitir** (la del PDF no aparece con `--exportar-pdf` o `--sin-pdf`; ver [PDF](pdf.md#cuándo-se-genera)). Esc cuenta como no, igual que en el modo interactivo, y también en las preguntas del PDF; con `--json` o sin terminal no se emite. Así, `--produccion --emitir` emite en producción sin preguntar, y también lo hace un comando sin flags si la config tiene `entorno produccion` y `emitir true`. Es a propósito, para quien no quiere confirmar cada vez. Para no depender de la config (scripts, agentes), pasá siempre el entorno y `--emitir` o `--previsualizar`. | Flag | Alias | Tipo | Valor por defecto | Descripción | | -------------- | ------- | --------- | ------------------------------------ | --------------------------------------------- | | `--testing` | ninguno | `boolean` | `false` | Fuerza entorno `testing` en esta ejecución | | `--produccion` | ninguno | `boolean` | `false` | Fuerza entorno `produccion` en esta ejecución | | `--json` | ninguno | `boolean` | `config.json` (`false` por defecto) | Devuelve salida estructurada | | `--bruto` | ninguno | `boolean` | `config.bruto` (`false` por defecto) | Agrega respuesta cruda de ARCA cuando exista | Si pasás una de estas opciones a un comando que no la usa (por ejemplo `arcli padron 20201797064 --bruto`), el comando corre igual y en stderr aparece un aviso: ``Aviso: `--bruto` no aplica a `arcli padron`, se ignora.`` Todos los comandos con `--json` lo resuelven igual: el flag o, si no está, la clave de config `json`. También los errores de uso (opción desconocida, valor faltante, comando que no existe): con `--json` o `json=true` salen como `INPUT_VALIDATION_ERROR` en el [formato de error JSON](input-output.md#errores-json-de-uso); sin JSON, en el mismo panel que el resto de los errores, con la sugerencia de ayuda. ## Flags de comprobantes Esta sección describe qué existe. Más abajo vas a encontrar qué hace falta en cada familia. ### Ejecución Estos flags controlan si ARCLI previsualiza o emite de verdad. | Flag | Alias | Tipo | Valor por defecto | Descripción | | ----------------- | ------- | --------- | ------------------------------------------------------------- | ------------------------------- | | `--previsualizar` | ninguno | `boolean` | lo contrario de `emitir`, resuelto desde flags, JSON o config | Muestra la solicitud sin emitir | | `--emitir` | ninguno | `boolean` | `config.emitir` (`false` por defecto) | Emite realmente en ARCA | ### Identidad e IVA receptor Estos flags definen a quién le emitís y bajo qué condición de IVA. En la práctica, siempre necesitás: - una identidad - una condición de IVA receptor | Flag | Alias | Tipo | Valor por defecto | Descripción | | ----------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------- | | `--cuit ` | ninguno | `string` | ninguno | CUIT del receptor: 11 dígitos, con o sin guiones | | `--cuil ` | ninguno | `string` | ninguno | CUIL del receptor: 11 dígitos, con o sin guiones | | `--dni ` | ninguno | `string` | ninguno | DNI del receptor: 7 u 8 dígitos, con o sin puntos | | `--consumidor-final` | `--cfinal` | `boolean` | `false` | Documento `0` e IVA receptor `consumidor-final` | | `--iva-receptor ` | `--ir ` | `'cliente-del-exterior' \| 'consumidor-final' \| 'iva-liberado' \| 'iva-no-alcanzado' \| 'monotributista-social' \| 'monotributo-trabajador-independiente-promovido' \| 'proveedor-del-exterior' \| 'responsable-inscripto' \| 'responsable-monotributo' \| 'sujeto-exento' \| 'sujeto-no-categorizado'` | Con `--cuit`, la del padrón; si no, `config.ivaReceptor` | Condición IVA del receptor | | `--ir-ce` | ninguno | `boolean` | `false` | Cliente del exterior | | `--ir-cf` | ninguno | `boolean` | `false` | Consumidor final | | `--ir-il` | ninguno | `boolean` | `false` | IVA liberado | | `--ir-ina` | ninguno | `boolean` | `false` | IVA no alcanzado | | `--ir-ms` | ninguno | `boolean` | `false` | Monotributista social | | `--ir-mtip` | ninguno | `boolean` | `false` | Monotributo trabajador independiente promovido | | `--ir-pe` | ninguno | `boolean` | `false` | Proveedor del exterior | | `--ir-ri` | ninguno | `boolean` | `false` | Responsable inscripto | | `--ir-rm` | ninguno | `boolean` | `false` | Responsable monotributo | | `--ir-se` | ninguno | `boolean` | `false` | Sujeto exento | | `--ir-snc` | ninguno | `boolean` | `false` | Sujeto no categorizado | El IVA receptor tiene que ser válido para la letra del comprobante. Por ejemplo, `fa` no admite `--ir-cf` y `fb` no admite `--ir-ri`. Ver [IVA receptor](validation-rules.md#iva-receptor). ### Contenido Estos flags arman el contenido del comprobante. En casi todos los casos te va a interesar mirar primero: - `--monto` - `--concepto` - `--fecha` - `--punto-venta` | Flag | Alias | Tipo | Valor por defecto | Descripción | | ------------------------------ | --------------- | ----------------------------------------------------- | ---------------------------------------- | ------------------------------------------------ | | `--cargar ` | ninguno | `string` | ninguno | Carga datos base desde un archivo JSON | | `--monto ` | `-m` | `number` | requerido | Importe total del comprobante | | `--alicuota ` | ninguno | `'0' \| '2.5' \| '5' \| '10.5' \| '21' \| '27'` | `config.alicuota` o `21` | Alícuota de IVA (solo `A` y `B`) | | `--alicuota :` | ninguno | repetible | ninguno | Varias alícuotas: monto con IVA de cada una | | `--exento ` | ninguno | `number` | `0` | Parte exenta del monto (solo `A` y `B`) | | `--nogravado ` | ninguno | `number` | `0` | Parte no gravada del monto (solo `A` y `B`) | | `--fecha ` | `-f` | `string` | hoy | Fecha del comprobante | | `--dia ` | `-d` | `integer` | ninguno | Deprecado: usá `--vencimiento` o `--vto` | | `--punto-venta ` | `--pv` | `integer` | `config.puntoVenta` | Punto de venta | | `--concepto ` | `-c` | `'productos' \| 'servicios' \| 'productos-servicios'` | `config.concepto` | `productos`, `servicios` o `productos-servicios` | | `--cs` | ninguno | `boolean` | `false` | Equivale a `--concepto servicios` | | `--cp` | ninguno | `boolean` | `false` | Equivale a `--concepto productos` | | `--csp` | ninguno | `boolean` | `false` | Equivale a `--concepto productos-servicios` | | `--moneda ` | `--mda` | `string(3)` | `config.moneda` o `ARS` | Moneda del comprobante: ISO o código de ARCA | | `--cotizacion-moneda ` | `--cm` | `number` | oficial de ARCA | Cotización de la moneda | | `--misma-moneda` | ninguno | `boolean` | `false` | El pago se cancela en la moneda extranjera | | `--servicio-desde ` | `--sd ` | `string` | ninguno | Fecha de inicio del servicio | | `--servicio-hasta ` | `--sh ` | `string` | ninguno | Fecha de fin del servicio | | `--vencimiento ` | `--vto ` | `string` | fin del servicio o fecha del comprobante | Vencimiento del pago (`FchVtoPago`) | En moneda extranjera (`--moneda USD`) hay dos formas de informar la cotización: - **Te pagan en pesos** (default): pasá `--cotizacion-moneda` con la cotización acordada. Sin ella, ARCLI usa la oficial de ARCA y lo avisa en "Avisos". No puede ser `1`. - **Te pagan en la moneda extranjera**: pasá `--misma-moneda`. ARCLI consulta la cotización oficial a ARCA y la muestra en la vista previa. No se combina con `--cotizacion-moneda`. En pesos la cotización siempre es `1` y `--misma-moneda` no aplica. Detalle en [Moneda y cotización](validation-rules.md#moneda-y-cotización). `--moneda` acepta el código ISO o el de ARCA, en mayúsculas o minúsculas: `ARS` y `PES` son lo mismo, como `USD` y `DOL`, `EUR` y `060` o `UYU` y `011`. ARCLI traduce el ISO al código de ARCA antes de enviar y la vista previa muestra el nombre con el ISO (`Pesos uruguayos (UYU)`). Están todas las monedas de la tabla de ARCA (`arcli parametros monedas`) que tienen código ISO; un código que no está en esa tabla se manda tal cual y lo rechaza ARCA si no existe. Lo mismo vale para `codigoMoneda` en el JSON y la clave `moneda` de la config. `--alicuota` acepta alias: `general` (21), `reducida` (10.5), `incrementada` (27) y `cero` (0). Para una factura con ítems a distintas alícuotas, repetí `--alicuota TASA:MONTO` (por ejemplo `--alicuota general:1210 --alicuota reducida:552,50`); el total se calcula solo. Ver [Varias alícuotas](validation-rules.md#varias-alícuotas-en-un-comprobante). `--monto` siempre es el total del comprobante. Si informás `--exento` o `--nogravado`, ARCLI los descuenta del total y calcula neto e IVA sobre el resto. Ejemplo: `fb -m 1196 --exento 50 --nogravado 25` da neto 926,45 e IVA 194,55. El flag es `--nogravado`, sin guion, porque el CLI interpreta cualquier `--no-*` como la negación de otro flag. Los montos usan formato argentino: el punto separa miles y la coma separa decimales. `15000`, `15.000`, `1500,50` y `1.500,50` son válidos; `1500.50` da error, igual que el texto sobrante (`12abc`) y más de 2 decimales. La cotización acepta hasta 6. Vale para `--monto`, `--exento`, `--nogravado`, `--cotizacion-moneda` y el monto de `--alicuota TASA:MONTO`. En el JSON de `--cargar` los montos son números, también con 2 decimales como máximo (la cotización, 6). #### Las fechas de un comprobante Un comprobante puede llevar hasta cuatro fechas, y cada una responde a una pregunta distinta: | Fecha | Flag | Responde | Sin el flag | | ------------------------ | ---------------------------------------------------- | ------------------------------ | ----------------------------------------------- | | Del comprobante | `-f`, `--fecha` | ¿Qué día se emite? | hoy | | Período del servicio | `--sd`/`--servicio-desde`, `--sh`/`--servicio-hasta` | ¿Qué período cubre la factura? | la fecha del comprobante | | Vencimiento | `--vto`, `--vencimiento` | ¿Cuándo vence el pago? | el fin del servicio, o la fecha del comprobante | | Período asociado (notas) | `--pd`/`--periodo-desde`, `--ph`/`--periodo-hasta` | ¿Qué facturas ajusta la nota? | no va: se usa el comprobante asociado (`--ac`…) | - `--servicio-*` y `--vencimiento` son de facturas (y notas) de servicios. `--periodo-*` es solo de notas: en lugar de ajustar una factura puntual, ajustan todo lo facturado en ese período. - `--dia` está deprecado: usá `--vencimiento` o `--vto`. Ejemplos: ```bash # Servicio de octubre, facturado hoy, que vence el 10/11 arcli fc -m 1000 --cs --cfinal --sd 1/10 --sh 31/10 --vto 10/11 # Nota de crédito por un descuento sobre todo lo facturado en octubre de 2026 arcli ncc -m 500 --cs --cfinal --pd 1/10/2026 --ph 31/10/2026 ``` Para facturar con otra fecha, sumá `-f`: por ejemplo, `-f 31/10` el 3/11 (en servicios, hasta 10 días antes o después de hoy). Las cuatro se escriben igual: formato argentino (día primero), con mes y año opcionales; sin año se toma la fecha más cercana a hoy. Detalle completo en [Fechas aceptadas](validation-rules.md#fechas-aceptadas). ### Asociados Estos flags importan solo para notas. Si estás emitiendo una factura, podés ignorarlos. Dicho más directo: **no aplican a `factura`, `factura-credito-electronica`, `recibo`, `fa`, `fb`, `fc`, `fcea`, `fceb`, `fcec` ni `rc`**. | Flag | Alias | Tipo | Valor por defecto | Descripción | | --------------------------------- | ---------------- | ------------ | ----------------- | ---------------------------------- | | `--ac ` | ninguno | `string` | ninguno | Atajo del comprobante asociado | | `--at ` | ninguno | `integer` | ninguno | Tipo ARCA del comprobante asociado | | `--asociado-punto-venta ` | `--apv ` | `integer` | ninguno | Punto de venta del asociado | | `--ar ` | ninguno | `integer` | ninguno | Número del comprobante asociado | | `--acuit ` | ninguno | `string(11)` | ninguno | CUIT del comprobante asociado | | `--afecha ` | ninguno | `string` | ninguno | Fecha del comprobante asociado | | `--periodo-desde ` | `--pd ` | `string` | ninguno | Inicio del período asociado | | `--periodo-hasta ` | `--ph ` | `string` | ninguno | Fin del período asociado | ### Crédito electrónico (FCE) Estos flags solo aplican a comprobantes de crédito electrónica. En cualquier otro comprobante dan error, porque ARCA los rechaza (10169). | Flag | Alias | Tipo | Valor por defecto | Aplica a | Descripción | | ----------------------------- | ------- | ---------------- | ----------------- | ----------- | ----------------------------------- | | `--cbu ` | ninguno | `string(22)` | `config.cbu` | Factura FCE | CBU del emisor (obligatorio) | | `--alias ` | ninguno | `string(6..20)` | `config.aliasCbu` | Factura FCE | Alias del CBU (opcional) | | `--transferencia ` | ninguno | `'sca' \| 'adc'` | `sca` | Factura FCE | Modalidad de transferencia | | `--anulacion` | ninguno | `boolean` | `false` | NC/ND FCE | La nota anula una factura rechazada | ### PDF Estos flags controlan el PDF del comprobante emitido. Los datos que se pasan acá **solo van en el PDF**: ARCA no los recibe. Detalle en [PDF de comprobantes](pdf.md). | Flag | Alias | Tipo | Valor por defecto | Descripción | | ------------------------------ | ------- | --------- | ----------------------- | -------------------------------------------- | | `--exportar-pdf` | `--pdf` | `boolean` | según `config.pdf` | Genera el PDF después de emitir | | `--sin-pdf` | ninguno | `boolean` | según `config.pdf` | No genera el PDF | | `--descripcion ` | ninguno | `string` | `Según detalle` | Detalle del comprobante en el PDF | | `--condicion-venta ` | `--cv` | `string` | `config.condicionVenta` | Condición de venta en el PDF | | `--sin-condicion-venta` | ninguno | `boolean` | ninguno | Omite la condición aunque esté configurada | | `--receptor-nombre ` | ninguno | `string` | ninguno | Nombre o razón social del receptor en el PDF | | `--receptor-domicilio ` | ninguno | `string` | ninguno | Domicilio del receptor en el PDF | `--condicion-venta` acepta `contado`, `tarjeta-debito`, `tarjeta-credito`, `cuenta-corriente`, `cheque`, `transferencia`, `otros-medios-electronicos` u `otra`, que se imprimen con su nombre (`cuenta-corriente` sale "Cuenta Corriente"). Cualquier otro texto se imprime tal cual: `--cv "Billetera virtual"`. `--sin-condicion-venta` permite omitirla en un comprobante aunque exista un valor en la config; no se combina con `--condicion-venta` ni `--cv`. Solo en A, B y C; en la factura `E` va `--forma-pago`, que sí viaja a ARCA. `--exportar-pdf` y `--sin-pdf` no se combinan. Sin ninguno de los dos, si confirmás la emisión a mano lo decide la opción que elijas (**Sí, emitir ahora** o **Sí, emitir y generar el PDF**); si se emite sin confirmar, decide `config.pdf` (`preguntar` por defecto: en una terminal pregunta después de emitir, con `--json` o sin terminal no genera). ### Comando `arcli pdf` Instala o revisa el plugin que genera los PDFs. No viene con ARCLI porque pesa unos 160 MB. | Comando | Descripción | | ----------------------- | ------------------------------------------------------ | | `arcli pdf` | Estado del plugin: instalado o no, versión y navegador | | `arcli pdf estado` | Igual que `arcli pdf` | | `arcli pdf instalar` | Descarga el plugin (y un navegador si no hay Chrome) | | `arcli pdf desinstalar` | Borra el plugin y el navegador que haya descargado | Todos aceptan `--json`. El formato está en [Entrada y salida](input-output.md#plugin-de-pdf-pdf-estado). ### Comando `arcli certificado` Arma el pedido del certificado de ARCA y carga el certificado que te devuelve, sin `openssl`. Los pasos en ARCA, con capturas, están en [Cómo obtener los certificados](obtencion-certificados.md). | Comando | Descripción | | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | `arcli certificado generar [--testing\|--produccion] [--alias ]` | Crea la clave privada y el CSR para subir a ARCA, y muestra los pasos del entorno | | `arcli certificado importar [--testing\|--produccion]` | Valida el `.crt` que bajaste de ARCA, lo guarda y configura `cert.` y `key.` | - Los archivos van a `certificados//`, junto al archivo de config: `.key` (permisos `0600`), `.crt` y `.csr`. - `generar` usa el entorno de `--testing`/`--produccion` o, sin flag, el de la config. `--alias` es el nombre del certificado en ARCA (por defecto `arcli`). - **Renovar sin cortar la facturación:** `generar` deja la clave nueva como pendiente (`.nueva.key`) y no toca la activa: seguís facturando con el certificado actual hasta que `importar` valida el nuevo. Recién ahí la pendiente pasa a ser la activa, y el par anterior queda como `.anterior.*`. Si ya hay un pedido pendiente, `generar` frena; `--reemplazar` lo descarta y arma otro. - `importar` saca el entorno del certificado (ARCA firma los de testing con "Computadores Test" y los de producción con "Computadores"). Antes de tocar nada valida que sea un certificado, que sea de tu CUIT, que no esté vencido y que corresponda a la clave del pedido. Acepta archivos con BOM o finales de línea de Windows. Al terminar, dice qué cargó: entorno, CUIT, alias y vencimiento. - Si ya había otro certificado configurado para ese entorno, `importar` pregunta antes de reemplazarlo; sin terminal o con `--json`, hace falta `--reemplazar`. - Las rutas configuradas a mano con `arcli config establecer cert.*`/`key.*` siguen andando igual: `importar` solo las cambia al cargar un certificado nuevo. - En la terminal, el título va con el color del entorno y la carpeta, el CSR y la clave son links: con un clic se abren (en terminales que los soportan, como la de VS Code, iTerm2 o Windows Terminal; `FORCE_HYPERLINK=0` los apaga). - Los dos aceptan `--json`. El formato está en [Entrada y salida](input-output.md#certificados-certificado). ### Comandos `arcli estado` y `arcli parametros` Consultan a ARCA sin emitir nada. Usan el entorno y el punto de venta de la config (o `--testing` / `--produccion`) y aceptan `--json`. | Comando | Descripción | | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | `arcli estado` | Si los servidores de ARCA responden, cuánto tardan y si el punto de venta está habilitado | | `arcli parametros` | Lista las tablas disponibles (no consulta ARCA) | | `arcli parametros ` | `puntos-venta`, `comprobantes`, `documentos`, `alicuotas`, `iva-receptor`, `monedas`, `conceptos`, `opcionales` o `tributos` | | `arcli parametros cotizacion ` | Cotización oficial de ARCA, por ejemplo `USD` | - Las tablas muestran solo los valores vigentes hoy, salvo `puntos-venta`, que también lista los bloqueados o dados de baja, con su estado. - En texto, cada tabla tiene una fila de encabezado (`CÓDIGO`, o `NÚMERO` en `puntos-venta`, la descripción y, en `iva-receptor` y `puntos-venta`, una tercera columna) y al pie para qué sirve el código en ARCLI, por ejemplo que `--moneda` acepta el código o el ISO. El `--json` no cambia. - **Puntos de venta en testing:** ARCA no los informa, así que `parametros puntos-venta` sale vacío y `estado` no puede verificar el punto de venta. En testing cualquier número sirve. - En producción, `estado` avisa si el punto de venta configurado no existe para tu CUIT, está bloqueado o dado de baja. - `estado` con `listo: false` sale con exit code `0`: es un diagnóstico, no un error. Si ARCA no responde, el error es `ARCA_UNAVAILABLE`. - El JSON de cada uno está en [Entrada y salida](input-output.md#estado-de-arca-estado) y [tablas de ARCA](input-output.md#tablas-de-arca-parametros). ## Parámetros por familia de comprobantes Acá está la parte más práctica del documento: qué necesitás para emitir cada familia y qué cambia entre una y otra. ### Facturas `A`, `B` y `C` Las facturas comparten la misma base. #### Qué necesitás para emitir este comprobante **Obligatorio** - monto: `--monto` - concepto: `--concepto`, `--cs`, `--cp` o `--csp` - IVA del receptor: `--iva-receptor`, `--ir` o un solo `--ir-*` (con `--cuit` se puede omitir: sale del padrón) **Opcional** - identidad del receptor: `--cuit`, `--cuil`, `--dni`, `--consumidor-final` o `--cfinal`. Sin ninguna, es consumidor final (documento 0) - punto de venta si no está en config: `--punto-venta` o `--pv` - fecha del comprobante: `--fecha` - moneda y cotización: `--moneda`, `--mda`, `--cotizacion-moneda`, `--cm`, `--misma-moneda` - carga JSON: `--cargar` - fechas de servicio y vencimiento: `--servicio-desde`, `--servicio-hasta`, `--vencimiento` (y `--dia`, deprecado) - modo de ejecución: `--previsualizar`, `--emitir` - salida: `--json`, `--bruto` #### Ejemplo mínimo funcional Factura C simple: ```bash arcli fc -m 300000 --cs --consumidor-final ``` Factura A con CUIT: ```bash arcli fa -m 1 --cs --cuit 20168598204 --ir-ri ``` #### Resumen rápido de parámetros | Parámetro | Alias | Tipo | Requerido | Cuándo usarlo | | ------------------------------------------------------------------------------- | --------------- | ----------------------------------------------------- | ----------- | --------------------------------------------------------- | | `--monto ` | `-m` | `number` | Sí | Siempre | | `--concepto ` | `-c` | `'productos' \| 'servicios' \| 'productos-servicios'` | Sí | Siempre | | `--cs`, `--cp`, `--csp` | ninguno | `boolean` | Condicional | Si preferís el atajo en lugar de `--concepto` | | `--cuit ` / `--cuil ` / `--dni ` / `--consumidor-final` | `--cfinal` | `string` / `boolean` | No | Sin ninguna, consumidor final; una sola identidad | | `--iva-receptor ` / `--ir ` / `--ir-*` | ninguno | unión de IVA receptor o `boolean` | Sí | Una sola forma; con `--cuit`, sin el flag sale del padrón | | `--punto-venta ` | `--pv ` | `integer` | Condicional | Si no está en config | | `--fecha ` | `-f` | `string` | No | Si querés fijar una fecha específica | | `--dia ` | `-d` | `integer` | No | Deprecado: usá `--vencimiento` o `--vto` | | `--servicio-desde ` | `--sd ` | `string` | Condicional | Si el concepto usa servicio | | `--servicio-hasta ` | `--sh ` | `string` | Condicional | Si el concepto usa servicio | | `--vencimiento ` | `--vto ` | `string` | No | Servicios y facturas FCE | #### Qué no aplica Las facturas no usan comprobante asociado, así que no aplican: - `--ac` - `--at` - `--apv` - `--asociado-punto-venta` - `--ar` - `--acuit` ### Recibo C `arcli rc` (o `arcli recibo c`) emite el Recibo C, tipo ARCA 15. Usa los mismos flags y validaciones que la Factura C: sin IVA discriminado, sin comprobante asociado y sin FCE. Una nota de crédito o débito C lo puede asociar con `--ac rc`. Detalle en [Reglas de validación](validation-rules.md#recibo-c). ```bash arcli rc -m 15000 --cs --cfinal ``` ### Notas de crédito y débito `A`, `B` y `C` Las notas heredan todo lo de una factura, pero suman una regla importante: **siempre requieren un comprobante asociado o un período asociado**. #### Diferencias clave con facturas - siempre requieren asociado: una factura puntual (`--ac`…) o un período (`--periodo-desde` y `--periodo-hasta`) - el asociado debe ser una factura compatible o, en notas C, un Recibo C (`--ac rc`) - la letra del asociado debe coincidir con la de la nota - `--ac` y `--at` son excluyentes #### Qué necesitás para emitir este comprobante **Obligatorio** - todo lo base de una factura - además: - un comprobante asociado: `--ac` o `--at`, con `--asociado-punto-venta` (o `--apv`), `--ar` y `--acuit` - o un período asociado: `--periodo-desde` y `--periodo-hasta` (entonces no van `--ac`, `--apv`, `--ar` ni `--acuit`) **Opcional** - el resto de flags base de facturas #### Ejemplo mínimo funcional ```bash arcli nca -m 1 --cs --cuit 20168598204 --ir-ri --ac fa --apv 3 --ar 6 --acuit 20333333334 ``` #### Nota por período Si la nota ajusta un período entero y no una factura puntual (por ejemplo, un descuento sobre todo lo facturado en el mes), usá el período en lugar del bloque `--ac`: ```bash arcli ncb -m 5000 --cs --cfinal --periodo-desde 01-09-2026 --periodo-hasta 30-09-2026 ``` El período no puede terminar después de la fecha de la nota. Las notas FCE no lo aceptan. #### Resumen rápido de parámetros asociados | Parámetro | Alias | Tipo | Requerido | Cuándo usarlo | | --------------------------------- | ---------------- | ------------ | ----------- | ------------------------------------------------------------------- | | `--ac ` | ninguno | `string` | Condicional | Si querés identificar el asociado por shortcut | | `--at ` | ninguno | `integer` | Condicional | Si querés identificar el asociado por tipo ARCA | | `--asociado-punto-venta ` | `--apv ` | `integer` | Condicional | Con `--ac`/`--at` | | `--ar ` | ninguno | `integer` | Condicional | Con `--ac`/`--at` | | `--acuit ` | ninguno | `string(11)` | Condicional | Con `--ac`/`--at`; no con período; en NC/ND FCE toma el CUIT emisor | ### Factura de crédito electrónica `A`, `B` y `C` La base es la de una factura común, más los datos de cobro que exige el régimen MiPyMEs. #### Qué cambia respecto a una factura común - cambia el tipo ARCA - no usa comprobante asociado - lleva el CBU del emisor y la modalidad de transferencia - siempre lleva vencimiento de pago, incluso con concepto productos - la fecha del comprobante puede ir de 5 días antes a 1 día después de hoy #### Qué necesitás para emitir este comprobante **Obligatorio** - lo mismo que en una factura común - CBU: `--cbu`, o configurado una vez con `arcli config establecer cbu <22 dígitos>` **Opcional** - `--alias`, `--transferencia` (por defecto `sca`) y `--vencimiento` #### Ejemplo mínimo funcional ```bash arcli fcea -m 1 --cs --cuit 20168598204 --ir-ri --cbu 0110599520000012345678 ``` ### Nota de crédito electrónica y nota de débito electrónica `A`, `B` y `C` Acá se combinan las dos reglas anteriores: - base de factura - tipo ARCA electrónico - comprobante asociado obligatorio, con su fecha #### Qué necesitás para emitir este comprobante **Obligatorio** - todo lo base de una factura - bloque de asociado: `--ac` o `--at`, `--apv` y `--ar` - el asociado tiene que ser del propio emisor: `--acuit` se puede omitir y toma el CUIT configurado **Opcional** - `--afecha`: sin ella, arcli consulta el asociado en ARCA y toma su fecha; la vista previa ya la muestra - `--anulacion` si la nota anula una factura que el comprador rechazó No llevan CBU, alias, transferencia ni vencimiento de pago. #### Ejemplo mínimo funcional ```bash arcli ncea -m 1 --cs --cuit 20168598204 --ir-ri --ac fcea --apv 3 --ar 6 ``` ### Factura de exportación `E` (WSFEX) `arcli fe` y `arcli factura e` hacen lo mismo: emiten o previsualizan una Factura de exportación `E` con el servicio `wsfex`, que tiene sus propios datos y su propio certificado autorizado. No es una letra más de la familia de facturas: no lleva concepto, IVA ni receptor con CUIT/CUIL/DNI, y en cambio lleva país de destino, incoterm, permisos de embarque e ítems reales. Las notas de crédito y débito `E` tienen su propia sección: [Notas de crédito y débito de exportación](#notas-de-crédito-y-débito-de-exportación-e). #### Credenciales WSFEX pide un certificado autorizado al servicio `wsfex`. ARCLI usa `exportacion.cert.` y `exportacion.key.` si están configurados; si no, cae en `cert.` y `key.`. El par se resuelve junto: si configurás solo una de las dos claves de exportación, el comando corta antes de ir a ARCA. Ver [Configuración](configuration.md#certificados-de-exportación-wsfex). #### Qué necesitás para emitir este comprobante **Obligatorio** - importe total: `--monto` - cliente y domicilio en el exterior: `--cliente`, `--domicilio-cliente` - país de destino: `--pais-destino`, por código (`203`) o por nombre (`Brasil`) - actividad: `--actividad` o la clave `exportacion.actividad` de la config, con un código de la tabla de actividades de WSFEX **Opcional** - `--id-impositivo` y `--cuit-pais` (sin `--cuit-pais` se resuelve desde el país de destino; si ARCA no publica un CUIT para ese país, el flag es obligatorio) - `--tipo-expo` (`1` bienes, `2` servicios, `4` otros; por defecto `2`) - `--item` para el detalle real; sin ítems va un renglón con `--descripcion` - `--incoterm` y `--incoterms-desc`, `--idioma`, `--forma-pago` (por defecto `Transferencia Internacional`) - `--permiso` y `--permiso-existente` para permisos de embarque (solo con `--tipo-expo 1`; en `2` y `4` ARCA exige `Permiso_existente` vacío) - `--numero` y `--id-solicitud` si los querés fijar a mano (por defecto, los siguientes de WSFEX) - punto de venta si no está en config: `--punto-venta` o `--pv` - moneda y cotización: `--moneda` (por defecto `DOL`), `--mda`, `--cotizacion-moneda`, `--cm`, `--misma-moneda` - PDF: `--exportar-pdf`, `--pdf` o `--sin-pdf` - modo y salida: `--previsualizar`, `--emitir`, `--json`, `--bruto` Sin `--tipo-expo`, `--moneda` ni `--forma-pago`, la `E` sale de servicios (`Tipo_expo` `2`), en dólares (`DOL`) y con forma de pago `Transferencia Internacional`. Las claves `moneda` y `cotizacion` de la config son de los comprobantes locales y no aplican a exportación. La actividad no tiene default: cada emisor tiene la suya. La tabla de actividades de WSFEX (`FEXGetPARAM_Actividades`) no es la del padrón y es más chica (por ejemplo, `620900` no está y `620100` sí), así que un código que no está es error de validación antes de ir a ARCA, con las actividades que empiezan igual. El pago de una exportación se hace en la moneda extranjera del comprobante (`Moneda_Id`/`Moneda_ctz`). Si además se cobra en esa misma moneda, `--misma-moneda` manda `CanMisMonExt` en `S`, que es el campo de WSFEX que lo declara; sin el flag va en `N`. La factura `E` no lleva comprobantes asociados ni datos opcionales, así que `solicitud` no incluye `Cmps_asoc` ni `Opcionales`: ARCA rechaza esos bloques vacíos (error 1820 el primero) y no acepta asociados en la factura (error 1755). #### Ejemplo mínimo funcional ```bash arcli fe --monto 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 203 \ --numero 1 --actividad 620100 ``` Con los datos del receptor del exterior (CUIT del país, ID impositivo, razón social y domicilio), ítems, incoterm y salida JSON: ```bash arcli fe -m 1500 --cliente "ACME LLC" --id-impositivo "12-3456789" --domicilio-cliente "123 Main St" \ --pais-destino 212 --cuit-pais 55000002126 --tipo-expo 1 --incoterm FOB --numero 2 --actividad 620100 \ --item "001|Bienes varios|1|1500|unidad" --emitir --json ``` Cobrando en dólares, con la cotización de aduana de ARCA (sin `--cm`) y el pago en la misma moneda (`--misma-moneda`): ```bash arcli fe -m 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 212 \ --numero 3 --actividad 620100 --misma-moneda --previsualizar ``` #### Resumen rápido de parámetros | Parámetro | Alias | Tipo | Requerido | Cuándo usarlo | | --------------------------------- | --------------- | ------------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------- | | `--monto ` | `-m` | `number` | Sí | Siempre | | `--cliente ` | ninguno | `string` | Sí | Siempre: nombre o razón social del cliente del exterior | | `--domicilio-cliente ` | ninguno | `string` | Sí | Siempre | | `--pais-destino ` | ninguno | `string` | Sí | Siempre: código de ARCA o nombre tal como lo informa ARCA | | `--id-impositivo ` | ninguno | `string` | No | ID fiscal del cliente en su país | | `--cuit-pais ` | ninguno | `integer` | No | CUIT del país del cliente; sin el flag sale de la tabla de ARCA | | `--tipo-expo <1\|2\|4>` | ninguno | `1` bienes, `2` servicios, `4` otros | No | Por defecto `2` (servicios) | | `--actividad ` | ninguno | `integer` | Condicional | Si no está `exportacion.actividad` en la config; código de la tabla de WSFEX | | `--item ` | ninguno | `string` repetible | No | `codigo\|descripcion\|cantidad\|precio\|unidad`; la suma debe dar `--monto` | | `--incoterm ` | ninguno | `string` | No | Por ejemplo `FOB`; se valida contra la tabla de ARCA | | `--incoterms-desc ` | ninguno | `string` | No | Por defecto, la descripción de la tabla de ARCA | | `--idioma ` | ninguno | `integer` | No | `1` español (por defecto), `2` inglés, `3` portugués | | `--forma-pago ` | ninguno | `string` | No | Por defecto `Transferencia Internacional` | | `--permiso ` | ninguno | `string` repetible | No | Permiso de embarque ya existente; solo con `--tipo-expo 1`. En la factura requiere `--permiso-existente` | | `--permiso-existente` | ninguno | `boolean` | No | Marca que los permisos informados ya están en ARCA | | `--numero ` | ninguno | `integer` | No | Por defecto, el siguiente al último de ese tipo en el punto de venta | | `--id-solicitud ` | ninguno | `integer` | No | Por defecto, el siguiente de WSFEX | | `--punto-venta ` | `--pv ` | `integer` | Condicional | Si no está en config | | `--fecha ` | `-f` | `string` | No | No admite fechas futuras | | `--fecha-pago ` | ninguno | `string` | No | Por defecto, la fecha del comprobante | | `--moneda ` | `--mda` | `string` | No | Código ISO o de ARCA, por ejemplo `USD` o `DOL`; por defecto `DOL` | | `--cotizacion-moneda ` | `--cm` | `number` | No | Sin flag se usa la última cotización de aduana publicada por ARCA | | `--misma-moneda` | ninguno | `boolean` | No | El pago se cancela en la misma moneda extranjera: manda `CanMisMonExt` en `S` | | `--observaciones ` | ninguno | `string` | No | Observaciones del comprobante | | `--obs-comerciales ` | ninguno | `string` | No | Observaciones comerciales | | `--descripcion ` | ninguno | `string` | No | Solo sin `--item`; también va al PDF | | `--cargar ` | ninguno | `string` | No | Un objeto con un comprobante, no un lote | Los flags globales (`--testing`, `--produccion`, `--json`, `--bruto`) y los de modo (`--previsualizar`, `--emitir`) funcionan igual que en el resto de los comprobantes. #### Ítems Cada `--item` se separa con `|` para no pelear con las comas de los importes. La forma completa es `codigo|descripcion|cantidad|precio|unidad`; con cuatro partes se omite el código y con tres la unidad, que queda en `unidad` (código `7` de ARCA). La unidad puede ser el código numérico o el nombre de la tabla de unidades, que se compara sin mayúsculas y acepta singular o plural (`unidad` o `unidades`). ```bash arcli fe -m 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 203 \ --numero 4 --actividad 620100 --item "001|Servicio de consultoría|1|1000|unidad" \ --item "002|Soporte|2|250|unidades" --previsualizar ``` WSFEX no valida que `Imp_total` coincida con la suma de los ítems, así que ARCLI lo valida antes de ir a ARCA: si la suma no da `--monto`, el comando corta con un error de validación. #### Qué no aplica Estos flags de facturación no existen en `fe`, que los rechaza como opción desconocida. `arcli factura e` comparte el comando con A, B y C, así que los acepta pero los saltea con un aviso en "Avisos" (y en `avisos` del JSON); lo mismo pasa al revés con los flags de la `E` en `arcli factura a`, `b` o `c`: - concepto (`--concepto`, `--cs`, `--cp`, `--csp`) y fechas de servicio (`--servicio-desde`, `--servicio-hasta`, `--vencimiento` y `--dia`, deprecado) - identidad del receptor (`--cuit`, `--cuil`, `--dni`, `--consumidor-final`) e `--iva-receptor` - IVA y alícuotas (`--alicuota`, `--exento`, `--nogravado`; tampoco `alicuotas` en el JSON) - comprobante asociado (`--ac`, `--at`, `--apv`, `--ar`, `--acuit`, `--afecha`, `--anulacion`, `--periodo-desde`, `--periodo-hasta`) - datos de cobro FCE (`--cbu`, `--alias`, `--transferencia`); el régimen FCE (`verificarFce` en la config) tampoco se consulta Los defaults de config de esos campos (concepto, IVA receptor, alícuota, CBU) no se usan al emitir una `E`. #### Vista previa, numeración y PDF - La vista previa consulta las tablas de WSFEX (países, monedas, unidades, incoterms, idiomas, actividades), la cotización y el ID de la solicitud, pero no emite. - WSFEX numera por punto de venta y tipo de comprobante. Sin `--numero`, ARCLI consulta el último (`FEXGetLast_CMP`) y usa el siguiente, también en la vista previa; si pasás otro, ARCA rechaza el comprobante. El ID de la solicitud también se consulta (`FEXGetLast_ID`). Fijá los dos con `--numero` e `--id-solicitud` si emitís en paralelo. - El PDF se genera después de emitir, como en el resto de los comprobantes. Se guarda como `factura-e_-.pdf` y usa el diseño de exportación: ítems reales, país de destino, CUIT del país, ID impositivo, divisa, forma y fecha de pago, incoterm y la leyenda de IVA exento. Ver [PDF](pdf.md#factura-de-exportación-e). - Un comprobante rechazado por WSFEX sale como respuesta válida con exit code `2`, igual que en las letras A, B y C. El JSON de salida y el de `--cargar` están en [Entrada y salida](input-output.md#factura-de-exportación-e). ### Notas de crédito y débito de exportación `E` `arcli nce` (`nota-credito e`, tipo ARCA `21`) y `arcli nde` (`nota-debito e`, tipo `20`) ajustan una Factura de exportación `E` ya emitida por WSFEX. Usan el mismo servicio, credenciales y flags que `fe`, más el comprobante asociado. Antes de armar la nota, ARCLI consulta el asociado en ARCA (`FEXGetCMP`) y toma de ahí lo que no venga por flag: cliente, domicilio, ID impositivo, país de destino, CUIT del país, tipo de exportación, moneda y cotización, idioma, incoterm, forma de pago y actividad. Por eso alcanza con el monto, el asociado y el número: ```bash arcli nce -m 500 --ar 1 --numero 1 ``` #### Comprobante asociado | Parámetro | Alias | Tipo | Requerido | Cuándo usarlo | | ------------------ | --------------------------------- | --------- | --------- | ----------------------------------------------------------------------------- | | `--ar ` | ninguno | `integer` | Sí | Número del comprobante que ajusta la nota | | `--apv ` | `--asociado-punto-venta ` | `integer` | No | Punto de venta del asociado; por defecto, el de la nota | | `--ac ` | ninguno | `string` | No | `fe` (por defecto), `nde` o `nce`, para ajustar otra nota `E` | | `--at ` | ninguno | `integer` | No | Lo mismo por tipo ARCA: `19`, `20` o `21` | | `--acuit ` | ninguno | `string` | No | No hace falta: el asociado de una `E` siempre es del CUIT emisor (error 2031) | `--afecha` no se usa: la fecha del asociado sale de ARCA. #### Qué valida antes de emitir - que el asociado exista en ARCA y esté aprobado; - que la nota no sea anterior al asociado; - que una nota de crédito no supere el total del asociado, si van en la misma moneda; - en servicios (`--tipo-expo 2`), lo que ARCA compara contra el asociado: mismo tipo de exportación (2049), mismo país de destino (2050), misma moneda o pesos (2051) y la misma cotización (2053). Además, una nota de débito solo ajusta una factura (2041, 2042) y una nota de crédito, una factura o una nota de débito (2045). #### Qué no aplica Las notas `E` no llevan fecha de pago (ARCA la rechaza, error 1673), `--misma-moneda` (1605) ni `--permiso-existente` (`Permiso_existente` va vacío, 1550): `nce` y `nde` no tienen esos flags. En las de bienes (`--tipo-expo 1`), los permisos de embarque son opcionales y van con `--permiso`, sin `--permiso-existente`. En `arcli nota-credito e` y `nota-debito e` los flags de A, B y C se saltean con un aviso, igual que en `factura e`. #### Ejemplos ```bash arcli nde -m 200 --ar 1 --apv 4 --numero 1 --item "001|Ajuste de precio|1|200|unidades" --previsualizar arcli nce -m 100 --ac nde --ar 1 --numero 2 --emitir --json ``` El PDF se guarda como `nota-credito-e_-.pdf` o `nota-debito-e_-.pdf`, con el comprobante asociado. ## Ejemplos útiles ### `arcli ejemplos` Muestra ejemplos seguros y listos para copiar de todos los comprobantes soportados. ```bash arcli ejemplos ``` La salida incluye versión mínima, versión completa, forma larga y forma corta para cada comprobante. Todos usan `--previsualizar` para evitar emisiones reales por error. ### Básico (manual) ```bash arcli fc -m 300000 --cs --consumidor-final ``` ### Desde JSON ```bash arcli fc --cargar ./voucher.json --json ``` ### Usando config Si ya guardaste `cuit`, `puntoVenta`, `concepto` e `ivaReceptor` en config: ```bash arcli config establecer concepto servicios arcli config establecer ivaReceptor consumidor-final arcli fc -m 300000 ``` ### Debug ```bash arcli fa -m 1 --cs --cuit 20168598204 --ir-ri --emitir --json --bruto ``` ## Consultar comprobantes emitidos Dos comandos de solo lectura para ver lo que ya está emitido en ARCA, sin abrir el modo interactivo: ```bash arcli ultimos fb # últimas 15 facturas B del punto de venta configurado arcli ultimos nca --cantidad 25 # últimas 25 notas de crédito A arcli consultar fb 14 # detalle de la factura B número 14 arcli consultar fb 14 --json # lo mismo, en JSON ``` | Comando | Argumentos | Flags | | --------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `arcli ultimos ` | `tipo`: atajo del comprobante (`fa`, `fb`, `nca`, `fcea`…) | `--cantidad ` (1 a 50; por defecto `config.filasPorLista` o 15), `--pv` / `--punto-venta`, `--json`, `--testing`, `--produccion` | | `arcli consultar ` | `tipo` y número del comprobante | `--pv` / `--punto-venta`, `--json`, `--testing`, `--produccion` | Sin `--pv` usan el punto de venta de la config. Aceptan también la `E` (`fe`, `nde`, `nce`), que se consulta en WSFEX con su certificado. Si el comprobante no existe, `consultar` termina con el error `VOUCHER_NOT_FOUND`. El formato del JSON está en [Entrada y salida](input-output.md#comprobantes-emitidos-ultimos-y-consultar). ## Consultar el régimen FCE `arcli fce-obligado ` le pregunta a ARCA si un receptor está obligado a recibir Factura de Crédito Electrónica y desde qué monto. Con eso sabés si corresponde `fa/fb/fc` o `fcea/fceb/fcec`. ```bash arcli fce-obligado 30546689979 arcli fce-obligado 30546689979 --fecha 15/10 --json ``` | Flag | Alias | Descripción | | ------------------------------------- | ------- | --------------------------------------------- | | `--fecha ` | `-f` | Fecha de emisión a consultar; por defecto hoy | | `--json`, `--testing`, `--produccion` | ninguno | Flags globales | Usa el servicio `wsfecred`, que hay que autorizar aparte de `wsfe`. Ver [Autorizar el servicio web](certificado-testing-completa.md#3-autorizar-el-servicio-web). Si activás `arcli config establecer verificarFce true`, la misma consulta corre en cada factura con CUIT del receptor y deja un aviso si el comprobante no coincide con el régimen. Por ejemplo, una `fa` a un receptor obligado por encima del mínimo. El aviso no frena la emisión. Ver [Régimen FCE del receptor](validation-rules.md#régimen-fce-del-receptor). El JSON está en [Entrada y salida](input-output.md#régimen-fce-fce-obligado). ## Consultar el padrón `arcli padron ` muestra lo que ARCA tiene de un CUIT: nombre o razón social, domicilio fiscal, condición frente al IVA, impuestos, categoría de monotributo y actividad principal. ```bash arcli padron 20201797064 arcli padron 20201797064 --json ``` | Flag | Alias | Descripción | | ------------------------------------- | ------- | -------------- | | `--json`, `--testing`, `--produccion` | ninguno | Flags globales | La condición IVA sale de los impuestos activos: monotributo es `responsable-monotributo`, IVA es `responsable-inscripto` e IVA exento es `sujeto-exento`. Con otros datos queda sin informar (`condicionIva: null`). Si el CUIT no está en el padrón, termina con el error `TAXPAYER_NOT_FOUND`. En testing el padrón tiene datos ficticios: `20201797064` devuelve datos completos. El JSON está en [Entrada y salida](input-output.md#padrón-padron). Usa el servicio `ws_sr_constancia_inscripcion`, que hay que autorizar aparte de `wsfe`. Ver [Autorizar el servicio web](certificado-testing-completa.md#3-autorizar-el-servicio-web). ### IVA receptor desde el padrón Al facturar con `--cuit` sin `--ir` (ni `ivaReceptor` en el JSON), ARCLI consulta el padrón y usa esa condición IVA, aunque la config tenga un `ivaReceptor` por defecto. También completa el nombre y el domicilio del receptor para el PDF, si no los pasaste. La vista previa lo marca: `IVA receptor Responsable inscripto (padrón)`. | Caso | Resultado | | ----------------------------------------------- | ----------------------------------------------------------- | | `--ir`, `--ir-*` o `ivaReceptor` en el JSON | Se usa ese valor; no se consulta el padrón | | El padrón informa la condición | Se usa la del padrón | | El padrón no responde o no informa la condición | Se usa `ivaReceptor` de la config, con un aviso en `avisos` | | Lo mismo, sin `ivaReceptor` en la config | Error `INPUT_VALIDATION_ERROR`: indicala con `--ir` | Para no consultarlo: `arcli config establecer consultarPadron false`. El modo interactivo hace la misma consulta al cargar un CUIT y propone esa condición, marcada "(según el padrón)". ## Autocompletado Completa con Tab comandos, flags y valores en bash, zsh y fish: atajos (`arcli ultimos nc`), flags (`arcli fc --ir-`), valores de `--iva-receptor`, `--concepto`, `--alicuota`, `--moneda`, `--transferencia` y `--ac`, claves de config y sus valores (`arcli config establecer entorno `), tablas de `parametros` y letras de las familias. Donde va una ruta (`--cargar`), completa archivos. ```bash arcli completado instalar # con el shell de $SHELL; o: arcli completado instalar zsh arcli completado # ¿está instalado? arcli completado desinstalar ``` `arcli completado instalar` agrega al archivo de inicio del shell una línea marcada con un comentario `# arcli` y `desinstalar` saca solo eso: | Shell | Archivo | | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | zsh | `~/.zshrc` (o `$ZDOTDIR/.zshrc`) | | bash | `~/.bashrc`; en macOS, el primero que exista de `~/.bash_profile`, `~/.bash_login` y `~/.profile` | | fish | `~/.config/fish/completions/arcli.fish`, o `$XDG_CONFIG_HOME/fish/completions/arcli.fish` si está definida (archivo propio; `desinstalar` lo borra) | Pedir el comando ya es la confirmación: no vuelve a preguntar, como `arcli pdf instalar`. Con `--json` devuelve `{ "cambio", "instalado", "ruta", "shell" }`. Si no se puede saber el shell, da `INPUT_VALIDATION_ERROR` y hay que indicarlo. Un programa no puede cambiar la terminal que ya está abierta: después de instalar, abrí una nueva. `arcli completado ` solo imprime el script, para instalarlo a mano. Cada Tab le pregunta a la versión instalada qué sigue, así que después de actualizar ARCLI no hay que reinstalar nada. En el modo interactivo está en Configuración → Autocompletado. ## Acceso directo Crea un ícono que abre ARCLI en su modo interactivo con doble clic, sin escribir comandos: ```bash arcli acceso-directo # en el escritorio arcli acceso-directo ~/Documentos # en otra carpeta, que tiene que existir ``` | Sistema | Qué crea | Dónde quedan el lanzador y el ícono | | ------- | --------------- | ------------------------------------------------ | | macOS | `ARCLI.app` | Dentro de la `.app` | | Windows | `ARCLI.lnk` | En `acceso-directo/`, junto al archivo de config | | Linux | `ARCLI.desktop` | En `acceso-directo/`, junto al archivo de config | Abre una terminal con ARCLI. Si termina con un error, la ventana espera un Enter para que se pueda leer. Con `--json` devuelve `{ "reemplazado", "ruta", "usaArcliInstalado" }`. - **Creado desde el código fuente** (`yarn dev acceso-directo`): abre el `arcli` instalado en lugar del `.ts` del repo, que Node no puede correr sin el cargador de `yarn dev`. Lo avisa al crearlo y en `usaArcliInstalado`. Si no hay un `arcli` instalado, el ícono avisa que falta instalarlo. - **Repetirlo:** actualiza el acceso directo de esa carpeta. En macOS y Linux, si ya hay un archivo con ese nombre que no creó ARCLI, da `INPUT_VALIDATION_ERROR` y no lo toca. - **Si cambiás Node o ARCLI de lugar:** el acceso directo guarda sus rutas al crearse. Si ya no están, prueba con el `arcli` del `PATH`; si tampoco anda, volvé a correr el comando. - **Quitarlo:** borrá el ícono como cualquier archivo. - En el modo interactivo está en Configuración → Acceso directo en el escritorio. ## Configuración Comandos `config` y claves disponibles: [Configuración](configuration.md). ## Estabilidad Todos los comandos de esta referencia son estables, salvo `storybook`, una herramienta interna de desarrollo que no aparece en la ayuda ni en `llms.txt`. ## Ver también - Cada comprobante, con sus opciones: [¿qué comprobante me toca?](comprobantes/README.md). Casos completos paso a paso: [monotributo](comprobantes-monotributo.md), [responsable inscripto](comprobantes-responsable-inscripto.md), [notas](notas-credito-debito.md), [FCE](fce.md), [exportación](exportacion.md) y [lotes](lotes-y-json.md). - [Reglas de validación](validation-rules.md) y [Troubleshooting](troubleshooting.md): qué rechaza el CLI y cómo resolverlo. --- # Configuración Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/configuration.md Cómo funciona la configuración persistente de ARCLI y qué conviene dejar guardado. ## Propósito La config persistente existe para guardar: - credenciales por entorno - defaults funcionales - defaults de salida Eso evita repetir siempre el mismo `cuit`, `puntoVenta`, concepto, IVA receptor o flags de salida. ## Ubicación del archivo ARCLI usa `conf` con: - `projectName: arcli` - `configName: config` La ubicación depende del sistema operativo: en macOS, `~/Library/Preferences/arcli/`; en Linux, `~/.config/arcli/`; en Windows, `%APPDATA%\arcli\Config\`. Para ver la exacta: ```bash arcli config ruta ``` Si el archivo no existe, `arcli config` lo crea automáticamente. En esa carpeta también quedan `certificados//` (con la clave privada), `tickets/` y `plugins/`. **Respaldala:** si perdés la clave privada, el certificado deja de servir y hay que sacar otro. `arcli config` muestra los datos agrupados en secciones: cuenta, certificados, al facturar, FCE, factura de exportación (E), datos del emisor (PDF), PDF, y salida y listados. Son las mismas secciones, en el mismo orden, que "Modificar configuración" del [modo interactivo](modo-interactivo.md). ## Claves soportadas ### Cuenta Quién factura y dónde. | Clave | Tipo | Valor por defecto | Descripción | | ------------ | ----------------------- | ----------------- | -------------------------- | | `cuit` | string | ninguno | CUIT del emisor | | `entorno` | `testing \| produccion` | `testing` | Entorno por defecto | | `puntoVenta` | number | ninguno | Punto de venta por defecto | ### Certificados Los arma `arcli certificado`: casi nunca hace falta tocarlas. | Clave | Tipo | Valor por defecto | Descripción | | ----------------- | ------ | ----------------- | ------------------------------------- | | `cert.testing` | string | ninguno | Ruta al certificado de testing | | `cert.produccion` | string | ninguno | Ruta al certificado de producción | | `key.testing` | string | ninguno | Ruta a la clave privada de testing | | `key.produccion` | string | ninguno | Ruta a la clave privada de producción | ### Al facturar Valores por defecto, para no repetir flags. | Clave | Tipo | Valor por defecto | Descripción | | ----------------- | ------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `alicuota` | string | `21` | Alícuota de IVA por defecto: alias (`general`, `reducida`, `incrementada`, `cero`) o número (solo letras A y B) | | `consultarPadron` | boolean | `true` | Completar el IVA receptor desde el padrón al facturar con `--cuit` y sin `--ir`. Ver [IVA receptor desde el padrón](cli-reference.md#iva-receptor-desde-el-padrón) | | `concepto` | string | ninguno | Concepto por defecto: `productos`, `servicios` o `productos-servicios` | | `cotizacion` | number | `1` | **Deprecada, se saca en la 3.0.0.** Cotización por defecto en moneda extranjera; `1` es no tenerla. Si está, cada factura que la usa lo avisa. Sin ella, en moneda extranjera se usa la cotización oficial de ARCA salvo `--cm` | | `emitir` | boolean | `false` | Emisión por defecto | | `ivaReceptor` | string | ninguno | IVA receptor por defecto: uno de los valores de `--iva-receptor` (ver [referencia](cli-reference.md)), por ejemplo `consumidor-final` | | `moneda` | string | `PES` | Moneda por defecto de A, B, C y FCE: código ISO o de ARCA, indistinto (`ARS`/`PES`, `USD`/`DOL`, `UYU`/`011`…). Ver [moneda y cotización](validation-rules.md#moneda-y-cotización). `arcli fe` va en `DOL` salvo `--moneda` | | `condicionVenta` | string | ninguno | Condición de venta del PDF de A, B y C si el comprobante no la sobrescribe, hasta 100 caracteres; `--sin-condicion-venta` o JSON `null` la omiten para ese comprobante. Ver [PDF](pdf.md#del-comprobante-flags-opcionales) | ### FCE Solo si emitís Factura de Crédito Electrónica. | Clave | Tipo | Valor por defecto | Descripción | | -------------- | ------- | ----------------- | ------------------------------------------------- | | `cbu` | string | ninguno | CBU del emisor (solo facturas FCE) | | `aliasCbu` | string | ninguno | Alias del CBU (solo facturas FCE) | | `verificarFce` | boolean | `false` | Consultar el régimen FCE del receptor al facturar | ### Exportación Solo si emitís la Factura E. | Clave | Tipo | Valor por defecto | Descripción | | ----------------------------- | ------ | ----------------- | --------------------------------------------------------------------------------------------------------------------------------- | | `exportacion.cert.testing` | string | ninguno | Ruta al certificado del servicio `wsfex` para testing; si falta, se usa `cert.testing` | | `exportacion.cert.produccion` | string | ninguno | Ruta al certificado del servicio `wsfex` para producción; si falta, se usa `cert.produccion` | | `exportacion.key.testing` | string | ninguno | Ruta a la clave privada del servicio `wsfex` para testing; si falta, se usa `key.testing` | | `exportacion.key.produccion` | string | ninguno | Ruta a la clave privada del servicio `wsfex` para producción; si falta, se usa `key.produccion` | | `exportacion.actividad` | number | ninguno | Código de la tabla de actividades de WSFEX que informa la factura de exportación `E`, por ejemplo `620100`; `--actividad` lo pisa | ### PDF y datos del emisor Lo que va impreso en el PDF y dónde se guarda. | Clave | Tipo | Valor por defecto | Descripción | | -------------------------- | ------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pdf` | `siempre \| preguntar \| nunca` | `preguntar` | Cuándo generar el PDF del comprobante emitido. Ver [PDF](pdf.md) | | `pdfCarpeta` | string | `~/arcli/comprobantes` | Carpeta donde se guardan los PDFs | | `pdfNavegador` | string | automático | Ruta a Chrome, Chromium o Edge para generar los PDFs | | `emisor.razonSocial` | string | ninguno | Nombre o razón social del emisor (solo PDF) | | `emisor.domicilio` | string | ninguno | Domicilio comercial del emisor (solo PDF) | | `emisor.inicioActividades` | fecha | ninguno | Inicio de actividades, con año: `1/03/2020` (solo PDF) | | `emisor.iibb` | string | sin valor (`-` en PDF) | Ingresos Brutos del emisor (solo PDF) | | `emisor.condicionIva` | string | según la letra | Condición de IVA del emisor (solo PDF): los mismos valores que `ivaReceptor`, por ejemplo `responsable-inscripto`, `responsable-monotributo` o `sujeto-exento`. Sin valor, sale de la letra: `A` y `B`, responsable inscripto; `C`, monotributo | | `emisor.logo` | string | ninguno | Ruta a un logo PNG o JPG (solo PDF) | ### Salida y listados Para scripts, automatización y las listas. | Clave | Tipo | Valor por defecto | Descripción | | ---------------------- | ------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `json` | boolean | `false` | Salida JSON por defecto | | `bruto` | boolean | `false` | Respuesta bruta por defecto | | `filasPorLista` | number | `15` | Cuántas filas muestran `arcli ultimos` (si no pasás `--cantidad`) y las listas del modo interactivo (comprobantes, tablas de ARCA y monedas), de 1 a 50 | | `comprobantesPorLista` | number | `15` | **Deprecada, se saca en la 3.0.0:** el nombre viejo de `filasPorLista`. Si está en el archivo se sigue leyendo (si están las dos, gana `filasPorLista`); `config establecer` y `config eliminar` la aceptan con un aviso y la pasan a `filasPorLista` | | `ticketPath` | string | ver abajo | Carpeta donde se guarda el ticket WSAA | > Para claves booleanas, ARCLI acepta `true` / `false`, `sí` / `no` o `1` / `0`. ### Certificados con `arcli certificado` `arcli certificado generar` y `arcli certificado importar` guardan la clave y el certificado en `certificados//`, junto a `config.json`, y configuran `cert.` y `key.` apuntando ahí. Si ya tenés las rutas configuradas a mano, siguen andando igual. Ver [Comando `arcli certificado`](cli-reference.md#comando-arcli-certificado). ### Certificados de exportación (WSFEX) La factura de exportación `E` (`arcli fe`) usa el servicio `wsfex`, que ARCA autoriza por separado de `wsfe`. El certificado general puede no estar autorizado a `wsfex`, así que podés guardar uno propio: ```bash arcli config establecer exportacion.cert.testing /ruta/al/certificado-exportacion.crt arcli config establecer exportacion.key.testing /ruta/a/la/clave-exportacion.key arcli config establecer exportacion.cert.produccion /ruta/al/certificado-exportacion.crt arcli config establecer exportacion.key.produccion /ruta/a/la/clave-exportacion.key ``` Reglas: - si `exportacion.cert.` y `exportacion.key.` están los dos, se usan esos; - si no hay ninguno de los dos, ARCLI usa `cert.` y `key.`; - si configurás solo la mitad del par (por ejemplo, el certificado pero no la clave), el comando de exportación corta antes de ir a ARCA con un error de configuración. Las claves aparecen en la sección **Certificados** de `arcli config`, se validan como PEM al guardarlas y `arcli config revisar` avisa si el par quedó incompleto o si el certificado de exportación está por vencer. Cómo autorizar el servicio: [Autorizar el servicio web](certificado-testing-completa.md#3-autorizar-el-servicio-web). La actividad que informa la `E` se guarda una vez con `arcli config establecer exportacion.actividad ` (sección **Factura de exportación (E)** de `arcli config`); `--actividad` la pisa. Tiene que ser un código de la tabla de actividades de WSFEX, que no es la del padrón: por ejemplo, `620100` para servicios de consultores en informática. Si el certificado no está autorizado a `wsfex`, la primera llamada falla con `WSFEX_SERVICE_NOT_AUTHORIZED`. Pasa incluso con `--previsualizar`, porque la vista previa consulta las tablas de WSFEX: autorizá el servicio en WSASS (testing) o creá la relación en el Administrador de Relaciones (producción) antes de reintentar. ### Ticket WSAA (`ticketPath`) Para autenticarse contra ARCA, el SDK pide un ticket de acceso (WSAA) que dura 12 horas y tiene rate limit estricto (1 request cada 2 minutos en producción, cada 10 minutos en testing). Ese ticket se guarda en disco para reutilizarlo entre corridas. Por defecto, ARCLI lo guarda en una carpeta `tickets/` junto al `config.json` (ver `arcli config ruta`), para que sobreviva a reinstalaciones o actualizaciones del paquete. Si preferís otra ubicación: ```bash arcli config establecer ticketPath /ruta/que/prefieras arcli config eliminar ticketPath ``` El ticket permite operar en ARCA como tu CUIT mientras dure, así que ARCLI deja la carpeta en `0700` (solo tu usuario). Si elegís otra ubicación, que no sea una carpeta compartida. ### PDF y datos del emisor Las claves `pdf`, `pdfCarpeta`, `pdfNavegador`, `condicionVenta` y `emisor.*` solo se usan para generar el PDF. ARCA no recibe los datos del emisor: van impresos en el PDF. Cómo completarlos y qué hace cada clave: [PDF de comprobantes](pdf.md#datos-que-arca-no-guarda). ## Prioridad de fuentes ARCLI resuelve los datos en este orden: 1. flags 2. JSON cargado con `--cargar` 3. config persistente 4. defaults internos Ejemplo: - si pasás `--moneda USD`, gana eso - si no pasás `--moneda` pero el JSON trae `codigoMoneda`, gana el JSON - si no hay JSON, usa `moneda` de config - si tampoco hay config, cae en el default interno En `arcli fe` la moneda no sale de `moneda`: sin `--moneda` la exportación va en dólares (`DOL`). ## Comandos de configuración ### Ver configuración actual ```bash arcli config ``` ### Ver ruta del archivo ```bash arcli config ruta arcli config ruta --json # {"ruta": "..."} ``` ### Revisar configuración activa ```bash arcli config revisar arcli config revisar --json ``` `config revisar` combina: - el estado de la config persistente - el vencimiento de los certificados de los dos entornos - la validación real (CUIT, certificado y clave legibles) del entorno por defecto y de cualquier otro que tenga `cert` o `key` configurados - el plugin de PDF, como `arcli pdf estado`: si está instalado, si es la versión que usa ARCLI y si encontró un navegador. Con `pdf=siempre` avisa si falta; con `preguntar` (por defecto) lo revisa solo si está instalado, y con `nunca`, no lo revisa. El plugin nunca bloquea la emisión. No recibe `--testing` ni `--produccion`: revisa los dos entornos de una vez. En `arcli config`, las rutas (certificados, claves, tickets, PDFs) se abren con un clic en terminales que soportan links, como la de VS Code, iTerm2 o Windows Terminal; `FORCE_HYPERLINK=0` los apaga. La sección Certificados muestra también la carpeta donde `arcli certificado` guarda los suyos. En la terminal agrupa los chequeos por sección (Cuenta, Al facturar, Certificados, Salida, PDF y Validaciones), con lo que falta en amarillo o rojo. El JSON trae los mismos chequeos, sin las secciones. Si falta el CUIT, la terminal lo muestra una sola vez, en rojo; el JSON trae los dos chequeos (`CUIT` y `Validación testing`). Con problemas sale igual con exit code `0`. `ok` es `true` solo si todos los chequeos están bien, y también queda en `false` por sugerencias opcionales (concepto o IVA receptor por defecto sin configurar, sin certificado de producción, el plugin de PDF): para saber si un entorno puede emitir, mirá que no haya chequeos `error`. Revisa la config localmente: no prueba el certificado contra ARCA (para eso, `arcli estado`). La forma del JSON de `config` y `config revisar` está en [Entrada y salida](input-output.md#configuración-config-y-config-revisar). `arcli config --ayuda` y `arcli config establecer --ayuda` listan todas las claves con sus valores. ### Guardar o eliminar valores ```bash arcli config establecer puntoVenta 3 arcli config eliminar puntoVenta ``` ### Validación al guardar credenciales Cuando se guarda `cert.*`, `key.*`, `exportacion.cert.*` o `exportacion.key.*`, ARCLI valida: - que la ruta exista - que el archivo tenga formato PEM válido La ruta se guarda absoluta, así que podés pasarla relativa a la carpeta donde estás. ¿Todavía no tenés el certificado y la clave? Ver [Cómo obtener los certificados de ARCA](obtencion-certificados.md). ## Variables de entorno No son claves de config. Las de color, `FORCE_HYPERLINK` y `ARCLI_ASCII` cambian solo cómo se ve la salida humana; el JSON no cambia. | Variable | Efecto | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `NO_COLOR` | Desactiva los colores | | `FORCE_COLOR` | `1` fuerza los colores aunque la salida no sea una terminal (por defecto, con la salida redirigida no hay colores); `0` o `false` los apaga | | `ARCLI_ASCII=1` | Dibuja los paneles y los símbolos con ASCII puro (`+`, `-`, `\|`), para terminales o fuentes que no muestran los caracteres de caja Unicode. Las tildes y la `ñ` se mantienen | | `FORCE_HYPERLINK=0` | Apaga los links clickeables en las rutas (con `1` los fuerza). Por defecto se usan en terminales que los soportan, como VS Code, iTerm2 o Windows Terminal | | `ARCLI_CONFIG_DIR` | Usa otra carpeta de config, con su `config.json`, tickets, plugins y certificados. Sirve para tener una config aparte (otro CUIT, pruebas) sin tocar la de siempre. `arcli config ruta` muestra la que se está usando | | `NO_UPDATE_NOTIFIER` | Desactiva el aviso de nueva versión, también en el modo interactivo. Tampoco aparece con `CI`, con `--json` ni si stderr no es una terminal | | `PUPPETEER_EXECUTABLE_PATH` | Ruta del navegador para el PDF (ver [PDF](pdf.md#el-plugin-de-pdf)) | ## Qué conviene guardar Guardá en config lo que se repite en el uso diario: `cuit`, `puntoVenta`, `concepto`, `ivaReceptor`, `cbu` (si emitís facturas FCE) y `alicuota` (si casi siempre facturás con una alícuota distinta de 21%). Un flag siempre pisa lo guardado. Para una configuración inicial, ver [Configurar](instalar.md#configurar). ## Advertencias ### `emitir=true` Si guardás: ```bash arcli config establecer emitir true ``` ARCLI va a emitir por defecto cuando no pases `--previsualizar`, sin preguntar. Es cómodo, pero también hace más fácil emitir sin querer en flujos repetitivos. Si no estás seguro, dejalo en `false`. Combinado con `entorno produccion`, un comando sin flags emite un comprobante real en producción. Si usás esa combinación, pasá `--previsualizar` cuando solo quieras ver la solicitud. --- # Entrada y salida Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md Contrato formal de entrada y salida de ARCLI. Este documento asume el flujo descrito en [mental-model.md](mental-model.md) (`Input -> Validación -> Solicitud -> ARCA -> Output`, con prioridad `flags > JSON > config > defaults`) y se enfoca en el contrato concreto de cada formato. ## Formato de input: objeto Cuando usás `--cargar`, ARCLI espera un objeto JSON o un array de objetos. ```bash arcli fc --cargar ./voucher.json ``` ### Campos soportados | Campo | Tipo | Requerido | Descripción | | --------------------- | -------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `alicuotaIva` | string, number | no | Alícuota de IVA: alias (`general`, `reducida`, `incrementada`, `cero`) o número (`0`, `2.5`, `5`, `10.5`, `21`, `27`); acepta `"10.5"` o `10.5` | | `alicuotas` | array | no | Varias alícuotas: `[{ "tasa": "general", "monto": 1210 }]`, monto con IVA incluido; con esto `montoTotal` es opcional | | `aliasCbu` | string | no | Alias del CBU (facturas FCE) | | `anulacion` | boolean | no | NC/ND FCE de anulación | | `cbu` | string | en facturas FCE, salvo `config.cbu` | CBU del emisor (facturas FCE) | | `comprobanteAsociado` | object | no | Comprobante asociado | | `concepto` | string | sí, salvo default por flags/config | Concepto | | `codigoMoneda` | string | no | Moneda: código ISO (`ARS`, `USD`, `UYU`…) o de ARCA (`PES`, `DOL`, `011`…) | | `cotizacionMoneda` | number | no | Cotización de la moneda; en moneda extranjera, sin ella se usa la oficial de ARCA | | `mismaMoneda` | boolean | no | El pago se cancela en la moneda extranjera | | `dia` | number | no | Deprecado: usá `vencimientoPago`. Vence el próximo día con ese número | | `emitir` | boolean | no | Emisión real | | `fechaComprobante` | string | no | Fecha del comprobante | | `importeExento` | number | no | Parte exenta del total (A y B) | | `importeNoGravado` | number | no | Parte no gravada del total (A y B) | | `ivaReceptor` | string | sí, salvo con CUIT (padrón) o default por config | Condición IVA del receptor; con CUIT y sin este campo, la del padrón | | `montoTotal` | number | sí, salvo con `alicuotas` | Importe total | | `periodoAsociado` | object | no | `{ "desde": "01-09-2026", "hasta": "30-09-2026" }`; alternativa a `comprobanteAsociado` en notas comunes | | `numeroDocumento` | number | depende del tipo de documento | Número de documento | | `pdf` | boolean | no | `true` genera el PDF y `false` no, como `--exportar-pdf` y `--sin-pdf`. Ver [PDF](pdf.md) | | `descripcion` | string | no | Detalle del comprobante en el PDF; ARCA no lo recibe | | `condicionVenta` | string \| null | no | Condición de venta en el PDF (`contado`, `cuenta-corriente`… o un texto); `null` omite el valor de la config; ARCA no la recibe | | `receptorNombre` | string | no | Nombre o razón social del receptor en el PDF; ARCA no lo recibe | | `receptorDomicilio` | string | no | Domicilio del receptor en el PDF; ARCA no lo recibe | | `previsualizar` | boolean | no | Preview sin emitir | | `puntoVenta` | number | no | Punto de venta | | `servicioDesde` | string | no | Fecha inicio de servicio | | `servicioHasta` | string | no | Fecha fin de servicio | | `vencimientoPago` | string | no | Fecha de vencimiento del pago | | `tipoDocumento` | string | no | `consumidor-final`, `cuit`, `cuil` o `dni` | | `transferencia` | string | no | `sca` o `adc` (facturas FCE) | ### Claves desconocidas y tipos Cada objeto se valida contra esta lista antes de mezclarlo con los flags y la config: - **Una clave que no está en las tablas es un error** (`INPUT_VALIDATION_ERROR`) que la nombra y, si se parece a una válida o a un flag, sugiere la correcta: `"montototal"` → `montoTotal`, `"vencimiento"` → `vencimientoPago`, `"moneda"` → `codigoMoneda`. Vale también dentro de `comprobanteAsociado`, `periodoAsociado` y cada ítem de `alicuotas`. - **Un tipo incorrecto es un error**, no se descarta: `"puntoVenta": "3"` falla con "tiene que ser un número". Los números van sin comillas y los booleanos son `true` o `false`, no `"true"`. `null` tampoco vale (salvo en `condicionVenta`, donde omite el valor de la config): para no informar un campo, omití la clave. La única clave que acepta texto o número es la tasa de IVA (`alicuotaIva` y `tasa` en `alicuotas`). - En un lote, cada ítem se valida por separado y el error sale en `BATCH_VALIDATION_ERROR` con su índice (ver [abajo](#validación-y-errores-del-lote)). Un array vacío también es error. Con un solo comprobante, `detalles.campos` lista cada problema con su ruta en el JSON: ```json { "codigo": "INPUT_VALIDATION_ERROR", "detalles": { "campos": [ { "mensaje": "\"puntoVenta\" tiene que ser un número y llegó el texto \"3\". Escribilo sin comillas.", "ruta": ["puntoVenta"] }, { "mensaje": "La clave \"vencimiento\" no existe: ¿quisiste decir \"vencimientoPago\"?", "ruta": ["vencimiento"] } ] }, "error": "En el JSON de `--cargar`: ...", "sugerencia": null } ``` ### Flags y claves del JSON Los nombres de las claves no siempre coinciden con los flags. Si pasás las dos cosas, gana el flag. | Flag | Clave del JSON | | ------------------------------------------------------------- | ----------------------------------- | | `--monto`, `-m` | `montoTotal` | | `--alicuota TASA` | `alicuotaIva` | | `--alicuota TASA:MONTO` (repetido) | `alicuotas: [{ "tasa", "monto" }]` | | `--exento` | `importeExento` | | `--nogravado` | `importeNoGravado` | | `--dia` | `dia` | | `--punto-venta`, `--pv` | `puntoVenta` | | `--fecha` | `fechaComprobante` | | `--concepto`, `--cs`, `--cp`, `--csp` | `concepto` | | `--moneda`, `--mda` | `codigoMoneda` | | `--cotizacion-moneda`, `--cm` | `cotizacionMoneda` | | `--misma-moneda` | `mismaMoneda` | | `--cuit`, `--cuil`, `--dni`, `--consumidor-final`, `--cfinal` | `tipoDocumento` y `numeroDocumento` | | `--iva-receptor`, `--ir`, `--ir-*` | `ivaReceptor` | | `--servicio-desde`, `--sd` | `servicioDesde` | | `--servicio-hasta`, `--sh` | `servicioHasta` | | `--vencimiento`, `--vto` | `vencimientoPago` | | `--ac` | `comprobanteAsociado.atajo` | | `--at` | `comprobanteAsociado.tipo` | | `--apv`, `--asociado-punto-venta` | `comprobanteAsociado.puntoVenta` | | `--ar` | `comprobanteAsociado.numero` | | `--acuit` | `comprobanteAsociado.cuit` | | `--afecha` | `comprobanteAsociado.fecha` | | `--periodo-desde`, `--pd` | `periodoAsociado.desde` | | `--periodo-hasta`, `--ph` | `periodoAsociado.hasta` | | `--cbu` | `cbu` | | `--alias` | `aliasCbu` | | `--transferencia` | `transferencia` | | `--anulacion` | `anulacion` | | `--exportar-pdf`, `--pdf` / `--sin-pdf` | `pdf: true` / `pdf: false` | | `--descripcion` | `descripcion` | | `--condicion-venta`, `--cv` | `condicionVenta` | | `--sin-condicion-venta` | `condicionVenta: null` | | `--receptor-nombre` | `receptorNombre` | | `--receptor-domicilio` | `receptorDomicilio` | | `--emitir` | `emitir` | | `--previsualizar` | `previsualizar` | ### Objeto `comprobanteAsociado` | Campo | Tipo | Requerido | Descripción | | ------------ | ------ | --------------- | ------------------------------------------------------------------- | | `atajo` | string | sí\* | Atajo del comprobante asociado | | `cuit` | string | sí para notas | CUIT del comprobante asociado (en NC/ND FCE, por defecto el emisor) | | `fecha` | string | sí en NC/ND FCE | Fecha del comprobante asociado | | `numero` | number | sí para notas | Número del comprobante asociado | | `puntoVenta` | number | sí para notas | Punto de venta del comprobante asociado | | `tipo` | number | sí\* | Tipo ARCA del comprobante asociado | \* Hay que informar `atajo` o `tipo`, pero no hace falta enviar ambos. ### Ejemplo de input simple ```json { "concepto": "servicios", "codigoMoneda": "ARS", "cotizacionMoneda": 1, "emitir": false, "ivaReceptor": "responsable-inscripto", "montoTotal": 15000, "numeroDocumento": 20168598204, "puntoVenta": 3, "tipoDocumento": "cuit" } ``` ### Ejemplo con asociado ```json { "comprobanteAsociado": { "atajo": "fa", "cuit": "20333333334", "numero": 120, "puntoVenta": 3 }, "concepto": "servicios", "ivaReceptor": "responsable-inscripto", "montoTotal": 5000, "numeroDocumento": 20168598204, "tipoDocumento": "cuit" } ``` ## Factura de exportación (E) La factura `E` (`arcli fe` o `arcli factura e`) y sus notas de crédito y débito (`arcli nce`, `arcli nde`) no comparten el JSON de facturación: no tiene concepto, IVA ni receptor con documento, y `--cargar` acepta **un objeto, nunca un array** (el lote de exportación no está soportado y responde `INPUT_VALIDATION_ERROR`). Una clave desconocida es error. ### Input de `--cargar` | Campo | Tipo | Requerido | Descripción | | ------------------------------------------- | ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `cliente` | string | sí | Nombre del cliente del exterior | | `domicilioCliente` | string | sí | Domicilio del cliente | | `paisDestino` | string \| number | sí | Código de ARCA o nombre del país (`203`, `"Brasil"`) | | `montoTotal` | number | sí | Total del comprobante, igual que en A, B y C. `monto` sigue andando, con un aviso, hasta la 3.0.0; las dos juntas son un error. Tiene que dar la suma de los ítems | | `numero` | number | no | Por defecto, el siguiente al último de ese tipo en el punto de venta, que ARCLI consulta en WSFEX | | `actividad` | number | sí\* | Código de la tabla de actividades de WSFEX. \*Si falta, sale de `exportacion.actividad` | | `items` | array | no | Renglones (ver abajo). Sin ítems va uno solo con `descripcion` por el total | | `idImpositivo` | string | no | ID impositivo del cliente en su país | | `cuitPais` | number | no | CUIT del país del cliente; si falta sale de la tabla de ARCA | | `tipoExpo` | `1` \| `2` \| `4` | no | `2` servicios (por defecto), `1` bienes, `4` otros | | `incoterm`, `descripcionIncoterm` | string | no | Código y descripción del incoterm (`FOB`, `CIF`…) | | `idioma` | number | no | `1` español (por defecto), `2` inglés, `3` portugués | | `formaPago` | string | no | Por defecto `Transferencia Internacional` | | `permisos`, `permisoExistente` | string[], boolean | no | IDs de permiso de embarque y si ya están informados en ARCA; solo con `tipoExpo: 1` | | `idSolicitud` | number | no | ID de la solicitud; si falta se pide a WSFEX | | `puntoVenta` | number | no | Por defecto, el de la config | | `fechaComprobante`, `fechaPago` | string | no | Formato argentino: `27/10/2026`, `27-10-26` o solo día y mes | | `codigoMoneda`, `cotizacionMoneda` | string, number | no | `USD` viaja como `DOL` (por defecto); sin cotización se usa la de aduana que publica ARCA | | `mismaMoneda` | boolean | no | Pago en la misma moneda extranjera (`CanMisMonExt` en `S`). No cambia la cotización: sale de `cotizacionMoneda` o, sin ella, de la de aduana | | `observaciones`, `observacionesComerciales` | string | no | Van a `Obs` y `Obs_comerciales` | | `descripcion` | string | no | Descripción del renglón único cuando no hay `items`; por defecto `Según detalle` | | `pdf`, `emitir`, `previsualizar` | boolean | no | Igual que en el resto de los comprobantes: `"previsualizar": false` no emite, decide la config (y en una terminal pregunta) | | `comprobanteAsociado` | object | notas | Solo en `nce` y `nde`: el comprobante que ajusta la nota (ver abajo). En `fe` es un error | Cada ítem: | Campo | Tipo | Requerido | Descripción | | ---------------- | ---------------- | --------- | --------------------------------------------------------- | | `cantidad` | number | sí | `Pro_qty` | | `descripcion` | string | sí | `Pro_ds` | | `precioUnitario` | number | sí | `Pro_precio_uni`; el total del renglón lo calcula ARCLI | | `codigo` | string | no | `Pro_codigo` | | `unidad` | string \| number | no | Código de ARCA o nombre de la tabla (`7`, `"kilogramos"`) | `comprobanteAsociado` usa las mismas claves que en A, B y C: | Campo | Tipo | Requerido | Descripción | | ------------ | ------ | --------- | --------------------------------------------------------------------- | | `numero` | number | sí | Número del comprobante asociado | | `puntoVenta` | number | no | Por defecto, el punto de venta de la nota | | `atajo` | string | no | `fe` (por defecto), `nde` o `nce` | | `tipo` | number | no | `19`, `20` o `21`; si va con `atajo`, tienen que coincidir | | `cuit` | string | no | Solo puede ser el CUIT emisor (error 2031 de ARCA) | | `fecha` | string | no | No se usa: la fecha sale de ARCA. Si viene, sale un aviso en `avisos` | En una nota, `cliente`, `domicilioCliente`, `paisDestino`, `actividad` y la moneda salen del asociado si faltan, y `fechaPago`, `mismaMoneda` y `permisoExistente` son un error, porque ARCA los rechaza en las notas. `permisos` es opcional en las notas de bienes (`tipoExpo: 1`) y va sin `permisoExistente`. ```json { "montoTotal": 500, "numero": 1, "comprobanteAsociado": { "atajo": "fe", "puntoVenta": 4, "numero": 1 }, "previsualizar": true } ``` Una factura: ```json { "cliente": "ACME LLC", "domicilioCliente": "123 Main St", "paisDestino": 203, "montoTotal": 1500, "numero": 1, "actividad": 620100, "tipoExpo": 2, "incoterm": "FOB", "items": [ { "codigo": "001", "descripcion": "Servicios de consultoría", "cantidad": 1, "precioUnitario": 1000, "unidad": "unidades" }, { "codigo": "002", "descripcion": "Soporte", "cantidad": 2, "precioUnitario": 250, "unidad": "unidades" } ], "previsualizar": true, "pdf": true } ``` ### Output JSON Es el mismo resumen que A, B y C (`atajo`, `cae`, `estado`, `errores`, `observaciones`, `pdf`…) con `atajo: "fe"` y `tipoArca: 19` (`nce` y `21`, `nde` y `20` en las notas), y `numero`, también en la vista previa, porque lo informás vos. Suma un bloque `exportacion` con lo que WSFEX tiene y `wsfe` no. `solicitud` es el `Cmp` de WSFEX, con los nombres de ARCA. ```json { "atajo": "fe", "cae": "86120020284412", "comprobante": "Factura de exportación E", "estado": "aprobado", "exportacion": { "actividad": [620100], "cliente": "ACME LLC", "comprobanteAsociado": null, "cuitPaisCliente": 55000002126, "destino": { "codigo": 212, "nombre": "ESTADOS UNIDOS" }, "domicilioCliente": "123 Main St", "formaPago": "Transferencia Internacional", "idImpositivo": null, "idioma": 1, "incoterm": null, "incotermDescripcion": null, "items": [ { "cantidad": 1, "codigo": "001", "descripcion": "Servicios de consultoría", "precioUnitario": 1000, "total": 1000, "unidad": "unidades", "unidadCodigo": 7 } ], "mismaMoneda": false, "permisos": [], "tipoExpo": 2 }, "solicitud": { "Cbte_Tipo": 19, "Imp_total": 1500 }, "tipoArca": 19 } ``` `exportacion.comprobanteAsociado` es `null` en la factura. En las notas trae el comprobante que ajustan, con la fecha y el total que devolvió ARCA: ```json { "comprobanteAsociado": { "atajo": "fe", "fecha": "20261030", "numero": 1, "puntoVenta": 4, "tipoArca": 19, "total": 1500 } } ``` En las notas, `solicitud` lleva `Cmps_asoc` con el asociado y `Permiso_existente` vacío (con `Permisos` solo si la nota de bienes los informa), y no lleva `Fecha_pago` ni `CanMisMonExt`. `exportacion.destino.nombre`, `exportacion.incotermDescripcion` y `exportacion.items[].unidad` salen de las tablas de WSFEX; si la tabla no trae el nombre, quedan en `null` y el código numérico sigue disponible. `exportacion.actividad` lista los códigos de actividad informados en `solicitud.Actividades` (de `--actividad` o de `exportacion.actividad`) y `exportacion.mismaMoneda` indica si el pago se cancela en la misma moneda extranjera (`solicitud.CanMisMonExt` en `S`). Una actividad que no está en la tabla de actividades de WSFEX es `INPUT_VALIDATION_ERROR` antes de ir a ARCA, porque ARCA la rechaza (error 2105). En `arcli factura e`, los flags de A, B y C que se saltean salen en `avisos`. En la factura, `solicitud` no trae `Cmps_asoc` ni `Opcionales`: ARCA rechaza esos bloques vacíos (error 1820 el primero). `solicitud` no incluye `Permisos` cuando el comprobante no informa permisos de embarque: ARCA rechaza ese campo (error 1720) si `Permiso_existente` es `N`. En las exportaciones de servicios (`tipoExpo: 2`) y otros (`tipoExpo: 4`) ARCA exige ese campo **vacío** (error 1550), así que `solicitud.Permiso_existente` sale `""` y los permisos de embarque no se admiten. ## Formato de input: batch Si el archivo contiene un array, ARCLI procesa un lote del mismo comando. **Un array es siempre un lote, aunque tenga un solo elemento**: la salida `--json` es un array y los errores son `BATCH_VALIDATION_ERROR` / `BATCH_EMISSION_ERROR` con el índice. Un objeto suelto es un solo comprobante: sale un objeto y los errores son los de siempre (`INPUT_VALIDATION_ERROR`, etc.). ```json [ { "concepto": "servicios", "ivaReceptor": "consumidor-final", "montoTotal": 1000, "numeroDocumento": 0, "tipoDocumento": "consumidor-final" }, { "concepto": "servicios", "ivaReceptor": "responsable-inscripto", "montoTotal": 2000, "numeroDocumento": 20168598204, "tipoDocumento": "cuit" } ] ``` ### Validación y errores del lote **Antes de emitir el primer comprobante, ARCLI valida todos los del lote**: la forma del JSON, las consultas a ARCA que se hacen antes de emitir (IVA receptor desde el padrón, cotización oficial) y las reglas de negocio (IVA receptor por letra, fechas, FCE, montos…). - Si alguno es inválido o falla su consulta, **no se emite ninguno** y el error `BATCH_VALIDATION_ERROR` lista **todos** los ítems con problemas, con su índice (desde 1) y el motivo. - Si la emisión se corta a mitad del lote (red, ARCA), ARCLI **muestra primero los comprobantes ya procesados**, con su PDF si corresponde (según `pdf` o `--exportar-pdf`, igual que en un lote completo; en `--json`, cada uno con su campo `pdf`), y después el error `BATCH_EMISSION_ERROR`, que indica en qué ítem falló y cuáles quedaron sin procesar. **No vuelvas a cargar los ya emitidos**. Si viene `detalles.sinConfirmar`, el que falló puede haberse emitido igual: verificalo con `arcli ultimos` antes de reintentarlo. Si no viene, falló antes de emitir (login, último número) y ya está en `detalles.sinProcesar`. Después reintentá los de `sinProcesar`. ```json { "codigo": "BATCH_VALIDATION_ERROR", "detalles": { "comprobantes": [ { "error": "Falta el dato: monto.", "indice": 2 }, { "error": "La factura B de $ 10.000.000 o más requiere identificar al consumidor final. Usá `--dni`, `--cuit` o `--cuil`.", "indice": 3 } ] }, "error": "2 de 4 comprobantes del lote tienen errores. No se emitió ninguno.\n\n#2: ...", "sugerencia": null } ``` ```json { "codigo": "BATCH_EMISSION_ERROR", "detalles": { "fallo": 3, "procesados": 2, "sinConfirmar": 3, "sinProcesar": [4], "total": 4 }, "error": "El lote se interrumpió en el comprobante #3: ...\nProcesados: 2 de 4. Sin procesar: #4.\nEl #3 puede haberse emitido: verificalo con `arcli ultimos` antes de reintentarlo.", "sugerencia": null } ``` Con un solo comprobante (sin lote) los errores son los de siempre. ## Output humano La salida humana está pensada para terminal y prioriza legibilidad. Incluye, según el caso: - banner de entorno - solicitud amigable - estado visual del resultado - paneles secundarios para `Observaciones`, `Eventos`, `Errores` y `Sugerencias` - panel `Respuesta bruta` al final, además de todo lo anterior, cuando se usa `--bruto` y hubo emisión real (en una previsualización no hay respuesta de ARCA y no se muestra) ### Estabilidad del contrato La salida humana no debe tratarse como contrato estable para automatización. Para eso existe `--json`. Una clave del JSON no cambia sin aviso. Antes de sacarla o de cambiarle el tipo, sigue funcionando y la respuesta suma `deprecado`: una lista de frases con qué pasa y qué usar. Solo aparece si esa respuesta trae algo deprecado, nunca es un error y no se muestra en la terminal. | Clave deprecada | Dónde | Qué usar | | ------------------------------------------ | ------------------------ | ---------------------------------------------------------- | | `Code`, `Msg` en `errores` y `eventos` | emisión de A, B y C | `codigo`, `mensaje` | | `code`, `message` en `errores` y `eventos` | emisión de la factura E | `codigo`, `mensaje` | | `puntoVenta` como objeto | `estado` | `puntoVentaDetalle`; en la 3.0.0 `puntoVenta` es un número | | `cuit` como número | `padron`, `fce-obligado` | Leelo como texto: en la 3.0.0 es un string | | `detalles.errors` | errores de ARCA | `detalles.errores`, con `codigo` y `mensaje` | | `monto` en `--cargar` | factura E | `montoTotal`; este aviso sale en `avisos` y en la terminal | | `comprobantesPorLista` | `config --json` | `filasPorLista`, que trae el mismo valor | Todas se sacan en la 3.0.0. ## Output JSON ### Caso simple ARCLI serializa un resumen del resultado. Con `--bruto` se agrega además el campo `respuesta` (ver [abajo](#output-con---bruto)); el resto no cambia. | Campo | Tipo | Descripción | | ------------------ | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `atajo` | `string` | Atajo del comprobante | | `avisos` | `string[]` | Avisos de ARCLI: régimen FCE, padrón, certificado por vencer, cotización oficial usada por defecto, clave `cotizacion` deprecada o flags salteados (ver [abajo](#aviso-del-certificado)) | | `cae` | `string \| null` | CAE informado por ARCA | | `caeVencimiento` | `string \| null` | Vencimiento del CAE | | `comprobante` | `string` | Nombre visible del comprobante | | `deprecado` | `string[]`, opcional | Claves de esta respuesta que se sacan en la 3.0.0 (ver [Estabilidad del contrato](#estabilidad-del-contrato)) | | `entorno` | `"testing" \| "produccion"` | Entorno en que se emitió o previsualizó | | `errores` | `object[]` | Errores de ARCA, con `codigo` y `mensaje` | | `estado` | `"aprobado" \| "observado" \| "rechazado" \| "previsualizacion"` | Estado normalizado que arma ARCLI; `previsualizacion` en la vista previa, sin emitir | | `eventos` | `object[]` | Eventos de ARCA, con `codigo` y `mensaje` | | `numero` | `number \| null` | Número del comprobante emitido; `null` en una previsualización | | `observaciones` | `string[]` | Observaciones amigables | | `observacion` | `string \| null` | Observaciones unidas en una sola cadena | | `pdf` | `object`, opcional | Solo si se intentó generar el PDF: `{ ruta }` o `{ error: { codigo, mensaje, sugerencia } }`. Ver [PDF](pdf.md#salida) | | `previsualizacion` | `boolean` | `true` si no hubo emisión real | | `puntoVenta` | `number` | Punto de venta del comprobante | | `resultado` | `string \| null` | Resultado original de ARCA, por ejemplo `A` o `R` | | `solicitud` | `object` | Solicitud enviada o previsualizada; si se emitió, con el número en `CbteDesde` y `CbteHasta` | | `sugerencias` | `string[]` | Sugerencias generadas por ARCLI | | `tipoArca` | `number` | Tipo ARCA del comprobante | ### Aviso del certificado Si a alguno de los certificados configurados (de testing o de producción, sin importar con cuál se trabaja) le quedan menos de 30 días, el aviso sale al principio del comando en **stderr** (stdout queda solo para el JSON) y, en los comandos de facturación, también como un texto más en `avisos`: ```json { "avisos": [ "El certificado de producción vence el 20/11/2026 (en 10 días). Renovalo: https://arcli.com.ar/empezar/certificado-testing/" ], "...": "..." } ``` En texto sale solo el banner del principio, no se repite en el panel de avisos. Si ya venció el del entorno que se usa, no hay resultado: sale el error [`CERTIFICATE_EXPIRED`](#certificado-vencido). Uno vencido de otro entorno solo se avisa. ### `estado` vs `resultado` No significan lo mismo: - `resultado` es el valor original que llega de ARCA - `estado` es una normalización que hace ARCLI Ejemplo: - ARCA puede devolver `resultado: "A"` - ARCLI puede devolver: - `estado: "aprobado"` si no hay observaciones - `estado: "observado"` si hubo observaciones - En la vista previa no se emite: `estado: "previsualizacion"` y `resultado: null` ```json { "atajo": "fb", "avisos": [], "cae": "86120020284412", "caeVencimiento": "20260329", "comprobante": "Factura B", "entorno": "testing", "errores": [], "estado": "aprobado", "eventos": [], "numero": 125, "puntoVenta": 3, "observaciones": [], "observacion": null, "previsualizacion": false, "resultado": "A", "solicitud": { "...": "..." }, "sugerencias": [], "tipoArca": 6 } ``` ## Output batch en JSON Cuando `--cargar` trae un array, ARCLI devuelve un array, aunque tenga un solo elemento. Con flags o un objeto devuelve un objeto. Cada ítem agrega: | Campo | Tipo | Descripción | | ------------- | -------- | ----------------------------------- | | `atajo` | `string` | Atajo del comprobante | | `comprobante` | `string` | Nombre visible del comprobante | | `indice` | `number` | Posición en el lote, empezando en 1 | Y después incluye el resto del resultado serializado. ## Output con `--bruto` `--bruto` (o `bruto=true` en la config) **agrega** el campo `respuesta` al JSON de siempre: `cae`, `estado`, `errores` y los demás campos del [caso simple](#caso-simple) siguen igual. En un lote, cada ítem trae su `respuesta`. | Campo | Tipo | Descripción | | ----------- | -------- | --------------------------------------------- | | `respuesta` | `object` | Respuesta cruda del SDK o un mensaje amigable | ```json { "atajo": "fb", "cae": "86120020284412", "estado": "aprobado", "errores": [], "...": "el resto del resumen", "respuesta": { "cae": "86120020284412", "caeFchVto": "20260329", "response": { "FeCabResp": { "...": "..." }, "FeDetResp": { "...": "..." } } } } ``` ### Sin emisión real Si no hubo emisión real, `respuesta` no se serializa como `null`. En su lugar: ```json { "mensaje": "Sin emisión real. Usá `--emitir` para obtener una respuesta de ARCA." } ``` ## Comprobantes emitidos (`ultimos` y `consultar`) `arcli ultimos --json` devuelve el tipo de comprobante y la lista, del más nuevo al más viejo: ```json { "atajo": "fb", "comprobante": "Factura B", "tipoArca": 6, "comprobantes": [ { "cae": "86400940834444", "caeVencimiento": "20261011", "concepto": 2, "cotizacion": 1, "fecha": "20261001", "importes": { "exento": 50, "iva": 105.05, "neto": 1000.45, "noGravado": 25, "total": 1180.5, "tributos": 0 }, "moneda": "PES", "numero": 12, "numeroDocumento": 0, "resultado": "A", "tipoDocumento": 99 } ], "entorno": "testing", "puntoVenta": 3 } ``` `arcli consultar --json` devuelve un solo comprobante, con los mismos campos al primer nivel (sin el array `comprobantes`). | Campo | Tipo | Descripción | | ------------------------- | ---------------- | --------------------------------------------------------------------- | | `fecha`, `caeVencimiento` | `string` | Formato ARCA `yyyymmdd` | | `concepto` | `number` | `1` productos, `2` servicios, `3` productos y servicios | | `tipoDocumento` | `number` | Código de ARCA: `80` CUIT, `86` CUIL, `96` DNI, `99` consumidor final | | `moneda` | `string` | Código de ARCA (`PES`, `DOL`…) | | `importes` | `object` | `total`, `neto`, `iva`, `exento`, `noGravado` y `tributos` | | `resultado` | `string \| null` | `A` aprobado, `R` rechazado | ## Padrón (`padron`) `arcli padron --json` devuelve los datos de la constancia de inscripción. Los campos que ARCA no informa salen en `null` (o `[]` en las listas): ```json { "actividades": [{ "descripcion": "SERVICIOS DE CONSULTORES EN INFORMATICA", "id": 620100 }], "avisos": [], "categoriaMonotributo": null, "condicionIva": "responsable-inscripto", "cuit": 20201797064, "deprecado": ["`cuit` pasa a ser texto en la 3.0.0: leelo como texto para que no te afecte."], "domicilio": "AV SIEMPRE VIVA 742, CABA, CP 1000, CIUDAD AUTONOMA BUENOS AIRES", "entorno": "testing", "estadoClave": "ACTIVO", "impuestos": [{ "activo": true, "descripcion": "IVA", "id": 30 }], "nombre": "PEREZ JUAN", "tipoPersona": "fisica" } ``` | Campo | Tipo | Descripción | | ---------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | `actividades` | `{ descripcion, id }[]` | Actividades; la primera es la principal | | `avisos` | `string[]` | Observaciones de ARCA sobre la constancia | | `categoriaMonotributo` | `string \| null` | Categoría, si es monotributista | | `condicionIva` | `string \| null` | `responsable-inscripto`, `responsable-monotributo` o `sujeto-exento`; `null` si no se puede deducir de los impuestos | | `cuit` | `number` | CUIT consultado | | `domicilio` | `string \| null` | Domicilio fiscal en una línea | | `entorno` | `"testing" \| "produccion"` | Entorno consultado | | `estadoClave` | `string \| null` | Estado de la clave fiscal según ARCA, por ejemplo `ACTIVO` | | `impuestos` | `{ activo, descripcion, id }[]` | Impuestos inscriptos | | `nombre` | `string \| null` | Razón social, o apellido y nombre | | `tipoPersona` | `"fisica" \| "juridica" \| null` | Tipo de persona | Si el CUIT no figura, es el error `TAXPAYER_NOT_FOUND` (ver [códigos](#códigos-de-error)). ## Régimen FCE (`fce-obligado`) `arcli fce-obligado --json`: ```json { "cuit": 30546689979, "deprecado": ["`cuit` pasa a ser texto en la 3.0.0: leelo como texto para que no te afecte."], "entorno": "testing", "fecha": "20261019", "montoDesde": 3958316, "obligado": true } ``` | Campo | Tipo | Descripción | | ------------ | --------- | -------------------------------------------------------------- | | `cuit` | `number` | CUIT consultado | | `fecha` | `string` | Fecha consultada, formato ARCA `yyyymmdd` (`--fecha` o hoy) | | `montoDesde` | `number` | Monto en pesos desde el que corresponde FCE | | `obligado` | `boolean` | `true` si el receptor está obligado a recibir FCE en esa fecha | | `entorno` | `string` | `testing` o `produccion` | ## Estado de ARCA (`estado`) `arcli estado --json`: ```json { "deprecado": ["`puntoVenta` pasa a ser un número en la 3.0.0: para el detalle usá `puntoVentaDetalle`."], "entorno": "produccion", "latenciaMs": 412, "listo": true, "puntoVenta": { "estado": "habilitado", "numero": 3, "tipoEmision": "CAE" }, "puntoVentaDetalle": { "estado": "habilitado", "numero": 3, "tipoEmision": "CAE" }, "servidores": { "aplicacion": "OK", "autenticacion": "OK", "baseDeDatos": "OK" } } ``` | Campo | Tipo | Descripción | | ------------------------ | ---------------- | ----------------------------------------------------------------------------------------------- | | `listo` | `boolean` | Se puede emitir: los tres servidores en `OK` y el punto de venta `habilitado` o `sin-datos` | | `latenciaMs` | `number` | Lo que tardó ARCA en responder el estado de los servidores | | `servidores` | `object` | `aplicacion`, `baseDeDatos` y `autenticacion`, tal como los informa ARCA (`OK` si andan) | | `puntoVentaDetalle` | `object` | Lo mismo que `puntoVenta`, que en la 3.0.0 pasa a ser un número. Se detalla abajo | | `puntoVenta.estado` | `string` | `habilitado`, `bloqueado`, `de-baja`, `no-encontrado`, `sin-datos` (testing) o `sin-configurar` | | `puntoVenta.numero` | `number \| null` | Punto de venta de la config; `null` si no hay | | `puntoVenta.tipoEmision` | `string \| null` | Tipo de emisión que informa ARCA, si encontró el punto de venta | | `entorno` | `string` | `testing` o `produccion` | `listo: false` **no es un error**: el comando sale con exit code `0`. Revisá `listo` en el JSON. Si ARCA no responde, sí es error: `ARCA_UNAVAILABLE`, con exit code `1`. ## Tablas de ARCA (`parametros`) `arcli parametros --json` lista las tablas (no consulta ARCA ni necesita config): ```json { "tablas": [ { "descripcion": "Alícuotas de IVA", "tabla": "alicuotas" }, { "descripcion": "Cotización oficial de ARCA", "tabla": "cotizacion" } ] } ``` `arcli parametros --json` devuelve los valores vigentes: ```json { "entorno": "testing", "tabla": "alicuotas", "valores": [{ "descripcion": "21%", "detalle": null, "id": "5", "vigenteHasta": null }] } ``` | Campo | Tipo | Descripción | | ------------------------ | ---------------- | ----------------------------------------------------------------------------------------- | | `valores[].id` | `string` | Código de ARCA | | `valores[].descripcion` | `string` | Descripción de ARCA | | `valores[].detalle` | `string \| null` | Dato propio de la tabla: clase de comprobante en `iva-receptor`, estado en `puntos-venta` | | `valores[].vigenteHasta` | `string \| null` | Fin de vigencia, `yyyymmdd`; `null` si no vence | En testing, `puntos-venta` sale con `valores: []`: ARCA no informa puntos de venta en ese entorno. `arcli parametros cotizacion --json`: ```json { "cotizacion": 1452.5, "entorno": "produccion", "fecha": "20261017", "moneda": "DOL" } ``` `moneda` es el código de ARCA (`USD` sale como `DOL`) y `fecha` (`yyyymmdd`) puede ser `null`. ## Configuración (`config` y `config revisar`) `arcli config --json` (y `config establecer` o `config eliminar` con `--json`, que devuelven la config resultante) muestra la config con las rutas enmascaradas. Las claves sin valor no aparecen: ```json { "alicuota": "21", "cert": { "testing": ".../certs/testing.crt" }, "concepto": "servicios", "consultarPadron": true, "cotizacion": 1, "cuit": "20333333334", "emisor": { "razonSocial": "Ana Gomez", "domicilio": "Calle 1, CABA" }, "emitir": false, "entorno": "testing", "exportacion": { "cert": {}, "key": {} }, "json": false, "key": { "testing": ".../certs/testing.key" }, "moneda": "PES", "pdf": "preguntar", "pdfCarpeta": ".../arcli/comprobantes", "puntoVenta": 3, "bruto": false, "ticketPath": ".../arcli/tickets" } ``` Las claves son las de [configuración](configuration.md), salvo que `cert.*`, `key.*`, `emisor.*` y `exportacion.*` van anidadas en los objetos `cert`, `key`, `emisor` y `exportacion` (vacíos si no hay nada; `exportacion` trae a su vez `cert`, `key` y, si está, `actividad`). `emitir`, `entorno`, `exportacion`, `json`, `bruto`, `pdf`, `pdfCarpeta`, `moneda`, `cotizacion`, `consultarPadron` y `ticketPath` siempre aparecen, con su valor por defecto si no se configuraron; el resto, solo si tiene valor. Si `filasPorLista` tiene valor (o el archivo tiene la clave vieja `comprobantesPorLista`), sale también `comprobantesPorLista` con el mismo valor, deprecada hasta la 3.0.0, y `deprecado` lo avisa (ver [Estabilidad del contrato](#estabilidad-del-contrato)). `arcli config revisar --json`: ```json { "chequeos": [ { "categoria": "ok", "detalle": "Entorno por defecto: testing.", "etiqueta": "Entorno" }, { "categoria": "warning", "detalle": "Configurá un punto de venta por defecto con `arcli config establecer puntoVenta `.", "etiqueta": "Punto de venta" }, { "categoria": "error", "detalle": "Falta el CUIT. Configuralo con `arcli config establecer cuit `.", "etiqueta": "Validación testing" } ], "ok": false } ``` `categoria` es `ok`, `warning` o `error`, y `ok` es `true` solo si todos los chequeos son `ok`. `ok: false` **no es un error**: el comando sale con exit code `0`, y también queda en `false` por sugerencias opcionales (`warning`). Para saber si un entorno puede emitir, mirá que no haya chequeos `error`. ## Plugin de PDF (`pdf estado`) `arcli pdf --json`, `arcli pdf estado --json` y `arcli pdf instalar --json` (al terminar) devuelven: ```json { "instalado": true, "navegador": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "origenNavegador": "sistema", "ruta": "/Users/ana/Library/Preferences/arcli/plugins/pdf", "version": "0.2.1", "versionInstalada": "0.2.1" } ``` | Campo | Tipo | Descripción | | ------------------ | ---------------- | -------------------------------------------------------------------------------------------- | | `instalado` | `boolean` | El plugin está instalado | | `navegador` | `string \| null` | Navegador que usa para el PDF; `null` si no encontró ninguno | | `origenNavegador` | `string \| null` | `config` (`pdfNavegador`), `entorno` (`PUPPETEER_EXECUTABLE_PATH`), `sistema` o `descargado` | | `ruta` | `string` | Carpeta del plugin | | `version` | `string` | Versión del plugin que usa esta versión de ARCLI | | `versionInstalada` | `string \| null` | Versión instalada; `null` si no está instalado | `arcli pdf desinstalar --json` devuelve `{ "desinstalado": true, "ruta": "..." }`. ## Certificados (`certificado`) `arcli certificado generar --json` devuelve el pedido y los pasos para ARCA: ```json { "alias": "arcli", "csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----\n", "cuit": "20123456786", "entorno": "produccion", "guia": "https://arcli.com.ar/empezar/certificado-testing/", "pasos": ["1. Entrá a ARCA con tu clave fiscal y abrí \"Administración de Certificados Digitales\".", "..."], "rutaClave": "/Users/ana/Library/Preferences/arcli/certificados/20123456786/produccion.nueva.key", "rutaCsr": "/Users/ana/Library/Preferences/arcli/certificados/20123456786/produccion.nueva.csr" } ``` `arcli certificado importar --json` devuelve lo que cargó: ```json { "alias": "arcli", "cuit": "20123456786", "entorno": "produccion", "reemplazado": false, "rutaCertificado": "/Users/ana/Library/Preferences/arcli/certificados/20123456786/produccion.crt", "rutaClave": "/Users/ana/Library/Preferences/arcli/certificados/20123456786/produccion.key", "vence": "2028-11-04T12:00:00.000Z" } ``` | Campo | Tipo | Descripción | | ------------- | ---------------- | ----------------------------------------------------------------- | | `alias` | `string \| null` | Nombre del certificado en ARCA (`CN` del certificado) | | `entorno` | `string` | `testing` o `produccion`, según quién firmó el certificado | | `reemplazado` | `boolean` | Había otro certificado configurado para el entorno y se reemplazó | | `vence` | `string` | Vencimiento, en ISO 8601 | Los errores de los dos comandos son los `CERTIFICATE_*` de la [tabla de códigos](#códigos-de-error); ninguno toca la config ni los archivos. ## Acceso directo y autocompletado `arcli acceso-directo --json` devuelve dónde quedó el acceso directo: ```json { "reemplazado": false, "ruta": "/Users/ana/Desktop/ARCLI.app", "usaArcliInstalado": false } ``` | Campo | Tipo | Descripción | | ------------------- | --------- | ----------------------------------------------------------------------------------------------- | | `reemplazado` | `boolean` | Ya había un acceso directo de ARCLI en esa carpeta y se actualizó | | `ruta` | `string` | Ruta del acceso directo | | `usaArcliInstalado` | `boolean` | Se creó desde el código fuente (`yarn dev`): abre el `arcli` instalado en lugar del que lo creó | `arcli completado --json`, `arcli completado instalar --json` y `arcli completado desinstalar --json` devuelven el estado del autocompletado: ```json { "cambio": true, "instalado": true, "ruta": "/Users/ana/.zshrc", "shell": "zsh" } ``` | Campo | Tipo | Descripción | | ----------- | --------- | --------------------------------------------------------------------------------- | | `cambio` | `boolean` | Solo en `instalar` y `desinstalar`: si se modificó el archivo de inicio del shell | | `instalado` | `boolean` | El autocompletado queda instalado | | `ruta` | `string` | Archivo de inicio del shell (`~/.zshrc`, `~/.bashrc`…) | | `shell` | `string` | `bash`, `zsh` o `fish` | ## Formato de errores Los errores salen en JSON con `--json` o, sin el flag, si la config tiene `json=true`. Van a stderr y el proceso termina con exit code `1`. Todos tienen las mismas cuatro claves: | Campo | Tipo | Descripción | | ------------ | ------------------------- | ---------------------------------------------------------------------------------------- | | `codigo` | `string` | Código estable del error (ver [códigos](#códigos-de-error)) | | `detalles` | `object \| array \| null` | Datos del error: un objeto, la lista de campos en errores de validación de Zod, o `null` | | `error` | `string` | Mensaje para mostrar | | `sugerencia` | `string \| null` | Qué hacer; `null` cuando no hay nada que sugerir | En los errores de ARCA, `detalles.errores` trae cada error con `codigo` y `mensaje`. Si `detalles.errors` también está, `detalles.deprecado` avisa que se saca en la 3.0.0. Un comprobante **rechazado por ARCA no es un error del comando**: sale como resultado normal (stdout, `estado: "rechazado"`, con `errores` y `observaciones`), pero el exit code es `2`. | Exit code | Cuándo | | --------- | ------------------------------------------------------------------------------------- | | `0` | Todo bien: comprobantes aprobados (también `observado`, que tiene CAE) o vista previa | | `1` | Error: entrada inválida, configuración, red o ARCA sin respuesta | | `2` | ARCA rechazó al menos un comprobante. En un lote, revisá `estado` de cada uno | Dos comandos de diagnóstico informan un problema sin que sea un error: `arcli config revisar` con `ok: false` y `arcli estado` con `listo: false` salen por stdout con exit code `0`. Para saber si está todo listo, leé `ok` o `listo` en el JSON, no el exit code. ### Códigos de error | Código | Comando | Qué pasó | Qué hacer | | ---------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `INPUT_VALIDATION_ERROR` | todos | Flags, argumentos o JSON de `--cargar` inválidos o incompletos | Corregí lo que indican `error` y `detalles`; no se emitió nada | | `CONFIGURATION_ERROR` | todos los que usan ARCA, `config` | Falta o es inválido un dato de la config: CUIT, certificado, clave, `config.json` corrupto | `arcli config revisar` y `arcli config establecer` | | `BATCH_VALIDATION_ERROR` | facturación con lote | Algún comprobante del lote es inválido; no se emitió ninguno | Corregí los índices de `detalles.comprobantes` y corré el lote completo ([detalle](#validación-y-errores-del-lote)) | | `BATCH_EMISSION_ERROR` | facturación con lote | El lote se cortó a mitad; los procesados salen antes por stdout | No reemitas los procesados; verificá `detalles.sinConfirmar` con `arcli ultimos` y reintentá `detalles.sinProcesar` | | `EMISSION_UNCERTAIN` | facturación | Falló la llamada que emite: puede haberse emitido igual | Seguí la `sugerencia` antes de reintentar ([detalle](#emisión-sin-confirmar)) | | `TRANSIENT_ERROR` | todos los que usan ARCA | WSAA o ARCA informan un estado pasajero (ticket vigente, transacción activa) | Esperá unos segundos y reintentá sin cambiar nada | | `UNEXPECTED_ERROR` | todos | Error sin código propio: red, login en WSAA (certificado no autorizado o revocado; uno vencido corta antes con `CERTIFICATE_EXPIRED`), respuesta inesperada de ARCA | Leé `error`; si es de red o de ARCA, reintentá más tarde | | `ARCA_UNAVAILABLE` | `estado` | ARCA no respondió a la consulta de estado | Reintentá en unos minutos; si persiste, ARCA está caído | | `ARCA_PARAMETERS_ERROR` | `parametros ` | ARCA devolvió un error al consultar una tabla o los puntos de venta (`detalles.errores`) | Revisá el mensaje de ARCA; suele ser pasajero o de permisos del certificado | | `ARCA_QUOTATION_ERROR` | `parametros cotizacion`, facturación en moneda extranjera sin `--cm`, `fe` | ARCA no devolvió una cotización válida para la moneda | Revisá el código de moneda (`arcli parametros monedas`) o pasá la cotización con `--cm` (sin `--misma-moneda`) | | `ARCA_LAST_VOUCHER_ERROR` | facturación, `ultimos` | ARCA devolvió un error al pedir el último número (`detalles.errores`); no se emitió nada | Si es del punto de venta (11002), revisá `arcli parametros puntos-venta`; si no, el mensaje de ARCA y reintentá | | `VOUCHER_NOT_FOUND` | `consultar` | El comprobante no existe en ese punto de venta y entorno | Revisá tipo, número, `--pv` y entorno; `arcli ultimos` lista los emitidos | | `TAXPAYER_NOT_FOUND` | `padron` | El CUIT no figura en el padrón de ese entorno | Revisá el número; en testing el padrón tiene datos ficticios (`sugerencia` trae un CUIT de prueba) | | `PADRON_SERVICE_NOT_AUTHORIZED` | `padron` | El certificado no está autorizado para `ws_sr_constancia_inscripcion` | Autorizalo como `wsfe` ([certificados](obtencion-certificados.md)). Al facturar no corta: se usa `ivaReceptor` de la config con un aviso | | `FCE_SERVICE_NOT_AUTHORIZED` | `fce-obligado` | El certificado no está autorizado para `wsfecred` | Autorizalo como `wsfe` ([certificados](obtencion-certificados.md)). Con `verificarFce` al facturar no corta: sale como aviso | | `WSFE_SERVICE_NOT_AUTHORIZED` | facturación (A, B, C, FCE, recibo), `ultimos` y `consultar` | El certificado no está autorizado a facturar (`wsfe`); no se emitió nada | Autorizalo en WSASS (testing) o en el Administrador de Relaciones (producción): [certificados](certificado-testing-completa.md#3-autorizar-el-servicio-web) | | `WSFEX_SERVICE_NOT_AUTHORIZED` | `fe`, `factura e` | El certificado no está autorizado para `wsfex` | Autorizalo como `wsfe` ([certificados](obtencion-certificados.md)) o configurá `exportacion.cert.*`/`exportacion.key.*` | | `ARCA_EXPORT_ERROR` | `fe`, `factura e` | WSFEX devolvió un error al consultar una tabla, el ID de solicitud o la cotización (`detalles.errores`) | Revisá el mensaje de ARCA; no se emitió nada | | `FCE_OBLIGATION_ERROR` | `fce-obligado` | ARCA no pudo informar si el receptor está obligado a FCE (`detalles.errores`) | Revisá el CUIT y la fecha; los códigos de ARCA vienen en el mensaje. Al facturar sale como aviso | | `CERTIFICATE_REQUEST_PENDING` | `certificado generar` | Ya hay un pedido del entorno sin importar | Importá el certificado de ese pedido, o sumá `--reemplazar` para descartarlo y armar otro | | `CERTIFICATE_INVALID` | `certificado importar` | El archivo no tiene un certificado X.509 | Usá el `.crt` que bajaste de ARCA, sin abrirlo ni guardarlo con otro programa | | `CERTIFICATE_CUIT_MISMATCH` | `certificado importar` | El certificado es de otro CUIT que el de la config | Bajalo con la clave fiscal del CUIT configurado, o cambiá `cuit` | | `CERTIFICATE_EXPIRED` | todos los que usan ARCA, `certificado importar` | El certificado del entorno ya venció ([detalle](#certificado-vencido)); en `importar`, el que se quiso cargar | Renovalo con `arcli certificado generar` | | `CERTIFICATE_ENVIRONMENT_UNKNOWN` | `certificado importar` | El emisor no es una autoridad de ARCA conocida | Si es de ARCA, indicá el entorno con `--testing` o `--produccion` | | `CERTIFICATE_KEY_MISMATCH` | `certificado importar` | El certificado no corresponde a la clave del pedido ni a la configurada | Bajá el certificado que creaste con el último CSR de `arcli certificado generar` | | `CERTIFICATE_REPLACE_CONFIRMATION` | `certificado importar` | Ya hay otro certificado configurado para ese entorno | Sumá `--reemplazar` (en una terminal, se pregunta) | | `DESKTOP_SHORTCUT_ERROR` | `acceso-directo` | Windows no pudo crear el `.lnk` | Revisá los permisos de la carpeta y que PowerShell esté disponible | | `PDF_PLUGIN_INSTALL_ERROR` | `pdf instalar` | No se pudo descargar el plugin o el navegador | Revisá la conexión o el proxy de npm y reintentá | | `PDF_*` en `pdf.error` | facturación con PDF | No es un error del comando: el comprobante se emitió y falló solo el PDF | Ver [errores del PDF](#errores-del-pdf); no reemitas | ### Errores JSON de validación Cuando el error viene de Zod o de validación de entrada: ```json { "codigo": "INPUT_VALIDATION_ERROR", "detalles": [ { "mensaje": "Falta el dato: monto.", "ruta": ["montoTotal"] } ], "error": "Hay parámetros inválidos o incompletos en la entrada.", "sugerencia": null } ``` ### Errores JSON de uso Una opción desconocida, un valor faltante o un comando que no existe también sale en JSON cuando corresponde (`--json` o `json=true` en la config), con exit code `1`. El mensaje es el de commander traducido al español, en una sola línea. `--ayuda` y `--version` no son errores. ```json { "codigo": "INPUT_VALIDATION_ERROR", "detalles": null, "error": "opción desconocida `--montoo` (¿quisiste decir `--monto`?)", "sugerencia": "Usá `arcli ayuda` o `arcli --ayuda` para ver comandos y opciones." } ``` ### Errores JSON de configuración ```json { "codigo": "CONFIGURATION_ERROR", "detalles": null, "error": "Falta la ruta del certificado para testing. Configurá \"cert.testing\".", "sugerencia": null } ``` Si el `config.json` tiene JSON inválido, sale con el mismo código, la ruta del archivo y qué hacer: ```json { "codigo": "CONFIGURATION_ERROR", "detalles": { "ruta": "/Users/ana/Library/Preferences/arcli/config.json" }, "error": "El archivo de configuración tiene JSON inválido y no se puede leer.", "sugerencia": "Corregilo a mano, o renombralo (por ejemplo, a config.json.bak) y volvé a cargar los datos con `arcli config establecer` o desde \"Configuración\" en `arcli`. ARCLI no lo borra ni lo pisa." } ``` ### Certificado vencido Con el certificado del entorno vencido, los comandos que van a ARCA cortan antes de autenticar en WSAA: no se envió nada y no hay que verificar. Con `--json` no sale el banner, solo este error en stderr: ```json { "codigo": "CERTIFICATE_EXPIRED", "detalles": { "entorno": "produccion", "vencimiento": "20/11/2026" }, "error": "El certificado de producción venció el 20/11/2026: ARCA no lo acepta.", "sugerencia": "Renovalo con `arcli certificado generar --produccion` y cargá el .crt de ARCA con `arcli certificado importar `. Guía: https://arcli.com.ar/empezar/certificado-testing/" } ``` ### Emisión sin confirmar Si falla la llamada que emite en ARCA (red, timeout, transacción activa), no se sabe si el comprobante quedó autorizado: pudo emitirse y perderse la respuesta. **No reintentes sin verificar**, porque se duplicaría. Los pasos previos no cuentan: si falla el login en WSAA (por ejemplo, un certificado no autorizado; uno vencido corta antes, con [`CERTIFICATE_EXPIRED`](#certificado-vencido)) o el pedido del último número, no se envió nada: sale como `ARCA_LAST_VOUCHER_ERROR` si ARCA devolvió errores, o como `UNEXPECTED_ERROR` o `TRANSIENT_ERROR` si falló la red o WSAA. ```json { "codigo": "EMISSION_UNCERTAIN", "detalles": { "causa": "socket hang up" }, "error": "No se pudo confirmar la emisión: socket hang up", "sugerencia": "Puede haberse emitido igual. Antes de reintentar, verificá con `arcli ultimos fc --pv 3`: si figura, ya está emitido y no hay que repetirlo." } ``` En la E el número ya está fijado en la solicitud, y ARCA no autoriza dos comprobantes con el mismo número. Por eso la `sugerencia` manda a verificar ese número con `arcli consultar` y, si hay que reintentar, a usar los mismos `--numero` e `--id-solicitud`, que también vienen en `detalles`: ```json { "codigo": "EMISSION_UNCERTAIN", "detalles": { "causa": "socket hang up", "idSolicitud": 42, "numero": 7 }, "error": "No se pudo confirmar la emisión: socket hang up", "sugerencia": "Puede haberse emitido igual. Verificalo con `arcli consultar fe 7 --pv 3 --testing`: si figura, ya está emitido. Si reintentás, usá el mismo número y la misma solicitud (`--numero 7 --id-solicitud 42 --pv 3 --testing`): si ya se había emitido, ARCA no lo autoriza dos veces." } ``` En un lote, el mismo caso sale como `BATCH_EMISSION_ERROR` con `detalles.sinConfirmar` (el índice que hay que verificar). ### Errores transitorios o inesperados ```json { "codigo": "TRANSIENT_ERROR", "detalles": null, "error": "ns1:coe.alreadyAuthenticated", "sugerencia": "ARCA todavía tiene abierta una sesión anterior. Esperá un par de minutos y probá de nuevo, con los mismos datos." } ``` ### Errores del PDF Un error del PDF **no** es un error del comando: el comprobante ya se emitió, así que el error va dentro del resultado, en `pdf.error`, y el código de salida no cambia. Los códigos son `PDF_PLUGIN_MISSING`, `PDF_PLUGIN_INSTALL_ERROR`, `PDF_ISSUER_INCOMPLETE` y `PDF_GENERATION_ERROR`. Ver [PDF de comprobantes](pdf.md#salida). `arcli pdf instalar` sí falla como un comando, con `sugerencia`: ```json { "codigo": "PDF_PLUGIN_INSTALL_ERROR", "detalles": { "salida": "npm error code ECONNREFUSED" }, "error": "npm no pudo instalar @arcasdk/pdf.", "sugerencia": "Revisá la conexión a internet o el proxy de npm y volvé a correr `arcli pdf instalar`." } ``` ## Diferencias entre modos | Modo | Llama a ARCA | Devuelve solicitud | Devuelve respuesta real | Contrato recomendado | | ----------------- | -------------- | ------------------ | ---------------------------------------------- | ---------------------------------- | | texto | depende | sí | depende | uso humano | | `--json` | depende | sí | resumen serializado | automatización | | `--json --bruto` | depende | sí | resumen + cruda (`respuesta`), si hubo emisión | automatización con detalle técnico | | `--previsualizar` | solo consultas | sí | no | revisión previa | | `--emitir` | sí | sí | sí | operación real | --- # Reglas de validación Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/validation-rules.md Resumen rápido: - primero ARCLI valida flags, tipos y combinaciones - después aplica reglas de negocio del comprobante - por último pueden aparecer restricciones o errores propios de ARCA La idea de esta guía es separar esas tres capas para que sea más fácil entender dónde se rompió el flujo. ## 1. Validaciones del CLI ### Flags mutuamente excluyentes - `--testing` y `--produccion` - `--emitir` y `--previsualizar` - `--concepto` y cualquiera de `--cs`, `--cp`, `--csp` - `--iva-receptor`, `--ir` y cualquier `--ir-*` - `--ac` y `--at` - `--misma-moneda` y `--cotizacion-moneda` / `--cm` - `--condicion-venta` / `--cv` y `--sin-condicion-venta` - `--exportar-pdf` y `--sin-pdf` - en el JSON de `--cargar`, `"emitir": true` y `"previsualizar": true` a la vez - combinaciones múltiples de identidad del receptor: - `--cuit` - `--cuil` - `--dni` - `--consumidor-final` - `--cfinal` ### Tipos y formatos - `--monto` debe ser un número positivo - `--dia` (deprecado: usá `--vencimiento` o `--vto`) debe ser un entero entre `1` y `31`. Fija solo el vencimiento: este mes si el día todavía no pasó y si no, el siguiente; si ese mes no tiene ese día (`--dia 31` en abril), da error. No se combina con `--vencimiento`/`--vto` - `--punto-venta`, `--pv`, `--at`, `--apv`, `--ar` deben ser enteros positivos, escritos solo con dígitos (`3a` da error) - `--cuit`, `--cuil`, `--acuit` y `--dni` aceptan guiones y puntos (`20-33333333-4`), pero nada más. Lo mismo el CUIT de `arcli padron`, `arcli fce-obligado`, `config establecer cuit` y `comprobanteAsociado.cuit` en el JSON - `--at` se valida igual que `--ac`: una NC A no puede asociar una factura B. Si en el JSON vienen `tipo` y `atajo`, tienen que coincidir - `--cotizacion-moneda` y `--cm` deben ser números positivos - Todo CUIT o CUIL debe tener 11 dígitos y un dígito verificador válido: un número mal tipeado da error antes de llegar a ARCA - `--dni` debe tener 7 u 8 dígitos - `--condicion-venta` / `--cv` (y `condicionVenta` en el JSON o la config) acepta hasta 100 caracteres - En el JSON de `--cargar`, una clave desconocida o un tipo incorrecto (`"puntoVenta": "3"`) es error: ver [claves desconocidas y tipos](input-output.md#claves-desconocidas-y-tipos) ### Fechas aceptadas ARCLI interpreta las fechas en formato argentino (día primero), con mes y año opcionales: - `D` o `DD` - `D-MM` o `D/MM` - `D-MM-YY` o `D/MM/YY` - `D-MM-YYYY` o `D/MM/YYYY` Reglas de interpretación: - "hoy" es siempre el día en Argentina, aunque el equipo esté en otra zona horaria (por ejemplo un servidor en UTC después de las 21 h) - si omitís el año, ARCLI usa el de la fecha más cercana a hoy: el 5/1/2027, `1/12` es el 1/12/2026; el 28/12/2026, `10/1` es el 10/1/2027. Para una fecha a más de seis meses, escribí el año - si omitís mes y año, ARCLI usa el mes y año actuales - un año de 2 dígitos se interpreta como `20YY` - no se pueden mezclar separadores dentro de la misma fecha (por ejemplo, `5-3/26` no es válido) Formatos como `YYYY-MM-DD` no son válidos. Si el formato no coincide, ARCLI corta antes de armar el payload. ### Emisión en producción ARCLI no tiene una regla aparte para producción: emite si `--emitir` lo pide o, sin `--emitir` ni `--previsualizar`, si lo pide `"emitir"` del JSON de `--cargar` o `config.emitir`. Con `entorno produccion` y `emitir true` en la config, un comando sin flags emite en producción sin preguntar. Si nada pide emitir, en una terminal se muestra la vista previa y se pregunta; con `--json` o sin terminal no se emite. Detalle en [Emisión en producción](cli-reference.md#emisión-en-producción). ## 2. Reglas de negocio ### Punto de venta - Puede venir por flags o por config. - Si falta en ambos lugares, el flujo falla antes de emitir. ### Concepto y fechas de servicio #### `productos` - no usa `--servicio-desde` - no usa `--servicio-hasta` - no usa `--vencimiento` ni `--dia`, salvo en facturas FCE #### `servicios` y `productos-servicios` - si informás una fecha de servicio, tenés que informar ambas - la fecha de inicio no puede ser posterior a la de fin #### Vencimiento de pago (`FchVtoPago`) | Comprobante | ¿Se envía? | Default sin `--vencimiento` | Mínimo | | ---------------------------------------------------------- | ---------- | --------------------------------------------------------------- | -------------------------------------- | | Servicios / productos y servicios | sí | el fin del servicio, o la fecha del comprobante si es posterior | fecha del comprobante (10036) | | Factura FCE (`fcea`, `fceb`, `fcec`), incluso de productos | sí (10163) | la fecha del comprobante o hoy, la que sea posterior | la fecha del comprobante o hoy (10164) | | NC/ND FCE | no (10175) | — | `--vencimiento` da error | | Productos (no FCE) | no | — | `--vencimiento` da error | `--vencimiento` permite separar el vencimiento del período facturado. Por ejemplo, un servicio de febrero facturado el 18/03 que vence el 10/04. `--dia` (deprecado) sigue las mismas reglas que `--vencimiento`. ### Fecha del comprobante ARCA solo acepta una `CbteFch` cercana a la fecha de envío (errores 10016 y 10152). ARCLI lo valida antes de llamar al servicio: | Comprobante | Desde | Hasta | Fecha futura | | --------------------------------- | ------------- | ------------- | -------------------------- | | Productos | hoy − 5 días | hoy + 5 días | solo dentro del mes actual | | Servicios / productos y servicios | hoy − 10 días | hoy + 10 días | sin restricción de mes | | FCE (facturas y notas) | hoy − 5 días | hoy + 1 día | solo dentro del mes actual | ARCA además exige que la fecha no sea anterior a la del último comprobante emitido para ese tipo y punto de venta. Esa regla no se valida localmente, porque depende de lo ya emitido. ### Identidad del receptor #### Consumidor final Si usás consumidor final: - el documento debe ser `0` - el IVA receptor debe ser `consumidor-final`: con `--consumidor-final` (o `tipoDocumento: "consumidor-final"` en el JSON) ARCLI ya lo asume y no hace falta `--ir-cf`, aunque la config tenga otro `ivaReceptor`. Un IVA explícito distinto (`--ir-rm` con `--cfinal`) es error - el total en pesos tiene que ser menor a `$ 10.000.000`. Desde ese monto hay que identificarlo con `--dni`, `--cuit` o `--cuil` ([RG 5700/2025](https://www.consejosalta.org.ar/wp-content/uploads/ARCA-5700.pdf)). En moneda extranjera se compara `monto × cotización`. #### CUIT, CUIL y DNI - si el tipo de documento no es `consumidor-final`, ARCLI exige `numeroDocumento` ### IVA receptor ARCLI exige una única fuente de IVA receptor: - `--iva-receptor ` - `--ir ` - un solo `--ir-*` - `--consumidor-final`, que implica `consumidor-final` - o un default configurado Además, la condición tiene que ser válida para la letra del comprobante. ARCLI aplica la misma tabla que devuelve ARCA en `FEParamGetCondicionIvaReceptor` (error 10243): | Letra | IVA receptor admitido | | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `A` | `responsable-inscripto`, `responsable-monotributo`, `monotributista-social`, `monotributo-trabajador-independiente-promovido` | | `B` | `sujeto-exento`, `consumidor-final`, `sujeto-no-categorizado`, `proveedor-del-exterior`, `cliente-del-exterior`, `iva-liberado`, `iva-no-alcanzado` | | `C` | todas | Si la combinación no es válida, el error sugiere la letra que corresponde. Ejemplo: `fb` con `--ir-ri` sugiere usar letra `A`. ### Comprobantes asociados Aplica a: - `nota-credito` - `nota-debito` - `nota-credito-electronica` - `nota-debito-electronica` No aplica a: - `factura` - `factura-credito-electronica` - `recibo` (`rc`) Para notas, ARCLI acepta un comprobante asociado **o** un período asociado (`PeriodoAsoc`), pero no ambos (10197). Período asociado (`--periodo-desde` y `--periodo-hasta`): - solo en notas comunes: en facturas (10198) y en notas FCE (10196) da error - requiere las dos fechas - desde ≤ hasta (10207), y ambas posteriores al 01/01/2006 (10206) - hasta ≤ fecha de la nota (10208) Comprobante asociado (si no se usa el período), que necesita: - `--ac` o `--at` - `--apv` o `--asociado-punto-venta` - `--ar` - `--acuit`, salvo en NC/ND FCE, donde se puede omitir y toma el CUIT emisor Con período asociado no hace falta ninguno de estos flags, `--acuit` incluido. Además: - el asociado debe ser una factura o un Recibo C, no otra nota - la letra debe coincidir - la categoría electrónica debe coincidir - `--afecha` es opcional y no puede ser posterior a la fecha de la nota (10159). En NC/ND FCE ARCA la exige (10158): sin `--afecha`, ARCLI la toma del asociado en ARCA antes de la vista previa; si ARCA no lo tiene o no responde, es error - una nota de crédito no puede superar el total del asociado cuando van en la misma moneda. Se controla antes de la vista previa, con una consulta del asociado en ARCA (`FECompConsultar`) por nota que se reusa al emitir, y es un `INPUT_VALIDATION_ERROR` con la sugerencia del `--monto` que la anula entera. Solo se consulta un asociado del propio emisor; si ARCA no responde, la nota sigue con un aviso ### Crédito electrónico (FCE) ARCLI arma `Opcionales` (los "Adicionales por R.G.") según el comprobante: | Comprobante | `Opcionales` | Reglas | | ------------------------------------ | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Factura FCE (`fcea`, `fceb`, `fcec`) | `2101` CBU, `2102` alias (si se informa), `27` transferencia | El CBU es obligatorio (10168) y tiene 22 dígitos (10165). El alias tiene de 6 a 20 caracteres (10166). La transferencia es `SCA` o `ADC`, por defecto `SCA` (10216). `--anulacion` da error (10171). | | NC/ND FCE (`ncea`…`ndec`) | `22` anulación: `S` con `--anulacion`, si no `N` | Obligatorio (10173). `--cbu`, `--alias` y `--transferencia` dan error (10172). Sin `--afecha`, la fecha del asociado sale de ARCA (10158). El asociado tiene que ser del CUIT emisor (10155), así que `--acuit` se puede omitir. | | Resto | ninguno | `--cbu`, `--alias`, `--transferencia` y `--anulacion` dan error (10169). | ### Régimen FCE del receptor Con `config.verificarFce` en `true`, ARCLI consulta `wsfecred` (`consultarMontoObligadoRecepcion`) antes de la vista previa. La consulta corre en facturas comunes y FCE con `--cuit` del receptor, usando la fecha del comprobante. Los avisos posibles son: | Comprobante | Receptor | Aviso | | ---------------------- | ------------------------------------ | ----------------------------------- | | `fa`, `fb`, `fc` | obligado y monto (en pesos) ≥ mínimo | Corresponde `fcea`, `fceb` o `fcec` | | `fcea`, `fceb`, `fcec` | no obligado | Corresponde `fa`, `fb` o `fc` | | `fcea`, `fceb`, `fcec` | obligado, pero monto < mínimo | Corresponde `fa`, `fb` o `fc` | Los avisos aparecen en la salida de texto (panel "Avisos") y en el campo `avisos` del JSON. No frenan la emisión. Si la consulta falla, por ejemplo porque el certificado no tiene autorizado `wsfecred`, el motivo también llega como aviso. `config.cbu` y `config.aliasCbu` solo se aplican a facturas FCE. ARCA además exige que el CBU esté registrado a nombre del emisor (10174), cosa que no se puede validar localmente. ### Moneda y cotización `--moneda` acepta el código ISO o el de ARCA de cualquier moneda de la tabla de ARCA (`arcli parametros monedas`) que tenga ISO: `ARS` → `PES`, `USD` → `DOL`, `EUR` → `060`, `UYU` → `011`… Un código que no está en la tabla se envía tal cual. | Caso | `MonCotiz` | `CanMisMonExt` | Regla | | ----------------------------------- | ------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Pesos | `1` | no se envía | Una cotización distinta de `1` da error (ARCA 10039 y 10241). `--misma-moneda` da error. | | Moneda extranjera, pago en pesos | `--cm` o la oficial | `N` | Sin `--cm`, ARCLI usa la oficial de ARCA y lo avisa. `--cm 1` da error. ARCA la acepta entre el 2% y el 400% de la oficial (10119). | | Moneda extranjera, `--misma-moneda` | la oficial de ARCA | `S` | ARCLI la consulta antes de la vista previa porque ARCA exige el valor exacto (10038). La fecha del comprobante tiene que ser la de hoy: la cotización de un día pasado no se puede consultar y la de uno futuro todavía no existe. | La clave `cotizacion` de la config (deprecada) se usa como default en moneda extranjera sin `--misma-moneda` ni `--cm`, con un aviso; si vale `1` o no está, se usa la oficial de ARCA. ### Factura de exportación (E) WSFEX tiene su propio contrato: las reglas de concepto, fecha de servicio, IVA receptor, IVA y comprobante asociado no corren para `E`, y tampoco se usan `concepto`, `ivaReceptor`, `alicuota`, `cbu` ni `aliasCbu` de la config. | Regla | Detalle | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Requeridos | `--monto` > 0, `--cliente`, `--domicilio-cliente`, `--pais-destino`, `--numero` y la actividad (`--actividad` o `exportacion.actividad`). Se validan antes de ir a ARCA | | País de destino | Código (`203`) o nombre (`Brasil`), contra la tabla de WSFEX. Argentina (`200`) da error: para el mercado local van `arcli factura a` o `arcli factura b` | | CUIT del país | `--cuit-pais` tiene que existir en la tabla de CUIT de países y ser del país de destino. Sin el flag se busca por país, prefiriendo la fila de persona jurídica; si la tabla no trae el país, pide el flag. La tabla nombra cada país con el tipo de entidad (`BRASIL - Persona Jurídica`), así que el sufijo, los acentos y las mayúsculas no cuentan, y cuando las dos tablas lo nombran distinto (`CHINA` y `CHINA REP.POPULAR`) solo se valida que el CUIT exista | | Ítems | `--item` con 3 a 5 partes separadas por `\|`: cantidad y precio mayores a 0, descripción obligatoria. La unidad es un código de ARCA o el nombre de la tabla de unidades, sin mayúsculas y con singular o plural (`unidad` o `unidades`); una unidad desconocida es error | | Suma de ítems | Se redondea cada renglón a 2 decimales y la suma tiene que coincidir con `--monto`. Se valida antes de WSAA, no lo valida ARCA | | `--tipo-expo` | `1` bienes, `2` servicios (por defecto) o `4` otros | | Actividad | Entero positivo, de `--actividad` o de `exportacion.actividad`; no hay default. El `Cmp` siempre lleva una `Actividad` (ARCA rechaza `Actividades` vacío con el error 2100). Se compara con la tabla de actividades de WSFEX (`FEXGetPARAM_Actividades`), que no es la del padrón: si el código no está, es error de validación con las actividades que empiezan igual, porque ARCA lo rechaza (error 2105) | | Bloques vacíos | En la factura, `Cmps_asoc` y `Opcionales` no se envían: ARCA rechaza el bloque vacío (error 1820 el de `Cmps_asoc`) | | `--incoterm` | Código de la tabla, sin importar mayúsculas. Si no pasás `--incoterms-desc`, la descripción sale de la tabla | | `--idioma` | Código de la tabla; por defecto `1` (español) | | Permisos | `--permiso` requiere `--permiso-existente` y `--permiso-existente` sin permisos es error. Se deduplican y solo aplican a `--tipo-expo 1`: en `2` (servicios) y `4` (otros) ARCA exige `Permiso_existente` vacío (error 1550), así que ARCLI manda el campo en `""` y rechaza los permisos. Sin permisos el campo `Permisos` no se envía: ARCA lo rechaza (error 1720) cuando `Permiso_existente` es `N` | | Numeración | WSFEX numera por punto de venta y tipo: sin `--numero` sale del último de ese tipo más uno (`FEXGetLast_CMP`). `--numero`, `--id-solicitud` y `--punto-venta` son enteros positivos (máximo 99.999.999); sin `--id-solicitud` sale del último de WSFEX más uno | | Fecha | La del comprobante no puede ser futura; `--fecha-pago` por defecto es la del comprobante | | Moneda | Por defecto `DOL` (dólares); `--moneda` acepta `ARS`/`PES` y el resto de la tabla de monedas de WSFEX (`DOL`, `PES`, `060`…). La cotización que falta sale de `FEXGetPARAM_MON_CON_COTIZACION`, la cotización de aduana de WSFEX, pedida con la fecha del comprobante —por defecto hoy— en `yyyymmdd` (`Fecha_CTZ`). ARCA publica la del día una vez por día: hasta entonces se usa la última publicada y la vista previa avisa de qué día es. Para fijar otra, `--cotizacion-moneda`, que tiene que ser mayor a 1. En pesos la cotización es 1 y `--misma-moneda` no aplica | | Defaults de config | Aplican `puntoVenta` y `exportacion.actividad`. `moneda` y `cotizacion` no: la exportación va en `DOL` salvo `--moneda`, con la cotización de aduana de ARCA salvo `--cotizacion-moneda`. Los de concepto, IVA, CBU y padrón tampoco | ### Notas de crédito y débito de exportación (E) `nce` y `nde` siguen las reglas de la factura `E`, con estas diferencias. Todo se valida antes de emitir; lo que depende del asociado, después de consultarlo en ARCA (`FEXGetCMP`). | Regla | Detalle | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Asociado | `--ar` obligatorio. `--ac` (`fe`, `nde`, `nce`) o `--at` (`19`, `20`, `21`); por defecto una factura `E`. Si van los dos, tienen que coincidir | | CUIT del asociado | Siempre el emisor: `--acuit` con otro CUIT es error (ARCA lo rechaza con el 2031) | | Existencia | El asociado tiene que existir en ARCA y estar aprobado | | Datos que hereda | Cliente, domicilio, ID impositivo, destino, CUIT del país, tipo de exportación, moneda, cotización (si la moneda es la misma), idioma, incoterm, forma de pago y actividad | | Fecha | No puede ser anterior a la del asociado | | Monto de la NC | No puede superar el total del asociado cuando van en la misma moneda | | Servicios (`2`) | Mismo tipo de exportación (2049), destino (2050), moneda o pesos (2051) y cotización (2053) que el asociado. La ND solo ajusta una factura (2041, 2042); la NC no ajusta otra NC (2045) | | No van | `--fecha-pago` (1673), `--misma-moneda` (1605) y `--permiso-existente`. `Permiso_existente` va vacío (1550); en bienes, `--permiso` es opcional y va sin él y `Cmps_asoc` lleva un solo asociado (1754) | ### IVA automático ARCLI calcula IVA automáticamente en todos los comprobantes letra `A` y `B`, sea cual sea el IVA receptor. Los letra `C` no informan IVA. El total se reparte así (ARCA 10048): ``` ImpTotal = ImpTotConc (--nogravado) + ImpOpEx (--exento) + ImpNeto + ImpIVA ``` - `ImpNeto` e `ImpIVA` salen del resto del total con la alícuota de `--alicuota`, o la de `config.alicuota`, o `21`. Se redondean a 2 decimales. `config.alicuota` no se aplica a letra `C`. - `--exento` + `--nogravado` no pueden superar el total. Si lo igualan, no hay neto gravado ni array `Iva`. - Con neto mayor a cero siempre se envía el array `Iva`, también al 0% (10070). - En letra `C`, `--alicuota`, `--exento` y `--nogravado` dan error, porque ARCA exige que esos importes sean cero. | Alias | Número | Id ARCA | | -------------- | ------ | ------- | | `cero` | `0` | `3` | | — | `2.5` | `9` | | — | `5` | `8` | | `reducida` | `10.5` | `4` | | `general` | `21` | `5` | | `incrementada` | `27` | `6` | `--alicuota` acepta el alias o el número, con coma o punto decimal y un `%` final (`reducida`, `10,5`, `10.5`, `10.5%`). #### Varias alícuotas en un comprobante Repetí `--alicuota TASA:MONTO`, con el importe de cada alícuota **IVA incluido**, igual que `--monto`: ```bash arcli fa --cs --cuit 30709965812 --ir-ri --alicuota general:1210 --alicuota reducida:552,50 ``` - Cada monto se parte en neto e IVA según su tasa, y se envía una entrada de `Iva` por alícuota. La suma de los netos es `ImpNeto` (10061). - `--monto` pasa a ser opcional. Sin él, el total es la suma de las alícuotas más `--exento` y `--nogravado`. Si lo pasás, tiene que coincidir exactamente con esa suma. - Si la misma alícuota aparece dos veces, se suman sus montos. - No se puede mezclar `--alicuota TASA` con `--alicuota TASA:MONTO`, ni repetir `--alicuota TASA` sin monto. - En JSON: `"alicuotas": [{ "tasa": "general", "monto": 1210 }, { "tasa": "10.5", "monto": 552.5 }]`. ### Recibo C El Recibo C (`rc`, tipo ARCA 15) usa las mismas validaciones y el mismo armado que la Factura C: letra `C`, sin IVA, sin comprobante asociado y sin FCE. Puede ser el asociado de una nota de crédito o débito C (`--ac rc` o `--at 15`). ARCA es quien acepta o rechaza el tipo según el punto de venta y la condición del emisor. ## 3. Restricciones y errores de ARCA Hay rechazos que ARCLI no puede anticipar: errores transitorios de WSAA (`coe.alreadyAuthenticated`, `Transacción Activa`), receptor igual al emisor, observaciones de padrón y fechas anteriores al último comprobante emitido. Ver [Troubleshooting](troubleshooting.md#arca) y [Limitaciones](limitations.md). --- # Glosario Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/glossary.md Términos de facturación electrónica argentina que aparecen en la documentación de ARCLI. Pensado para alguien que nunca facturó por ARCA/AFIP y necesita una referencia rápida sin salir de los docs. ## Organismo y servicios ### Testing y producción Testing (homologación) es el ambiente de prueba de ARCA: podés emitir sin que cuente, y los comprobantes no tienen validez fiscal. Producción es el real: lo que emitís ahí vale y no se borra. ARCLI arranca en testing. ### ARCA / AFIP ARCA (Agencia de Recaudación y Control Aduanero) es el organismo que sucedió a AFIP como autoridad fiscal argentina. ARCLI habla con los web services de ARCA para autorizar comprobantes; en la documentación y en el código, "ARCA" y "AFIP" se usan como sinónimos del mismo organismo. ### WSAA Web Service de Autenticación y Autorización. Es el servicio de ARCA que entrega un [TA](#ta) a partir del certificado y clave configurados. Todo comprobante necesita un TA válido antes de poder emitirse. ### TA Ticket de Acceso. Credencial temporal que devuelve WSAA y que habilita a operar contra los servicios de facturación de ARCA por un tiempo limitado. Si ARCLI pide uno nuevo mientras el anterior sigue vigente, ARCA responde `coe.alreadyAuthenticated` (ver [Troubleshooting](troubleshooting.md)). ### Padrón Base de datos de ARCA con la situación fiscal de cada CUIT. Un comprobante puede aprobarse pero igual traer una observación de padrón (por ejemplo `10217` o `10017`) según la condición del receptor, sin que eso implique un error del CLI. ### wsfe / wsfex / wsfecred / ws_sr_constancia_inscripcion Servicios web de ARCA que usa ARCLI: `wsfe` emite las facturas, notas y recibos A, B y C; `wsfex`, la factura de exportación E; `wsfecred` consulta el régimen FCE del receptor; `ws_sr_constancia_inscripcion` es el padrón (`arcli padron` y el IVA receptor desde el padrón). Cada uno se autoriza aparte en ARCA. Ver [Qué servicios autorizar](certificado-testing.md#qué-servicios-autorizar). ### CSR y alias El CSR (pedido de firma de certificado) es el archivo que subís a ARCA para que te devuelva el certificado; `arcli certificado generar` lo arma junto con la clave privada. El alias es el nombre con el que el certificado aparece en ARCA (por defecto `arcli`). ## Identidad y comprobante ### CUIT / CUIL / DNI Formas de identificar al receptor de un comprobante: - **CUIT**: Clave Única de Identificación Tributaria, 11 dígitos. Identifica personas jurídicas o autónomos. - **CUIL**: Clave Única de Identificación Laboral, 11 dígitos. Identifica trabajadores en relación de dependencia. - **DNI**: Documento Nacional de Identidad, 7 u 8 dígitos. Se usa cuando el receptor no tiene CUIT/CUIL a mano. ### Consumidor final Categoría de receptor sin documento identificable. ARCLI la representa con documento `0` e IVA receptor `consumidor-final`: `--consumidor-final` alcanza para las dos cosas. ### Condición IVA (IVA receptor) La situación del receptor frente al IVA: `responsable-inscripto`, `responsable-monotributo`, `consumidor-final`, `sujeto-exento`, etc. Define, entre otras cosas, qué letra corresponde (A, B o C) (ver [Reglas de validación](validation-rules.md#iva-automático)). ### Punto de venta Número que identifica la "caja" o punto de emisión dentro de ARCA para un mismo CUIT emisor. Se configura una vez y se reutiliza en cada comprobante. ### Concepto Qué se está facturando: `productos`, `servicios` o `productos-servicios`. Determina si hace falta informar fechas de servicio (`--servicio-desde`, `--servicio-hasta`, `--vencimiento`). ### Período del servicio, vencimiento y período asociado - **Período del servicio** (`--servicio-desde`/`--servicio-hasta`, `FchServDesde`/`FchServHasta`): qué período cubre una factura de servicios. Por ejemplo, el abono de octubre. - **Vencimiento** (`--vencimiento`/`--vto`, `FchVtoPago`): hasta cuándo se puede pagar. `--dia` está deprecado. - **Período asociado** (`--periodo-desde`/`--periodo-hasta`, `PeriodoAsoc`): solo en notas. Qué facturas ajusta la nota cuando no es una puntual, por ejemplo un descuento sobre todo lo facturado en octubre. Ejemplos en [Las fechas de un comprobante](cli-reference.md#las-fechas-de-un-comprobante). ### Comprobante asociado / `CbtesAsoc` El comprobante original que una nota de crédito o débito ajusta o anula. `CbtesAsoc` es el nombre del campo tal cual lo espera ARCA dentro del payload; en ARCLI se arma con `--ac`/`--at`, `--apv`, `--ar` y `--acuit`. En notas comunes, la alternativa es el período asociado (`PeriodoAsoc`), que se arma con `--periodo-desde` y `--periodo-hasta`. ### `DocTipo` / `DocNro` Campos del payload de ARCA para la identidad del receptor: `DocTipo` indica el tipo de documento (CUIT, CUIL, DNI o consumidor final) y `DocNro` el número. Por ejemplo, consumidor final se envía como `DocTipo 99` y `DocNro 0`. ### `CbteTipo` / tipo ARCA Código numérico con el que ARCA identifica cada tipo de comprobante (Factura A, Nota de crédito B, etc). En ARCLI aparece como `tipoArca` en la salida `--json` y es lo que distingue, por ejemplo, una factura común de su versión de crédito electrónica aunque compartan la misma letra. ### Factura de crédito electrónica (FCE) Variante electrónica de factura pensada para el régimen de facturación de crédito PyME. Usa la misma estructura que una factura común, con un tipo ARCA distinto y datos de cobro adicionales: CBU del emisor, modalidad de transferencia (`SCA` o `ADC`) y vencimiento de pago. Sus notas de crédito y débito llevan el código de anulación y la fecha de la factura asociada. Ver [Crédito electrónico (FCE)](validation-rules.md#crédito-electrónico-fce). ### Recibo C Comprobante tipo ARCA `15` (`arcli rc`) para documentar un cobro. Se arma como una Factura C: sin IVA discriminado y sin comprobante asociado. Ver [Recibo C](validation-rules.md#recibo-c). ### Factura de exportación E Factura para clientes del exterior (`arcli fe`), que va por `wsfex` en vez de `wsfe`: no lleva concepto, IVA ni documento del receptor, y sí cliente, país de destino, ítems e incoterm. Sus notas de crédito y débito son `arcli nce` y `arcli nde`. Ver [Factura de exportación (E)](validation-rules.md#factura-de-exportación-e). ## Números y respuesta ### CAE Código de Autorización Electrónico. El número que ARCA devuelve al aprobar un comprobante; sin CAE, el comprobante no es válido fiscalmente. Viene acompañado de `caeVencimiento`, la fecha límite para entregar ese comprobante. ### Alícuota El porcentaje de IVA aplicado. ARCLI calcula el IVA automáticamente en las letras `A` y `B`, con `21%` por defecto; se cambia con `--alicuota` o `config.alicuota` (ver [IVA automático](validation-rules.md#iva-automático)). ### Estado vs. resultado - `resultado` es el valor crudo que devuelve ARCA (por ejemplo `A` de aprobado o `R` de rechazado). - `estado` es la normalización que hace ARCLI (`aprobado`, `observado`, `rechazado`), distinguiendo si hubo observaciones aunque ARCA haya aprobado. Ver el detalle completo en [Entrada y salida](input-output.md#estado-vs-resultado). --- # Limitaciones actuales Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/limitations.md Limitaciones y decisiones de diseño que hoy forman parte del comportamiento real del proyecto. ## Limitaciones funcionales ### Lotes sin emisión parcial controlada Un lote se valida entero antes de emitir, pero si la emisión se corta a mitad (red, ARCA) los comprobantes ya emitidos quedan emitidos: no hay "deshacer". ARCLI los muestra antes del error para que no se carguen dos veces. Ver [input-output.md](input-output.md#validación-y-errores-del-lote). ### Salida humana no estable La salida humana es para terminal y puede cambiar. Para integraciones usá `--json` (o `--json --bruto`). ### Dependencia de ARCA y WSAA Hay errores que no dependen de la solicitud sino del entorno remoto, por ejemplo: - `coe.alreadyAuthenticated` - `Transacción Activa` ARCLI los trata mejor en la salida, pero no los elimina. ### Factura de exportación (E) ARCLI emite la factura `E` y sus notas de crédito y débito (`nce`, `nde`). No hay lote: el JSON de `--cargar` tiene que ser un objeto. - Sin concepto, fechas de servicio, IVA discriminado, comprobante asociado ni datos FCE: esos flags y sus defaults de config no aplican a `E`. - `--tipo-expo` acepta solo `1` (bienes), `2` (servicios) y `4` (otros), y por defecto la `E` sale de servicios; la moneda por defecto es `DOL` y la forma de pago `Transferencia Internacional`. Las claves `moneda` y `cotizacion` de la config no aplican. La tabla de ARCA se consulta igual para validar países, unidades, incoterms e idiomas. - Los permisos de embarque se informan como ya existentes (`--permiso-existente` en la factura; en las notas, `--permiso` solo) y solo aplican a exportaciones de bienes (`--tipo-expo 1`): ARCLI no da de alta permisos nuevos en ARCA. Sin permisos el campo `Permisos` no se envía, porque ARCA lo rechaza (error 1720) cuando `Permiso_existente` es `N`; en `--tipo-expo 2` (servicios) y `4` (otros) el campo va vacío, como pide ARCA (error 1550). - La actividad no tiene default: se informa con `--actividad` o `exportacion.actividad`. - El certificado tiene que estar autorizado a `wsfex`, además de `wsfe`. Se puede usar uno propio con `exportacion.cert.*` / `exportacion.key.*` ([configuración](configuration.md#certificados-de-exportación-wsfex)). - La cotización es la de aduana que publica WSFEX (`FEXGetPARAM_MON_CON_COTIZACION`), no la de `wsfe`, y no se toma de la clave `cotizacion` de la config. - En homologación, ARCA rechazó una nota de crédito de servicios asociada a una nota de débito (error 2055) aunque la nota de débito tenía su factura asociada. ARCLI no la bloquea: si ARCA la rechaza, no se emite nada. ### Recibo C con la plantilla de factura El PDF del Recibo C (`rc`) usa la plantilla de factura con el título `RECIBO C`, no el formato de recibo del portal de ARCA (sin "Recibí(mos) la suma de"). ### PDF solo al emitir El PDF se genera en el momento de emitir. Todavía no se puede regenerar el de un comprobante ya emitido: la consulta de ARCA que usa el SDK (`FECompConsultar`) no devuelve el detalle de IVA, los comprobantes asociados ni las fechas de servicio. Tampoco hay ítems detallados en A, B y C: el PDF lleva un renglón por alícuota con la descripción que pases (la factura de exportación `E` sí imprime los ítems de WSFEX). Ver [PDF de comprobantes](pdf.md#qué-no-hace-todavía). ## Decisiones de diseño ### `testing` por defecto Se eligió `testing` como entorno por defecto para reducir errores accidentales. ### IVA automático y tributos En letras `A` y `B` el CLI calcula el IVA a partir del total, con una o varias alícuotas, y admite importes exentos y no gravados. Ver [IVA automático](validation-rules.md#iva-automático). Todavía no se soportan los tributos (`Tributos` / `ImpTrib`), como las percepciones de IIBB. ## Inconsistencias o bordes ya detectados ### Observaciones de padrón Algunos CUIT de testing aprueban y devuelven observaciones como: - `10217` - `10017` No siempre indican un error del CLI. ### Casos sensibles al paralelismo En pruebas reales apareció el error `10016` cuando se forzaron varias emisiones `A` en paralelo. Probando de forma serial, el caso volvió a aprobar. ### `respuesta` cambia según el modo Con `--bruto` se agrega `respuesta` al resumen de siempre (no reemplaza ningún campo): - si hubo emisión real, `respuesta` contiene la respuesta cruda del SDK - si no hubo emisión, `respuesta` pasa a ser un objeto con `mensaje` Eso está documentado, pero conviene tenerlo presente si alguien consume JSON desde scripts. --- # Problemas frecuentes Fuente: https://github.com/LcsGrz/arcli/blob/main/docs/troubleshooting.md Errores frecuentes agrupados por categoría: síntoma, causa y solución. Si usás el asistente (`arcli` sin argumentos): Configuración → Revisar configuración te dice qué falta. ## Instalación ### `npm install -g arcli` falla con `EACCES` (macOS o Linux) - **Síntoma:** `npm ERR! code EACCES` o `permission denied` al instalar. - **Causa:** npm quiere escribir en una carpeta del sistema. - **Solución:** no uses `sudo`. Configurá una carpeta propia para los paquetes globales (`npm config set prefix ~/.npm-global` y sumá `~/.npm-global/bin` al `PATH`) o instalá Node con un gestor de versiones como `nvm`. ### PowerShell dice "la ejecución de scripts está deshabilitada" - **Síntoma:** al correr `arcli` en PowerShell: `arcli.ps1 no se puede cargar porque la ejecución de scripts está deshabilitada en este sistema`. - **Solución:** `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` y volvé a abrir PowerShell, o usá el "Símbolo del sistema" (`cmd`), o abrí ARCLI con el [acceso directo](cli-reference.md#acceso-directo). ### `arcli` no se reconoce como comando - **Síntoma:** `command not found: arcli` o "'arcli' no se reconoce como un comando interno o externo". - **Causa:** la terminal se abrió antes de instalar, o la carpeta de los paquetes globales de npm no está en el `PATH`. - **Solución:** cerrá y abrí la terminal. Si sigue, `npm prefix -g` te dice la carpeta: sumala al `PATH`. ## Debug rápido Si algo no cierra, estas son las tres corridas que más ayudan: ```bash arcli config revisar arcli fc ayuda arcli fc -m 1000 --cs --consumidor-final --previsualizar --json --testing ``` Con eso normalmente ves: - si falta configuración - si el comando está mal armado - si el problema viene de la solicitud o de ARCA Si la salida humana no alcanza para entender qué pasó, agregá `--json`, `--bruto` o ambos al mismo comando. Formatos: [Entrada y salida](input-output.md). ## Config ### Falta CUIT del emisor - **Severidad:** frecuente - **Síntoma:** error de configuración indicando que falta el CUIT. - **Causa:** no existe `cuit` en la config persistente. - **Solución:** ```bash arcli config establecer cuit 20168598204 arcli config revisar ``` - **Documentación relacionada:** [Configuración](configuration.md) ### Falta punto de venta - **Severidad:** frecuente - **Síntoma:** el flujo corta antes de emitir con un mensaje sobre punto de venta. - **Causa:** no llegó `puntoVenta` por flags ni por config. - **Solución:** ```bash arcli config establecer puntoVenta 3 ``` o bien: ```bash arcli fc -m 1000 --pv 3 --cs --consumidor-final ``` - **Documentación relacionada:** [Configuración](configuration.md), [Referencia del CLI](cli-reference.md) ### El punto de venta no existe o está bloqueado - **Síntoma:** ARCA rechaza el comprobante por el punto de venta, o `arcli estado` dice que no existe, está bloqueado o dado de baja. - **Causa:** el punto de venta tiene que estar dado de alta en ARCA para tu CUIT y para factura electrónica por web service. - **Solución:** `arcli parametros puntos-venta --produccion` lista los habilitados. Guardá uno con `arcli config establecer puntoVenta `. En testing ARCA no informa puntos de venta y cualquier número sirve. ### Certificado o clave PEM inválidos - **Severidad:** crítico - **Síntoma:** error indicando que la ruta apunta a un archivo con formato PEM inválido. - **Causa:** el archivo existe, pero el contenido no parece un PEM válido. - **Solución:** hay dos formas, según cómo cargaste el certificado: - **Con `arcli certificado` (recomendada):** volvé a cargar el `.crt` que bajaste de ARCA. Valida el archivo antes de guardarlo. ```bash arcli certificado importar testing.crt ``` - **Si lo hiciste con openssl:** volvé a guardar las rutas correctas. ```bash arcli config establecer cert.testing /ruta/al/certificado.crt arcli config establecer key.testing /ruta/a/la/clave.key ``` - **Documentación relacionada:** [Configuración](configuration.md), [Cómo obtener los certificados de ARCA](obtencion-certificados.md) ### Al importar: el certificado no corresponde a la clave - **Severidad:** a veces - **Síntoma:** `arcli certificado importar` corta con `El certificado no corresponde a la clave del último pedido` (`CERTIFICATE_KEY_MISMATCH`). No se toca la config. - **Causa:** el `.crt` se creó en ARCA con otro CSR: uno de un pedido anterior que descartaste con `--reemplazar`, uno armado en otra computadora o uno hecho con `openssl`. - **Solución:** en ARCA, creá el certificado con el CSR del último `arcli certificado generar` (está en `certificados//.nueva.csr`, junto a la config) y volvé a importar. Si el certificado es de un par que armaste con `openssl`, configuralo con `arcli config establecer cert.` y `key.`. - **Documentación relacionada:** [Comando `arcli certificado`](cli-reference.md#comando-arcli-certificado) ### Al importar: otros rechazos del certificado - **Severidad:** a veces - **Síntoma:** `arcli certificado generar` o `importar` corta sin tocar la config. El código del JSON dice cuál es: - `CERTIFICATE_REQUEST_PENDING` (`generar`): ya hay un pedido de ese entorno sin importar. - `CERTIFICATE_INVALID`: el archivo no tiene un certificado X.509. - `CERTIFICATE_CUIT_MISMATCH`: el certificado es de otro CUIT que el de la config. - `CERTIFICATE_EXPIRED`: el `.crt` que querés cargar ya venció. - `CERTIFICATE_ENVIRONMENT_UNKNOWN`: ARCLI no reconoce al emisor como una autoridad de ARCA, así que no sabe de qué entorno es. - `CERTIFICATE_REPLACE_CONFIRMATION`: ya había otro certificado y, sin terminal o con `--json`, no se puede preguntar. - **Solución:** importá el certificado del pedido pendiente o descartalo con `--reemplazar`; usá el `.crt` tal como lo bajaste de ARCA, sin abrirlo ni guardarlo con otro programa; bajalo con la clave fiscal del CUIT configurado; si está vencido, generá uno nuevo; si es de ARCA, indicá el entorno con `--testing` o `--produccion`; para reemplazar sin preguntar, sumá `--reemplazar`. - **Documentación relacionada:** [Comando `arcli certificado`](cli-reference.md#comando-arcli-certificado), [códigos de error](input-output.md#códigos-de-error) ### Certificado por vencer o vencido - **Severidad:** crítico, si ya venció (antes es un aviso) - **Síntoma:** a menos de 30 días de vencer cualquiera de los certificados configurados (también el de producción si trabajás en testing), cada comando que va a ARCA empieza con el aviso `El certificado de vence el dd/mm/aaaa (en N días)` (en stderr; en el modo interactivo, un recuadro debajo de la barra). Si ya venció el del entorno que usás, el comando corta con `Certificado vencido` (`CERTIFICATE_EXPIRED` en el JSON, con `detalles.entorno` y `detalles.vencimiento`) sin llegar a ARCA. - **Causa:** los certificados de ARCA vencen (por defecto, a los 2 años). Vencido, WSAA rechaza el login, así que no se puede emitir ni consultar en ese entorno. - **Solución:** renovalo con `arcli certificado generar` (o en el modo interactivo: Configuración → Certificados de ARCA). Arma una clave y un pedido nuevos sin tocar los actuales, así que seguís facturando hasta cargar el certificado nuevo. Subí el CSR en ARCA, bajá el `.crt` y cargalo; si usás un alias nuevo, autorizá de nuevo los servicios web: ```bash arcli certificado generar --produccion arcli certificado importar produccion.crt arcli config revisar ``` Si lo renovaste a mano, también sirve `arcli config establecer cert.produccion /ruta/al/certificado-nuevo.crt`. - **Documentación relacionada:** [Cómo obtener los certificados de ARCA](obtencion-certificados.md), [Formato de errores](input-output.md#certificado-vencido) ### `config.json` con JSON inválido - **Severidad:** crítico - **Síntoma:** cualquier comando falla con `Error de configuración` ("El archivo de configuración tiene JSON inválido y no se puede leer."), con la ruta del archivo en `Ruta` (`detalles.ruta` con `--json`). - **Causa:** el `config.json` quedó mal escrito, casi siempre por una edición a mano (una coma de más, comillas sin cerrar) o un archivo vacío. - **Solución:** corregir el JSON a mano en esa ruta, o renombrar el archivo y volver a cargar los datos. ARCLI no lo borra ni lo pisa: lo que tenía sigue ahí para recuperarlo. ```bash mv "" ".bak" arcli config establecer cuit 20168598204 ``` Después, el certificado. Si lo tenés con `arcli certificado` (recomendado), está en `certificados//`, junto al `config.json`: volvé a cargarlo con `arcli certificado importar /testing.crt`. Si lo hiciste con openssl, cargá las rutas a mano: ```bash arcli config establecer cert.testing /ruta/al/certificado.crt arcli config establecer key.testing /ruta/a/la/clave.key ``` O abrí `arcli` y elegí "Configuración" para la configuración guiada. - **Documentación relacionada:** [Configuración](configuration.md) ## Validación ### Falta un dato obligatorio - **Severidad:** frecuente - **Síntoma:** `INPUT_VALIDATION_ERROR` o mensaje como `Falta el dato: monto.` - **Causa:** falta un dato obligatorio en flags o JSON. - **Solución:** revisar `ayuda` del comando puntual y completar los campos faltantes. ```bash arcli fc ayuda ``` - **Documentación relacionada:** [Reglas de validación](validation-rules.md) ### Clave desconocida o tipo incorrecto en el JSON de `--cargar` - **Severidad:** frecuente - **Síntoma:** `INPUT_VALIDATION_ERROR` (o `BATCH_VALIDATION_ERROR` en un lote) con `La clave "montototal" no existe: ¿quisiste decir "montoTotal"?` o `"puntoVenta" tiene que ser un número y llegó el texto "3".` - **Causa:** el JSON trae una clave que ARCLI no conoce (un typo o el nombre de un flag, como `vencimiento` en vez de `vencimientoPago`) o un valor con otro tipo (un número entre comillas, `"true"` en vez de `true`, `null`). - **Solución:** usá la clave que sugiere el mensaje y escribí los números sin comillas. La lista completa está en [entrada y salida](input-output.md#campos-soportados). ### Se mezclan identidades del receptor - **Severidad:** frecuente - **Síntoma:** error pidiendo usar una sola identidad de receptor. - **Causa:** se combinaron `--cuit`, `--cuil`, `--dni` o `--consumidor-final`. - **Solución:** dejar una sola forma de identificar al receptor. - **Documentación relacionada:** [Reglas de validación](validation-rules.md) ### Se mezclan formas de indicar IVA receptor - **Severidad:** frecuente - **Síntoma:** error pidiendo usar `--iva-receptor`, `--ir` o un solo `--ir-*`. - **Causa:** se combinaron varias formas de indicar IVA receptor. - **Solución:** dejar una sola fuente. - **Documentación relacionada:** [Reglas de validación](validation-rules.md) ### Falta la cotización en moneda extranjera - **Severidad:** frecuente - **Síntoma:** `Falta la cotización de USD.` - **Causa:** se pasó `--moneda USD` con `--cm 1`. Sin `--cm`, ARCLI usa la cotización oficial de ARCA. - **Solución:** pasar `--cm ` con la acordada, sacar `--cm` para usar la oficial, o `--misma-moneda` si te pagan en dólares. - **Documentación relacionada:** [Moneda y cotización](validation-rules.md#moneda-y-cotización) ### El comprobante no admite el IVA receptor - **Severidad:** frecuente - **Síntoma:** `La factura B no admite IVA receptor "responsable-inscripto". Usá un comprobante letra A.` - **Causa:** ARCA solo acepta ciertas condiciones IVA para cada letra. Por ejemplo, la `A` es para responsables inscriptos y monotributistas, y la `B` para el resto. - **Solución:** usar la letra que sugiere el error, o corregir el IVA receptor. - **Documentación relacionada:** [IVA receptor](validation-rules.md#iva-receptor) ### Consumidor final sin identificar desde $ 10.000.000 - **Severidad:** ocasional - **Síntoma:** `... de $ 10.000.000 o más requiere identificar al consumidor final.` - **Causa:** la RG 5700/2025 obliga a identificar al consumidor final desde ese monto. - **Solución:** reemplazar `--consumidor-final` por `--dni`, `--cuit` o `--cuil`, manteniendo `--ir-cf`. - **Documentación relacionada:** [Consumidor final](validation-rules.md#consumidor-final) ### Fecha del comprobante fuera de rango - **Severidad:** ocasional - **Síntoma:** `La fecha ... está fuera de rango ...` o `... es futura y cae en otro mes.` - **Causa:** ARCA solo acepta fechas cercanas a hoy: ±5 días en productos, ±10 en servicios y de −5 a +1 en FCE. - **Solución:** usar una fecha dentro de la ventana, o no pasar `--fecha` para usar la de hoy. - **Documentación relacionada:** [Fecha del comprobante](validation-rules.md#fecha-del-comprobante) ### Vencimiento de pago anterior a la fecha - **Severidad:** ocasional - **Síntoma:** `El vencimiento de pago (...) no puede ser anterior al ...` - **Causa:** `FchVtoPago` tiene que ser igual o posterior a la fecha del comprobante. En FCE, también a la de hoy. - **Solución:** pasar un `--vencimiento` posterior. - **Documentación relacionada:** [Vencimiento de pago](validation-rules.md#vencimiento-de-pago-fchvtopago) ### Factura FCE sin CBU - **Severidad:** frecuente - **Síntoma:** `La factura de crédito electrónica ... requiere el CBU del emisor.` - **Causa:** ARCA exige el CBU del emisor en toda factura FCE (10168). - **Solución:** pasar `--cbu <22 dígitos>` o configurarlo una vez con `arcli config establecer cbu <22 dígitos>`. - **Documentación relacionada:** [Crédito electrónico (FCE)](validation-rules.md#crédito-electrónico-fce) ### NC/ND FCE: ARCA no tiene el asociado - **Severidad:** ocasional - **Síntoma:** `ARCA no tiene la factura de crédito electrónica ..., así que no se puede tomar su fecha.` - **Causa:** en NC/ND FCE, ARCA exige la fecha de la factura asociada (10158). Sin `--afecha`, arcli la busca en ARCA antes de la vista previa y no la encontró o ARCA no respondió. - **Solución:** revisar `--ac`, `--apv` y `--ar`: tienen que apuntar a una factura FCE tuya ya emitida. Si ARCA no respondió, reintentar o pasar la fecha con `--afecha`. - **Documentación relacionada:** [Crédito electrónico (FCE)](validation-rules.md#crédito-electrónico-fce) ### La nota de crédito supera el total de la factura - **Severidad:** ocasional - **Síntoma:** `La nota de crédito por $ 150.000 no puede superar el total de la factura C 00003-00000045, de $ 120.000.` - **Causa:** antes de la vista previa, arcli consulta el asociado en ARCA y la NC es mayor que su total (en la misma moneda). Pasa igual en A, B, C, FCE y `E`. No se emite nada. - **Solución:** bajar `--monto` (la sugerencia trae el `--monto` para anularla entera) o revisar `--ar` y `--apv`, por si apuntan a otra factura. - **Documentación relacionada:** [Crédito electrónico (FCE)](validation-rules.md#crédito-electrónico-fce) ### La suma de las alícuotas no coincide con el total - **Severidad:** ocasional - **Síntoma:** `La suma de las alícuotas (...) no coincide con lo gravado del monto total (...)`. - **Causa:** con varias `--alicuota TASA:MONTO`, cada monto lleva el IVA incluido, y la suma más `--exento` y `--nogravado` tiene que dar `--monto`. - **Solución:** sacar `--monto` (el total se calcula solo) o corregir los montos. - **Documentación relacionada:** [Varias alícuotas](validation-rules.md#varias-alícuotas-en-un-comprobante) ### Exento o no gravado mayor al total - **Severidad:** ocasional - **Síntoma:** `El importe exento más el no gravado no puede superar el monto total.` - **Causa:** `--monto` es el total del comprobante, y `--exento` y `--nogravado` son partes de ese total. - **Solución:** pasar en `--monto` el total, incluidos exento y no gravado. - **Documentación relacionada:** [IVA automático](validation-rules.md#iva-automático) ### `wsfe` no autorizado - **Severidad:** frecuente, la primera vez - **Síntoma:** error `WSFE_SERVICE_NOT_AUTHORIZED` ("El certificado no está autorizado para facturar (servicio wsfe). No se emitió nada.") al facturar o con `ultimos` y `consultar`. - **Causa:** sacaste e importaste el certificado, pero falta autorizarlo a facturar en ARCA. - **Solución:** en testing, WSASS → "Crear autorización a servicio" con el mismo nombre del certificado y el servicio `wsfe`; en producción, el Administrador de Relaciones de Clave Fiscal. No se emitió nada: después de autorizarlo, reintentá igual. - **Documentación relacionada:** [Autorizar el servicio web](certificado-testing-completa.md#3-autorizar-el-servicio-web) ### `wsfecred` no autorizado - **Severidad:** frecuente, si usás `fce-obligado` o `verificarFce` - **Síntoma:** `El certificado no está autorizado para el servicio wsfecred ...` (ARCA responde `coe.notAuthorized`). - **Causa:** el certificado solo tiene autorizado `wsfe`. La consulta del régimen FCE usa otro servicio. - **Solución:** crear la autorización para `wsfecred` igual que la de `wsfe`, en WSASS (testing) o en el Administrador de Relaciones (producción). Si no la necesitás, desactivá el chequeo con `arcli config eliminar verificarFce`. - **Documentación relacionada:** [Autorizar el servicio web](certificado-testing-completa.md#3-autorizar-el-servicio-web) ### `ws_sr_constancia_inscripcion` no autorizado - **Severidad:** frecuente, si usás `arcli padron` o facturás con `--cuit` sin `--ir` - **Síntoma:** `arcli padron` falla con `El certificado no está autorizado para el servicio ws_sr_constancia_inscripcion ...`. Al facturar no corta: aparece el aviso `No se pudo consultar el padrón de ARCA` y se usa el `ivaReceptor` de la config. - **Causa:** el certificado solo tiene autorizado `wsfe`. El padrón usa otro servicio. - **Solución:** crear la autorización para `ws_sr_constancia_inscripcion` igual que la de `wsfe`. Si no la necesitás, desactivá la consulta con `arcli config establecer consultarPadron false`. - **Documentación relacionada:** [IVA receptor desde el padrón](cli-reference.md#iva-receptor-desde-el-padrón) ## ARCA ### `dh key too small` en producción - **Severidad:** a veces - **Síntoma:** en una versión anterior de ARCLI, los comandos de producción fallan con `dh key too small` o `ERR_SSL_DH_KEY_TOO_SMALL`, con certificado, clave y punto de venta correctos. En testing andan. - **Causa:** WSFE y WSFEX de producción prefieren un intercambio DHE con una clave de 1024 bits, y OpenSSL la rechaza con `SECLEVEL=2`, el nivel de Debian 13 y otras distros. - **Solución:** actualizar ARCLI. Si no podés, corré el CLI con `node --tls-cipher-list='DEFAULT:!DHE' "$(which arcli)"` más los argumentos de siempre. - **Documentación relacionada:** [Arquitectura](architecture.md) ### `coe.alreadyAuthenticated` - **Severidad:** frecuente - **Síntoma:** error WSAA con `coe.alreadyAuthenticated`. - **Causa:** ya existe un ticket válido para ese servicio. - **Solución:** esperar unos segundos y reintentar sin cambiar la solicitud. - **Documentación relacionada:** [Reglas de validación](validation-rules.md), [Limitaciones actuales](limitations.md) ### `Transacción Activa` - **Severidad:** frecuente - **Síntoma:** error ARCA con referencia a transacción activa. - **Causa:** ARCA informa una operación transitoria en curso. - **Solución:** esperar unos segundos y reintentar antes de modificar el comprobante. Si apareció al emitir, sale como `EMISSION_UNCERTAIN`: verificá primero con `arcli ultimos` (ver abajo). - **Documentación relacionada:** [Reglas de validación](validation-rules.md), [Limitaciones actuales](limitations.md) ### No se pudo confirmar la emisión (`EMISSION_UNCERTAIN`) - **Severidad:** crítico - **Síntoma:** "No se pudo confirmar la emisión: …" al emitir. - **Causa:** falló la llamada que emite en ARCA (red, timeout, transacción activa). ARCA pudo haber autorizado el comprobante y perderse la respuesta. Si el error es del login en WSAA (certificado no autorizado; uno vencido corta antes con `CERTIFICATE_EXPIRED`) o del pedido del último número, no sale este error sino el original: ahí no se emitió nada y alcanza con corregir y reintentar. - **Solución:** **no reintentes todavía**. Corré el `arcli ultimos --pv ` que muestra la sugerencia: si el comprobante figura, ya está emitido y no hay que repetirlo; si no figura, reintentá. En la factura E (`fe`), reintentá con el mismo `--numero` e `--id-solicitud` que muestra la sugerencia: ARCA no autoriza dos veces el mismo número. - **Documentación relacionada:** [Entrada y salida](input-output.md#emisión-sin-confirmar) ### El receptor coincide con el emisor - **Severidad:** crítico - **Síntoma:** error ARCA `Campo DocNro no puede ser igual al del emisor.` - **Causa:** se está usando el mismo CUIT como emisor y receptor. - **Solución:** usar otro CUIT válido de testing como receptor. - **Documentación relacionada:** [Reglas de validación](validation-rules.md) ### Observaciones de padrón - **Severidad:** frecuente - **Síntoma:** el comprobante aprueba, pero devuelve observaciones como `10217` o `10017`. - **Causa:** condición del receptor o del entorno de testing. - **Solución:** revisar si el caso es aceptable para tu flujo y distinguirlo de un rechazo real. - **Documentación relacionada:** [Limitaciones actuales](limitations.md) ### ARCA rechaza por punto de venta - **Severidad:** frecuente, en producción - **Síntoma:** el comprobante sale `rechazado` con el error `10005` ("El punto de venta informado debe estar dado de alta y ser del tipo RECE"), y la sugerencia habla de un punto de venta para web service. `arcli estado --produccion` dice que el punto de venta no está habilitado para web service. - **Causa:** el punto de venta configurado no es de web service. Pasa con los de Comprobantes en línea ("Factura en línea"), Facturador o talonarios manuales. Desde el 1/11/2026, por la RG 5893/2026, ARCA da de alta de oficio un punto de venta "Factura en línea - Monotributo" a los monotributistas que no tienen uno electrónico: ese tampoco sirve para ARCLI. - **Solución:** `arcli parametros puntos-venta --produccion` lista los habilitados para web service. Si el tuyo no está, creá uno nuevo con sistema de web services en "Administración de puntos de venta y domicilios" y guardalo con `arcli config establecer puntoVenta `. - **Documentación relacionada:** [Punto de venta para web service](certificado-produccion-completa.md#punto-de-venta-para-web-service) ### Rechazos de ARCA por código Cuando ARCA rechaza o deja una observación con alguno de estos códigos, `sugerencias` del JSON (y el panel de la salida humana) dice qué pasó y qué hacer. Los que ARCLI valida antes de enviar (por ejemplo, la ventana de fechas o el IVA receptor por letra) casi nunca llegan a ARCA, pero si llegan, el texto es el mismo. | Código | Qué pasó | Qué hacer | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | `10005`/`11002` | El punto de venta no está habilitado para web service | Ver [ARCA rechaza por punto de venta](#arca-rechaza-por-punto-de-venta) | | `10016` | El número o la fecha no es el próximo a autorizar: otro comprobante del mismo tipo y punto de venta se emitió en el medio, o la fecha es anterior a la del último | Mirá el último con `arcli ultimos` y reintentá; si emitís varios, de a uno (ver [Limitaciones](limitations.md)) | | `10152` | La fecha del comprobante está fuera del rango que acepta ARCA | Ver [Fecha del comprobante fuera de rango](#fecha-del-comprobante-fuera-de-rango) | | `10243` | El IVA receptor no es válido para la letra | Ver [El comprobante no admite el IVA receptor](#el-comprobante-no-admite-el-iva-receptor) | | `10174` | El CBU de la factura FCE no está registrado a nombre del emisor | Usá un CBU propio registrado en ARCA (`--cbu` o la clave `cbu`) | | `10119` | La cotización está fuera del rango que acepta ARCA: entre el 2% y el 400% de la oficial | Revisá `--cotizacion-moneda` contra `arcli parametros cotizacion ` | | `10038` | Con `--misma-moneda`, la cotización enviada ya no es la oficial exacta | Volvé a emitir: ARCLI consulta la oficial en ese momento | | `10017`/`10217` | Observación sobre la condición del receptor; el comprobante puede estar aprobado | Ver [Observaciones de padrón](#observaciones-de-padrón) | También se reconocen por el mensaje, sin código: receptor igual al emisor, `Transacción Activa`, CUIT receptor inexistente y detalle de IVA obligatorio. Si ARCA rechaza con otro código, `sugerencias` pide revisar `errores` y `observaciones`. - **Documentación relacionada:** [Reglas de validación](validation-rules.md), [Entrada y salida](input-output.md) ### Factura E: el número no es el que sigue - **Severidad:** ocasional, solo si pasás `--numero` a mano - **Síntoma:** ARCA rechaza la `E` con un error de correlatividad del número. - **Causa:** WSFEX numera por punto de venta y tipo de comprobante, y el número tiene que ser el siguiente al último autorizado. - **Solución:** sacá `--numero`: ARCLI consulta el último en ARCA (`FEXGetLast_CMP`) y usa el siguiente. Para ver los últimos, `arcli ultimos fe` (o `nde`, `nce`). Un rechazo no emite nada. - **Documentación relacionada:** [Referencia del CLI](cli-reference.md#factura-de-exportación-e-wsfex) ### Factura E: falta la actividad o no está en la tabla de WSFEX - **Severidad:** frecuente, la primera vez que se emite una `E` - **Síntoma:** `Falta la actividad de exportación.` o `La actividad 620900 no está en la tabla de actividades de WSFEX y ARCA la rechaza (error 2105).` - **Causa:** la `E` informa siempre una actividad (ARCA rechaza `Actividades` vacío con el error 2100) y solo acepta los códigos de su propia tabla (`FEXGetPARAM_Actividades`), que **no es la del padrón y es más chica**: por ejemplo, `620900` (servicios de informática N.C.P.) no está; para informática están `620100` (consultores en informática y suministros de programas) y `620300` (consultores en tecnología de la información). - **Solución:** elegí la que corresponda a tu actividad declarada (el error lista las que empiezan igual) y guardala con `arcli config establecer exportacion.actividad `, o pasala con `--actividad`. - **Documentación relacionada:** [Reglas de validación](validation-rules.md#factura-de-exportación-e), [Configuración](configuration.md) ### Factura E: el certificado no está autorizado a `wsfex` - **Severidad:** frecuente, la primera vez - **Síntoma:** error `WSFEX_SERVICE_NOT_AUTHORIZED` ("El certificado no está autorizado para el servicio wsfex"), incluso con `--previsualizar`. - **Causa:** la vista previa ya consulta las tablas de WSFEX, y el certificado no tiene la relación con el servicio `wsfex`. - **Solución:** autorizá el certificado a `wsfex` igual que a `wsfe` (WSASS en testing, Administrador de Relaciones en producción), o configurá uno propio con `exportacion.cert.*` y `exportacion.key.*`. - **Documentación relacionada:** [Configuración](configuration.md#certificados-de-exportación-wsfex), [Obtención de certificados](obtencion-certificados.md) ### Factura E: la cotización no es la del día - **Severidad:** frecuente, casi siempre con la fecha de hoy - **Síntoma:** aviso `ARCA no publicó la cotización de DOL del : se usa la del `. - **Causa:** la `E` usa la cotización de aduana de WSFEX (`FEXGetPARAM_MON_CON_COTIZACION`), que ARCA publica una vez por día. Mientras no sale la de hoy, se usa la última publicada. - **Solución:** no hace falta hacer nada. Para fijar otra cotización, pasá `--cotizacion-moneda ` (o `--cm`). - **Documentación relacionada:** [Reglas de validación](validation-rules.md#factura-de-exportación-e) ## Batch ### El lote tiene comprobantes inválidos - **Severidad:** frecuente - **Síntoma:** `BATCH_VALIDATION_ERROR` con la lista de ítems inválidos (`#2: Falta el dato: monto.`…). No se emitió ninguno. - **Causa:** ARCLI valida todo el lote antes de emitir el primero, incluidas las consultas al padrón (IVA receptor desde `--cuit`) y a la cotización oficial. - **Solución:** corregir esos ítems en el JSON y volver a correr el lote completo. Si el motivo es una consulta a ARCA que no respondió, reintentá en unos minutos. - **Documentación relacionada:** [Entrada y salida](input-output.md#validación-y-errores-del-lote) ### El lote se interrumpió a mitad - **Severidad:** crítico - **Síntoma:** se ven los resultados de algunos comprobantes (con su PDF, si corresponde) y después `BATCH_EMISSION_ERROR` ("El lote se interrumpió en el comprobante #3…"). - **Causa:** la emisión falló a mitad del lote (red, ARCA, transacción activa). - **Solución:** **no vuelvas a cargar los comprobantes que ya se procesaron**, porque se duplicarían. Si el JSON trae `sinConfirmar`, el que falló puede haberse emitido igual: verificalo con `arcli ultimos` y sumalo solo si no figura. Si no lo trae, falló antes de emitir (login, último número) y ya está en "Sin procesar" (`sinProcesar`). Armá un lote con los de `sinProcesar` (y el sin confirmar, si no figura) y reintentá. Si el que falló fue por "Transacción Activa", esperá unos segundos. - **Documentación relacionada:** [Entrada y salida](input-output.md#validación-y-errores-del-lote) ## Terminal ### Los bordes de los paneles se ven como `?` o cuadraditos - **Severidad:** ocasional, en terminales viejas (como el `cmd` clásico de Windows) o fuentes sin caracteres de caja - **Síntoma:** los bordes de los paneles muestran `?`, `�` o cuadrados en lugar de líneas. - **Causa:** la terminal o la fuente no tiene los caracteres de caja Unicode que usa ARCLI (`╒`, `┃`, `╏`, `╓`, `╌`, `┈`, `━`, `▎`…). - **Solución:** usar una terminal moderna (Windows Terminal, iTerm2, la de VS Code) o activar los bordes y símbolos ASCII con `ARCLI_ASCII=1`. También cambia los símbolos del modo interactivo (`✔`, `❯`, `↑↓`); las tildes y la `ñ` se mantienen. ```bash ARCLI_ASCII=1 arcli fc -m 1000 --cs --cfinal ``` - **Documentación relacionada:** [Variables de entorno](configuration.md#variables-de-entorno) ## Acceso directo ### No se encontró el escritorio o la carpeta no existe - **Síntoma:** "No se encontró el escritorio en …" o "La carpeta … no existe". - **Causa:** el sistema no informa un escritorio (pasa en servidores o en Linux sin entorno gráfico) o la ruta que indicaste no existe. ARCLI no crea carpetas. - **Solución:** indicá una carpeta que exista. ```bash arcli acceso-directo ~/Documentos ``` ### Ya existe y no lo creó ARCLI - **Síntoma:** "… ya existe y no lo creó ARCLI". - **Causa:** en macOS y Linux ARCLI solo reemplaza el `ARCLI.app` o `ARCLI.desktop` que creó él. En Windows reemplaza `ARCLI.lnk` sin preguntar. - **Solución:** borrá ese archivo o creá el acceso directo en otra carpeta. ### `DESKTOP_SHORTCUT_ERROR` - **Síntoma:** "No se pudo crear el acceso directo en …" (solo en Windows). - **Causa:** el acceso directo `.lnk` lo crea PowerShell. Falla si no tenés permiso de escritura en la carpeta o si PowerShell está bloqueado. - **Solución:** probá en una carpeta tuya, por ejemplo `arcli acceso-directo %USERPROFILE%\Documents`, o pedile a quien administra la máquina que habilite PowerShell. ### En Linux el escritorio dice que el lanzador no es confiable - **Síntoma:** al hacer doble clic en `ARCLI.desktop` aparece "lanzador no confiable" o se abre como texto. - **Causa:** ARCLI lo marca como confiable con `gio`. Si `gio` no está o el escritorio no lo respeta, queda sin marcar. - **Solución:** clic derecho sobre el ícono y "Permitir ejecutar". ### El ícono dejó de abrir ARCLI - **Síntoma:** la ventana dice "ARCLI terminó con un error" o se cierra enseguida. - **Causa:** el acceso directo guarda las rutas de Node y de ARCLI del momento en que se creó. Si después moviste o reinstalaste Node (por ejemplo, con otra versión) o desinstalaste ARCLI, esas rutas ya no existen. - **Solución:** volvé a crearlo con `arcli acceso-directo`. Reemplaza al anterior. - **Documentación relacionada:** [Acceso directo](cli-reference.md#acceso-directo) ### El ícono dice "No se encontró ARCLI instalado" - **Síntoma:** al abrir el ícono aparece "No se encontró ARCLI instalado". - **Causa:** no hay un `arcli` instalado que el acceso directo pueda abrir. Pasa si lo creaste desde el código fuente (`yarn dev acceso-directo`) sin tener ARCLI instalado, o si cambiaste de versión de Node (por ejemplo con nvm) y ARCLI quedó instalado en la anterior. - **Solución:** instalalo con `npm install -g arcli` y volvé a abrir el ícono. No hace falta recrear el acceso directo. - **Documentación relacionada:** [Acceso directo](cli-reference.md#acceso-directo) ## PDF Un error del PDF no deshace la emisión: el comprobante ya tiene CAE. **No lo vuelvas a emitir para obtener el PDF**, porque quedaría duplicado en ARCA. Arreglá la causa para los próximos. Regenerar el PDF de un comprobante ya emitido todavía no está disponible. Ver [PDF de comprobantes](pdf.md#qué-no-hace-todavía). ### `PDF_PLUGIN_MISSING` - **Síntoma:** "Para generar PDFs falta instalar el plugin de PDF". - **Causa:** el plugin no se descarga solo con `--json` o sin terminal. También aparece si una versión nueva de ARCLI usa otra versión del plugin. - **Solución:** `arcli pdf instalar`. Para ver qué hay instalado: `arcli pdf`. ### `PDF_PLUGIN_INSTALL_ERROR` - **Síntoma:** `arcli pdf instalar` falla y muestra las últimas líneas de npm, o se corta con "no terminó en 5 minutos" (15 para el navegador). - **Causa:** sin internet, un proxy corporativo o un registro de npm privado. Si el proxy no responde, la instalación se corta por tiempo en lugar de quedar colgada. - **Solución:** revisá `npm config get proxy` y `npm config get registry` y volvé a correr `arcli pdf instalar`. Si lo que falla es la descarga del navegador y ya tenés Chrome, Chromium o Edge, indicá su ruta: ```bash arcli config establecer pdfNavegador "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" ``` ### `PDF_ISSUER_INCOMPLETE` - **Síntoma:** "Faltan datos del emisor para el PDF". - **Causa:** ARCA no guarda el nombre, el domicilio ni el inicio de actividades del emisor, y el PDF los necesita. - **Solución:** completalos una vez con los comandos que muestra el error: ```bash arcli config establecer emisor.razonSocial "Tu Nombre o Empresa" arcli config establecer emisor.domicilio "Calle 123, Ciudad" arcli config establecer emisor.inicioActividades 1/03/2020 ``` ### `PDF_GENERATION_ERROR` - **Síntoma:** "No se pudo generar el PDF". - **Causa habitual:** el navegador no arranca. Pasa en servidores sin entorno gráfico o con un Chrome muy viejo. - **Solución:** probá con otro navegador (`arcli config establecer pdfNavegador `) o borrá esa config para que ARCLI use el que descargó el plugin. --- # Novedades de cada versión Fuente: https://github.com/LcsGrz/arcli/blob/main/CHANGELOG.md Todos los cambios relevantes de ARCLI se documentan acá. El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y el proyecto usa [versionado semántico](https://semver.org/lang/es/). Como el contrato del CLI es público (comandos, flags, claves de config y JSON), cada entrada aclara qué cambia para quien ya lo usa. ## [Sin publicar] ## [2.5.0] - 2026-11-17 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](https://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`. - `--afecha` en las notas FCE y `--numero` en `fe`, `nde` y `nce` dejan de ser obligatorios: sin ellos, ARCLI los toma de ARCA. - `arcli config --json` trae `filasPorLista` y, mientras dure la deprecación, también `comprobantesPorLista` y `deprecado`. - En `arcli certificado generar --json`, `guia` apunta 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 a `comprobantesPorLista`, 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 muestran `arcli 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 de `arcli 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`, `060` o `usd`) y se desplazan con las flechas; las filas por página son las de `filasPorLista`. 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 `:** el listado tiene una fila de encabezado (`CÓDIGO`, la descripción y, en `iva-receptor` y `puntos-venta`, una tercera columna) y al pie para qué sirve el código en ARCLI. Es salida humana: el `--json` no 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 (`cbu` y `aliasCbu`), como ya pasaba con la actividad de la `E`. - **La E completa en el modo interactivo:** la factura `E` y 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 notas `E` ahora pueden ajustar otra nota `E`, no solo la factura. El comando equivalente incluye los flags nuevos (`--item`, `--idioma`, `--cuit-pais`, `--observaciones`, `--obs-comerciales`, `--incoterms-desc`, `--cm` y `--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 `E` y 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 que `arcli consultar fe`. Antes solo estaban los 19 tipos de A, B y C. - **Permisos de embarque en el modo interactivo:** la factura `E` de bienes pregunta los permisos de embarque ya existentes (opcional, separados por coma), igual que `--permiso` con `--permiso-existente`. Las notas `E` sobre una factura de bienes también los preguntan. - **`ultimos` y `consultar` con la E:** `arcli ultimos fe` (también `nde` y `nce`) lista los últimos comprobantes de exportación y `arcli consultar fe ` 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 su `config.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 nce` y `arcli nde` (también `arcli nota-credito e` y `arcli nota-debito e`) ajustan una Factura de exportación `E` ya emitida. Alcanza con el monto, el asociado (`--ar`, y `--apv` si 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` (`null` en 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 factura `E` ni 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 config `pdf`, y lo elegido decide. Con `pdf preguntar` (el valor por defecto) ya no hay una segunda pregunta, "¿Generamos el PDF del comprobante?", después de emitir. Con `pdf siempre` se puede emitir sin PDF (el cursor arranca en la opción con PDF), y con `pdf nunca` aparece la opción para generarlo esa vez. Con `--exportar-pdf` o `--sin-pdf` el PDF ya está decidido y la pregunta solo ofrece emitir o no. Al emitir sin confirmar (`--emitir`, `emitir true`, `--json` o sin terminal) todo sigue igual: decide la config. Vale para todos los comprobantes, también la `E`, 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 `--monto` para anularla entera. Antes la mandaba igual y decidía ARCA. Es el mismo control que ya tenían las notas `E` y 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 `--acuit` de otro CUIT no se controla, y si ARCA no responde la nota sigue con un aviso. - **`--afecha` deja de ser obligatoria en las notas FCE:** en `ncea`…`ndec`, sin `--afecha`, ARCLI toma la fecha del asociado de ARCA, como en las notas `E`, 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`. - **`--numero` deja de ser obligatorio en `fe`, `nde` y `nce`:** 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` (o `numero` en `--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 con `arcli 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](https://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 --ayuda` suma `Documentación: https://arcli.com.ar`, y el modo interactivo lo muestra al empezar la configuración guiada y al salir. En `arcli certificado generar --json`, el campo `guia` trae la URL nueva; los campos no cambian. ### Deprecado - **`comprobantesPorLista`**, ahora `filasPorLista`; se saca en la 3.0.0. Hasta entonces se sigue leyendo del archivo de config (si están las dos, gana `filasPorLista`), `arcli config establecer comprobantesPorLista N` avisa y guarda `filasPorLista` (y saca la vieja), y `arcli config --json` trae las dos con el mismo valor, más `deprecado`. ### Arreglado - **Datos vacíos del receptor en el PDF:** a un consumidor final sin identificar, el PDF muestra `Documento: -` en lugar de `Documento: - -`, 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-nombre` y `--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 en `cotizacion`), 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`, o `arcli interactivo --produccion`/`--testing`), no siempre los de testing. Con `entorno 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?](docs/comprobantes/README.md)), 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](docs/formas-de-uso/asistente.md), [comandos](docs/formas-de-uso/comandos.md) y [con IA](docs/formas-de-uso/con-ia.md)), el certificado de [testing](docs/certificado-testing.md) y de [producción](docs/certificado-produccion.md) en pasos cortos con las capturas plegadas, [cómo funciona](docs/mental-model.md), un índice de [comandos](docs/comandos.md) y el [PDF](docs/pdf-en-corto.md) en corto, cada uno con link a su guía completa. Suman [cambiar de entorno](docs/entornos.md), [consultas](docs/consultas.md), [notas](docs/notas-credito-debito.md), [FCE](docs/fce.md), [exportación](docs/exportacion.md) y [lotes y JSON](docs/lotes-y-json.md). Los links viejos siguen andando: `obtencion-certificados.md` y `usage-patterns.md` quedan como índice. El sitio publica además `llms-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 generar` e `importar` (la recomendada, con la que ya no hay que configurar nada) o, si la clave se hizo con openssl, las rutas a mano con `arcli config establecer`. - **Sitio de documentación:** [arcli.com.ar](https://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. ## [2.4.0] - 2026-11-08 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 ` ``, 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](docs/input-output.md#estabilidad-del-contrato). - **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](docs/modo-interactivo.md#menú-principal). - **`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](docs/troubleshooting.md#rechazos-de-arca-por-código). 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`. ## [2.3.0] - 2026-11-04 Trae el Recibo C (`rc`), `arcli certificado generar` e `importar` para sacar el certificado de ARCA sin `openssl`, y la condición de venta en el PDF. Gracias a [Guillermo Britos](https://github.com/guillermobr) y a [Kevin Tea](https://github.com/kevintea), que trajeron el recibo y la condición de venta. Un cambio puede afectar scripts: `--dia` está deprecado y ya no fija el período del servicio, solo el vencimiento. Sigue andando con un aviso. Ver "Cambiado". ### Agregado - **`arcli certificado generar` e `importar`:** arman la clave y el CSR para ARCA sin `openssl` (también en Windows) y cargan el certificado que devuelve ARCA. `importar` deduce el entorno del certificado, valida CUIT, vencimiento y clave, lo guarda en `certificados//` junto a la config y configura `cert.*`/`key.*`. Para renovar, la clave nueva queda pendiente hasta importar, así que se sigue facturando con el certificado actual. Las rutas configuradas a mano siguen andando. En el modo interactivo: Configuración → Certificados de ARCA, y la configuración guiada ofrece sacarlo si no tenés uno. - **Recibo C (`rc`, `arcli recibo c`):** emite o previsualiza un Recibo C (tipo ARCA 15) con los mismos flags y validaciones que la Factura C. La familia `recibo` solo tiene la letra C: `arcli recibo a` da error y el autocompletado ofrece solo `c`. Las notas de crédito y débito C pueden asociarse a un Recibo C (`arcli ncc --ac rc ...`). En el modo interactivo tiene su propia opción, **Emitir recibo**, y se puede elegir como comprobante original de una nota. "Repetir una factura anterior" pasa a llamarse **Repetir un comprobante anterior** y deja elegir entre una factura y un recibo. El PDF lleva el título `RECIBO C`, `COD.15` y el QR de ARCA con el tipo 15, y se guarda como `recibo-c_-.pdf`. Gracias a [Guillermo Britos](https://github.com/guillermobr), que lo trajo en [#78](https://github.com/LcsGrz/arcli/pull/78). - **Condición de venta en el PDF de A, B y C:** `--condicion-venta` (alias `--cv`), `condicionVenta` en el JSON de `--cargar` y la clave `condicionVenta` de la config como default. `--sin-condicion-venta` y `"condicionVenta": null` permiten omitir ese default para un comprobante. Acepta `contado`, `tarjeta-debito`, `tarjeta-credito`, `cuenta-corriente`, `cheque`, `transferencia`, `otros-medios-electronicos` y `otra`, que se imprimen con su nombre, o un texto libre que se imprime tal cual. El modo interactivo la pregunta con una lista y la de la config marcada; "Omitir" la suprime y "Otra" pide el texto. Es un dato exclusivo del PDF: WSFE no lo recibe. Gracias a [Kevin Tea](https://github.com/kevintea), que la trajo en [#74](https://github.com/LcsGrz/arcli/pull/74). ### Cambiado - **Rutas clickeables:** en terminales que soportan links (VS Code, iTerm2, Windows Terminal, Kitty, WezTerm, Ghostty), las rutas de `arcli config`, `arcli pdf`, el PDF guardado y `arcli certificado` se abren con un clic. `FORCE_HYPERLINK=0` los apaga. `arcli config` muestra además la carpeta de certificados. - **`arcli config revisar` más fácil de leer:** los chequeos van agrupados por sección (Cuenta, Al facturar, Certificados, Salida, PDF y Validaciones), con lo que falta en color, y los avisos de certificados sugieren `arcli certificado generar`. El JSON no cambia de forma. - **`--consumidor-final` (`--cfinal`) implica IVA receptor consumidor final:** ya no hace falta sumar `--ir-cf`, y anda aunque la config tenga otro `ivaReceptor`, que antes daba error. Lo mismo `tipoDocumento: "consumidor-final"` en el JSON de `--cargar`. Un IVA explícito distinto (`--cfinal --ir-rm`) sigue siendo error. - **`--dia` está deprecado y fija solo el vencimiento:** antes también ponía el período del servicio en ese día (`--dia 10` facturaba un servicio "del 10/11 al 10/11"). Ahora el período es el de `--servicio-desde`/`--servicio-hasta` o, sin ellos, la fecha del comprobante, como sin `--dia`. Se puede combinar con `--fecha` y `--servicio-hasta`, y da error junto con `--vencimiento`/`--vto`. Sigue andando con un aviso; usá `--vencimiento` o `--vto`. Lo mismo la clave `dia` del JSON de `--cargar`. ### Corregido - **Fechas sin año en el cambio de año:** se tomaba siempre el año actual, así que el 5/1/2027 `--sd 1/12` era diciembre de 2027. Ahora se toma la fecha más cercana a hoy: diciembre de 2026, y el 28/12 `--vto 10/1` es enero que viene. - **`--moneda EUR` y `BRL`** se mandaban tal cual y ARCA las rechazaba: ahora se traducen a sus códigos (`060` y `012`) en `fc`/`fb`/`fa`, `fe` y `parametros cotizacion`. - **`--misma-moneda` con `--fecha` futura** llegaba a ARCA y fallaba con el error 10038: ahora pide que la fecha sea la de hoy, porque ARCA solo publica la cotización vigente. - **Repetir una factura con montos chicos** podía deducir mal la alícuota de IVA (por ejemplo, 2,5% en vez de 21%). ### Seguridad - **Publicación en npm más estricta:** el paquete se publica desde el tag de la release de GitHub (antes, desde lo último de `main`) y el release falla si el tag no coincide con la versión. Se arma en un job sin permiso para publicar, sin cache y sin scripts de dependencias, y antes de publicarlo se instala y se prueba que arranque. ## [2.2.1] - 2026-11-03 Corrige `arcli pdf instalar` en Windows y suma lo necesario para recibir contribuciones: plantillas de issue y de PR, código de conducta, Discussions para preguntas, y un CI que también corre en Windows, macOS y Node 26. No cambian comandos, flags, claves de config ni el `--json`. ### Corregido - **`arcli pdf instalar` en Windows:** la descarga del navegador pasaba por `cmd.exe`, que corta las rutas con espacios (como `C:\Users\Nombre Apellido`), y fallaba. Ahora la shell se usa solo para correr `npm.cmd`. ### Documentación - El README explica cómo instalar con pnpm y Yarn además de npm, cómo probarlo con `npx` y cómo actualizar, y suma las secciones "Ayuda y soporte" (preguntas en [Discussions](https://github.com/LcsGrz/arcli/discussions), bugs en issues) y "Estabilidad" (qué es contrato público y qué puede cambiar entre versiones). - Plantillas de issue y de PR, y [código de conducta](CODE_OF_CONDUCT.md). - El CI corre también en Windows, macOS y Node 26. ## [2.2.0] - 2026-11-02 Trae la factura de exportación `E` (`arcli fe`) sobre WSFEX: items, país de destino, incoterm y permisos de embarque, con credenciales propias para `wsfex`, PDF con el diseño de exportación y modo interactivo. Es todo agregado: los comandos y flags de A, B, C y FCE siguen igual. Gracias a [Manuel Aller](https://github.com/itManuel), que la trajo en [#67](https://github.com/LcsGrz/arcli/pull/67). Además suma el autocompletado con Tab, el número del comprobante en el JSON, la validación del dígito verificador de todo CUIT y una ayuda más corta y en español, y corrige varios errores de la revisión del repo. Dos cambios pueden afectar scripts: los mensajes ahora usan voseo y tildes (si comparás el texto de un error en lugar de `codigo`), y un `montoTotal` con más de 2 decimales en el JSON da error en lugar de redondearse. Ver "Cambiado" y "Corregido". ### Agregado - **`arcli fe` y `arcli factura e`:** emiten o previsualizan la Factura de exportación `E` (tipo 19) con WSFEX. Obligatorios: `--monto`, `--cliente`, `--domicilio-cliente`, `--pais-destino` (código o nombre), `--numero` y la actividad. Opcionales: `--id-impositivo`, `--cuit-pais`, `--tipo-expo` (`1` bienes, `2` servicios, `4` otros), `--incoterm`, `--incoterms-desc`, `--idioma`, `--forma-pago`, `--permiso` con `--permiso-existente`, `--id-solicitud`, `--fecha-pago`, `--observaciones` y `--obs-comerciales`. No lleva concepto, IVA ni receptor con CUIT/CUIL/DNI. `fe` va en la tabla de atajos de `arcli --ayuda` y en `arcli ejemplos`, y Tab completa la letra `e` en `arcli factura`. - **`--numero` obligatorio en la `E`:** WSFEX numera por punto de venta y tipo, pero `@arcasdk/core` todavía no permite consultar el último comprobante E. Pasá el siguiente al último que emitiste (`1` si es el primero). - **Actividad de la `E`:** `--actividad` o la clave nueva `exportacion.actividad` (sección "Factura de exportación (E)" de `arcli config`), con un código de la tabla de actividades de WSFEX, que no es la del padrón. No hay default; un código que no está en la tabla es error de validación con los que empiezan igual. - **Flags de otra letra en `arcli factura `:** como `factura` comparte el comando para A, B, C y E, los flags que no aplican a la letra elegida se saltean con un aviso en "Avisos" y en `avisos` del JSON (`factura a --incoterm`, `factura e --alicuota`). Los atajos (`fa`, `fe`…) siguen rechazándolos como opción desconocida. - **`--item` con detalle real:** `codigo|descripcion|cantidad|precio|unidad`, repetible; el código y la unidad son opcionales y la unidad puede ser el código de ARCA o su nombre. La suma de los items tiene que dar `--monto` y se valida antes de autenticar en WSAA, porque WSFEX no lo controla. - **`--cargar` para `E`:** un objeto, con claves propias (`cliente`, `domicilioCliente`, `paisDestino`, `monto`, `numero`, `actividad`, `items`, `tipoExpo`…). El lote no está soportado: un array es error de entrada. - **`exportacion.cert.testing`, `exportacion.cert.produccion`, `exportacion.key.testing`, `exportacion.key.produccion`:** credenciales del servicio `wsfex`, para cuando el certificado general no está autorizado a exportación. Si no están las dos de un entorno, se usan `cert.*`/`key.*`; con la mitad del par configurada el comando corta antes de ir a ARCA. Se muestran en la sección **Certificados** de `arcli config` (también en el modo interactivo), se validan como PEM al guardarlas y `arcli config revisar` las revisa con el resto. Sin autorización a `wsfex`, el error es `WSFEX_SERVICE_NOT_AUTHORIZED`. - **Defaults de la `E`:** sin flags, la exportación sale de servicios (`Tipo_expo` `2`), en dólares (`Moneda_Id` `DOL`), con la cotización de aduana que publica ARCA (si la del día todavía no salió, la última, con un aviso) y con forma de pago `Transferencia Internacional`. Las claves `moneda` y `cotizacion` de la config no aplican a exportación. - **Salida JSON de exportación:** el mismo resumen que A, B y C (`atajo: "fe"`, `tipoArca: 19`, `comprobante: "Factura de exportación E"`) más un bloque `exportacion` con cliente, destino, domicilio, actividad, incoterm, items y permisos; `solicitud` es el `Cmp` de WSFEX, con los nombres de ARCA. Forma exacta en [entrada y salida](docs/input-output.md#factura-de-exportación-e). - **PDF de exportación:** se guarda como `factura-e_-.pdf` con el diseño de exportación de `@arcasdk/pdf` y los mismos datos que la E de Comprobantes en línea: título `FACTURA DE EXPORTACIÓN`, items de WSFEX, país de destino, CUIT del país con su tipo de entidad, ID impositivo, divisa con su código ISO (`USD - Dólar Estadounidense`), forma y fecha de pago, incoterm y la leyenda `IVA EXENTO OPERACIÓN DE EXPORTACIÓN`, sin discriminar IVA. - **Factura E en el modo interactivo:** se elige en el mismo selector que A, B y C y tiene su propio asistente (cliente, país, tipo, monto, moneda, incoterm en bienes, pago, actividad y número), con vista previa, comando equivalente y PDF. Ver [modo interactivo](docs/modo-interactivo.md#factura-de-exportación-e). - **CUIT con dígito verificador y con o sin guiones en todos lados:** `arcli padron`, `arcli fce-obligado`, `--cuit`, `--cuil`, `--acuit`, `comprobanteAsociado.cuit` en el JSON, `config establecer cuit` y el modo interactivo aceptan `20-33333333-4` o `20333333334`, y rechazan un CUIT mal tipeado antes de llegar a ARCA. Antes `arcli padron 20-20179706-4` fallaba y nadie chequeaba el dígito verificador. - **Error `ARCA_LAST_VOUCHER_ERROR`:** si ARCA rechaza el pedido del último número (por ejemplo, con un punto de venta no habilitado para web service), la facturación y `arcli ultimos` cortan ahí con el mensaje de ARCA y una sugerencia. No se emite nada. - **Esc en las preguntas del CLI:** "¿Querés emitir … ahora?", que aparece sin `--emitir` en una terminal, ahora se cierra con Esc como un "no", igual que en el modo interactivo y en las preguntas del PDF. - **`numero` en el JSON de facturación:** el número que le tocó al comprobante emitido (`null` en una previsualización), y `solicitud` lo trae en `CbteDesde`/`CbteHasta`. El panel de texto muestra `Número: 00003-00000125`. Antes el número solo se veía con `--bruto`. - **Autocompletado con Tab** para bash, zsh y fish. Se instala con `arcli completado instalar`, que agrega una línea al archivo de inicio del shell (`~/.zshrc`, `~/.bashrc`…), y se saca con `arcli completado desinstalar`; también desde el modo interactivo, en Configuración → Autocompletado. Completa comandos y atajos, flags, valores (`--iva-receptor`, `--concepto`, `--alicuota`, `--moneda`, `--transferencia`, `--ac`), claves de config y sus valores, tablas de `parametros` y letras de las familias; donde va una ruta, archivos. No hay que reinstalarlo al actualizar ARCLI. Ver [Autocompletado](docs/cli-reference.md#autocompletado). ### Cambiado - **Ayuda más corta y toda en español.** `arcli --ayuda` pasa de unas 145 líneas a 57: los 18 atajos van en una tabla familia × letra y `storybook` (herramienta de desarrollo) ya no aparece, aunque sigue funcionando. La ayuda de cada comprobante (`arcli fc --ayuda`) pasa de 177 a 79 líneas: muestra solo los flags que aplican a ese comprobante, menciona los alias en la opción principal (`punto de venta (alias: --pv)`) y ya no repite la tabla de parámetros. Los flags ocultos se siguen aceptando igual. "Usage", "Options", `[options]`, `` y la descripción de `--version` ahora están en español. - **Errores de uso en español:** opción o comando desconocido, valor faltante y argumentos de más (`opción desconocida '--montoo' (¿quisiste decir --monto?)`). También en el `error` del JSON con `--json`; el `codigo` sigue siendo `INPUT_VALIDATION_ERROR`. - **Voseo y tildes en toda la salida:** mensajes, ayuda, modo interactivo y PDF ("Usá", "Revisá", "número", "configuración"). Los flags, claves de config, valores (`produccion`, `cotizacion`) y claves JSON no cambian. Si un script compara el texto de un mensaje de error en lugar de `codigo`, puede necesitar un ajuste. ### Corregido - **Punto de venta inválido:** la facturación seguía con el número 1 y recién fallaba al emitir con un error confuso, y `arcli ultimos` mostraba que no había comprobantes. Ahora cortan con `ARCA_LAST_VOUCHER_ERROR`. - **Lote cortado antes de emitir:** si el lote se cortaba en el login o en el pedido del último número, el comprobante que falló no figuraba en `detalles.sinProcesar` de `BATCH_EMISSION_ERROR`, y reintentar solo esa lista lo perdía. Ahora figura. Si la emisión quedó sin confirmar, sigue en `sinConfirmar` y no en `sinProcesar`, como antes. - **IIBB en el PDF:** sin `emisor.iibb`, el PDF decía "Exento"; ahora muestra "-". Si sos exento, configuralo con `arcli config establecer emisor.iibb Exento`. La configuración guiada del modo interactivo ahora lo pregunta junto a los otros datos del emisor. - **Números con letras o notación científica:** `config establecer puntoVenta 3a` guardaba `3`, y `arcli consultar fc 1e3` buscaba el 1000. Ahora dan error, igual que en el modo interactivo. - **`arcli pdf instalar` colgado:** con un proxy que no responde, npm o la descarga del navegador no terminaban nunca. Ahora se cortan a los 5 y 15 minutos con `PDF_PLUGIN_INSTALL_ERROR`. - **`montoTotal` del JSON nunca se redondea:** con más de 2 decimales se redondeaba en silencio antes de validar (`1.005` se emitía por `$1`). Ahora da `INPUT_VALIDATION_ERROR` ("Use hasta 2 decimales"), igual que `--monto` y el resto de los importes. - **`consultarPadron false` se respeta siempre:** con un `ivaReceptor` en la config, facturar con `--cuit` igual consultaba el padrón y su condición IVA pisaba la de la config. - **Aviso falso en `avisos`:** "--descripcion, --receptor-nombre y --receptor-domicilio solo se usan en el PDF" salía sin haber pasado esos flags, cuando el nombre o el domicilio los había completado el padrón. - **Modo interactivo:** al generar el PDF, apretar Enter en el nombre o el domicilio del receptor borraba lo que había traído el padrón; ahora lo propone y Enter lo deja. En una FCE se informa el `aliasCbu` de la config, como con flags. Y si la config tiene una moneda extranjera, el comando equivalente de un comprobante en pesos lleva `--moneda ARS`, así al pegarlo hace lo mismo. - **Leyendas obligatorias en el PDF:** los comprobantes B ahora traen el bloque del Régimen de Transparencia Fiscal al Consumidor (Ley 27.743, RG 5614), con el IVA contenido, y los comprobantes A a un monotributista la leyenda de la RG 5003 sobre el crédito fiscal. Salen debajo del CAE. Ver [PDF](docs/pdf.md#leyendas-obligatorias). ### Documentación - Nueva sección de la `E` en [referencia del CLI](docs/cli-reference.md#factura-de-exportación-e-wsfex) y en [reglas de validación](docs/validation-rules.md#factura-de-exportación-e); credenciales de WSFEX en [configuración](docs/configuration.md#certificados-de-exportación-wsfex); items, JSON y limitaciones (`--numero` obligatorio, sin notas E, sin lote) en [entrada y salida](docs/input-output.md), [PDF](docs/pdf.md) y [limitaciones](docs/limitations.md); el asistente de la `E` en [modo interactivo](docs/modo-interactivo.md) y sus problemas comunes en [troubleshooting](docs/troubleshooting.md). ## [2.1.0] - 2026-10-23 Trae `arcli padron` y el IVA receptor desde el padrón al facturar con `--cuit`, el aviso de vencimiento del certificado y una guía para el punto de venta de web service. Además corrige un montón de cosas que salen de una revisión del repo: el JSON de `--cargar` se valida clave por clave, los errores con `--json` tienen siempre la misma forma, y los ejemplos de la ayuda y de los docs se pueden copiar y andan. Algunos cambios rompen scripts que dependían del comportamiento anterior. Revisá la sección "Cambiado": - **Exit code `2`** cuando ARCA rechaza un comprobante (antes, `0`). - **Validación estricta del JSON de `--cargar`:** una clave desconocida o con otro tipo ahora es error. - **Un array de un elemento en `--cargar`** sale como array. - **`--bruto`** agrega `respuesta` en lugar de reemplazar el resumen. - **`config revisar`** ya no recibe `--testing` ni `--produccion`. - **Los PDFs** se guardan en una subcarpeta por CUIT. Los comandos, los flags de facturación y las claves de config siguen siendo los mismos. ### Agregado - **`arcli padron `:** nombre o razón social, domicilio fiscal, condición IVA, impuestos, categoría de monotributo y actividad de un CUIT, desde el padrón de ARCA (`ws_sr_constancia_inscripcion`). Con `--json` para scripts. - **IVA receptor desde el padrón:** al facturar con `--cuit` y sin `--ir`, ARCLI usa la condición IVA del padrón, antes que el `ivaReceptor` de la config. También completa el nombre y el domicilio del receptor para el PDF. Si el padrón no responde o no la informa, sigue con la config y avisa. El modo interactivo propone la misma condición al cargar un CUIT. Se desactiva con `arcli config establecer consultarPadron false`. - **Aviso de vencimiento del certificado:** a menos de 30 días de vencer cualquiera de los certificados configurados (testing o producción, sin importar con cuál estés trabajando), los comandos que van a ARCA (facturación, `ultimos`, `consultar`, `padron`, `fce-obligado`, `parametros`, `estado`) avisan al principio, en stderr: `El certificado de produccion vence el 20/11/2026 (en 10 días)`, con el link a la [guía para renovarlo](docs/obtencion-certificados.md). Con `--json`, stdout queda solo con el JSON y en facturación el aviso va también en `avisos`. En el modo interactivo es un recuadro debajo de la barra de estado. Si vencen los dos, van en el mismo recuadro. Si ya venció el del entorno que se usa, cortan antes de autenticar en ARCA con el error `CERTIFICATE_EXPIRED` (antes fallaba el login en WSAA con un error inesperado). - **Punto de venta para web service:** si ARCA rechaza el comprobante porque el punto de venta no es de web service (error `10005`), la `sugerencia` lo dice y apunta a la [guía para crear uno](docs/obtencion-certificados.md#punto-de-venta-para-web-service). `arcli estado` avisa lo mismo cuando el punto de venta configurado no está entre los habilitados. Desde el 1/11/2026 ARCA da de alta de oficio puntos de venta "Factura en línea" a monotributistas (RG 5893/2026), y esos no sirven para ARCLI. ### Cambiado - **`--bruto` agrega la respuesta cruda sin quitar el resumen:** con `--json --bruto` ahora salen `cae`, `caeVencimiento`, `estado`, `resultado`, `errores`, `observaciones` y el resto del JSON de siempre, más `respuesta` con la respuesta cruda de ARCA. Antes `--bruto` reemplazaba el resumen y esos campos desaparecían, aunque la documentación decía que agregaba. En texto pasa lo mismo: el resultado se muestra como siempre y el panel `Respuesta bruta` va al final. Vale igual para `bruto=true` en la config. - **Un array de un elemento en `--cargar` es un lote:** si el JSON es un array sale un array (con `indice`) y los errores son `BATCH_VALIDATION_ERROR` / `BATCH_EMISSION_ERROR`, tenga uno o muchos elementos. Antes un array de un elemento salía como objeto y con los errores de un comprobante suelto. Un objeto sigue devolviendo un objeto. Si un script leía `[0]` solo cuando había más de uno, ya puede leer siempre el array. - **El JSON de `--cargar` se valida clave por clave:** una clave desconocida (`"montototal"`, `"vencimiento"`, `"moneda"`) o un valor con otro tipo (`"puntoVenta": "3"`, `"emitir": "true"`, `null`) ahora es error de entrada (`INPUT_VALIDATION_ERROR`, o `BATCH_VALIDATION_ERROR` con el índice en un lote) que nombra la clave y sugiere la correcta. Antes se ignoraban sin aviso: con `"puntoVenta": "3"` se emitía en el punto de venta de la config. Si un archivo que te funcionaba ahora falla, corregí la clave o sacale las comillas al número; las claves documentadas siguen igual. Un lote vacío (`[]`) también es error: antes se ignoraba el archivo y se usaban solo los flags. La tabla de claves y su flag equivalente está en [entrada y salida](docs/input-output.md#flags-y-claves-del-json). - **`config revisar` revisa los dos entornos:** valida el entorno por defecto y cualquier otro que tenga `cert` o `key` configurados, cada uno en su línea (`Validacion testing`, `Validacion produccion`). La línea `Revision activa` del JSON ya no existe. Ya no recibe `--testing` ni `--produccion`: antes los aceptaba pero los ignoraba y revisaba siempre testing. - **Exit code `2` cuando ARCA rechaza un comprobante:** antes salía con `0` y había que leer `estado` para enterarse. En un lote, `2` si ARCA rechazó al menos uno. `observado` sigue saliendo con `0`. Si un script trataba cualquier exit distinto de `0` como error de ARCLI, ahora también corta en un rechazo. - **PDFs en una subcarpeta por CUIT emisor:** `~/arcli/comprobantes/20123456789/factura-c_0003-00000125.pdf` (en testing, `testing/20123456789/`). Si el archivo ya existe no se pisa: se guarda con `-2`, `-3` y así. - **`sugerencia` siempre en el JSON de error:** todos los errores con `--json` traen las mismas cuatro claves (`codigo`, `detalles`, `error`, `sugerencia`), con `sugerencia: null` cuando no hay nada que sugerir. Antes faltaba en los errores sin sugerencia (`CONFIGURATION_ERROR`, `INPUT_VALIDATION_ERROR`…) y era `null` solo en los inesperados. Si un script chequeaba si la clave existe, ahora tiene que chequear si es `null`. - **`--bruto` solo en los comandos de facturación:** `padron`, `fce-obligado`, `ultimos`, `consultar`, `parametros`, `estado` e `interactivo` ya no lo declaran (no lo usaban): pasado ahí, el comando corre igual y avisa en stderr que se ignora. Ya no aparece en su ayuda. - **`arcli interactivo --json` ya no falla:** el asistente acepta solo `--testing` y `--produccion`; `--json` y `--bruto` se ignoran con un aviso. Sin terminal interactiva sigue fallando, con o sin `--json`. - **Comando equivalente del modo interactivo:** siempre lleva `--testing` o `--produccion`. Antes, en testing no llevaba nada, y si la config pasaba a producción el comando pegado emitía ahí. ### Corregido - **Ejemplos de la ayuda y de los docs que fallaban:** los ejemplos de `--ayuda` de las notas B y C, las B, las FCE y las familias, las NC/ND FCE de `arcli ejemplos` y varios de los docs (`pdf.md`, `usage-patterns.md`, `cli-reference.md`, el JSON de `llms.txt` y de `input-output.md`) daban error al copiarlos: asociado de otra letra, IVA receptor que la letra no admite, FCE sin `--cbu` o con `--acuit` ajeno, fechas fijas viejas o sin IVA receptor. Ahora cada nota asocia una factura de su letra y categoría, y un test pasa todos los ejemplos por el parser y arma la solicitud a ARCA. - **"Puede haberse emitido" cuando seguro no se emitió:** un certificado vencido, un fallo de login en WSAA o un error al pedir el último número salían como `EMISSION_UNCERTAIN`, con la sugerencia de verificar con `arcli ultimos` antes de reintentar. En esos casos no llegó nada a ARCA: ahora salen con su error (`UNEXPECTED_ERROR` o `TRANSIENT_ERROR` en el JSON) y se puede reintentar directo. `EMISSION_UNCERTAIN` queda solo para un fallo en la llamada que emite (red, timeout, transacción activa). En un lote, ese caso ya no suma `detalles.sinConfirmar`. - **Lote interrumpido, PDFs de los ya emitidos:** si un lote se cortaba a mitad, los comprobantes que ya tenían CAE quedaban sin PDF. Ahora se generan antes de mostrar el error, según `pdf` o `--exportar-pdf` como en un lote completo, y en `--json` cada uno lleva su campo `pdf`. Si falla el PDF, el error que se muestra sigue siendo el de la emisión. - **Lote, fallos del padrón o de la cotización con su índice:** si la consulta al padrón (IVA receptor desde `--cuit`) o a la cotización oficial fallaba para un ítem, el lote cortaba con un error que no decía cuál era. Ahora sale en `BATCH_VALIDATION_ERROR`, junto con los demás ítems con problemas y su `#n`, antes de emitir ninguno. - **`config.json` con JSON inválido** salía como "Error inesperado", sin decir qué archivo ni qué hacer. Ahora es un error de configuración (`CONFIGURATION_ERROR`) con la ruta del archivo y la sugerencia de corregirlo a mano o renombrarlo y volver a configurar. ARCLI no lo borra ni lo pisa. - **`json=true` de la config en todos los comandos:** `pdf` (y sus subcomandos) y `parametros` sin tabla solo salían en JSON con `--json`. Ahora todos los comandos resuelven la salida igual: `--json` o, si no está, la clave `json` de la config. `config ruta` acepta `--json` y devuelve `{"ruta": "..."}`. - **Errores de uso en JSON:** una opción desconocida (`arcli fc --montoo 1 --json`), un valor faltante o un comando que no existe salían en texto aunque se pidiera JSON. Ahora, con `--json` o `json=true`, salen como `INPUT_VALIDATION_ERROR` en el mismo formato que el resto de los errores, con exit code `1`. Sin JSON se ven igual que antes. - **Opciones globales que no aplican:** `--testing`, `--produccion`, `--json` o `--bruto` en un comando que no las usa (`arcli config ruta --produccion`) se aceptaban sin decir nada. Ahora el comando corre igual y avisa en stderr que la opción se ignora. - **`json=true` en `config`:** `config`, `config revisar`, `config establecer` y `config eliminar` respetan `json=true` de la config, como el resto de los comandos. - **`--dia` corría un mes de más** a fin de mes: `--dia 15` el 31/03 daba el 15/05 en vez del 15/04, y ARCA lo aceptaba con las fechas de servicio y vencimiento equivocadas. Si el día no existe en ese mes (`--dia 31` con abril), ahora da error. - **`--json` con `FORCE_COLOR`:** con `FORCE_COLOR=1` en el entorno, el JSON redirigido a un archivo o a otro programa salía con colores y no se podía parsear. Ahora solo se colorea en una terminal. - **`--json` en `config`:** `config`, `config revisar`, `config establecer` y `config eliminar` ignoraban `--json` y salían en texto. - **`config --ayuda` listaba la mitad de las claves:** mostraba 15 de 30. Ahora `config --ayuda` y `config establecer --ayuda` listan todas, por sección, con sus valores posibles. - **Links de `llms.txt` y del README en el paquete de npm:** apuntaban a `docs/`, que no se publica en npm. Ahora son links a GitHub. - **`config establecer` con un valor inválido** (`puntoVenta abc`, `comprobantesPorLista 99`) sale como error de entrada (`INPUT_VALIDATION_ERROR`) y no como error inesperado. ## [2.0.0] - 2026-10-12 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 `