Documentatie

Aan de slag

Welkom bij Oura! In een paar stappen ben je klaar om je eerste professionele factuur te versturen.

Proefperiode

Elke nieuwe gebruiker start automatisch met het gratis plan waarmee je 2 facturen per maand kunt genereren of verzenden. Upgrade naar Professional of Business voor meer facturen en extra functies.

Abonnementen

Kies het plan dat bij je past. Upgraden of downgraden kan op elk moment.

Dashboard overzicht

Na het inloggen kom je op het dashboard terecht. Hier zie je in één oogopslag:

• Aantal concepten, verzonden en openstaande facturen
• Betaald bedrag deze maand
• Waarschuwing bij verlopen facturen
• Overzicht van je laatste facturen met statusbadges

Facturen

Het maken van facturen is de kern van Oura. Je kunt:

• Concept opslaan — Blijf in de editor en werk later verder
• Versturen — Genereer automatisch een PDF en verstuur per e-mail
• Uren koppelen — Wijs uren toe aan factuurregels voor tijdregistratie
• Negatieve bedragen — Voer correcties of retouren in
• Regels herordenen — Sleep items in de gewenste volgorde
• Templates kiezen — Selecteer een ander template per factuur

Klanten

Beheer je klantenbestand centraal. Klantgegevens worden automatisch ingevuld bij het aanmaken van een factuur. Je kunt per klant de bedrijfsnaam, adres, KvK, BTW-id en contactpersoon opslaan.

Uren & Projecten

Registreer uren direct vanuit je facturen of handmatig. Met projecten kun je:

• Werkdagen en max uren per dag instellen
• Uren automatisch verspreiden over werkdagen
• Alternerende vrije dagen instellen (bijv. om de week woensdag vrij)
• Kalender-, lijst- en statistiekweergave bekijken
• Declarabele uren per regel bijhouden

Templates

De drag & drop template editor geeft je volledige controle over het uiterlijk van je facturen:

• Secties slepen en herordenen
• Achtergrondkleuren en afbeeldingen per sectie
• Google Fonts integratie
• Label kleuren en teksten aanpassen
• Logo uploaden en positioneren
• Eigen afbeeldingen en tekstblokken toevoegen (tot 6 per type)
• Voettekst verbergen of altijd onderaan vastzetten
• Standaard opmerkingen met dynamische velden

Groepen & velden

Via het "Groepen" tabblad in de template editor beheer je welke velden in welke sectie staan:

• Velden (zoals bedrijfsnaam, adres, KvK, BTW) per groep bekijken
• Velden drag & drop verplaatsen tussen groepen (bijv. van Afzender naar Footer)
• Per veld de zichtbaarheid aan- of uitzetten
• Volgorde van velden binnen een groep aanpassen door te slepen
• Instellingen worden per template opgeslagen

Instellingen

Onder instellingen beheer je je bedrijfsprofiel(en), API-sleutels en meer. Je kunt meerdere bedrijfsprofielen aanmaken en er één als standaard instellen.

API — Overzicht

De Oura API maakt het mogelijk om facturen, klanten, bedrijfsgegevens en templates programmatisch te beheren. Alle endpoints bevinden zich onder /api/v1/ en retourneren JSON.

API — Authenticatie

Alle requests moeten worden geauthenticeerd met een API-sleutel via de Authorization header.

Authorization: Bearer fg_jouwApiSleutelHier...

curl -X GET https://jouwdomein.nl/api/v1/invoices \
  -H "Authorization: Bearer fg_abc123def456..."  \
  -H "Content-Type: application/json"

API — Bedrijfsprofiel

Beheer het bedrijfsprofiel dat als afzender op facturen verschijnt.

Velden

API — Klanten

Beheer je klantenbestand via de API.

Velden

curl -X POST https://jouwdomein.nl/api/v1/clients \
  -H "Authorization: Bearer fg_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Voorbeeld BV",
    "address": "Keizersgracht 100",
    "postalCode": "1015 AA",
    "city": "Amsterdam"
  }'

API — Facturen

Het kernonderdeel van de API: facturen aanmaken, bijwerken, verwijderen en als PDF downloaden.

Factuurvelden

Factuurregel (items[])

curl -X POST https://jouwdomein.nl/api/v1/invoices \
  -H "Authorization: Bearer fg_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "clm1abc2def3...",
    "items": [
      {
        "description": "Webdesign werkzaamheden",
        "quantity": 40,
        "unit": "uren",
        "unitPrice": 85.00,
        "taxRate": 21
      }
    ]
  }'

API — Templates

Beheer factuurtemplate via de API.

API — Dynamische velden

In het notes veld kun je variabelen gebruiken die automatisch worden ingevuld.

"notes": "Gelieve het bedrag over te maken op IBAN {{iban}} t.n.v. {{tnv}} binnen {{termijn}} dagen."

API — Factuurstatussen

API — Foutafhandeling

{ "error": "Missing required fields: companyName, address" }

API — Paginering

{
  "data": [ ... ],
  "total": 42,
  "limit": 50,
  "offset": 0
}

API — Limieten & best practices

• Maximaal 100 resultaten per request
• API-sleutels zijn privé — deel ze niet publiekelijk
• Gebruik altijd Content-Type: application/json
• Datums in ISO 8601 formaat: 2026-03-08

Kleuren

Onze drie primaire merkkleuren vormen de basis van het hele ontwerp.

Primaire gradient — gebruikt voor CTA's, accenten en het merkidentiteit

Typografie

Wij gebruiken Inter als primair lettertype over de hele applicatie.

Componenten

Voorbeelden van veelgebruikte UI-componenten.

Buttons

Card met accent streep

Merk strepen

Laadanimatie