Excelファイルフォーマット

概要

• このドキュメントは、各Excelシートの入力カラムを説明します。
• カラム: Excelのヘッダー名。
• 型: 期待される値の型。
• 値: 列挙型の場合にとりうる値の一覧。- はスカラー型を示します。
• 必須: 必須 は必須カラム、任意 は省略可能なカラムを示します。
• デフォルト: デフォルト値が定義されている場合に適用されます。- はデフォルトなしを示します。
• 説明: カラムの意味と使い方。
• id や versionId などのシステム管理フィールドは入力カラムではありません。
• サンプルExcelファイルをダウンロードできます。

カラム仕様

1. Periods（計画期間）

カラム	型	値	必須	デフォルト	説明
name	String	-	必須	-	計画期間の識別名（例: 2026Q1）
start	DateTime	-	必須	-	期間の開始日時
end	DateTime	-	必須	-	期間の終了日時

入力制約: start ≤ end である必要があります。

2. Products（製品）

カラム	型	値	必須	デフォルト	説明
name	String	-	必須	-	製品名（製品を一意に識別）。通常製品・グループ代表製品の両方を定義する
type	ProductType	Individual Group	必須	-	製品タイプ。Product Groups のグループ代表製品は Group、それ以外は Individual を指定する

3. Locations（ロケーション）

カラム	型	値	必須	デフォルト	説明
name	String	-	必須	-	ロケーション名（他シート参照キー）
type	LocationType	Customer Facility Supplier	必須	-	ロケーションタイプ。対応するシート（Customers / Facilities / Suppliers）と整合している必要がある
address	String	-	任意	-	住所（ジオコーディング用途）
city	String	-	任意	-	市区町村
region	String	-	任意	-	州・都道府県
country	String	-	任意	-	国名
latitude	Float	-	任意	-	緯度
longitude	Float	-	任意	-	経度
zipCode	String	-	任意	-	郵便番号

入力制約（OR条件）: latitude と longitude の両方、または address / city / country / zipCode のいずれか1つ以上を指定する必要があります。住所が指定された場合はジオコーディングで座標を取得します。いずれも省略するとバリデーションエラーになります。region のみでは住所条件を満たしません。

4. Customers（顧客）

カラム	型	値	必須	デフォルト	説明
name	String	-	必須	-	顧客名（Locations.name と対応）
include	CustomerInclude	Include Exclude	必須	-	最適化で顧客需要を含める方針

5. Facilities（施設）

カラム	型	値	必須	デフォルト	説明
name	String	-	必須	-	施設名（Locations.name と対応）
type	FacilityType	DC Port Mfg	必須	-	施設タイプ
open	Open	Open Closed	必須	-	初期状態（開設/閉鎖）
include	Include	Consider Include Exclude	必須	-	最適化で施設を含める方針
fixedCO2Emissions	Float	-	任意	0	施設に紐づく固定CO2排出量
fixedStartingCost	Float	-	任意	0	開設時の固定費
fixedOperatingCost	Float	-	任意	0	操業中の固定費
fixedClosingCost	Float	-	任意	0	閉鎖時の固定費
currency	Currency	JPY USD	任意	USD	固定費の通貨

6. BoMs（部品表）

カラム	型	値	必須	デフォルト	説明
productName	String	-	必須	-	製造される製品名（Products.name）
partProductName	String	-	必須	-	使用される部品製品名（Products.name）
unit	ProductUnit	pcs m3	必須	-	出力製品（productName）の数量単位。「unit単位のproductNameを製造するのにpartProductNameがquantity quantityUnit必要」と解釈される
quantity	Float	-	必須	-	unit単位の製品を製造するのに必要な部品（partProductName）の量
quantityUnit	ProductUnit	pcs m3	必須	-	部品数量（quantity）の単位

7. BoM Assignments（部品表割り当て）

カラム	型	値	必須	デフォルト	説明
productName	String	-	必須	-	製造される製品名（Products.name）
partProductName	String	-	必須	-	使用される部品製品名（Products.name）。BoMs シートに対応する組み合わせが存在する必要がある
facilityName	String	-	必須	-	当該BoMを適用する施設名（Facilities.name）

8. Suppliers（サプライヤ）

カラム	型	値	必須	デフォルト	説明
name	String	-	必須	-	サプライヤ名（Locations.name と対応）
include	Include	Consider Include Exclude	必須	-	最適化でサプライヤを含める方針

9. Product Groups（製品グループ）

