API REST de facturació
Crea i envia factures, registra cobraments i connecta clients, catàleg i workflows amb l’ERP, la botiga o l’aplicació. Una API REST de facturació amb VeriFactu i FacturaE, sobre les mateixes dades que fa servir l’equip.
Integracions i formats compatibles
WhatsApp
POST/v1/invoices
{
"client_id": "f58fbf7f-333f-499b-affc-c0d396cbd83f",
"series_id": "019e5584-7a72-7038-a8f6-561ed180b699",
"issued_on": "2026-09-22", "due_on": "2026-10-22",
"external_id": "order_1042",
"lines": [{
"description": "Consultoría",
"quantity": 2, "unit_price": 150, "tax_rate": 21
}]
}Què pots construir
Connecta l’ERP, la botiga o l’aplicació amb els mateixos documents i dades que fa servir l’equip a Factuarea. Explora l’abast real abans d’escriure la integració.
Crea factures, converteix pressupostos i treballa amb proformes, albarans i recurrents. Numera, envia, descarrega el PDF i registra cobraments o rectificatives.
POST /invoicesPOST /quotes/{quote}/convertPOST /recurring_invoicesSincronitza contactes, productes, variants i tarifes. Consulta existències i moviments d’estoc per connectar la venda amb el catàleg.
POST /contactsGET /productsGET /price-listsRegistra despeses, consulta’n el detall i anota pagaments. Mantén els documents de proveïdor relacionats amb la gestió de despeses.
POST /purchase_invoicesPOST /purchase_invoices/{purchase_invoice}/paymentsAccedeix a registres i estats de VeriFactu, genera XML FacturaE i presenta factures a FACe quan l’empresa disposa de la configuració i el certificat necessaris.
GET /invoices/{invoice}/facturaePOST /invoices/{invoice}/face-submissionsConsulta el catàleg de disparadors i accions, crea regles, prova l’execució amb dry run i revisa cada execució. Fes servir webhooks per continuar el flux al teu sistema.
POST /automations/rulesPOST /automations/rules/{rule}/dry_runGET /automations/runsIntegra empleats, jornades, fitxatges, absències i tancaments mensuals. Cada recurs utilitza els permisos i mòduls habilitats a l’empresa.
GET /employeesGET /time-entriesGET /absence-requestsCrea tasques, mou-les per les columnes del projecte i imputa el temps amb el temporitzador. Les hores facturables es converteixen en una factura esborrany.
POST /tasksPOST /tasks/{task}/timer/startPOST /projects/{project}/time-invoicesL’abast de cada clau depèn dels permisos, del pla i dels mòduls actius. La referència indica els requisits de cada operació.
Integracions amb un propòsit
L’API REST permet decidir quan crear un document, quines dades porta i com continua la feina. Aquests són tres recorreguts que pots construir amb les operacions disponibles.
order_1042POST /contactsPOST /invoicesPOST /invoices/{id}/sendCada flux requereix una clau amb els permisos adequats i la configuració dels recursos que utilitza.
Acceptat/invoices/{invoice}/verifactuFacturació a Espanya
Una API de facturació amb VeriFactu ha d’explicar quin document es crea i què passa després. Factuarea manté el registre, el format i els estats dins de l’empresa emissora.
En emetre s’aplica la configuració fiscal de l’empresa. Si VeriFactu està actiu, es genera i remet el registre; pots consultar-ne els estats des de l’API. Fer servir REST no activa VeriFactu per si sol.
Descarrega l’XML FacturaE d’una factura emesa. Per signar-lo i presentar-lo a FACe cal un certificat actiu i els tres codis DIR3 del client. El registre de presentació queda vinculat a la factura.
Mode de proves de Factuarea
Una quantitat incorrecta també falla al sandbox. Comprova la resposta de l’API amb fact_test_ i prepara l’aplicació per gestionar tant el resultat correcte com el rebuig.
fact_test_…"lines": [{
"quantity": 2,
"unit_price": 150,
"tax_rate": 21
}]{
"data": {
"status": "draft",
"number": null,
"total": 363,
"currency": "EUR"
}
}Esborrany creat: 300,00 € de base i 63,00 € d’IVA. Encara no consumeix número.
El sandbox hereta el teu pla. L’accés i els límits de l’API continuen aplicant-se.
Veure el sandbox de l’APIPreparada per integrar
El contracte tècnic acompanya el resultat: autenticació, permisos, idempotència, límits i versió. Pots comprovar-ho a la documentació abans de connectar dades reals.
201 Created data.id: 01931b3e…8a42
1 intent, una factura. La mateixa clau i el mateix cos recuperen la primera resposta durant 24 hores.
Com aplicar la idempotènciaAutentica des del servidor i concedeix només els permisos necessaris. Cada operació respecta l’accés de la clau i el context d’empresa.
Configurar claus i permisosLes claus fact_test_ treballen en una empresa de proves. No es lliuren correus reals ni registres a l’AEAT; els webhooks d’esdeveniments no surten cap al receptor. El ping explícit d’un webhook sí que fa una petició externa.
Explorar el sandboxFixa la versió d’API i consulta les capçaleres de límit. Davant un 429, Retry-After indica quant esperar. Les quotes depenen del pla i la configuració.
Veure les versions de l’APIFes servir HTTP o els SDK de TypeScript i PHP. Crea el primer document, revisa el resultat i amplia el flux a mesura que ho necessitis.
Dubtes
Crear, numerar i enviar factures, recuperar PDF, registrar cobraments i emetre rectificatives. També pots treballar amb clients, catàleg, compres, pressupostos, recurrents i workflows. Cada recurs requereix els permisos i mòduls corresponents.
El teu negoci, més connectatExplora el sandbox, crea una factura de prova i connecta les operacions que necessita el negoci.
Resolem els teus dubtes sobre plans, funcions o com canviar de programa.