Supplier Hub – klantenhandleiding

Core 1.1.0 en Pro Customer 2.2.0 20 oktober 2026 – klantenhandleiding

Met Supplier Hub verbind je je WooCommerce-webshop met leveranciers. Core helpt je verbindingen in te stellen en producten te bekijken. Pro Customer voegt productimport, synchronisatie en ondersteunde orderverwerking toe. Begin met de snelstart en lees daarna het hoofdstuk voor de taak die je wilt uitvoeren. De schermvoorbeelden gebruiken fictieve producten in een werkende testomgeving. De plugin volgt de WordPress-taalinstelling; in deze ene handleiding kies je bovenaan Nederlands of Engels.

Ondersteunde connectoren

Supplier Hub heeft instelbare connectoren voor de onderstaande formaten. De aansluiting moet passen bij de documentatie van de leverancier. Er is geen garantie dat ieder leverancierssysteem aansluit.

Authenticatie bij REST/JSON: geen authenticatie, HTTP Basic, vast Bearer-token, API-sleutel in een instelbare X-header, of een HTTPS-login met JSON POST die een tijdelijk Bearer-token oplevert. CSV/XML ondersteunt de eerste vier methoden. De token-login is geen volledige OAuth2-implementatie.

Niet standaard ingebouwd: SOAP/WSDL, GraphQL, FTP/SFTP, EDI/EDIFACT, cXML, inkomende leverancierswebhooks, WebSockets, volledige OAuth2-aanmeldstromen, mTLS-klantcertificaten en bijzondere HMAC-ondertekening. Hiervoor kan een afzonderlijke connectoruitbreiding nodig zijn. Een eerder afgegeven JWT kan als Bearer-token worden gebruikt.

Catalogus bekijken, nieuwe producten importeren, bestaande producten synchroniseren en orders versturen zijn afzonderlijke mogelijkheden. Een geslaagde catalogustest bewijst geen werkende orderroute. De Pro-abilities voor MCP zijn een bedieningskoppeling op de eigen WordPress-site via een afzonderlijke MCP-server; ze voegen geen leveranciersprotocol toe.

Snelstart: begin veilig met lokale testdata

Doel: leren configureren en bladeren zonder leveranciersverkeer. Voor een lokale conceptimport is ook Pro nodig. Op een externe testsite hoort de beheerder vooraf de site, back-up en mutaties goed te keuren.

1. Maak een herstelbare back-up van database en bestanden. Controleer dat terugzetten mogelijk is.
2. Activeer WooCommerce en vervolgens Core 1.1.0. Installeer voor import daarna de bijpassende Pro Customer. Customer en Owner zijn alternatieven; activeer ze niet naast elkaar.
3. Open Supplier Hub > Leveranciers; de menu’s volgen je WordPress-taalinstelling.
4. Geef de leverancier de naam Mijn lokale test. Kies Lokale testdata / Local test data, scenario baseline, en sla de verbinding eerst als inactief concept op.
5. Open de opgeslagen leverancier en voer de verbindingstest uit. De verwachte uitkomst noemt lokale testdata. Dit is geen leveranciers-API-test.
6. Activeer deze testleverancier en open Live catalogus / Live catalogue. Blader naar de volgende pagina en zoek exact op DEMO-001.
7. Voor een uitsluitend lokale proef met Pro: stel bij de importinstellingen afbeeldingen niet verplicht voor deze fictieve bron; de testbron levert geen echte afbeeldingen. Laat de beschrijvingscontrole aan. Deze keuze geldt alleen voor de lokale demonstratie.
8. Selecteer één product, start de conceptimport en volg Imports & synchronisatie. Open het resultaat in Producten. Het product hoort concept te zijn, met bronkoppeling en leveranciersvoorraad, zonder automatisch bedachte verkoopprijs.
9. Vul eigen titel, tekst en verkoopprijs in. Herhaal dezelfde import. Er hoort één gekoppeld product te blijven bestaan; eigen verkoopgegevens blijven behouden.

Veilig herstel: stop bij een fout en lees de taakmelding. Publiceer niets om een test te laten slagen. Een ontbrekende afbeelding is bij deze fictieve bron verwacht. Gebruik bij echte leveranciers passende eigen instellingen en controleer de rechten op hun media.

