API de facturación

API de facturación CFDI 4.0:tu primera factura de prueba en minutos

Abre una cuenta de prueba con una llamada, timbra con el CSD de prueba del SAT que ya trae y descarga el PDF. Modo de prueba gratis, sin tarjeta. API, webhooks y MCP incluidos.

Modo de prueba gratis, sin tarjeta. Desde $199 MXN + IVA al mes por RFC, más uso.

Pruébalo en tu terminal

Tres comandosde cero a un PDF timbrado en prueba

Copia y pega en tu terminal; necesitas curl y jq. Es una factura de prueba, sin validez fiscal.

  1. 1.Abre una cuenta de prueba

    Una llamada, sin formulario. Te llega un código por correo para reclamarla después. La llave sk_test_ sólo viene en esta respuesta.

    export GIGSTACK_API_KEY=$(curl -s -X POST https://api.gigstack.io/v2/auth/sandbox \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{"email":"tu@empresa.com","name":"Tu nombre"}' \
      | jq -r '.data.api_key.test')
  2. 2.Emite una factura de prueba

    La cuenta ya trae el CSD de prueba del SAT. Factura de ingreso a público en general, timbrada en modo de prueba, sin validez fiscal.

    UUID=$(curl -s -X POST https://api.gigstack.io/v2/invoices/income \
      -H "Authorization: Bearer $GIGSTACK_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"client":{"name":"PUBLICO EN GENERAL","legal_name":"PUBLICO EN GENERAL","tax_id":"XAXX010101000","tax_system":"616","address":{"country":"MEX","zip":"42501"}},"use":"S01","payment_method":"PUE","payment_form":"01","currency":"MXN","global":{"periodicity":"04","months":"'$(date +%m)'","year":'$(date +%Y)'},"items":[{"description":"Servicio de ejemplo","product_key":"01010101","unit_key":"E48","quantity":1,"unit_price":100,"taxes":[{"type":"IVA","rate":0.16,"factor":"Tasa","inclusive":false,"withholding":false}]}],"automation_type":"none","send_email":false}' \
      | jq -r '.data.uuid')
  3. 3.Descarga el PDF

    El PDF y el XML llegan en base64. Este comando guarda el PDF en tu carpeta.

    curl -s "https://api.gigstack.io/v2/invoices/$UUID/files?file_type=pdf" \
      -H "Authorization: Bearer $GIGSTACK_API_KEY" \
      | jq -r '.data[0].content' | base64 --decode > factura-prueba.pdf
Qué incluye

Lo que necesitas para facturardesde tu backend

Todos los CFDI 4.0

Facturas de ingreso PUE y PPD, notas de crédito, complementos de pago y traslados, con cancelación ante el SAT y borradores. POST /v2/invoices/income, /egress, /payment y /transfer.

Webhooks

Avisos en tiempo real de pagos y facturas: payment.succeeded, invoice.created, invoice.canceled, invoice.failed, receipt.created y más, con reintentos y reenvío.

Catálogos del SAT

Claves de producto y servicio y claves de unidad para buscar y validar antes de timbrar: /v2/catalogs/product-keys y /v2/catalogs/unit-keys.

Modo de prueba y producción

Una llave sk_test_ timbra con el CSD de prueba del SAT, gratis. Con tu CSD y producción activa, la misma llamada emite CFDI con validez fiscal.

Reintentos seguros

Encabezado Idempotency-Key: si repites una llamada por un error de red, no se timbra dos veces.

PDF y XML

Cada factura devuelve su PDF y su XML, y se puede enviar por correo a tu cliente desde la API.

MCP y CLI

Tu agente de IA también facturapor MCP o desde la terminal

Servidor MCP

Conecta ChatGPT, Claude o Cursor a tu cuenta. Emite, cancela y consulta, no sólo lee. Autorización OAuth.

https://mcp.gigstack.io/v2/mcp
Cómo conectarlo

CLI

El paquete gigstack en npm. Cada comando acepta --json para scripts, CI y agentes.

npm install -g gigstack
gigstack login
gigstack invoices list --json
Ver en npm

Documentación completa en docs.gigstack.io. Para agentes: agents.md.

Precio

Desde $199 MXN + IVA al mes por RFC, más usoAPI y MCP incluidos

Sin planes ni paquetes de timbres. Las cifras son las mismas de la página de precios.

Lo que pagas

  • $199 MXN al mes por el primer RFC (cada RFC adicional paga menos, desde $99).
  • Cada CFDI timbrado paga según la escala del mes, desde $2.10 los primeros 50 y bajando hasta $0.40 por documento.
  • Las facturas de ingreso y los complementos de pago que se emiten en automático pagan el 50% del escalón.
  • API, webhooks y MCP: incluidos, sin costo adicional.
  • 11 créditos de bienvenida ($11 MXN de uso) al activar producción.
  • El modo de prueba es gratis y no pide tarjeta. Precios en MXN antes de IVA.
Calcula tu mes en /precios

Precio por CFDI timbrado, por RFC y por mes

Documentos del mesManualAutomático
1 a 50$2.10$1.05
51 a 200$1.80$0.90
201 a 1,000$1.30$0.65
1,001 a 5,000$0.55$0.28
5,001 en adelante$0.40$0.20

MXN antes de IVA. Escala graduada: cada escalón cobra sólo los documentos que caen en él. Automático es el precio de una factura de ingreso o un complemento de pago emitido por una integración o una automatización.

Con tu agente de IA

O pídeselo a tu agentey él abre la cuenta

Copia el texto en Claude Code, Cursor o Codex: abre la cuenta de prueba, emite la factura y te enseña el PDF.

Pega esto en tu agente
Crea mi cuenta de gigstack, emite una factura de prueba y dime cuánto pagaría al mes.

Lee https://gigstack.pro/agents.md y sigue sus pasos:
1. Pregúntame mi correo y cuántas facturas emito al mes.
2. Crea mi cuenta de prueba con POST https://api.gigstack.io/v2/auth/sandbox y guarda la llave de prueba en un archivo .env local, nunca en el chat.
3. Emite una factura de prueba (PÚBLICO EN GENERAL, servicio de ejemplo) con esa llave y muéstrame el PDF.
4. Pídeme el código que me llegue por correo y reclama la cuenta.
5. Explícame qué falta para facturar de verdad: mi RFC, mi CSD, el manifiesto y una tarjeta en app.gigstack.pro.
6. Consulta los precios en https://api.gigstack.io/v2/pricing y calcula mi costo mensual antes y después de IVA, paso por paso. Usa sólo los precios que devuelve.

Funciona con agentes que pueden hacer llamadas a internet, como Claude Code, Cursor o Codex. Tu agente emite una factura de prueba y te enseña el PDF. La cuenta nace en modo prueba: no se cobra nada hasta que actives producción. Instrucciones para agentes

Preguntas frecuentes

La API de facturaciónlo que preguntan los equipos

Cuánto cuesta la API de facturación de gigstack

La API, los webhooks y el MCP están incluidos, sin costo adicional. Pagas desde $199 MXN + IVA al mes por RFC, más uso: cada CFDI según tu volumen del mes, desde $2.10 MXN + IVA y bajando. El modo de prueba es gratis y al activar producción recibes 11 créditos de bienvenida ($11 MXN de uso, válidos 30 días). La cuota y el uso se cobran al cierre del mes.

Puedo probar la API sin tarjeta

Sí. POST /v2/auth/sandbox abre una cuenta de prueba con una llave sk_test_ y el CSD de prueba del SAT ya cargado. Emites facturas de prueba sin tarjeta y sin costo; no tienen validez fiscal. Para reclamar la cuenta usas el código que te llega por correo.

Qué necesito para timbrar facturas reales

Tus datos fiscales, tu Certificado de Sello Digital (CSD: el .cer, el .key y su contraseña), firmar el manifiesto del SAT y una tarjeta. Todo se captura en app.gigstack.pro, casi siempre desde una computadora. Agregar la tarjeta no genera cargo.

La API emite complementos de pago y factura global

Sí. Los complementos de pago se emiten por API (POST /v2/invoices/payment) o solos cuando una integración registra el pago de una factura PPD. La factura global a público en general se emite por API con el periodo, o en automático al cierre con la función de factura global.

Tiene SDK, CLI o MCP

Hay CLI oficial en npm (npm install -g gigstack) con salida --json para scripts y agentes, y servidor MCP oficial (https://mcp.gigstack.io/v2/mcp) que puede emitir, cancelar y consultar desde ChatGPT, Claude o Cursor. La API es REST con especificación OpenAPI, así que funciona desde cualquier lenguaje.

Puedo facturar por varios RFC con la misma integración

Sí. Cada RFC es un equipo con su propia cuota mensual, más baja a partir del segundo. Con Connect operas varios equipos desde una cuenta maestra usando el parámetro team.

Si comparas opciones: alternativa a Facturapi. Si cobras con Stripe: factura cada cobro sin código.

Timbra tu primera facturade prueba hoy

Crea tu cuenta de prueba desde aquí o con el primer comando. Activas producción cuando subas tu CSD.

Crear cuenta de prueba

Desde $199 MXN + IVA al mes por RFC, más uso. 11 créditos de bienvenida ($11 MXN de uso, válidos 30 días) al activar producción. Modo de prueba gratis.

Crear cuenta de prueba