Sign in
latestOpenAPI 3.0.12026-08-101292701.1 MB

f21981db32be

SKUs

Upserts a SKU

Either creates or updates a SKU.

put/skus/{id}

Path parameters

idstring required

The identifier of the SKU to update or create. If a SKU with this id exists, then Digital River uses the data in the request body to update the resource. Otherwise, Digital River uses that same data to create a new SKU resource and assigns it id.

Request body

eccnstring

The export control classification number.

hsCodestring

The international and US Harmonized System code (sometimes referred to as the Harmonized Tariff Schedule).

skuGroupIdstring

The unique identifier of the Sku Group.

partNumberstring

The manufacturer's part number.

manufacturerIdstring

The unique identifier

managedFulfillment'DRGlobalFulfillment'

Signifies the product is physically fulfilled by Digital River.

taxCodestring

The designated tax code.

namestring required

The product’s name.

descriptionstring

A description of the product.

imagestring

An image of the product.

urlstring

A product url.

countryOfOriginstring

A two-letter Alpha-2 country code as described in the ISO 3166 international standard.

weightnumber double

The weight of the product measured in the unit specified by weightUnit.

weightUnit'oz' | 'lb' | 'g' | 'kg'

The unit of measurement applied to the weight.

itemBreadcrumbstring

The full path to the category where item is included. Categories should be separated by “ > “.

partnerAccountIdstring

The unique, Digital River identifier (account Id) of the partner associated with the sku.

metadataMetadata

Key-value pairs used to store additional data. Value can be string, boolean or integer types.

Example request

{
  "eccn": "EAR99",
  "hsCode": "6404.20",
  "skuGroupId": "5823594809",
  "partNumber": "SWG1224J10L",
  "manufacturerId": "654123",
  "taxCode": "4323.310_A",
  "name": "Athena Womens Running Shoes",
  "description": "Athena Womens Running Shoes",
  "image": "https://imageurl.com",
  "url": "https://producturl.com",
  "countryOfOrigin": "US",
  "weight": 20.5,
  "weightUnit": "oz",
  "itemBreadcrumb": "Sports & Outdoors > Exercise & Fitness > Wearable Technology > Fitness Trackers",
  "partnerAccountId": "00g6atnynbl2wFsFG357",
  "metadata": {
    "coupon": "iOS"
  }
}

Response

200 OK. This indicates that a SKU with that id existed and is now updated.

createdTimestring date-time

The time when the SKU was created.

idstring

The unique identifier of the SKU.

eccnstring

The export control classification number.

hsCodestring

The international and US Harmonized System code (sometimes referred to as the Harmonized Tariff Schedule).

skuGroupIdstring

The unique identifier of the Sku Group.

partNumberstring

The manufacturer's part number.

manufacturerIdstring

The unique identifier

managedFulfillment'DRGlobalFulfillment'

Signifies the product is physically fulfilled by Digital River.

physicalboolean

Identifies whether or not a product is physical, so that the appropriate data requirements are enforced.

taxCodestring

The designated tax code.

namestring

The product’s name.

descriptionstring

A description of the product.

imagestring

An image of the product.

urlstring

A product url.

countryOfOriginstring

A two-letter Alpha-2 country code as described in the ISO 3166 international standard.

weightnumber double

The weight of the product measured in the unit specified by weightUnit.

weightUnit'oz' | 'lb' | 'g' | 'kg'

The unit of measurement applied to the weight.

itemBreadcrumbstring

The full path to the category where item is included. Categories should be separated by “ > “.

partnerAccountIdstring

The unique, Digital River identifier (account Id) of the partner associated with the sku.

liveModeboolean

Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.

metadataMetadata

Key-value pairs used to store additional data. Value can be string, boolean or integer types.

updatedTimestring date-time

The time when the SKU was last updated.

Example response

{
  "createdTime": "2018-04-25T20:36:00Z",
  "id": "sku_5823594809",
  "eccn": "EAR99",
  "hsCode": "6404.20",
  "skuGroupId": "5823594809",
  "partNumber": "SWG1224J10L",
  "manufacturerId": "654123",
  "physical": true,
  "taxCode": "4323.310_A",
  "name": "Athena Womens Running Shoes",
  "description": "Athena Womens Running Shoes",
  "image": "https://imageurl.com",
  "url": "https://producturl.com",
  "countryOfOrigin": "US",
  "weight": 20.5,
  "weightUnit": "oz",
  "itemBreadcrumb": "Sports & Outdoors > Exercise & Fitness > Wearable Technology > Fitness Trackers",
  "partnerAccountId": "00g6atnynbl2wFsFG357",
  "metadata": {
    "coupon": "iOS"
  },
  "updatedTime": "2018-04-25T20:36:00Z"
}