gigstack CLI: cómo los agentes de IA pueden automatizar tu operación fiscal

Hoy lanzamos el gigstack CLI, una herramienta de línea de comandos que pone toda la potencia de la API de gigstack directamente en tu terminal — y en manos de tus agentes de IA.

Instálalo en segundos:

npm install -g gigstack

¿Por qué un CLI?

La facturación electrónica en México tiene muchas partes móviles: CFDI, RFC, complementos de pago, conciliación, cobranza PPD. Hoy, la mayoría de esas operaciones se hacen manualmente desde la app web — lo cual funciona bien para humanos, pero no escala para procesos automatizados.

Con el CLI, esas mismas operaciones se vuelven comandos de una sola línea que cualquier script, pipeline o agente puede ejecutar sin intervención humana.

Para desarrolladores

Si integras gigstack en tu stack, el CLI te da acceso inmediato a todos los recursos de la API v2 sin tener que escribir código de integración:

npm install -g gigstack
gigstack login -k tu_api_key
gigstack status

Todos los comandos soportan --json para output estructurado, lo que facilita encadenar operaciones con jq o procesarlas con cualquier lenguaje.

Para agentes de IA

Aquí es donde el CLI se vuelve especialmente poderoso. Los agentes de IA necesitan dos cosas para operar en un dominio: contexto y acciones. El gigstack CLI provee ambas.

Contexto: el comando gigstack context

Antes de que un agente pueda tomar decisiones inteligentes sobre facturación mexicana, necesita entender el dominio. El comando context sirve exactamente para eso:

gigstack context --all --json

Esto le da al agente conocimiento sobre el ciclo de vida de pagos, tipos de CFDI (I/E/P/T), diferencia entre PUE y PPD, motivos de cancelación del SAT, y mucho más — sin necesidad de entrenamiento especializado.

Acciones: operaciones de una sola línea

Una vez que el agente tiene contexto, puede ejecutar operaciones reales:

gigstack status --json
gigstack forecast --json
gigstack clients search "ACME" --json
gigstack invoices create --client client_abc123 --payment-form 03 --payment-method PUE --json
gigstack explain inv_abc123 --json

Pago + factura en un solo paso

El comando pay permite a un agente registrar un cobro y emitir la factura de forma automática:

gigstack pay \
  --email cliente@empresa.com \
  --description "Servicio mensual" \
  --amount 15000 \
  --iva \
  --payment-form 03 \
  --json

También acepta stdin para pipelines:

echo '{"email":"cliente@co.com","description":"Consultoría","amount":5000}' | gigstack pay --stdin --json

Forecast: visibilidad hacia adelante

Uno de los comandos más útiles para agentes de planificación es forecast:

gigstack forecast --months 6 --json

Devuelve proyección de ingresos, riesgo de cobranza PPD con probabilidades de recuperación, estimado de factura global de fin de mes, y proyección de flujo de caja. Un agente financiero puede usar esto para tomar decisiones proactivas antes de que los problemas ocurran.

Flujo completo de un agente

Un workflow típico donde un agente maneja una solicitud de facturación de principio a fin:

# 1. Cargar conocimiento del dominio
gigstack context --all --json

# 2. Estado financiero actual
gigstack status --json

# 3. Buscar cliente
gigstack clients search "Empresa XYZ" --json

# 4. Crear factura
gigstack invoices create --client client_xyz --payment-form 03 --json

# 5. Enviar por email
gigstack invoices send uuid_de_factura --json

Todo esto sin que un humano tenga que abrir la app.

Empieza hoy

npm install -g gigstack
gigstack login
gigstack status

El CLI es open source bajo licencia MIT. Código en GitHub: github.com/disruptive-learning/gigstack-cli

Para obtener tu API key: app.gigstack.pro → Configuración → API