Square連携・売上
決済日時・商品名・金額を Square API から自動取得し、担当タレントとイベントに自動で紐付けます。紐付けできなかった分だけ、人が確認します。
取込パイプライン
毎朝 04:00 に自動実行（手動でも実行できます）
接続先：KOSEI LIVE SPACE（Square アカウント／デモ接続）
使用API：Payments・Orders・Catalog
前回取込：本日 04:00
今月の取込状況
自動振り分けルール
上から順に判定Square の項目 → このシステムの項目
| Square API | 取得する情報 | 使い道 |
|---|---|---|
| payment.created_at | 決済日時（UTC→JSTに変換） | 月別集計・イベント紐付け |
| order.line_items[].name | 商品名・数量 | 担当タレントの判定 |
| amount_money.amount | 金額（円） | 売上・歩合計算 |
| processing_fee | 決済手数料 | 経費・歩合基準（選択制） |
| refunded_money | 返金（マイナス計上） | 売上・報酬から自動控除 |
| catalog / location_id | 商品カテゴリ・会場 | イベント・案件の判定 |
Square には「担当タレント」という欄がありません。そのため商品名の付け方（例：「星野ミオ チェキ」）や商品カテゴリで判定します。運用ルールは導入時にご相談して決めます。