OPEN-API-客户对接【外】
  1. 产品
OPEN-API-客户对接【外】
  • 默认分组
    • 产品
      • sku批量分页查询
        POST
      • 创建/编辑产品 V2(字段覆盖完整)
        POST
      • 新增箱商品
        POST
      • 创建/编辑 产品
        POST
      • 创建产品识别码
        POST
      • 查询 sku
        POST
      • 渠道产品---渠道产品关系查询
        GET
    • 入库计划单
      • 入库计划创建修改(支持默认草稿状态可编辑)
      • 修改发运信息
      • 船公司代码列表
      • 入库计划分页查询
      • 入库计划创建
      • 入库计划发运操作
      • 入库计划添加附件
      • 取消入库订单
      • 查询入库信息
    • 库存
      • 批量查询库龄
      • 批量查询库存
      • 查询库存
      • winit快照查询
      • 查询库内变更明细
      • 库存批次明细查询
    • 订单
      • 测算
      • 创建销售订单(带附件的 )
      • 获取订单的详细信息
      • 获取订单的详细信息(获取店铺订单)
      • 订单-- 查询列表
      • 订单上传附件
      • 订单取消
    • 退货
      • 退货单物流追踪
      • 退货条目处理
      • 退货附件上传
      • 删除附件
      • 退货计划确认处理
      • 创建销售退货
      • 销售退货取消
      • 销售退货计划查询
    • 调拨
      • 创建
      • 取消(根据来源单号)
      • 上传附件
      • 查看
    • 预约
      • 查询是否可预约
    • 基础数据
      • 查询仓库
      • 根据仓库编码查询产品服务列表
    • 三方授权
      • 开发者账号注册
      • 应用注册
      • 服务商授权
    • 运费
      • 运费结算明细查询
    • 费用
      • 结算明细
  1. 产品

创建/编辑 产品

POST
https://hwc-open-api.yqn.com/v1/product/save

请求参数

Header 参数
x-api-key
string 
必需
示例值:
abc123(认证信息)
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
sku
string 
产品sku
必需
customItemNo
string 
自定义产品编码
可选
upc
string 
upc编码
可选
productType
integer 
可选
产品类型 1:成品 2:配件 3:耗材 (不填默认为成品)
name
string 
中文名称
必需
nameEn
string 
英文名称
必需
description
string 
可选
产品描述(不填默认为产品英文名称nameEn)
packingType
integer 
必需
产品发货包装 0:原包装发货 1:重新打包
length
number 
产品长(cm)
必需
width
number 
产品宽(cm)
必需
height
number 
产品高(cm)
必需
weight
number 
产品重量(g)
必需
itemLength
number 
单品长(cm)
可选
itemWidth
number 
单品宽(cm)
可选
itemHeight
number 
单品高(cm)
可选
expirationControl
integer 
可选
保质期管理 0:否 1:是 不填默认为否
expirationDate
integer 
保持期时间(天数)
可选
packedQty
integer 
装箱数量
可选
packedLength
number 
外箱长(cm)
必需
packedWidth
number 
外箱宽(cm)
必需
packedHeight
number 
外箱高(cm)
必需
packedWeight
number 
外箱重量(g)
必需
cost
number 
成本
可选
currency
string 
币种
可选
isInsuranceFlag
string 
可选
产品是否保价 N:否; Y:是 不填默认为否
isInsuranceRate
number 
保价费用
可选
remark
string 
备注
可选
customName
string 
报关 中文名
可选
customNameEn
string 
报关英文名称
可选
isRequireSn
integer 
必需
是否需要SN 0 否 1 是 不填默认为否
示例
{
    "sku": "string",
    "customItemNo": "string",
    "upc": "string",
    "productType": 0,
    "name": "string",
    "nameEn": "string",
    "description": "string",
    "packingType": 0,
    "length": 0,
    "width": 0,
    "height": 0,
    "weight": 0,
    "itemLength": 0,
    "itemWidth": 0,
    "itemHeight": 0,
    "expirationControl": 0,
    "expirationDate": 0,
    "packedQty": 0,
    "packedLength": 0,
    "packedWidth": 0,
    "packedHeight": 0,
    "packedWeight": 0,
    "cost": 0,
    "currency": "string",
    "isInsuranceFlag": "string",
    "isInsuranceRate": 0,
    "remark": "string",
    "customName": "string",
    "customNameEn": "string",
    "isRequireSn": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://hwc-open-api.yqn.com/v1/product/save' \
--header 'x-api-key: abc123(认证信息)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sku": "string",
    "customItemNo": "string",
    "upc": "string",
    "productType": 0,
    "name": "string",
    "nameEn": "string",
    "description": "string",
    "packingType": 0,
    "length": 0,
    "width": 0,
    "height": 0,
    "weight": 0,
    "itemLength": 0,
    "itemWidth": 0,
    "itemHeight": 0,
    "expirationControl": 0,
    "expirationDate": 0,
    "packedQty": 0,
    "packedLength": 0,
    "packedWidth": 0,
    "packedHeight": 0,
    "packedWeight": 0,
    "cost": 0,
    "currency": "string",
    "isInsuranceFlag": "string",
    "isInsuranceRate": 0,
    "remark": "string",
    "customName": "string",
    "customNameEn": "string",
    "isRequireSn": 0
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
  "statusCode": 200,
  "status": 0,
  "code": 200,
  "message": "产品创建成功"
}
修改于 2025-05-26 06:32:19
上一页
新增箱商品
下一页
创建产品识别码
Built with