Leverancierskoppelingen

Met een leverancierskoppeling kan je snel producten van een externe leverancier toevoegen op een offerte, inkooporder... met de juiste, actuele prijzen.

Legende

Symbool	Betekenis
✅	Werkt via de API of het kanaal van de leverancier
🟡	Beperkt, of alleen op de lokale databank
❌	Niet ondersteund
⛔	Endpoint bestaat, maar is defect of ongevalideerd (gooit NotImplemented, geeft altijd 400, doet iets anders dan verwacht)
–	Niet van toepassing

Vier soorten koppelingen

Type	Koppelingen	Kenmerk
Live leveranciers-API	Cebeo, VanOirschot, 2BA, FittingShop	Geen lokale catalogus. Zoeken, prijzen en mandje gaan rechtstreeks naar de leverancier.
API met lokale catalogus	Desco, STG, Rexel, Viessmann, TechnischeUnie, Würth	Producten in de eigen databank. Prijzen en mandje live.
Bestand en e-mail	Kramp, RoyalCrown, Tradeplace	Catalogus via feed, FTP of import. Geen live prijzen, geen winkelmandje.
Configurator	Hörmann	Geen productcatalogus. Samenstellingen configureren bij de leverancier en bestellen.

Overzicht leveranciers + functionaliteit

Koppeling	Login-controle	Catalogus	Zoeken	EAN	Klantprijzen	Mandje ophalen	Mandje leegmaken	Bestellen	Order opvragen	Locaties	Extra
Cebeo	✅	✅	✅ API	✅ API, barcode als zoekwoord	✅ GetArticles	✅ open order	✅	✅ met leveringsoptie	❌	❌	Leveringsoptie
VanOirschot	✅	✅	✅ API	✅ API, barcode meegestuurd	✅	✅ cart	✅	✅ leverdatum verplicht	❌	❌	–
2BA	✅	✅ live, per leverancier (GLN)	✅ API, leverancier verplicht	🟡 alleen zoekterm	✅ netto via OCS	✅ selectielijst	✅	❌	❌	❌	Leverancierslijst (multi-leverancier)
FittingShop	✅	🟡 live, sync NotImplemented	✅ API vrije tekst	🟡 alleen zoekterm	✅ PVCheck	✅	✅	✅ SendOrder	🟡 eerste onbevestigde order, id genegeerd	❌	–
Desco	✅	✅ volledige sync GetAllProducts	🟡 lokaal	🟡 lokaal	✅ PVcheck	✅	✅	✅ PlaceOrder	✅ GetOrder met totalen	✅ afhaalpunten	–
STG	✅	✅ Excel-prijslijst, aangevuld met PvCheck	🟡 lokaal	🟡 lokaal	✅ PvCheck	✅ items ook in DB bewaard	✅	✅ SOAP Order	⛔	⛔	–
Rexel	✅	✅ DBF-bestand	🟡 lokaal	🟡 lokaal	✅ getPrices, altijd actueel	✅ met actuele prijzen	⛔ leest mandje, wist niets	❌	❌	❌	–
Viessmann	✅	🟡 refresh van gekende producten	🟡 lokaal	🟡 lokaal	✅ pvCheck	✅	✅	✅ putBasket, afwerken in webshop	❌	❌	–
TechnischeUnie	✅	🟡 gekende producten per tenant	🟡 lokaal	🟡 lokaal	✅ GetPrice	✅ via hook, 5 min bewaard	✅	⛔	❌	❌	Fabrikantnaam en -nummer per product
Würth	✅	🟡 geen catalogus, alleen opgevraagde artikels	🟡 lokaal	🟡 lokaal	✅ pvCheck	✅ hook of webservice	✅	❌	❌	❌	–
Kramp	✅	✅ PRICAT-CSV via FTP	🟡 lokaal	🟡 lokaal	🟡 prijs uit pricat	❌	❌	✅ UBL-XML op FTP	❌	❌	Orderbevestigingen (UBL responses) ophalen en afvinken
RoyalCrown	🟡 controleert adrescode en feedbestand	✅ XML-productfeed uit PIM	🟡 lokaal	🟡 lokaal	🟡 feedprijs, geen klantprijs	❌	❌	✅ e-mail met XML-bijlage	❌	❌	–
Tradeplace	⛔ geen validatie, altijd true	✅ import per merk, push naar anoniem endpoint	🟡 lokaal, merk verplicht	🟡 alleen zoekterm	🟡 geïmporteerde prijs	❌	❌	❌	❌	❌	Merkenlijst (multi-leverancier)
Hörmann	🟡 controleert alleen of velden ingevuld zijn	–	–	–	✅ kostprijs per configuratie	–	–	✅ configuraties en losse onderdelen	⛔	–	Configurator (nieuw, bewerken, kopiëren), technische PDF's

