この記事でわかること
EC-CUBEの受注・配送データを、配送会社の送り状発行サービスへCSVで渡すための設計ポイントを解説します。標準機能と項目変換の使い分け、取込結果の確認、住所変更・再発行時の重複防止、送り状番号をEC-CUBEへ戻す方法を整理します。
送り状CSV連携では、必要な項目を揃えたうえで、どの配送を取り込み、何枚の送り状を発行したかを確認できるようにすることが大切です。利用するソフトの設定で対応できる範囲を確認し、毎回の手直しや確認漏れが起きやすい部分を、追加する処理として検討します。
送り状CSV連携の流れと、標準機能で対応できる範囲
EC-CUBEに登録された配送先や商品情報をCSVで渡すと、送り状を作る際の転記を減らせます。基本的な流れは、対象配送の選択、CSV出力、送り状ソフトへの取り込み、内容確認、発行・印刷です。送り状番号をEC-CUBEへ戻す場合は、その後の出荷情報の登録も含めて設計します。
EC-CUBE4の公式マニュアルでは、受注・配送などのCSVについて、出力する項目と並び順を設定する方法が説明されています。最初に、利用中のバージョン・プラグイン・既存改修と、実際に出力されるCSVを確認します。
ヤマト運輸のB2クラウドでは、指定の形式に合わせる方法に加え、元データの列と取込項目を対応づける方法も案内されています。佐川急便のe飛伝ⅢにもCSV等の取込機能があります。EC-CUBEの出力設定と、送り状ソフト側の取込設定の両方を確認すると、追加開発が必要な範囲を判断しやすくなります。
| 確認する範囲 | 主な確認内容 |
|---|---|
| EC-CUBEの標準CSV出力 | 必要な項目があるか、項目の並び順を調整できるか、CSVの1行が何を表すか |
| 送り状ソフトの取込設定 | 項目の対応づけ、テンプレート、固定値などの設定で必要な形式を満たせるか |
| プラグイン・個別の加工処理 | 住所の結合・分割、コード変換、配送単位への集約、独自項目や出力履歴への対応が必要か |
毎回同じ手順でExcelなどを使って加工している場合は、変換ルールを整理して、出力時に処理する方法も考えられます。設定やプラグインを変更する際は、既存のCSVを利用している他の連携先への影響も確認します。
参照：EC-CUBE公式マニュアル「CSV出力項目設定」／ヤマト運輸「B2クラウドで外部データから送り状を発行する方法」／佐川急便「e飛伝Ⅲ」
住所・配送区分・代引金額の対応と変換ルールを決める
項目名が似ていても、注文者の住所と届け先の住所、店舗内の配送区分と配送会社の区分などは意味が異なります。元データ、取込先の項目、加工方法、空欄や不正な値の扱いを対応表にまとめます。
| 項目 | 設計時に確認すること |
|---|---|
| 届け先・依頼主 | 注文者と届け先の使い分け、ギフト時の依頼主、会社名・部署名・担当者名の印字先 |
| 郵便番号・電話番号 | 先頭ゼロの保持、ハイフンの有無、文字数、空欄・不正値を確認する方法 |
| 住所 | 都道府県から建物名までの結合・分割、文字数制限、全角・半角や使用できない文字 |
| 配送区分・温度帯 | 配送会社・サービスごとのコード対応、常温・冷蔵・冷凍などの扱い |
| 日付・時間帯 | 出荷予定日とお届け希望日の区別、日付形式、時間帯コード、指定なしの扱い |
| 品名・荷物数 | 複数商品の品名のまとめ方、規格名、梱包数と商品数量の区別 |
| 代引金額・管理番号 | 実際に回収する金額と税額の扱い、注文・配送を照合する番号、複数配送時の対応 |
先頭ゼロや住所の末尾を欠落させない
CSVを表計算ソフトで開いて保存すると、電話番号や管理番号の先頭ゼロなどが変わることがあります。対象列を文字列として扱い、加工前後のデータを比較します。文字コード、区切り文字、見出し行の有無、改行や引用符を含む値の扱いも、取込仕様に合わせます。
住所の文字数が上限を超えた場合は、後半を機械的に切り捨てると建物名・部屋番号が欠けるおそれがあります。別の住所欄へ分けるのか、確認対象として止めるのかを決め、印刷された送り状でも確認します。
配送区分と代引金額を店舗の表示名だけで判断しない
EC-CUBE上の「通常便」「午前中」などの表示名と、連携先で必要なコードがそのまま一致するとは限りません。配送会社や利用サービスごとに対応を確認し、変換先が見つからない値は担当者が確認できるようにします。
代引金額は、注文の合計をそのまま全行へ複写せず、値引き・ポイント利用・送料・手数料を含め、実際に回収する金額と一致するか確認します。1件の注文を複数の荷物に分ける場合は、回収方法を配送会社の条件に合わせて決めます。各送り状で注文総額を重ねて請求したり、独自の判断で分割したりしないよう、業務ルールを整理します。
配送単位と取込結果を確認して送り状を発行する
CSVの行数・注文数・送り状の枚数を区別する
1件の注文が、必ず1枚の送り状になるとは限りません。複数のお届け先、出荷元、梱包、発送日がある場合は、注文と配送・荷物の対応を整理します。
たとえば、同じ届け先へ2商品を1箱で送る注文について、商品明細ごとに2行あるCSVをそのまま取り込むと、設定によっては送り状が2件作られる場合があります。反対に、複数の届け先を注文番号だけで1行にまとめると、必要な配送が欠落します。
どの項目で行をまとめ、品名や数量をどう扱い、何枚発行するかを決めます。別々の注文を同梱する場合も、届け先が同じという理由だけでまとめず、お客様の希望、支払方法、出荷日などの条件を確認します。
取込成功の表示から、印刷結果と荷物の照合まで確認する
出力前には、今回発送する対象、保留・キャンセル・出荷済みの除外、配送会社の振り分けを確認します。締め時刻や前日からの持ち越しもある場合は、当日発送CSVの抽出条件と再出力の設計もあわせて整理します。
取り込み後は、予定した配送と登録されたデータを照合します。件数に加え、届け先、配送区分、代引金額などを確認し、エラー行が残っていないかを確かめます。印刷前の確認と、印刷後の送り状・荷物の照合までを作業手順に含めます。
CSVの出力、取り込み、送り状の発行・印刷、実際の発送は、それぞれ確認する段階です。必要な操作は利用するサービスや設定によって異なるため、「CSVを取り込むだけで、自動的に印刷・発送まで完了する」とは考えず、誰がどの結果を確認するかを決めます。
注文変更・再取り込み・再発行の手順を決める
住所変更と印刷失敗では、必要な対応を分ける
CSVを出力した後に住所が変わった場合と、印刷中に紙詰まりが起きた場合では、必要な対応が異なります。EC-CUBE側の情報を修正しても、すでに取り込んだデータや印刷済みの送り状まで変わるとは限りません。
- 取込前の変更：変更後のCSVを用意し、古いファイルを使わないようにする
- 取込後の変更：登録済みデータの状態を確認し、利用サービスの修正・取消手順に従う
- 印刷失敗：送り状の発行状況と印刷できた範囲を確認し、再印刷・再発行の対象を特定する
- 新しい配送の追加：すでに処理した配送を含めず、追加対象を確認して取り込む
同じ番号での再印刷になるか、新たな番号が発行されるかは、サービスや操作によって確認が必要です。旧送り状を荷物へ貼らないこと、必要な取消や回収を行うこと、出荷担当者に変更を伝えることまで手順に含めます。
処理済みの対象を確認し、二重発行・二重発送を防ぐ
取込エラーや通信の中断が起きた場合は、全件が未登録なのか、一部が処理されているのかを確認してから再操作します。同じCSVを取り込み直したときの重複チェックの有無や、チェックに使われる項目も、利用する環境で確認します。
運用上の記録として、出力日時、ファイル名、対象の注文・配送、使用したレイアウト、取込結果、送り状番号、担当者などを残す方法を検討します。複数人で処理する場合は、同じ配送を同時に作業しないよう、担当と進行状況を共有します。
CSVや送り状には個人情報が含まれるため、保存先、閲覧できる担当者、保管期間、不要になったファイルや印刷物の処分方法も決めます。
送り状番号をEC-CUBEへ戻し、出荷管理につなげる
送り状を発行した後は、どの注文・配送に、どの送り状番号が付いたかを確認できると、出荷管理やお客様からの問い合わせに対応しやすくなります。連携先から取り出せるデータと、EC-CUBE側の登録方法を照合します。
EC-CUBE4の公式マニュアル（4.3.1-p1版）には、出荷ID、お問い合わせ番号、出荷日を扱う「出荷CSV登録」が案内されています。ここで指定する出荷IDは、受注一覧から出力した出荷CSVの配送IDに対応します。
受注一覧からダウンロードする出荷CSVと、出荷CSV登録でアップロードするCSVは別の形式です。登録用画面の雛形を確認し、送り状ソフトの出力データを必要な形式へ合わせます。利用バージョンや既存改修によっても確認が必要です。
注文番号だけで照合せず、複数配送や再発行を扱えるようにする
1件の注文に複数の配送がある場合は、注文番号だけでは送り状番号を戻す先を特定できないことがあります。出力時から配送を識別する情報を渡し、発行後のデータにも残せるかを確認します。
1つの配送に複数の送り状番号が付く運用では、現在の登録欄で管理できるか、関連情報を持つ処理が必要かを確認します。再発行で番号が変わった場合は、有効な番号と以前の番号を区別できるようにします。
また、送り状の発行日と、実際に荷物を出す日は一致しない場合があります。番号の登録、出荷日の設定、受注状態の変更、発送通知メールをどのタイミングで行うかを決め、利用環境の動作を確認します。
送り状CSV連携の相談前に整理したいこと
現在出力しているCSVと、送り状ソフト側で必要な形式、毎回手作業で直している箇所が分かると、対応方法を検討しやすくなります。まずは次の情報を整理します。
- EC-CUBEのバージョン、利用中のプラグイン、CSV関連の既存改修
- 配送会社・送り状発行サービス、利用する配送サービス、取込テンプレート
- 現在のCSV、必要項目の対応表、コード変換や住所加工のルール
- 複数配送・分納・同梱・代引きの運用と、1回に処理する件数
- 取込エラー、住所変更、印刷失敗、再発行時の確認方法
- 送り状番号の戻し先、出荷日・受注状態・発送通知メールの扱い
確認には個人情報を置き換えたサンプルを用い、通常の注文に加えて、長い住所、先頭ゼロ、複数商品・複数配送、代引き、注文変更、取込失敗などのケースを含めます。取込結果と印刷内容、必要に応じてEC-CUBEへの番号登録まで確認します。
サンクユーでは、EC-CUBE構築・カスタマイズやBtoB-EC構築のご相談に対応しています。標準機能と送り状ソフトの設定で対応できる範囲を確認し、項目変換、専用CSV出力、番号の取り込みなど、業務に合わせて必要な処理を整理します。
EC-CUBEの送り状CSV連携に関するよくある質問
EC-CUBEの標準機能だけで送り状用CSVを作れますか？
EC-CUBE4のCSV出力項目設定では、出力する項目と並び順を調整できます。送り状ソフト側の項目対応やテンプレート設定と組み合わせ、必要な情報を渡せるか確認します。住所の分割、配送区分のコード変換、配送単位への集約などが必要な場合は、プラグインや個別の加工処理を検討します。
ヤマト運輸B2クラウドや佐川急便e飛伝Ⅲに連携できますか？
両サービスにはCSVなどの外部データを取り込む機能があります。B2クラウドのレイアウト設定やe飛伝Ⅲのテンプレートを確認し、利用サービスの必須項目・入力規則に合うデータを用意します。EC-CUBEから出したCSVが、そのまま無加工で使えるかは実際の形式を照合して判断します。
CSVを取り込めば、自動で送り状の印刷まで終わりますか？
CSVの取り込み、エラーや内容の確認、送り状の発行・印刷は区別して確認します。必要な操作は利用サービスや設定によって異なります。取込成功だけで印刷・発送まで完了したとは判断せず、印刷結果と荷物の対応を確認します。
1件の注文から複数の送り状を発行する場合はどうしますか？
複数のお届け先、出荷元、梱包数、発送日などに応じて、注文と配送・荷物の対応を整理します。注文明細ごとのCSVをそのまま取り込むと、必要以上に送り状が作られる場合があります。どの単位で行をまとめ、何枚発行するかを決め、代引金額や送り状番号の対応も確認します。
住所変更や印刷失敗で再発行するときは、CSVを取り込み直せばよいですか？
最初に、登録済みのデータ、発行された送り状、荷物の作業状況を確認します。同じ送り状の再印刷、内容を変更した発行、新しい配送の追加は分けて扱い、利用サービスの手順に従います。不要な旧送り状を使わないことと、登録済みデータを重ねて処理しないことを確認します。
発行した送り状番号をEC-CUBEへ戻せますか？
EC-CUBE4の公式マニュアルには、出荷ID・お問い合わせ番号・出荷日を扱う出荷CSV登録が案内されています。連携先の出力データをEC-CUBEの登録用形式に合わせ、対象の配送と送り状番号を対応づけます。受注一覧から出力した出荷CSVとは形式が異なるため、そのまま流用せず、利用環境の雛形を確認します。
EC-CUBEの送り状CSV連携・出荷業務をご相談ください
現在のCSVと送り状発行の手順を確認し、項目変換、取込確認、再発行、送り状番号の登録まで、業務に合う対応方法を整理します。
投稿者プロフィール
- サンクユーのEC-CUBE担当。15年以上にわたりEC-CUBE開発に従事し、2系・3系・4系すべてに精通。難易度の高いカスタマイズや、他社構築サイトの改修・再設計も多数対応しています。
Javaでの業務システム開発を起点に、PHP・Perl・フロントエンド・CMSまで横断的に対応。基幹システム連携や業務フローを踏まえた設計を得意とし、複雑な要件にも柔軟に対応可能です。
ChatGPT CODEXを活用し、開発スピードと品質の両立を実現しています。
