Direct naar inhoud

Aan de slag

Snelstart: je eerste API-verzoek in vijf minuten

Maak een API-sleutel, doe je eerste verzoek en maak een klant en een conceptfactuur aan.

Wat heb je nodig

  • Een Factora-organisatie met een pakket waarin de API zit en een afgeronde eerste pakketbetaling.
  • De rol eigenaar of beheerder in die organisatie; alleen zij kunnen API-sleutels aanmaken.
  • Een HTTP-client: curl, Postman of de HTTP-bibliotheek van je programmeertaal.

Stap 1: maak een API-sleutel

  1. 1Log in op Factora en open Instellingen → API.
  2. 2Kies Nieuwe API-sleutel, geef hem een herkenbare naam (bijvoorbeeld Webshop-koppeling) en kies eventueel een vervaldatum.
  3. 3Bevestig met je wachtwoord.
  4. 4Kopieer de sleutel direct. Hij begint met factora_ en wordt maar één keer getoond.

Stap 2: test de verbinding

Het endpoint GET /me geeft je organisatie en de gebruikte sleutel terug. Krijg je 200, dan werkt alles.

export FACTORA_API_KEY="factora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl https://factora.one/api/v1/me \
  -H "Authorization: Bearer $FACTORA_API_KEY" \
  -H "Accept: application/json"
{
    "data": {
        "organization": {
            "id": "9d3c5e2a-1b7f-4c0e-9a51-2f6d8b7e4c10",
            "name": "Demo BV",
            "email": "info@demo.nl",
            "payment_terms_days": 14,
            "timezone": "Europe/Amsterdam",
            "is_active": true
        },
        "api_key": {
            "id": "9d3c5e2a-77aa-4b1c-8d0e-1a2b3c4d5e6f",
            "name": "Webshop-koppeling",
            "last_used_at": "2026-11-12T09:14:03.000000Z"
        }
    }
}

Stap 3: maak een klant aan

curl -X POST https://factora.one/api/v1/customers \
  -H "Authorization: Bearer $FACTORA_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name": "Jansen Bouw", "email": "info@jansenbouw.nl", "city": "Rotterdam", "country": "NL"}'

Je krijgt 201 Created met de nieuwe klant onder data. Bewaar data.id; die heb je in de volgende stap nodig.

Stap 4: maak een conceptfactuur

Bedragen zijn altijd gehele eurocenten exclusief btw. 7500 is dus € 75,00. Factora rekent btw en totalen zelf uit en kiest het volgende factuurnummer.

curl -X POST https://factora.one/api/v1/invoices \
  -H "Authorization: Bearer $FACTORA_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "<id uit stap 3>",
    "invoice_date": "2026-11-12",
    "lines": [
      {"description": "Website onderhoud", "quantity": 2, "unit_price": 7500, "tax_rate": 21}
    ]
  }'

De factuur staat nu als concept in Factora. Laat je due_date weg, dan gebruikt Factora de factuurdatum plus de betalingstermijn van je organisatie.

Volgende stappen

  • Verstuur de factuur met POST /invoices/{id}/send of download de PDF met GET /invoices/{id}/pdf (zie Facturen).
  • Lees Verzoeken en antwoorden voor paginering, datums en bedragen.
  • Reageer op gebeurtenissen in Factora met Webhooks via automatiseringen.

Lees ook