创建/编辑产品 V2(字段覆盖完整)

请求参数

Body 参数application/json

nameEn

string

品名（英文）

必需

示例值:

uat_19_test_5

name

string

品名

必需

示例值:

uat_19_test_5

lineCode

string

项目code

必需

示例值:

demo

erpSku

string

erpSku

必需

示例值:

uat_19_test_5

erpSkuCode

string

自定义产品编码

可选

示例值:

uat_19_test_5

categoryCode

string

品类

可选

示例值:

101001001

factoryCode

string

工厂编码

可选

示例值:

uat_19_test_5

isSeasonal

integer

必需

是否是季节性：1.是;0.否

示例值:

seasonalSalesCycle

string

可选

季节性周期开始,结束 1,2 (逗号分割)

status

integer

必需

补货状态 0正常补货 1-不再补货

示例值:

ean

string

EAN

可选

示例值:

ean1234567890

brand

string

品牌

可选

示例值:

model

upc

string

UPC

可选

示例值:

upc

asin

string

Asin

可选

示例值:

asin

model

string

Model

可选

示例值:

model

productType

integer

必需

产品类型 1成品,2配件，3耗材

示例值:

unit

string

必需

最小销售单位 Bag, Bar, Bottle, Box, Bundle, Carton, Dozen, Ea, Pair, Pcs, Piece, Set, Unit

示例值:

Pcs

isCalculateCost

integer

必需

是否计算成本 1.是;0.否

示例值:

fobPrice

number

FOB(USD)

可选

saleLocation

integer

可选

销售定位 0-无, 1-NEW, 2-Core, 3-Normal, 5-Discontinued-w/ Inventory, 6-Discontinued-w/o Inventory

示例值:

countryOfOrigin

string

原产地

可选

示例值:

length

number

产品长

可选

示例值:

width

number

产品宽

可选

示例值:

height

number

产品高

可选

示例值:

weight

number

产品毛重

可选

示例值:

sizeUnit

string

必需

单品外包装尺寸单位inch/cm

示例值:

inch

weightUnit

string

必需

产品毛重单位 g/oz/lb

示例值:

dangerous

integer

必需

是否危险品1.是;0.否

isRequireSn

integer

必需

是否启用序列号 1.是;0.否

示例值:

warehouse

object

仓库发货信息

可选

packingType

string

必需

运输包装方式 REPACK，ORIGINAL

示例值:

REPACK

isSignService

integer

必需

签名服务 0-否 1-直接签收 2-承认签收 3-间接签收

示例值:

isInsurance

string

快递保价 Y/N

必需

示例值:

insuranceRate

number

投保金额(USD)

必需

示例值:

prePackedQty

integer

单包装销售件数

可选

示例值:

shapeType

integer

必需

包装形状长方体-0, 1-异形体

示例值:

materialType

integer

必需

包装材质 0-纸箱 1-其他

示例值:

isMagnetism

integer

必需

是否带磁 1-是，0-否

示例值:

isLiquid

integer

必需

是否含液体 1-是，0-否

示例值:

isFragile

integer

必需

是否易碎1-是，0-否

示例值:

isAllowStack

integer

必需

是否允许堆叠 1-是，0-否默认是

示例值:

isContainBattery

integer

必需

是否带电1-是，0-否

hasTie

integer

必需

是否扎带 1.是;0.否

示例值:

batteryRequest

object

必需

batteryPower

integer

电池功率(WH)

可选

batteryWeight

number

电池锂离子含量 g

可选

batteryLabel

integer

可选

是否已经张贴电池标1.是;0.否

batteryLabelType

integer

可选

电池标类型"0-UN3480 ，1-UN3481_C， 2-UN3090，3-UN3171，4-UN3091_P，5-UN3091_C，6-UN3481_P

batteryQty

integer

电池数量

可选

uncall

string

电池标电话

可选

netWeight

number

电池净重 kg

可选

innerPackCode

string

可选

METAL_RECEPTACLES_400KG, SINGLE_PACKAGING_400KG, AEROSOL_CANS_NON_REFILLABLE_400KG, FIBER_BOX_400KG, FIBER_CANS_400KG, GLASS_400KG, GLASS_AMPOULES_400KG, METAL_CAN_ALUMINIUM_400KG, METAL_TUBE_400KG, MULTI_WALL_PAPER_BAGS_400KG, PLASTIC_BAGS_400KG, PLASTIC_RECEPTACLES_400KG, PLASTIC_TUBE_400KG, SEATBELT_MODULE_400KG, TUBE_OTHER_THAN_ALUMINIUM_400KG, TUBES_ALUMINIUM_400KG

outerPackCode

string

可选

