SDK oficial · v0.2.0TypeScript / Node.js
Tipos completos, async/await y automatismos listos para Node 20 o superior.
Instalar
npm install @factuarea/sdkSDK oficiales
Integra Factuarea con TypeScript o PHP.
Clientes oficiales para tu backend, con reintentos, idempotencia y paginación ya resueltos.
- Node 20 o superior
- PHP 8.2 o superior
- Sandbox con clave fact_test_
Integraciones y formatos compatibles
WhatsApp
SDK oficial · v0.2.0
SDK oficial · v0.2.0PHP
PSR-4 sobre Guzzle, errores claros y soporte para PHP 8.2 o superior.
Instalar
composer require factuarea/factuarea-phpQué hay dentro
Reintentos, idempotencia y paginación incluidos
Tu aplicación hace una llamada. El SDK se ocupa de que llegue una sola vez y de recuperar la respuesta correcta.
- ReintentosRespeta Retry-After y recupera automáticamente los fallos transitorios.
- IdempotenciaCada operación lleva una clave para que repetirla no duplique una factura.
- Paginación por cursorRecorre next_cursor hasta completar la colección, sin bucles manuales.
TypeScriptv0.2.0PHPv0.2.0Factuarea SDKinvoices.create(factura)
201 CreatedFRA 2026/0184
✓ Reintentos✓ Idempotencia✓ Paginación por cursor
Las cabeceras
Autenticación y cabeceras gestionadas por el SDK
Escribir menos código es el argumento fácil. El que se nota es este: dejar de acordarte. Cada una de estas cabeceras tiene una consecuencia si se olvida, y el SDK las pone y las lee por ti.
- Idempotency-KeyGenerada para cada mutación. Es lo que hace que un reintento no acabe en dos facturas.
- Retry-AfterCuando llega un 429, el SDK espera lo que diga esta cabecera antes de volver a intentarlo.
- Factuarea-VersionLa versión que ancla el release que tienes instalado. La API se comporta igual hasta que actualizas.
TypeScriptPHPFactuarea SDKruntime.request()
- AuthorizationwriteBearer fact_live_…
- Idempotency-Keywrite0192…1d4b
- Factuarea-Versionwrite2026-06-01
- Retry-Afterread12
- X-Request-Idreadreq_01…
- Factuarea-Signaturereadt=… v1=…
El SDK va en el servidor. Siempre.
La clave es un secreto: no la lleves a un navegador, a una app móvil ni a ningún cliente público.
OpenAPI 3.1
Un contrato público para generar tu propio cliente
Genera un cliente para tu lenguaje desde la misma especificación que publica la API.
- Tipos siempre alineadosModelos y operaciones salen directamente de OpenAPI 3.1.
- Tu lenguaje también entraTypeScript, Python, Go, Java, C# y Rust, entre otros.
- Tú eliges el runtimeAñade reintentos e idempotencia siguiendo las guías de Factuarea.
OpenAPI 3.1openapi.json✓ Tipos siempre alineados✓ Tu lenguaje también entra✓ Tú eliges el runtime
docs.factuarea.com/api/openapiSuperficie publicada
Una integración que encaja con tu stack
El contrato OpenAPI, los SDK y el servidor MCP parten de la misma API. Las cifras se revisan contra la superficie publicada para que puedas evaluar alcance y mantenimiento antes de integrar.
- operaciones API
- 413
- recursos
- 37
- herramientas MCP
- 391
- páginas de documentación
- 797
Tecnologías y clientes compatibles
- TypeScript
- PHP
OpenAPI
Cursor
Los logotipos identifican tecnologías o clientes compatibles; no implican una relación comercial ni un testimonio.
Dudas
Lo que se pregunta antes de fijar la dependencia
Sí puedes usarlo. Hasta el 1.0.0 una versión menor puede traer cambios incompatibles, así que fíjala en el lockfile. Cada release ancla una Factuarea-Version y la API no cambia debajo hasta que tú actualizas.
Instala, apunta al sandbox y emite una factura
Con una clave fact_test_ no se envía nada a ninguna parte. Cuando salga, cambias el prefijo.