マスタ取込テンプレート
各マスタを CSV ファイルで一括登録するためのテンプレート集です。テンプレートには記入例（コードが SAMPLE- で始まる行）が入っています。推奨取込順序のとおりに無修正で取り込むと、すべてエラーなく登録できるように作られているので、まず一度そのまま取り込んで動きを確認し、その後 SAMPLE 行をご自身のデータに置き換える使い方をおすすめします（SAMPLE データは確認後に各一覧画面から削除できます）。
テンプレート一覧（ダウンロード）
| # | マスタ | テンプレート | 取込画面 |
|---|---|---|---|
| 1 | 顧客区分 | 取込テンプレート_顧客区分.csv | マスタ管理 → 顧客区分一覧 → インポート |
| 2 | 仕入先区分 | 取込テンプレート_仕入先区分.csv | マスタ管理 → 仕入先区分一覧 → インポート |
| 3 | 商品区分 | 取込テンプレート_商品区分.csv | マスタ管理 → 商品区分一覧 → インポート |
| 4 | 商品区分2 | 取込テンプレート_商品区分2.csv | マスタ管理 → 商品区分2一覧 → インポート |
| 5 | 商品区分3 | 取込テンプレート_商品区分3.csv | マスタ管理 → 商品区分3一覧 → インポート |
| 6 | 商品区分4 | 取込テンプレート_商品区分4.csv | マスタ管理 → 商品区分4一覧 → インポート |
| 7 | 仕入先 | 取込テンプレート_仕入先.csv | マスタ管理 → 仕入先一覧 → インポート |
| 8 | 商品 | 取込テンプレート_商品.csv | マスタ管理 → 商品一覧 → インポート |
| 9 | 顧客（フル） | 取込テンプレート_顧客.csv | マスタ管理 → 顧客一覧 → インポート |
| 10 | 顧客（掛率区分割当のみ） | 取込テンプレート_顧客_掛率区分割当のみ.csv | マスタ管理 → 顧客一覧 → インポート |
| 11 | 顧客別単価 | 取込テンプレート_顧客別単価.csv | マスタ管理 → 顧客別単価一覧 → インポート |
推奨取込順序
マスタ間には参照関係があるため、この順序で取り込んでください。順序を守らないと「〜が登録されていません」エラーになります。
- 顧客区分
- 仕入先区分
- 商品区分（必要に応じて商品区分2〜4も）
- 仕入先 ← 仕入先区分を参照
- 商品 ← 商品区分（必須）・商品区分2〜4・仕入先（任意）を参照
- 顧客 ← 顧客区分（必須）を参照。締め日グループ・入金条件は名称から自動作成可能（後述）
- 顧客別単価 ← 顧客・商品を参照（両方を先に登録）
- 掛率区分割当のみ（任意）← 顧客と掛率区分マスタを先に登録したうえで、顧客一覧のインポートから実行
取込の基本ルール（全マスタ共通)
- ファイル形式: CSV（UTF-8）または Excel（.xlsx）。本テンプレートは Excel でそのまま開いて編集できます
- 上限: 1ファイル 5MB・50,000行まで
- 1行目はヘッダ行（列名）。列の並び順は自由で、ヘッダ名で判定されます。不要な任意列は列ごと削除しても構いません（その列は既定値で登録されます)
code（コード）が登録キーです。未登録のコードは新規登録、登録済みのコードは上書き更新、登録済みかつ内容が同じ行はスキップされます。⚠️ 既存データと同じコードを誤って書くと上書きされるためご注意ください- コードの変更（リネーム）には使えません。コードを変えて取り込むと「旧コードが残ったまま新コードが追加」されます
- 取込実行後、まずプレビュー（検証）画面で新規/更新/スキップ/エラーの件数が表示されます。エラーが1件でもあると本登録はできません。この時点ではデータは一切登録されていないので、ファイルを修正して何度でもやり直せます
- 真偽値（有効フラグ等）は
1（はい）/0（いいえ）で記入します - 数値の列と選択値の列は空欄にせず、必ず値を記入してください（迷ったら各表の「既定値」を記入）。文字列の任意列（住所・備考など）は空欄で構いません
1. 区分マスタ（顧客区分・仕入先区分・商品区分1〜4）
6種とも同じ3列構成です。
| 列名 | 項目 | 必須 | 記入内容 |
|---|---|---|---|
code |
区分コード | 必須 | 半角英数 20文字以内。登録キー |
name |
区分名 | 必須 | 100文字以内 |
sort_order |
表示順 | 任意 | 整数。空欄は 0。10・20・30 のように間隔を空けると後から間に追加できます |
補足
- 商品区分1〜4 は別々のマスタ・別々の取込画面です。1つのファイルにまとめることはできません
- 顧客区分は1つのマスタを「顧客区分1〜4」の4用途で共用します。マスタ登録は顧客区分一覧の1か所だけで行います
- 商品・顧客・仕入先から参照されている区分（区分1）は削除できません。区分2〜4は削除可能です（参照していた商品等の区分2〜4は未設定に戻ります）
2. 仕入先マスタ（31列）
| 列名 | 項目 | 必須 | 記入内容 / 既定値 |
|---|---|---|---|
code |
仕入先コード | 必須 | 50文字以内。登録キー |
name |
仕入先名 | 必須 | 200文字以内 |
name_kana |
仕入先略称 | 任意 | 200文字以内 |
supplier_category_code |
仕入先区分 | 必須 | 仕入先区分マスタの code。先に区分を登録 |
is_group_company |
グループ会社 | 任意 | 1/0。既定値 0 |
is_individual |
個人（支払調書対象） | 任意 | 1/0。既定値 0 |
corporate_number |
法人番号 | 任意 | 20文字以内 |
invoice_number |
適格請求書発行事業者登録番号 | 任意 | T+13桁（例: T1234567890123） |
is_tax_exempt |
免税事業者等 | 任意 | 1/0。既定値 0 |
postal_code / address / address2 |
郵便番号・住所 | 任意 | |
tel / tel2 / fax |
電話・FAX | 任意 | 各20文字以内 |
fax_enabled |
FAX送信 | 任意 | 1/0。既定値 1 |
email / url / contact_person |
メール・URL・担当者 | 任意 | |
payment_slip_send_method |
支払明細書送信手段 | 任意 | mail郵送 / emailメール / faxFAX / otherその他。空欄可 |
payment_type |
支払区分 | 推奨記入 | kakake掛け（締め） / cash現金 / prepaid前払い。既定値 kakake |
payment_terms_detail |
支払条件 | 推奨記入 | end_of_month月末締め / 15th15日締め / 20th20日締め / otherその他。既定値 end_of_month |
payment_method |
支払方法 | 推奨記入 | transfer銀行振込 / cash現金 / check小切手 / bill手形 / offset相殺 / otherその他。既定値 transfer |
tax_calc_method |
消費税計算方法 | 推奨記入 | invoice伝票計 / monthly月計 / line明細行計。既定値 invoice |
rounding_method |
端数処理 | 推奨記入 | round四捨五入 / floor切り捨て / ceil切り上げ。既定値 round |
ap_opening_balance |
買掛金開始残高 | 推奨記入 | 数値（例 0.00） |
bank_name / bank_from |
振込先・振込元 | 任意 | 各200文字以内 |
sort_order |
表示順 | 任意 | 整数 |
is_active |
有効 | 推奨記入 | 1/0。既定値 1 |
remarks |
備考 | 任意 |
3. 商品マスタ
| 列名 | 項目 | 必須 | 記入内容 / 既定値 |
|---|---|---|---|
code |
商品コード | 必須 | 50文字以内。登録キー |
name |
商品名 | 必須 | 200文字以内 |
name2 |
商品名（下段） | 任意 | 200文字以内 |
name_kana |
商品略称 | 任意 | 200文字以内 |
category_code |
商品区分 | 必須 | 商品区分マスタの code。先に区分を登録 |
category2_code〜category4_code |
商品区分2〜4 | 任意 | 各区分マスタの code。空欄可 |
unit |
基準単位 | 条件付き | 20文字以内（個・箱・kg・式 等）。在庫管理する商品、または単位2/3を使う商品では必須。それ以外は空欄可。既定値 個 |
unit2 |
単位2 | 任意 | 複数単位管理がオンのとき利用。20文字以内 |
unit2_factor |
単位2の換算係数 | 条件付き | 単位2を使う場合は必須。単位2の1あたりの基準単位数（例: 1箱=100個 なら 100） |
unit3 |
単位3 | 任意 | 複数単位管理がオンのとき利用。20文字以内 |
unit3_factor |
単位3の換算係数 | 条件付き | 単位3を使う場合は必須。単位3の1あたりの基準単位数（例: 1袋=10個 なら 10） |
jan_code |
JANコード | 任意 | 50文字以内 |
stock_management |
在庫管理区分 | 推奨記入 | stock在庫管理する / non_stock在庫管理しない / serviceサービス。既定値 non_stock |
business_category |
事業区分 | 推奨記入 | follow販売基本情報に準拠 / sales販売のみ / purchase仕入のみ / both両方。既定値 follow |
list_price |
定価 | 任意 | 数値。空欄可（未設定として扱われます） |
standard_price |
標準売価 | 推奨記入 | 数値（例 1000.00） |
standard_price2〜5 |
販売単価2〜5 | 推奨記入 | 数値。使わない場合は 0.00 |
price_tax_included |
税込み単価（販売） | 推奨記入 | 1/0。既定値 0（税抜） |
sales_tax_type |
販売課税区分 | 推奨記入 | standard課税（標準） / reduced課税（軽減） / exempt非課税 / free免税。既定値 standard |
standard_cost |
標準原価 | 推奨記入 | 数値 |
purchase_tax_type |
仕入課税区分 | 推奨記入 | 販売課税区分と同じ選択肢。既定値 standard |
cost_tax_included |
税込み単価（仕入） | 推奨記入 | 1/0。既定値 0 |
primary_supplier_code |
主たる仕入先① | 任意 | 仕入先マスタの code。空欄可 |
primary_supplier_2_code |
主たる仕入先② | 任意 | 仕入先マスタの code。空欄可。①〜③で同一コード不可 |
primary_supplier_3_code |
主たる仕入先③ | 任意 | 仕入先マスタの code。空欄可。①〜③で同一コード不可 |
is_bom_product |
BOM商品 | 任意 | 1/0。既定値 0 |
is_outsource |
外注加工品 | 任意 | 1/0。既定値 0 |
default_supplier_code |
主な仕入先（外注・BOM用） | 任意 | 仕入先マスタの code。空欄可 |
initial_stock |
初期在庫数量 | 推奨記入 | 数値（例 0.000）。参考値です |
stock_threshold |
在庫しきい値 | 推奨記入 | 数値 |
sort_order |
表示順 | 任意 | 整数 |
is_active |
有効 | 推奨記入 | 1/0。既定値 1 |
weight_kg |
重量(kg) | 任意 | 数値。空欄可 |
package_width_mm / package_depth_mm / package_height_mm |
梱包サイズ(mm) | 任意 | 正の整数。空欄可 |
country_of_origin |
原産国 | 任意 | 50文字以内 |
drawing_url |
図面URL | 任意 | |
remarks |
備考 | 任意 |
商品名（英文）や追加管理項目は CSV 取込の対象外です。取込後に商品編集画面から入力してください。
4. 顧客マスタ（フル・39列）
| 列名 | 項目 | 必須 | 記入内容 / 既定値 |
|---|---|---|---|
code |
顧客コード | 必須 | 50文字以内。登録キー |
name |
顧客名 | 必須 | 200文字以内 |
name_kana |
顧客略称 | 任意 | 200文字以内 |
customer_category_code |
顧客区分 | 必須 | 顧客区分マスタの code。先に区分を登録 |
customer_category2_code〜customer_category4_code |
顧客区分2〜4 | 任意 | 同じ顧客区分マスタの code。空欄可 |
is_individual |
個人顧客 | 任意 | 1/0。既定値 0 |
corporate_number |
法人番号 | 任意 | 20文字以内 |
postal_code / address / address2 |
郵便番号・住所 | 任意 | |
tel / tel2 / fax |
電話・FAX | 任意 | |
email / url / contact_person |
メール・URL・担当者 | 任意 | |
billing_type |
請求区分 | 推奨記入 | closing掛け（締め） / spot掛け（都度） / cash現金。既定値 closing |
closing_group_name |
締め日グループ | 任意 | 名称で記入（例: 月末締め・20日締め）。下記「自動作成」参照 |
closing_day |
締め日 | 推奨記入 | 1〜31 の整数。既定値 31 |
payment_terms_name |
入金条件 | 任意 | 名称で記入（例: 翌月末払い・翌々月10日払い）。下記「自動作成」参照 |
payment_method |
入金方法 | 推奨記入 | transfer銀行振込 / cash現金 / check小切手 / bill手形 / offset相殺 / otherその他。既定値 transfer |
bank_name |
振込先銀行 | 任意 | |
invoice_send_method |
請求書送信手段 | 任意 | mail郵送 / emailメール / faxFAX / otherその他。空欄可 |
billing_target |
請求先設定 | 推奨記入 | self自分に請求 / parent親顧客に請求。既定値 self |
parent_customer_code |
親顧客（請求先） | 任意 | 顧客マスタの code。親となる顧客を先に登録（同一ファイル内なら親の行を上に） |
is_billing_parent |
請求親として利用する | 任意 | 1/0。既定値 0 |
tax_calc_method |
消費税計算方法 | 推奨記入 | invoice伝票計 / monthly月計 / line明細行計。既定値 invoice |
rounding_method |
端数処理 | 推奨記入 | round四捨五入 / floor切り捨て / ceil切り上げ。既定値 round |
ar_opening_balance |
売掛金開始残高 | 推奨記入 | 数値（例 0.00） |
credit_limit |
与信限度額 | 推奨記入 | 数値 |
price_rank |
販売単価ランク | 推奨記入 | 1〜5（商品の販売単価1〜5に対応）。既定値 2 |
sales_ratio |
販売掛率（%） | 推奨記入 | 数値（例 100.00） |
price_ratio_category_code |
掛率区分 | 任意 | 掛率区分マスタの code。空欄は未設定 |
fiscal_year_end_month |
決算月 | 任意 | 1〜12。空欄可 |
sort_order |
表示順 | 任意 | 整数 |
is_active |
有効 | 推奨記入 | 1/0。既定値 1 |
remarks |
備考 | 任意 |
⚠️ フル版顧客テンプレートの空セル上書きに注意
フル版（上記の全列）を使う場合、ヘッダに列がありセルが空だと、その項目の既存値が空で上書きされます。
「掛率区分だけ変えたい」「住所だけ直したい」といった部分更新にフル版を使い、他列を空のまま残すと、名称・住所・請求設定などが消える事故になります。
- 掛率区分だけを一括更新したい → 次節の 2列テンプレート（
code+price_ratio_category_code）を使ってください - フル版で更新する場合は、先に顧客一覧の「CSV出力」で現状を書き出し、必要な列だけ編集して取り込む運用を推奨します
掛率区分だけを一括更新する（2列テンプレート）
テンプレート: 取込テンプレート_顧客_掛率区分割当のみ.csv
| 列名 | 項目 | 必須 | 記入内容 |
|---|---|---|---|
code |
顧客コード | 必須 | 既存顧客の code（登録キー） |
price_ratio_category_code |
掛率区分 | 任意 | 掛率区分マスタの code。空欄は未設定 |
取込画面は顧客一覧の「インポート」です（専用画面はありません）。CSV に この2列だけ を含めることで、他の顧客項目には触れません。
締め日グループ・入金条件の自動作成
closing_group_name（締め日グループ）と payment_terms_name（入金条件）は名称で指定します。未登録の名称を書いた場合、名称から内容を読み取れるときは自動で新規作成されます。
- 締め日グループ: 「月末締め」「20日締め」のように、月末または日付が読み取れる名称にしてください
- 入金条件: 「翌月末払い」「翌々月10日払い」のように、入金月（当月/翌月/翌々月/締め後）と入金日が読み取れる名称にしてください
- 読み取れない名称（例: 「特別条件A」）はエラーになります。その場合は先に各マスタを画面から登録してください
- 名称は完全一致で照合されます。「月末締め」と「月末締 」（末尾スペース）は別物になるためご注意ください
5. 顧客別単価（4列）
テンプレート: 取込テンプレート_顧客別単価.csv
| 列名 | 項目 | 必須 | 記入内容 |
|---|---|---|---|
customer_code |
顧客コード | 必須 | 顧客マスタの code。先に顧客を登録 |
product_code |
商品コード | 必須 | 商品マスタの code。先に商品を登録 |
unit_price |
販売単価 | 必須 | 数値。基準単位あたりの単価（単位列はありません） |
remarks |
備考 | 任意 |
補足
- 登録キーは 顧客コード×商品コード です。未登録の組み合わせは新規、既存は上書き更新、内容が同じ行はスキップされます
- 取込画面はマスタ管理 → 顧客別単価 一覧の「インポート」です（「CSV出力」「Excel出力」も同画面にあります）
- 記入例の備考にも「単価は基準単位あたり」と記載しています。複数単位を使う商品でも、ここには基準単位あたりの単価を入れてください
よくあるエラーと対処
| エラーメッセージ（例） | 原因 | 対処 |
|---|---|---|
null value in column "category_id" ... violates not-null constraint |
商品の category_code（商品区分）が空欄 |
商品区分は必須です。区分コードを記入してください |
〇行目: 商品区分1コード「XXX」が登録されていません。商品区分1マスタを先に登録してください。 |
参照先の区分・仕入先が未登録 | 推奨取込順序のとおり、参照される側のマスタを先に取り込んでください。コードの打ち間違い（大文字小文字・全角半角）もこのエラーになります |
締め日グループ名「…」から締日（1〜31）を判定できませんでした。 |
自動作成できない名称 | 「月末締め」「20日締め」形式に直すか、先に締め日グループを画面から登録してください |
支払条件名「…」から入金月・入金日を判定できませんでした。 |
自動作成できない名称 | 「翌月末払い」「翌々月10日払い」形式に直すか、先に入金条件を画面から登録してください |
販売単価（unit_price）は必須です。 |
顧客別単価の単価が空 | unit_price に数値を記入してください |
顧客コード「XXX」が登録されていません。 / 商品コード「XXX」が登録されていません。 |
顧客別単価の参照先未登録 | 顧客・商品を先に登録し、コードを合わせてください |
| 取り込んだのに件数が増えない（スキップ表示） | 既存データと完全に同じ内容 | 正常な動作です（変更がない行はスキップされます） |
| 新規のつもりが既存データが書き換わった | 既存と同じ code（または顧客×商品）を使用 |
登録キーです。取込前にエクスポートでバックアップを取ることをおすすめします |
| 文字化けする | 文字コードが UTF-8 以外 | Excel で編集した場合は「CSV UTF-8（コンマ区切り）」形式で保存してください |
取込前のチェックリスト
- [ ] 推奨取込順序のとおりか（区分 → 仕入先 → 商品 → 顧客 → 顧客別単価）
- [ ] 必須列（コード・名称・各区分コード）がすべて埋まっているか
- [ ] 数値・選択値の列に空欄がないか（不要なら列ごと削除）
- [ ] 区分コード・仕入先コードの打ち間違いがないか
- [ ] 既存データと重複する
codeがないか（更新が目的の場合を除く） - [ ] 顧客フル版で「一部だけ更新」していないか（掛率区分のみなら2列テンプレートを使う）
- [ ] 大量取込の前に、まず数行だけで試したか