カラム	型	値	必須	デフォルト	説明
groupProductName	String	-	必須	-	グループを代表する製品名（Products.name）
memberProductName	String	-	必須	-	グループに属する製品名（Products.name）

10. Product Individuals（製品個別属性）

カラム	型	値	必須	デフォルト	説明
productName	String	-	必須	-	属性を定義する製品名（Products.name）
unit	ProductBaseUnit	pcs	必須	-	製品数量の基準単位
sellingPrice	Float	-	必須	-	製品の販売単価
value	Float	-	任意	-	製品の評価額・価値
currency	Currency	JPY USD	必須	-	金額項目に使う通貨
include	IncludeExclude	Include Exclude	必須	-	最適化で製品を含める方針
volume	Float	-	必須	-	製品1単位あたり体積（0より大きい値）
volumeUnit	VolumeUnit	m3	必須	-	体積の単位
weight	Float	-	必須	-	製品1単位あたり重量（0より大きい値）
weightUnit	WeightUnit	kg	任意	kg	重量の単位

11. Demands（需要）

カラム	型	値	必須	デフォルト	説明
customerName	String	-	必須	-	需要を持つ顧客名（Customers.name）
productName	String	-	必須	-	需要対象の製品名（Products.name）
quantity	Float	-	必須	-	需要数量
quantityUnit	ProductBaseUnit	pcs	必須	-	需要数量の単位
periodName	String	-	必須	-	需要が発生する期間名（Periods.name）

12. Paths（パス）

カラム	型	値	必須	デフォルト	説明
fromName	String	-	必須	-	出発ロケーション名（Locations.name）
toName	String	-	必須	-	到着ロケーション名（Locations.name）
distance	Float	-	任意	-	拠点間距離
distanceUnit	DistanceUnit	km mile	任意	-	距離の単位

13. Sourcing Policies（調達ポリシー）

カラム	型	値	必須	デフォルト	説明
productName	String	-	必須	-	対象製品名（グループを指定する場合はグループ代表製品名）
fromName	String	-	必須	-	調達元ロケーション名
toName	String	-	必須	-	調達先ロケーション名
fixedSourcingCost	Float	-	任意	0	固定調達コスト
variableSourcingCost	Float	-	任意	0	変動調達コスト（単位あたり）
variableSourcingCostProductUnit	ProductUnit	pcs m3	任意	pcs	変動調達コストの数量単位
currency	Currency	JPY USD	任意	USD	調達コストの通貨
periodName	String	-	必須	-	適用期間名

入力制約: (fromName, toName) の組み合わせが Paths シートに登録されている必要があります。

14. Transportation Constraints（輸送制約）

カラム	型	値	必須	デフォルト	説明
fromName	String	-	必須	-	出発ロケーション名
toName	String	-	必須	-	到着ロケーション名
productName	String	-	必須	-	制約対象の製品名（グループを指定する場合はグループ代表製品名）
periodName	String	-	必須	-	適用期間名
modeName	String	-	必須	-	輸送モード名（Transportation Modes）
minThroughput	Float	-	任意	-	最小輸送量
maxThroughput	Float	-	任意	-	最大輸送量
throughputUnit	ProductUnit	pcs m3	条件付き必須	-	輸送量の単位。minThroughput または maxThroughput を指定した場合は必須

入力制約:

• (fromName, toName) の組み合わせが Paths シートに登録されている必要があります。
• minThroughput と maxThroughput の両方を指定した場合、maxThroughput ≥ minThroughput である必要があります。

15. Supplier Constraints（サプライヤ制約）

カラム	型	値	必須	デフォルト	説明
supplierName	String	-	必須	-	サプライヤ名（Suppliers.name）
productName	String	-	必須	-	供給対象製品名（Products.name）
supplyCapacity	Int	-	任意	-	供給上限量
supplyCapacityUnit	ProductUnit	pcs m3	任意	-	供給上限の単位
periodName	String	-	必須	-	適用期間名

16. Facility Processing Times（施設処理時間）

カラム	型	値	必須	デフォルト	説明
facilityName	String	-	必須	-	施設名（Facilities.name）
productName	String	-	任意	-	処理対象製品名
unit	ProductUnit	pcs m3	必須	-	処理量の単位
time	Int	-	必須	-	処理に要する時間値
timeUnit	FacilityProcessingTimeUnit	Hour Day Week	必須	-	処理時間の単位

17. Facility Constraints（施設制約）

