Doel: Leer hoe je jouw Peoplevox WMS kunt verbinden met het Sendcloud platform
Peoplevox is een Ecommerce Warehouse Management System voor snelgroeiende online retailers die direct naar klanten versturen.
Stap 1: Configureer je templates in Peoplevox
Voordat je Peoplevox als integratie met Sendcloud verbindt, dien je eerst templates te configureren binnen je WMS, door middel van een CSV bestand als template model.
- Log in bij je Peoplevox account.
- Rechtsboven in het menu selecteer je Integration
- Ga naar het tabje Integration Templates en selecteer een template; bijvoorbeeld: "Customer addresses".
- Klik op de Configure knop. Een popup die aangeeft om de CSV file the uploaden zal verschijnen.
- Download en extract de CSV templates die Peoplevox aanlevert hier.
- Upload het correcte CSV bestand, bijvoorbeeld: Als je "Customer Addresses" aan het configureren bent, upload je het CSV bestand met dezelfde naam vanuit het ZIP bestand dat je eerder uit Peoplevox hebt gehaald.
- Zodra je het matchende bestand hebt geüpload, klop je op het tabje Export.
- Match de property namen met de kolommen uit de CSV en klik op save wanneer je klaar bent.
- Complete this step for all of the templates before proceeding to Step 2.
Stap 2: Verbind met Sendcloud
- Ga in je Sendcloud panel naar Instellingen > Integraties en vind Peoplevox in de lijst met integraties. Je kunt ook zoeken door middel van de zoekbalk.
- Klik op "Verbinden" om de verbindingsinstellingen te openen.
- Geef je integratie een naam (bijvoorbeeld de naam van je webshop) en voer je Peoplevox credentials (client ID, username en password) in om de verbinding te authenticeren. Als niet wat wat je credentials zijn of als je hier geen toegang tot hebt, neem dan contact op met Peoplevox.
- Klik op Opslaan.
- Klik op de knop Go to the configuration page. Deze knop wordt beschikbaar zodra je de Peoplevox credentials hebt opgeslagen.
- Je wordt doorgestuurd naar de Peoplevox applicatie site waar twee tabjes beschikbaar zijn: Configuration en Carrier integration.
- Selecteer hier het veld zoals het wordt weergegeven in je Peoplevox SalesOrder entity om te matchen met het klant telefoonnummer, gezien deze getoond wordt in de sales order in Sendcloud.
- Map je bedrijfsnaam bij Company door het te selecteren vanuit het dropdown menu.
- Klik op het tabje Configuration en map je Sendcloud afzendadres aan je Peoplevox afzendadres. Je kunt een afzendadres toevoegen of controleren in je Sendcloud panel door naar Instellingen > Adressen > Afzendadressen te gaan.
-
Selecteer het veld uit de Peoplevox SalesOrder om deze toe te wijzen aan de Service Point Location ID. Dit zal door Sendcloud gebruikt worden om te bepalen welk servicepunt door de klant geselecteerd is bij het afrekenen. Map het PO box nummer veld in de configuratie aan het betreffende veld in Peoplevox. (In het geval van DHL DE, is dit het klantnummer dat door DHL is toegewezen, zodat de klant zijn pakket bij elk DHL servicepunt kan afhalen).
- Activeer de optie Send package type information for dispatch. Deze optie is beschikbaar wanneer de Carrier integratie tab is ingesteld in de volgende stappen. Hierdoor kunnen gegevens over wanneer een nieuwe verzending wordt aangemaakt en wanneer een label wordt aangevraagd worden doorgestuurd naar Sendcloud.
-
Om zendingen buiten de EU te verzenden, zijn douanedocumenten nodig. Om ervoor te zorgen dat het toevoegen van douanegegevens niet voor elke bestelling een handmatig proces wordt, dien je douane-informatie in de configuratie vastleggen. In de sectie Configure customs information vind je jouw standaardinstellingen. Wanneer er geen waarde kan worden gevonden voor je item ("null"), zullen de instellingen die je hier invult worden gebruikt. Zorg ervoor dat je het Type zending en Country of origin selecteert, en een HS-code invult. Bij Configure customs information mapping kun je aangepaste Peoplevox attributen selecteren om dynamisch een veld in Peoplevox te mappen naar een veld in Sendcloud. Op deze manier kunnen de douanegegevens succesvol worden overgezet naar Sendcloud.
Het enige document dat momenteel naar Sendcloud wordt gestuurd is het label. De douanedocumenten (CN23, CP71 en de handelsfactuur) kunnen worden toegevoegd via de Sendcloud Carrier integratie. Wanneer de integratie een Carrier integratie request ontvangt, zal het controleren of het document bestaat en de print template URL retourneren als dat het geval is. Als het document niet bestaat, wordt het gemarkeerd als "niet vereist" in de response van de Carrier integratie.
- Klik op save. Order synchronisatie zal beginnen en alle orders die in de afgelopen 7 dagen zijn gecreëerd, zullen in Sendcloud worden geïmporteerd. Zodra deze zijn geïmporteerd, zullen ze in Sendcloud zichtbaar zijn in het Inkomende order overzicht.
-
Als je een Zebra printer gebruikt, moet je het ZLP printformaat selecteren. Je kunt dit in je Peoplevox account doen door ZLP formaat te selecteren in het dropdown menu.
Beschikbare formaten voor het label zijn: pdf, zpl 203, zpl 300, zpl 600, png 150 and png 300.
- Configureer je checkout verzendmethodes in Peoplevox. Map het veld in Peoplevox dat informatie bevat over de verzendmethode van je checkout. Je kunt verzendregels instellen op basis van de naam van je checkout verzendmethode. Deze verzendregels kan je gebruiken om je verzendproces te automatiseren. Zie ons artikel Verzendregels aanmaken.
Stap 3: Configureer carrier integration instellingen
Wanneer een order in Peoplevox wordt verzonden, worden de ordergegevens automatisch doorgestuurd naar Sendcloud. Het label wordt gegenereerd en geprint in Sendcloud en vervolgens met de trackingnummers teruggestuurd naar Peoplevox.
Om labels en trackingnummers automatisch te laten genereren wanneer een zending wordt aangemaakt, volg je de optionele stappen hieronder om de carrier integratie instellingen te configureren.
Stel je 'carrier integration' toegang in Peoplevox in
- Log in bij Peoplevox
- Verander rechtsboven in het scherm je view naar Integratie
- In de header selecteer je Carrier Integration
- Klik op Add New (of als je al een Sendcloud integratie hebt, ga je naar change the API key ONLY bij deze stappen, gezien één integratie genoeg is)
- Voer bij Name 'Sendcloud' in
- Stel de Date time format in als dd/MM/yyyy hh:mm:ss.
- Zet de Timeout (ms) op 30000.
- Kopieer en plak de API key van Sendcloud. Deze kun je vinden bij Instellingen > Integraties > Peoplevox > Bewerken > Go naar configuratie
- Kopieer en plak het Endpoint
- Zet het Tracking number format op {outbound}
- Klik op Opslaan
Stel je DespatchPackage print templates in Peoplevox in
- Log in bij Peoplevox
- Verander je view naar Setup (via het dropdown menu rechtsboven op de pagina).
- Selecteer Print Templates.
- Selecteer bij Label type "DespatchPackage" (voor uitgaande labels en uitgaande commercial invoices)
- Klik op Search
- Klik op je gekozen template
- Zet de Registered template name naar Outgoing label (verlaat Carrier connection)
- Klik op Opslaan
Selecteer de print templates in de carrier connection in Peoplevox
- Ga terug naar de eerder ingestelde carrier integration
- Klik hierop en vervolgens op Edit
- Onderaan in de popup van Document Types vul je een Name en Reference in en selecteer je een van de Print Templates gecreëerd onder sectie 4 hierboven.
- De Name kan worden ingevuld naar keuze, maar je kunt gewoon dezelfde tekst gebruiken als bij Reference (beneden).
- De Reference moet worden ingesteld als Outbound label.
- Het Outbound label motel geselecteerd worden voor de Print templates.
- Klik op Save
Verbinden met de Peoplevox Testomgeving
Peoplevox heeft twee omgevingen:
-
Live: https://wms.peoplevox.net/ (WMS)
-
Test: https://qac.peoplevox.net/ (QAC)
Het is mogelijk om Sendcloud te verbinden met een Peoplevox Testomgeving (https://qac.peoplevox.net/) voor staging om nieuwe instellingen en configuraties te testen. Om dit te doen, dien je de stappen hierboven te volgen, maar bij Stap 2 (waar je de Peoplevox credentials moet invullen in Sendcloud) je client ID invullen, gevolgd door "/qac" en dan deze credentials opslaan.
Let op dat als je de prefix /qac vergeet toe te voegen aan je client ID, de integratie standaard naar de live omgeving gaat (/wms).