Requesting a label based on service point selection
Creating a parcel with service point delivery
Read our step-by-step guide on how to create a parcel that is delivered to a service point.
How to determine which flow of data to use for the integration
Refer to the following decision tree:
Most common integrations
| Integration | Service point id | To post number |
|---|---|---|
| Lightspeed (new) | order.shipmentData.location | Not saved |
| Lightspeed (old) | Not saved | Not saved |
| Magento v2 | sendcloud_service_point_id | sendcloud_service_point_postnumber |
| Prestashop | Not saved | Not saved |
| Shopify | Not saved | Not saved |
| Shopware 6 | order.sendcloud_service_point | Not saved |
| Woocommerce | Not saved | Not saved |
Custom-built plugins using Sendcloud service points
In cases where we do not offer a plug-and-play integration with your CMS platform, or the integration does not save the service point ID to the webshop, there are two possible options:- Embed the Sendcloud service points widget JavaScript code in your checkout
- Create your own service point picker plugin using our Service Points API.
service_point_id, to_post_number, and carrier (as they are returned in the service point object) to the order in your webshop.
This information can then be sent to the ERP/WMS when the order is synced. It’s a good idea to save the carrier since this field can be used for setting more flexible shipping rules in Sendcloud; refer to the Standard flow section below.
Standard flow
As depicted in the diagram, theservice_point_id (and potentially the to_post_number) are saved in the webshop and, most commonly, to the order. This information can then be sent to the ERP/WMS, where it is saved, and later can be sent to Sendcloud at the time of parcel creation. It’s important to note that the shipment id has to be defined when creating a parcel to ship to a service point. This can be done via three methods:
- Using Sendcloud shipping rules. For example, when you have the following shipping rule: if the checkout delivery method is PostNL service point, then ship with “PostNL service point 0-23 kg”, you would use the
shipmentidof8and set"apply_shipping_rules": truewhen creating a parcel with"request_label": true. The checkout delivery method name is defined in the webshop, and should also be sent to the ERP/WMS, and then to Sendcloud. - Use the Retrieve a list of shipping methods endpoint to find shipping methods that ship to the service point. In the query parameters, use the
service_point_id. - If the carrier is known in the ERP/WMS, the Retrieve a list of shipping products endpoint can be used to find an appropriate shipping method. Make sure to pass the
last_mile=service_pointquery parameter.Example request method and URL
Fulfilling webshop orders via API flow
Read a full explanation of this flow on Fulfill orders. Note that when the integration fetches the shipment created by the webshop integration, theto_service_point, to_post_number and the shipping_method are also retrieved.