Item Update by SKU

PostedJanuary 12, 2022

Update your SKU information by SKU number into Best system, only single SKU can be updated in single call.

URL: {API root URL}/items/{customerCode}/{sku}
Method: PUT

Request

URL Parameters

Parameter Name	Required	Data Type	Description
CustomerCode	Y	String	Your unique customer code assigned by Best system
SKU	Y	String	The SKU number

Attribute List

Element Name	Required	Data Type	Description
CustomerCode	Y	String	Your unique customer code assigned by Best system
SKU	Y	String	The unique number to identity your SKU
Description	Y	String	The name of title of your SKU
Description2		String	Additional detail description of your SKU
UPC	Y	String	The UPC code or barcode that will be printed on your product label, Best warehouse will scan this code to identify your product when receiving or picking your SKU.
UPC2		String	Additional UPC code
UPC3		String	Another additional UPC code
Length	Y	Decimal	The length of your SKU by unit Inch.
Width	Y	Decimal	The width of your SKU by unit Inch.
Height	Y	Decimal	The height of your SKU by unit Inch.
Weight	Y	Decimal	The weight of your SKU by unit Pound.
type		String	A proper value to indicate the inventory classification for your item. Available options: Component – Basic items that can be shipped as regular inventory. PackingMaterial – Items that are added as shipping packages. If not specified, Component will be applied.
CommodityCode		String	International tariff code, provide this code if your item will ship to a place out of US.
CountryOfOrigin		String	The ISO Alpha-2 code of the originally produced country for your item, provide it if your item will ship to a place out of US. To check the Alpha-2 country code for each country, please refer to below page: https://www.iso.org/obp/ui/#search
BatteryFlag		Boolean	Indicate if this item includes any battery, system will set to False if you don’t specify value.
HazmatFlag		Boolean	Indicate if this item is hazmat, system will set to False if you don’t specify value.
LiquidFlag		Boolean	Indicate if this item includes liquid, system will set to False if you don’t specify value.
FragileFlag		Boolean	Indicate if this item is fragile product, system will set to False if you don’t specify value.
MfgDateRequired		Boolean	Indicate if this item is required to collect the manufacturing date when receiving this product into Best warehouse. Please always contact your AM to enable this feature in your account profile before you send True for this field. System will set to False if you don’t specify value.
ExpDateRequired		Boolean	Indicate if this item is required to collect the expiration date when receiving this product into Best warehouse. Please always contact your AM to enable this feature in your account profile before you send True for this field. System will set to False if you don’t specify value.
BatchNumberRequired		Boolean	Indicate if this item is required to collect the batch number when receiving this product into Best warehouse. Please always contact your AM to enable this feature in your account profile before you send True for this field. System will set to False if you don’t specify value.
CountryOfOriginRequired		Boolean	Indicate if this item is required to collect the country of origin when receiving this product into Best warehouse. Please always contact your AM to enable this feature in your account profile before you send True for this field. System will set to False if you don’t specify value.
SerialNumberRequired		Boolean	Indicate if this item is required to collect the serial number when receiving this product into Best warehouse. System will set to False if you don’t specify value.
AltUnit		String	Indicate the unit type other than single piece for your SKU if it’s applicable, the available value is “Carton”.
AltQuantity		Integer	Indicate how many individual pieces are contained in each pack based on the unit type specified in AltUnit.
AltUPC		String	The UPC or barcode of your pack based on the unit type specifiedin AltUnit.
AltLength		Decimal	The length in unit Inch of your pack based on the unit type specifiedin AltUnit.
AltWidth		Decimal	The width in unit Inch of your pack based on the unit type specifiedin AltUnit.
AltHeight		Decimal	The height in unit Inch of your pack based on the unit type specifiedin AltUnit.
AltWeight		Decimal	The weight in unit Pound of your pack based on the unit type specifiedin AltUnit.

Request Example

{
    "customerCode": "TEST",
    "sku": "YQ-9999997",
    "upc": "124445622565",
    "upc2": "124445622566",
    "upc3": "124445622567",
    "description": "Anker Powerline Cable (8ft)", 
    "description2": "MFi Certified for iPhone 11 / XS/XS Max/XR/X / 8/8 Plus / 7/7 Plus / 6/6 Plus",
    "commodityCode": "",
    "countryOfOrigin": "CN",
    "length": 5.45,
    "width": 3,
    "height": 2,
    "weight": 1.2,
    "expDateRequired": false,
    "MfgDateRequired": false,
    "CountryOfOriginRequired": true,
    "SerialNumberRequired": true,
    "BatchNumberRequired": true,
    "BatteryFlag": false,
    "HazmatFlag": false,
    "LiquidFlag": false,
    "FragileFlag": false,
    "altUnit": "Carton",
    "altUPC": "124445622565",
    "altQuantity": 4,
    "altLength": 11.65,
    "altWidth": 3.6,
    "altHeight": 4.12,
    "altWeight": 4.25
  }

Response

Attribute List

Element Name	Data Type
Id (Internal ID of SKU)	Integer
CustomerCode	String
SKU	String
Description	String
Description2	String
UPC	String
UPC2	String
UPC3	String
Length	Decimal
Width	Decimal
Height	Decimal
Weight	Decimal
type	String
CommodityCode	String
CountryOfOrigin	String
BatteryFlag	Boolean
HazmatFlag	Boolean
LiquidFlag	Boolean
FragileFlag	Boolean
MfgDateRequired	Boolean
ExpDateRequired	Boolean
BatchNumberRequired	Boolean
CountryOfOriginRequired	Boolean
SerialNumberRequired	Boolean
AltUnit	String
AltQuantity	Integer
AltUPC	String
AltLength	Decimal
AltWidth	Decimal
AltHeight	Decimal
AltWeight	Decimal

Response Example

{
    "id": 57234,
    "customerCode": "TEST",
    "sku": "YQ-9999997",
    "upc": "124445622565",
    "upc2": "124445622566",
    "upc3": "124445622567",
    "description": "Anker Powerline Cable (8ft)", 
    "description2": "MFi Certified for iPhone 11 / XS/XS Max/XR/X / 8/8 Plus / 7/7 Plus / 6/6 Plus",
    "commodityCode": "",
    "countryOfOrigin": "CN",
    "length": 5.45,
    "width": 3,
    "height": 2,
    "weight": 1.2,
    "expDateRequired": false,
    "MfgDateRequired": false,
    "CountryOfOriginRequired": true,
    "SerialNumberRequired": true,
    "BatchNumberRequired": true,
    "BatteryFlag": false,
    "HazmatFlag": false,
    "LiquidFlag": false,
    "FragileFlag": false,
    "altUnit": "Inner",
    "altUPC": "124445622565",
    "altQuantity": 4,
    "altLength": 11.65,
    "altWidth": 3.6,
    "altHeight": 4.12,
    "altWeight": 4.25
  }