SchoonGenoeg — API Documentatie

Welkom bij de SchoonGenoeg API

Het SchoonGenoeg platform biedt een REST API waarmee je projecten, gebruikers, uren, contracten, GPS-tracking en meer kunt integreren met externe systemen. Hieronder vind je alle beschikbare en geplande endpoints — inclusief hoe je ze aanroept, welke parameters je meestuurt en wat je terugkrijgt.

Base URL https://api.schoongenoeg.app/v1 Intern (RESTful Table API) tables/{resource}

LIVE — beschikbaar OP AANVRAAG — beschikbaar na aanvraag BETA — test beschikbaar

Authenticatie

Alle API-aanroepen vereisen een Bearer token in de Authorization header. Tokens worden uitgegeven via de Supabase auth-laag of via de platform-inlogflow.

LIVE Supabase Auth

POST /auth/login Inloggen en JWT-token ophalen

Request body

Veld	Type	Verplicht	Beschrijving
email	string	✓	E-mailadres van de gebruiker
password	string	✓	Wachtwoord

curl -X POST https://api.schoongenoeg.app/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"wachtwoord"}'

const res = await fetch('/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email, password })
});
const { token, user } = await res.json();

200 — { token: "eyJ…", user: { id, name, role, email } }

POST /auth/refresh Token vernieuwen

200 — { token: "eyJ…" } — Verzendt huidige token, ontvangt nieuw token (geldig 8u).

Projecten

Projecten aanmaken, ophalen, bijwerken en verwijderen. Ondersteunt ook bulk-import via externe API (REST JSON, CSV, Webhook, Supabase). Projecten bevatten team, subprojecten, locatie, compliance en overnachtingsinfo.

LIVE API Import Kanban Pipeline

GET tables/projects Alle projecten ophalen (gefilterd op rol)

Query parameters

Parameter	Type		Beschrijving
status	string	optioneel	Filter: `active`, `planned`, `done`, `offerte`, `goedkeuring`, `factuur`
search	string	optioneel	Zoek op naam, client of locatie
page	number	optioneel	Pagina (standaard: 1)
limit	number	optioneel	Resultaten per pagina (max 100)

200 — { data: [Project], total, page, limit }

POST tables/projects Nieuw project aanmaken

Request body — Project object

name

string ✓

Projectnaam

client

string

Opdrachtgever

location

string

Locatienaam (bijv. "Ahoy Rotterdam")

address

string

Volledig adres

start

string

Startdatum ISO of DD-MM-YYYY

end

string

Einddatum

status

enum

active · planned · done · offerte · goedkeuring · factuur

country

string

ISO landcode (NL, DE, BE…)

gpsLat / gpsLng

number

GPS-coördinaten

orderNr

string

Intern opdrachtnummer

team

array

Array van teamleden

color

string

blue · green · orange · red · purple

Bulk import: Gebruik SGProjectAPI.webhook([...]) of de CSV-upload in de projecten-sectie voor bulk-imports via externe systemen (Exact, AFAS, ERP, eigen database).

201 — Project object met gegenereerd id

PATCH tables/projects/{id} Project gedeeltelijk bijwerken (status, team, etc.)

200 — Bijgewerkt project object. Gebruik PATCH om alleen gewijzigde velden te sturen (bijv. { "status": "done" }).

DELETE tables/projects/{id} Project verwijderen (soft delete)

204 — Geen inhoud. Soft delete: project krijgt deleted: true vlag.

Gebruikers & Rollen

Gebruikersbeheer met rollen (opdrachtgever, projectmanager, voorman, ZZP, subcontractor, financieel, tekenaar, verkoper). Inclusief KVK-verificatie, profiel en beschikbaarheid.

LIVE 8 rollen

GET tables/users Gebruikers ophalen (gefilterd op rol/project)

Query parameters

Parameter	Type		Beschrijving
role	string	optioneel	Filter op rol: opdrachtgever · zzp · voorman · etc.
projectId	string	optioneel	Teamleden van een specifiek project

200 — { data: [User] } — Gebruikers zonder gevoelige velden (geen wachtwoord/token).

GET tables/users/{id}/beschikbaarheid Beschikbaarheid van een gebruiker ophalen

200 — { werkdagen: [], uren: {}, regio: "", werksoort: "", notities: "" }

POST /users/invite Nieuwe gebruiker uitnodigen (e-mail + rol)

201 — { inviteId, email, role, expiresAt }

Planning & Agenda

Week/dag planning, personeelsinplanning, beschikbaarheidsrooster, ATW-bewaking. Inclusief smart planner met logistieke calculator en bot-suggesties.

LIVE Smart Planner v4.27

