getShippingMethod
get
/ccstore/v1/shippingMethods/{id}
Get Shipping Method. Get a shipping method. Optionally takes the x-ccasset-language header to get translated content in another language.
Request
Supported Media Types
- application/json
Path Parameters
-
id: string
the id of the shipping method to get
Header Parameters
-
X-CCAsset-Language(optional): string
The asset language of the request
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : getShippingMethod_response
Type:
Show Source
object
-
associatedPriceListGroups(optional):
array associatedPriceListGroups
The associated Price list groups for this Shipping Method.
-
displayName(optional):
string
The display name for the shipping method given the current locale.
-
displaySequence(optional):
integer
Used to determine the ordering of shipping methods in the UI. Lower values should appear first in any ordered list.
-
eligibleForProductWithSurcharges(optional):
boolean
Whether this shipping method is enabled for products with surcharges or not. Defaults to false.
-
enabled(optional):
boolean
Whether this shipping method is enabled or not.
-
externalId(optional):
string
External Id for the shipping method
-
internalName(optional):
string
Internal name for the shipping method.
-
isExternallyPriced(optional):
boolean
Whether this shipping method can be priced externally or not. Defaults to false.
-
isFallback(optional):
boolean
Use this shipping method when Commerce Cloud cannot connect to an external shipping service. Defaults to false.
-
name(optional):
string
The internal name for the shipping method.
-
ranges(optional):
array ranges
The price ranges for this shipping method.
-
repositoryId(optional):
string
The repository ID shipping method item.
-
shippingCalculator(optional):
string
A valid key for the available calculator types.
-
shippingGroupType(optional):
string
The shipping group type for the shipping method.
-
shipToLocations(optional):
array shipToLocations
The Shipping Regions for a Shipping Method
-
taxCode(optional):
string
A valid tax code for calculating tax on shipping.
-
type(optional):
integer
The type of shipping method
Nested Schema : associatedPriceListGroups
Type:
array
The associated Price list groups for this Shipping Method.
Show Source
Nested Schema : items
Type:
Show Source
object
-
active(optional):
boolean
If the price list group is active.
-
currency(optional):
object currency
The currency of the price list group.
-
deleted(optional):
boolean
If the price list deleted
-
displayName(optional):
string
The display name of the price list group.
-
id(optional):
string
The id of the price list group.
-
locale(optional):
string
The locale associated
-
repositoryId(optional):
string
The repository Id of the price list group.
Nested Schema : currency
Type:
object
The currency of the price list group.
Show Source
-
repositoryId(optional):
string
The repository ID of the currency.
Nested Schema : items
Type:
Show Source
object
-
amount(optional):
number
The monetary value for the range.
-
high(optional):
number
The upper boundary of the range.
-
low(optional):
number
The lower boundary of the range.
-
repositoryId(optional):
string
The repository id of this priceRange item.
Nested Schema : items
Type:
Show Source
object
-
repositoryId(optional):
string
The repository ID of the shipping region.
Example Response (application/json)
{
"eligibleForProductWithSurcharges":true,
"shippingCalculator":"priceRange",
"isExternallyPriced":false,
"ranges":[
{
"amount":4.75,
"high":14.99,
"low":0,
"repositoryId":"groundRange1"
},
{
"amount":5.95,
"high":49.99,
"low":15,
"repositoryId":"groundRange2"
},
{
"amount":6.5,
"high":null,
"low":50,
"repositoryId":"groundRange3"
}
],
"displayName":"Ground",
"description":null,
"type":0,
"taxCode":"FR020400",
"shippingGroupType":"hardgoodShippingGroup",
"enabled":true,
"displaySequence":0,
"repositoryId":"ground",
"isFallback":false,
"shipToLocations":[
{
"repositoryId":"100002"
},
{
"repositoryId":"100001"
}
]
}
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|31015|If there was no shipping method found with the given id|
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code