POST /api/v1/supplier-items/parse
{"url":"https://mobile.yangkeduo.com/goods.html?goods_id=123","id":"123","title":"示例商品","shop_name":"示例店","shipping_fee_cents":0,"skus":[{"id":"sku1","name":"默认规格","price_cents":1299}]}
PUT /api/v1/items/123456/link
{"supplier_item_ids":["123"],"mappings":[{"local_sku_id":"skuA","supplier_item_id":"123","supplier_sku_id":"sku1","quantity":1,"note":""}]}
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.item_id
string
本店商品 ID
data.suppliers / mappings
array
更新后的关联
GET/api/v1/purchase-accounts
采购账号名称列表
只保存和返回账号显示名称,不接收采购平台密码、Cookie 或令牌。
请求参数
字段
类型
说明
无
—
无需请求体
GET /api/v1/purchase-accounts
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data[]
array
账号 id、name
POST/api/v1/purchase-accounts
登记采购账号名称
登记前端采购端使用的账号名称;请求体只允许 name。
请求参数
字段
类型
说明
name
string
账号显示名称,最多 100 字符
POST /api/v1/purchase-accounts
{"name":"采购账号 A"}
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.id / name
integer / string
账号 ID 和名称
GET/api/v1/settings/purchase
读取下单设置
设置按主账号保存。
请求参数
字段
类型
说明
无
—
无需请求体
GET /api/v1/settings/purchase
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.auto_purchase / lock_orders
boolean
自动处理开关、锁单开关
data.warn_repeat_address / warn_address_keywords
boolean
提示开关
data.address_keywords
string[]
地址关键字
PUT/api/v1/settings/purchase
修改下单设置
只更新提交的字段;自动采购由前端执行。
请求参数
字段
类型
说明
auto_purchase / lock_orders
boolean
开关
warn_repeat_address / warn_address_keywords
boolean
提醒开关
address_keywords
string[]
最多 50 个,每个最多 50 字
PUT /api/v1/settings/purchase
{"auto_purchase":false,"lock_orders":true}
POST /api/v1/orders/123/purchase
Idempotency-Key: purchase-123-001
{"purchase_account_id":1,"status":"success","purchase_order_no":"PD123","amount_cents":1299,"auto":false}
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.status
string
结果状态
data.purchase_order_no / amount_cents
string / integer
回传的采购单号和金额
data.account_name / reason
string
账号名称与说明
POST/api/v1/orders/:id/purchase/cancel
回传取消采购结果
前端先在采购端取消,再回传结果;仅成功时清空订单采购单号并保留历史事件。
请求参数
字段
类型
说明
Idempotency-Key
header
唯一请求键
status
string
success、failed、unknown
reason
string
失败或未知原因
POST /api/v1/orders/123/purchase/cancel
Idempotency-Key: cancel-123-001
{"status":"success","reason":""}
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.status / reason
string
取消结果与说明
POST/api/v1/orders/:id/skip
跳过待下单订单
保存跳过原因,待下单列表排除已跳过订单。
请求参数
字段
类型
说明
reason
string
sold_out、package_mismatch、price_too_high、other
note
string
补充说明,最多 500 字
POST /api/v1/orders/123/skip
{"reason":"sold_out","note":""}
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.skip_reason / skip_note
string
保存后的原因与说明
PUT/api/v1/orders/:id/remarks
修改订单备注
店铺备注及旗帜调用开放平台;软件备注保存本地数据库。请求必须带 shop_id。
请求参数
字段
类型
说明
shop_id
integer
订单所属店铺 ID
shop_remark / flag_color
string / integer
平台备注和 1–6 旗帜
software_remark
string
本地软件备注
PUT /api/v1/orders/123/remarks
{"shop_id":12,"software_remark":"已核对"}
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.seller_remark / seller_remark_flag
string / integer
已保存的平台备注及旗帜
data.software_remark
string
已保存的软件备注
GET/api/v1/auto-purchase/status
自动采购状态
查询是否开启和上次前端触发时间。
请求参数
字段
类型
说明
无
—
无需请求体
GET /api/v1/auto-purchase/status
返回字段说明
字段
类型
说明
ok
boolean
成功为 true;失败为 false
data
object / array
成功响应数据
data.enabled
boolean
自动采购设置
data.last_run_at
datetime / null
上次触发时间
POST/api/v1/auto-purchase/run
领取自动采购候选订单
返回最多 100 个待下单订单 ID 给前端处理。后端不执行采购,purchased、failed、unknown 在此响应中均为 0。