API gigstack: Integra Facturación CFDI en tu Sistema
Documentación de la API de gigstack para desarrolladores. Integra facturación CFDI en cualquier sistema.
La API de gigstack te permite integrar facturación CFDI 4.0 en cualquier sistema, aplicación o plataforma. Ya sea que tengas un sistema propio, CRM personalizado, o app móvil, puedes agregar facturación con unas pocas llamadas a la API.
¿Por Qué Usar la API?
- Integración a la medida de tu sistema
- Control total del flujo de facturación
- Automatización personalizada
- Sin depender de integraciones predefinidas
Autenticación
La API usa autenticación Bearer Token:
- Obtén tu API Key en app.gigstack.pro/settings/api
- Incluye en cada request: Authorization: Bearer {API_KEY}
Endpoints Principales
Crear Factura
POST /v1/invoices
Genera un CFDI con los datos proporcionados. Respuesta incluye UUID, XML y PDF.
Crear Nota de Crédito
POST /v1/credit-notes
Genera nota de crédito relacionada a factura existente.
Complemento de Pago
POST /v1/payment-complements
Genera REP para facturas PPD.
Cancelar Factura
POST /v1/invoices/{uuid}/cancel
Solicita cancelación ante el SAT.
Consultar Factura
GET /v1/invoices/{uuid}
Obtiene datos, XML y PDF de una factura.
Estructura de Request
Ejemplo para crear factura:
- receptor: RFC, razón social, régimen, uso CFDI
- conceptos: clave SAT, descripción, cantidad, precio, impuestos
- formaPago: código SAT
- metodoPago: PUE o PPD
Validaciones
La API valida antes de timbrar:
- RFC del receptor con lista del SAT
- Estructura del CFDI
- Claves de catálogos SAT
- Cálculos de impuestos
Si hay error, respuesta incluye detalle para corregir.
Webhooks
Configura webhooks para recibir notificaciones:
- Factura timbrada
- Factura cancelada
- Cancelación aceptada/rechazada
SDKs Disponibles
gigstack ofrece SDKs para:
- Node.js / JavaScript
- Python
- PHP
- Ruby
O usa la API REST directamente con cualquier lenguaje.
Ambiente de Pruebas
Desarrolla en sandbox antes de producción:
- URL: api.sandbox.gigstack.pro
- Mismos endpoints
- CFDIs de prueba (no válidos ante SAT)
- Sin costo de timbres
Límites y Rate Limiting
- 1000 requests por minuto
- Sin límite de facturas según tu plan
- Respuestas incluyen headers de rate limit
Casos de Uso
Sistema ERP Propio
Tu ERP genera factura comercial, llama a la API y obtiene el CFDI.
App Móvil
Tu app de ventas factura en tiempo real desde el celular.
Sistema Legacy
Sistema viejo que no se puede reemplazar. Agregas facturación sin tocar el core.
Soporte para Desarrolladores
- Documentación completa en docs.gigstack.pro
- Colección de Postman
- Ejemplos de código
- Soporte técnico dedicado
Preguntas Frecuentes
¿La API tiene costo adicional?
No. Incluida en todos los planes. Pagas por timbres.
¿Puedo usar desde frontend?
Usa backend para proteger tu API Key. El frontend llama a tu backend.
Integra Hoy
Si necesitas facturación mexicana en tu sistema, la API de gigstack te da todo lo necesario. Empieza en docs.gigstack.pro.