Products and SKUs

Learn more about the standards related to products and SKUs

The checklist items and standards in this section cover how to manage your products in the Digital River APIs.

On this page, the integration checklist that you should use depends on the product data model you employ. For more information, refer to the:

• Defining goods and services page

• Sending product data in the checkouts section on the Describing line items page

Integration checklists

The integration checklist you should work from in this section depends on your product data model.

For more information, refer to the sending product data in checkouts section on the Describing line items page.

Click any checklist item for more details on meeting the integration standard.

SKUs only checklist

• Do you have a method for manually synchronizing a full product catalog using the SKUs API?

• Do you have a scheduled job or real-time trigger to synchronize new and updated products in your catalog with their corresponding SKUs in our system?

• Can you capture a product's tax code, ECCN, and country of origin within your product admin interface?

• Does your integration use your source system's unique product identifier as the SKU identifier when interfacing with the SKUs API?

SKUs with SKU groups checklist

• Do you have a method for manually synchronizing a full product catalog using the SKUs API?

• Do you have a scheduled job or real-time trigger to synchronize new and updated products in your catalog with their corresponding SKUs in our system?

• Does your integration use your source system's unique product identifier (UUID) as the SKU identifier when interfacing with the SKUs API?

• Have you associated a SKU group with each of your SKU's?

Product details with SKU groups checklist

• Have you associated a SKU group with each product in your system?

Integration standards

The product and SKU standards that apply to your integration depend on which of the above ☝️ checklists you're using.

Manually synchronize your catalog

You should have a tool that manually imports and then allows you to periodically update your products in Digital River's system through the SKUs API. Your platform's admin interface most likely already has a product management page. You can simply modify this page to perform SKU imports and updates.

Automatically synchronize your catalog

Product catalogs are often very large. To optimize performance, you should synch your products and SKUs on a timed schedule or using a similar trigger.

These scheduled jobs should make as few calls to the SKUs API as possible. Therefore, we suggest you use a delta to only update the attributes in a SKU that changed in its corresponding product. This prevents you from having to overwrite every SKU value each time you run a synchronization job.

Capture SKU attributes

If you're sending product data in checkouts by referencing SKUs that don't belong to SKU groups, then you should add the following attributes to the product schema in your commerce platform:

• Export Control Classification Number
• Country of origin
• Tax code

Similarly, regardless of whether or not you associate SKU groups with SKUs, if you're sending product data in checkouts by referencing SKUs, you should also add the following attributes to your platform's product schema:

• Part number
• Weight and weight unit
• Image and URL
• Fulfillment coordinator

When you set these values in your admin interface, you can sync your products with their corresponding SKUs in Digital River's system.

Ensure product and SKU identifiers match

Your product's identifier should match the identifier of its corresponding SKU in our system. It's important that these values are the same. This ensures that synchronization is possible and that the SKUs work properly during checkouts.

Associate a SKU group with each SKU

Before deployment, you should associate a SKU group with each of your SKUs in our system.

Associate a SKU group with each product in your system

Before deployment, you should associate a SKU group with each product in your system.

API interfaces

Documentation	Direct API	PHP SDK
Defining goods and services, Grouping SKUs, Sending product data	SKUs	SKUs