SDK oficials de Factuarea
Porta factures, contactes i cobraments a la teva aplicació amb els paquets oficials. Instal·la el SDK, connecta la clau i treballa amb l’API de Factuarea des del teu backend.
Integracions i formats 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 documents per conciliar-los, sincronitzar-los amb el teu ERP o preparar un informe.
has_more: truePàgina següentMenys infraestructura, més producte
Consultar una factura és només el principi. Els SDK incorporen eines per recórrer dades, gestionar respostes i verificar avisos sense reconstruir cada peça.
Reintents configurables per a respostes 429 i 5xx. A TypeScript 0.6.0, Retry-After té un límit de 32 segons per defecte; si l’API demana més temps, gestiona l’espera a la integració. Conserva la Idempotency-Key en repetir una operació.
Evita operacions duplicadesTypeScript ofereix iteració asíncrona; PHP inclou PageIterator. Recorre factures i altres llistats amb cursor sense mantenir un bucle manual de peticions.
Entén la paginacióTots dos SDK verifiquen la signatura HMAC, l’antiguitat del missatge i les signatures durant la rotació. El teu receptor conserva el cos original i decideix què fer amb l’esdeveniment.
Connecta els webhooksUna API, diversos processos de negoci
Els SDK accedeixen als recursos de l’API pública. Els permisos de la teva clau, el pla i la configuració de l’empresa determinen les operacions disponibles.
Crea l’esborrany amb client, sèrie i línies. Assigna la numeració amb l’operació específica, descarrega el PDF i consulta l’estat fiscal quan correspongui.
Consulta el flux de facturació02Connecta clients, proveïdors, productes i tarifes amb el teu programari. Fes servir identificadors externs per relacionar cada recurs amb el registre del teu sistema.
Explora els recursos de l’API03Consulta imports pendents, registra pagaments i recupera l’estat de les factures. Porta aquesta informació als processos de conciliació i seguiment.
Explora la gestió de cobraments04Combina crides al SDK amb webhooks: un pressupost aprovat pot iniciar el procés comercial i un pagament rebut actualitzar el CRM. Tu defineixes la lògica.
Dissenya un flux amb esdevenimentsTria amb el contracte al davant
Cada SDK conserva les convencions del seu llenguatge. Per a Python, Go, Java o C#, pots consumir REST directament o generar un client a partir de l’OpenAPI i afegir el comportament de runtime que necessiti la integració.
Obre el contracte OpenAPI
api.factuarea.com/v1invoices.list()publicApiV1InvoicesList()Versions 0.x: revisa el changelog, fixa dependències i valida les actualitzacions abans de portar-les a producció.
Tria com connectar
Treballa amb un SDK, consulta el contracte de l’API o connecta el teu assistent. Tria la teva eina per trobar el punt de partida i la documentació que necessites.
Tecnologies i clients compatibles
Instal·la l’SDK oficial per treballar amb l’API des de Node.js. Inclou reintents, paginació i verificació de la signatura de webhooks.
npm install @factuarea/sdkConnectar TypeScriptDubtes
El pots integrar en producció. Fins a la versió 1.0.0 una actualització menor pot portar canvis incompatibles: fixa la dependència, revisa el changelog i valida les actualitzacions. També pots fixar Factuarea-Version per controlar la versió de l’API.
El teu negoci, més connectatCrea el compte i genera una clau de sandbox. Quan hagis validat el flux, utilitza una clau de producció amb els permisos que necessiti l’aplicació.
Resolem els teus dubtes sobre plans, funcions o com canviar de programa.