Manage products (asynchronous API)

Update an individual or base product

post

Update an existing individual product, or base product asynchronously. The product identifier should be an individual or base product.

Authorizations

Path parameters

productIdstringRequired

The product identifier of either an individual product or a base product.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Body

Responses

202

Successful response.

application/json

401

* The API key is invalid if you are HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* Product was not found.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products/{productId} HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 341

{
  "deploymentRequiredChanges": {
    "fulfillmentTypes": [
      "Download"
    ],
    "otherFulfillmentIntegration": {
      "fulfillerIds": [
        "digitalRiver"
      ]
    },
    "transferProduct": "2234567800",
    "upgradeProducts": [
      "3234567800"
    ],
    "downgradeProducts": [
      "4234567800"
    ]
  },
  "localizations": [
    {
      "locale": "en_US",
      "isDefault": true,
      "groups": [
        {
          "attributes": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        }
      ]
    }
  ]
}

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Retire a product

post

Retire an existing product asynchronously. The product variations will be retired along with the base product. Therefore, the provided product identifier must be for an individual or base product.

Authorizations

Path parameters

productIdstringRequired

The product identifier of either an individual product or a base product.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Responses

202

Successful response.

application/json

401

* The API key is invalid if you are using HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* Product was not found.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products/{productId}/retire HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Accept: */*

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Delete a locale from the product

delete

Delete a locale from an existing product asynchronously. The available locales for a product variation are based on the base product. Therefore, the provided product identifier must be the identifier for an individual or base product. The change will go live immediately. You do not need to deploy the change.

Authorizations

Path parameters

productIdstringRequired

The product identifier of either an individual product or a base product.

localestringRequired

The locale for the product.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Responses

202

Successful response.

application/json

401

* The API key is invalid if you are using HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* Product was not found.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

delete

HTTPcURLJavaScriptPython

DELETE /v1/products/{productId}/locales/{locale} HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Accept: */*

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Deploy a product

post

Deploy an existing product asynchronously. The product variations will be deployed along with base product. Therefore, the provided product specified identifier must be for an individual or base product

Authorizations

Path parameters

productIdstringRequired

The product identifier of either an individual product or a base product.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Responses

202

Successful response.

application/json

401

* The API key is invalid if you are using HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* Product was not found.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products/{productId}/deploy HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Accept: */*

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Create a new individual or base product with variations

post

Create a new product asynchronously. You can create either an individual product or base product with variations.

Authorizations

Body

Responses

202

Successful response.

application/json

401

* The API key is invalid if you are using HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 1266

{
  "deploymentRequiredChanges": {
    "fulfillmentTypes": [
      "Download"
    ],
    "otherFulfillmentIntegration": {
      "fulfillerIds": [
        "digitalRiver"
      ]
    },
    "transferProduct": "2234567800",
    "upgradeProducts": [
      "3234567800"
    ],
    "downgradeProducts": [
      "4234567800"
    ]
  },
  "liveChanges": {
    "externalReferenceId": "sku-1234-5678-xyz",
    "catalogs": [
      {
        "catalogId": "123456000",
        "categories": [
          {
            "categoryId": "19000000"
          }
        ],
        "prices": [
          {
            "type": "listPrice",
            "prices": [
              {
                "currency": "USD",
                "locale": "en_US",
                "configuredPrice": 15.99
              }
            ]
          }
        ]
      }
    ]
  },
  "localizations": [
    {
      "locale": "en_US",
      "isDefault": true,
      "groups": [
        {
          "attributes": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        }
      ]
    }
  ],
  "variations": [
    {
      "varyingAttributes": [
        {
          "attributeName": "fulfillmentType",
          "attributeValue": "Download"
        }
      ],
      "deploymentRequiredChanges": {
        "fulfillmentTypes": [
          "Download"
        ],
        "otherFulfillmentIntegration": {
          "fulfillerIds": [
            "digitalRiver"
          ]
        },
        "transferProduct": "2234567800",
        "upgradeProducts": [
          "3234567800"
        ],
        "downgradeProducts": [
          "4234567800"
        ]
      },
      "liveChanges": {
        "externalReferenceId": "sku-1234-5678-xyz",
        "catalogs": [
          {
            "catalogId": "123456000",
            "categories": [
              {
                "categoryId": "19000000"
              }
            ],
            "prices": [
              {
                "type": "listPrice",
                "prices": [
                  {
                    "currency": "USD",
                    "locale": "en_US",
                    "configuredPrice": 15.99
                  }
                ]
              }
            ]
          }
        ]
      },
      "localizations": [
        {
          "locale": "en_US",
          "isDefault": true,
          "groups": [
            {
              "attributes": {
                "ANY_ADDITIONAL_PROPERTY": "text"
              }
            }
          ]
        }
      ]
    }
  ]
}

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Update a product variation

post

Update an existing product variation asynchronously.

Authorizations

Path parameters

baseProductIdstringRequired

The base product identifier must be for the base product for the product variation, or simply use 'product' instead.

Example: product

variationIdstringRequired

The product variation identifier.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Body

Responses

202

Successful response.

application/json

400

* Bad request

application/json

401

* The API key is invalid if you are HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* Could not find the product variation.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products/{baseProductId}/variations/{variationId} HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 341

{
  "deploymentRequiredChanges": {
    "fulfillmentTypes": [
      "Download"
    ],
    "otherFulfillmentIntegration": {
      "fulfillerIds": [
        "digitalRiver"
      ]
    },
    "transferProduct": "2234567800",
    "upgradeProducts": [
      "3234567800"
    ],
    "downgradeProducts": [
      "4234567800"
    ]
  },
  "localizations": [
    {
      "locale": "en_US",
      "isDefault": true,
      "groups": [
        {
          "attributes": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        }
      ]
    }
  ]
}

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Delete a product variation

delete

Delete an existing product variation asynchronously. The changes go live immediately. You do not need to deploy these changes. If the request cannot find the product variation the response returns 200 OK.

Authorizations

Path parameters

baseProductIdstringRequired

The base product identifier must be for the base product for the product variation, or simply use 'product' instead.

Example: product

variationIdstringRequired

The product variation identifier.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Responses

202

Successful response.

application/json

400

* Bad request

application/json

401

* The API key is invalid if you are using HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

delete

HTTPcURLJavaScriptPython

DELETE /v1/products/{baseProductId}/variations/{variationId} HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Accept: */*

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Update the live changes of an individual or base product

