配送伝票CSV・追跡番号
CSV出力設定（Webゆうパック・クリックポスト）
配送伝票CSVを正しく出力するために、あらかじめ日本郵便向けの設定を行っておく必要があります。こちらでは「CSVに関する設定」画面の使い方を説明します。
この画面は、TimePort 日本郵便の左メニュー「配送伝票CSV・追跡番号」を開き、上部の「CSVに関する設定」タブから移動できます。
画面の構成
設定画面は、タブで「共通設定」「日本郵便」に分かれています。「日本郵便」タブの中に、Webゆうパックプリント用の設定とクリックポスト（まとめ申込）用の設定がまとめて表示されます。右上の「保存」ボタンで、すべてのタブの設定がまとめて保存されます。
1. 共通設定
配送日時の参照元、文字コード（初期値はShift_JIS）、品名・内容品の出力、依頼主（差出人）情報を設定します。
依頼主情報（差出人）
配送伝票に記載する店舗名・依頼主名、電話番号、住所を「店舗の依頼主情報」に入力します。空欄の項目はShopifyの店舗情報から自動取得されます。
「注文者住所と配送先住所が異なる場合は、注文者を依頼主にする」にチェックを入れると、注文者と配送先の住所が異なる注文（贈り物など）では、注文の「請求先住所」にある氏名・住所・電話番号を依頼主として出力します。
- 住所が同じ注文には「店舗の依頼主情報」を使用します。
- 注文者の電話番号が未入力・不足の場合は、電話番号だけ空欄で出力します。
- 請求先の住所や氏名が不足しているなど、注文者の情報を使えない注文は、CSV出力時に確認の案内を表示します。詳しくは「配送伝票CSVのエクスポート方法」をご覧ください。
- チェックがない場合は、すべての注文で「店舗の依頼主情報」を使用します。
- クリックポストのCSVには依頼主欄がないため、この設定は適用されません。
品名・内容品の出力設定
「品名・内容品を配送会社の字数上限に合わせる」をオンにすると、バリエーション別の出力名が設定されていない商品は、日本郵便の上限に合わせて品名・内容品を省略します。オフにすると省略せず出力するため、取込エラーになる可能性があります。
バリエーションごとに任意の出力名を設定できます。「バリエーションを選択」から商品を開き、対象のバリエーションを選択してください。設定一覧には「商品名 – バリエーション名」と表示されます。
- 設定は選択したバリエーションだけに適用され、同じ商品内のほかのバリエーションには適用されません。
- バリエーション別の出力名は字数制限設定の影響を受けず、そのまま出力されます。
- 日本郵便は20文字、クリックポストは30単位（半角1・全角2。全角のみは15文字、半角のみは30文字）を目安に、現在値と超過状況をそれぞれ表示します。
- 上限を超えていても保存できますが、そのまま出力されるため取込エラーになる可能性があります。
- 設定がない場合は、注文時点の商品名・バリエーション名を使用します。
クリックポストは「追加内容品ルール（商品タグ別）」、次に「内容品（デフォルト）」が優先され、どちらも空欄の場合に商品名またはバリエーション別の出力名を使用します。
外部ツールから配送日時を指定する
ストアフロントの日時指定ブロックを設置せず、CSVエクスポートと追跡番号の取込だけを利用できます。外部ツールで指定した日時をCSVに使う場合は、「共通設定」の「配送日時の参照元」で「外部ツールの注文属性」を選び、保存してください。初期値は従来の「TimePort」です。
外部連携用として、次の固定キーを新設しています。既存のTimePort用のキーとは別のキーです。キー名の変更設定はありません。
| 用途 | note attributes の name | value の書式・例 |
|---|---|---|
| お届け希望日 | timeport_csv_external_delivery_date | 実在する日付を YYYY-MM-DD 形式で指定。例：2026-12-24 |
| お届け希望時間帯 | timeport_csv_external_delivery_time | 表記補正後に下記の対応文字列と照合。例：午前中、14:00〜16:00 |
GraphQL Admin APIの注文では customAttributes の key / value に相当します。既存属性を消さないよう、外部ツール側で注文属性を保持して更新してください。注文タグからの読取は行いません。
- 日本郵便（ゆうパック系）：
午前中、12:00〜14:00、14:00〜16:00、16:00〜18:00、18:00〜20:00、19:00〜21:00
時間帯の区切りの標準表記は 〜（U+301C）です。読取時には、日付・時間帯の全角数字を半角にし、前後の空白を除去します。日付の －（U+FF0D）・/・／ は - に、時間帯の ： は : に、～（U+FF5E）・~ は 〜 に変換します。それ以外の記号、内部の空白、年月日表記、桁不足の日付は補正しません。
例：２０２６／１２／２４ / １４：００～１６：００ → 2026-12-24 / 14:00〜16:00。補正後に実在する日付・会社ごとの対応時間帯かを検証します。配送会社の数値コードは入力できません。CSV出力時にTimePort 日本郵便が日本郵便の書式・コードへ変換し、この例のCSV出力は20261224 / 53になります。
指定なしの場合は属性を未登録または空文字にしてください。「外部ツールの注文属性」を選んだ場合、空欄をTimePortの既存属性やCSV設定の既定日時で補完しません。不正な日付・非対応の時間帯があればCSV出力を止めて対象注文を表示します。クリックポストなど日時指定に非対応のサービスでは、外部日時を空欄にしてください。
注文に保存した日時は、同じ注文の全発送単位に共通で適用します。発送単位ごとに異なる外部日時を指定する機能は含まれません。TimePortのCSV出力によって、この外部属性が書き換わることはありません。
2. 日本郵便の設定
「日本郵便」タブでは、Webゆうパックプリント・クリックポストそれぞれのCSVフォーマットに合わせた固定項目（商品、着払/代引、書留/特定記録、お届け先敬称、セキュリティ、サイズ、差出方法、お支払方法など）を設定します。ここで入力した内容は、CSV出力のたびに毎回反映されるため、一度設定すれば通常は変更の必要はありません。
- 半角/全角や桁数などの入力形式は決まっています。 画面上でエラーが出た場合は、入力形式が合っているかご確認ください（詳しくはこのページ末尾の「入力エラーが出たときは」をご覧ください）。
- 一部の項目は、他の項目の設定内容によっては選べないことがあります（例：着払は商品が「ゆうパック」「重量ゆうパック」の場合のみ利用可能、など）。エラーメッセージに従って設定を調整してください。
- 「ヘッダー行を含める」は初期状態ではオフです。ヘッダー行を含むCSVはWebゆうパックプリントで取り込めません。
3. デフォルト設定とタグルール（商品タグに応じた自動設定）
保冷設定・取扱上の注意・クリックポストの内容品など、多くの項目は「デフォルト設定」と「タグルール（商品タグ別設定）」の2段構えになっています。
- デフォルト設定：出力する行の商品がどのタグルールにも該当しない場合に使う基本の値です。
- タグルール：特定の商品タグが付いた商品を含む行に、デフォルトとは異なる内容を適用したい場合に追加します。該当するタグルールがあれば、そちらがデフォルトより優先されます。
設定例： 「保冷（デフォルト）」を「なし:0」のままにし、「追加保冷ルール（商品タグ別）」で商品タグ「冷蔵」に「チルド:1」を割り当てます。そのタグを商品に付けると、商品を含む行にルールが適用されます。タグ名を付けるだけでは保冷の設定は変わりません。
- 「日本郵便」タブ内にある「◯◯（デフォルト）」の項目で基本の値を設定します。
- 例外にしたい商品がある場合は、その下の「追加◯◯ルール（商品タグ別）」欄を開きます。
- 対象にしたい商品タグを選択します。
- そのタグが付いた商品を含む行に適用したい設定内容を選択するか入力します（項目によって選択式・入力式のいずれかになります）。
- 保存します。
タグルールの行は、商品タグ・設定内容のどちらも入力してください。片方だけ入力された行があると保存時にエラーになります。不要な行は削除してください。
クリックポストの内容品について
クリックポストの「内容品」も同様に「内容品（デフォルト）」と「追加内容品ルール（商品タグ別）」に分かれています。どのタグルールにも該当しない商品は「内容品（デフォルト）」が使われ、デフォルトも空欄の場合はShopifyの商品名がそのまま内容品になります。
クリックポストのタグルールは、他の項目と異なり商品タグ・内容品の両方を必ず入力する必要があります（片方だけの入力は保存時にエラーになります）。
発送単位での保冷・取扱上の注意
発送単位の出力では、その行の商品タグとCSV設定のルールだけを見て判定します。配送プロファイル名は判定に使いません。「冷蔵」などのタグ名は例です。商品タグを付けたうえで、CSV設定で対応する値を割り当ててください。
保冷と取扱上の注意には同じ商品タグを共用できます。適用値はそれぞれのルールで設定します。該当しない行にはデフォルト設定を使用します。取扱上の注意は、こわれもの・なまもの・ビン類・逆さま厳禁・下積み厳禁の5項目で、該当した注意はすべて出力されます。
作成数を複数にしても、その行の各送り状には同じ設定を使います。箱ごとに別の温度帯を指定するものではありません。
保冷（チルド）は、商品が「ゆうパック」の場合のみ有効です。対象外の商品では出力されません。クリックポストは保冷や日時指定に対応していません。
保存する
すべての入力が終わったら、画面右上の保存ボタンを押してください。保存が完了すると「CSV出力設定を保存しました」というメッセージが表示されます。
入力エラーが出たときは
保存時に赤字でエラーメッセージが表示された場合は、該当の項目を確認してください。
よくあるエラーの例：
- 設定同士の組み合わせが利用できない状態になっている（着払・セキュリティ・サイズは商品が「ゆうパック」「重量ゆうパック」の場合のみ、書留/特定記録は「ゆうメール」「定形郵便」「定形外郵便」の場合のみ、保冷は「ゆうパック」の場合のみ）
- タグルールに、対象商品タグが選択されていない行がある
- バリエーション別の出力名が空欄になっている
エラーメッセージにはどの項目をどう直せばよいかが具体的に書かれていますので、その内容に従って修正してください。
関連ページ
- 設定が終わったら「配送伝票CSVのエクスポート方法」で実際にCSVを出力してみましょう。