PlataformaDocumentación

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.

CFDI 4.0
Multi-PAC
API REST v1
Webhooks y MCP

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 · Ingreso
    Ingreso — facturas de venta
  • E · Egreso
    Egreso — notas de crédito
  • P · Pago
    Pago — complementos REP
  • N · Nómina
    Nómina — recibos de sueldo
  • T · Traslado
    Traslado — carta porte

Flujo de vida de un CFDI

  1. 1.Capturar la factura (o dejarla en borrador)
  2. 2.Validar datos fiscales y adendas
  3. 3.Timbrar ante el PAC (con respaldo)
  4. 4.Generar el PDF con tu diseño y enviarlo por correo
  5. 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.

1

Obtén tu CSD del SAT

Descarga los archivos .cer y .key desde el portal del SAT con tu e.firma. El CSD es específico para cada RFC emisor.
2

Sube los certificados en la plataforma

Ve a Ajustes › Certificados. Sube ambos archivos y escribe la contraseña del .key. El sistema valida la vigencia y el RFC. Una vez guardado, el CSD no vuelve a salir del servidor: ninguna pantalla ni API lo devuelve.
3

Verifica el estado

Un indicador verde confirma que el certificado es válido y la empresa puede timbrar.

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.

CampoDescripciónEjemplo
RFCRegistro Federal de Contribuyentes (13 dígitos personas físicas, 12 morales)XAXX010101000
Razón SocialSin régimen de capital (sin S.A. de C.V., etc.)ACME SERVICES
Régimen FiscalClave SAT del régimen del emisor601 — General de Ley
Código PostalCP del domicilio fiscal registrado ante el SAT06600

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.

CampoTipoReq.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
email
OpcionalCorreo 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

IVA Trasladado 16%
IVA Trasladado 8% (frontera)
IVA Exento
IEPS Trasladado
ISR Retenido
IVA Retenido 10.67%

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

CampoTipoReq.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
OpcionalISO 4217. MXN por defecto. USD, EUR disponibles.
tipo_cambio
decimal
OpcionalObligatorio si moneda ≠ MXN.
conceptos
array
Requerido
Lista de ítems con clave SAT, unidad, descripción, precio y objImp (01/02/03).

Proceso de Timbrado

1

Crear borrador

La factura se guarda con estado
borrador
. Se puede editar libremente.
2

Validar y timbrar

Al hacer clic en «Timbrar», se envía al PAC para certificación. El SAT devuelve el UUID (Folio Fiscal) y el sello digital.
3

Emisión exitosa

La factura pasa a estado
timbrada
. Se genera el XML y PDF listos para descarga.
4

Envío por correo

Al terminar de timbrar, el mismo diálogo te deja enviar el XML y el PDF hasta a 10 correos del receptor.

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

CampoTipoReq.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
OpcionalNúmero de referencia bancaria o folio de operación.
rfc_emisor_cta_ord
string
OpcionalRFC 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

Registra el CURP, Seguridad Social y tipo de jornada de cada trabajador.

Percepciones

Sueldo ordinario, horas extra, prima vacacional, aguinaldo, bonos.

Deducciones

ISR, IMSS cuota obrera, préstamos, descuentos varios.

Datos del Empleado

CampoTipoReq.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.

MotivoDescripción¿Requiere sustitución?
01
Comprobante emitido con errores con relaciónSí — indica el UUID de la nueva factura
02
Comprobante emitido con errores sin relaciónNo
03
No se llevó a cabo la operaciónNo
04
Operación nominativa relacionada en una factura globalNo

Flujo de cancelación

1

Solicitar cancelación

Desde el detalle de la factura, selecciona el motivo. Con el motivo 01 Faqturia pide el UUID del CFDI que la sustituye y no deja continuar sin uno válido.
2

Envío al SAT

La plataforma envía la solicitud de cancelación al SAT vía el PAC. El SAT responde con un acuse.
3

Aceptación del receptor (si aplica)

Los CFDI de hasta $1,000 MXN (entre otros supuestos del SAT) se cancelan sin aceptación. En los demás, el receptor tiene 3 días hábiles para aceptar o rechazar; si no responde, se entiende aceptada.
4

Cancelación efectiva

La factura pasa a estado
cancelada
y el XML refleja la cancelación.

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

Se firma con un CSD de pruebas que subes en Ajustes › Certificados. Nunca se usa tu CSD real.

Series TEST

Series propias (TEST-I, TEST-E…) que empiezan en el folio 1 y no consumen tus folios reales.

Sin efectos

PDF con marca "SIN VALIDEZ FISCAL", sin correo, fuera de reportes y de la API, y sin consumir timbres del plan.

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

