Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
| Table of Contents |
|---|
1接口说明：
url | |||
接口功能 | 添加产品 | ||
支持格式 | JSON | 开发人员 | |
请求方式 | POST | 发布日期 | |
请求参数说明：
参数 | 必选 | 类型 | 说明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
product_id |
| INT(10) | 产品id | ||||||
consignment_id |
| BINGINT(16) | 订单ID | ||||||
product_type |
| VARCHAR | 产品类型,默认“NORMAL” | ||||||
quantity |
| INT | 数量 | ||||||
is_directional_shared_product |
| BOOL | 是否定向共享产品 | ||||||
ebay_transaction_id |
| VARCHAR | eBay订单交易号 | ||||||
ebay_item_no |
| VARCHAR | eBay产品ID |
参数说明：
参数 | 类型 | 说明 |
|---|---|---|
sold_quantity | INT | 出售数量 |
count | INT | 产品数量 |
product_customs_name | VARCHAR | 海关属性名称 |
product_weight | float(‘%.2f’) | 产品重量 |
total_price_customs_export | float(‘%.3f’) | 总出口报关价 |
product_client_ref | VARCHAR | 产品SKU |
id | INT | 订单产品列表ID |
product_id | INT | 产品ID |
consignment_id | INT | 订单ID |
quantity | INT | 数量 |
unit_product_price | float(‘%.2f’) | 产品单价 |
unit_product_cost | float(‘%.2f’) | 产品成本 |
unit_product_length | float(‘%.2f’) | 产品长 |
unit_product_width | float(‘%.2f’) | 产品宽 |
unit_product_depth | float(‘%.2f’) | 产品高 |
unit_product_weight | float(‘%.2f’) | 产品重 |
price_customs_export | float(‘%.3f’) | 出口报关价 |
price_customs_export_internal | float(‘%.3f’) | 内部出口报关价 |
price_customs_export_origin | float(‘%.3f’) | 出口报关价来源 |
price_customs_export_internal_origin | float(‘%.3f’) | 内部出口报关价来源 |
sn | VARCHAR | SN唯一码（sn !=product_id && sn != product_client_ref） |
product_type | VARCHAR | 产品类型:[“NORMAL”||“DIRECTIONAL”] |
primary_keys | VARCHAR | 主键：[“id”] |
2、接口示例：
接口请求示例
URL:http://test.birdsystem.com/client/Consignment-Product
请求接口示例
| Code Block | ||
|---|---|---|
| ||
#api_key和company_id和提交数据中consignment_id &product_id需要替换成实际数据
-Headers 'api_key: {{bs.default_api_key}}' \ #所需登录站点company_id
-Headers 'company_id: {{bs.default_company_id}}' \ #所需登录账号的api_key
-Headers 'content-type: application/x-www-form-urlencoded' \ |
接口请求参数示例
（一次请求只能推送一次产品，多件产品需推送多次）
| Code Block | |||
|---|---|---|---|
| |||
{ "consignment_id:2012140360000997 ":2011180360000239, "product_id:2989354 quantity:1":2989352, "quantity":1 } |
接口返回示例
| Code Block | ||
|---|---|---|
| ||
{
"data": {
"sold_quantity": null,
"count": null,
"product_customs_name": null,
"product_weight": null,
"total_price_customs_export": null,
"product_client_ref": null,
"id": 71525956,
"product_id": 2989354,
"consignment_id": 2012140360000997,
"quantity": "2",
"unit_product_price": "2.00",
"unit_product_cost": "0.00",
"unit_product_weight": "50.00",
"unit_product_length": "50.00",
"unit_product_width": "50.00",
"unit_product_depth": "50.00",
"price_customs_export": "5.000",
"price_customs_export_internal": "1.000",
"price_customs_export_origin": "0.000",
"price_customs_export_internal_origin": "0.000",
"sn": null,
"product_type": "NORMAL",
"primary_keys": [
"id"
]
},
"success": true,
"moduleName": "client"
} |
返回异常示例（检查产品ID是否允许添加产品或检查产品是否正常，库存是否充足）
| Code Block | ||
|---|---|---|
| ||
{
"success": false,
"message": "Can not find product by id [2989352222]."
} |