API v1

REST API per Factuur.software. Parte dell'abbonamento Pro. JSON in e out, autenticazione Bearer.

Autenticazione

Invia la tua chiave API nell'intestazione Authorization:

Authorization: Bearer JOUW_SLEUTEL

Genera la tua chiave tramite Profilo, sotto Accesso API. La chiave è visibile solo una volta - poi conserviamo solo un hash. Persa? Revocala e generane una nuova.

Limite di richiesta

1000 richieste all'ora per utente. Oltre si riceve HTTP 429.

Endpoints

Metodo	Percorso	Descrizione
GET	/api/v1/me	profilo, abbonamento, funzionalità e utilizzo
GET	/api/v1/invoices	fatture (non archiviate); query: da, a (YYYY-MM-DD), limite (max 1000), offset
GET	/api/v1/invoices/{id}	una fattura con righe e cliente
POST	/api/v1/invoices	crea fattura; invoice_number vuoto = numerazione automatica, righe opzionali
PUT	/api/v1/invoices/{id}	modifica stato, invoice_number, issue_date, due_date, notes o customer_id
DELETE	/api/v1/invoices/{id}	archivia la fattura (obbligo di conservazione fiscale, nessuna cancellazione definitiva)
GET	/api/v1/customers	clienti; query: limite, offset
GET	/api/v1/customers/{id}	un cliente
POST	/api/v1/customers	crea cliente; il nome è obbligatorio
PUT	/api/v1/customers/{id}	modifica campi cliente
DELETE	/api/v1/customers/{id}	elimina cliente; 409 finché ci sono fatture collegate
GET	/api/v1/expenses	spese; query: da, a (YYYY-MM-DD), limite, offset
GET	/api/v1/expenses/{id}	un spesa
POST	/api/v1/expenses	crea spesa
PUT	/api/v1/expenses/{id}	modifica spesa; importi e IVA verranno ricalcolati
DELETE	/api/v1/expenses/{id}	elimina spesa

Codici di stato

200 / 201 riuscito
401 Token Bearer mancante o non valido
403 abbonamento non fornisce accesso API
404 non trovato
409 conflitto, ad esempio eliminare cliente con fatture
422 payload non valido
429 limite di richiesta superato

Esempi

curl -H "Authorization: Bearer JOUW_SLEUTEL" https://factuur.software/api/v1/me

curl "https://factuur.software/api/v1/invoices?from=2026-01-01&limit=50" -H "Authorization: Bearer JOUW_SLEUTEL"

curl -X POST -H "Authorization: Bearer JOUW_SLEUTEL" -H "Content-Type: application/json" -d '{"customer_id":1,"lines":[{"description":"Consultancy","quantity":8,"unit_price":95,"tax_rate":21}]}' https://factuur.software/api/v1/invoices

curl -X PUT -H "Authorization: Bearer JOUW_SLEUTEL" -H "Content-Type: application/json" -d '{"status":"betaald"}' https://factuur.software/api/v1/invoices/123

Utilizziamo cookie essenziali per far funzionare questo sito. Con il tuo permesso utilizziamo anche analisi per migliorare il sito.