Aan de slag als fulfilmentbedrijf (API)
Deze gids is voor fulfilmentbedrijven (3PL's) die inpakken en verzenden voor meerdere webshops en die deze webshops digitaal Payment on Delivery willen bieden, terwijl ze hun eigen magazijnbeheersysteem (WMS) houden. Uw WMS blijft orders ontvangen zoals nu. Voor Payment on Delivery-orders vraagt het via de QrX Public API bij QrX het vervoerderslabel en het QrX-betaallabel op. Aan de deur scant de shopper de QrX QR-code en betaalt via de eigen betaalprovider van de webshop. QrX houdt het geld nooit aan, en het loopt ook nooit via uw bedrijf.
In PortalX is dit de inrichtingsroute Ik ben een fulfilmentbedrijf en koppel mijn eigen WMS via de API in de Aan de slag-gids (Instellingen > Zakelijk > Aan de slag).
Kies uw accountmodel
QrX werkt met verkoopkanalen (handelaarskanalen). Elk kanaal heeft een eigen betaalprovider, API-sleutel, huisstijl en standaardvervoerder. Er zijn twee manieren om uw klanten in te richten:
U beheert de klanten (meest gebruikelijk): uw bedrijf heeft één QrX-account met één handelaarskanaal per klantwebshop. U koppelt de eigen betaalprovider van elke klant aan het kanaal van die klant, zodat betalingen aan de deur rechtstreeks aan de klant worden uitbetaald. U krijgt één QrX-factuur voor alle klanten.
De klanten hebben een eigen QrX-account: elke webshop meldt zich zelf aan, koppelt zijn betaalprovider en geeft uw bedrijf toegang met Partnertoegang (Instellingen > Zakelijk > Partnertoegang, scope Reseller operations of Carrier operations). Uw WMS gebruikt dan de API-sleutel van het kanaal van de klant, of u koppelt via QrX Connect (zie "QrX Connect: uw platform koppelen met OAuth").
Spreek met QrX af welk model u gebruikt voordat uw eerste klant live gaat. Partnervergoedingen voor fulfilmentbedrijven worden per partnerschap afgesproken; zie "Partners en hoe u partner wordt van QrX".
1. Richt je bedrijf in
Bedrijfsgegevens. QrX bewaart de bedrijfsnaam, het adres en het btw- of KvK-nummer uit uw aanmelding. Ontbreekt er iets of is er iets veranderd, klik dan in de stap op Vraag het aan QrX en QrX vult het voor u aan. De stap wordt afgevinkt wanneer alle gegevens bekend zijn.
Afzenderadres van het magazijn met een korte code voor API-aanroepen: Instellingen > Bedrijfsvoering > Adressen.
Team: nodig uw collega's van magazijn en IT uit in Instellingen > Team & Toegang > Gebruikers, en geef ze rollen in Rollen en rechten.
2. Verzend voor je klantwebshops
Eén kanaal per klantwebshop: Instellingen > Zakelijk > Handelaarskanalen. Gebruik de winkelnaam van de klant, zodat shoppers deze herkennen op de betaalpagina.
Koppel de betaalprovider van elke klant in het tabblad Betalingen van het kanaal (Stripe, Mollie of MultiSafePay). De klant doorloopt de onboarding bij de provider met de eigen bedrijfsgegevens.
Huisstijl per klant: logo en kleuren op het kanaal, een Track and Trace-sjabloon (Instellingen > Bedrijfsvoering > Track & Trace) en berichtsjablonen, zodat shoppers de webshop zien en niet het magazijn.
3. Vervoerders en printen koppelen
Vervoerders: Instellingen > Bedrijfsvoering > Vervoerders. Gebruik uw eigen vervoerderscontracten of het QrX UPS Payment on Delivery-account. Koppel een account aan alle kanalen of aan één klantkanaal.
Labelformaat: kies PDF of ZPL en, voor UPS, Standard (vervoerderslabel plus QrX-betaallabel) of Extended (één gecombineerd label). Print de complete set voor elk Payment on Delivery-pakket.
Als uw WMS zelf print, gebruikt het de labels die de API teruggeeft. Koppel anders PrintNode in Instellingen > Voorkeuren > Afdrukken.
4. Koppel je systeem
API-sleutel per klantkanaal: Handelaarskanalen, open het kanaal, tabblad Instellingen, API-sleutel opnieuw genereren (Regenerate API Key). Bewaar de sleutels versleuteld op uw server, één per klant.
Token: POST /api/v1/auth/token met de header QrX-MerchantChannel-API-Key.
Zoek codes op met /api/v1/reference/shipping-methods en /api/v1/reference/senders. Gebruik nooit vaste id's van een andere klant.
Maak de transactie met het label aan in één aanroep: POST /api/v1/transactions met type Payment voor Payment on Delivery, of No payment voor vooraf betaalde orders, plus een parcel-blok met CreateCarrierLabel. Sla het teruggegeven transactie-id en de labels op voordat u het pakket als ingepakt meldt, zodat een nieuwe poging nooit een tweede label koopt.
Webhooks: Instellingen > Geavanceerd > Webhooks. Abonneer u op transactie betaald, geannuleerd en zendinggebeurtenissen, per kanaal of voor alle kanalen. Controleer de header X-QrX-Signature.
Test van begin tot eind in testmodus voor elke klant voordat u live gaat: order binnen, label geprint, testbetaling aan de deur, webhook ontvangen.
5. Live gaan per klant
Vraag QrX de live modus te activeren (Chat met QrX in de gids).
Zet één klant tegelijk om, en houd voor die klant de oude werkwijze aan totdat de eerste live betalingen aan de deur zijn bevestigd.
Goed om te weten
Een geannuleerde transactie kan niet meer worden betaald, gelabeld of uitgeleverd. Annuleer in QrX wanneer de webshop annuleert.
HTTP 201 bij het aanmaken is geen bewijs van betaling. Wacht op de webhook voor betaald.
Uw partnervergoeding wordt vastgelegd in uw partnerovereenkomst; er is geen algemeen gepubliceerd tarief.
Voorraad en picken blijven in deze route in uw eigen WMS. Wilt u uw magazijn liever in QrX beheren? Zie "Aan de slag als fulfilmentbedrijf met het QrX WMS".
Wanneer neemt u contact op met ons supportteam
Neem contact op met QrX om uw accountmodel en partnervoorwaarden af te spreken, om uw labeluitvoer en printer te laten certificeren, wanneer de onboarding bij de betaalprovider van een klant vastloopt, of wanneer webhooks blijven mislukken.