El CLI de gigstack es la forma más rápida de interactuar con la plataforma para usuarios técnicos. En lugar de clicks en un dashboard, ejecutas comandos. En lugar de formularios, pasas parámetros. Esta guía cubre cómo crear scripts que automatizan tareas de facturación y cobranza. integra gigstack en tus pipelines y cron jobs existentes.
Instalación del CLI
- Instala Node.js 18+ si no lo tienes
- Ejecuta: npm install -g @gigstack/cli
- Verifica la instalación: gigstack --version
- Autentica tu cuenta: gigstack auth login
- Selecciona tu ambiente: gigstack config set environment production
Comandos esenciales
- gigstack invoice create - Crear una factura CFDI 4.0
- gigstack invoice list - Listar facturas emitidas
- gigstack invoice cancel - Cancelar una factura
- gigstack customer create - Crear un cliente
- gigstack customer validate - Validar RFC ante el SAT
- gigstack report generate - Generar reporte mensual
- gigstack config - Ver y modificar configuración
Ejemplo práctico
Para crear scripts que automatizan tareas de facturación y cobranza, el flujo típico es:
gigstack invoice create --customer RFC123456789 --amount 5000 --concept "Servicios de consultoría" --payment-method "03"
Este comando emite una factura CFDI 4.0 timbrada ante el SAT en menos de 3 segundos. Recibe el UUID y la URL del PDF en la respuesta.
Integración con scripts
El CLI está diseñado para composición. Puedes encadenar comandos, parsear output JSON con jq, y construir flujos complejos. Ejemplo: listar facturas pendientes de pago y enviar recordatorios masivos con un solo script de 5 líneas.
Flags útiles
- --json - Output en formato JSON para parsing
- --quiet - Solo imprime el resultado, sin decoración
- --dry-run - Simula la operación sin ejecutarla
- --sandbox - Usa el ambiente de pruebas
- --verbose - Muestra detalles de la operación
Preguntas Frecuentes
¿El CLI funciona en Windows, Mac y Linux?
Sí. El CLI está escrito en Node.js y funciona en cualquier sistema operativo con Node 18+. La instalación es idéntica en todas las plataformas.
¿Puedo usar el CLI en servidores sin interfaz gráfica?
Sí, el CLI está diseñado específicamente para entornos headless. Puedes autenticarte con un token de API en lugar de login interactivo.
¿Hay límite de requests desde el CLI?
Los mismos límites de la API aplican: 50 requests/minuto en plan estándar, 200 en enterprise. El CLI maneja automáticamente el rate limiting.
Da el Siguiente Paso
Cada minuto que dedicas a facturar manualmente es un minuto menos para tu negocio. Activa gigstack hoy y recupera ese tiempo.
Blogs que te pueden gustar
