Referencia API

Documentacion completa de todos los endpoints de la API de FactuLink.

Base URL: https://api.factulink.com.mx/api/v1

Todas las peticiones usan esta URL base. El prefijo de tu API Key determina el ambiente: sk_test_ = sandbox, sk_live_ = produccion.

Descargar especificacion

• OpenAPI spec (JSON) — Compatible con Swagger UI, Redocly, Stoplight y otros
• Postman collection (JSON) — Importar en Postman para probar todos los endpoints

Autenticacion

Endpoints para autenticacion con JWT y gestion de sesiones.

POST/auth/login — Autenticar con email y password. Retorna un access token JWT.

POST/auth/refresh — Renovar access token usando el refresh token.

GET/auth/me — Obtener el perfil del usuario autenticado.

Ver la guia completa en Autenticacion.

API Keys

Endpoints para crear y gestionar API Keys. Requieren autenticacion JWT con rol ADMIN para crear.

POST/api-keys — Crear una nueva API Key (requiere rol ADMIN).

GET/api-keys — Listar todas las API Keys del tenant.

DELETE/api-keys/:id — Revocar una API Key existente.

CFDIs

Endpoints para emitir, consultar, cancelar y descargar comprobantes fiscales digitales.

POST/cfdis — Emitir un nuevo CFDI (Ingreso, Egreso o Traslado).

GET/cfdis — Listar CFDIs con cursor pagination. Soporta filtros por status, tipo, RFC receptor y rango de fechas.

GET/cfdis/:uuid — Obtener el detalle completo de un CFDI por su UUID.

POST/cfdis/:uuid/cancel — Cancelar un CFDI vigente. Requiere motivo de cancelacion del catalogo SAT.

GET/cfdis/:uuid/xml — Descargar el XML timbrado del CFDI.

GET/cfdis/:uuid/pdf — Descargar la representacion impresa (PDF) del CFDI.

GET/cfdis/:uuid/sat-status — Consultar el estatus del CFDI directamente en el SAT.

POST/cfdis/validate — Pre-validar un CFDI sin timbrarlo. Util para detectar errores antes de emitir.

Ver las guias de Emitir CFDI y Cancelar CFDI.

Clientes

Endpoints para gestionar el directorio de clientes (receptores de CFDIs).

POST/clients — Crear un nuevo cliente con sus datos fiscales.

GET/clients — Listar clientes del tenant. Soporta busqueda por RFC y nombre.

GET/clients/:id — Obtener el detalle de un cliente.

PATCH/clients/:id — Actualizar los datos de un cliente existente.

DELETE/clients/:id — Eliminar un cliente del directorio.

Certificados (CSD)

Endpoints para gestionar los Certificados de Sello Digital necesarios para firmar CFDIs.

POST/csds — Subir un nuevo CSD (archivos .cer y .key via multipart/form-data).

GET/csds — Listar los CSDs del tenant con su estado y vigencia.

GET/csds/:id — Obtener el detalle de un CSD.

PATCH/csds/:id — Activar o desactivar un CSD.

DELETE/csds/:id — Eliminar un CSD del sistema.

Ver la guia de Subir Certificado.

Series

Endpoints para gestionar series de folios para CFDIs (ej. Serie A, Serie B).

POST/series — Crear una nueva serie de folios.

GET/series — Listar las series del tenant.

PATCH/series/:id — Actualizar configuracion de una serie.

Catalogos SAT

Endpoints de solo lectura para consultar los catalogos oficiales del SAT. Utiles para construir formularios y validar datos antes de emitir.

GET/catalogs/productos — Buscar claves de producto/servicio. Soporta busqueda full-text por descripcion.

GET/catalogs/unidades — Listar claves de unidad de medida.

GET/catalogs/regimenes — Listar regimenes fiscales vigentes.

GET/catalogs/usos-cfdi — Listar usos de CFDI permitidos.

GET/catalogs/formas-pago — Listar formas de pago (efectivo, transferencia, etc.).

GET/catalogs/metodos-pago — Listar metodos de pago (PUE, PPD).

GET/catalogs/monedas — Listar monedas soportadas (MXN, USD, etc.).

GET/catalogs/paises — Listar países (clave SAT, ISO 3166).

Estadisticas

Endpoints para obtener metricas y estadisticas del tenant.

GET/stats/cfdi — Estadisticas de CFDIs: total emitidos, cancelados, montos por periodo.

GET/stats/csd — Estadisticas de CSDs: activos, por vencer, vencidos.

GET/stats/users — Estadisticas de usuarios del tenant.

Tenant

Endpoints para consultar y actualizar la configuracion del tenant (organizacion).

GET/tenants/me — Obtener el perfil y configuracion del tenant actual.

PATCH/tenants/me — Actualizar datos del tenant (nombre, logo, configuracion fiscal).