REST API for Oracle Commerce Cloud December 2017

listShippingMethods

post

/ccstore/v1/shippingMethods

List Shipping Methods. Get a list of shipping methods that are valid for a given address. Optionally takes the x-ccasset-language header to get translated content in another language.

Request

Supported Media Types

application/json

Header Parameters

X-CCAsset-Language: Type: string

The asset language of the request

Body Parameter

Root Schema : listShippingMethods_request

Example


{
    "priceInfo":{
        "amount":22.98,
        "total":22.98,
        "shipping":0,
        "shippingSurchargeValue":0,
        "tax":0,
        "subTotal":22.98,
        "currencyCode":"USD",
        "totalWithoutTax":22.98
    },
    "shippingAddress":{
        "lastName":"kim",
        "country":"United States",
        "address2":"",
        "city":"ALS",
        "address1":"20 Cedar Ave",
        "postalCode":"36123",
        "county":"",
        "selectedCountry":"US",
        "firstName":"james",
        "phoneNumber":"",
        "state":"Alabama",
        "email":"james@example.com",
        "selectedState":"AL",
        "state_ISOCode":"US-AL"
    },
    "items":[
        {
            "quantity":1,
            "discountInfo":[
            ],
            "productId":"prod10020",
            "rawTotalPrice":12.99,
            "price":12.99,
            "invalid":false,
            "stockStatus":true,
            "currentPrice":12.99,
            "catRefId":"Sku_15DE"
        },
        {
            "quantity":1,
            "discountInfo":[
            ],
            "productId":"prod10022",
            "rawTotalPrice":9.99,
            "invalid":false,
            "stockStatus":true,
            "currentPrice":9.99,
            "catRefId":"Sku_18Dyii"
        }
    ],
    "productIdForShippingSurcharge":[
        "prod10020",
        "prod10022"
    ]
}

Properties

items: Type: array items

Required: true

Additional Properties Allowed:

The array of products in the shopping cart.
priceInfo: Type: object priceInfo

Additional Properties Allowed:

The price information.
productIdForShippingSurcharge: Type: array productIdForShippingSurcharge

Required: true

Additional Properties Allowed:

array of product ids present in the cart.
shippingAddress: Type: object shippingAddress

Additional Properties Allowed:

shipping address of the profile

Nested Schema : items

Type: array

The array of products in the shopping cart.

Items

Type: object items

Additional Properties Allowed:

Nested Schema : priceInfo

Type: object

The price information.

Properties

amount: Type: number

The total order amount.
currencyCode: Type: string

The currency code.
shipping: Type: number

The total shipping cost.
shippingSurchargeValue: Type: number

Extra handling costs for shipping the products.
subTotal: Type: number

Sub-total.
tax: Type: number

The total tax amount.
total: Type: number

The order total.

Nested Schema : productIdForShippingSurcharge

Type: array

array of product ids present in the cart.

Items

Type: string

Nested Schema : shippingAddress

Type: object

shipping address of the profile

Properties

address1: Type: string

Required: true

the address1 of the shipping address
address2: Type: string

the address2 of the shipping address
city: Type: string

Required: true

the city of the shipping address
country: Type: string

Required: true

the country of the shipping address
county: Type: string

the county of the shipping address
email: Type: string

Required: true

the email address
firstName: Type: string

Required: true

the first name of the shipping address
lastName: Type: string

Required: true

the last name of the shipping address
phoneNumber: Type: string

the phone Number of the shipping address
postalCode: Type: string

Required: true

the postal Code of the shipping address
selectedCountry: Type: string

the country code of the shipping address
selectedState: Type: string

the state ISO alpha-2 code of the shipping address
state: Type: string

the state of the shipping address
state_ISOCode: Type: string

the state ISO alpha-4 code of the shipping address

Nested Schema : items

Type: object

Properties

catRefId: Type: string

Required: true

The category to which the product belongs.
currentPrice: Type: integer

Required: true

The current price of the item.
discountInfo: Type: object discountInfo

Additional Properties Allowed:

Discount information.
price: Type: string

The Price.
productId: Type: string

Required: true

ID of the product in the cart.
quantity: Type: integer

Required: true

The quantity of the product in the cart.
stockStatus: Type: string

