ARCLI

       d8888 8888888b.   .d8888b.  888      8888888
      d88888 888   Y88b d88P  Y88b 888        888
     d88P888 888    888 888    888 888        888
    d88P 888 888   d88P 888        888        888
   d88P  888 8888888P"  888        888        888
  d88P   888 888 T88b   888    888 888        888
 d8888888888 888  T88b  Y88b  d88P 888        888
d88P     888 888   T88b  "Y8888P"  88888888 8888888

Emití o previsualizá comprobantes ARCA desde tu terminal, con un flujo claro, seguro y rapido en lugar de utilizar UI.

Características

• configuración persistente por usuario
• previsualización segura antes de emitir
• entrada por flags o JSON
• salida humana, JSON o respuesta bruta
• prompts interactivos cuando el flujo lo requiere
• integración real con ARCA

Demo basica

npm install -g arcli
arcli config
arcli config establecer cuit 20168598204
arcli config establecer puntoVenta 3
arcli config establecer cert.testing /ruta/al/certificado.crt
arcli config establecer key.testing /ruta/a/la/clave.key

arcli fc -m 15000 --cs --consumidor-final --ir-cf

Inicio rápido

1. Instalar

Requiere Node.js 20 o superior.

npm install -g arcli

2. Crear o abrir la configuración

arcli config

3. Guardar defaults útiles

arcli config establecer cuit 20168598204
arcli config establecer puntoVenta 3
arcli config establecer concepto servicios
arcli config establecer ivaReceptor consumidor-final
arcli config establecer moneda ARS
arcli config establecer cotizacion 1
arcli config establecer emitir false
arcli config establecer bruto false

4. Configurar credenciales

arcli config establecer cert.testing /ruta/al/certificado.crt
arcli config establecer key.testing /ruta/a/la/clave.key

Si después querés usar producción:

arcli config establecer cert.produccion /ruta/al/certificado.crt
arcli config establecer key.produccion /ruta/a/la/clave.key

5. Revisar el entorno activo

arcli config revisar

6. Previsualizar el primer comprobante

arcli fc -m 15000 --cs --consumidor-final --ir-cf

7. Emitir de verdad

arcli fc -m 15000 --cs --consumidor-final --ir-cf --emitir

Cómo funciona

ARCLI toma datos por flags, JSON o config, valida lo que puede localmente, arma el payload y — si corresponde — llama a ARCA. La prioridad es flags > JSON > config > defaults.

Ver docs/mental-model.md para el modelo completo.

Seguridad: testing vs producción

• Si no pasás nada, el entorno es testing.
• testing usa cert.testing y key.testing.
• produccion usa cert.produccion y key.produccion.
• Para emitir realmente en producción hacen falta:
  • --produccion
  • --emitir

Ejemplo:

arcli fa -m 15000 --cs --cuit 20168598204 --ir-ri \
  --produccion \
  --emitir

Documentación

• Modelo mental
• Glosario
• Referencia del CLI
• Patrones de uso
• Configuración
• Entrada y salida
• Reglas de validación
• Troubleshooting
• Limitaciones actuales
• Guía de desarrollo
• Testing
• Cómo contribuir
• llms.txt: referencia condensada para que un agente/IA con acceso a terminal ejecute el CLI directamente
• Seguridad

❤️ Agradecimientos

ARCLI existe apoyado en trabajo open source que ya resolvió partes difíciles del problema. En particular:

• @arcasdk/core creada por Rodrigo Alcorta
• Arpit Bhayani por cederme el paquete de npm bajo el nombre de 'arcli', estaba siendo utilizado por el.

Y la comunidad open source que mantiene herramientas de este estilo vivas y usables

☕ Apoyar el proyecto

ARCLI es open source. Mantenerlo, probarlo contra servicios reales y documentarlo bien lleva tiempo.

• Si queres darme un mimo: Cafesito
• Reporta issues claros, repros buenos y feedback real de uso
• Dejame tu estrellita ★ :)

Licencia

MIT © LcsGrz. Ver LICENSE.

Proyecto

• repo: github.com/LcsGrz/arcli
• issues: github.com/LcsGrz/arcli/issues