Paazl voor ontwikkelaars

SOAP API

SOAP authenticatie

Voor authenticatie moet elk verzoek worden voorzien van een met SHA-1 versleutelde code. De string die je moet hashen verschilt per aanroep. Welke substrings je achter elkaar plaatst (samenvoegt) bepaalt de opbouw van de hash-string.


Stel bijvoorbeeld dat de te hashen string een samenvoeging is van de volgende substrings:


<Webshop ID> + <Integratiewachtwoord> + <Orderreferentie>


Deze substrings hebben de volgende waarden:


Webshop ID: 123

Wachtwoord: abcdefghi

Orderreferentie: Ref00001


De te hashen string wordt dan: 123abcdefghiRef00001


In de twee tabellen hieronder zie je de verschillende hash-stringformaten voor de SOAP API-aanroepen van Paazl en de definities van de substrings.


Hash-stringformaten


SOAP API-aanroepSubstrings
  • address
  • cancelShipment
  • changeOrder
  • checkout
  • checkoutStatus
  • commitOrder
  • deleteOrder
  • deliveryEstimate
  • generateExtraPdfLabel
  • generateExtraPdfReturnLabel
  • generateLabels
  • generatePdfLabels
  • generatePdfReturnLabels
  • generateShippingManifest
  • generateZplLabels
  • getExistingPdfLabel
  • getExistingPdfLabels
  • getExistingZplLabels
  • order
  • orderDetails
  • orderStatus
  • rate
  • shippingOption
  • updateOrder
<webshop ID> + <integratiewachtwoord> + <orderreferentie>
  • addExistingShipment
  • listOrders
  • listStores
<webshop ID> + <integratiewachtwoord> + <huidige datum: YYYYMMDD>
  • servicePoints

<webshop ID> + <integratiewachtwoord> + <land>

<webshop ID> + <integratiewachtwoord> + <land> + <postcode>

<webshop ID> + <integratiewachtwoord> + <southWest.latitude>

  • createPickup
<webshop ID> + <integratiewachtwoord> + <interne referentie>
  • createStores
  • deleteStores
  • updateStores
<webshop ID> + <integratiewachtwoord> + <winkelcode>
  • triggerCarrierRegistration
<webshop ID> + <integratiewachtwoord>
  • generateShippingManifest
<webshop ID> + <integratiewachtwoord> + <startdatum manifest>
  • openBatch
<webshop ID> + <integratiewachtwoord> + <vervoerderscode> + <verzendoptie> + <landcode> + <huidige datum: YYYYMMDD>

Substring-definities


SubstringDefinitie
Webshop ID

De interne Paazl-code voor jouw webshop. Je vindt deze in je Paazl-webappaccount onder Integratie > SOAP API (Integration > SOAP API).

Integratiewachtwoord

Het integratiewachtwoord van jouw webshop. Je vindt dit in je Paazl-webappaccount onder Integratie > SOAP API (Integration > SOAP API).

Interne referentieDe "internal ref" die is opgegeven in de "createPickupRequest"-aanroep zelf (bepaald door de webshop).
Orderreferentie

Dit is de orderreferentie die je aan een bestelling toekent met behulp van de aanroep order of commitOrder.


Wil je een bestelling pas van een definitieve referentie voorzien als het bestelproces helemaal is afgerond? Omdat Paazl altijd een type orderreferentie vereist, kun je bij het indienen van een order-aanroep eerst een tijdelijke referentie meegeven. Bij de commitOrder-aanroep wijzig je deze vervolgens naar de definitieve referentie.

WinkelcodeDit is de code die je aan een winkel hebt toegekend via de aanroep createStores.
Vervoerderscode

In de online help van Paazl vind je een overzicht van alle Paazl-vervoerderscodes.

Verzendoptie

Je vindt de codes van de gecontracteerde verzendopties in je Paazl-webappaccount onder Vervoerders > Verzendopties (Carriers > Shipping options).

Huidige datumDit is de datum van vandaag in het formaat "YYYYMMDD".
LandcodeDe ISO 3166-2-code voor het land van de verzendbestemming.
PostcodeDe postcode van de verzendbestemming.
Startdatum manifestDe startdatum van een verzendmanifest.

Was dit artikel nuttig?

Dat is fantastisch!

Hartelijk dank voor uw beoordeling

Sorry dat we u niet konden helpen

Hartelijk dank voor uw beoordeling

Laat ons weten hoe we dit artikel kunnen verbeteren!

Selecteer tenminste een van de redenen
CAPTCHA-verificatie is vereist.

Feedback verzonden

We stellen uw moeite op prijs en zullen proberen het artikel te verbeteren