<aside> 📋

目次

</aside>

⚠️ カタログアイテムCSVのフォーマットは現在β版です。今後、変更される可能性があるため、ご注意ください。

<aside> 💡

このページについて

カタログアイテムのCSVエクスポート・インポートのフォーマット仕様を説明します。 エクスポートCSVはそのままインポートの雛形としてご利用いただけますが、インポート時に必須・任意となるカラムが異なります。

</aside>

CSVの構造

正規化形式：1つのカタログアイテムが複数行に展開されます（3階層展開）

カラム定義

「インポート必須」列の凡例：◯ = 必須、◯（条件付き） = 条件付き必須、空欄 = 任意

1. カタログアイテム基本情報（列A–P）

列 カラム名 データ型/形式 説明 備考 インポート必須
A アイテムID 文字列 CatalogItemId 最初の行のみ出力
B アイテム管理ID 文字列 オプショナルID 最初の行のみ出力、空の場合あり
C プロダクトID 文字列 ProductId 最初の行のみ出力 ◯
D プロダクト名 文字列 ProductName 最初の行のみ出力
E アイテム名 文字列 カタログアイテム名 最初の行のみ出力 ◯
F アイテム概要 文字列 説明文 最初の行のみ出力、空の場合あり
G 契約での取り扱い 文字列 PLAN_OR_ADD_ON=メインまたはオプション
ONLY_PLAN=メインのみ
ONLY_ADD_ON=オプションのみ 最初の行のみ出力
H 利用締日 文字列 END_OF_MONTH=月末
ONE_DAY_BEFORE=契約開始日の前日 最初の行のみ出力 ◯
I 利用周期 数値 利用周期（月数） 最初の行のみ出力
J 更新時に延長される期間 数値 契約期間（月数） 最初の行のみ出力
K 税率 数値 VAT税率 最初の行のみ出力
L 自動更新 - フラグ "0"/"1" 0=無効
1=有効 最初の行のみ出力
M 自動更新タイミング - 値 数値 自動更新の値 最初の行のみ出力、無効時は空
N 自動更新タイミング - 単位 文字列 MONTHLY=月単位
DAILY=日単位 最初の行のみ出力、無効時は空
O ステータス 文字列 販売中=空、販売停止=DISCONTINUED 最初の行のみ出力
P アイテム行キー 数値 行番号（1から連番） 全行に出力

2. 課金項目基本情報（列Q–V）

列 カラム名 データ型/形式 説明 備考 インポート必須
Q 課金項目ID 文字列 ChargeItemId
R 請求書記載名 文字列 請求書に表示される名前 ◯
S SB見積記載名 文字列 見積書に表示される名前 空の場合あり
T 課金タイプ 文字列 RECURRING=継続課金
ONE_TIME=一回課金
DISCOUNT=割引 ◯
U 課金項目表示順 数値 ソート順
V 課金項目行キー 数値 課金項目ごとの行番号（1から連番） 課金項目が1つだけの場合も1を入力 ◯

3. 料金モデル（列W–X）

列 カラム名 データ型/形式 説明 備考 インポート必須
W 料金計算モデル 文字列 FLAT_FEE=定額料金
PER_UNIT=従量制
TIERED=積上式従量制
VOLUME=選択式従量制 ◯
X 単価 数値 単価（金額） TIEREDまたはVOLUMEの場合は空 ◯（定額料金・従量制の場合）

4. 請求設定（列Y–AI）