お客様提供ラベル：API で送る方法と倉庫でアップロードする方法

お客様自身がラベルを購入し、PDF を注文と一緒に送ってくる場合があります。その PDF を注文のラベルとして登録すれば（注文作成時に API で送るか、注文ページでアップロード）、倉庫はそのまま印刷して貼り、別のラベルを購入しません。

お客様提供ラベルがラベルとして認められるのは、PDF に追跡番号・運送業者・標準の 4×6 インチ単ページのラベルファイルが揃っている場合だけです。追跡番号のない PDF はただのファイルで、システムはラベルとして扱いません。登録されると、注文のラベルカードに運送業者・サービス・追跡番号が表示され、バッチ出荷（WMS → 出庫注文 → ラベル先行バッチ出荷）ではこのラベルが優先され、その注文の運賃は発生しません。倉庫の印刷・貼付の作業費のみが対象です。

方法A：お客様が注文と一緒に送る（API）#

1. 注文 API で注文を作成する際、ラベルのブロックを追加します。PDF（ファイル参照または base64）、追跡番号、運送業者コードです。サービスコードは任意です。正確なフィールドは注文作成 API のドキュメントにあります。
2. 注文は必ず作成されます。ラベルを登録できない場合（サイズ違い、複数ページ、追跡番号が他の注文で使用中）は、レスポンスのラベル結果に分かりやすく表示され、注文自体は有効なままです。ファイルを直して、注文ページから後で登録してください（方法B）。注文を作り直す必要はありません。
3. 追跡番号は同時に1つの注文にしか属せません。同じ番号が2回来ると、2回目は明確なメッセージで拒否されます。再試行する前に、ファイルを間違った注文に送っていないか確認してください。

方法B：倉庫でアップロード#

1. 注文詳細（OMS → 受注 → 注文を開く）またはその出庫注文（WMS → 出庫注文 → 注文を開く）を開きます。どちらのページにも同じ「お客様提供ラベル」カードがあり、一方でアップロードすれば他方にも表示されます。
2. PDF ファイルを選び、追跡番号と運送業者を確認して（カードには注文が宣言済みの値が初期表示されます。紙のラベルと見比べてください）アップロードします。新しいアップロードは現在のラベルを自動で置き換え、古いものは無効になります。どれが有効か迷うことはありません。
3. 間違ったファイルを送った場合は、カードの「無効化」で追跡番号を解放し、正しいものをアップロードしてください。ラベルの追跡番号が注文の宣言と異なる場合は、登録されたラベルが優先され、注文もその番号に更新されます。運送業者が認めるのは実物ラベルの番号です。

この記事で使った Docklify の機能#

• お客様提供ラベルカード（表示、アップロード、差し替え、無効化）——OMS → 受注 → 注文詳細（/oms/orders）と WMS → 出庫注文 → 注文詳細（/wms/orders）
• 注文作成 API のラベルブロック——注文作成 API のドキュメント参照（/api/oms/orders）
• ラベル先行バッチ出荷では登録済みラベルが優先されます——WMS → 出庫注文 → ラベル先行バッチ出荷（/wms/orders）