Ir al contenido
Star104

Configuración

Cómo funciona la configuración persistente de ARCLI y qué conviene dejar guardado.

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.

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:

Terminal
arcli config ruta

Si 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.

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

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

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

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

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)

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.

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.

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:

Terminal
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.<entorno> y exportacion.key.<entorno> están los dos, se usan esos;
  • si no hay ninguno de los dos, ARCLI usa cert.<entorno> y key.<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.

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:

Terminal
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.

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.

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).

Terminal
arcli config
Terminal
arcli config ruta
arcli config ruta --json # {"ruta": "..."}
Terminal
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.

arcli config --ayuda y arcli config establecer --ayuda listan todas las claves con sus valores.

Terminal
arcli config establecer puntoVenta 3
arcli config eliminar puntoVenta

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.

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)

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.

Si guardás:

Terminal
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.

¿Te sirvió esta página?
Editar esta página en GitHub