1. Wat Core en Pro doen

Core is de gratis verbindings- en cataloguslaag. Je kunt leveranciersprofielen bewaren, authenticatie en veldkoppelingen controleren, cataloguspagina’s bekijken en waar ondersteund exact zoeken. Core bevat geen product- of leveranciersquotum, commerciële activatie of private updater. De oude bediening voor het opbouwen van een permanente SQL-catalogusindex is verwijderd. Bestaande historische tabellen zijn geen opdracht om een nieuwe index te bouwen.

Pro voegt conceptimport naar WooCommerce, lokale mediaopslag, gerichte voorraad-/inkoopprijssynchronisatie en geconfigureerde betaalde-orderverwerking toe. Pro Customer gebruikt reguliere klantrechten. Pro Owner bevat een afzonderlijke, aan de bevoegde eigen installatie gebonden eigenaarstoekenning. Gebruik Owner niet als klantlicentie.

Orderverzending is een afzonderlijke capability van een geconfigureerde orderconnector. Een geslaagde productverbinding bewijst geen werkende order-API. Deze release bouwt geen nieuwe combinatie van verzendtarieven voor gemengde bestellingen. Beloof die functionaliteit niet aan klanten.

2. Vereisten en installatie

Benodigd: PHP 8.1 of hoger, WordPress 6.8 of hoger, WooCommerce 10.1 of hoger en de bijpassende Core/Pro-versies. De lokale acceptatie gebruikt PHP 8.1.34, WordPress 7.1.3, WooCommerce 11.2.1 en MariaDB 11.4.5. Dat bewijst geen test op iedere tussengelegen WordPress-/WooCommerce-versie. Sodium is nodig voor versleutelde gegevens en ondertekende rechten; ZipArchive voor ZIP-verwerking; XMLReader voor XML; GD voor de geteste beeldverwerking.

Doel: installeren zonder configuratie of productdata te verwijderen.

1. Controleer siteadres, versies, vrije ruimte en een herstelbare back-up.
2. Open Plugins > Nieuwe plugin > Plugin uploaden. Upload Core en kies bij een bestaande installatie voor vervangen.
3. Activeer Core. Controleer de versie bij Plugins en open Supplier Hub.
4. Upload vervolgens Pro Customer en vervang de bestaande Pro indien van toepassing. Controleer ook die versie.
5. Open Systeemstatus & ondersteuning en controleer de afhankelijkheden. Een ontbrekende of te oude Core hoort Pro tegen te houden.
6. Download/open de meegeleverde actuele handleiding en doorloop de snelstart op de goedgekeurde testomgeving.

Verwachte uitkomst: Core 1.1.0 en Pro 2.2.0 zijn zichtbaar; bestaande leveranciers en bronkoppelingen blijven bestaan. Herstel: vervang de code door de vooraf bewaarde passende set. Gebruik geen uninstall als upgrade- of rollbackmethode. Een codearchief alleen is geen databaseback-up.

De uitgever verzorgt de instellingen die nodig zijn voor klantactivatie en updates. Je hoeft daarvoor geen broncode te bewerken. Gebruik de passende installatiebestanden en activatiegegevens van de uitgever. Ontbreken die gegevens, neem dan contact op voordat je met een nieuwe klantinstallatie begint.

3. Eerste ingebruikname

Begin met lokale testdata, vervolgens met één echte inactieve leverancier en pas daarna met één goedgekeurd conceptproduct. Laat automatische orders uit zolang de orderroute niet afzonderlijk is geaccepteerd. De plugin doet bij openen van het leveranciersdashboard geen leveranciers-API-test.

Maak vooraf onderscheid tussen drie verantwoordelijkheden: jij beheert winkelteksten, verkoopprijzen en publicatie; de leverancier levert bronidentiteit, inkoopprijs en voorraadwaarneming; de uitgever beheert softwareversies en licentierechten. Een voorraadgetal is geen reservering bij de leverancier.

Controle voordat je uitbreidt: je kunt een leverancier bewaren, opnieuw openen, testen en gericht terugvinden. Je kunt een mislukte taak herkennen en een gekoppeld concept onderscheiden van een handmatig product. Bewaar daarbij geen geheimen in schermafbeeldingen of vrije notities.

4. Leverancier bewaren, pauzeren en testen