GET tables/planning Planning ophalen voor een week

Parameter	Type		Beschrijving
week	string	optioneel	ISO weeknummer bijv. `2026-W16` (standaard: huidige week)
projectId	string	optioneel	Filter op project
userId	string	optioneel	Filter op persoon

200 — { days: { "2026-04-14": [ {userId, projectId, van, tot, rol} ] } }

POST tables/planning Persoon inplannen op project + dag

Veld	Type		Beschrijving
userId	string	✓	Gebruiker-ID
projectId	string	✓	Project-ID
date	string	✓	Datum YYYY-MM-DD
van	string	optioneel	Starttijd HH:MM
tot	string	optioneel	Eindtijd HH:MM

201 — Planningsregel aangemaakt. ATW-check wordt automatisch uitgevoerd.

Urenadministratie

Uren registreren, accorderen en exporteren per project en persoon. Inclusief GPS-tijdmeting (reistijd + werktijd), nacht/weekend/feestdag toeslagen, en koppeling met facturatie.

LIVE GPS-timer Export → OP AANVRAAG

GET tables/hours Urenlog ophalen per project / persoon / periode

Parameter	Type		Beschrijving
projectId	string	optioneel	Uren van één project
userId	string	optioneel	Uren van één persoon
from	string	optioneel	Startdatum YYYY-MM-DD
to	string	optioneel	Einddatum YYYY-MM-DD
status	string	optioneel	`pending` · `approved` · `exported`

200 — { data: [HourEntry], totaalUren, totaalBedrag }

POST tables/hours Uren registreren

userId

string ✓

Werknemer ID

projectId

string ✓

Project ID

date

string ✓

Datum YYYY-MM-DD

startTime

string

HH:MM starttijd

endTime

string

HH:MM eindtijd

travelKm

number

Reisafstand in km

notes

string

Notitie bij uren

status

enum

pending · approved

201 — HourEntry met berekend tarief (incl. nacht/weekend-toeslag op basis van CAO Evenementenbranche).

PATCH tables/hours/{id}/approve Uren accorderen (voorman / OG)

200 — Status wordt approved. Triggert automatisch factuur-aanmaak indien ingeschakeld.

GET tables/hours/export Export uren naar CSV / PDF / Exact

Contracten & DBA

DBA-conforme opdrachtovereenkomsten per persoon per project. Automatische generatie op basis van CAO Evenementenbranche. E-handtekening, digitale kluis, tarieven (uurloon / dagtarief / vaste prijs).

LIVE CAO Evenementenbranche E-handtekening

GET tables/contracts Contracten ophalen (per project of persoon)

Parameter	Type		Beschrijving
projectId	string	optioneel	Contracten van één project
personId	string	optioneel	Contracten van één persoon
status	string	optioneel	`concept` · `signed` · `expired`

200 — { data: [Contract] }

POST tables/contracts/generate Contract automatisch genereren voor een persoon + project

Veld	Type		Beschrijving
projectId	string	✓	Project ID
personId	string	✓	Persoon ID
priceModel	enum	optioneel	`hourly` · `fixed` · `daily`
rate	number	optioneel	Tarief (standaard: CAO-tarief €31,50/uur)

201 — Contract gegenereerd. Verstuur e-mail met handtekeningverzoek via /contracts/{id}/send.

POST tables/contracts/{id}/sign Contract digitaal ondertekenen

200 — Contract status wordt signed. Tijdstempel + IP opgeslagen in kluis.

Projectchat & Communicatie

Lineaire projectchat van opdrachtgever → projectmanager → voorman → ZZP. Groepschats per project + directe berichten. Traceerbaar en gelogd, inclusief locatiebericht en bestandsdeeloptie.

LIVE WebSocket

GET tables/messages Berichten ophalen (per project of DM)

Parameter	Type		Beschrijving
projectId	string	optioneel	Groepschat van een project
userId	string	optioneel	DM-thread met gebruiker
limit	number	optioneel	Aantal berichten (standaard: 50)
before	string	optioneel	Paginatie: berichten vóór timestamp

200 — { data: [Message], hasMore: bool }

POST tables/messages Bericht versturen

Veld	Type		Beschrijving
text	string	✓	Berichttekst
projectId	string	optioneel	Groepschat (of userId voor DM)
toUserId	string	optioneel	Direct message naar gebruiker
location	object	optioneel	`{ lat, lng, label }` — locatiebericht

201 — Bericht verzonden. Real-time delivery via WebSocket aan alle actieve deelnemers.

WS wss://api.schoongenoeg.app/v1/chat/ws Real-time chat verbinding

