Shipping Service Tutorials

info

Names and/or descriptions of shipping zones, methods, and groups are localized. When creating a new shipping zone, method, or group, you can specify its name and/or description in one or multiple languages.

Looking for more info on localization? Check out Standard practices.

How to configure delivery and shipping settings

To allow customers to place orders, you need to configure delivery and shipping settings by following the process below:

Create a shipping zone.
Create a shipping group.
Assign customers to a shipping group.
Add shipping methods and define shipping fees.
Add delivery times.
Add delivery slots.

Before you start

Ensure that you have created at least one customer.

info

A customer account can be created by the employee themselves or from your Emporix tenant's side. For more information, check out the following endpoints in the Emporix API Reference:

Create a shipping zone

Shipping zones are countries that your business delivers products to. You can create a shipping zone by calling the Creating a shipping zone endpoint.

Create a shipping group

You can set up shipping groups for customers and define different shipping methods and costs for these groups. To create a shipping group, you need to call the Creating a shipping group endpoint.

Assign customers to shipping groups

By adding customers to shipping groups, you can offer them different shipping methods and costs. Assign customers to shipping groups by calling the Creating a customer-group relation endpoint.

Add shipping methods and define fees

Add shipping methods and configure shipping fees by calling the Creating a shipping method endpoint.

Add delivery times

Delivery times specify days of the week and hours of the day on which orders can be delivered. They are defined for particular shipping zones.

Add delivery times by calling the Creating a delivery time endpoint.

Add delivery slots

Delivery slots specify periods during the day, when the delivery can take place. You can create multiple slots for every day.

Add delivery time slots by calling the Creating a delivery time slot endpoint.

How to manage delivery and shipping information upon checkout

You need to retrieve available delivery windows to be able to estimate the delivery time for a specific postal code. At checkout, updating the cart with delivery and shipping information is necessary for the order to be placed.

Retrieve available delivery windows.
Add delivery information to the customer's cart.

Before you start

Ensure that you have already finished the How to configure delivery and shipping settings tutorial.
Ensure that you have created at least one customer.
Ensure that you have configured payment options. For more information on payments, check out How to enable payment methods.
Ensure that the order settings are configured. For more information, check out the Order Service API Reference.

Retrieve available delivery windows for a particular postal code and cart

Shipping times for particular postal codes are automatically calculated based on the business' shipping configuration, for example shipping capacity, or cut-off time. Retrieve delivery windows by calling the Retrieving delivery windows by cart endpoint.

Update the cart with delivery information

Add the delivery information to the cart by calling the Updating a cart endpoint.