A1_BOX_200_BURST_A2_ANYTHING_HERE_MAKE_IT_UN_BOX, ALUMINUM_DRUM_1B2_E_DRUM, ALUMINUM_DRUM_6HB1_E_DRUM, ALUMINUM_JERRICAN_3B1_E_DRUM, ALUMINUM_JERRICAN_3B2_E_DRUM, AUTO_AUTO_BOX, CYLINDER_DOT31FP_CYLINDER, CYLINDER_DOT3AA_CYLINDER, DOT_SP_10529_DOT_SP_10529_BOX, DOT_SP_10672_ATA_300_BOX, DOT_SP_10977_DOT_SP_10977_BOX, DOT_SP_11248_DOT_SP_11248_BOX, DOT_SP_8249_DOT_SP_8249_BOX, DOT7A_DOT7A_BOX, DRUM_1H2_TEST_E_DRUM, FIBER_DRUM_1D_E_DRUM, FIBER_DRUM_1G_1G_Y_DRUM, FIBER_DRUM_6HG1_E_DRUM, FIBERBOARD_BOX_E_BOX, FIBERBOARD_BOX_4G_4G_Y35_S_23_CN_C232611_BOX, FIBERBOARD_BOX_4G_4GY35_S_23_CN_C293012_BOX, FIBERBOARD_BOX_4G_4G_Y25_S_20_CN_C232713_BOX, FIBERBOARD_BOX_4G62_4G_CLASS6_2_97_USA_BOX, FIBERBOARD_BOX_4G_4G_Y16_S_23_CN_C520056_BOX, METAL_DRUM_1N1_OR_1N2_1N1_Y_DRUM, OUTER_PACKAGING_PACKAGE_IDENTIFIER_BOX, PAPER_BAGS_E_BOX, PLASTIC_BOX_4H1_E_BOX, PLASTIC_BOX_4H2_E_BOX, PLASTIC_BOX_SOLID_4H1_Y_BOX, PLASTIC_DRUM_1H1_E_DRUM, PLASTIC_DRUM_1H2_E_DRUM, PLASTIC_DRUM_1H2_TEST_E_DRUM, PLASTIC_DRUM_6HH1_E_DRUM, PLASTIC_JERRICAN_3H1_E_DRUM, PLASTIC_JERRICAN_3H2_E_DRUM, PLYWOOD_BOX_4D_E_BOX, PLYWOOD_BOX_6HD2_E_BOX, PLYWOOD_DRUM_6HD1_E_DRUM, RADIOACTIVE_TYPE_A_DOT_TYPE_A_BOX, RADIOACTIVE_TYPE_B_DOT_TYPE_B_BOX, STEEL_BOX_4A_E_BOX, STEEL_BOX_4B_E_BOX, STEEL_BOX_6HA2_E_BOX, STEEL_DRUM_1A2_Y_DRUM, STEEL_DRUM_1A1_1A1_X1_2_250_11_USA_DRUM, STEEL_DRUM_1A1_1A1_Z30_S_18_USA_DRUM, STEEL_DRUM_1A2_1A2_Y70_S_11_USA_DRUM, STEEL_DRUM_6HA1_E_DRUM, STEEL_JERRICAN_3A1_E_DRUM, STEEL_JERRICAN_3A2_E_DRUM, WOODEN_BOX_4C1_E_BOX, WOODEN_BOX_4C2_E_BOX, WOODEN_BOX_4F_E_BOX, WOODEN_BOX_6HC_E_BOX

packages

object

头程信息

必需

cartonMaterialType

integer

必需

外箱包装材质0-纸箱 1-其他

示例值:

packedLength

number

长

必需

示例值:

packedWidth

number

宽

必需

示例值:

packedHeight

number

高

必需

示例值:

packedWeight

number

重

必需

示例值:

cartonMaxStacking

integer

最高可堆叠层数

可选

packedSizeUnit

string

必需

外箱尺寸单位 inch/cm

示例值:

inch

packedWeightUnit

string

必需

外箱毛重单位 g/oz/lb

示例值:

cartonPackedQty

integer

装箱入数

必需

示例值:

htsName

string

报关品名(中文)

必需

示例值:

htsNameEn

string

报关品名(英文)

必需

示例值:

htsCode

string

中国报关代码

可选

customs

array [object {6}]

清关信息

可选

countryCode

string

国家编码

可选

customCode

string

HS Code

可选

示例值:

importTaxRate

number

关税

可选

customDiscountRate

number

折扣率

可选

customRemark

string

清关说明

可选

示例值:

antcipatedFreight

number

预估运费

可选

pictures

array [object {2}]

图片信息

可选

pictureName

string

文件名

可选

示例值:

1729508620040.png

file

string

base64编码

可选

示例值:

returnDealMethod

integer

可选

客退货物外观破损处理方式0-客户自提 1-拍照确认 2-销毁 5-仓库确认

示例值:

isDistribution

integer

可选

是否允许分销：1.是;0.否

示例值:

productMidCondition

string

产品状况

可选

示例值:

productMidModel

string

产品型号

可选

示例值:

productMidMeta

string

备注1

可选

示例值:

productMidStandard

string

备注2

可选

示例值:

示例

