Skip to Content
Changelog

Changelog

Historial de cambios y versiones de la API de FactuLink.

v1.2.0 — Mayo 2026

SDKs oficiales para PHP y .NET en paridad con el SDK Node.js.

Nuevas funcionalidades

  • SDK PHP / Laravel — composer require factulink/factulink-php. PHP 8.1+, integración Laravel (auto-discovery, Facade, config publish), tipos nativos, auto-paginación y errores estructurados (ApiError, AuthError, RateLimitError). Recursos: cfdis, clients, certificates, catalogs, webhooks, ai, apiKeys. Ver SDK PHP.
  • SDK C# / .NET — dotnet add package FactuLink. Multi-target netstandard2.0 + net8.0, async/await, IAsyncEnumerable para auto-paginación, excepciones tipadas (ApiException, AuthException, RateLimitException). Mismos recursos que el SDK Node.js. Ver SDK .NET.

v1.1.0 — Abril 2026

Sprint 8 — Webhooks salientes y SDK oficial de Node.js.

Nuevas funcionalidades

  • Webhooks salientes — Recibe notificaciones HTTP en tiempo real cuando un CFDI es timbrado, cancelado, encolado o falla. Firma HMAC-SHA256 en el header X-FC-Signature, reintentos automáticos con backoff exponencial, e historial de entregas por endpoint. Eventos vivos: cfdi.timbrado, cfdi.cancelado, cfdi.fallido, cfdi.encolado. Ver Webhooks.
  • SDK oficial Node.js / TypeScript — npm install @factulink/node. Tipos nativos, auto-paginacion async, reintentos en 429/5xx, errores tipados (ApiError, AuthError, RateLimitError). Recursos: cfdis, clients, certificates, catalogs, webhooks, ai, apiKeys. Ver SDK Node.js.

Endpoints nuevos

  • POST /api/v1/webhooks — Registrar webhook (devuelve secret una sola vez)
  • GET /api/v1/webhooks — Listar webhooks del tenant
  • PATCH /api/v1/webhooks/:id — Actualizar URL, eventos o estado
  • DELETE /api/v1/webhooks/:id — Eliminar webhook
  • GET /api/v1/webhooks/:id/deliveries — Historial de entregas
  • POST /api/v1/webhooks/:id/test — Disparar evento de prueba

v1.0.0 — Abril 2026

Lanzamiento inicial de la API publica de FactuLink.

Nuevas funcionalidades

  • API Keys — Autenticacion persistente con claves sk_test_ y sk_live_ para sandbox y produccion
  • Sandbox con timbrado simulado — Ambiente de pruebas completo que simula el timbrado sin conexion al SAT
  • Developer Portal — Documentacion interactiva con guias, ejemplos de codigo y referencia de API
  • OpenAPI spec — Especificacion completa descargable en formato JSON para generacion de clientes

Endpoints

  • POST /api-keys — Crear API Key (requiere rol ADMIN y autenticacion JWT)
  • GET /api-keys — Listar API Keys del tenant
  • DELETE /api-keys/:id — Revocar una API Key

Endpoints existentes documentados

  • Autenticacion: login, refresh, me
  • CFDIs: emitir, listar, detalle, cancelar, descargar XML/PDF, estatus SAT, pre-validar
  • Clientes: CRUD completo
  • Certificados (CSD): subir, listar, detalle, activar/desactivar, eliminar
  • Series: crear, listar, actualizar
  • Catalogos SAT: productos/servicios, unidades, regimenes, usos CFDI, formas de pago, metodos de pago, monedas, motivos de cancelacion
  • Estadisticas: CFDIs, CSDs, usuarios
  • Tenant: perfil y configuracion
Last updated on
C# / .NET