添加产品
URL | http://test.birdsystem.com/client/Product/ | ||
---|---|---|---|
接口功能 | 添加产品 | ||
支持格式 | 开发人员 | ||
请求方式 | POST | 发布日期 |
...
添加产品时, 需要以表单form的格式POST如下数据到接口: (注意不是json格式)
字段 | 注释 | 是否必填 | 类型 | |||
---|---|---|---|---|---|---|
name | 产品中文名称 | 必填 | VARCHAR(100) | |||
url | 链接 | VARCHAR(50) | ||||
name_customs | 产品英文名称 | 必填 | VARCHAR(100) | |||
material | 材质 | VARCHAR(50) | ||||
usage | 用途 | VARCHAR(50) | ||||
brand | 品牌 | VARCHAR(50) | ||||
color | 颜色 | VARCHAR(100) | ||||
model | 型号 | VARCHAR(100) | ||||
shape_type | 形状 | 普通形状NORMAL_SHAPE(默认) 轴状体NORMAL_SHAPE 不规则形状RREGULAR_SHAPE | ||||
customs_category_id | 海关分类编码ID | INT(10) . 参考接口: 获取海关分类 | ||||
product_product_customs_property[] | 产品属性 | INT(10) . 参考接口: 获取产品属性 . 这些属性ID一般不常变动. 如有多个海关属性, 请传多个同名的form 字段, 例如: product_product_customs_property[] = 1 | ||||
note | 备注 | VARCHAR(100) | ||||
client_ref | 客户自定义SKU编码(不能和其他SKU重复) | VARCHAR(50) | ||||
commodity_code | 商品报关编码 | VARCHAR(50) | ||||
weight | 重量 默认单位 g | DECIMAL(10,2) | ||||
length | 长度 默认单位 mm | DECIMAL(10,2) | ||||
width | 宽度 默认单位 mm | DECIMAL(10,2) | ||||
depth | 高度(深度)默认单位 mm | DECIMAL(10,2) | ||||
company_product-is_shared_internal | 是否是共享产品 | TINYINT(1) | ||||
description | 产品描述 | TEXT | ||||
company_product-price | 产品价格 (货币每个站点不同,详询客服) | FLOAT(8,2) | ||||
company_product-cost | 产品成本 (货币每个站点不同,详询客服) | FLOAT(8,2) | ||||
price_customs_import | 海关进口价格 (美元) | FLOAT(8,2) | ||||
price_customs_export | 海关出口价格(美元) | 必填 | FLOAT(8,2) | |||
sales_price | 销售价格 (美元) | FLOAT(8,2) | ||||
company_product-low_stock_level | 低库存报警线 | INT(5) | ||||
inventory_time | 在途产品入库时间 | INT(3) | ||||
attachment_url | 附件URL | VARCHAR(2000) 在创建或者更新产品时,同时上传一个或者多个附件, 一个URL指向一个附件,多个URL用\n换行符分隔. ps: 附件是在后台队列中异步下载的,不会马上体现在界面上,可以通过 “查看后台运行任务” 来查看队列任务 附件可以是图片,pdf, doc,excel等文档,与产品详细页面的附件上传是同一个功能。 | ||||
override_old_attachment | 是否覆盖旧的附件 (仅更新产品时有效) | TINYINT(1) 当当前请求是修改已有产品,且有提供附件时, 是否要覆盖掉旧的附件 | ||||
status | 不填写时,默认为preparing; 当值为PENDING时,添加的产品直接是待处理状态,不需要再更改状态 | ENUM('PREPARING','PENDING') | ||||
is_need_to_record_sn | 是否需要记录产品sn唯一码 | BOOL | ||||
country_of_origin | 产地 | 国家的二字码:CN, GB 等 | sales_price | 平台销售价格 | FLOAT(8,2) |
示例:
Markdown |
---|
```shell # 需要指定客户sku的,请添加 -d 'client_ref=your_sku' curl -X POST \ https://test.birdsystem.com/client/product \ -H 'api_key: 248ccb90dff2b99465b54c113765360c' \ -H 'company_id: 36' \ -H 'content-type: application/x-www-form-urlencoded' \ -d 'name=test' \ -d 'name_customs=test' \ -d 'customs_category_id=4' \ -d 'material=test material' \ -d 'usage=test usage' \ -d 'brand=test brand' \ -d 'product_product_customs_property[]=0' \ -d 'price_customs_export=3' |
...