Ever Connect
v1.4.0中文·EN·한국어登录申请接入
批发订单

创建批发订单(默认只建草稿,auto_confirm=true 才提交审核)

POST/api/v1/orders需要 tokenorder:write写操作2 点

创建批发订单(默认只建草稿,auto_confirm=true 才提交审核)。OMS 账号登录时要有物流信息:shipping 里给 shipping_method_id(见 /shipping-methods)+ address_id(见 /addresses);不传则用你 OMS 账号里的默认设置

请求体(JSON)

字段类型说明
warehouse_code 必填string仓库编码:AU(澳洲(全部仓合计),合计视图)、AUSYD2(悉尼主仓(Rosehill))、AUSYD1(悉尼配件仓)、CN(中国(全部仓合计),合计视图)、CHNZJ1(中国镇江仓)。AU / CN 是公司级合计视图,其余是真实仓;完整清单看 GET /api/v1/warehouses。
lines 必填array<object>明细数组,每项 { sku, quantity }。至少一项;quantity=0 在调整锁单 / 购物车时表示去掉这一行。
1–1000
lines[].sku 必填stringSKU / 条码——具体到颜色和尺码的那一层,如 OB0021611。查整个款请改用 product_code。
最长 64
lines[].quantity 必填integer件数,正整数,如 2。锁单调整 / 购物车里传 0 表示去掉这一行。
0–99999
notestring备注(选填,最长 500 字)。
最长 500
client_order_numberstring你自己系统里的订单号(下代发单时传的那个)。
最长 64
auto_confirmboolean是否直接提交(选填)。不传 = 只保存草稿,需要人在 ERP 里确认后才生效——这是有意的默认。代发单提交后会立刻配货、无法再修改。
shippingobject物流信息(用 OMS 账号登录下批发单时必需)。里面:shipping_method_id(发货方式,见 GET /api/v1/shipping-methods)、address_id(收货地址,见 GET /api/v1/addresses)、carrier_id(物流公司,选填)、pickup_at(自取时间,自取方式才填)。整个不传则用你 OMS 账号里的默认设置;默认也没设会报错并指路。
shipping.shipping_method_idstring发货方式编号,从 GET /api/v1/shipping-methods 取。
最长 64
shipping.carrier_idstring物流公司编号(选填),从 GET /api/v1/carriers 取。
最长 64
shipping.address_idstring收货地址编号,从 GET /api/v1/addresses 取。地址簿在 OMS 网站「用户 → 偏好设置 → 批发收货地址」里维护。
最长 64
shipping.pickup_atstring自取时间(选填,自取方式才用),如 2026-09-10T14:00:00。
最长 32

响应

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

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