客供面单：API 传入与仓库上传

有些货主自己买好面单、把 PDF 随订单一起发来。把这份 PDF 登记成订单的面单——建单时经 API 带入，或在订单页上传——仓库就会原样打印贴上，不再另买一张。

客供面单要算数，PDF 必须同时带三样东西：tracking 号、承运商、以及标准的 4×6 英寸单页面单文件。没有 tracking 号的 PDF 只是一份普通文件，系统不会把它当面单。登记成功后，订单上的「客供面单」卡会显示承运商、服务和 tracking 号；走批量出库时（WMS → 出库单 → Label 先行批量出库），这张单会优先用这份面单、不产生运费，只计仓库打印拣贴的操作费用。

方式一：货主随订单一起传入（API）#

1. 经订单 API 建单时，在请求里加上 label 段：PDF（文件引用或 base64）、tracking 号和承运商代码，服务代码可选。具体字段见建单接口的 API 文档。
2. 订单永远会建好。如果面单登记不上——尺寸不对、超过一页、或 tracking 号已被另一张订单占用——响应会在面单结果里大白话写明，订单本身不受影响。把文件改对后，在订单页补登记即可（方式二），不用重建订单。
3. 一个 tracking 号同一时间只能属于一张订单。同一个号来第二次会被拒绝并给出明确提示——重试前先核对是不是把文件传错了订单。

方式二：仓库在订单页上传#

1. 打开订单详情（OMS → 订单 → 打开订单）或它的出库单详情（WMS → 出库单 → 打开出库单）。两边都有同一张「客供面单」卡，在一边上传，另一边也能看到。
2. 选好 PDF 文件，核对 tracking 号和承运商（卡片会预填订单已声明的值，请和纸质面单对一眼），再上传。上传新面单会自动替换当前面单，旧的随即失效——永远不会搞混哪张是现行的。
3. 传错了？在卡上点「作废」释放这个 tracking 号，再传对的。如果面单上的 tracking 号和订单原先声明的不一致，以登记的面单为准，订单会同步更新成面单上的号——承运商认的是实物面单上的号。

本文用到的 Docklify 功能#

• 客供面单卡（查看、上传、换新、作废）——OMS → 订单 → 订单详情（/oms/orders）与 WMS → 出库单 → 出库单详情（/wms/orders）
• 建单 API 的 label 段——见建单接口 API 文档（/api/oms/orders）
• 批量出库优先使用已登记的客供面单——WMS → 出库单 → Label 先行批量出库（/wms/orders）