注文の一括アップロード

CSV ファイルをアップロードして、販売チャネルの注文を Zonos Dashboard に迅速同期できます。アップロード後、shipment list で選択して Japan Post ラベルを作成できます。

ラベル作成前の準備

account setup を完了し、fulfillment center を追加してください。両方完了するまでラベルは作成できません。

米国宛先のみ

Verified Account 配送は米国向けのみです。すべての行の Country Code は US である必要があります — 非米国宛先はアップロード時に拒否されます。

CSV をアップロード

Dashboard → Orders に移動します。
ページ header の Upload orders をクリックします。
CSV ファイルをドラッグ＆ドロップするか、クリックして参照します。
解析された行を確認します。
Create orders をクリックして order を作成します。

アップロード後、order は shipment list に表示されます。ラベル化する order にチェックを入れ、Create labels をクリックします。ラベル flow は Creating shipping labels を参照してください。

CSV テンプレートをダウンロード

CSV 列

各行は 1 品目を表します。同一 shipment に属する複数品目は同じ Order ID を共有し、order レベルの値（recipient、carton、customs フィールド）は行間でマージされます — フィールドごとに最初の非空値が採用されます。

以下の列はダウンロード可能テンプレートと同じ順序です。

Column↕	Required↕	Description↕
Order ID	Yes	order の一意識別子。同じ `Order ID` の繰り返し行は 1 shipment にグループ化されます。
Item Name	Yes	配送品目名。Latin 文字のみ。
HS Code	Yes	品目の HS tariff code。
Country of Origin	Yes	製造国の 2 文字 ISO country code（例: `JP`）。
Item Price	Yes	品目単価。0 より大きい必要があります。
Currency	No	行内価格の 3 文字通貨 code。空白時は organization の通貨が default。
Quantity	No	数量。0 より大きい整数、default 1。
Item Weight	Yes	単位あたり重量。0 より大きい必要があります。
Weight Unit	No	Item Weight の単位（`kg`、`lb`、`g`、`oz`）。空白時は gram。Weight and dimension units 参照。
Carton Length	No	carton の長さ。Cartons 参照。
Carton Width	No	carton の幅。
Carton Height	No	carton の高さ。
Carton Dimensional Unit	No	carton 寸法の単位（`cm`、`in`、`mm`、`m`）。default は centimeter。
Carton Weight	No	carton の重量。
Carton Weight Unit	No	Carton Weight の単位（`kg`、`lb`、`g`、`oz`）。default は gram。
Company Name	No	受取人の会社名。Latin 文字のみ。
First Name	Yes	受取人の名。Latin 文字のみ。
Last Name	Yes	受取人の姓。Latin 文字のみ。
Email	No	受取人のメール。
Phone	Yes	受取人の電話番号。
Address Line 1	Yes	受取人の street address。Latin 文字のみ。
Address Line 2	No	受取人の apartment、suite、unit。Latin 文字のみ。
City	Yes	受取人の city。Latin 文字のみ。
Postal Code	Yes	受取人の ZIP code。
State/Province	Yes	米国 state 名または 2 文字 code（例: `CA`）。
Country Code	Yes	配送先国。`US` である必要があります。
End Use	No	`FOR_RESALE` または `NOT_FOR_RESALE`。default `NOT_FOR_RESALE`。
Shipping Amount	Yes	顧客に請求する配送コスト。`0` 可、列は blank 不可。
Contents Type	No	customs contents type。8 種類の値のいずれか — 詳細は Customs and declaration fields 参照。
Licence Number	No	該当する export license number。
Certificate Number	No	該当する certificate number。
Invoice	No	commercial invoice number。
Tax Code/VAT Number	No	配送の tax または VAT 識別子。
Pay Condition	No	配送の payment conditions。
Remarks	No	自由記述 customs remarks。
Sender's Reference Number	No	内部参照または purchase-order number。
Non-commercial	No	non-commercial shipment は `true`；commercial は `false` または blank。

Cartons

6 つの Carton 列は各 shipment が出荷する box を記述します。寸法と重量は Japan Post ラベルに印刷されるため、Zonos は auto-cartonize しません — 実値を提供してください。

Carton 列は任意ですが、carton を提供する場合は Carton Length、Carton Width、Carton Height、Carton Weight をすべて入力する必要があります。部分 carton は無視されます。単位が blank の場合、寸法は centimeter、重量は gram（CP72 customs 単位）が default です。

Carton は order レベル: multi-item order では、その Order ID の任意 1 行に carton 列を設定します。

Customs and declaration fields

これらの任意列はラベルの Japan Post customs declaration に引き継がれます:

Contents Type — contents の customs 理由。8 種類の値のいずれかを使用（下記参照）。
Licence Number、Certificate Number — 品目に必要な regulatory identifier。
Invoice — commercial invoice number。
Tax Code/VAT Number — 配送の tax または VAT 識別子。
Pay Condition — 配送の payment conditions。
Remarks — declaration 用自由記述メモ。
Sender's Reference Number — 内部参照または purchase-order number。
Non-commercial — non-commercial shipment には true。

carton と同様、order レベル — Order ID ごとに 1 回設定します。

Contents Type の値。 以下の 8 つのいずれかを、記載の通り正確に使用してください:

Value↕	Use for↕
`ECOMMERCE_GOODS`	一般消費者向け（BtoC）に販売される e-commerce goods。典型的なオンライン注文。
`COMMERCIAL_GOODS`	企業間（BtoB）で販売される commercial goods。
`SALE_OF_GOODS`	BtoC の e-commerce でも BtoB でもない販売。
`COMMERCIAL_SAMPLE`	販売ではなく評価目的で送付されるサンプル。
`RETURNED_GOODS`	送付者または supplier に返送される商品。
`GIFT`	正真正銘の gift。gift には米国独自の customs 取り扱いがある点に注意してください。
`DOCUMENTS`	商業的価値のない紙の documents。
`OTHER`	上記のいずれにも該当しないもの。

ECOMMERCE_GOODS と COMMERCIAL_GOODS は単なるラベルではありません — これらは Zonos が Japan Post のラベル呼び出しで送信する pkgType を設定するため、BtoC / BtoB の選択によって customs declaration に印刷される内容が変わります。取引内容に合致するものを選択してください。

Contents Type は End Use（FOR_RESALE / NOT_FOR_RESALE）および Non-commercial（true / false）とは別の項目です。通常の BtoC order では、End Use が FOR_RESALE、Non-commercial が blank の ECOMMERCE_GOODS になります。

Weight and dimension units

重量単位（Weight Unit と Carton Weight Unit）は kg、lb、g、oz を受け付けます。寸法単位（Carton Dimensional Unit）は cm、in、mm、m を受け付けます。

Japan Post では単位列は任意で、CP72 metric 単位 — 重量 grams、寸法 centimeters — が default です。単位はファイルから読み取られるため、販売チャネルの export 単位のまま保持できます。Zonos は customs declaration 用に net weight を gram に変換します。

CSV では service level を選択しません。Dashboard でラベル作成時に各 shipment の Japan Post service level を選択 — Creating shipping labels を参照してください。

デモを予約する