カタログエクスポートCSV フォーマット仕様

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

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"=契約開始日の前日、"CUSTOM_DAY{n}"=任意の締め日（n=1〜30） 最初の行のみ出力
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から連番）

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

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

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

列 カラム名 データ型/形式 説明 備考
Y 請求周期 数値 請求周期（月数）
Z 請求タイミング - 月数 数値 請求タイミングの月数オフセット
AA 請求タイミング - 日付 数値 請求日
AB 一括請求オプション "0"/"1" 0=分割、1=一括
AC 支払期限タイミング - 月数 数値 支払期限の月数オフセット 空の場合あり
AD 支払期限タイミング - 日付 数値 支払期限日 空の場合あり
AE 端数処理桁数 数値 丸め処理の桁数
AF 端数処理方法 文字列 "ROUND_UP"=切り上げ、"ROUND_DOWN"=切り捨て、"ROUND_OFF"=四捨五入
AG 売上計上タイミング - タイプ 文字列 "SAME_DATE"=計上日が利用日と同じ、"TIMING"=指定期間後の指定日に計上 空の場合あり
AH 売上計上タイミング - 基準日 文字列 "START"=利用開始日、"END"=利用終了日 空の場合あり、TIMINGタイプ選択時のみ有効
AI 売上計上タイミング - オフセット日数 数値 売上計上日のオフセット日数 空の場合あり、デフォルト=0

5. 日割設定（列AJ-AM）

列 カラム名 データ型/形式 説明 備考
AJ 開始月日割設定タイプ 文字列 "FULL_PRICE"=満額、"AVAILABILITY_BASE"=利用日数分、"FIXED_RATE"=固定割合
AK 開始月日割設定値 数値 日割計算の値 空の場合あり
AL 終了月日割設定タイプ 文字列 "FULL_PRICE"=満額、"AVAILABILITY_BASE"=利用日数分、"FIXED_RATE"=固定割合
AM 終了月日割設定値 数値 日割計算の値 空の場合あり