注文の一括アップロード

DashboardのアップロードページからCSV templateを直接ダウンロードできます。テンプレートには必須列と任意列がすべて含まれており、必須列はヘッダー行でアスタリスク（*）でマークされています。

商品ごとに1行 

各行は1件の注文ではなく、1商品を表します。同じOrder IDを持つ行はまとめられ、1件の複数商品注文になります。たとえば3商品の注文は3行になります。受取人、住所、service level、配送料、通貨、Duty Paid By、カートンといった注文レベルの値は、各グループの最初の行から読み取られます。

必須列

各行に必要な情報は、次の3つのカテゴリーに分類されます。

受取人情報 — 受取人の氏名、電話番号、配送先住所（配送先国を含む）です。メールアドレスは任意ですが、入力する場合は形式が検証されます。郵便番号とstate/provinceは、その情報を使用する住所形式の国でのみ必須です。郵便番号のない国（Hong KongやTanzaniaなど）では、該当するセルを空欄のままにしてください。state/provinceのリストがある国では、キャリアが配送先をレーティングできるように、認識される地域名またはコード（Dubaiの場合は「Dubayy」または「DU」など）を使用してください。

商品情報 — 最低限、商品名と価格が必要です。数量は任意で、デフォルトは1です。HSコードと原産国を指定すると、分類精度が向上し、確認画面での処理時間を短縮できます。

配送情報 — アカウントに設定されているキャリアと一致するservice level code（例：fedex.international_priority、ups_worldwide_expedited）です。Shipping Amount列は任意です。金額を入力（0も可）すると、その注文の配送料として使用されます。空欄のままにすると、選択したservice levelに基づくキャリアレートの見積りが計算されます。見積り計算が必要な行は確認画面で処理に数秒余分にかかり、ラベル作成時の実際のキャリア料金は見積りと異なる場合があります。一部の配送先は自動でレーティングできないことがあります（「service not available for destination country」エラー）。その場合は該当する行にのみ配送料を入力してください。空欄の行と入力済みの行は同じファイル内で自由に混在できます。

任意列

Recipient tax ID（受取人の税ID） — Tax ID Type列とTax ID Number列を使用して、注文に受取人の税識別情報を含めることができます。typeには以下のコードのいずれかを指定してください（大文字小文字は区別されません）。両方の列は必ず一緒に指定してください。numberのないtype（またはtypeのないnumber）は、確認画面でエラーとしてフラグされます。税IDは注文の受取人情報として保存され、ラベル作成時にキャリアへ渡されます。複数商品の注文では、最初の行の税IDが使用されます。

該当する国別コードがある場合はそれを使用してください。リストにない国についてはTINを使用してください。

Zonosの担当者から指示があった場合、追加のspecial-purpose codes（FED、FTZ、DUN、およびDAN/TAN/DTFの関税・税延納account）が使用できます。

Duty Paid By（関税負担者） — 注文ごとに任意でDDPまたはDDUを指定できます。空欄の場合はデフォルトの動作になります。配送先がDDPに対応していればDDPが適用され、対応していない場合は自動的にDDUにフォールバックします。明示的にDDPを指定した場合は厳格に適用され、フォールバックせず該当行はエラーになります。DDUを指定すると、配達時の関税・税金は受取人が負担します。確認画面と結果のダウンロードには、各注文が実際にどちらになったかが表示され、DDUの行にはオレンジ色のバッジが付きます。複数商品の注文では最初に指定された値が優先され、値が矛盾している場合はエラーになります。

Carton quantity（カートン数量） — 1件の注文が複数の同一の箱で出荷される場合は、Carton Length/Width/Height/Weight列と一緒にCarton Quantityを設定してください。カートン列は1箱分を表します（Weightは梱包済みの1箱分の重量です）。Quantityはその値に掛け合わされます。例えば、360個の商品を1箱30個ずつで梱包する場合は、その箱の寸法、梱包済み1箱分の重量、カートン数量12を使用します。空欄の場合は1として扱われます。箱のサイズが混在する注文はCSVでは表現できません。該当する注文ではカートン列を空欄のままにしてください。その場合、Zonosが商品の重量に基づいて自動的に箱詰めを計算します。

ヒント

