Centro de Documentación
Guía completa de FAQTURIA — facturación electrónica CFDI 4.0 para México. Desde la configuración inicial hasta la integración avanzada vía API.
Introducción
Qué es FAQTURIA y sus capacidades centrales
FAQTURIA es una plataforma SaaS de facturación electrónica diseñada para cumplir con el estándar CFDI 4.0 del SAT. Permite gestionar el ciclo completo de documentos fiscales: emisión, timbrado, descarga, cancelación y reportes avanzados — todo desde una sola interfaz.
Tipos de CFDI soportados
- I · IngresoIngreso — facturas de venta
- E · EgresoEgreso — notas de crédito
- P · PagoPago — complementos REP
- N · NóminaNómina — recibos de sueldo
- T · TrasladoTraslado — carta porte
Flujo de vida de un CFDI
- 1.Capturar la factura (o dejarla en borrador)
- 2.Validar datos fiscales y adendas
- 3.Timbrar ante el PAC (con respaldo)
- 4.Generar el PDF con tu diseño y enviarlo por correo
- 5.Cancelar (si aplica) ante el SAT
CFDI 4.0 es obligatorio desde el 1 de enero de 2023. Todos los documentos deben incluir el RFC y nombre del receptor validados contra la Constancia de Situación Fiscal del SAT.
Multi-PAC
Facturapi y FiscalAPI con respaldo automático
Multiempresa
Varias razones sociales en un acceso
API REST v1
Los 5 tipos de CFDI por API
Webhooks y MCP
Eventos firmados y herramientas para IA
Configuración Inicial
Prepara tu cuenta antes de emitir tu primer documento
Certificados de Sello Digital (CSD)
El CSD es indispensable para timbrar. No confundas la e.firma con el CSD — son archivos distintos.
Obtén tu CSD del SAT
.cer y .key desde el portal del SAT con tu e.firma. El CSD es específico para cada RFC emisor.Sube los certificados en la plataforma
Verifica el estado
Los CSD tienen una vigencia de hasta 4 años: revisa la fecha que muestra Ajustes › Certificados y renuévalo en el SAT antes de que venza. Para el modo pruebas se sube un CSD de pruebas aparte, que nunca se mezcla con el real.
Datos Fiscales de la Empresa
Los datos deben coincidir exactamente con la Constancia de Situación Fiscal.
| Campo | Descripción | Ejemplo |
|---|---|---|
| RFC | Registro Federal de Contribuyentes (13 dígitos personas físicas, 12 morales) | XAXX010101000 |
| Razón Social | Sin régimen de capital (sin S.A. de C.V., etc.) | ACME SERVICES |
| Régimen Fiscal | Clave SAT del régimen del emisor | 601 — General de Ley |
| Código Postal | CP del domicilio fiscal registrado ante el SAT | 06600 |
Usuarios y Permisos
El acceso es con tu cuenta de Kontrolia: Faqturia nunca ve tu contraseña. Invita a tu equipo desde Ajustes › Usuarios y asígnale un rol; cada rol es un conjunto de permisos por módulo.
Facturas
Ver, crear, timbrar, cancelar y eliminar borradores: cada acción es un permiso aparte.
Catálogos
Clientes, productos, proveedores, empleados, series y cargas masivas.
Configuración
Empresa, certificados, PAC y modo pruebas, API keys, webhooks y reportes.
Catálogos
Clientes, productos y proveedores
Clientes (Receptores CFDI)
Cada cliente debe tener datos fiscales válidos. Estos se verifican al momento de timbrar.
| Campo | Tipo | Req. | Descripción |
|---|---|---|---|
| rfc | string | Requerido | RFC del receptor. XAXX010101000 para público general. |
| nombre | string | Requerido | Razón social sin régimen de capital, exacta según el SAT. |
| regimen_fiscal | clave | Requerido | Clave SAT del régimen (ej. 612 = Personas Físicas con Actividad Empresarial). |
| codigo_postal | string | Requerido | CP del domicilio fiscal del receptor. |
email | Opcional | Correo para envío automático de PDF/XML al timbrar. |
Para Ventas al Público General (ticket de caja), usa RFC genérico XAXX010101000, régimen 616 y Uso CFDI S01.
Productos y Servicios
Los productos almacenan la clave SAT y los impuestos predeterminados para agilizar la facturación.
Clave Prod/Serv: Código SAT de 8 dígitos que clasifica el bien o servicio. Búscalo en el catálogo oficial del SAT (ej. 80141600 = Consultoría de TI).
Unidad: Clave de unidad de medida SAT (ej. E48 = Unidad de servicio, H87 = Pieza, KGM = Kilogramo).
Impuestos configurables por producto
Facturación CFDI 4.0
Ingreso, Egreso y flujo completo de timbrado
CFDI de Ingreso (I)
Venta de bienes o servicios
Es el tipo más común. Se emite cuando realizas una venta o prestas un servicio. Puede tener método de pago PUE (pago en una sola exhibición) o PPD (pago en parcialidades o diferido).
CFDI de Egreso (E)
Notas de crédito y devoluciones
Rectifica monetariamente una factura de ingreso. Se relaciona con el UUID de la factura original. Úsalo para descuentos retroactivos, devoluciones y bonificaciones.
Campos obligatorios CFDI 4.0
| Campo | Tipo | Req. | Descripción |
|---|---|---|---|
| uso_cfdi | clave | Requerido | Uso que el receptor dará al CFDI (G03=Gastos generales, P01=Pagos, S01=Sin efectos fiscales). |
| forma_pago | clave | Requerido | Forma en que se realiza el pago: 01=Efectivo, 03=Transferencia, 04=Tarjeta crédito, 99=Definir. |
| metodo_pago | clave | Requerido | PUE = pago único al emitir. PPD = parcialidades o diferido (requiere Complemento de Pago). |
| moneda | clave | Opcional | ISO 4217. MXN por defecto. USD, EUR disponibles. |
| tipo_cambio | decimal | Opcional | Obligatorio si moneda ≠ MXN. |
| conceptos | array | Requerido | Lista de ítems con clave SAT, unidad, descripción, precio y objImp (01/02/03). |
Proceso de Timbrado
Crear borrador
Validar y timbrar
Emisión exitosa
Envío por correo
Factura global: las ventas al público en general que no pidieron factura se acumulan en un CFDI de ingreso a XAXX010101000 con el nodo InformacionGlobal (periodicidad, mes y año). Faqturia lo envía al PAC cuando capturas esos datos.
Complementos de Pago (REP)
Para facturas emitidas con método de pago PPD
Cuando emites una factura con Método de Pago PPD (Pago en Parcialidades o Diferido), estás obligado a emitir un Recibo Electrónico de Pago (REP), también llamado Complemento de Pago, cada vez que el cliente liquide total o parcialmente.
PUE vs PPD: Usa PUE cuando el cliente pagará el mismo día de emisión. Usa PPD para créditos, pagos diferidos o cuando el pago se realizará en fecha futura.
El REP debe emitirse a más tardar el día 5 del mes siguiente al mes en que se recibió el pago. En Faqturia lo emites desde Facturación › Recibos de Pago (REP) eligiendo las facturas PPD pagadas: el saldo anterior y el insoluto se calculan solos, y cada cobro queda en Pagos recibidos.
Datos del Complemento de Pago
| Campo | Tipo | Req. | Descripción |
|---|---|---|---|
| fecha_pago | datetime | Requerido | Fecha y hora en que se recibió el pago. |
| forma_pago_p | clave | Requerido | Forma del pago: 03 Transferencia, 04 Tarjeta, 01 Efectivo (no puede ser 99). |
| monto | decimal | Requerido | Importe pagado. Puede ser pago parcial o total. |
| num_operacion | string | Opcional | Número de referencia bancaria o folio de operación. |
| rfc_emisor_cta_ord | string | Opcional | RFC del banco del ordenante. |
| factura_origen | uuid | Requerido | UUID de la(s) factura(s) relacionadas a las que aplica este pago. |
Nómina (CFDI-N)
Recibos de pago para empleados
El CFDI de Nómina (Tipo N) incluye el Complemento de Nómina 1.2 del SAT. Es obligatorio para todos los patrones que pagan sueldos y salarios.
Empleados
Percepciones
Deducciones
Datos del Empleado
| Campo | Tipo | Req. | Descripción |
|---|---|---|---|
| curp | string | Requerido | Clave Única de Registro de Población. |
| num_seguridad_social | string | Requerido | Número IMSS del trabajador. |
| tipo_contrato | clave | Requerido | Catálogo SAT: 01=Indefinido, 02=Relación de trabajo por obra, etc. |
| tipo_jornada | clave | Requerido | 01=Diurna, 02=Nocturna, 03=Mixta, 08=Por horas. |
| salario_base | decimal | Requerido | Salario Diario Integrado (SDI). |
| riesgo_puesto | clave | Requerido | Clase de riesgo IMSS: 1-5. |
El número de período (quincena, semana, mes) y las fechas de inicio/fin del período son obligatorias y deben corresponderse con el patrón de pago registrado en el IMSS.
Traslados
Carta Porte para transporte de mercancías
El CFDI de Traslado (Tipo T) se emite cuando transportas bienes propios. Si contratas a un tercero para el transporte, ese tercero emite el CFDI. El Complemento de Carta Porte es requerido desde el 2022 para transporte nacional.
Vía Terrestre: Se requiere la información del autotransporte: número de permiso SCT, tipo de carrocería y número de placas.
Los bienes transportados deben incluir la clave SAT de producto, unidad, peso y fracción arancelaria si aplica para el bien.
Cancelaciones
Proceso oficial de cancelación de CFDI ante el SAT
Desde CFDI 4.0, la cancelación requiere un motivo y puede requerir la aceptación del receptor dependiendo del monto.
| Motivo | Descripción | ¿Requiere sustitución? |
|---|---|---|
01 | Comprobante emitido con errores con relación | Sí — indica el UUID de la nueva factura |
02 | Comprobante emitido con errores sin relación | No |
03 | No se llevó a cabo la operación | No |
04 | Operación nominativa relacionada en una factura global | No |
Flujo de cancelación
Solicitar cancelación
Envío al SAT
Aceptación del receptor (si aplica)
Cancelación efectiva
Las facturas no pueden cancelarse si tienen complementos de pago relacionados no cancelados. Cancela primero los REP y luego la factura original.
PDF y Adendas
Tu representación impresa y lo que exigen tus clientes
PDF con tu diseño
Ajustes › Plantillas PDF
Tras cada timbrado Faqturia genera el PDF desde el XML con la plantilla de tu empresa. Elige uno de los 5 diseños de fábrica por tipo de comprobante, pon tu logo y colores, o edítalo con vista previa real. Puedes asignar plantillas por cliente o por serie, regenerar PDFs y obtener el PDF desde cualquier XML. El PDF del PAC se conserva siempre.
Adendas comerciales
Ficha del cliente › Adendas
Algunos receptores exigen una cfdi:Addenda (orden de compra, remisión…). Configúrala en la ficha del cliente con sus datos fijos; los datos por factura se capturan al timbrar. Si la adenda es obligatoria y falta un dato, no se timbra. Se aplica también a notas de crédito y REP.
Un fallo al generar el PDF o al inyectar la adenda nunca invalida el timbrado: el CFDI queda válido ante el SAT, el estado se marca en el listado y puedes reintentarlo desde el detalle.
Modo pruebas
Ensaya todo el flujo sin emitir CFDI con validez fiscal
Cada empresa puede cambiar su ambiente de timbrado entre producción y pruebas con el interruptor de la cabecera (requiere el permiso de configurar el PAC). Mientras está en pruebas, una franja visible avisa a todo el equipo.
CSD de pruebas
Series TEST
Sin efectos
Cada ambiente usa exclusivamente sus propias credenciales de PAC. Si falta la del ambiente activo, el timbrado se detiene con un mensaje claro en lugar de usar la del otro.
Bóveda fiscal y SAT
Todo lo que te facturan, con su estado ante el SAT
Configura la e.firma
Activa la sincronización
O pide un periodo a mano
El SAT solo permite pedir el mismo rango un par de veces. Por eso la sincronización automática consulta primero los metadatos y pide XML solo de lo que falta.
Todo en un solo lugar
CFDI recibidos › Bóveda fiscal
Estado ante el SAT
Listas SAT
Un mismo UUID no se registra dos veces. Tesorería (órdenes de compra y de pago, y captura de facturas desde un buzón de correo), cartera y contabilidad son módulos opcionales por instalación. Los portales públicos (autofacturación, facturas de proveedores y comprobantes de pago) están disponibles en instalaciones propias.
Conciliación fiscal
Cada factura contra sus complementos y notas de crédito
En Conciliación fiscal, las pestañas Por cobrar (lo que emites) y Por pagar (lo que te facturan) cruzan cada factura con sus complementos de pago (REP) y notas de crédito vigentes. Faqturia calcula el saldo y le asigna una situación:
| Cancelada | La factura está cancelada ante el SAT. |
| No requiere REP | Se pagó en una sola exhibición (PUE). |
| Sobrepagada | Lo pagado y acreditado supera el total. |
| Liquidada | Los complementos y notas de crédito cubren el total, incluso si se saldó solo con nota de crédito. |
| Sin REP | Es PPD y no tiene ningún complemento de pago que cuente. |
| Parcial | Tiene complementos, pero todavía queda saldo. |
Observaciones
Alertas en la campana
Excel para tu contador
El estado de cada comprobante sale de la fuente más confiable disponible: la consulta al SAT, lo timbrado en Faqturia o los metadatos de la descarga masiva. Las alertas y los días sin complemento se ajustan en Configuración › Ajustes.
Monitor Fiscal
Tus proveedores y clientes contra las listas del SAT
Faqturia mantiene una copia local, versionada y con historial de las listas públicas del SAT: 69-B (presunción de operaciones inexistentes), artículo 69 (no localizados, créditos firmes y exigibles, sentencias, cancelados) y CSD sin efectos, y cruza contra ellas a tus contrapartes.
Dónde se valida
Tablero
CFDI recibidos › Monitor Fiscal
Alertas
La validación es local: nunca consulta al SAT en el momento ni bloquea tu operación. Solo te avisa; la decisión es tuya.
Reportes y Exportaciones
Analiza y descarga tu información fiscal
Dashboard
Reportes ejecutivos
Impuestos
Formatos de exportación
Plan y timbres
Qué se cuenta y qué pasa al llegar al límite
| Plan | Precio | Timbres / mes | Recibidos / mes |
|---|---|---|---|
| Emprendedor | $249 MXN / mes | 30 · +$3.50 c/u | 30 · +$0.50 c/u |
| Negocio | $599 MXN / mes | 150 · +$3.00 c/u | 150 · +$0.50 c/u |
| Max | $1,290 MXN / mes | 500 · +$2.80 c/u | 500 · +$0.50 c/u |
Cuenta como timbre cada CFDI timbrado en producción: factura, nota de crédito, complemento de pago, nómina o traslado. Cuenta como recibido cada CFDI que la descarga del SAT importa a tu bóveda. El modo pruebas no cuenta.
Al agotar el cupo, el timbrado responde con un aviso para mejorar el plan (en la API, 402 PLAN_LIMIT_EXCEEDED). Tu consumo está en el dashboard y el plan se administra en Configuración › Plan y facturación, con pago por Stripe.
Integraciones
API Keys y Webhooks para automatizar tus procesos
API Keys
Genera claves desde Integraciones › API Desarrolladores. Cada llave pertenece a una empresa, tiene scopes, límite por minuto y, opcionalmente, expiración y orígenes permitidos.
Scopes disponibles
readTodas las lecturaswriteTodas las escriturasinvoices:read / :writeFacturas de ingresocredit-notes:read / :writeNotas de créditopayment-complements:read / :writeComplementos de pagopayroll:read / :writeRecibos de nóminatransfers:read / :writeTrasladosclients:read / :writeClientesproducts:read / :writeProductosreports:readReportesfiscal:readBóveda, conciliación, alertas y Monitor Fiscalwebhooks:read / :writeSuscripciones de webhooksGuarda tu API key (ktrl_live_…) al momento de crearla — no volverá a mostrarse. Si la pierdes, revoca la actual y genera una nueva.
Webhooks
Recibe notificaciones HTTP POST en tiempo real cuando ocurran eventos en la plataforma.
Eventos disponibles
Ejemplo de payload webhook
{
"id": "uuid-del-evento",
"event": "invoice.stamped",
"api_version": "2026-09-18",
"created_at": "2026-09-24T17:30:00.000Z",
"organization_id": "uuid-empresa",
"data": {
"id": "uuid-factura",
"tipo_comprobante": "I",
"serie": "A",
"folio": "1043",
"uuid": "UUID-DEL-SAT",
"status": "timbrada",
"total": 11600
}
}Cada entrega lleva X-Webhook-Signature: t=<unix>,v1=<firma>: un HMAC-SHA256 de <t>.<cuerpo> con tu secret. Rechaza marcas de tiempo de más de 5 minutos y deduplica por id: si no respondes 2xx se reintenta 7 veces, hasta 24 h después. Código de verificación.
IA y MCP
Tu asistente de IA, con tus datos fiscales
Claude.ai y ChatGPT
Integraciones › MCP (IA)
Agrega Faqturia como conector en Claude.ai o ChatGPT con el Client ID que te muestra la app e inicia sesión con tu cuenta de Kontrolia: sin API keys. El acceso es de solo lectura y con los permisos de tu usuario: facturas, catálogos, reportes, bóveda fiscal, conciliación, alertas y Monitor Fiscal. Nada se timbra ni se cancela desde un chat.
Servidor MCP con API key
Claude Desktop, n8n o tu propio agente
Conecta /api/mcp con una API key: 45 herramientas (33 de lectura, 12 de escritura) que hacen lo mismo que la API, con los mismos scopes; las fiscales piden fiscal:read. Configuración.
Referencia de API REST
Documentación completa para desarrolladores
La API REST v1 de FAQTURIA te permite integrar la facturación electrónica directamente en tus sistemas: los 5 tipos de CFDI, cancelación, clientes, productos, catálogos SAT, reportes y webhooks. La misma superficie está disponible para asistentes de IA con el servidor MCP.
Documentación API
completa
Inicio rápido, autenticación y scopes, idempotencia, errores, webhooks, MCP, ejemplos en Node.js, Python y PHP, y la referencia completa generada de la especificación OpenAPI.
GET /invoicesPOST /invoicesPOST /payment-complementsGET /catalogs/uso-cfdiGET /reports/taxesAutenticación
X-API-Key o Bearer, scopes por recurso, límite por minuto.
Facturas
Crear y timbrar, listar, detalle, cancelar y URLs firmadas de XML/PDF.
Clientes & Productos
Alta, consulta, edición parcial y baja de receptores y productos.
Webhooks
17 eventos firmados, reintentos, historial de entregas y prueba.
Servidor MCP
Las mismas operaciones como herramientas para asistentes de IA.
Errores & Códigos
Formato único de error y códigos estables para ramificar.
Ejemplo: Crear factura via API
curl -X POST "https://app.faqturia.com/api/v1/invoices" \
-H "X-API-Key: ktrl_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-10482" \
-d '{
"client_id": "uuid-del-cliente",
"uso_cfdi": "G03",
"metodo_pago": "PUE",
"forma_pago": "03",
"conceptos": [{
"clave_prod_serv": "80141600",
"clave_unidad": "E48",
"descripcion": "Servicio de consultoría",
"cantidad": 1,
"precio_unitario": 10000,
"impuestos": true
}]
}'