Sites

Create and manage sites where you sell your goods.

The Sites section allows you to manage all the configurations related to your sites.

General information

In the general settings, you can activate or deactivate the site, and designate it as the default one. Specify the languages supported on the site and the countries where the products can be shipped. Also, choose the currency and settings for proper price handling, and the available payment methods that the site supports. Additionally, determine whether the shipping or billing address should be used as the basis for the tax calculation.

Tax determination

To determine the relevant location to calculate proper taxes, the cart and checkout services read the Tax determination based on setting for the site. This setting determines the proper location by the countryCode from the relevant address. The default setting for a site is the billing address.

If you set the tax determination as shipping address, the country for calculating tax is determined in the following order:

1. For the cart service:

a. the cart's countryCode

b. if the countryCode is not provided for a cart, a customer's default shipping address countryCode

c. if a customer doesn't have a default shipping address, the first customer's shipping address countryCode on the list

d. if a customer doesn't have any shipping addresses, the default countryCode from the site settings

1. For the checkout service:

a. a shipping address countryCode, provided during checkout

b. if a shipping address is not provided, a customer's billing address countryCode is taken as a fallback

Home base address

Provide your business's address information.

The Country and Timezone fields determine computation of values for the defined sequential IDs placeholders. The value you set in the Country field determines the country code value that replaces the country placeholder, while the selected site's Timezone determines all the date-and-time-related values. For example, if you use date and time placeholders for computing values in the order number sequential ID schema, the values for the date and time are generated based on the selected timezone. If the timezone is not set, the default system value is used (GMT/UTC-0). Or, if you wish to include a country code in the quote number pattern, the country placeholder takes the value that you have chosen for the home address country. If the Country is not set, the default system value is used (DE). To learn more how to define sequential IDs schemas, refer to the Sequential ID Service Tutorial.

Location coordinates

Provide a longitude and latitude for the home base address.

Assisted buying

To enable using the assisted buying feature, enter the storefront URL in the corresponding field of the site settings.

If the authorization is successful, the following query parameters are added to the URL:

• customerToken - It's a customer authorization token.

• customerTokenExpiresIn - It indicates a validity period for the token.

• saasToken - It's customer saas token, it contains information about the employee who generated the token, therefore it's crucial to send the saas-token header with the value in every http request sent by a customer.

After enabling the feature for a specific site, you can now log in as a customer and perform the requested actions on their behalf. In the Customers view in Management Dashboard, choose the site that you want to use, it opens a new browser tab with the storefront. You can now do any purchases or action that were requested by the customer.

To learn more about sites, see Sites business documentation and Site Settings Service API guide.