← Terug naar home Voor ERP-leveranciers

ERP-koppelvlak
Grossier.nu

Dit is wat het ERP van een grossier aanbiedt, zodat Grossier.nu er rechtstreeks mee koppelt. Eén beschrijving voor elk ERP: wie hem overneemt sluit aan op de generieke koppeling van het platform, wie alleen de eisen in een eigen API inbouwt krijgt een koppeling op maat. Status: concept 0.2, openbaar. Vragen en terugmeldingen via support@grossier.nu.

Drie lagen

Het platform eist niet dat een ERP alles levert. Het koppelt al op een klein minimum en werkt dan met minder; alles daarboven meldt het ERP zelf, en het platform past zich aan. Een onderdeel dat ontbreekt is geen storing, maar een functie die de garage in de shop mist.

Laag 1

Minimum om te koppelen

Zonder deze twee onderdelen koppelt het platform niet.

  • Artikelinfo live: kent het ERP het artikel, en wat is de vrije voorraad per vestiging
  • Order plaatsen, idempotent op de platformreferentie, met het ERP-ordernummer terug
Laag 2 · aanbevolen

Volledig koppelvlak

Alles wat de garage in de shop verwacht te zien van zijn grossier.

  • Vestigingen
  • Artikelstam en voorraad in bulk (volledig en wijzigingen sinds tijdstip)
  • Klant lezen
  • Orderstatus en historie, ook orders buiten het platform om
  • Facturen en creditnota's
  • Retour aanmelden en volgen
  • Levermoment op de order
Laag 3

Uitbreidingen

Modules voor wat per grossier anders ligt.

  • Prijs uit het ERP (klantcondities)
  • Garage-login bij het ERP
  • Klant opzoeken op debiteurnummer, klant aanmaken, artikelen aanleggen
  • Inkooporders per leverancier
  • Borg op ruildelen
  • Routeschema per klant
  • Export als bestand, meldingen, testomgeving

Eisen en vorm

De eisen gelden altijd, ook voor wie de functies in een bestaande API inbouwt. De vorm (endpoints, velden, foutcodes uit de OpenAPI-beschrijving) is de aanbevolen uitwerking.

  1. Idempotent bestellen op de platformreferentie: bestaat de order al, dan komt die terug, nooit een tweede; het ERP legt vast vóór het antwoordt.
  2. Exact matchen van artikelen op ERP-artikel-id, EAN of artikelnummer plus merk; gelijkheid na normalisatie, nooit op een deel van het nummer.
  3. Stabiele identiteiten voor klant, artikel, order, factuur, retour en inkooporder.
  4. Wijzigingen sinds een tijdstip, met een door het ERP teruggegeven vertrekpunt en stabiele paginering.
  5. Vrije voorraad is aanwezig min gereserveerd, per vestiging.
  6. Een order faalt niet op een onbekend artikel; de regel landt zichtbaar voor handwerk.
  7. Prijs en levermoment worden geboekt zoals meegegeven, tenzij de module Prijs actief is.
  8. Echte foutstatussen; een fout komt nooit als geslaagd antwoord terug.
Vorm overgenomenAlleen de eisen, in een eigen API
KoppelingDe generieke koppeling van het platform: basis-URL en sleutel instellen, klaar.Een koppeling op maat, door het platform te bouwen en te onderhouden.
DoorlooptijdDe acceptatiescenario's draaien direct tegen de testomgeving.Eerst een analyse van de API, dan bouwen, dan dezelfde scenario's.
Uitbreidingen laterEen nieuwe module is aan beide kanten een instelling.Elke uitbreiding is opnieuw maatwerk.
Kosten en planningGeen bouwkosten voor de koppeling aan platformzijde.In overleg, afhankelijk van de afwijking.

Documenten, versie 0.2

Specificatie, volledig (PDF) Deel 1 voor de beslisser met de bindende eisen, deel 2 voor de bouwer, bijlagen. Specificatie, alleen deel 1 (PDF) Filosofie, drie lagen, eisen, testomgeving en acceptatie. Voor wie beslist. OpenAPI, leesbare weergave Alle endpoints, velden, voorbeelden en foutantwoorden, bladerbaar in de browser. OpenAPI 3.1 (YAML) De bronbeschrijving, voor codegeneratie en validatie. OpenAPI als PDF Dezelfde leesbare weergave, om te printen of door te sturen.

Wijzigingen per versie

VersieDatumWat is er veranderd
0.221 oktober 2026Uitkomst van een bouwtest: een bouwer zonder voorkennis bouwde een ERP uit de spec, het platform koppelde er in één keer op. Twee werkwijzen benoemd (ERP-beheerd, platform-beheerd) met masterData in de capabilities; module Artikelen aanleggen; idempotentie puur op platformreferentie; matchen vastgelegd (normalisatie, volgorde, matchedOn); prijscorrectie zichtbaar en niet bij online betaling; regelstatussen gedefinieerd en platformLineRef; delta over alle klanten, sort en totalCount; document-URL zonder sleutel; retouren altijd onder /returns; foutcodes aangevuld; module Testomgeving. Volledige lijst in bijlage C van de specificatie.
0.121 oktober 2026Eerste openbare concept: drie lagen, bindende eisen los van de aanbevolen vorm, OpenAPI met 24 operaties.

Zolang het versienummer onder 1.0 ligt is de inhoud een concept en kan hij wijzigen op basis van wat ERP-leveranciers terugmelden. Binnen /v1 zijn wijzigingen alleen toevoegend.