Required: true

The stock status of the product.

Nested Schema : discountInfo

Type: object

Discount information.

Properties

coupon: Type: string

Required: true

Coupon code.
promotionDesc: Type: string

Required: true

Promotion description.
promotionId: Type: string

Required: true

Pomotion ID.

Response

Supported Media Types

application/json

200 Response

Following model is returned when operation succeeds.

Body

Root Schema : listShippingMethods_response

Properties

object: Type: array object

Additional Properties Allowed:

the array of shipping methods

Nested Schema : object

Type: array

the array of shipping methods

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

description: Type: string

The description of shipping group.
displayName: Type: string

the display name for the shipping method given the current locale.
displaySequence: Type: integer

used to determine the ordering of shipping methods in the UI. Lower values should appear first in any ordered list.
eligibleForProductWithSurcharges: Type: boolean

whether this shipping method is enabled for products with surcharges or not.
enabled: Type: boolean

whether this shipping method is enabled or not.
ranges: Type: array ranges

Additional Properties Allowed:

the price ranges for this shipping method
repositoryId: Type: string

the id of the shipping method item
shippingCalculator: Type: string

a valid key for the available calculator types
shippingGroupType: Type: string

The shipping group type.
shipToLocations: Type: array shipToLocations

Additional Properties Allowed:

The array of repository IDs of shipping locations.
taxCode: Type: string

a valid tax code for calculating tax on shipping.
type: Type: integer

The type property of the shipping method.

Nested Schema : ranges

Type: array

the price ranges for this shipping method

Items

Type: object items

Additional Properties Allowed:

Nested Schema : shipToLocations

Type: array

The array of repository IDs of shipping locations.

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

amount: Type: number

the monetary value for the range
high: Type: number

the upper boundary of the range
low: Type: number

the lower boundary of the range
repositoryId: Type: string

the repository id of this priceRange item

Nested Schema : items

Type: object

Properties

repositoryId: Type: string

Repository ID of shipping location.

Example application/json


[
    {
        "eligibleForProductWithSurcharges":true,
        "shippingCalculator":"priceRange",
        "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",
        "displaySequence":0,
        "repositoryId":"ground",
        "description":null,
        "type":0,
        "taxCode":"FR020400",
        "shippingGroupType":"hardgoodShippingGroup",
        "enabled":true,
        "shipToLocations":[
            {
                "repositoryId":"100002"
            },
            {
                "repositoryId":"100001"
            }
        ]
    },
    {
        "eligibleForProductWithSurcharges":true,
        "shippingCalculator":"priceRange",
        "ranges":[
            {
                "amount":8.75,
                "high":14.99,
                "low":0,
                "repositoryId":"twoDayRange1"
            },
            {
                "amount":9.95,
                "high":49.99,
                "low":15,
                "repositoryId":"twoDayRange2"
            },
            {
                "amount":10.5,
                "high":null,
                "low":50,
                "repositoryId":"twoDayRange3"
            }
        ],
        "displayName":"Two Day",
        "displaySequence":1,
        "repositoryId":"twoDay",
        "description":null,
        "type":0,
        "taxCode":"FR020400",
        "shippingGroupType":"hardgoodShippingGroup",
        "enabled":true,
        "shipToLocations":[
            {
                "repositoryId":"100002"
            },
            {
                "repositoryId":"100001"
            }
        ]
    },
    {
        "eligibleForProductWithSurcharges":true,
        "shippingCalculator":"priceRange",
        "ranges":[
            {
                "amount":16.4,
                "high":null,
                "low":0,
                "repositoryId":"overnightRange1"
            }
        ],
        "displayName":"Overnight",
        "displaySequence":2,
        "repositoryId":"overnight",
        "description":null,
        "type":0,
        "taxCode":"FR020400",
        "shippingGroupType":"hardgoodShippingGroup",
        "enabled":true,
        "shipToLocations":[
            {
                "repositoryId":"100002"
            },
            {
                "repositoryId":"100001"
            }
        ]
    }
]

Default Response

The error response

Body

Root Schema : errorModel

Type: object

Properties

devMessage: Type: string

An optional non-localized message containing technical information for developers
errorCode: Type: string

The numerical code identifying the error
errors: Type: array errors