1

Configura la e.firma

La descarga masiva del SAT usa tu e.firma (no el CSD). Súbela en Ajustes › Certificados.
2

Activa la sincronización

En Facturación › Descarga masiva activa la sincronización automática para emitidos y/o recibidos. Cada hora se consulta al SAT qué hay a tu nombre y solo se descargan los XML que faltan, de todos los tipos: ingreso, egreso, pago, nómina y traslado.
3

O pide un periodo a mano

Con Nueva descarga solicitas un rango de fechas. El SAT tarda de horas a días en procesarla; Faqturia vuelve a preguntar sola y extrae los XML cuando están listos.

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

Lo descargado del SAT y los XML que subes con Subir XML (validados antes de guardarse), una vez por UUID. Busca por RFC, emisor, UUID o folio, filtra por estado, tipo, origen y fechas, y exporta a CSV.

Estado ante el SAT

Faqturia vuelve a consultar periódicamente si cada CFDI recibido sigue vigente o fue cancelado, y guarda el historial de cambios. En el detalle puedes pedir Consultar SAT ahora.

Listas SAT

Cada CFDI muestra si su emisor aparece en las listas 69-B o 69 del SAT, según el Monitor Fiscal.

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:

CanceladaLa factura está cancelada ante el SAT.
No requiere REPSe pagó en una sola exhibición (PUE).
SobrepagadaLo pagado y acreditado supera el total.
LiquidadaLos complementos y notas de crédito cubren el total, incluso si se saldó solo con nota de crédito.
Sin REPEs PPD y no tiene ningún complemento de pago que cuente.
ParcialTiene complementos, pero todavía queda saldo.

Observaciones

Marca lo que una revisión encontraría primero: REP fuera de plazo, saldos que no encadenan entre parcialidades, parcialidades repetidas o faltantes, factura cancelada con REP vigentes, PUE con forma de pago 99 y factoraje (el REP lo emite un tercero).

Alertas en la campana

Facturas PPD sin REP después de 30 días (configurable), REP fuera de plazo y REP de facturas canceladas. Se crean y se resuelven solas cada hora, y cada una abre la conciliación ya filtrada.

Excel para tu contador

Un archivo con Resumen, Por cobrar, Por pagar, Complementos (una fila por parcialidad, con plazo y factoraje evaluados) y Notas de crédito.

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

Al llegar un CFDI a tu bóveda, en la vista previa de un XML y antes de timbrar una factura, nota de crédito o REP, con un aviso previo.

Tablero

CFDI recibidos › Monitor Fiscal

Contrapartes con publicaciones y sus CFDI, cambios recientes y alertas que puedes poner en revisión, resolver, descartar o reabrir. Cada RFC tiene su detalle con la línea de tiempo del SAT.

Alertas

Si una contraparte aparece o cambia en una lista, te llega una alerta en la campana. Una alerta descartada no se vuelve a abrir sola.

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

KPIs de facturación: facturado, timbrado, pendiente de REP y comparativas por periodo.

Reportes ejecutivos

Ventas por cliente, producto, mes o día, con desglose operativo y gráficas.

Impuestos

IVA e IEPS trasladados por mes, trimestre o año. También por API (/reports/taxes).

Formatos de exportación

XML (CFDI oficial)
PDF (representación impresa)
CSV / Excel (reportes)
JSON (API)

Plan y timbres

Qué se cuenta y qué pasa al llegar al límite

PlanPrecioTimbres / mesRecibidos / mes
Emprendedor$249 MXN / mes30 · +$3.50 c/u30 · +$0.50 c/u
Negocio$599 MXN / mes150 · +$3.00 c/u150 · +$0.50 c/u
Max$1,290 MXN / mes500 · +$2.80 c/u500 · +$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 lecturas
writeTodas las escrituras
invoices:read / :writeFacturas de ingreso
credit-notes:read / :writeNotas de crédito
payment-complements:read / :writeComplementos de pago
payroll:read / :writeRecibos de nómina
transfers:read / :writeTraslados
clients:read / :writeClientes
products:read / :writeProductos
reports:readReportes
fiscal:readBóveda, conciliación, alertas y Monitor Fiscal
webhooks:read / :writeSuscripciones de webhooks

Guarda 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

invoice.created
invoice.stamped
invoice.canceled
invoice.paid
invoice.partially_paid
credit_note.created
credit_note.stamped
credit_note.canceled
payment_complement.created
payment_complement.stamped
payment_complement.canceled
payroll.created
payroll.stamped
payroll.canceled
transfer.created
transfer.stamped
transfer.canceled

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.

v1
REST
JSON

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/taxes
Abrir guía

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
    }]
  }'