Menu: Supplier Hub > Leveranciers. De menu’s volgen je WordPress-taalinstelling.

1. Geef een herkenbare naam en kies het passende connectortype.
2. Neem HTTPS-endpoint, authenticatietype, paginering en veldpaden over uit de leveranciersdocumentatie. Raad geen SKU- of orderendpoint.
3. Vul credentials alleen in de daarvoor bestemde velden in. Lege geheime velden bij bewerken behouden de opgeslagen waarde; de expliciete wisoptie verwijdert die waarde.
4. Sla eerst inactief op. Open daarna de opgeslagen verbinding opnieuw.
5. Gebruik de veilige responsepreview voor veldkoppelingen en daarna de algemene verbindingstest.
6. Activeer pas wanneer het juiste bronprofiel is gecontroleerd. Bewaren van een profiel of interval is geen opdracht tot downloaden of importeren.

Verwachte uitkomst: de status noemt het type test en het tijdstip. Een gewijzigde endpoint- of credentialconfiguratie maakt eerder succes ongeldig voor de nieuwe configuratie. De historie blijft in het log. Herstel: zet de verbinding terug op inactief, corrigeer het profiel en test opnieuw.

Sommige koppelingen hebben naast de catalogusverbinding een afzonderlijke productcontrole. Die controle vraagt één exact product op. Opgeslagen inloggegevens zijn nog geen geslaagde test. De status bewaart het type test en tijdstip; een uitgebreid voorbeeldresultaat kan na tien minuten verdwijnen. Dat betekent niet dat de test opnieuw is mislukt.

Pauzeren van catalogus of leverancier kan nieuwe aankopen van gekoppelde producten blokkeren, ook in een bestaande winkelwagen. Bestaande orders worden niet verwijderd. Wijzig dit bewust en controleer de gevolgen voor klanten; pauzeer niets alleen om een dashboard op te schonen.

5. Catalogus, zoeken en bronleeftijd

Doel: beoordelen wat de bron levert zonder WooCommerce-producten aan te maken.

1. Open Live catalogus, kies de leverancier en laad een pagina.
2. Gebruik vorige/volgende of de beschikbare paginering. Paginering is begrensd door het connectorprofiel.
3. Gebruik Exact zoeken met de volledige externe product-ID wanneer de bron die mogelijkheid ondersteunt.
4. Controleer identiteit, titel, EAN/GTIN, valuta, inkoopprijs, voorraad en beschikbare beschrijving/media.
5. Lees de bronleeftijd en eventuele cache-/nachtvenstermelding voordat je conclusies over actualiteit trekt.

Waar beschikbaar gelden categorie- en tekstfilters op de tijdelijke feedcache. Een paginagebonden API-filter is geen onbeperkte zoekopdracht door de hele leverancier. Een bron zonder exact endpoint kan bladeren ondersteunen terwijl actuele import niet beschikbaar is. Een ontbrekend resultaat hoort geen ongeveer overeenkomend ander product te selecteren.

Een koppeling kan een aparte bron voor beschrijvingen en afbeeldingen gebruiken, naast een product-API voor actuele prijs en voorraad. Voor import moeten beide bronnen bruikbaar zijn. Exact zoeken of importeren start niet ongemerkt een volledige catalogusdownload wanneer brongegevens ontbreken of te oud zijn.

Bij een daarvoor geschikte volledige-lijstkoppeling gebruiken exact zoeken en conceptimport een complete opgeslagen catalogus binnen de toegestane bronleeftijd, nooit ouder dan 24 uur. Dit is een momentopname en geen realtime voorraadreservering. Andere verbindingen kunnen een afzonderlijke actuele SKU-API nodig hebben.

Een catalogusregel is nog geen winkelproduct. Als je een importvoorbeeld via een gekoppelde assistent bekijkt, kan dat voorbeeld uit eerder opgeslagen gegevens komen. De daadwerkelijke import voert de benodigde actuele productcontrole alsnog uit.

6. Conceptimport, identiteit en eigen wijzigingen

Voorwaarden: Pro, een geaccepteerde exacte bron, juiste valuta, bruikbare content en afzonderlijk akkoord voor import op een externe site.