Additional Properties Allowed:

An optional list of errors if multiple errors were encountered
message: Type: string

The localized message describing the error
moreInfo: Type: string

An optional non-localized message with more information
o:errorPath: Type: string

An optional machine readable description of where the error occurred
status: Type: string

The HTTP status code
type: Type: string

The URI to the HTTP state code definition

Nested Schema : errors

Type: array

An optional list of errors if multiple errors were encountered

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

devMessage: Type: string

An optional non-localized message containing technical information for developers
errorCode: Type: string

The numerical code identifying the error
message: Type: string

The localized message describing the error
moreInfo: Type: string

An optional non-localized message with more information
o:errorPath: Type: string

An optional machine readable description of where the error occurred
status: Type: string

The HTTP status code

Examples

Sample Request:

{
  "priceInfo": {
    "amount": 22.98,
    "total": 22.98,
    "shipping": 0,
    "shippingSurchargeValue": 0,
    "tax": 0,
    "subTotal": 22.98,
    "currencyCode": "USD",
    "totalWithoutTax": 22.98
  },
  "shippingAddress": {
    "lastName": "kim",
    "country": "United States",
    "address2": "",
    "city": "ALS",
    "address1": "20 Cedar Ave",
    "postalCode": "36123",
    "county": "",
    "selectedCountry": "US",
    "firstName": "james",
    "phoneNumber": "",
    "state": "Alabama",
    "email": "james@example.com",
    "selectedState": "AL",
    "state_ISOCode": "US-AL"
  },
  "items": [
    {
      "quantity": 1,
      "discountInfo": [],
      "productId": "prod10020",
      "rawTotalPrice": 12.99,
      "price": 12.99,
      "invalid": false,
      "stockStatus": true,
      "currentPrice": 12.99,
      "catRefId": "Sku_15DE"
    },
    {
      "quantity": 1,
      "discountInfo": [],
      "productId": "prod10022",
      "rawTotalPrice": 9.99,
      "invalid": false,
      "stockStatus": true,
      "currentPrice": 9.99,
      "catRefId": "Sku_18Dyii"
    }
  ],
  "productIdForShippingSurcharge": [
    "prod10020",
    "prod10022"
  ]
}

Sample Response Payload returned by endpoint:

[
  {
    "eligibleForProductWithSurcharges": true,
    "shippingCalculator": "priceRange",
    "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",
    "displaySequence": 0,
    "repositoryId": "ground",
    "description": null,
    "type": 0,
    "taxCode": "FR020400",
    "shippingGroupType": "hardgoodShippingGroup",
    "enabled": true,
    "shipToLocations": [
      {"repositoryId": "100002"},
      {"repositoryId": "100001"}
    ]
  },
  {
    "eligibleForProductWithSurcharges": true,
    "shippingCalculator": "priceRange",
    "ranges": [
      {
        "amount": 8.75,
        "high": 14.99,
        "low": 0,
        "repositoryId": "twoDayRange1"
      },
      {
        "amount": 9.95,
        "high": 49.99,
        "low": 15,
        "repositoryId": "twoDayRange2"
      },
      {
        "amount": 10.5,
        "high": null,
        "low": 50,
        "repositoryId": "twoDayRange3"
      }
    ],
    "displayName": "Two Day",
    "displaySequence": 1,
    "repositoryId": "twoDay",
    "description": null,
    "type": 0,
    "taxCode": "FR020400",
    "shippingGroupType": "hardgoodShippingGroup",
    "enabled": true,
    "shipToLocations": [
      {"repositoryId": "100002"},
      {"repositoryId": "100001"}
    ]
  },
  {
    "eligibleForProductWithSurcharges": true,
    "shippingCalculator": "priceRange",
    "ranges": [{
      "amount": 16.4,
      "high": null,
      "low": 0,
      "repositoryId": "overnightRange1"
    }],
    "displayName": "Overnight",
    "displaySequence": 2,
    "repositoryId": "overnight",
    "description": null,
    "type": 0,
    "taxCode": "FR020400",
    "shippingGroupType": "hardgoodShippingGroup",
    "enabled": true,
    "shipToLocations": [
      {"repositoryId": "100002"},
      {"repositoryId": "100001"}
    ]
  }
]