Item Creation

Create your SKU information into Best system. Single SKU per request.

• URL: {API root URL}/items
• Method: POST

Request

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, up to 30 characters.
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.
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": "Test Powerline II Cable (8ft)", 
    "description2": "MFi Certified for 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

Response Example

{
    "id": 57234,
    "customerCode": "TEST",
    "upc": "1244432232565",
    "sku": "YQ-9995557",
    "description": "Test Powerline Cable (12ft)",
    "description2": "MFi Certified for 11 / XS/XS Max/XR/X / 8/8 Plus / 7/7 Plus / 6/6 Plus",
    "itemUnit": "Each",
    "length": 5.45,
    "width": 3.0,
    "height": 2.0,
    "lengthUnit": "Inch",
    "weight": 1.12,
    "weightUnit": "Pound",
    "status": "Creating",
    "commodityCode": "",
    "countryOfOrigin": "CN",
    "expDateRequired": false,
    "mfgDateRequired": false,
    "countryOfOriginRequired": true,
    "serialNumberRequired": true,
    "batchNumberRequired": true,
    "batteryFlag": false,
    "hazmatFlag": false,
    "liquidFlag": false,
    "fragileFlag": false,
    "altUnit": "Inner",
    "altUPC": "12444135565",
    "altQuantity": 4,
    "altLength": 11.65,
    "altWidth": 3.26,
    "altHeight": 4.12,
    "altWeight": 4.25
}