This article provides an overview of the steps required when integrating Paazl's SOAP API with a webshop making use of Paazl Perfect.
SOAP API reference provides detailed information the various calls listed below.
- The order process always starts when your WMS sends an order request to Paazl. This creates a temporary order in the Paazl database. The order request can include the dimensions (length×width×height), weight, content description, HS Tariff code, and price of the product concerned
- If your customer changes the products in his/her basket, you have to send Paazl an order update because the available shipping options may have changed too.
- Your webshop sends a shipping option request to Paazl as soon as customers enter their country and postal code. Paazl returns all the options available for the order concerned
- If customers want a different shipping option, they click the button or link concerned (depending on how your webshop has implemented this functionality), and Paazl displays the available shipping options. The steps are as follows:
- Your webshop sends a checkout request to Paazl as soon as the button or link is clicked
- Paazl returns a URL for the Paazl Perfect module
- Your customer selects a shipping option and confirms his/her selection. After your customer exits Paazl Perfect, it saves the selected option
- Your webshop asks Paazl for the selected shipping option
- Paazl returns the selected shipping option, which your webshop has to save
- On checkout (after payment), your webshop confirms the selected shipping option by telling Paazl to commit it to the Paazl database
If your customer selects a pick-up location, certain commitOrderRequest elements change:
- commitOrder > shippingMethod > identifier
- commitOrder > shippingMethod > servicepointAccountNumber
- commitOrder > shippingMethod > servicepointNotificationEmail
- commitOrder > shippingMethod > servicepointNotificationMobile
- Your webshop sends the order reference (in Paazl) to your WMS
- Your WMS requests the label for the shipping order; Paazl returns a PDF label in Base64 code
- If desired, your WMS requests a return label for the shipping order. Paazl returns a PDF label in a Base64 code