> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# PeakWMS koppelen
> Stel Zippendo in als leverancier van verzendlabels voor je PeakWMS-magazijn, stap voor stap met schermafbeeldingen, van de eerste klik in Zippendo tot het eerste verzendlabel dat aan de inpaktafel wordt geprint.
Draait je magazijn op [PeakWMS](https://peakwms.com), dan hoeven je inpakkers Zippendo nooit te openen. Ze pakken een pakket in bij PeakWMS, PeakWMS vraagt Zippendo om het verzendlabel en het verzendlabel komt uit de printer aan de inpaktafel. Zippendo stuurt de zending naar de vervoerder, volgt de track & trace en toont de zending bij **Zendingen** zoals alle andere.
Deze tutorial loopt met schermafbeeldingen door de installatie. De naslagpagina [PeakWMS](/docs/nl/integrations/peakwms) legt elke PeakWMS-instelling uit en wat je moet doen als er iets misgaat.
Er wordt niets in PeakWMS geïnstalleerd. Je maakt een koppeling aan in Zippendo, kopieert een API-token en een paar webadressen naar PeakWMS en vertelt PeakWMS welk verzendproduct elke verzendmethode gebruikt. Dat kost ongeveer twintig minuten, eenmalig.
## Voordat je begint
* Je kunt instellingen in PeakWMS wijzigen en je weet waar de forwarders staan. Een forwarder is de naam van PeakWMS voor de instelling van een vervoersbedrijf.
* Je webshop is gekoppeld aan Zippendo en de checkout toont al de verzendmethoden van Zippendo. Zie [Verkoopkanalen koppelen](/docs/nl/tutorials/connect-order-channels).
* Er bestaat minstens één [verzendregel](/docs/nl/tutorials/shipping-rules) in Zippendo.
## 1. PeakWMS zoeken in Zippendo
Klik in de zijbalk op **Apps en integraties** en dan op het tabblad **Catalogus**. Onder **Integraties** vind je de systemen die met Zippendo verbinden en het iets laten doen. PeakWMS is er een van, met een knop **Koppelen**. **Meer lezen** op de kaart opent de eigen helppagina's van PeakWMS.
## 2. De koppeling aanmaken
Het venster **PeakWMS koppelen** vraagt om een **Naam** en een **Account-ID (optioneel)**.
Iets als "PeakWMS-magazijn Køge". Heb je meerdere magazijnen, maak dan per magazijn een koppeling en noem elke koppeling naar de locatie, zodat je later kunt zien welke een probleem had.
Ga je in PeakWMS een Account-ID invullen, typ dan hier dezelfde waarde. Het is een vangnet: komen de twee niet overeen, dan weigert Zippendo het verzoek. Zo kan een forwarder die met de webadressen van een ander magazijn is ingesteld, geen verzendlabels maken op de verkeerde koppeling. Je kunt het leeg laten.
Gebruikt je organisatie merken, dan vraagt het venster ook om het **Merk** waarvoor dit magazijn verzendt.
Je ziet **WMS-koppeling aangemaakt** en de pagina van de nieuwe koppeling gaat open.
## 3. Kopieer het API-token terwijl het op het scherm staat
De pagina van de koppeling toont het **API-token** precies één keer, direct nadat je de koppeling hebt aangemaakt. Klik nu op de kopieerknop ernaast en bewaar het token ergens veilig tot je het in PeakWMS hebt gezet.
Verlaat je de pagina zonder te kopiëren, dan kan het token niet opnieuw worden getoond. Klik op **Token vervangen** om een nieuw token te krijgen. Het oude werkt op dat moment niet meer, dus PeakWMS heeft het nieuwe token nodig voordat je inpakkers weer kunnen printen.
Met het API-token kan PeakWMS alleen zendingen aanmaken en lezen. Het kan je vervoerdersaccounts, adressen, bestellingen of facturatie niet zien.
## 4. Kopieer de webadressen naar PeakWMS
Onder het token toont **URL's voor je WMS** één webadres voor alles wat PeakWMS aan Zippendo kan vragen. Elk adres heeft een eigen kopieerknop.
Schakel nu over naar PeakWMS. Alles in deze stap gebeurt daar, op een nieuwe forwarder:
Voeg in PeakWMS een nieuwe **Forwarder** toe en stel **Provider** in op **Generic**: het soort forwarder dat verzoeken stuurt naar webadressen die je zelf invult. Kun je het scherm niet vinden, dan loopt het eigen [helpcentrum](https://help.peakwms.com/support/solutions) van PeakWMS je erdoorheen. De instelling is hetzelfde, welk vervoersbedrijf je ook gebruikt.
Kopieer elk adres uit Zippendo naar het PeakWMS-veld met dezelfde naam: **Create shipping label** (verplicht), **Tracking** (aanbevolen) en de optionele velden die je wilt, zoals **Create return label**, **QR code label**, **Existing shipment** en **Label used**. Laat **Cancel shipment** leeg. Zippendo toont daar "Niet ondersteund. Laat dit veld leeg.", omdat het een verzendlabel niet bij de vervoerder kan annuleren.
**API key** is het API-token dat je in stap 3 hebt gekopieerd. **Auth scheme** is **Bearer**, dat is gewoon hoe PeakWMS het token doorgeeft. **Account ID** is de waarde die je in stap 2 in Zippendo hebt getypt, als je er een hebt gebruikt.
De volledige tabel met forwardervelden, inclusief welke optioneel zijn, staat op de pagina [PeakWMS](/docs/nl/integrations/peakwms) onder "Ze in PeakWMS invullen".
## 5. Stel bij elke verzendmethode in PeakWMS de Host-ID in
In PeakWMS heeft elke verzendmethode een **Host-ID**. Daarmee vertelt PeakWMS aan Zippendo welke vervoerder, welk verzendproduct en welke verzendregel er moeten worden gebruikt wanneer een pakket is ingepakt. Je stelt het in bij PeakWMS, op de verzendmethode zelf, niet in Zippendo.
Is je webshop gekoppeld aan Zippendo, dan heeft elke bestelling de verzendmethode die de klant koos als een code zoals `postnord:PNL13:rule_01HZX9K2QF`: de vervoerder, het verzendproduct en de verzendregel. Plaats een testbestelling in je webshop, open hem en kopieer die code van de verzendmethode.
Open de bijbehorende verzendmethode in PeakWMS en plak de code in het veld **Host ID**. Herhaal dit voor elke verzendmethode die je webshop aanbiedt. Zippendo herkent deze codes zelf, dus daarvoor hoef je in Zippendo niets in te stellen.
Als de klant een afhaalpunt heeft gekozen, eindigt de code op de bestelling met een streepje (`|`) en het afhaalpunt, zoals `postnord:PNL13:rule_01HZX9K2QF|1234567`. Plak alleen het deel **vóór** het streepje als Host-ID. PeakWMS splitst de code daar zelf en geeft het afhaalpunt door aan Zippendo, dus één Host-ID dekt elk afhaalpunt.
Komt een Host-ID nooit overeen, of wordt steeds de verkeerde vervoerder gebruikt, controleer dan of je bestellingen een veld `peak_shipping_code` hebben, vaak achtergebleven van een verzendapp die je eerder gebruikte. PeakWMS leest dat veld eerst en negeert de code die Zippendo op de bestelling zet. Wie je webshop beheert, kan het leegmaken.
### In plaats daarvan je eigen Host-ID's gebruiken
Je hoeft pas iets in Zippendo te doen als de Host-ID een eigen code is in plaats van die van een webshopbestelling. Dat is zo wanneer bestellingen rechtstreeks in PeakWMS worden ingevoerd, of wanneer je liever codes hebt zoals `GLS_BUSINESS_PARCEL`.
Open in Zippendo de koppeling en ga naar **Host-ID-toewijzingen**. Klik op **Toewijzing toevoegen**, typ je code onder **Host-ID in het WMS** en kies onder **Zippendo-verzendregel** de regel die hij moet gebruiken. Klik op **Toewijzingen opslaan** als de rijen compleet zijn. Een rij zonder verzendregel kan niet worden opgeslagen.
## 6. Stop met het importeren van bestellingen uit die webshop
PeakWMS beheert nu de bestellingen. Als Zippendo ze ook bleef importeren, zouden beide systemen zendingen voor dezelfde bestelling aanmaken en zou je twee verzendlabels betalen. Open **Verkoopkanalen**, open de webshop en schakel onder **Waarvoor je Zippendo gebruikt** de schakelaar **Bestellingen uit deze webshop importeren** uit.
Verzendprijzen en het kiezen van een afhaalpunt bij het afrekenen blijven precies werken zoals voorheen. Alleen het importeren van bestellingen stopt en Zippendo markeert bestellingen in je webshop niet meer als verzonden, omdat PeakWMS dat nu doet.
## 7. Controleren of het werkt
Pak één bestelling in je PeakWMS-testomgeving in en controleer drie dingen: het verzendlabel wordt geprint en toont de vervoerder die je verwachtte, het pakket verschijnt bij **Zendingen** in Zippendo en de track & trace verschijnt op de bestelling in PeakWMS. Zet daarna de adressen in PeakWMS om naar je live-omgeving.
Terug in Zippendo toont het tabblad **Gekoppeld** onder **Apps en integraties** je PeakWMS-koppeling met wanneer PeakWMS voor het laatst iets vroeg, of "Nog niet gebruikt". Als een verzoek mislukte, toont het de melding die je inpakker zag.
## De koppeling pauzeren of verwijderen
Open de koppeling door op de rij op de PeakWMS-kaart te klikken. Schakel **Het WMS verzendlabels laten aanmaken** uit om te voorkomen dat PeakWMS verzendlabels aanmaakt, zonder iets te verwijderen, en schakel het weer in als je klaar bent. **Koppeling verwijderen** onderaan verwijdert de koppeling en het bijbehorende API-token definitief. Zendingen die al zijn aangemaakt, blijven waar ze zijn.
## Goed om te weten
* Een inpakker die dezelfde bestelling twee keer inpakt, krijgt geen twee verzendlabels. Zippendo geeft het verzendlabel terug dat al is gemaakt.
* Retourlabels werken op dezelfde manier. Het adres waar het pakket naartoe terugkomt, is altijd het afzenderadres op je verzendregel, dus het verzendlabel klopt ook als PeakWMS een ander adres heeft vastgelegd.
* Gevaarlijke stoffen worden geweigerd in plaats van verzonden zonder de papieren die ze nodig hebben. Stuur die via een andere forwarder in PeakWMS.
## Gerelateerd
* [PeakWMS](/docs/nl/integrations/peakwms) voor elke PeakWMS-instelling, de regels voor Host-ID's en de meldingen die je inpakkers kunnen zien
* [Verzendregels](/docs/nl/tutorials/shipping-rules) voor de regels waar een Host-ID naar wijst
* [Instellingen voor verkoopkanalen](/docs/nl/how-to/order-channel-settings) voor de schakelaars van de webshop
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.