1. Selecteer maximaal 25 producten voor één taak. Gebruik voor de eerste proef één product.
2. Controleer leverancier en volledige externe ID; vergelijk ook de EAN als de bron die levert.
3. Start de conceptimport en noteer het taaknummer.
4. Open Imports & synchronisatie. Wacht op een eindstatus en lees fouten per product.
5. Open het gekoppelde WooCommerce-product. Controleer conceptstatus, eigen verkoopprijs, btw, beschrijving, lokale afbeeldingen en bronkoppeling.
6. Herhaal bij een lokale acceptatietest dezelfde externe ID. Controleer dat één bronkoppeling en één winkelproduct overblijven.

Een nieuwe import kopieert de initiële beschrijving en waar ingesteld media. De verkoopprijs wordt niet automatisch uit de inkoopprijs afgeleid. Synchronisatie onderhoudt leveranciersvelden; een eigen titel, tekst, afbeelding, verkoopprijs of publicatiestatus blijft van de winkelier. Een handmatig product met toevallig dezelfde leveranciers-SKU hoort niet te worden overgenomen.

Prijs en voorraad moeten geldige getallen zijn. Een voorraad van nul betekent dat het product niet beschikbaar is. Ontbrekende waarden en ja/nee-waarden worden niet als een betrouwbare prijs of een exact voorraadaantal behandeld. De toegestane precisie en nulprijs hangen af van de koppeling. Controleer een nulprijs altijd bij de bron; gebruik nooit een ontbrekende of ongeldige inkoopprijs als basis voor je verkoopprijs.

Herstel: beoordeel de fout en de bestaande bronkoppeling voordat je herhaalt. Maak geen extra handmatig product om een mappingfout te omzeilen. Een onzekere leveranciersorder is een ander probleem dan een herhaalbare lokale import en mag nooit blind opnieuw worden verstuurd.

7. Intervallen en werkelijke actualiteit

Menu: Leveranciers > Instellingen wijzigen.

Bij een algemene API die een volledige lijst teruggeeft, geldt de opgeslagen cataloguskeuze. Sommige koppelingen hebben een eigen dagelijkse standaard. Als je bewust de gedeelde webshopbron inschakelt, heeft het gekozen webshopinterval voorrang waar de koppeling dat ondersteunt. Het leveranciersscherm toont het effectieve interval en de reden. Een update schakelt deze optie niet automatisch in.

Normale volledige bladerfeeds worden tussen 01:00 en 06:00 in de WordPress-sitetijdzone verwerkt en niet vaker dan eenmaal per 24 uur opnieuw gestart. De aparte gedeelde-lijstoptie is een bewuste uitzondering op zowel nacht- als daginterval. Stem hogere frequentie af met de leverancier; een volledige download per uur kan veel verkeer veroorzaken.

Procedure: open de leverancier, kies de intervallen, laat de gedeelde-lijstoptie uit tenzij bewust gewenst, sla op en open opnieuw. Controleer de opgeslagen keuze én het effectieve interval. Een uurlijkse WooCommerce-tick op een dagelijkse snapshot levert geen uurlijks nieuwe leverancierswaarneming op.

Bij een mislukte vernieuwing blijft de laatste complete snapshot behouden. Dat bewijst geen actualiteit: een te oude bron wordt voor de relevante handelsactie geweigerd. Verhoog geen limieten of frequenties om een fout te verbergen.

8. Orders, sandbox en tracking

Doel: een orderroute voorbereiden zonder een echte order te versturen. Menu: Supplierorders & sandbox.

1. Controleer welke leverancier de gekozen producten bezit en welke orderconnector daarvoor is geconfigureerd.
2. Controleer create- en statusendpoint, omgeving, authenticatie, adresvelden, product-ID en responsepaden.
3. Gebruik dry-run of sandbox uitsluitend voor de functies die deze connector werkelijk ondersteunt. Een payloadpreview bewijst geen externe acceptatie.
4. Laat de globale en leveranciersspecifieke productiebevoegdheid uit tot concrete toestemming aanwezig is.
5. Plan de eerste echte proef met leverancierbevestiging, bedrag en adres. Volg daarna betaling, één geaccepteerde supplierorder, factuur, tracking en ontvangst afzonderlijk.