const ws = new WebSocket('wss://api.schoongenoeg.app/v1/chat/ws');
ws.onopen  = () => ws.send(JSON.stringify({ token, projectId }));
ws.onmessage = (e) => renderMessage(JSON.parse(e.data));

Notificaties & Push

Web Push notificaties, in-app meldingen, smartwatch-berichten (Apple Watch, Wear OS). Per kanaal configureerbaar: chat, planning, compliance, contracten, finance, marktplaats, goedkeuringen.

LIVE VAPID Push 10 kanalen

POST /notifications/send Push notificatie versturen naar gebruiker(s)

Veld	Type		Beschrijving
to	string[]	✓	Array van user-IDs of `"all"`
channel	enum	✓	chat · planning · compliance · contracten · finance · marktplaats · etc.
title	string	✓	Notificatie-titel
body	string	✓	Notificatie-tekst
data	object	optioneel	Extra data (bijv. `{ projectId, url }`)

200 — { sent: number, failed: number }

GPS Tracker

Live voertuig- en personeelstracking via Leaflet kaart. Koppeling met REST JSON, Traccar, GPSwox, Wialon, Fleet Complete, TomTom Webfleet en WebSocket. Uitbreidbaar via veld-mapping.

LIVE 7 bronnen WebSocket

GET /gps/trackers Alle actieve trackers ophalen (positie + status)

id

string

Tracker-ID

name

string

Naam voertuig/persoon

lat / lng

number

GPS-coördinaten

speed

number

Snelheid km/u

status

enum

online · idle · offline

lastSeen

string

ISO timestamp laatste ping

type

enum

vehicle · person · machine

battery

number

Batterijpercentage (indien beschikbaar)

Externe bron instellen: Configureer een Traccar, GPSwox of custom REST endpoint in de GPS Tracker instellingen. Veld-mapping configureerbaar per platform.

200 — { trackers: [Tracker], stats: { total, online, idle, offline } }

WS wss://traccar.voorbeeld.nl/api/socket Live GPS updates via WebSocket (Traccar / GPSwox)

Configureer het WebSocket-endpoint in de GPS-instellingen. Ontvang real-time positie-updates; de kaart herlaadt automatisch bij elk bericht.

EU Rijverboden

Rijverboddatabank voor 17 Europese landen. Weekend- en feestdagverboden per land, gewichtsgrens, uitzonderingen. Automatische check bij aanmaken/bewerken van projecten met buitenlandse locaties.

LIVE 17 landen

GET /rijverboden/{land} Rijverboden voor een specifiek land ophalen

URL parameter

Parameter	Type		Beschrijving
land	string	✓	ISO-code: DE, FR, BE, NL, AT, CH, PL, ES, IT, CZ, SK, HU, RO, HR, SI, DK, LU

200 — { naam, vlag, weekendVerbod, feestdagen, uitzonderingen, zomerverbod, bronUrl }

POST /rijverboden/check Check of een rit verboden is op datum + land

Veld	Type		Beschrijving
land	string	✓	ISO landcode
datum	string	✓	YYYY-MM-DD
tijdstip	string	optioneel	HH:MM starttijdstip rit
gewicht	number	optioneel	Voertuiggewicht in ton

200 — { verboden: bool, reden: string, uitzonderingen: string[] }

Compliance & ATW Arbeidstijden

Automatische Arbeidstijdenwet-bewaking: max uren/dag, max uren/week, verplichte pauzes, minimale rusttijd. Configureerbare drempelwaarden. Alerts worden automatisch gegenereerd op de planning.

LIVE ATW + EU Richtlijn

POST /compliance/atw/check ATW-check uitvoeren voor een persoon op een dag/week

Veld	Type		Beschrijving
userId	string	✓	Gebruiker-ID
weekOf	string	✓	Datum van maandag YYYY-MM-DD

200 — { ok: bool, alerts: [ { type, severity, beschrijving } ] }

GET /compliance/milieuzones Milieuzone-data per stad ophalen

200 — Array van milieuzones met stad, Euro-norm-eisen per voertuigtype, coördinaten en zone-kleur.

Finance & Facturatie

Automatische factuur-aanmaak op basis van goedgekeurde uren. Koppeling met Exact Online en Rompslomp. BTW-export, creditnota's, abonnementen (SG Credits systeem).

OP AANVRAAG Exact Online Rompslomp

POST /invoices/generate Factuur aanmaken op basis van goedgekeurde uren

Gepland. Body: { projectId, userId, periode: { from, to }, priceModel }. Retourneert factuur-PDF URL.

POST /integrations/exact/sync Uren + facturen synchroniseren naar Exact Online

Marktplaats Opdrachten