• carrier settingsに表示されている正確なservice level codeを使用してください。認識できないservice level codeの行には、確認画面に警告が表示されます。
• US territoriesには違いがあります。US Virgin Islandsは独自の国コード（VI）を使用し、internationalとして出荷されます。一方、Puerto RicoはUSを使用し、domesticとして出荷されます。
• キャリア（特にUPS）はP.O. Box宛の配送先住所を拒否します。住所欄に「P.O. Box」が含まれる行は、汎用的なservice-availabilityエラーでレーティングに失敗することがあります。可能な限り番地入りの住所を使用してください。
• WordやExcelからのtypographic punctuation（カーリークォート、en/emダッシュなど）は自動的に修正されます。アクセント付き文字があるはずの場所に疑問符が表示されている場合は、ファイルのエンコーディングが失われたことを示しています。該当する行にはフラグが立てられるため、テキストを再入力してください。
• state/provinceコードが必要な配送先国（Brazil、US、Canadaなど）では、state欄に正しいISOコードが入力されていることを確認してください。
• Order IDは必須で、過去のアップロードを含め、アカウント全体で一意である必要があります。過去に一度でも使用されたID（過去のシーズンのファイルやキャンセル済みの注文であっても）は、注文作成時に拒否されます。同じファイルを再利用する場合は、IDに接尾辞を追加してください（例：33回目のアップロードならACALB-33）。IDは確認画面に表示され、作成された注文にはmerchant referenceとして引き継がれます。
• 受取人の氏名、住所、市区町村、state/province、会社名、商品名にはLatin文字を使用する必要があります。日本語やアラビア語などLatin文字以外の文字は拒否されます。
• 完全に空白の行は無視されるため、ファイル末尾に空行があっても問題ありません。

標準テンプレートのすべての列を、テンプレートの順序で示します。Conditionalは、特定の場合にのみ必須となる列を意味します — 詳細は上記の必須列を参照してください。

Japan Postは独自のCSVテンプレートを使用し、同じアップロードページからダウンロードします。service level列はありません — アップロード時にキャリアの最初のservice levelが割り当てられ、ラベル作成フローで選び直します — また、これらのアップロードは常に単一のカートンとして出荷されるため、carton quantity列もありません。

標準テンプレートでは任意ですが、Japan Postでは必須となる列：

• HS code
• Country of origin
• Item weight — 重量単位はここでは任意のままで、デフォルトはgramになります
• Postal code
• State/province
• Shipping amount — 標準テンプレートと異なり、空欄にはできません

テンプレートにはJapan Postの配送フィールドも追加されており、注文に保存され、ラベル作成時に配送物に適用されます：Contents Type、Licence Number、Certificate Number、Invoice、Tax Code/VAT Number、Pay Condition、Remarks、Sender's Reference Number、Non-commercial。いずれも任意です。テキストフィールドは最大25文字まで入力でき、Non-commercialにはtrueまたはfalseのみ指定できます。

アップロード後、注文が作成される前に、各注文の計算済みLanded cost breakdownを示す確認画面が表示されます。画面には以下が表示されます。

配送先の国が、出荷のdeclared value（申告価格）に対してimport feesを課さない場合（その国のde minimis thresholdを下回る場合）、行には$0の関税・税金・手数料が表示されることがあります。これはLanded costが実際にゼロであり欠落しているわけではないことを意味し、その注文では配送料のみがコストになります。

Create ordersボタンには、送信される注文数が表示されます（例：Create 17 orders）。ReadyまたはWarning状態の行のみが対象となり、エラーのある行は除外されます。

注文が作成される前に顧客へ見積りを提示する場合に便利な、完全な見積り内訳（選択されたレート、商品価格合計、配送料、関税、税金、手数料、注文ごとの合計）をエクスポートするには、Download results CSVを使用してください。アップロードを取り消して修正済みのファイルからやり直す場合は、Start overをクリックしてください。

Shipping Amountを空欄のままにすると、Service level列にはCSVのservice levelに一致するレートが表示されます。指定したservice levelが配送先で利用できない場合は、利用可能な最も近いレートが選択され、Different service levelバッジが表示されます。ほかにも選択肢がある場合は、注文を作成する前にSelect a rateドロップダウンからレートを選択できます。

問題は確認画面にインラインでフラグ表示されます。

エラー

Create ordersをクリックすると、エラーのある行は除外されます。CSVの問題を修正して再アップロードすると、該当する行を含めることができます。よくあるエラー：

• Low-value orders not allowed — 注文金額が、ご利用のストアの最低金額しきい値を下回っています。
• Invalid state code — state/provinceコードが配送先国に対して無効です。Brazil、US、Canadaなどの国では必須です。
• Missing required field — 必須列が空欄、または解析できません。
• Order ID already exists — 各注文IDは、過去のアップロードを含めアカウント全体で一意である必要があります。使用済みのIDを持つ行は作成時に失敗しますが、ファイルの残りの行は正常に処理されます。失敗した行のみ、新しいID（-33のような接尾辞を付けるとよいでしょう）で再アップロードしてください。

警告

警告のある行は送信対象に含まれます。Create ordersをクリックする前に確認してください。よくある警告：

• Service level not configured — CSVのservice levelコードがアカウントに接続されていません。注文は作成されますが、正しくレーティングされない場合があります。carrier settingsを確認するか、CSVのservice levelコードを更新してください。

現在のアップロード上限はCSV1件あたり200注文です。注文はAPI呼び出しごとに最大50件のバッチで送信されます。準備済みの注文が50件を超える場合は、複数のバッチに分けて自動的に処理されます。

今後の予定: 今後のアップデートで200注文の上限が撤廃され、より大規模なアップロードに対応するバックグラウンドジョブ処理が追加される予定です。