Configuración Multi-ambiente CLI: Guía Completa 2026

Aprende a manejar ambientes de sandbox y producción desde el CLI. prueba en sandbox, despliega en producción con el mismo comando. Tutorial paso a paso con ejemplos de código.

· Mariana Barreto

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 manejar ambientes de sandbox y producción desde el CLI. prueba en sandbox, despliega en producción con el mismo comando.

Instalación del CLI

  1. Instala Node.js 18+ si no lo tienes
  2. Ejecuta: npm install -g @gigstack/cli
  3. Verifica la instalación: gigstack –version
  4. Autentica tu cuenta: gigstack auth login
  5. 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 manejar ambientes de sandbox y producción desde el CLI, 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

Automatiza tu cumplimiento fiscal hoy. Conecta gigstack y emite tu primer CFDI 4.0 en 5 minutos. Empieza tu prueba gratuita ahora.