一括登録更新 - 追跡番号
1. ファイルの概要
当サービスの管理に必要なデータは、サイドメニュー＞設定＞一括登録更新より、CSV ファイルで一括登録更新できます。
ここでは、出荷データ（システム内出荷番号単位のデータ）に対して、配送業者の追跡番号を登録更新する CSV ファイルについてご紹介します。
2. ファイルの作成
追跡番号を登録更新する CSV ファイルの作成方法をご紹介します。
作成方法
-
登録更新する CSV ファイルを作成するため、もととなる CSV ファイルをダウンロードします。
【一括登録更新】ページにテンプレートファイルがあるので、「追跡番号」をダウンロードしてください。
-
ダウンロードしたテンプレートファイルを、登録更新したい内容に修正します。
3. ファイルの仕様
追跡番号を登録更新する CSV ファイルの仕様をご紹介します。
1. ファイル概要
CSV ファイルの概要をご紹介します。
| ファイル名 | 入力 / 出力 | 拡張子 | 文字コード | 囲み文字 | 区切り文字 | エスケープ文字 | 改行コード | ヘッダー有無 | 1 ファイルあたりの上限行数 | 備考 |
|---|---|---|---|---|---|---|---|---|---|---|
| 任意のファイル名を指定してください。 | 入力 | .csv | UTF-8 BOM 付 | ダブルクォーテーション | , | ダブルクォーテーション | CRLF ※「\r\n」を入力してください。それ以外はエラーとなります。 | あり | 1000 | ー |
＜データの指定に関するルール＞
CSV ファイルをアップロードする際に、気を付けるべきルールが 2 点あります。
1. Null の設定方法とその扱い
・Null とは？: Null は「何もない状態」を意味します。データベースやプログラムで、値が存在しないことを示します。
・Null の設定方法: データの区切り文字（カンマ）の間に何も入力しないと、その部分は「Null」として扱われます。 例：,,
・Null の扱い: 既存のデータを更新する際に、Null が指定されている項目は、変更されず、元の値のまま残ります。
2. 空文字の設定方法
・空文字とは？: 空文字は「空の文字列」を意味します。つまり、値は存在するが、その中身が空であることを示します。
・空文字の設定方法: データの区切り文字（カンマ）の間をダブルクオーテーション（"）で囲むと、その部分は「空文字」として扱われます。 例：,"",
・空文字の扱い（新規登録）: CSV ファイルで空文字が指定されている項目は、そのまま空文字で登録されます。
・空文字の扱い（更新）: 空文字を指定して更新すると、既に登録済のデータは削除されます。
2. イメージ図
1 行目：ヘッダ領域
2 行目：データ領域
3. 項目定義
CSV ファイルの項目定義をご紹介します。
| 項目名 | データ型 | 項目長 | 新規登録時必須 | 更新時必須 | 形式 ※注釈参照 | 備考 |
|---|---|---|---|---|---|---|
| Index | 数値 | 15 | ○ | ○ | CSV ファイルの各レコードの先頭（システム内出荷番号 の前）に、そのレコードが特定できる数値（1,2,3…）を指定してください。 | アップロードの際に、取込エラーとなるレコードがあった場合、Index を含めてエラーメッセージを表示します。 |
| システム内出荷番号 | 文字列 | 20 | ○ | ○ | 任意の文字列（システム内出荷番号） | 存在しないシステム内出荷番号を指定した場合、エラーとなります。 |
| 追跡番号 | 文字列 | 100 | 半角数字 | ・「システム内出荷番号」に対応する注文の状態が「承認済」である必要があります。 それ以外の状態の場合、エラーとなります。 ・「配送ステータス」に 09：未出荷クローズ を指定している場合は、エラーとなります。 ・追跡番号を登録すると、その出荷データ（システム内出荷番号）のステータスは「出荷済」となります。 ・登録できる追跡番号は、1 回のアップロードにつき最大 200 件です。 | ||
| 配送手段 ID | 文字列 | 19 | 任意の文字列（配送手段 ID） | ・「追跡番号」 に値を指定している場合にのみ、この項目は有効です。「追跡番号」を指定せずにこの項目に値を指定した場合は、エラーとなります。 ・ステータスが「無効」になっている配送手段は指定できません。 | ||
| 配送手段名 | 文字列 | 255 | 任意の文字列 | 「追跡番号」に値を指定している、かつ、「配送手段 ID」に値を指定していない場合にのみ、この項目は有効です。 それ以外の場合でこの項目に値を指定すると、エラーとなります。 | ||
| 出荷予定日 | 日付 | - | YYYY-MM-DD（年月日） | 「追跡番号」に値を指定していない場合のみ、この項目は有効です。 「追跡番号」と「出荷予定日」いずれにも値を指定した場合は、エラーとなります。 | ||
| 配送ステータス | 文字列 | 2 | 下記のいずれかの数字 2 桁を指定してください。 【配送ステータス】 01：未出荷 02：出荷依頼済 03：出荷済 09：未出荷クローズ | 「システム内出荷番号」に対応する注文の状態が「承認済」である必要があります。それ以外の状態の場合、エラーとなります。 |
※注釈
実際には、記載の形式をダブルクォーテーションで囲って指定してください。
囲っている値に、カンマ（,）、ダブルクォーテーション（"）、改行コード（\r\n）が含まれている場合は、エスケープ処理を行った状態で指定してください。
4. 例
【一括登録更新】ページに、追跡番号を登録更新する CSV ファイルのサンプルファイルを掲載しています。
CSV ファイル作成時にご参考ください。