El paquete trae un comando, facturas, para la parte más difícil del primer
comprobante: las habilitaciones de ARCA. Genera la clave y el CSR, prueba cada
capa en orden y nombra la que falla, con la página y la acción exactas.
Necesitás Node.js 22 o superior. No instala nada aparte del paquete. Esta
página es el recorrido para la primera vez. Todas las opciones, la tabla de
diagnósticos, la salida --json y los códigos de salida están en
Comandos del CLI.
Qué guarda y qué nunca hace
init, cert y check nunca escriben en ARCA. Solo leen. cert no
descarga nada: el certificado se lo pegás vos.init copia el CSR al portapapeles del sistema en homologación, con la
herramienta que ya tiene tu sistema (pbcopy, wl-copy, xclip, xsel o
clip), sin shell y sin instalar nada. Si no hay ninguna, lo imprime.- Lo único que el CLI guarda, aparte de los archivos de
init, es el ticket
WSAA: en <temporal del sistema>/facturas-cli, con el directorio en 0700
y los archivos en 0600. El ticket dura 12 horas y el CLI lo reusa mientras
sigue vigente. ARCA rechaza un login nuevo hasta unos minutos después del
anterior (coe.alreadyAuthenticated: 2 en producción, 10 en homologación),
así que sin ese archivo no podrías correr check dos veces seguidas ni
encadenar check con issue.
Con --no-cache el CLI no lee ni escribe nada: pide un ticket nuevo y lo usa
solo en memoria.
- No hay archivo de configuración, ni telemetría, ni ningún otro dato guardado.
- Nunca imprime el contenido de un PEM, un token, una firma ni un CMS. Los
errores que no están en la tabla de
diagnósticos salen con el mensaje seguro del
SDK.
issue sí escribe en ARCA: emite un comprobante real de homologación. Se
niega fuera de test.
1. Generá la clave y el CSR
Sin flags y en una terminal, pregunta el CUIT y el entorno. Escribe
arca-test.key, una clave privada RSA 2048 con permisos 0600, y
arca-test.csr, el pedido de certificado con el subject que pide el
instructivo oficial. Si hay un .gitignore en el directorio, le agrega
arca-*.key y arca-*.crt.
En homologación copia el CSR al portapapeles y después imprime los pasos
exactos en ARCA, solo para el entorno que elegiste:
Los nombres de página, campo y botón están verificados contra las referencias
oficiales que lista Habilitación en ARCA. La
salida para producción y la tabla de páginas están en
Comandos del CLI.
2. Guardá el certificado
En homologación no hay descarga: el certificado aparece en el cuadro de
resultado del propio WSASS. Por eso init lo pide ahí mismo, mientras la
pestaña sigue abierta. Pegás el bloque entero y termina solo al ver la línea
-----END CERTIFICATE-----:
Antes de escribir, verifica que el certificado sea de esa clave y de ese CUIT.
Si saliste con Ctrl-C, npx facturas cert hace lo mismo después.
3. Probá cada capa
No hay ningún export que copiar: check encuentra el par de archivos en el
directorio y saca de ahí el entorno y el CUIT. Si una capa falla, nombra el
paso y muestra dónde corregirlo en ARCA. Las variables de entorno son para tu
aplicación, no para el CLI, y están en
Inicio rápido.
4. Emití una prueba
Emite una factura de ARS 1 en homologación y se niega fuera de test.
Corre antes las capas de check y no sigue si alguna falla. Emite sin store
y sin idempotencyKey: es el inicio rápido en un comando. En tu aplicación
real, configurá los dos, como explica
Inicio rápido.
Si el comprobante no queda autorizado, sale con código 1 y el consejo de
Inicio rápido. Last modified on October 2, 2026
