get
/api/v1/businessProfil entreprise
Vastaukset
- 200OK
Pikaopas
Luo API-avain tiliasetuksistasi ja kutsu sitten rajapintaa X-Api-Key-otsikolla.
curl
curl -X POST https://app.fastfaktura.io/api/v1/invoices \
-H "X-Api-Key: ffk_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"client_id": "1f0c4a9e-…",
"currency": "EUR",
"lines": [
{ "description": "Consulting", "quantity": 1, "unit_price_cents": 50000, "tax_rate": 20 }
]
}'Todennus
Jokaisen pyynnön on sisällettävä API-avaimesi joko X-Api-Key-otsikossa tai Bearer-tokenina. Molemmat tavat ovat samanarvoisia.
X-Api-Key
curl https://app.fastfaktura.io/api/v1/clients \ -H "X-Api-Key: ffk_xxxxxxxx"
Authorization: Bearer
curl https://app.fastfaktura.io/api/v1/clients \ -H "Authorization: Bearer ffk_xxxxxxxx"
Päätepisteet
Yritys
put
/api/v1/businessMise à jour du profil
Vastaukset
- 200OK
Asiakkaat
get
/api/v1/clientsListe des clients
Parametrit
pagequery | integer | |
qquery | string | Recherche nom/email/téléphone |
Vastaukset
- 200OK
post
/api/v1/clientsCréation client
Vastaukset
- 201Créé
get
/api/v1/clients/{id}Détail client
Vastaukset
- 200OK
- 404Introuvable
put
/api/v1/clients/{id}Édition client
Vastaukset
- 200OK
delete
/api/v1/clients/{id}Archivage client (pas de suppression définitive)
Vastaukset
- 200OK
Laskut
get
/api/v1/invoicesListe des factures
Parametrit
pagequery | integer | |
statusquery | string |
Vastaukset
- 200OK
post
/api/v1/invoicesCréation facture (avec lignes)
Pyynnön runko
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
client_idpakollinen | uuid | |
currencypakollinen | string | |
due_date | string | null | |
notes | string | null | |
linespakollinen | InvoiceLine[] |
Vastaukset
- 201Créée
get
/api/v1/invoices/{id}Détail facture + lignes + événements
Vastaukset
- 200OK
get
/api/v1/invoices/{id}/pdfPDF de la facture
Vastaukset
- 200application/pdf
post
/api/v1/invoices/{id}/sendEnvoi (email / sms / lien), mode normal ou rappel
Pyynnön runko
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
channelspakollinen | string[] | |
reminder | boolean |
Vastaukset
- 200OK (sandbox: envoi simulé)
get
/api/v1/invoices/{id}/eventsTimeline d'événements
Vastaukset
- 200OK
Skeemat
Rajapinnan hyväksymien ja palauttamien objektien rakenne.
Client
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
id | uuid | |
name | string | |
email | string | null | |
phone | string | null | E.164 |
address | string | null | |
country | string | null | |
locale | string | frennbsv |
external_id | string | null | |
tags | string[] | |
archived_at | string | null |
InvoiceLine
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
descriptionpakollinen | string | |
quantitypakollinen | number | |
unit_price_centspakollinen | integer | Centimes |
tax_ratepakollinen | number | Pourcentage (ex. 20) |
Invoice
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
id | uuid | |
number | string | |
client_id | uuid | |
currency | string | EURUSDGBPNOKSEKDKK |
subtotal_cents | integer | |
tax_cents | integer | |
total_cents | integer | |
status | string | draftsentopenedpaidoverduecancelled |
due_date | string | null | |
public_url | string |