VOOR GROOTHANDELS

Wat Nomy bij jullie opvraagt

Nomy is bedrijfssoftware voor Belgische KMO's — offertes, planning, facturatie. Vraagt een van jullie klanten een koppeling aan, dan vindt u hier wat onze software precies doet: welke oproepen, hoe vaak, en met welke aanmeldgegevens.

Vragen of iets niet duidelijk? Mail gerust rechtstreeks naar bart@nomy.be.

Drie dingen die overal gelden

  1. Elke klant gebruikt zijn eigen toegang. Er is geen platform-brede sleutel: de klant vult zijn eigen account in, en die gegevens worden versleuteld bewaard (AES-256-GCM) binnen zijn eigen werkruimte. Ze zijn nooit zichtbaar voor andere klanten, staan nooit in een logboek en worden nooit gedeeld.
  2. Er gaan geen persoonsgegevens naar jullie. Wij sturen artikelnummers en zoektermen; wij ontvangen artikelgegevens en prijzen. Geen namen, adressen, offertes of projecten.
  3. Wij plaatsen geen bestellingen. Vandaag gebruiken we uitsluitend de oproepen hieronder. Bestel-, order- en offerte-functies van jullie webservice laten we bewust ongebruikt. Eén uitzondering, en die staat er per groothandel ook bij: heeft de zaakvoerder zijn winkelmandje op jullie webshop gevuld en klikt hij in Nomy op de knop “Mandje van {jullie naam}”, dan lezen we dat mandje om er offertelijnen van te maken — en maken we het enkel leeg wanneer hij daar zelf om vraagt. Komt er ooit iets bij, dan vragen we dat eerst aan jullie — en staat het hier.

Per groothandel

APOK

APOK API to connect External ERP with APOK Webplatform (v1.4)

Adres

https://www.apok.be

Oproepen die we gebruiken
  • token/get — aanmelden als softwareleverancier (token, 1 uur geldig)
  • Search/SearchProducts — zoeken op trefwoord vanuit de offerte-editor
  • product/getpriceinformation — prijzen per artikelnummer, per 50
  • product/getproductdata — eenheden en omrekening van één gekozen artikel
  • cart/getbasket — het winkelmandje dat de klant zelf op apok.be vulde, om er offerteposten van te maken (enkel wanneer hij daarop klikt)
  • cart/emptybasket — datzelfde mandje leegmaken, enkel wanneer de klant daar zelf om vraagt
  • Token/GetLogin — een kortlevend aanmeldtoken voor de link naar het mandje op apok.be, enkel wanneer de klant in een offerte op de mandjelink klikt
Aanmelding

de myAPOK-login van de klant zelf (e-mailadres + wachtwoord, versleuteld bewaard), naast onze partnerlogin per ERP-systeem

Hoeveel en hoe vaak

geen volledige catalogus; enkel de artikelen die de klant zelf kiest, daarna wekelijks ververst

Cebeo

cebeoXML 2.0.0 (B2B-webservices)

Adres

https://b2b.cebeo.be/webservices/xml

Oproepen die we gebruiken
  • Article/Search — zoeken op trefwoord vanuit de offerte-editor
  • Article/Get — artikelgegevens, prijzen, verpakkingseenheid en de wettelijke bijdragen (Recupel, Ecotax, Sabam) per artikelnummer, per 50
Aanmelding

de eigen e-shop-login van de klant (klantnummer, gebruikersnaam en wachtwoord van eshop.cebeo.be) — zoals de Cebeo-specificatie voorschrijft; geen apart account

Hoeveel en hoe vaak

geen volledige catalogus; enkel de artikelen die de klant zelf kiest, daarna wekelijks ververst

Deschacht

Buildmat API v2 (ook Foylo, ODM, Technicel, LsDrain, Domspro)

Adres

https://shop.deschacht.eu/api/v2

