Shipping Zones
Manage shipping zones
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Site’s unique identifier. A site is a specific shop.
If the tenant owns only one shop, the value should be set to main
.
- If set to
true
, only active methods are included. - If set to
false
, only inactive methods are included. - If not specified, all expanded shipping methods are included.
- methods: To return zones with expanded shipping methods.
- fees: To expand the configured fees for those shipping methods.
methods,fees
The Accept-Language request HTTP header defines which languages the client is able to understand, and which locale variant is preferred. It can be a priority list working as a fallback mechanism. If the Accept-Language header is empty, all languages for localized fields are returned in a map format where the key is language code and the value is a translation.
fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7
Resource successfully retrieved.
Request syntactically incorrect. Any details will be provided within the response payload.
Unauthorized
Some server side error occurred.
GET /shipping/{tenant}/{site}/zones HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"id": "zone1",
"name": "Zone 1",
"shipTo": [
{
"country": "DE",
"postalCode": "70190"
}
],
"default": true
},
{
"id": "zone2",
"name": "Zone 2",
"shipTo": [
{
"country": "DE",
"postalCode": "70192"
}
],
"default": false
}
]
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Site’s unique identifier. A site is a specific shop.
If the tenant owns only one shop, the value should be set to main
.
The Content-Language request HTTP header defines language of the payload. When the Content-Language header is empty, all localized fields in a payload should be in a map format, where the key is a language code and the value is a translation.
fr
The zone is an area where shipments can be delivered.
Delivery zone's unique identifier.
Flag indicating whether the zone is the default delivery zone for the site.
String value in the specified language.
FedEx 2Day
Resource successfully created.
Request syntactically incorrect. Any details will be provided within the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match required scopes.
The requested resource does not exist.
Creation failed because there was a conflict with another resource. Any details will be provided within the response payload.
Some server side error occurred.
POST /shipping/{tenant}/{site}/zones HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 94
{
"shipTo": [
{
"country": "DE",
"postalCode": "70190"
}
],
"name": "Zone 1",
"id": "zone1",
"default": true
}
{
"id": "zone1"
}
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Site’s unique identifier. A site is a specific shop.
If the tenant owns only one shop, the value should be set to main
.
Shipping zone's unique identifier.
- If set to
true
, only active methods are included. - If set to
false
, only inactive methods are included. - If not specified, all expanded shipping methods are included.
- methods: To return zones with expanded shipping methods.
- fees: To expand the configured fees for those shipping methods.
methods,fees
The Accept-Language request HTTP header defines which languages the client is able to understand, and which locale variant is preferred. It can be a priority list working as a fallback mechanism. If the Accept-Language header is empty, all languages for localized fields are returned in a map format where the key is language code and the value is a translation.
fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7
Resource successfully retrieved.
Request syntactically incorrect. Any details will be provided within the response payload.
Unauthorized
The requested resource does not exist.
Some server side error occurred.
GET /shipping/{tenant}/{site}/zones/{zoneId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"id": "zone1",
"name": "Zone 1",
"shipTo": [
{
"country": "DE",
"postalCode": "70190"
}
],
"default": true
}
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Site’s unique identifier. A site is a specific shop.
If the tenant owns only one shop, the value should be set to main
.
Shipping zone's unique identifier.
The Content-Language request HTTP header defines language of the payload. When the Content-Language header is empty, all localized fields in a payload should be in a map format, where the key is a language code and the value is a translation.
fr
The zone is an area where shipments can be delivered.
Delivery zone's unique identifier.
Flag indicating whether the zone is the default delivery zone for the site.
String value in the specified language.
FedEx 2Day
Resource successfully updated.
Request syntactically incorrect. Any details will be provided within the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match required scopes.
The requested resource does not exist.
Some server side error occurred.
PUT /shipping/{tenant}/{site}/zones/{zoneId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 94
{
"shipTo": [
{
"country": "DE",
"postalCode": "70190"
}
],
"name": "Zone 1",
"id": "zone1",
"default": true
}
No content
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Site’s unique identifier. A site is a specific shop.
If the tenant owns only one shop, the value should be set to main
.
Shipping zone's unique identifier.
Resource successfully deleted.
Request syntactically incorrect. Any details will be provided within the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match required scopes.
The requested resource does not exist.
Some server side error occurred.
DELETE /shipping/{tenant}/{site}/zones/{zoneId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
No content
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Site’s unique identifier. A site is a specific shop.
If the tenant owns only one shop, the value should be set to main
.
Shipping zone's unique identifier.
The Content-Language request HTTP header defines language of the payload. When the Content-Language header is empty, all localized fields in a payload should be in a map format, where the key is a language code and the value is a translation.
fr
The zone is an area where shipments can be delivered.
Delivery zone's unique identifier.
Flag indicating whether the zone is the default delivery zone for the site.
String value in the specified language.
FedEx 2Day
Resource successfully updated.
Request syntactically incorrect. Any details will be provided within the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match required scopes.
The requested resource does not exist.
Some server side error occurred.
PATCH /shipping/{tenant}/{site}/zones/{zoneId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 94
{
"shipTo": [
{
"country": "DE",
"postalCode": "70190"
}
],
"name": "Zone 1",
"id": "zone1",
"default": true
}
No content
Was this helpful?