Shipping Methods
Manage shipping methods
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 returned. If set to false
, only the inactive methods are returned.
If not specified, both active and inactive methods are returned.
- 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}/methods HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"id": "fedex-2dayground",
"name": "FedEx 2Day",
"active": true,
"maxOrderValue": {
"amount": 5000,
"currency": "EUR"
},
"fees": [
{
"minOrderValue": {
"amount": 0,
"currency": "EUR"
},
"cost": {
"amount": 10,
"currency": "EUR"
}
},
{
"minOrderValue": {
"amount": 50,
"currency": "EUR"
},
"cost": {
"amount": 9,
"currency": "EUR"
},
"shippingGroupId": "group1"
},
{
"minOrderValue": {
"amount": 200,
"currency": "EUR"
},
"cost": {
"amount": 8,
"currency": "EUR"
},
"shippingGroupId": "group2"
}
]
},
{
"id": "ups-standard",
"name": "UPS Standard",
"fees": [
{
"minOrderValue": {
"amount": 0,
"currency": "EUR"
},
"cost": {
"amount": 5,
"currency": "EUR"
}
},
{
"minOrderValue": {
"amount": 50,
"currency": "EUR"
},
"cost": {
"amount": 2,
"currency": "EUR"
},
"shippingGroupId": "group3"
}
]
}
]
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
Shipping methods define the types of deliveries and properties such as delivery fees.
String value in the specified language.
FedEx 2Day
Flag indicating whether the shipping method is active.
Shipping method's tax code.
Shipping groups unique identifier.
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/{zoneId}/methods HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 430
{
"id": "fedex-2dayground",
"name": "FedEx 2Day",
"active": true,
"maxOrderValue": {
"amount": 5000,
"currency": "EUR"
},
"fees": [
{
"minOrderValue": {
"amount": 0,
"currency": "EUR"
},
"cost": {
"amount": 10,
"currency": "EUR"
}
},
{
"minOrderValue": {
"amount": 50,
"currency": "EUR"
},
"cost": {
"amount": 9,
"currency": "EUR"
},
"shippingGroupId": "group1"
},
{
"minOrderValue": {
"amount": 200,
"currency": "EUR"
},
"cost": {
"amount": 8,
"currency": "EUR"
},
"shippingGroupId": "group2"
}
]
}
{
"id": "fedex-2dayground"
}
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Shipping zone's unique identifier.
Delivery method's unique identifier.
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 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}/methods/{methodId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"id": "fedex-2dayground",
"name": "FedEx 2Day",
"active": true,
"maxOrderValue": {
"amount": 5000,
"currency": "EUR"
},
"fees": [
{
"minOrderValue": {
"amount": 0,
"currency": "EUR"
},
"cost": {
"amount": 10,
"currency": "EUR"
}
},
{
"minOrderValue": {
"amount": 50,
"currency": "EUR"
},
"cost": {
"amount": 9,
"currency": "EUR"
},
"shippingGroupId": "group1"
},
{
"minOrderValue": {
"amount": 200,
"currency": "EUR"
},
"cost": {
"amount": 8,
"currency": "EUR"
},
"shippingGroupId": "group2"
}
]
}
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Shipping zone's unique identifier.
Delivery method's unique identifier.
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
Shipping methods define the types of deliveries and properties such as delivery fees.
String value in the specified language.
FedEx 2Day
Flag indicating whether the shipping method is active.
Shipping method's tax code.
Shipping groups unique identifier.
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}/methods/{methodId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 430
{
"id": "fedex-2dayground",
"name": "FedEx 2Day",
"active": true,
"maxOrderValue": {
"amount": 5000,
"currency": "EUR"
},
"fees": [
{
"minOrderValue": {
"amount": 0,
"currency": "EUR"
},
"cost": {
"amount": 10,
"currency": "EUR"
}
},
{
"minOrderValue": {
"amount": 50,
"currency": "EUR"
},
"cost": {
"amount": 9,
"currency": "EUR"
},
"shippingGroupId": "group1"
},
{
"minOrderValue": {
"amount": 200,
"currency": "EUR"
},
"cost": {
"amount": 8,
"currency": "EUR"
},
"shippingGroupId": "group2"
}
]
}
No content
Your Emporix tenant's name.
Note: The tenant should always be written in lowercase.
^[a-z][a-z0-9]+$
Shipping zone's unique identifier.
Delivery method's unique identifier.
Site’s unique identifier. A site is a specific shop.
If the tenant owns only one shop, the value should be set to main
.
Resource successfully deleted.
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}/methods/{methodId} 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]+$
Shipping zone's unique identifier.
Delivery method's unique identifier.
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
Shipping methods define the types of deliveries and properties such as delivery fees.
String value in the specified language.
FedEx 2Day
Flag indicating whether the shipping method is active.
Shipping method's tax code.
Shipping groups unique identifier.
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}/methods/{methodId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 430
{
"id": "fedex-2dayground",
"name": "FedEx 2Day",
"active": true,
"maxOrderValue": {
"amount": 5000,
"currency": "EUR"
},
"fees": [
{
"minOrderValue": {
"amount": 0,
"currency": "EUR"
},
"cost": {
"amount": 10,
"currency": "EUR"
}
},
{
"minOrderValue": {
"amount": 50,
"currency": "EUR"
},
"cost": {
"amount": 9,
"currency": "EUR"
},
"shippingGroupId": "group1"
},
{
"minOrderValue": {
"amount": 200,
"currency": "EUR"
},
"cost": {
"amount": 8,
"currency": "EUR"
},
"shippingGroupId": "group2"
}
]
}
No content
Was this helpful?