API v1
REST API pentru Factuur.software. Parte din abonamentul Pro. JSON în și din, autentificare Bearer.
Autentificare
Trimite cheia ta API în header-ul Authorization:
Authorization: Bearer JOUW_SLEUTEL
Generează-ți cheia prin Profil, sub Acces API. Cheia este vizibilă o singură dată - apoi păstrăm doar un hash. Pierdut? Retrage-o și generează una nouă.
Limită de rată
1000 de cereri pe oră per utilizator. Peste aceasta urmează HTTP 429.
Endpoints
| Metodă | Cale | Descriere |
|---|---|---|
| GET | /api/v1/me | profil, abonament, caracteristici și consum |
| GET | /api/v1/invoices | facturi (nearchivate); interogare: de la, până la (YYYY-MM-DD), limită (max 1000), offset |
| GET | /api/v1/invoices/{id} | o factură cu rânduri și client |
| POST | /api/v1/invoices | creează factură; invoice_number gol = numerotare automată, rânduri opțional |
| PUT | /api/v1/invoices/{id} | modifică status, invoice_number, issue_date, due_date, notes sau customer_id |
| DELETE | /api/v1/invoices/{id} | arhivează factura (obligația de păstrare fiscală, fără ștergere definitivă) |
| GET | /api/v1/customers | clienți; interogare: limită, offset |
| GET | /api/v1/customers/{id} | un client |
| POST | /api/v1/customers | creează client; numele este obligatoriu |
| PUT | /api/v1/customers/{id} | modifică câmpurile clientului |
| DELETE | /api/v1/customers/{id} | șterge client; 409 atâta timp cât există facturi asociate |
| GET | /api/v1/expenses | cheltuieli; interogare: de la, până la (YYYY-MM-DD), limită, offset |
| GET | /api/v1/expenses/{id} | o cheltuială |
| POST | /api/v1/expenses | creează cheltuială |
| PUT | /api/v1/expenses/{id} | modifică cheltuială; sumele și TVA-ul vor fi recalculat |
| DELETE | /api/v1/expenses/{id} | șterge cheltuială |
Coduri de stare
200/201reușit401Token-ul Bearer lipsește sau este invalid403abonamentul nu oferă acces API404nu a fost găsit409conflict, de exemplu ștergerea unui client cu facturi422payload invalid429limita de rată depășită
Exemple
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