SDK oficiales de Factuarea
Lleva facturas, contactos y cobros a tu aplicación con los paquetes oficiales. Instala el SDK, conecta tu clave y trabaja con la API de Factuarea desde tu backend.
Integraciones y formatos compatibles
WhatsApp
npm install @factuarea/sdkimport { Factuarea } from "@factuarea/sdk";
const factuarea = new Factuarea({
apiKey: process.env.FACTUAREA_API_KEY!,
});
const invoices = await factuarea.invoices.list();
for await (const item of invoices) {
const invoice = item as { id: string };
console.log(invoice.id);
}Recupera documentos para conciliarlos, sincronizarlos con tu ERP o preparar un informe.
has_more: trueSiguiente páginaMenos infraestructura, más producto
Consultar una factura es solo el principio. Los SDK incorporan herramientas para recorrer datos, gestionar respuestas y verificar avisos sin reconstruir cada pieza.
Reintentos configurables para respuestas 429 y 5xx. En TypeScript 0.6.0, Retry-After tiene un tope de 32 segundos por defecto; si la API pide más tiempo, gestiona esa espera en tu integración. Conserva tu Idempotency-Key al repetir una operación.
Evitar operaciones duplicadasTypeScript ofrece iteración asíncrona; PHP incluye PageIterator. Recorre facturas y otros listados con cursor sin mantener un bucle manual de peticiones.
Entender la paginaciónAmbos SDK verifican la firma HMAC, la antigüedad del mensaje y las firmas durante la rotación. Tu receptor conserva el cuerpo original y decide qué hacer con el evento.
Conectar los webhooksUna API, varios procesos de negocio
Los SDK acceden a los recursos de la API pública. Los permisos de tu clave, el plan y la configuración de la empresa determinan las operaciones disponibles.
Crea el borrador con cliente, serie y líneas. Asigna la numeración en su operación específica, descarga el PDF y consulta el estado fiscal cuando corresponda.
Ver el flujo de facturación02Conecta clientes, proveedores, productos y tarifas con tu software. Usa identificadores externos para relacionar cada recurso con el registro de tu sistema.
Explorar los recursos de la API03Consulta importes pendientes, registra pagos y recupera el estado de las facturas. Lleva esa información a tus procesos de conciliación y seguimiento.
Explorar la gestión de cobros04Combina llamadas al SDK con webhooks: un presupuesto aprobado puede iniciar tu proceso comercial y un pago recibido actualizar tu CRM. Tú defines la lógica.
Diseñar un flujo con eventosElige con el contrato delante
Cada SDK conserva las convenciones de su lenguaje. Para Python, Go, Java o C#, puedes consumir REST directamente o generar un cliente a partir del OpenAPI y añadir el comportamiento de runtime que necesite tu integración.
Abrir el contrato OpenAPI
api.factuarea.com/v1invoices.list()publicApiV1InvoicesList()Versiones 0.x: revisa el changelog, fija dependencias y valida las actualizaciones antes de llevarlas a producción.
Elige cómo conectar
Trabaja con un SDK, consulta el contrato de la API o conecta tu asistente. Elige tu herramienta para encontrar el punto de partida y la documentación que necesitas.
Tecnologías y clientes compatibles
Instala el SDK oficial para trabajar con la API desde Node.js. Incluye reintentos, paginación y verificación de la firma de webhooks.
npm install @factuarea/sdkConectar TypeScriptDudas
Puedes integrarlo en producción. Hasta la versión 1.0.0 una actualización menor puede traer cambios incompatibles: fija la dependencia, revisa el changelog y valida las actualizaciones. Puedes fijar también Factuarea-Version para controlar la versión de la API.
Tu negocio, mejor conectadoCrea tu cuenta y genera una clave de sandbox. Cuando hayas validado el flujo, utiliza una clave de producción con los permisos que necesite tu aplicación.
Resolvemos tus dudas sobre planes, funciones o cómo cambiar de programa.