Ever Connect
v1.4.0中文·EN·한국어登录申请接入
购物车

添加 / 更新购物车条目(幂等)

PUT/api/v1/carts/{account}/lines需要 tokencart:write写操作2 点

路径参数

名称类型说明
account 必填string购物车所属账号(OMS 网站的登录账号,如 100470admin)。
最长 64

请求体(JSON)

字段类型说明
lines 必填array<object>明细数组,每项 { sku, quantity }。至少一项;quantity=0 在调整锁单 / 购物车时表示去掉这一行。
1–500
lines[].sku 必填stringSKU / 条码——具体到颜色和尺码的那一层,如 OB0021611。查整个款请改用 product_code。
最长 64
lines[].quantity 必填integer件数,正整数,如 2。锁单调整 / 购物车里传 0 表示去掉这一行。
0–99999

响应

响应信封只看 HTTP 状态码:成功是 2xx,正文 { data: … }(列表另带 page / page_size / has_moretotal_count);失败是 4xx / 5xx,正文 { error: { code, message, hint, request_id, doc_url } }

写操作请带 Idempotency-Key 头(任意唯一串,如 UUID):网络重试不会重复下单。下单默认只建草稿,由人在 ERP 确认后生效。