カラム	型	値	必須	デフォルト	説明
facilityName	String	-	必須	-	施設名（Facilities.name）
productName	String	-	必須	-	制約対象の製品名（グループを指定する場合はグループ代表製品名）
productNameGroupBehavior	ProductNameGroupBehavior	Aggregate Enumerate	任意	-	対象製品がグループ代表製品の場合の扱い（Aggregate=合算, Enumerate=個別）
initialStorage	Float	-	任意	-	期初在庫量
storageCapacity	Float	-	任意	-	保管容量上限
storageUnit	ProductUnit	pcs m3	任意	-	在庫・保管量の単位
minThroughput	Float	-	任意	-	最小処理量
maxThroughput	Float	-	任意	-	最大処理量
throughputUnit	ProductUnit	pcs m3	条件付き必須	-	処理量の単位。minThroughput または maxThroughput を指定した場合は必須
periodName	String	-	必須	-	適用期間名

入力制約:

• initialStorage と storageCapacity の両方を指定した場合、initialStorage ≤ storageCapacity である必要があります。
• minThroughput と maxThroughput の両方を指定した場合、maxThroughput ≥ minThroughput である必要があります。

18. Facility Policies（施設ポリシー）

カラム	型	値	必須	デフォルト	説明
facilityName	String	-	必須	-	施設名（Facilities.name）
productName	String	-	必須	-	対象製品名（Products.name）
periodName	String	-	必須	-	適用期間名
currency	Currency	JPY USD	必須	-	費用の通貨
variableOperatingCost	Float	-	必須	-	操業の変動費（単位あたり）
variableOperatingCostProductUnit	ProductUnit	pcs m3	必須	-	変動費の数量単位

19. Transportation Modes（輸送モード）

カラム	型	値	必須	デフォルト	説明
name	String	-	必須	-	輸送モード名（例: Truck, Vessel）
speed	Float	-	必須	-	輸送速度
speedUnit	SpeedUnit	kph mph	必須	-	速度の単位

20. Transportation Policies（輸送ポリシー）

カラム	型	値	必須	デフォルト	説明
fromName	String	-	必須	-	出発ロケーション名
toName	String	-	必須	-	到着ロケーション名
periodName	String	-	必須	-	適用期間名
productName	String	-	必須	-	対象製品名（グループを指定する場合はグループ代表製品名）
modeName	String	-	必須	-	輸送モード名（Transportation Modes.name）
cost	Float	-	必須	-	輸送コスト値
dutyRate	Float	-	任意	-	関税率（例: 0.1 = 10%）
currency	Currency	JPY USD	必須	-	コストの通貨
costRule	CostRule	UnitCost FixedCostTreatAsFull	必須	-	コスト計算ルール
unit	ProductUnit	pcs m3	条件付き必須	-	数量単位。costRule=UnitCost の場合は必須
averageShipmentSize	Float	-	条件付き必須	-	1回あたり平均出荷量。costRule=FixedCostTreatAsFull の場合は必須
averageShipmentSizeUnit	ProductUnit	pcs m3	条件付き必須	-	平均出荷量の単位。costRule=FixedCostTreatAsFull の場合は必須
deliveryFrequency	Int	-	任意	-	期間内の配送回数（costRule=FixedCostTreatAsFull 時のみ有効）
inventoryCarryingCostPercentage	Float	-	任意	0.2	在庫保有コスト率

入力制約: (fromName, toName) の組み合わせが Paths シートに登録されている必要があります。

21. Inventory Policies（在庫ポリシー）

カラム	型	値	必須	デフォルト	説明
facilityName	String	-	必須	-	施設名（Facilities.name）
productName	String	-	必須	-	対象製品名（グループを指定する場合はグループ代表製品名）
carryingCostPercentage	Float	-	任意	0.12	在庫保有コスト率
inventoryTurns	Float	-	任意	1	在庫回転数

注意事項

• DateTime フィールド（start, end）はパース可能な日時フォーマット（例: ISO 8601）で指定してください。
• Product Groups は内部モデル ProductGroupMembership に、Product Individuals は内部モデル ProductIndividual に対応します。
• Product Individuals には、Product Groups.groupProductName（グループ代表製品）を含めないでください。
• Products では type と Product Groups の内容が整合している必要があります（Group は代表製品、Individual は非代表製品）。
• Locations では type と Customers / Facilities / Suppliers の対応が整合している必要があります。
• Products に定義した製品のうち、グループ代表製品以外は Product Individuals で属性定義が必要です。
• インポーター・バリデーターのランタイム検証によって、追加のルールが課される場合があります。