Configuración
Cómo funciona la configuración persistente de ARCLI y qué conviene dejar guardado.
Propósito
Sección titulada «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
Sección titulada «Ubicación del archivo»ARCLI usa conf con:
projectName: arcliconfigName: 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:
arcli config rutaSi el archivo no existe, arcli config lo crea automáticamente.
En esa carpeta también quedan certificados/<CUIT>/ (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.
Claves soportadas
Sección titulada «Claves soportadas»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
Sección titulada «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
Sección titulada «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 |
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), 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. 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 |
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
Sección titulada «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
Sección titulada «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 |
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
Sección titulada «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í/noo1/0.
Certificados con arcli certificado
Sección titulada «Certificados con arcli certificado»arcli certificado generar y arcli certificado importar guardan la clave y el certificado en certificados/<CUIT>/, junto a config.json, y configuran cert.<entorno> y key.<entorno> apuntando ahí. Si ya tenés las rutas configuradas a mano, siguen andando igual. Ver Comando arcli certificado.
Certificados de exportación (WSFEX)
Sección titulada «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:
arcli config establecer exportacion.cert.testing /ruta/al/certificado-exportacion.crtarcli config establecer exportacion.key.testing /ruta/a/la/clave-exportacion.keyarcli config establecer exportacion.cert.produccion /ruta/al/certificado-exportacion.crtarcli config establecer exportacion.key.produccion /ruta/a/la/clave-exportacion.keyReglas:
- si
exportacion.cert.<entorno>yexportacion.key.<entorno>están los dos, se usan esos; - si no hay ninguno de los dos, ARCLI usa
cert.<entorno>ykey.<entorno>; - 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.
La actividad que informa la E se guarda una vez con arcli config establecer exportacion.actividad <codigo> (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)
Sección titulada «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:
arcli config establecer ticketPath /ruta/que/prefierasarcli config eliminar ticketPathEl 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
Sección titulada «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.
Prioridad de fuentes
Sección titulada «Prioridad de fuentes»ARCLI resuelve los datos en este orden:
- flags
- JSON cargado con
--cargar - config persistente
- defaults internos
Ejemplo:
- si pasás
--moneda USD, gana eso - si no pasás
--monedapero el JSON traecodigoMoneda, gana el JSON - si no hay JSON, usa
monedade 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
Sección titulada «Comandos de configuración»Ver configuración actual
Sección titulada «Ver configuración actual»arcli configVer ruta del archivo
Sección titulada «Ver ruta del archivo»arcli config rutaarcli config ruta --json # {"ruta": "..."}Revisar configuración activa
Sección titulada «Revisar configuración activa»arcli config revisararcli config revisar --jsonconfig 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
certokeyconfigurados - el plugin de PDF, como
arcli pdf estado: si está instalado, si es la versión que usa ARCLI y si encontró un navegador. Conpdf=siempreavisa si falta; conpreguntar(por defecto) lo revisa solo si está instalado, y connunca, 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.
arcli config --ayuda y arcli config establecer --ayuda listan todas las claves con sus valores.
Guardar o eliminar valores
Sección titulada «Guardar o eliminar valores»arcli config establecer puntoVenta 3arcli config eliminar puntoVentaValidación al guardar credenciales
Sección titulada «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.
Variables de entorno
Sección titulada «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) |
Qué conviene guardar
Sección titulada «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.
Advertencias
Sección titulada «Advertencias»emitir=true
Sección titulada «emitir=true»Si guardás:
arcli config establecer emitir trueARCLI 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.