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

创建代发订单：一单一个 SKU；收件人（澳新地址要 state / city / postal_code）；shipping normal / express；auto_confirm=true 才提交配货（提交后不能改）

POST/api/v1/dropship-orders需要 tokendf:write写操作2 点

请求体（JSON）

字段类型说明
warehouse_code 必填string仓库编码：AU（澳洲（全部仓合计），合计视图）、AUSYD2（悉尼主仓（Rosehill））、AUSYD1（悉尼配件仓）、CN（中国（全部仓合计），合计视图）、CHNZJ1（中国镇江仓）。AU / CN 是公司级合计视图，其余是真实仓；完整清单看 GET /api/v1/warehouses。
sku 必填stringSKU / 条码——具体到颜色和尺码的那一层，如 OB0021611。查整个款请改用 product_code。
最长 64
quantity 必填integer件数，正整数，如 2。锁单调整 / 购物车里传 0 表示去掉这一行。
1–99999
recipient 必填object收件人对象 { name, phone, address, country_code, state, city, postal_code }。country_code 用 AU / CN / NZ；寄澳洲、新西兰时 state / city / postal_code 必填。跨境件电话请带国际区号（如 +61…），地址请含门牌——地址不全是派送失败最常见的原因。
recipient.name 必填string收件人姓名，写全名（快递面单上打印的就是它）。
最长 128
recipient.phone 必填string收件人电话。跨境件请带国际区号（如 +61…），否则清关和派送可能联系不上。
最长 64
recipient.address 必填string收件地址，请含门牌。地址不全是派送失败最常见的原因。
最长 512
recipient.country_code 必填string收件国家：AU 澳洲 / CN 中国 / NZ 新西兰（代发只支持这三国）。
recipient.statestring州 / 省，如 NSW。寄澳洲、新西兰时必填。
最长 64
recipient.citystring城市，如 Sydney。寄澳洲、新西兰时必填。
最长 128
recipient.postal_codestring邮编，如 2000。寄澳洲、新西兰时必填。
最长 16
senderobject发件人对象 { name, phone }（选填），印在面单上的寄件人。
sender.namestring收件人姓名，写全名（快递面单上打印的就是它）。
最长 128
sender.phonestring收件人电话。跨境件请带国际区号（如 +61…），否则清关和派送可能联系不上。
最长 64
shipping_methodstring运输方式：normal 普通（默认）/ express 特快 / ems 邮政EMS。
auto_confirmboolean是否直接提交（选填）。不传 = 只保存草稿，需要人在 ERP 里确认后才生效——这是有意的默认。代发单提交后会立刻配货、无法再修改。
client_order_numberstring你自己系统里的订单号（下代发单时传的那个）。
最长 64
notestring备注（选填，最长 500 字）。
最长 500

响应

响应信封只看 HTTP 状态码：成功是 2xx，正文 { data: … }（列表另带 page / page_size / has_more 或 total_count）；失败是 4xx / 5xx，正文 { error: { code, message, hint, request_id, doc_url } }。

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