FastFaktura

FastFaktura API

v1 · 1.0.0

Samþættu FastFaktura reikningagerð inn í tólin þín: viðskiptavini, reikninga, sendingar og PDF-skjöl með einföldu REST API. Sandbox reikningar líkja eftir raunverulegri sendingu og nota Stripe í prófunarham.

OpenAPI lýsingGrunnslóðhttps://app.fastfaktura.io/api/v1

Fljótlegt yfirlit

Búðu til API-lykil í stillingum reikningsins þíns og kallaðu svo á API með X-Api-Key hausnum.

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 }
    ]
  }'

Auðkenning

Hver fyrirspurn verður að innihalda API-lykilinn þinn, annaðhvort í X-Api-Key hausnum eða sem Bearer tóki. Báðar aðferðir eru jafngildar.

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"

Endapunktar

Fyrirtæki

get/api/v1/business

Profil entreprise

Svör

  • 200OK
put/api/v1/business

Mise à jour du profil

Svör

  • 200OK

Viðskiptavinir

get/api/v1/clients

Liste des clients

Færibreytur

pagequeryinteger
qquerystringRecherche nom/email/téléphone

Svör

  • 200OK
post/api/v1/clients

Création client

Svör

  • 201Créé
get/api/v1/clients/{id}

Détail client

Svör

  • 200OK
  • 404Introuvable
put/api/v1/clients/{id}

Édition client

Svör

  • 200OK
delete/api/v1/clients/{id}

Archivage client (pas de suppression définitive)

Svör

  • 200OK

Reikningar

get/api/v1/invoices

Liste des factures

Færibreytur

pagequeryinteger
statusquerystring

Svör

  • 200OK
post/api/v1/invoices

Création facture (avec lignes)

Meginmál fyrirspurnar

ReiturTegundLýsing
client_idnauðsynlegtuuid
currencynauðsynlegtstring
due_datestring | null
notesstring | null
linesnauðsynlegtInvoiceLine[]

Svör

  • 201Créée
get/api/v1/invoices/{id}

Détail facture + lignes + événements

Svör

  • 200OK
get/api/v1/invoices/{id}/pdf

PDF de la facture

Svör

  • 200application/pdf
post/api/v1/invoices/{id}/send

Envoi (email / sms / lien), mode normal ou rappel

Meginmál fyrirspurnar

ReiturTegundLýsing
channelsnauðsynlegtstring[]
reminderboolean

Svör

  • 200OK (sandbox: envoi simulé)
get/api/v1/invoices/{id}/events

Timeline d'événements

Svör

  • 200OK

Skemu

Uppbygging hlutanna sem API tekur við og skilar.

Client

ReiturTegundLýsing
iduuid
namestring
emailstring | null
phonestring | nullE.164
addressstring | null
countrystring | null
localestringfrennbsv
external_idstring | null
tagsstring[]
archived_atstring | null

InvoiceLine

ReiturTegundLýsing
descriptionnauðsynlegtstring
quantitynauðsynlegtnumber
unit_price_centsnauðsynlegtintegerCentimes
tax_ratenauðsynlegtnumberPourcentage (ex. 20)

Invoice

ReiturTegundLýsing
iduuid
numberstring
client_iduuid
currencystringEURUSDGBPNOKSEKDKK
subtotal_centsinteger
tax_centsinteger
total_centsinteger
statusstringdraftsentopenedpaidoverduecancelled
due_datestring | null
public_urlstring