De huidige productievoorwaarde vraagt een echte WooCommerce payment_complete-gebeurtenis met passend bewijs van livebetaling, bedrag, valuta, referentie en activeringstijd. Een testbetaling en een handmatig gewijzigde orderstatus voldoen niet. De betaalprovider moet door de gebruikte betalingscontrole worden ondersteund.

Dezelfde WooCommerce-order/leveranciercombinatie krijgt een duurzame reservering. Dubbele callbacks mogen niet tweemaal verzenden. Bij een timeout of verloren bevestiging blijft de uitkomst onzeker. Veilig herstel: controleer eerst het leveranciersportaal en de lokale registratie. Verwijder de reservering niet om een nieuwe verzending af te dwingen.

Een stagingtoekenning geeft geen recht op echte supplierorders. Statuspolling staat los van nieuwe verzending. Tracking verschijnt waar ondersteund in Supplier Hub en interne ordernotities; deze release belooft geen automatische klanttrackingmail of automatisch voltooien van WooCommerce-orders. Een gemengde bestelling wordt per leverancier beoordeeld, maar dit voegt geen nieuwe verzendkostenberekening toe.

9. Dagelijks beheer en achtergrondwerk

Open Systeemstatus & ondersteuning en bekijk vervolgens de relevante taak en het log. Controleer de laatste geslaagde sync, bronleeftijd, taakstatus en fouttijdstip afzonderlijk.

Action Scheduler beschikbaar betekent dat de bibliotheek bestaat. Een recente afgeronde actie bewijst haar uitvoering, maar niet een hele nachtcyclus zonder bezoek. Als WP-Cron is uitgeschakeld, moet de host een passende onafhankelijke aansturing leveren. Verander servercron alleen na akkoord en op basis van aantoonbare oorzaak.

De totale tijdelijke feedcachelimiet staat onder systeemstatus: 64-8192 MB, standaard 512 MB. Laat ruimte voor downloads, uitgepakte bestanden en generatiepublicatie. De tijdelijke cataloguscache kan maximaal 30 dagen leesbaar zijn; dit maakt handelsgegevens niet automatisch 30 dagen geldig. Oude losse bestanden worden begrensd opgeruimd. De host kan strengere quota hebben dan WordPress ziet.

Herstel bij achterstand: noteer hook, taak-ID, geplande tijd, begin/einde en foutcode. Beoordeel een specifieke veilige vervolgstap. Gebruik geen algemene queue-run of watchdogrun als cosmetische reparatie; daarin kunnen echte orders en mails zitten.

10. Aankoop, licentie, verlenging, support en verhuizing

Je koopt Supplier Hub Pro via het product dat op de Supplier Hub-website staat. Reken het digitale product af als aparte bestelling. Na bevestigde afrekening ontvang je één sitegebonden licentie en een PDF-factuur per e-mail. De aankoop- en verlengmails bevatten Nederlands met Engels eronder. Er wordt geen fysiek pakket verstuurd.

Open Mijn account > Downloads voor Core, Pro Customer en deze handleiding. De knop in de mail verwijst rechtstreeks naar die tab. De handleiding is één document met taalkeuze; bewaar de oorspronkelijke aankoopbestanden. Downloads zijn beveiligd en staan niet als openbare mediabestanden online.

Verlengen behoudt dezelfde licentie en website. De nieuwe periode is twaalf maanden vanaf de bestaande toekomstige einddatum, of vanaf de verlenging wanneer de oude periode al is afgelopen. Er komt geen tweede licentie en geen automatische incasso. Kies na verlengen Status controleren en laat WordPress daarna opnieuw op updates controleren. Oude herinneringen vervallen; de nieuwe einddatum krijgt een nieuwe herinneringscyclus.

Menu: Supplier Hub > Licentie & updates (Engels: Licence & updates). De sitebeheerder heeft passende beheerrechten nodig.

1. Gebruik de reguliere klantcode die de uitgever via een goedgekeurde route verstrekt.
2. Controleer het siteadres en kies productie of vooraf goedgekeurde staging.
3. Activeer en controleer de ondertekende lokale toekenning en update-einddatum.
4. Beoordeel support afzonderlijk; een updateperiode kent niet automatisch persoonlijke ondersteuning toe.

