Managing inventory items
Learn how to manage inventory items
Last updated
Learn how to manage inventory items
Last updated
are only used in .
In the , you must and . Once created, you can then or the resource. In this model, you must also ensure that the of remain synchronized.
In both the and the , you use an inventory item's to , , and during checkout.
In the , you must use an inventory item's when .
The following are some of an inventory item's key definable attributes. For comprehensive specifications, refer to the documentation.
An inventory item's unique identifier is represented by id
.
When , if you don't specify id
, Digital River generates a value for you.
However, the product identifier in your system should match the inventory item's id
in our system. As a result, we recommend that you specify your own inventory id
and that it matches your product's designated universally unique identifier.
An inventory item's countryOfOrigin
is a two-letter described in the international standard. Invalid country codes return a 400 Bad Request
:
A product requires a US export/re-export license
A product contains any other license requirements/restrictions
A product has an end use which is prohibited by applicable export control laws
The format of the code is ####.##.####
, where #
represents a numeric digit between 0 and 9. The first six digits are mandatory. Any code longer than six digits but less than ten digits is optional and based on the country's preference. The period is not included in the character count.
Digital River only validates that the format of a Harmonized System code you provide is correct. We don't determine whether the code accurately classifies your product.
For example, the full ten-digit code for Jasmine rice in the United States is 1006.20.40.25. If that's the value you specify, we don't check to ensure your product fits into that category.
Incorrectly formatted hsCode
values return a 400 Bad Request
:
An inventory item contains manufacturerId
and partNumber
fields.
The manufacturerId
signifies the unique identifier of a part/product's manufacturer.
A manufacturer part number (MPN) is a unique code manufacturers issue to identify a part/product. It is represented by partNumber
.
MPNs are meant to be static identifiers of a part/product, universal to all distributors, wholesalers, and resellers. They allow customers to identify exact parts and protect themselves from counterfeits accurately.
If two parts/products originate from two manufacturers, each must have its own MPN. These identifiers are especially relevant for automotive and consumer electronics due to the numerous parts in these complex products.
You may build your integration so customers can reserve out-of-stock or pre-order items not yet in stock. To do this, you can use an inventory item's allowOversell
flag.
An inventory item's eccn
represents an (ECCN). This value determines whether:
Digital River's lists for use in the Digital River APIs. In the table's description field, you may find additional requirements and restrictions that further limit the use of the ECCN.
Digital River can only resell products with these listed ECCNs. If you have a product with an ECCN that you'd like to be considered for addition to the list, contact
An inventory item's hsCode
represents a .
If you set the flag to true
, customers can even when inventory is not available. When set to false
, customers won't be able to place a hold on an item when its inventory levels are insufficient.
You can override allowOversell
during the .
You can use the to create, update, retrieve, search for, and delete inventory items.
The allows you to create and update inventory items.
In the , do not directly create or update inventory items.
For more information, refer to on the page.
The methods to create and update inventory items are similar, with one major difference. For the requests, you're allowed to specify a . When , you must send that identifier as a path parameter.
For both POST/inventory-items
and POST/inventory-items/{id}
requests, however, you can specify a , , , and . You can also tell us whether you want to that item.
The allows you to retrieve a .
The allows you to .
The lets you permanently by supplying its unique identifier.
In that use the , you should not directly delete inventory items.
For more information, refer to on the page.