帮助中心
< 所有主题
Print

创建商品SKU

更新于

在 系统中创建您的商品SKU信息。

  • 请求地址: {API root URL}/items
  • 请求方法: POST

请求

请求参数

名称是否必须类型描述
customerCode是 String百世系统分配的客户代码
sku是String识别商品的 SKU 编号，最多 30 个字符
description是String商品SKU的名称
description2String更多有关商品SKU的描述
upc是String产品标签的UPC条码或自定义库存编码。 仓库在入库或拣货 时扫描此代码来识别您的商品
upc2String附加UPC代码 1
upc3String附加UPC代码 2
length是DecimalSKU 的长度， 单位为英寸
width是DecimalSKU 的宽度， 单位为英寸
height是DecimalSKU 的高度， 单位为英寸
weight是DecimalSKU 的重量， 单位为英磅
commodityCodeString海关编码，如果商品会运送到美国以外的地方，请提供此代码
countryOfOriginString商品原产国的 ISO Alpha-2 代码，如果商品会运送到美国以外的地方，请提供此代码。要查看每个国家/地区的 Alpha-2 代码，请参阅以下页面：https://www.iso.org/obp/ui/#search
batteryFlagBoolean指出该商品是否包含电池，如果不指定值，系统将设置为 False （没有）
hazmatFlagBoolean
指出该商品是否为危险品，如果不指定值，系统将设置为 False （没有）
liquidFlagBoolean指出该商品是否包含液体，如果不指定值，系统将设置为 False （没有）
fragileFlagBoolean指出该商品是否是易碎品，如果不指定值，系统将设置为 False （没有）
mfgDateRequiredBoolean指出该商品在入仓时，是否需要记录制造日期。在为该字段发送 True 之前，请务必联系您的百世客户经理在您的帐户设置中启用此功能。如果不指定值，系统将设置为 False （不需要）。
expDateRequiredBoolean指出该商品在入仓时，是否需要记录过期日期。在为该字段发送 True 之前，请务必联系您的百世客户经理在您的帐户设置中启用此功能。如果不指定值，系统将设置为 False （不需要）。
batchNumberRequiredBoolean指出该商品在入仓时，是否需要记录批次号。在为该字段发送 True 之前，请务必联系您的百世客户经理在您的帐户设置中启用此功能。如果不指定值，系统将设置为 False （不需要）。
countryOfOriginRequiredBoolean指出该商品在入仓时，是否需要记录原产国。在为该字段发送 True 之前，请务必联系您的百世客户经理在您的帐户设置中启用此功能。如果不指定值，系统将设置为 False （不需要）。
serialNumberRequiredBoolean指出该商品在入仓时，是否需要记录序列号。如果不指定值，系统将设置为 False （不需要）。
altUnitString如果适用，请指明商品SKU 在单件以外的单位类型，可用值为 Carton（外箱）。
注意：Carton（外箱）为固定单位的纸箱。例如，您有一款商品, A001。如果有外包箱是固定为 12 个单位的 A001，就适合建立Carton（外箱）记录。在入库的时候，扫描 1 个外箱标，仓库就会知道有 12 个单位的 A001。可以直接上架， 无需开箱逐一计数。同时在出库时， 如果一个包含 120 个单位的 A001的订单，仓库系统会指示拣货员挑选 10 箱而不是 120 个单位。
altQuantityInteger每个外箱包含多少个单件。例如一个外包箱是固定包装12 个单位，这里的值即为 12.
altUPCString外箱标的UPC条码或自定义库存编码。 仓库在入库或拣货时扫描此代码来识别整箱商品
altLengthDecimalCarton（外箱）的长度（单位为英寸）
altWidthDecimalCarton（外箱）的宽度（单位为英寸）
altHeightDecimalCarton（外箱）的高度（单位为英寸）
altWeightDecimalCarton（外箱）的重量（单位为英寸）

请求示例

{
    "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
  }

响应

响应参数

名称类型
Id ( 系统内部的 SKU ID)Integer
customerCodeString
skuString
descriptionString
description2String
upcString
upc2String
upc3String
lengthDecimal
widthDecimal
heightDecimal
weightDecimal
commodityCodeString
countryOfOriginString
batteryFlagBoolean
hazmatFlagBoolean
liquidFlagBoolean
fragileFlagBoolean
mfgDateRequiredBoolean
expDateRequiredBoolean
batchNumberRequiredBoolean
countryOfOriginRequiredBoolean
serialNumberRequiredBoolean
altUnitString
altQuantityInteger
altUPCString
altLengthDecimal
altWidthDecimal
altHeightDecimal
altWeightDecimal

响应示例

{
    "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
}
目录