Alle Produkte

Integrating the service point picker

Sendcloud provides a service point picker which can be easily integrated with your system. This will display a map on your checkout page, from which your customers can choose a convenient service point to have their parcel delivered to. You can find out more about the service point picker here.

Please note that the service point will be displayed in the language that is set in your account, and not by the language of the web browser.

Before you begin, make sure you have:

1. Obtained your API keys
2. Enabled Service Points for selected carriers in your Integration settings

To integrate the service point picker with your custom-built shop:

1. Play around with the live example. When selecting a service point, you’ll receive a service point object and a post number, if entered, as a result. You’ll need that data later when creating a new parcel through our parcels API (see Create a parcel in our shipping API reference).
2. Make sure to fill in the to_service_point and to_post_number parameters when sending the data over.
3. You can copy the code from the bottom of this page, under the Usage section

To integrate with your back-end code:

1. You need to call sendcloud.servicePoints.open and provide with a config object, a success callback and a failure callback (example)
2. Once a Service Point is selected, our library will call your callback function with a Service Point Object. This contains the service point address properties and the unique service_point_id.
3. When you Create a parcel via the API, you will need to structure your request so that it includes the service point address information. In the to_service_point parameter, pass the service point ID.
4. You can find a guide on creating parcels to ship to service points with the Sendcloud API here.

Related Links:

• Sendcloud API Documentation
  https://api.sendcloud.dev/docs/sendcloud-public-api/
• Service Point Picker integration example
  https://sendcloud.github.io/spp-integration-example/
• Service Point Picker integration example repository
  https://github.com/SendCloud/spp-integration-example/