post

Update the live changes to an existing individual product or base product asynchronously. The changes will go live immediately. You do not need to deploy these changes. Live changes for individual or base product includes catalog, category, price.

Authorizations

Path parameters

productIdstringRequired

The product identifier of either an individual product or a base product.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Body

The changed attributes under this object will go live immediately. You do not need to deploy these changes. You can use these attributes to insert live changes when creating a product. After creating the product, the fields are read-only. You can apply live changes by using the POST /v1/products/{productId}/live-changes API.

externalReferenceIdstringOptional

The external reference identifier. A unique identifier for the product from the Digital River client.

Example: sku-1234-5678-xyz

Responses

202

Successful response.

application/json

401

* The API key is invalid if you are HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* Product was not found.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products/{productId}/live-changes HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 226

{
  "externalReferenceId": "sku-1234-5678-xyz",
  "catalogs": [
    {
      "catalogId": "123456000",
      "categories": [
        {
          "categoryId": "19000000"
        }
      ],
      "prices": [
        {
          "type": "listPrice",
          "prices": [
            {
              "currency": "USD",
              "locale": "en_US",
              "configuredPrice": 15.99
            }
          ]
        }
      ]
    }
  ]
}

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Update the live changes (like price) of a product variation

post

Update the live changes to an existing product variation asynchronously. The changes will go live immediately. You do not need to deploy these changes. Live changes for product variation include the price.

Authorizations

Path parameters

baseProductIdstringRequired

The base product identifier must be for the base product for the product variation, or simply use 'product' instead.

Example: product

variationIdstringRequired

The product variation identifier.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Body

The changed attributes under this object will go live immediately. You do not need to deploy these changes. You can use these attributes to insert live changes when creating a product. After creating the product, the fields are read-only. You can apply live changes by using the POST /v1/products/{productId}/live-changes API.

externalReferenceIdstringOptional

The external reference identifier. A unique ID for the product from the Digital River client.

Example: sku-1234-5678-xyz

Responses

202

Successful response.

application/json

400

* Bad request

application/json

401

* The API key is invalid if you are using HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* Variation not found

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products/{baseProductId}/variations/{variationId}/live-changes HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 185

{
  "externalReferenceId": "sku-1234-5678-xyz",
  "catalogs": [
    {
      "catalogId": "123456000",
      "prices": [
        {
          "type": "listPrice",
          "prices": [
            {
              "currency": "USD",
              "locale": "en_US",
              "configuredPrice": 15.99
            }
          ]
        }
      ]
    }
  ]
}

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}

Create a new product variation for an existing base product

post

Create a new product variation for existing base product asynchronously.

Authorizations

Path parameters

baseProductIdstringRequired

The base product identifier or external reference identifier.

Header parameters

x-erid-as-pidbooleanOptional

Set to true if you want to use the external reference identifier (ERID) in the path instead of the product identifier (productId).

Body

Responses

202

Successful response.

application/json

401

* The API key is invalid if you are HTTP Basic Authentication.

application/json

403

* The token is invalid if you are using Bearer Token Authentication.

application/json

404

* The base product was not found.

application/json

409

* Unable to handle request because it conflicts with other requests.

application/json

post

HTTPcURLJavaScriptPython

POST /v1/products/{baseProductId}/variations HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 668

{
  "varyingAttributes": [
    {
      "attributeName": "fulfillmentType",
      "attributeValue": "Download"
    }
  ],
  "deploymentRequiredChanges": {
    "fulfillmentTypes": [
      "Download"
    ],
    "otherFulfillmentIntegration": {
      "fulfillerIds": [
        "digitalRiver"
      ]
    },
    "transferProduct": "2234567800",
    "upgradeProducts": [
      "3234567800"
    ],
    "downgradeProducts": [
      "4234567800"
    ]
  },
  "liveChanges": {
    "externalReferenceId": "sku-1234-5678-xyz",
    "catalogs": [
      {
        "catalogId": "123456000",
        "categories": [
          {
            "categoryId": "19000000"
          }
        ],
        "prices": [
          {
            "type": "listPrice",
            "prices": [
              {
                "currency": "USD",
                "locale": "en_US",
                "configuredPrice": 15.99
              }
            ]
          }
        ]
      }
    ]
  },
  "localizations": [
    {
      "locale": "en_US",
      "isDefault": true,
      "groups": [
        {
          "attributes": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        }
      ]
    }
  ]
}

{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT"
}