Koppeling activeren

Elke gebruiker die de koppeling nodig heeft, moet deze zelf toevoegen aan zijn profiel
De koppeling kan je instellen onder je profiel in IAMD.

Dit doe je als volgt


Ga naar het tandwieltje bovenaan en klik op profiel
Ga naar de tab koppelingen:
Klik onderaan links op de knop '+ Toevoegen' en kies een leverancier
Geef in de pop-up het klantennummer in, jouw persoonlijke login voor de webshop en jouw persoonlijk wachtwoord voor de webshop. (Niet de gegevens om in te loggen bij onze applicatie)
Klik vervolgens op bewaren.
De koppeling is nu geactiveerd.

De gevraagde info kan verschillen per leverancier. Kijk op de pagina van de leverancier voor meer details

Producten toevoegen aan je offerte/order/levering

Op offerteniveau zal je nu bij het toevoegen van regels, onder product, een aantal extra opties krijgen.

Deze opties zijn:

Lijst van leverancier (dit is de lijst van alle actieve artikelen van de leverancier aanwezig in de IAMD database)
Winkelmand van leverancier (via deze optie ga je naar het winkelmandje van de leverancier webshop. Je kan hier producten in toevoegen en deze ophalen in je offerte, rechtstreeks uit de webshop)
Eigen bibliotheek (dit zijn jouw producten, deze vind je terug onder producten in jouw IAMD-omgeving en komen dus niet binnen via de leverancierskoppeling)

Uit de lijst van de leverancier


Kies je leverancier door op het logo te klikken
Duidt een of meerdere artikels aan en klik op toevoegen onderaan je scherm
De artikels zijn nu toegevoegd aan de regels in je offerte. De nettoprijs zal overgenomen worden naar het kostprijsveld, de brutoprijs zal overgenomen worden naar het verkoopprijsveld.

Winkelmand van leverancier

Niet elke leverancier ondersteund deze methode


Kies een leverancier door op het logo te klikken
De webshop van de leverancier opent.
Voeg de gewenst artikels toe aan je winkelmandje via de zoekfunctie van de webshop en klik vervolgens op toevoegen.
Het opgevraagde artikel zal ingelezen worden in je offerte. De nettoprijs zal overgenomen worden naar het kostprijsveld, de brutoprijs zal overgenomen worden naar het verkoopprijsveld.

Vast product aanmaken

Indien je van een toegevoegd leveranciersartikel een eigen artikel wenst te maken kan je dit doen door op het vrachtwagentje te gaan staan achter de regel en op de knop vast product aanmaken te klikken.

Je kan via deze weg ook de externe productpagina oproepen. De webshop van de leverancier zal openen in een nieuw tabblad en je zal daar de gedetailleerde artikelinfo terugvinden in de leveranciersshop.

Producten synchroniseren

Niet alle leveranciers ondersteunen synchronisatie. Kijk op de helpdeskpagina van uw leverancier voor de ondersteunde functionaliteiten

Bij de productenlijst in het platform, is er een actie om de producten van een leverancier te synchroniseren. Deze actie zal eerst de nieuwe productenlijst ophalen bij de leverancier en vervolgens ook de vaste producten updaten.

Meer informatie vindt u op Worden producten uit een catalogus van een externe leverancier automatisch bijgewerkt?

Inkooporder verzenden naar leverancier.

Niet alle leveranciers ondersteunen automatische ordercreatie. Kijk op de helpdeskpagina van uw leverancier voor de ondersteunde functionaliteiten

Een inkooporder kan automatisch omgezet worden naar een bestelling bij de leverancier. Voeg de gewenste producten toe op het inkooporder en via de actie Verstuur naar <leverancier>. In de popup kan u de leverdetails nakijken en vervolgens de levering bestellen bij de leverancier.

Als de leverancier niet correct gelinkt is, zal de actie niet zichtbaar zijn.

Relatie linken aan leverancierskoppeling

Het platform moet weten welke van uw leveranciers in het platform overeenkomen met welke koppeling. Bij `Instellingen`->`Leverancier`->`Velden en Secties`->`Algemeen` moet het veld Externe productleverancier zichtbaar gemaakt worden.

Zoek vervolgens de leverancier die u wilt koppelen op en selecteer de juiste koppeling in het veld Externe productleverancier.

Hoe de lokale databank gevuld wordt

