API Documentatie

Geeft alle bedrijven waar de ingelogde gebruiker lid van is (eigenaar of medewerker), met vermelding welk bedrijf nu actief is.

[
  {
    "id": 19,
    "naam": "A IT",
    "logo_url": null,
    "rol": "eigenaar",
    "actief": true
  }
]

Geeft 403 als je geen lid bent van het opgegeven bedrijf.

Een extra bedrijf toevoegen is een functie voor betalende klanten: dit vereist een actief betaald abonnement op minstens één van je bestaande bedrijven. Geeft 403 als dat ontbreekt. Het nieuwe bedrijf start zelf op de gratis tier, zonder proefperiode.

Geeft een gepagineerde lijst van klanten voor het ingelogde bedrijf.

{
  "data": [
    {
      "id": 1,
      "naam": "Jan Jansen",
      "bedrijfsnaam": "Jansen BV",
      "email": "jan@jansen.nl",
      "btw_nummer": "NL123456789B01"
    }
  ],
  "total": 42
}

{
  "data": [
    {
      "id": 1,
      "factuurnummer": "F2024-001",
      "status": "verzonden",
      "totaal": "242.00",
      "vervaldatum": "2024-02-15",
      "customer": { "id": 1, "naam": "Jan Jansen" }
    }
  ]
}

# regels-object
{
  "omschrijving": "Webdesign - 10 uur",
  "aantal": 10,
  "prijs": "85.00",
  "btw": 21
}

Geeft de factuur terug als application/pdf. Je kunt de Content-Disposition header bekijken voor de bestandsnaam.

Verstuurt de factuur per e-mail naar de klant en zet de status op verzonden.

Geeft alle producten/diensten terug die zijn opgeslagen als sjabloon voor factuurregels.

Geeft de huidige Mollie-verbindingsstatus voor dit bedrijf terug.

# Verbonden
{
  "verbonden": true,
  "modus": "live",
  "naam": "Jansen BV",
  "type": "oauth"
}

# Niet verbonden
{ "verbonden": false }

Geeft de Mollie OAuth-autorisatie-URL terug. De gebruiker moet vervolgens naar deze URL worden doorgestuurd om toestemming te geven. Na autorisatie stuurt Mollie de browser terug naar /api/koppelingen/mollie/callback — dit endpoint is publiek (geen Bearer token nodig, want het is een browser-redirect van Mollie).

{
  "url": "https://my.mollie.com/oauth2/authorize?client_id=..."
}

Verwijdert de Mollie OAuth-tokens voor dit bedrijf. Bestaande facturen behouden hun betaalstatus. Nieuwe facturen krijgen geen Mollie-betaallink meer totdat opnieuw wordt verbonden.

{ "success": true }

Dit endpoint wordt door Mollie's servers aangeroepen zodra een betalingsstatus wijzigt. Niet bedoeld voor directe aanroep vanuit je eigen applicatie. Mollie stuurt een id (payment-ID) mee; het systeem haalt vervolgens de actuele status op bij Mollie en werkt de factuur bij. Het endpoint is publiek (geen auth) maar valideert de betaling server-side bij Mollie voordat er iets wijzigt.

# Mollie POST-body
id=tr_WDqYK6vAhe

Vraagt een SEPA-incassomandaat aan bij de klant, gekoppeld aan een eerste factuur die de klant moet goedkeuren/betalen (Mollie sequenceType=first). Geeft een betaallink terug die naar de klant gestuurd moet worden — pas zodra die eerste betaling is voltooid, wordt het mandaat actief.

{
  "betaallink": "https://www.mollie.com/checkout/..."
}

Geeft 422 als de klant al een actief mandaat heeft, of als de opgegeven factuur niet bij deze klant hoort.

Incasseert een factuur direct via een al actief mandaat (sequenceType=recurring) — geen checkout-redirect nodig, de klant heeft eerder al gemachtigd. Int het openstaande bedrag (na eventuele deelbetalingen), niet blind het volledige factuurbedrag.

{
  "message": "Incasso gestart, status wordt via de webhook bijgewerkt."
}

Geeft 422 als de klant nog geen actief mandaat heeft, of als de factuur al betaald is.

Trekt de SEPA-machtiging van een klant in. Toekomstige facturen van deze klant worden daarna niet meer automatisch geïncasseerd, ook niet als incasso_toegestaan op een factuur aanstaat.

{ "message": "Incassomachtiging ingetrokken." }

Start een asynchrone import van WeFact-gegevens. Geeft direct een job_id terug waarmee je de voortgang kunt volgen.

# Response
{
  "job_id": "import_1719388800_abc123",
  "status": "gestart",
  "bericht": "Import gestart — gebruik job_id om voortgang te volgen"
}

Geeft de status van de lopende of meest recente import terug.

{
  "status": "voltooid",
  "verwerkt": 154,
  "totaal": 157,
  "nieuwe_klanten": 12,
  "nieuwe_facturen": 142,
  "nieuwe_producten": 8,
  "fouten": []
}

Upload een CSV- of XML-bestand (max 10 MB). Het systeem parseert het bestand en geeft een preview terug — er wordt nog niets opgeslagen. Bevestig daarna via /api/import/bevestigen.

{
  "token": "import_abc123",
  "totaal_in_bestand": 87,
  "nieuw_te_importeren": 72,
  "wordt_overgeslagen_duplicaat": 15,
  "unieke_klanten": 23,
  "totaalbedrag": "18420.00",
  "verloopt_over_minuten": 15
}

{
  "aangemaakt": 72,
  "overgeslagen": 15
}

Geeft alle aan dit bedrijf gekoppelde bankrekeningen terug.

{
  "data": [
    {
      "id": "NL91ABNA0417164300",
      "iban": "NL91ABNA0417164300",
      "naam": "Jansen BV",
      "bank": "ABN AMRO",
      "valuta": "EUR",
      "autorisatie_vervalt": "2026-09-15"
    }
  ]
}

Haalt nieuwe transacties op bij GoCardless en slaat ze op. Geeft direct het resultaat terug (synchrone call, typisch 1–3 seconden).

{
  "nieuwe_transacties": 7,
  "nieuwe_matches": 3
}

{
  "data": [
    {
      "id": 1,
      "datum": "2026-06-15",
      "bedrag": "242.00",
      "valuta": "EUR",
      "omschrijving": "F2026-042 Jansen BV",
      "tegenrekening_iban": "NL02ABNA0123456789",
      "tegenrekening_naam": "Jansen BV",
      "match": { "factuur_id": 17, "betrouwbaarheid": 0.97, "bevestigd": true }
    }
  ],
  "total": 42
}

Geeft onbevestigde matchsuggesties terug, gesorteerd op betrouwbaarheidsscore (hoogste eerst).

{
  "data": [
    {
      "transactie_id": 5,
      "factuur_id": 23,
      "factuurnummer": "F2026-023",
      "bedrag_transactie": "907.50",
      "bedrag_factuur": "907.50",
      "betrouwbaarheid": 0.94,
      "bevestigd": false
    }
  ]
}

Geeft de live systeemstatus terug. Zie ook status.factuurmakenonline.nl.

{
  "overall": "ok",
  "checks": [
    { "id": "database", "name": "Database", "status": "ok", "detail": "12 ms" },
    { "id": "cache",    "name": "Cache",    "status": "ok", "detail": "3 ms"  }
  ],
  "timestamp": "2026-06-26T08:00:00+02:00",
  "uptime_pct": 99.98
}