Publieke en privé opdrachten posten voor ZZP'ers en subcontractors. Reageren met tariedbod, beschikbaarheidsdatum en motivatie. Matching-systeem op basis van categorieën en vereisten.

LIVE Publiek + Privé

GET tables/marktplaats_opdrachten Openstaande opdrachten ophalen

Parameter	Type		Beschrijving
categorie	string	optioneel	Schoonmaak · Standbouw · Transport · etc.
locatie	string	optioneel	Stad of regio
type	string	optioneel	`publiek` · `privé`

200 — { data: [Opdracht] }

POST tables/marktplaats_opdrachten Nieuwe opdracht posten

titel

string ✓

Korte opdrachtomschrijving

categorie

string ✓

Type opdracht

locatie

string

Stad/adres

tarief

number

Uurloon of totaalprijs

aantalPersonen

number

Aantal ZZP/sub gezocht

vereisten

string[]

Bijv. ["VCA","Rijbewijs B"]

type

enum

publiek · privé

startDatum

string

ISO datum

201 — Opdracht geplaatst. Kost 1 SG-credit bij publieke post.

Webhooks (uitgaand)

Laat externe systemen (ERP, AFAS, Exact, eigen CRM) automatisch informeren bij events in SchoonGenoeg. Configureerbaar per event-type met retry-logica en HMAC-signatuur.

OP AANVRAAG HMAC-signed

EVENT project.created / project.updated / project.deleted Project lifecycle events

// POST naar jouw endpoint
{
  "event": "project.created",
  "timestamp": "2026-04-16T12:00:00Z",
  "data": { /* Project object */ }
}

EVENT hours.approved / contract.signed / user.invited Goedkeuringen & documenten

Alle goedkeuringen (uren, contracten, offerten) triggereren een webhook naar het geconfigureerde endpoint.

EVENT compliance.alert / gps.geofence / atw.violation Compliance & GPS-alerts

Compliance-overtredingen (ATW, milieuzone, rijverbod) en GPS geofence-events sturen real-time webhooks.

SG-Bot AI Assistent

Slimme planningsassistent en compliance-bot. Stelt vragen over je planning, geeft suggesties op basis van historische data, beantwoordt vragen over DBA, ATW en rijverboden.

OP AANVRAAG LLM-powered

POST /bot/ask Vraag stellen aan de SG-Bot

Veld	Type		Beschrijving
question	string	✓	De vraag in natuurlijke taal (NL/EN)
context	object	optioneel	Extra context: `{ projectId, userId, date }`

200 — { answer: string, sources: [], suggestions: [] }

Digitale Kluis & Documenten

Beveiligde opslag van ID-scans, KVK-uittreksels, VCA-certificaten, DBA-contracten, kostenbonnen en arbeidsverklaringen. Exporteerbaar als belastingdossier.

OP AANVRAAG — REST API UI LIVE

POST /vault/upload Document uploaden naar digitale kluis

Veld	Type		Beschrijving
file	File	✓	PDF, JPG, PNG (max 10MB)
category	string	✓	id · vca · kvk · contract · certificaat · kostenbon
userId	string	optioneel	Document koppelen aan gebruiker

201 — { docId, category, uploadedAt, expiresAt }

SG-Keurmerk

Aantoonbare zelfstandigheid. Automatische score op basis van KVK-verificatie, DBA-contracten, meerdere opdrachtgevers, gecertificeerde uren en exporteerbaar belastingdossier.

OP AANVRAAG — REST UI LIVE

GET /keurmerk/{userId} Keurmerk-score en status ophalen

200 — { score: 85, status: "bijna_compleet", checks: [{label, ok}], exportUrl: null }

E-Learning & Certificaten

Cursusmodules (VCA, werken op hoogte, heftruck, EHBO) met voortgangsbewaking en vervaldatums. Koppeling met externe leeromgevingen.

OP AANVRAAG UI LIVE

Wagenpark

Voertuigbeheer met APK-datums, Euro-norm, onderhoud op km/draaiuren-interval. Integratie met planning en GPS-tracker. Milieuzone-check bij projectinplanning.

OP AANVRAAG — REST Alerts LIVE

SG API Docs

Welkom bij de SchoonGenoeg API

Authenticatie

Projecten

Gebruikers & Rollen

Planning & Agenda

Urenadministratie

Contracten & DBA

Projectchat & Communicatie

Notificaties & Push

GPS Tracker

EU Rijverboden

Compliance & ATW Arbeidstijden

Finance & Facturatie

Marktplaats Opdrachten

Webhooks (uitgaand)

SG-Bot AI Assistent

Digitale Kluis & Documenten

SG-Keurmerk

E-Learning & Certificaten

Wagenpark