Koppeling	Bron van de catalogus	Wanneer	Aanvulling per artikel	Via winkelmandje	Lijst per tenant
Desco	Volledige productlijst via de API, met de IAMD-credentials uit de settings, niet die van de tenant	op vraag	Ja. Op een onbekend id doet een PVcheck en bewaart het product (nettoprijs wordt bewust niet bewaard)	Nee	Nee, gedeeld
STG	Excel-bestand op het bestandssysteem van de server, drie headerrijen worden overgeslagen. Het bestand moet manueel op de server gezet worden	op vraag	Ja. Op een onbekend id, of op een product dat enkel uit Excel komt doet een PvCheck en bewaart het resultaat	Ja. Bewaart alle items die nog niet in de databank staan	Nee, gedeeld
Rexel	DBF-bestand in een zip, via HTTP gedownload met de IAMD-credentials uit de settings	op vraag	Ja, ruim. Elke productopvraging én elke prijsopvraging bewaart of actualiseert de producten. Artikels die Rexel als verwijderd terugstuurt worden gewist	Nee, uitgecommentarieerd	Gemarkeerd als persoonlijk
Kramp	PRICAT-CSV op de FTP-server van Kramp, gelezen met de FTP-login van de tenant	op vraag, én automatisch bij de eerste filter of productopvraging als de klant nog geen producten heeft	Nee, Kramp heeft geen product-API	Nee	Ja, per klantnummer
RoyalCrown	XML-productfeed via HTTP uit het PIM, plus de feedbestandsnaam die de tenant bij het inloggen meegeeft	op vraag	Nee	Nee	Ja
Tradeplace	Tradeplace pusht een zip met TradeXML. De tenant wordt bepaald via het Tradeplace-id in de routing, het merk via de SellerCode. Onbekende merken worden aangemaakt	Push door Tradeplace.	Nee	Nee	Ja, per tenant en merk
Viessmann	Geen catalogus. De databank start leeg	Sync vernieuwt enkel de reeds gekende producten via pvCheck	Ja. Op een onbekend id doet een pvCheck en bewaart het product	Ja. Bewaart alle items met status 0	Ja
TechnischeUnie	Geen catalogus. De databank start leeg	Sync vernieuwt enkel de reeds gekende producten	Ja. Op een onbekend id doet een GetProduct en bewaart het product	Nee. Het mandje uit de OCI-hook wordt niet bewaard, het platform moet daarna productopvraging aanroepen	Ja
Würth	Geen catalogus. De databank start leeg	Sync vernieuwt enkel de reeds gekende producten via pvCheck	Ja. Op een onbekend id doet een pvCheck en bewaart het product	Nee. Het mandje uit de OCI-hook of de webservice wordt niet bewaard	Ja
Cebeo, VanOirschot, FittingShop	Geen lokale producttabel, alles live	–	–	–	–
2BA	Heeft een product-tabel in de migraties, maar gebruikt ze niet. Alles live	–	–	–	–
Hörmann	Geen producten, alleen composities die na het opslaan in de configurator via de hook gesynchroniseerd worden	Hook na opslaan	–	–	Ja

Opzoeken via EAN en productcode

Koppeling	EAN-opzoeking	Waar	Productcode-opzoeking	Waar
Cebeo	Ja	API, barcode wordt als zoekwoord meegestuurd	Ja	API, zoekwoord en productcode
VanOirschot	Ja	API, zoekwoord en barcode	Ja	API
2BA	Alleen via zoekterm	API	Ja	API
FittingShop	Alleen via zoekterm	API vrije tekstzoeker	Ja	API, zoeker en op id
Würth	Ja	Lokale database	Ja	Lokaal
TechnischeUnie	Ja	Lokale database	Ja	Lokaal
STG	Ja	Lokale database	Ja	Lokaal
Rexel	Ja	Lokale database	Ja	Lokaal
Viessmann	Ja	Lokale database	Ja	Lokaal
Desco	Ja	Lokale database	Ja	Lokaal
Kramp	Ja	Lokale database (CSV via FTP)	Ja	Alleen lokaal, geen remote fallback
RoyalCrown	Ja	Lokale database	Ja	Alleen lokaal, geen remote fallback
Tradeplace	Alleen via zoekterm	Lokale database	Ja	Alleen lokaal
Hörmann	Nee	n.v.t.	Nee	n.v.t.

Samengevat: enkel Cebeo en VanOirschot sturen een EAN effectief naar de leverancier. Bij alle koppelingen met lokale catalogus wordt een EAN van een nog niet gesynchroniseerd of opgevraagd product niet gevonden. Bij Würth weegt dat het zwaarst, want daar komt een product pas in de databank na een eerdere opvraging via artikelnummer of winkelmandje.