注文の一括アップロード

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

必須列

各行は1注文を表します。各行の必須情報は3つのカテゴリに分類されます：

Recipient — 受取人の名前、メール、電話番号、shipping address（配送先国を含む）。Postal codeとstate/provinceはaddress formatで使用する国のみ必須です。postal codeがない国（Hong KongやTanzaniaなど）ではセルを空白のままにしてください。state/province listがある国では、carrierがdestinationをrateできるよう認識されたregion nameまたはcode（Dubaiの場合は「Dubayy」または「DU」など）を使用してください。

Items — 最低限、item name、quantity、priceです。HS codeとcountry of originを提供するとclassification accuracyが向上し、confirmation screenの処理時間を短縮できます。

Shipping — アカウントに設定されたcarrierと一致するservice level code（例：fedex.international_priority、ups_worldwide_expedited）。Shipping Amount列は任意です。金額を入力（0も可）して注文のshipping chargeとして使用するか、空白のままにしてservice levelのcarrier-rate estimateを計算します。Calculated rowsはconfirmation screenで各行に数秒追加され、label作成時の最終carrier chargeはestimateと異なる場合があります。一部のdestinationは自動rate不可（「service not available for destination country」error）— 該当行のみshipping amountを入力してください。blankとfilled rowsは1ファイル内で自由に混在できます。

任意列

Recipient tax ID — Tax ID TypeとTax ID Number列を使用して注文にrecipient tax identifierを含めます。typeは以下のcodesのいずれか（大文字小文字不問）である必要があります。両列を一緒に提供してください。numberなしのtype（またはその逆）はconfirmation screenでerrorとしてフラグされます。tax IDは注文recipientに保存され、label作成時にcarrierに渡されます。multi-item ordersでは注文最初の行のtax IDが使用されます。

該当するcountry-specific codeがある場合は使用してください。リストにない国はTINを使用します。

Zonos representativeが使用を指示した場合、追加のspecial-purpose codes（FED、FTZ、DUN、およびDAN/TAN/DTF duty and tax deferment accounts）が受け入れられます。

Duty Paid By — 注文ごとに任意のDDPまたはDDUです。デフォルト動作の場合は空白にしてください。destinationがサポートする場合はDDP、サポートしない場合はDDUに自動fallbackします。明示的なDDPはstrict — fallbackせずrows errorになります。DDUはdelivery時の関税・税金をrecipientが負担します。confirmation screenとresults downloadは各注文が実際にどちらになったかを表示し、DDU rowsにはorange badgeが付きます。multi-item ordersでは最初に指定されたvalueが優先され、矛盾するvaluesはerrorです。

Carton quantity — 注文が複数の同一boxで出荷される場合、Carton Length/Width/Height/Weight列とともにCarton Quantityを設定します。carton columnsは1 boxを記述し（weightは1つの梱包済みboxのweight）、quantityがそれを乗算します。例：360 unitsを30 per boxで梱包する場合、box dimensions、1 full boxのweight、carton quantity 12を使用します。Blankは1です。mixed box sizesの注文はCSVで記述できません — 該当注文でcarton columnsを空白にし、Zonosがitem weightsに基づき自動box化します。

ヒント

• carrier settingsに表示される正確なservice level codesを使用してください。認識されないservice level codesのrowsはconfirmation screenでwarningが表示されます。
• US territoriesは異なります：US Virgin Islandsは独自country code（VI）を使用しinternationalとして出荷、Puerto RicoはUSを使用しdomesticとして出荷します。
• Carrier（特にUPS）はP.O. Box delivery addressesを拒否します — address lineに「P.O. Box」があるrowsはgeneric service-availability errorでratingに失敗する場合があります。可能な限りstreet addressを使用してください。
• WordまたはExcelからのtypographic punctuation（curly quotes、en/em dashes）は自動修正されます。accented lettersがあるべき場所にquestion marksが表示される場合、ファイルがencodingを失ったことを示します — 該当rowsはフラグされ、テキストを再入力できます。
• stateまたはprovince codeが必要なdestination countries（Brazil、US、Canadaなど）では、state fieldに正しいISO codeが入力されていることを確認してください。
• Order IDは必須で、previous uploadsを含めアカウント全体で一意である必要があります — 以前使用されたID（以前のシーズンのファイルやキャンセル済み注文を含む）は注文作成時に拒否されます。ファイルを再利用しますか？IDにsuffixを追加してください（例：volume 33の場合ACALB-33）。IDはconfirmation screenに表示され、作成された注文のmerchant referenceとして引き継がれます。

アップロード後、何も作成される前にconfirmation screenが各注文の計算済みlanded cost breakdownを表示します。画面には以下が表示されます：

destinationが出荷のdeclared valueでimport feesを請求しない場合（国のde minimis threshold未満）、rowsは$0 duties、taxes、feesを表示できます — landed costは本当にゼロであり欠落ではなく、shippingのみがコストです。

Create ordersボタンは送信される注文数を表示します（例：Create 17 orders）。ReadyまたはWarning statusのrowsのみ含まれ — error rowsは除外されます。

注文作成前に顧客へquoteするのに便利な完全quote breakdown（selected rate、item total、shipping、duties、taxes、fees、注文ごとのtotals）をエクスポートするにはDownload results CSVを使用します。改訂ファイルで最初からやり直すにはStart overをクリックします。

Shipping Amountを空白のままにすると、service level列はCSVのservice levelに一致するrateを表示します。要求service levelがdestinationで利用不可の場合、最も近い利用可能rateが選択されDifferent service level badgeでフラグされます — または複数の代替がある場合、Select a rate dropdownで注文作成前に選択できます。

問題はconfirmation screenでインラインにフラグされます。

エラー

Create ordersクリック時、error rowsは除外されます。CSVの問題を修正して再アップロードして該当rowsを含めてください。一般的なerrors：

• Low-value orders not allowed — 注文valueがstoreのminimum threshold未満です。
• Invalid state code — stateまたはprovince codeがdestination countryで無効です。Brazil、US、Canadaなどで必須です。
• Missing required field — 必須列が空または解析不可です。
• Order ID already exists — 各order IDはprevious uploadsの注文を含めアカウント全体で一意である必要があります。すでに使用されたIDのrowsは作成時に失敗し、ファイルの残りは成功します — fresh IDs（-33などのsuffix）で失敗rowsのみ再アップロードしてください。

警告

warning rowsは送信に含まれます。Create orders前に確認してください。一般的なwarnings：

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

現在のアップロード制限はCSVあたり200注文です。注文はAPI callあたり最大50件のバッチで送信されます — 50件超のready ordersがある場合、複数バッチで自動処理されます。

Coming soon: 将来の更新で200-order capが撤廃され、大規模アップロード向けbackground job processingが追加されます。