Oproepen die we gebruiken
  • productcodes opvragen — welke artikelen bestaan er voor deze klant
  • productgegevens per code, per 50 (prijs, eenheid, EAN, voorraad)
  • GET basket/basket — het winkelmandje dat de klant zelf op de webshop vulde, om er offerteposten van te maken (enkel wanneer hij daarop klikt)
  • DELETE basket/basket — datzelfde mandje leegmaken, enkel wanneer de klant daar zelf om vraagt
Aanmelding

een API-sleutel die de klant zélf ophaalt in de webshop (/api/v2/key) — wij zien zijn wachtwoord nooit

Hoeveel en hoe vaak

de volledige catalogus van de klant, één keer per week

Desco

Desco API v2.03

Adres

https://www.desco.be

Oproepen die we gebruiken
  • GetAllProducts — de catalogus met de klantspecifieke nettoprijzen
  • PVCheck — één controle-oproep bij het koppelen
  • GetAutoLogonUrl — een aanmeldlink (90 s geldig) naar het partnermandje op de Desco-site, enkel wanneer de klant in een offerte op de webshoplink klikt
  • GetBasket — het partnermandje ("winkelwagen Nomy") dat de klant zelf op de Desco-site vulde, om er offerteposten van te maken (enkel wanneer hij daarop klikt)
  • ClearBasket — datzelfde mandje leegmaken, enkel wanneer de klant daar zelf om vraagt
Aanmelding

de gewone webshoplogin van de klant (klantnummer, e-mailadres, wachtwoord)

Hoeveel en hoe vaak

de volledige catalogus van de klant, één keer per week

Facq

FacqSoap

Adres

https://extranet.facq.be/addin/facq/soap/FacqSoap.asmx

Oproepen die we gebruiken
  • PVCheck — prijs en gegevens per artikelnummer, per 50
  • GetBasket — de caddie die de klant zelf op de webshop vulde, om er offerteposten van te maken (enkel wanneer hij daarop klikt)
  • ClearBasket — datzelfde mandje leegmaken, enkel wanneer de klant daar zelf om vraagt
Aanmelding

de e-commerce-login van de klant; Facq activeert de dienst per klantnummer

Hoeveel en hoe vaak

uitdrukkelijk NOOIT de hele catalogus — enkel de artikelen die de klant in zijn offertes gebruikt, met een bovengrens per ronde, wekelijks

STG

STG OrderExchange V2 (SOAP)

Adres

https://www.stg-pro.be/OrderExchange-V2/OrderExchange.asmx

Oproepen die we gebruiken
  • PvCheck — prijs en voorraad per artikelnummer (puntkomma-gescheiden, 50 per oproep)
  • GetBasket / ClearBasket — de bestellijst van de webshop ophalen en leegmaken
  • Authentication.aspx/ExternalLogin — de doorklik-login naar stg-pro.be, enkel wanneer de klant in een offerte op de webshoplink klikt (de link gaat enkel naar zijn eigen browser)
  • GetSavedOrders — de bewaarde bestellijsten — nog niet in gebruik
Aanmelding

de gewone stg-pro.be-webshoplogin van de klant (klantnummer, gebruikersnaam, wachtwoord)

Hoeveel en hoe vaak

enkel de artikelen die de zaak écht gebruikt, één keer per week

Rexel

Rexel web services (NetStore)

Adres

https://services.rexel.be/exchange/ws/prod/rexel

Oproepen die we gebruiken
  • getPrices — prijs en beschikbaarheid per artikelnummer, per 100
  • Rexstand eCatalog — de klant-eigen artikellijst (DBF) via de RESTful-dienst
  • getBasket — het NetStore-winkelmandje van de klant, om er offerteposten van te maken (enkel wanneer hij daarop klikt); NetStore wist het mandje zelf bij het ophalen, dus een aparte leegmaak-oproep doen we hier niet
Aanmelding

de aparte webservices-gebruiker die Rexel per klant aanmaakt (…WEBS), niet de webshoplogin

Hoeveel en hoe vaak

maximaal 1.000 artikelen per ronde, gebruikte artikelen eerst, wekelijks

Van Marcke

Van Marcke Products API v2 (+ OAuth 2.0 v1)

Adres

https://api.vanmarcke.com