Na een geldige activatie blijven de bestaande operationele functies werken bij verlopen updates of uitval van de licentieserver. De updateperiode duurt twaalf kalendermaanden. Intrekking van toekomstige updates wist de bewaarde permanente lokale runtime-toekenning niet. Zonder eerdere geldige toekenning of na verlies daarvan is eerste activatie/herstel een ander geval: daarvoor is hulp van de uitgever nodig.

De licentiecontrole wordt dagelijks gepland. De plugin controleert zowel je recht op een update als de herkomst en integriteit van het updatepakket. Wordt een pakket geweigerd, stop dan de update en neem contact op met de uitgever. Pas de beveiligingsinstellingen niet aan om de weigering te omzeilen.

Een verhuizing naar een andere klantwebsite vraagt gecontroleerde herbinding. Een verhuizing van de backend behoudt het blijvende API-adres en contract; de klant hoort daarvoor geen handmatige patch of nieuwe activatie nodig te hebben. Een staginguitnodiging is vooraf aan de exacte site gebonden. Verstuur nooit een private sleutel of volledige licentiecode in een bugrapport.

11. Bijwerken, back-up en herstel

Voorwaarden: passende Core/Pro-set, bekende werkende vorige set, back-up en akkoord voor de externe site.

1. Controleer lopende taken en leg bestaande versies en instellingen vast.
2. Maak en controleer de herstelbare database-/bestandsback-up. Een download van plugin-ZIP’s vervangt dit niet.
3. Werk Core eerst bij, daarna de passende Pro-variant. Vervang; verwijder niet vooraf.
4. Lees beide versies terug. Open dashboard, één gekoppeld product en een gerichte controle.
5. Controleer dat instellingen en bronkoppelingen behouden zijn. Start geen volledige feed als rooktest.

Bij falen: beoordeel of terugzetten van de code volstaat. Herstel zo nodig de passende code en de gecontroleerde data-back-up. Houd nieuwe mutaties sinds de back-up bij. Een naar de leverancier verzonden order wordt niet ingetrokken door oude code terug te plaatsen. Een oude database terugzetten kan recente reserveringen verliezen; voorkom daardoor dubbele externe effecten.

Bij verlies van lokale licentierechten: stel bestaande product-/orderdata veilig en laat de uitgever de exacte activatie herstellen. Verwijder geen licentie- of bronregistraties als algemene foutoplossing. Test back-up/herstel eerst afgeschermd.

12. Fouten oplossen

Neem contact op wanneer een gedocumenteerde correcte configuratie herhaald faalt, wanneer bronidentiteit conflicteert of een externe orderuitkomst onzeker is. Geef versie, proces, taak-ID, tijdstip, foutcode en geschoonde reproductiestappen.

13. Privacy, support en begrippen

Menu: Systeemstatus & ondersteuning > Bug melden.

1. Beschrijf doel, stappen, verwacht resultaat en werkelijk resultaat.
2. Kies alleen noodzakelijke technische diagnostiek. Je kunt het rapport eerst bekijken.
3. Verwijder zichtbare klantgegevens uit een schermafbeelding. De plugin anonimiseert afbeeldingen niet automatisch.
4. Kies Verstuur bugrapport. Je ingevulde melding en eventuele bijlage gaan rechtstreeks naar support@the-goods.nl. Een bestand downloaden of zelf een e-mail opstellen is niet nodig.
5. Bewaar de referentie. Bij onzekere verzending verstuur je dezelfde melding niet opnieuw; neem contact op met support en vermeld de referentie. Aanbieding aan het mailsysteem bewijst niet dat een medewerker de mail al heeft gelezen.

Algemene vragen: info@the-goods.nl. Technische ondersteuning: support@the-goods.nl.

Core bewaart configuratie, versleutelde credentials en lokale catalogus-/taakgegevens. Pro bewaart daarnaast bronkoppelingen en orderstatus. Een echte supplierorder kan naam, afleveradres, contactgegevens, product-ID’s en aantallen naar de ingestelde leverancier sturen. De winkelier blijft verantwoordelijk voor transparantie richting klanten en voor de gekozen leveranciersroute. Normale logs hebben een beperkte bewaartermijn; een licentiemigratie-export is geen supportbestand.

Gebruik de handleiding die bij jouw geïnstalleerde versie hoort. Neem bij twijfel over een instelling contact op met de uitgever voordat je deze wijzigt.