店舗POS注文データ連携ガイド

注文単位: order_id は同一注文内であれば複数行で重複しても問題ありません。
商品単位: order_id + product_id + sku_code の組み合わせは、ファイル内で一意（ユニーク）である必要があります。
- この組み合わせが重複している場合、インポートエラーとなります。

3. CSV カラム一覧

ヘッダーの順序は固定です。入れ替えずに作成してください。

Plaintext

order_id,channel,shop_code,order_discount_amount,ordered_at,user_id,user_email,product_id,sku_code,sales_price,sales_quantity,shipped_at,cancelled_at,cancelled_quantity

4. 項目仕様（必須 / オプション / 制約）

以下では、項目ごとの 必須性・許容値・制約・自動補正ロジック を記載します。

必須項目

項目名	型	必須	制約	サンプル	仕様
order_id	string	必須	同一注文内では重複可／商品単位ではユニークキー	ORDER001	空欄不可
channel	string	必須	店舗POSデータ連携では pos を指定	pos	空欄・その他の値はエラー
ordered_at	datetime	必須	YYYY-MM-DD HH:MM:SS	2024-02-01 10:00:00	空欄不可
product_id	string	必須	制約なし	PROD001	空欄不可
sales_price	int	必須	整数、0以上	2000	空欄不可
sales_quantity	int	必須	整数、0以上	2	空欄不可

オプション項目

項目名	型	必須	制約・挙動	サンプル
shop_code	string	任意	空欄可。未登録の shop_code を指定した場合 → エラーではなく shop_id=null として処理	SHOP001
order_discount_amount	int	任意	空欄の場合 → 0 として扱う	100
user_id	string	任意	制約なし	USER001
user_email	string	任意	user_id が空の場合、user_email を指定するとエラー	user1@example.com
sku_code	string	任意	空欄可	SKU001
shipped_at	datetime	任意	空欄可	2024-02-02 12:00:00
cancelled_at	datetime	任意	空欄可	2024-02-05 09:30:00
cancelled_quantity	int	任意	自動補正：・空欄 → 0 と扱う・負の値 → 0 に補正・sales_quantity より大きい場合 →sales_quantity に補正	1

5. 特殊な挙動（自動処理仕様）

shop_code の扱い

shop_code	挙動
空欄	shop_id=null として登録
未登録のコード	エラーとせず、shop_id=null
登録済みコード	対応する shop_id を紐付け

cancelled_quantity の自動補正

入力値	実際に登録される値
空欄	0
負の値	0
sales_quantity より大きい	sales_quantity
数値変換不可	0

6. CSVサンプル

Plaintext

order_id,channel,shop_code,order_discount_amount,ordered_at,user_id,user_email,product_id,sku_code,sales_price,sales_quantity,shipped_at,cancelled_at,cancelled_quantity
ORDER001,pos,SHOP001,100,2024-01-01 10:00:00,USER001,user1@example.com,PROD001,SKU001,1000,2,2024-01-02 15:00:00,,0
ORDER001,pos,SHOP001,100,2024-01-01 10:00:00,USER001,user1@example.com,PROD002,SKU002,2000,1,2024-01-02 15:00:00,,0
ORDER002,web,,0,2024-02-01 12:00:00,,,PROD003,SKU003,3000,3,,,0

補足：既に取り込み済みの注文を処理した場合

既に取り込み済みの注文データを再度アップロードした場合、以下の情報のみ更新が可能です。

更新可能な項目

ユーザー情報：user_id / user_email（メールアドレスの更新）
発送日情報：shipped_at（商品ごとの発送日）
キャンセル情報：cancelled_at / cancelled_quantity（商品ごとのキャンセル情報）

注意事項

商品情報（product_id、sales_priceなど）や注文日時（ordered_at）は更新できません
複数回アップロードしても、同じ情報の場合は重複して更新されません
キャンセル情報は、cancelled_atまたはcancelled_quantityのいずれかが指定されている場合のみ更新されます