Ecommerce Shipping Options API
Create, Retrieve, Update and Delete Ecommerce Shipping Options via the public API endpoint as well as return external shipping providers and settings.
GET
Ecommerce External Shipping Services List
Retrieves a list of External Shipping Providers as a JSON response based on your provided query parameters.
/api/v2/admin/shipping-options/provider-services
Data / Response:
{
"ShippingProviderType" : "string"
}
[
{
"Id": "19688",
"Code": "INT_PARCEL_COR_OWN_PACKAGING",
"DisplayName": "Courier (international)",
"Description": null,
"Type": "AustraliaPost"
},
{
"Id": "19689",
"Code": "INT_PARCEL_EXP_OWN_PACKAGING",
"DisplayName": "Express (international)",
"Description": null,
"Type": "AustraliaPost"
}
]
GET
Ecommerce External Shipping Settings List
Retrieves a list of External Shipping Provider Settings as a JSON response based on your provided query parameters.
/api/v2/admin/shipping-options/provider-settings
Data / Response:
{
"ShippingProviderType" : "string"
}
{
}
//Object with fields for the specified ShippingProviderType
GET
Ecommerce Shipping Options List
Retrieves a list of Shipping Options as a JSON response based on your provided query parameters.
/api/v2/admin/shipping-options
Data / Response:
{
"Where" : {},
"Order_By" : "Id",
"Offset" : 0,
"Limit" : 100,
}
{
"Items": [
{
"Id": 0,
"Name": "string",
"Price": 0,
"IsEnabled": true,
"CurrencyCountry": "string",
"Currency": "string",
"Country": "string",
"Type": 0,
"TaxId": 0,
"TaxNeverApplies": true,
"ChosenShippingProviderServices": [
0
],
"ProviderSettings": "string",
"ShippingSettings": {
"Services": [
{
"Id": 0,
"Code": "string",
"DisplayName": "string",
"Description": "string",
"Type": 0
}
],
"AccountTypes": [
{
"DisplayName": "string",
"Value": "string"
}
],
"DeliveryConfirmations": [
{
"DisplayName": "string",
"Value": "string"
}
],
"PackageType": [
{
"DisplayName": "string",
"Value": "string"
}
]
},
"Settings": {
"HandlingCharge": 0,
"AdditionalPerItemHandlingCharge": 0,
"MinWeight": 0,
"MaxWeight": 0,
"MinWidth": 0,
"MaxWidth": 0,
"MinHeight": 0,
"MaxHeight": 0,
"MinDepth": 0,
"MaxDepth": 0,
"MinOrderPrice": 0,
"MaxOrderPrice": 0,
"AllowedCustomersTypes": [
0
],
"LimitDeliveryFollowingCountries": [
"string"
],
"ExcludeShippingForCatalogs": [
0
]
}
}
],
"TotalItemsCount": 0
}
POST
Ecommerce Shipping Option Create
Creates a new Shipping Option based on the provided data.
/api/v2/admin/shipping-options
Data / Response:
{
"Name": "string",
"Price": 0,
"IsEnabled": true,
"Currency": "string",
"Country": "string",
"Type": "string",
"TaxId": 0,
"TaxNeverApplies": true,
"ChosenShippingProviderServices": [
0
],
"ProviderSettings": "string",
"Settings": {
"HandlingCharge": 0,
"AdditionalPerItemHandlingCharge": 0,
"MinWeight": 0,
"MaxWeight": 0,
"MinWidth": 0,
"MaxWidth": 0,
"MinHeight": 0,
"MaxHeight": 0,
"MinDepth": 0,
"MaxDepth": 0,
"MinOrderPrice": 0,
"MaxOrderPrice": 0,
"AllowedCustomersTypes": [
0
],
"LimitDeliveryFollowingCountries": [
"string"
],
"ExcludeShippingForCatalogs": [
0
]
}
}
{
"Id": 0,
"Name": "string",
"Price": 0,
"IsEnabled": true,
"CurrencyCountry": "string",
"Currency": "string",
"Country": "string",
"Type": 0,
"TaxId": 0,
"TaxNeverApplies": true,
"ChosenShippingProviderServices": [
0
],
"ProviderSettings": "string",
"ShippingSettings": {
"Services": [
{
"Id": 0,
"Code": "string",
"DisplayName": "string",
"Description": "string",
"Type": 0
}
],
"AccountTypes": [
{
"DisplayName": "string",
"Value": "string"
}
],
"DeliveryConfirmations": [
{
"DisplayName": "string",
"Value": "string"
}
],
"PackageType": [
{
"DisplayName": "string",
"Value": "string"
}
]
},
"Settings": {
"HandlingCharge": 0,
"AdditionalPerItemHandlingCharge": 0,
"MinWeight": 0,
"MaxWeight": 0,
"MinWidth": 0,
"MaxWidth": 0,
"MinHeight": 0,
"MaxHeight": 0,
"MinDepth": 0,
"MaxDepth": 0,
"MinOrderPrice": 0,
"MaxOrderPrice": 0,
"AllowedCustomersTypes": [
0
],
"LimitDeliveryFollowingCountries": [
"string"
],
"ExcludeShippingForCatalogs": [
0
]
}
}
GET
Ecommerce Shipping Option Item
Retrieves a single Shipping Option based on the ID passed in the endpoint URL.
/api/v2/admin/shipping-options/{id}
Data / Response:
N/A
{
"Id": 0,
"Name": "string",
"Price": 0,
"IsEnabled": true,
"CurrencyCountry": "string",
"Currency": "string",
"Country": "string",
"Type": 0,
"TaxId": 0,
"TaxNeverApplies": true,
"ChosenShippingProviderServices": [
0
],
"ProviderSettings": "string",
"ShippingSettings": {
"Services": [
{
"Id": 0,
"Code": "string",
"DisplayName": "string",
"Description": "string",
"Type": 0
}
],
"AccountTypes": [
{
"DisplayName": "string",
"Value": "string"
}
],
"DeliveryConfirmations": [
{
"DisplayName": "string",
"Value": "string"
}
],
"PackageType": [
{
"DisplayName": "string",
"Value": "string"
}
]
},
"Settings": {
"HandlingCharge": 0,
"AdditionalPerItemHandlingCharge": 0,
"MinWeight": 0,
"MaxWeight": 0,
"MinWidth": 0,
"MaxWidth": 0,
"MinHeight": 0,
"MaxHeight": 0,
"MinDepth": 0,
"MaxDepth": 0,
"MinOrderPrice": 0,
"MaxOrderPrice": 0,
"AllowedCustomersTypes": [
0
],
"LimitDeliveryFollowingCountries": [
"string"
],
"ExcludeShippingForCatalogs": [
0
]
}
}
PUT
Ecommerce Shipping Option Update
Updates a single Shipping Option based on the ID passed in the endpoint URL and data provided.
/api/v2/admin/shipping-options/{id}
Data / Response:
{
"Name": "string",
"Price": 0,
"IsEnabled": true,
"Currency": "string",
"Country": "string",
"Type": "string",
"TaxId": 0,
"TaxNeverApplies": true,
"ChosenShippingProviderServices": [
0
],
"ProviderSettings": "string",
"Settings": {
"HandlingCharge": 0,
"AdditionalPerItemHandlingCharge": 0,
"MinWeight": 0,
"MaxWeight": 0,
"MinWidth": 0,
"MaxWidth": 0,
"MinHeight": 0,
"MaxHeight": 0,
"MinDepth": 0,
"MaxDepth": 0,
"MinOrderPrice": 0,
"MaxOrderPrice": 0,
"AllowedCustomersTypes": [
0
],
"LimitDeliveryFollowingCountries": [
"string"
],
"ExcludeShippingForCatalogs": [
0
]
}
}
{
"Id": 0,
"Name": "string",
"Price": 0,
"IsEnabled": true,
"CurrencyCountry": "string",
"Currency": "string",
"Country": "string",
"Type": 0,
"TaxId": 0,
"TaxNeverApplies": true,
"ChosenShippingProviderServices": [
0
],
"ProviderSettings": "string",
"ShippingSettings": {
"Services": [
{
"Id": 0,
"Code": "string",
"DisplayName": "string",
"Description": "string",
"Type": 0
}
],
"AccountTypes": [
{
"DisplayName": "string",
"Value": "string"
}
],
"DeliveryConfirmations": [
{
"DisplayName": "string",
"Value": "string"
}
],
"PackageType": [
{
"DisplayName": "string",
"Value": "string"
}
]
},
"Settings": {
"HandlingCharge": 0,
"AdditionalPerItemHandlingCharge": 0,
"MinWeight": 0,
"MaxWeight": 0,
"MinWidth": 0,
"MaxWidth": 0,
"MinHeight": 0,
"MaxHeight": 0,
"MinDepth": 0,
"MaxDepth": 0,
"MinOrderPrice": 0,
"MaxOrderPrice": 0,
"AllowedCustomersTypes": [
0
],
"LimitDeliveryFollowingCountries": [
"string"
],
"ExcludeShippingForCatalogs": [
0
]
}
}
DELETE
Ecommerce Shipping Option Delete
Deletes a single Shipping Option based on the ID passed in the endpoint URL.
/api/v2/admin/shipping-options/{id}
Data / Response:
N/A
Status 204