API Overzicht

NextWMS biedt een REST API waarmee je externe systemen koppelt aan het warehouse management systeem. Via de API beheer je orders, preadviezen, stamdata en raadpleeg je voorraad.

Base URL

https://api.nextwms.nl/

Vereiste headers

Header	Beschrijving	Vereist
`site`	Site identifier of Client ID	✅ Ja, bij elke request
`Authorization`	`Bearer <token>` (JWT)	✅ Ja, behalve bij `/login`
`Content-Type`	`application/json`	✅ Ja, bij POST/PUT requests

Quick start

# 1. Login en verkrijg een token
curl -X POST https://api.nextwms.nl/login \
  -H "Content-Type: application/json" \
  -H "site: your-site-id" \
  -d '{"email": "user@example.com", "password": "your-password"}'

# 2. Gebruik het token voor verdere requests
curl https://api.nextwms.nl/orders \
  -H "Authorization: Bearer <token>" \
  -H "site: your-site-id"

Documentatie per onderdeel

Onderdeel	Beschrijving
Authenticatie	Login, tokens en autorisatie
Orders	Orders en orderregels beheren
Preadviezen	Inbound preadviezen en regels
Klanten	Klantgegevens beheren
SKU's / Artikelen	Artikelstamgegevens beheren
Leveranciers	Leveranciersgegevens beheren
Voorraad	Voorraadoverzicht en transacties
Vervoerders	Vervoerders beheren
Waves	Waves definiëren, aanmaken en starten

Foutafhandeling

Alle fouten worden geretourneerd als JSON met een message veld:

{
  "message": "Beschrijving van de fout"
}

HTTP statuscodes

Code	Beschrijving
`200`	Succesvol
`204`	Succesvol, geen content (bij create/update/delete)
`400`	Validatiefout — controleer de request body
`401`	Niet geautoriseerd — token ontbreekt of is verlopen
`403`	Verboden — ongeldige site header
`404`	Resource niet gevonden
`409`	Conflict — resource bestaat al (bijv. duplicate order ID)
`500`	Serverfout

Swagger / OpenAPI

Naast deze documentatie genereert de API een OpenAPI-specificatie (swagger-output.json). Genereer deze opnieuw met npm run start-gendoc in next-wms-api.