{
  "nameEn": "uat_19_test_5",
  "name": "uat_19_test_5",
  "lineCode": "demo",
  "erpSku": "uat_19_test_5",
  "erpSkuCode": "uat_19_test_5",
  "categoryCode": "101001001",
  "factoryCode": "uat_19_test_5",
  "isSeasonal": 0,
  "seasonalSalesCycle": "string",
  "status": 0,
  "ean": "ean1234567890",
  "brand": "model",
  "upc": "upc",
  "asin": "asin",
  "model": "model",
  "productType": 1,
  "unit": "Pcs",
  "isCalculateCost": 0,
  "fobPrice": 0,
  "saleLocation": 1,
  "countryOfOrigin": "US",
  "length": 12,
  "width": 12,
  "height": 12,
  "weight": 12,
  "sizeUnit": "inch",
  "weightUnit": "lb",
  "dangerous": 0,
  "isRequireSn": 1,
  "warehouse": {
    "packingType": "REPACK",
    "isSignService": 1,
    "isInsurance": "Y",
    "insuranceRate": 11,
    "prePackedQty": 1,
    "shapeType": 0,
    "materialType": 0,
    "isMagnetism": 0,
    "isLiquid": 0,
    "isFragile": 1,
    "isAllowStack": 1,
    "isContainBattery": 0
  },
  "hasTie": 1,
  "batteryRequest": {
    "batteryPower": 0,
    "batteryWeight": 0,
    "batteryLabel": 0,
    "batteryLabelType": 0,
    "batteryQty": 0,
    "uncall": "string",
    "netWeight": 0,
    "innerPackCode": "string",
    "outerPackCode": "string"
  },
  "packages": {
    "cartonMaterialType": 0,
    "packedLength": 12,
    "packedWidth": 12,
    "packedHeight": 12,
    "packedWeight": 12,
    "cartonMaxStacking": 0,
    "packedSizeUnit": "inch",
    "packedWeightUnit": "lb"
  },
  "cartonPackedQty": 1,
  "htsName": "11",
  "htsNameEn": "11",
  "htsCode": "string",
  "customs": [
    {
      "countryCode": "string",
      "customCode": "11",
      "importTaxRate": 0,
      "customDiscountRate": 0,
      "customRemark": "11",
      "antcipatedFreight": 0
    }
  ],
  "pictures": [
    {
      "pictureName": "1729508620040.png",
      "file": ""
    }
  ],
  "returnDealMethod": 1,
  "isDistribution": 1,
  "productMidCondition": "11",
  "productMidModel": "11",
  "productMidMeta": "11",
  "productMidStandard": "11"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://hwc-open-api.yqn.com/v1/product/saveV2' \
--header 'Content-Type: application/json' \
--data-raw '{
    "nameEn": "uat_19_test_5",
    "name": "uat_19_test_5",
    "lineCode": "demo",
    "erpSku": "uat_19_test_5",
    "erpSkuCode": "uat_19_test_5",
    "categoryCode": "101001001",
    "factoryCode": "uat_19_test_5",
    "isSeasonal": 0,
    "seasonalSalesCycle": "string",
    "status": 0,
    "ean": "ean1234567890",
    "brand": "model",
    "upc": "upc",
    "asin": "asin",
    "model": "model",
    "productType": 1,
    "unit": "Pcs",
    "isCalculateCost": 0,
    "fobPrice": 0,
    "saleLocation": 1,
    "countryOfOrigin": "US",
    "length": 12,
    "width": 12,
    "height": 12,
    "weight": 12,
    "sizeUnit": "inch",
    "weightUnit": "lb",
    "dangerous": 0,
    "isRequireSn": 1,
    "warehouse": {
        "packingType": "REPACK",
        "isSignService": 1,
        "isInsurance": "Y",
        "insuranceRate": 11,
        "prePackedQty": 1,
        "shapeType": 0,
        "materialType": 0,
        "isMagnetism": 0,
        "isLiquid": 0,
        "isFragile": 1,
        "isAllowStack": 1,
        "isContainBattery": 0
    },
    "hasTie": 1,
    "batteryRequest": {
        "batteryPower": 0,
        "batteryWeight": 0,
        "batteryLabel": 0,
        "batteryLabelType": 0,
        "batteryQty": 0,
        "uncall": "string",
        "netWeight": 0,
        "innerPackCode": "string",
        "outerPackCode": "string"
    },
    "packages": {
        "cartonMaterialType": 0,
        "packedLength": 12,
        "packedWidth": 12,
        "packedHeight": 12,
        "packedWeight": 12,
        "cartonMaxStacking": 0,
        "packedSizeUnit": "inch",
        "packedWeightUnit": "lb"
    },
    "cartonPackedQty": 1,
    "htsName": "11",
    "htsNameEn": "11",
    "htsCode": "string",
    "customs": [
        {
            "countryCode": "string",
            "customCode": "11",
            "importTaxRate": 0,
            "customDiscountRate": 0,
            "customRemark": "11",
            "antcipatedFreight": 0
        }
    ],
    "pictures": [
        {
            "pictureName": "1729508620040.png",
            "file": ""
        }
    ],
    "returnDealMethod": 1,
    "isDistribution": 1,
    "productMidCondition": "11",
    "productMidModel": "11",
    "productMidMeta": "11",
    "productMidStandard": "11"
}'

application/json

Body

statusCode

integer

必需

status

integer

必需

code

integer

必需

message

string

必需

示例

{
  "statusCode": 200,
  "status": 0,
  "code": 200,
  "message": "产品创建成功"
}

请求参数

示例代码

返回响应