配送伝票CSVを正しく出力するために、あらかじめ佐川急便向けの設定を行っておく必要があります。こちらでは「CSVに関する設定」画面の使い方を説明します。
この画面は、TimePort 佐川急便の左メニュー「配送伝票CSV・追跡番号」を開き、上部の「CSVに関する設定」タブから移動できます。
画面の構成
設定画面は、タブで「共通設定」「佐川急便」に分かれています。
1. 共通設定
文字コードの選択や依頼主（差出人）情報を入力します。氏名・住所・電話番号など、配送伝票に共通して記載される情報です。空欄の場合はストアの情報が自動的に使われます。
品名の出力設定
「品名を配送会社の字数上限に合わせる」をオンにすると、バリエーション別の出力名が設定されていない商品は、e飛伝Ⅲの上限に合わせて品名を省略します。オフにすると省略せず出力するため、e飛伝Ⅲで取込エラーになる可能性があります。
バリエーションごとに任意の出力名を設定できます。「バリエーションを選択」から商品を開き、対象のバリエーションを選択してください。設定一覧には「商品名 – バリエーション名」と表示されます。
- 設定は選択したバリエーションだけに適用され、同じ商品内のほかのバリエーションには適用されません。
- バリエーション別の出力名は字数制限設定の影響を受けず、そのまま出力されます。
- 佐川急便の上限は、半角のみの場合は32文字、全角または半角・全角混在の場合は16文字です。
- 上限を超えるバリエーション別の出力名は保存できません。
- 設定がない場合は、注文時点の商品名・バリエーション名を使用します。
外部ツールから配送日時を指定する
ストアフロントの日時指定ブロックを設置せず、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、18:00〜21:00、19:00〜21:00
時間帯の区切りの標準表記は 〜（U+301C）です。読取時には、日付・時間帯の全角数字を半角にし、前後の空白を除去します。日付の －（U+FF0D）・/・／ は - に、時間帯の ： は : に、～（U+FF5E）・~ は 〜 に変換します。それ以外の記号、内部の空白、年月日表記、桁不足の日付は補正しません。
例：２０２６／１２／２４ / １４：００～１６：００ → 2026-12-24 / 14:00〜16:00。補正後に実在する日付・会社ごとの対応時間帯かを検証します。配送会社の数値コードは入力できません。CSV出力時にTimePortが会社別の書式・コードへ変換し、この例のCSV出力は20261224 / 14になります。
指定なしの場合は属性を未登録または空文字にしてください。「外部ツールの注文属性」を選んだ場合、空欄をTimePortの既存属性やCSV設定の既定日時で補完しません。不正な日付・非対応の時間帯があればCSV出力を止めて対象注文を表示します。日時指定に非対応のサービスでは、外部日時を空欄にしてください。
注文に保存した日時は、同じ注文の全発送単位に共通で適用します。発送単位ごとに異なる外部日時を指定する機能は含まれません。TimePortのCSV出力によって、この外部属性が書き換わることはありません。
2. 佐川急便の設定
「佐川急便」タブでは、e飛伝ⅢのCSVフォーマットに合わせた固定項目（お客様コード、荷姿、スピード指定など）を設定します。ここで入力した内容は、CSV出力のたびに毎回反映されるため、一度設定すれば通常は変更の必要はありません。
- 半角/全角や桁数などの入力形式は決まっています。 画面上でエラーが出た場合は、入力形式が合っているかご確認ください（詳しくは本記事末尾の「入力エラーが出たときは」をご覧ください）。
- 一部の項目は、他の項目の設定内容によっては選べないことがあります。エラーメッセージに従って設定を調整してください。
3. デフォルト設定とタグルール（商品タグに応じた自動設定）
クール便・ケアマークなど、一部の項目は「デフォルト設定」と「タグルール（商品タグ別設定）」の2段構えになっています。
- デフォルト設定：出力する行の商品がどのタグルールにも該当しない場合に使う基本の値です。
- タグルール：特定の商品タグが付いた商品を含む行に、デフォルトとは異なる内容を適用したい場合に追加します。該当するタグルールがあれば、そちらがデフォルトより優先されます。
設定例： デフォルトを通常便にし、クール便の商品タグ別ルールで商品タグ「冷凍」に冷凍便を割り当てます。そのタグを商品に付けると、商品を含む行にルールが適用されます。タグ名を付けるだけでは区分は設定されません。
- 「佐川急便」タブ内にある「◯◯（デフォルト）」の項目で基本の値を設定します。
- 例外にしたい商品がある場合は、その下の「追加◯◯ルール（商品タグ別）」欄を開きます。
- 対象にしたい商品タグを選択します。
- そのタグが付いた商品を含む行に適用したい設定内容を選びます。
- 保存します。
タグルールの行は、商品タグ・設定内容のどちらも入力してください。片方だけ入力された行があると保存時にエラーになります。不要な行は削除してください。
発送単位でのクール区分・荷扱い
発送単位の出力では、その行の商品タグとCSV設定のルールだけを見て判定します。配送プロファイル名は判定に使いません。「冷蔵」などのタグ名は例です。商品タグを付けたうえで、CSV設定で対応する値を割り当ててください。
クール区分と荷扱いには同じ商品タグを共用できます。適用値はそれぞれのルールで設定します。該当しない行にはデフォルト設定を使用します。CSV指定シール：クール・日時などの自動シールを含め、1行につき最大3つ。省略される項目は一覧で警告します。
出荷個数を複数にしても、その行の各送り状には同じ区分を使います。箱ごとに別の温度帯を指定するものではありません。
同じ発送単位に冷蔵と冷凍のルールが混在すると、出力を止めてお知らせします。商品タグかShopify側の発送単位を見直してください。アプリによる自動分割は行いません。注文単位では従来どおり冷凍を優先します。
保存する
すべての入力が終わったら、画面右上の保存ボタンを押してください。保存が完了すると「CSV出力設定を保存しました」というメッセージが表示されます。
入力エラーが出たときは
保存時に赤字でエラーメッセージが表示された場合は、該当の項目を確認してください。
よくあるエラーの例：
- お客様コードの桁数や半角/全角がe飛伝Ⅲの指定形式と合っていない
- ある設定同士の組み合わせが利用できない状態になっている
エラーメッセージにはどの項目をどう直せばよいかが具体的に書かれていますので、その内容に従って修正してください。
次に読む記事
- 設定が終わったら「配送伝票CSVのエクスポート方法」で実際にCSVを出力してみましょう。