Oproepen die we gebruiken
  • v1/oauth/.well-known/openid-configuration — het aanmeld- en tokenadres opvragen (nooit hardgecodeerd)
  • v1/oauth/token — client credentials voor de catalogusprijzen; authorization_code + refresh_token voor de eigen aanmelding van de klant
  • v2/products/bulk/detail?includePriceAndStock=true — artikelen mét prijs per artikelnummer, per 50
  • v2/products/bulk/mappingProductId — oude AS400-nummers omzetten naar de nieuwe SAP-nummers
  • v2/products?limit=500&offset=… — hun artikellijst pagina per pagina, enkel om ontbrekende barcodes (supplierBarcode) aan te vullen; hun eigen raad (API Support, 29/09/2026)
  • v2/products/checkPermissionPriceList, requestPriceListNetCsv en statusPriceListNetCsv — de nettoprijslijst van de klant als CSV aanvragen en ophalen, één keer per week, met zijn eigen aanmelding
  • v1/serviceusers — het klantnummer achter het toegangsbewijs, om te tonen met wie er gekoppeld is
  • v1/punchout/cart — het winkelmandje van de klant op Blue ophalen (GET) en op zijn vraag leegmaken (DELETE), met zijn eigen aanmelding
Aanmelding

de klant meldt zich aan bij Van Marcke zelf (OAuth 2.0 Authorization Code, terugkeeradres /api/oauth/vanmarcke/callback); wij bewaren enkel het toegangs- en vernieuwbewijs, versleuteld — nooit een wachtwoord. Zonder die aanmelding draait de koppeling op één sleutel voor heel Nomy en komt enkel de catalogusprijs mee

Hoeveel en hoe vaak

geen dagelijkse sync van het gamma (hun eigen vraag): de nettoprijslijst van de klant één keer per week als één CSV-aanvraag, daarnaast de artikelen die de klant opzoekt of in offertes gebruikt (bulk-oproepen van 50, hoogstens 500 per ronde), en per week hoogstens 20 pagina's van 500 uit hun artikellijst om barcodes aan te vullen die de CSV niet draagt (het hele gamma in ± een maand; geen enkele oproep wanneer niets nog een barcode nodig heeft)

Van Oirschot

Van Oirschot API v1.0.2 (REST, OAuth2)

Adres

https://www.vanoirschot.be/nl/customer/api

Oproepen die we gebruiken
  • POST /oauth/token — aanmelden (password grant), token per klant
  • GET /products?items=… — catalogusprijs én klant-eigen nettoprijs, met de milieubijdragen apart, 50 per oproep
  • GET /products/all — de volledige catalogus (enkel brutoprijzen, dagelijks ververst) — nog niet in gebruik
  • GET /cart — het winkelmandje dat de klant zelf op de webshop vulde, om er offerteposten van te maken
  • DELETE /cart/clear-lines — datzelfde mandje leegmaken, enkel wanneer de klant daar zelf om vraagt
Aanmelding

de applicatiesleutels van Nomy (client id + secret) én de gewone vanoirschot.be-webshoplogin van de klant (klantnummer, gebruikersnaam, wachtwoord)

Hoeveel en hoe vaak

enkel de artikelen die de zaak écht gebruikt, één keer per week

Krijgt u een aanvraag van een klant?

Dan hebben wij van jullie kant maar twee dingen nodig:

  1. De toegang voor die ene klant — een webservices-account of het vrijgeven van zijn bestaande account, met de aanmeldgegevens die de koppeling moet gebruiken.
  2. De technische beschrijving van jullie dienst, als die er nog niet is: het adres, de manier van aanmelden en de beschikbare oproepen.

Wij bouwen nooit op giswerk. Zolang er geen documentatie is, bouwen we de koppeling niet — precies om te vermijden dat jullie systeem oproepen krijgt die nergens op slaan.

Iets toe te voegen, of staat uw bedrijf er nog niet bij?

Contacteer ons over een koppeling

Nomy — de agent-native business-OS voor de Belgische KMO. Wat Nomy automatiseert →

Voor groothandels — koppelingen met Nomy