Desarrolladores

Timbra CFDI desde tu propio sistema.

La API REST de Facty es exactamente la misma que usa la aplicación web. Creas una API key desde tu cuenta, la mandas en un header, y emites CFDI 4.0 —ingresos, egresos, complementos de pago, nómina y retenciones— desde tu ERP, tu tienda o un script.

Inicio rápido Referencia de endpoints

curl -X POST https://facty.mx/api/authenticated/mi-empresa/invoices \
  -H "X-API-Key: fk_a1b2c3..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "ingreso",
    "clientId": "clx9aa...",
    "usoCfdi": "G03",
    "formaPago": "03",
    "metodoPago": "PUE",
    "idempotencyKey": "mi-erp:factura:4471",
    "items": [
      { "productId": "clxp01...", "quantity": 2 }
    ]
  }'

Una sola credencial

Un header X-API-Key. Sin OAuth, sin tokens que renovar, sin SDK obligatorio: si tu lenguaje habla HTTP, ya puedes timbrar.

Idempotencia de verdad

Cada timbrado lleva una llave que tú defines. Un doble clic, un timeout o un replay del cron devuelven el mismo CFDI y cobran un solo timbre.

Errores para máquinas

Todo error trae un code estable y un requestId. Nunca tienes que hacer match contra un mensaje en español que podríamos reescribir.

Sandbox antes de producción

El endpoint de contexto te dice si el ambiente timbra contra el sandbox del PAC o contra el SAT real. Verifícalo antes de emitir nada.

Toda la documentación

Empezar

Inicio rápidoDe cero a tu primer CFDI timbrado por API en cinco pasos.
Autenticación y API keysCómo crear una llave, qué scopes existen y cómo se comporta ante producción y sandbox.
Convenciones de la APIURL base, formato de errores, paginación por cursor, request ids y tipos de dato.
Idempotencia y reintentosCómo no timbrar dos veces la misma factura, y qué hacer cuando una petición se cae a la mitad.

Catálogos

ClientesAlta, búsqueda y actualización de los receptores de tus CFDI.
Productos y serviciosTu catálogo con claves del SAT e impuestos por default, para no repetirlos en cada timbrado.
Catálogos del SATConsulta las claves oficiales —uso de CFDI, forma de pago, régimen, unidades— en vez de codificarlas a mano.

Emitir CFDI

Timbrar facturasEl CFDI de ingreso completo: conceptos, impuestos, moneda, factura global, relacionados y traslados.
Notas de crédito (egreso)Devoluciones, descuentos y bonificaciones sobre facturas ya timbradas.
Complemento de pago (REP)Registrar cobros de facturas PPD y timbrar el CFDI de tipo Pago que exige el SAT.
NóminaDar de alta empleados y timbrar recibos de nómina con el complemento 1.2.
Retenciones e información de pagosEl CFDI de retenciones, para cuando retienes impuestos a un tercero.

Después de timbrar

Descargar y enviar el CFDIXML, PDF, el ZIP con ambos, y el envío por correo al receptor.
Cancelaciones y estatus SATCancelar un CFDI, descargar el acuse y consultar si el SAT lo tiene vigente.
Saldo de timbresConsultar cuántos timbres quedan y su historial de movimientos.

Referencia

ErroresLos códigos estables, qué significa cada uno y cuáles se pueden reintentar.
Referencia de endpointsTodos los endpoints públicos con su método, scope y descripción, en una sola tabla.

¿Vas a integrar con un agente de IA?

Facty también expone un servidor MCP, para que Claude y otros clientes de IA operen tu facturación con las mismas reglas y los mismos scopes.

Ver el servidor MCP