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

SAT Certificado

REST API

Webhooks

Referencia API Centro de Ayuda

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.Crear borrador
2.Validar datos fiscales
3.Timbrar ante PAC
4.Enviar por correo al receptor
5.Cancelar (si aplica) via 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.

PAC certificado

Timbrado válido ante SAT

Multi-empresa

Varias empresas por cuenta

API REST

Integración con sistemas externos

Webhooks

Notificaciones en tiempo real

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

Descarga los archivos .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

Ve a Configuración › Empresa › Certificados. Sube ambos archivos y escribe la contraseña del .key. El sistema validará automáticamente la vigencia y el RFC.

Verifica el estado

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

Los CSD tienen vigencia de 2 años. La plataforma te notificará con 30 días de anticipación antes de que expiren.

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

Administrador

Acceso total: configuración, reportes, eliminación

Facturador

Crear y timbrar CFDI. Sin acceso a configuración sensible

Consultor

Solo lectura: visualizar y descargar documentos

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

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

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

La factura se guarda con estado

borrador

. Se puede editar libremente.

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.

Emisión exitosa

La factura pasa a estado

timbrada

. Se genera el XML y PDF listos para descarga.

Envío automático

Si el cliente tiene email registrado, recibe el XML y PDF automáticamente tras el timbrado.

CFDI Global: Para ventas al público general acumuladas (ej. por día), usa la opción de CFDI Global bajo el complemento sin receptor. Requerido si el total supera $100 MXN y el cliente no solicitó factura.

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 10 del mes siguiente al mes en que se recibió el pago.

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

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

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

Desde el detalle de la factura, selecciona el motivo de cancelación y el UUID sustituto (si aplica).

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.

Aceptación del receptor (si aplica)

Para facturas mayores a $5,000 MXN el receptor tiene 72 horas para aceptar o rechazar. Si no responde, se cancela automáticamente.

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.

Reportes y Exportaciones

Analiza y descarga tu información fiscal

Dashboard

KPIs de facturación: monto total, documentos timbrados, tasa de cancelación y comparativas mensuales.

Descarga Masiva

Exporta XML y PDF de múltiples facturas en un ZIP. Filtrable por período, tipo y estado.

Reporte Fiscal

Resumen mensual para presentación de declaraciones: IVA trasladado, IVA acreditable y retenciones.

Formatos de exportación

XML (CFDI oficial)

PDF (representación impresa)

CSV (datos tabulares)

ZIP (lote masivo)

Integraciones

API Keys y Webhooks para automatizar tus procesos

API Keys

Genera claves API desde Integraciones › API Keys. Cada llave tiene un conjunto de permisos (scopes) granulares.

Scopes disponibles

invoices:readLeer facturas

invoices:writeCrear/timbrar facturas

clients:readLeer clientes

clients:writeCrear/editar clientes

payments:readLeer complementos de pago

payments:writeCrear complementos

reports:readAcceder a reportes

webhooks:manageAdministrar webhooks

Guarda tu API Key al momento de crearla — no volverá a mostrarse. Si la pierdes, deberás revocar la actual y generar una nueva.

Webhooks

Recibe notificaciones HTTP POST en tiempo real cuando ocurran eventos en la plataforma.

Eventos disponibles

invoice.created

invoice.stamped

invoice.canceled

payment_complement.stamped

payroll.stamped

credit_note.stamped

Ejemplo de payload webhook

{
  "event": "invoice.stamped",
  "timestamp": "2025-02-21T14:30:00Z",
  "organization_id": "uuid-empresa",
  "data": {
    "invoice_id": "uuid-factura",
    "uuid": "CFDI-UUID-SAT",
    "folio": "F-00123",
    "total": 11600.00,
    "status": "stamped"
  }
}

Todos los webhooks incluyen el header X-Faqturia-Signature con una firma HMAC-SHA256 que puedes verificar usando tu secret para garantizar la autenticidad.

Referencia de API REST

Documentación completa para desarrolladores

La API REST de FAQTURIA te permite integrar la facturación electrónica directamente en tus sistemas. Incluye endpoints para facturas, clientes, productos, pagos, nómina y reportes.

v1.0

REST

JSON

Documentación API
completa

Guía de inicio rápido, autenticación, ejemplos de código en Node.js, Python y PHP, referencia de todos los endpoints y manejo de errores.

GET /invoicesPOST /invoicesGET /clientsPOST /paymentsGET /reports

Abrir guía

Autenticación

Header X-API-Key en todas las peticiones. Genera tu key desde Integraciones.

Facturas

Crear, listar, obtener, timbrar y descargar XML/PDF de facturas CFDI.

Clientes & Productos

CRUD completo de catálogos de receptores y productos/servicios.

CFDI Avanzados

Notas de crédito, complementos de pago, nómina y traslados via API.

Reportes

Exporta datos de facturación en múltiples formatos programáticamente.

Errores & Códigos

Catálogo completo de errores HTTP y códigos de error del SAT/PAC.

Ejemplo: Crear factura via API

curl -X POST "https://www.faqturia.com/api/external/invoices" \
  -H "X-API-Key: faqturia_live_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "uuid-del-cliente",
    "uso_cfdi": "G03",
    "metodo_pago": "PUE",
    "forma_pago": "03",
    "conceptos": [{
      "clave_sat": "80141600",
      "unidad": "E48",
      "descripcion": "Servicio de consultoría",
      "cantidad": 1,
      "precio_unitario": 10000.00
    }],
    "auto_stamp": true
  }'

Centro de Documentación

Introducción

Configuración Inicial

Certificados de Sello Digital (CSD)

Datos Fiscales de la Empresa

Usuarios y Permisos

Catálogos

Clientes (Receptores CFDI)

Productos y Servicios

Facturación CFDI 4.0

Campos obligatorios CFDI 4.0

Proceso de Timbrado

Complementos de Pago (REP)

Datos del Complemento de Pago

Nómina (CFDI-N)

Datos del Empleado

Traslados

Cancelaciones

Flujo de cancelación

Reportes y Exportaciones

Formatos de exportación

Integraciones

API Keys

Webhooks

Referencia de API REST

Documentación APIcompleta

Documentación API
completa