一括登録更新 - 得意先
公開日：2024 年 10 月 1 日／更新日：2024 年 10 月 1 日
1. ファイルの概要
当サービスの管理に必要なデータは、サイドメニュー＞設定＞一括登録更新より、CSV ファイルで一括登録更新できます。
ここでは、得意先を登録更新する CSV ファイルについてご紹介します。
2. ファイルの作成
得意先を登録更新する CSV ファイルの作成方法をご紹介します。
作成方法
-
登録更新する CSV ファイルを作成するため、もととなる CSV ファイルをダウ ンロードします。
＜はじめて得意先を登録する場合＞ （既存の得意先のレコードが 0 の場合）
【一括登録更新】ページにテンプレートファイルがあるので、「得意先」をダウンロードしてください。
＜既に得意先が登録されている場合＞
得意先一覧のチェックボックス操作より、「CSV ダウンロード」を選択してダウンロードしてください。
詳しい操作方法については、【得意先一覧】 4. チェックボックス をご覧ください。
-
ダウンロードしたテンプレートファイルを、登録更新したい内容に修正します。
3. ファイルの仕様
得意先を登録更新する CSV ファイルの仕様をご紹介します。
1. ファイル概要
CSV ファイルの概要をご紹介します。
| ファイル名 | 入力/出力 | 拡張子 | 文字コード | 囲み文字 | 区切り文字 | エスケープ文字 | 改行コード | ヘッダー有無 | 備考 |
|---|---|---|---|---|---|---|---|---|---|
| 任意のファイル名を指定してください。 | 入力 | .csv | UTF-8 BOM 付 | ダブルクォーテーション | , | ダブルクォーテーション | CRLF | あり | ー |
＜データの指定に関するルール＞
CSV ファイルをアップロードする際に、気を付けるべきルールが 2 点あります。
1. Null の設定方法とその扱い
・Null とは？: Null は「何もない状態」を意味します。データベースやプログラムで、値が存在しないことを示します。
・Null の設定方法: データの区切り文字（カンマ）の間に何も入力しないと、その部分は「Null」として扱われます。 例：,,
・Null の扱い: 既存のデータを更新する際に、Null が指定されている項目は、変更されず、元の値のまま残ります。 2. 空文字の設定方法
・空文字とは？: 空文字は「空の文字列」を意味します。つまり、値は存在するが、その中身が空であることを示します。
・空文字の設定方法: データの区切り文字（カンマ）の間をダブルクオーテーション（"）で囲むと、その部分は「空文字」として扱われます。 例：,"",
・空文字の扱い: CSV ファイルで空文字が指定されている項目は、そのまま空 文字で更新されます。
2. イメージ図
1 行目：ヘッダ領域
2 行目：データ領域
3. 項目定義
CSV ファイルの項目定義をご紹介します。
| 項目名 | データ型 | 項目長 | 新規登録時必須 | 更新時必須 | 形式 | 備考 |
|---|---|---|---|---|---|---|
| Index | 数値 | 6 | ○ | ○ | CSV ファイルの各レコードの先頭（得意先コードの前）に、そのレコードが特定できる数値（1,2,3…）を指定してください。 | アップロードの際に、取込エラーとなるレコードがあった場合、Index を含めてエラーメッセージを表示します。 |
| 得意先コード | 文字列 | 11 | ※注釈 1 参照 | ○ | 任意の文字列 | 更新時は、更新新する得意先の得意先コードを指定してください。 得意先コードは、得意先一覧画面で確認できます。 |
| 得意先区分 | 文字列 | 255 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【得意先区分】 01：得意先（通常） 02：卸先 | 更新時、得意先区分を変更するこ とはできません。 | |
| ステータス | 文字列 | 255 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【ステータス】 01：有効 02：無効 | ||
| 言語コード | 文字列 | 255 | ○ | 下記のいずれかの文字列 2 桁を指定してください。 【言語コード】 ja：日本語 en：英語 | ||
| 得意先名 | 文字列 | 255 | ○ | 任意の文字列 | ||
| 得意先名_フリガナ | 文字列 | 255 | 任意の文字列 | |||
| 得意先名_略称 | 文字列 | 255 | 任意の文字列 | |||
| 事業所 | 文字列 | 255 | ○ | 任意の文字列 | ||
| 部署 | 文字列 | 255 | 任意の文字列 | |||
| 得意先担当者（姓・LASTname） | 文字列 | 50 | ○ | 任意の文字列 | ||
| 得意先担当者（姓・LASTname）フリガナ | 文字列 | 50 | 任意の文字列 | |||
| 得意先担当者（名・FIRSTname） | 文字列 | 50 | ○ | 任意の文字列 | ||
| 得意先担当者（名・FIRSTname）フリガナ | 文字列 | 50 | 任意の文字列 | |||
| E メール | 文字列 | 255 | XX＠XXX（半角英数記号） | |||
| 国コード | 文字列 | 255 | ○ | 下記リンクのページにある国コードのうちいずれかを指定してください。 【国コード一覧】 | ||
| 郵便番号 | 文字列 | 64 | 郵便番号 | ・記号（ - など）を含みます。 ・海外の郵便番号もご指定いただけます。 | ||
| 都道府県 | 文字列 | 32 | 任意の文字列 | |||
| 市区町村 | 文字列 | 255 | ○ | 任意の文字列 | ||
| 番地・建物・部屋番号 | 文字列 | 255 | 任意の文字列 | |||
| 電話番号 | 文字列 | 255 | 半角英数記号 | |||
| 内線 | 文字列 | 255 | 半角英数記号 | |||
| FAX | 文字列 | 255 | 半角英数記号 | |||
| 毒劇物取扱営業者許可 | 日付 | - | YYYY-MM-DD（年月日） | 毒劇物取扱営業者許可の有効期限（年月日）を指定してください。 | ||
| 医薬品製造業許可 | 日付 | - | YYYY-MM-DD（年月日） | 医薬品製造業許可の有効期限（年月日）を指定してください。 | ||
| 医薬品製造販売業許可 | 日付 | - | YYYY-MM-DD（年月日） | 医薬品製造販売業許可の有効期限（年月日）を指定してください。 | ||
| 得意先グループ ID | 文字列 | 255 | 任意の数値（得意先グループ ID） | |||
| グループ単価 ID | 文字列 | 255 | 任意の数値（グループ単価 ID） | |||
| 課税区分 | 文字列 | 255 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【課税区分】 01：課税 02：非課税 03：海外なら非課税 | ||
| 支払通貨コード | 文字列 | 3 | ○ | 下記リンクのページにある支払通貨コードのうちいずれかを指定してください。 【支払通貨コード一覧】 | ||
| 支払方法区分 | 文字列 | 255 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【支払方法区分】 01：銀行振込（前払い） 02：銀行振込（後払い） 09：その他 | ||
| 支払方法_自由入力 | 文字列 | 255 | 任意の文字列 | 支払方法区分に 09：その他 を指定するときに、具体的な支払方法を指定してください。 | ||
| 支払条件区分 | 文字列 | 255 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【支払方法区分】 01：都度払い 02：締め払い 09：その他 | ||
| 支払条件_締め日 | 文字列 | 255 | 01~31 のうちいずれかの数字を指定してください。 毎月末日とする場合は、99 を指定してください。 | |||
| 支払条件_支払月 | 文字列 | 255 | 下記のいずれかの数字 2 桁を指定してください。 【支払条件_月】 01：当月 02：翌月 09：翌々月 | |||
| 支払条件_支払日 | 文字列 | 255 | 01~31 のうちいずれかの数字を指定してください。 毎月末日とする場合は、99 を指定してください。 | |||
| 支払 条件_自由入力 | 文字列 | 255 | 任意の文字列 | 支払条件区分に 09：その他 を指定するときに、具体的な支払条件を指定してください。 | ||
| 確認者（管理者 ID） | 文字列 | 255 | 任意の文字列（管理者 ID） | 複数の管理者を指定するときは、カンマ（,）区切りで並べてください。 | ||
| 承認者（管理者 ID） | 文字列 | 255 | 任意の文字列（管理者 ID） | 複数の管理者を指定するときは、カンマ（,）区切りで並べてください。 | ||
| 標準倉庫管理番号 | 文字列 | 2 | 任意の数値 | 倉庫 ID を入力してください。 倉庫 ID は、店舗設定（倉庫）画面で確認できます。 ※左端に表示されている倉庫の番号です。  | ||
| 貿易取引条件（インコタームズ）コード | 文字列 | 255 | 下記リンクのページにある貿易取引条件（インコタームズ）コードのうちいずれかを指定してください。 【貿易取引条件（インコタームズ）コード一覧】 | |||
| 貿易取引条件（インコタームズ）_その他入力 | 文字列 | 255 | 任意の文字列 | 貿易取引条件（インコタームズ）コードに 999：その他 を指定するときに、具体的な貿易取引条件を指定してください。 | ||
| 仕向け国 | 文字列 | 255 | 任意の文字列 | |||
| 目的地 | 文字列 | 255 | 任意の文字列 | |||
| 請求先_会社・団体・学校・施設名 | 文字列 | 255 | 任意の文字列 | |||
| 請求先_事業所 | 文字列 | 255 | 任意の文字列 | |||
| 請求先_部署 | 文字列 | 255 | 任意の文字列 | |||
| 請求先担当者姓 | 文字列 | 50 | 任意の文字列 | |||
| 請求先担当者姓_フリガナ | 文字列 | 50 | 任意の文字列 | |||
| 請求先担当者名 | 文字列 | 50 | 任意の文字列 | |||
| 請求先担当者名_フリガナ | 文字列 | 50 | 任意の文字列 | |||
| 請求先_国コード | 文字列 | 255 | 下記リンクのページにある国コードのうちいずれかを指定してください。 【国コード一覧】 | |||
| 請求先_郵便番号 | 文字列 | 64 | 郵便番号 | ・記号（ - など）を含みます。 ・海外の郵便番号もご指定いただけます。 | ||
| 請求先_都道府県 | 文字列 | 32 | 任意の文字列 | |||
| 請求先_市区町村 | 文字列 | 255 | 任意の文字列 | |||
| 請求先_番地・建物・部屋番号 | 文字列 | 255 | 任意の文字列 | |||
| 請求先_電話番号 | 文字列 | 255 | 半角英数記号 | |||
| 請求先_内線 | 文字列 | 255 | 半角英数記号 | |||
| 請求先_FAX | 文字列 | 255 | 半角英数記号 | |||
| 請求書様式区分 | 文字列 | 255 | 下記のいずれかの数字 2 桁を指定してください。 【請求書様式区分】 01：取引単位 02：請求単位 | |||
| 配送先 ID | 数値 | - | ※注釈 2 参照 | ※注釈 2 参照 | 任意の数値（配送先 ID） | |
| 配送先_会社・団体・学校・施設名 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先_事業所 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先_部署 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先担当者姓 | 文字列 | 50 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先担当者姓_フリガナ | 文字列 | 50 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先担当者名 | 文字列 | 50 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先担当者名_フリガナ | 文字列 | 50 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先_国 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 下記リンクのページにある国コードのうちいずれかを指定してください。 【国コード一覧】 | |
| 配送先_郵便番号 | 文字列 | 64 | ※注釈 3 参照 | ※注釈 3 参照 | 郵便番号 | ・記号（ - など）を含みます。 ・海外の郵便番号もご指定いただけます。 |
| 配送先_都道府県 | 文字列 | 32 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先_市区町村 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先_番地・建物・部屋番号 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 任意の文字列 | |
| 配送先_電話番号 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 半角英数記号 | |
| 配送先_内線 | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 半角英数記号 | |
| 配送先_FAX | 文字列 | 255 | ※注釈 3 参照 | ※注釈 3 参照 | 半角英数記号 | |
| 配送業者コード | 数値 | 下記リンクのページにある配送業者コードのうちいずれかを指定してください。 【配送業者コード一覧】 | 配送業者の情報を登録更新するときに使用します。 会員に表示する/しないの情報や、配送料の情報を登録更新する配送料業 者を指定してください。 | |||
| 国内/海外 | 文字列 | 255 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【国内/海外区分】 01：国内 02：海外 | 配送業者を会員に表示する/しないの情報を登録更新するときに使用します。 国内配送時の情報を登録更新するときは「国内」を、海外配送時の情報を登録更新するときは「海外」を指定してください。 | |
| 表示フラグ | 真偽値 | - | 「true」もしくは「false」を指定してください。 【表示フラグ】 true：表示する false：表示しない | 配送業者を会員に表示する/しないの情報を登録更新するときに使用します。 | ||
| 配送料計算区分 | 文字列 | 255 | 下記のいずれかの数字 2 桁を指定してください。 【配送料計算区分】 01：無料 02：固定 03：受注後調整 04：受注金額 05：API 06：API ＋手数料 | 「API」および「API ＋手数料」は、配送業者コードに DHL 社を指定したときのみ指定できます。 | ||
| 固定額 | 数値 | 整数 13 桁+小数第 2 位 | 任意の数値 | 配送料計算区分に 02：固定を指定するときに、具体的な金額を指定してください。 | ||
| 受注金額 | 数値 | 整数 13 桁+小数第 2 位 | 任意の数値 | 配送料計算区分に 04：受注金額を指定するときに、条件とする受注金額を指定してください。 | ||
| 配送料_受注金額以上 | 数値 | 整数 13 桁+小数第 2 位 | 任意の数値 | 配送料計算区分に 04：受注金額を指定するときに、 条件とする受注金額を超えるときの配送料を指定してください。 | ||
| 配送料_受注金額未満 | 数値 | 整数 13 桁+小数第 2 位 | 任意の数値 | 配送料計算区分に 04：受注金額を指定するときに、条件とする受注金額を下回るときの配送料を指定してください。 | ||
| 手数料 | 数値 | 整数 13 桁+小数第 2 位 | 任意の数値 | 配送料計算区分に 06：API ＋手数料を指定するときに、具体的な金額を指定してください。 | ||
| 卸先の得意先コード | 文字列 | 11 | 任意の文字列（卸先の得意先コード） | 得意先に紐づける卸先の得意先コードを指定してください。 |
※注釈 1
得意先コードは、任意の文字列を指定するほか、未指定で登録することもできます。
未指定の場合は、下記の形式で自動採番されます。
| 項目名 | 形式 | 例 |
|---|---|---|
| 得意先コード | C+整数 10 桁 0 埋め | C0000000001 |
※注釈 2
配送先 ID は、配送先を新規登録する場合と、既存の配送先を指定する場合で登録方法が異なります。
＜配送先を新規登録する場合＞
配送先 ID は未指定で登録してください。下記の形式で自動採番されます。
| 項目名 | 形式 | 例 |
|---|---|---|
| 配送先 ID | 数字 | 1 |
＜既存の配送先を更新する場合＞
配送先 ID を指定してください。配送先 ID は、得意先一覧の CSV ファイルをダウンロードすることで確認できます。
ダウンロード方法と CSV ファイルの詳細については、【ダウンロード CSV（得意先一覧）】をご覧ください。
※注釈 3
配送先情報の各項目は、配送先を新規登録する場合と、既存の配送先を指定する場合で登録方法が異なります。
＜配送先を新規登録する場合＞（「配送先 ID」が未指定の場合）
各項目は指定必須です。
＜既存の配送先を更新する場合＞（「配送先 ID」を指定する場合）
各項目は指定不要です。
4. 例
【一括登録更新】ページに、得意先を登録更新する CSV ファイルのサンプルファイルを掲載しています。
CSV ファイル作成時にご参考ください。