airpay-agent

name: "airpay-agent" description: "Airレジ/Airペイ管理エージェント — リクルートのPOSレジ・キャッシュレス決済プラットフォームをClaude Codeから完全操作。売上管理、決済処理、在庫管理、顧客分析、スタッフシフト管理をターミナルからリアルタイムに実行する店舗運営特化スキル。" version: "1.0.0" author: "hanabi-jpn" tags: - airpay - airregi - pos - payment - japan - retail - cashless - inventory - recruit - store-management

┌──────────────────────────────────────────────────────────┐
│   ╔═╗╦╦═╗╔═╗╔═╗╦ ╦                                     │
│   ╠═╣║╠╦╝╠═╝╠═╣╚╦╝  Agent                              │
│   ╩ ╩╩╩╚═╩  ╩ ╩ ╩                                      │
│                                                          │
│   ┌─────┐  ┌─────┐  ┌─────┐  ┌─────┐  ┌─────┐         │
│   │ POS │──│ PAY │──│ INV │──│ CRM │──│STAFF│         │
│   │売上 │  │決済 │  │在庫 │  │顧客 │  │管理 │         │
│   └──┬──┘  └──┬──┘  └──┬──┘  └──┬──┘  └──┬──┘         │
│      └────────┴────────┴────────┴────────┘              │
│         リクルート Airレジ / Airペイ API                  │
│       Claude Code × 店舗運営オペレーション                │
└──────────────────────────────────────────────────────────┘

claude-code airpay pos payment japan

Airレジ/Airペイ管理エージェント — リクルートが提供するPOSレジ「Airレジ」とキャッシュレス決済「Airペイ」をClaude Codeから統合管理。売上分析、決済状況、在庫管理、顧客データ、スタッフシフトまで、店舗運営のすべてをコマンドラインから操作する実店舗DXスキル。

Overview

Airpay Agentは、リクルートが提供する店舗向けサービス「Airレジ」（POSレジ）と「Airペイ」（キャッシュレス決済）のAPIをClaude Codeから直接操作するためのスキルです。飲食店、小売店、サービス業など、実店舗を運営する事業者がターミナルから売上確認、在庫管理、顧客分析、スタッフ管理を一元的に行えます。Airペイは業界最安水準の決済手数料（3.24%〜）で、クレジットカード、電子マネー、QRコード決済に対応しており、本スキルでこれらの決済状況をリアルタイムに監視・分析できます。

アーキテクチャ概要

┌───────────────────────────────────────────────────────────────────┐
│                      Claude Code Terminal                         │
│  ┌──────────────────────────────────────────────────────────────┐ │
│  │  airpay sales / payment / inventory / customer / report     │ │
│  └──────────────────────────┬───────────────────────────────────┘ │
│                             │                                     │
│  ┌──────────────────────────▼───────────────────────────────────┐ │
│  │                  Airpay Agent Core                           │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐       │ │
│  │  │Sales     │ │Payment   │ │Inventory │ │Analytics │       │ │
│  │  │Manager   │ │Processor │ │Controller│ │Engine    │       │ │
│  │  │(売上管理)│ │(決済処理)│ │(在庫管理)│ │(分析)    │       │ │
│  │  └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘       │ │
│  │       │            │            │            │              │ │
│  │  ┌────┴─────┐ ┌────┴─────┐ ┌────┴─────┐                    │ │
│  │  │Customer  │ │Staff     │ │Menu      │                    │ │
│  │  │Manager   │ │Scheduler │ │Editor    │                    │ │
│  │  │(顧客管理)│ │(シフト)  │ │(商品管理)│                    │ │
│  │  └────┬─────┘ └────┬─────┘ └────┬─────┘                    │ │
│  │       └────────────┴────────────┘                           │ │
│  └──────────────────────────┬───────────────────────────────────┘ │
│                             │ HTTPS / REST API                    │
│  ┌──────────────────────────▼───────────────────────────────────┐ │
│  │          Airレジ API / Airペイ API                           │ │
│  │  sales / transactions / products / customers / staff        │ │
│  └──────────────────────────┬───────────────────────────────────┘ │
│                             │ リクルートID連携                     │
│  ┌──────────────────────────▼───────────────────────────────────┐ │
│  │    Airペイ決済端末 ← → 各カードブランド / QRコード決済        │ │
│  │    VISA / Mastercard / JCB / AMEX / Suica / PayPay 他       │ │
│  └──────────────────────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────┘

処理フロー

商品登録 ──→ 注文受付 ──→ 決済処理 ──→ レシート発行 ──→ 売上計上
   │            │            │             │              │
   ▼            ▼            ▼             ▼              ▼
 在庫連動    テーブル     Airペイ端末    電子レシート    日次集計
 価格設定    管理(飲食)   カード/QR     印刷/メール    月次レポート

System Prompt（行動指針）

Airpay Agentとして動作する際、以下のガイドラインに厳密に従うこと。

すべての金額は日本円（JPY）で処理する。 消費税は内税・外税の設定に従い、端数は店舗設定（切り捨て/切り上げ/四捨五入）に準拠する。
軽減税率8%と標準税率10%を商品カテゴリに基づいて自動判定する。 飲食料品（テイクアウト含む）は8%、イートインは10%を適用する。
決済手段ごとの手数料率を正確に把握する。 クレジットカード3.24%、電子マネー3.24%、QRコード決済は各ブランドの料率に従う。入金サイクルも決済手段ごとに管理する。
在庫数がアラート閾値を下回った場合、自動通知を行う。 デフォルト閾値は在庫数5個とし、商品ごとにカスタム設定可能とする。
売上データはリアルタイムで集計し、日次・週次・月次のトレンドを追跡する。 前年同月比、前週比の自動算出を行う。
顧客データは個人情報保護法に準拠して管理する。 顧客の同意なく個人情報を第三者に提供しない。データの暗号化保存を必須とする。
スタッフのシフト管理は労働基準法に準拠する。 6時間超勤務で45分、8時間超勤務で60分の休憩を自動チェックする。
レジ締め処理は日次で実施し、現金過不足を記録する。 過不足が発生した場合はアラートを発行する。
決済端末との通信エラーが発生した場合、オフラインモードで取引を記録する。 ネットワーク復旧後に自動同期を行う。
商品マスタの変更は営業時間外に反映することを推奨する。 営業中の価格変更は確認プロンプトを表示する。
複数店舗の管理に対応する。 店舗間の売上比較、在庫移動、統合レポートを提供する。
インボイス制度に対応したレシート・領収書を発行する。 登録番号、税率ごとの区分、適格請求書の要件を満たす。
Airペイの入金スケジュールを自動追跡する。 みずほ銀行・三菱UFJ銀行・三井住友銀行は月6回、ゆうちょ銀行は月3回の入金サイクルに対応する。
売上分析には時間帯別、曜日別、天候との相関分析を含める。 ピークタイム予測によるシフト最適化を提案する。
不正決済の検知パターンを監視する。 同一カードの短時間連続利用、高額決済の急増など、異常パターンを検出してアラートする。
日次バックアップを自動実行する。 売上データ、商品マスタ、顧客データを暗号化してローカルに保存する。
レポート出力はCSV、Excel、PDF形式に対応する。 税理士向けの仕訳データ出力にも対応し、freee・弥生会計・マネーフォワードのインポート形式をサポートする。

Environment Variables

変数名	必須	説明	例
`AIRPAY_API_KEY`	Yes	Airレジ/AirペイAPIキー	`apr_k_7f8a9b0c1d2e3f4g5h6i`
`AIRPAY_STORE_ID`	Yes	店舗ID	`str_tokyo_shibuya_001`
`AIRPAY_TERMINAL_ID`	Yes	決済端末ID	`trm_ap2_00123456`
`AIRPAY_RECRUIT_ID`	No	リクルートIDアカウント	`recruit_biz_hanabi_001`
`AIRPAY_WEBHOOK_URL`	No	決済完了通知のWebhook先	`https://hooks.hanabi-tech.co.jp/airpay`
`AIRPAY_DEFAULT_TAX`	No	デフォルト税率（内税/外税）	`exclusive`
`AIRPAY_CURRENCY`	No	通貨コード	`JPY`
`AIRPAY_RECEIPT_LOGO`	No	レシートロゴのパス	`~/.airpay-agent/assets/logo.png`
`AIRPAY_ALERT_THRESHOLD`	No	在庫アラート閾値	`5`
`AIRPAY_BANK_CODE`	No	入金先銀行コード	`0001`
`AIRPAY_STORAGE_DIR`	No	ローカルデータ保存先	`~/.airpay-agent/data`
`AIRPAY_MULTI_STORE`	No	複数店舗モード有効化	`true`

Commands

1. `airpay sales` — 売上管理

日次・月次の売上データを照会・分析します。

airpay sales today --store str_tokyo_shibuya_001

出力例:

╔═══════════════════════════════════════════════════════════════╗
║  本日の売上サマリー（2026-03-01）                              ║
║  店舗: 渋谷本店                                               ║
╠═══════════════════════════════════════════════════════════════╣
║                                                               ║
║  売上総額:     ¥287,450                                       ║
║  取引件数:     48件                                           ║
║  客単価:       ¥5,988                                         ║
║  前日比:       +12.3%（¥255,800）                             ║
║  前年同日比:   +8.7%（¥264,350）                              ║
║                                                               ║
║  時間帯別売上:                                                ║
║  ┌─────┬──────────┬──────┬───────────────────────────┐        ║
║  │時間 │ 売上     │ 件数 │ グラフ                    │        ║
║  ├─────┼──────────┼──────┼───────────────────────────┤        ║
║  │10-11│   12,300│    3│ ██                         │        ║
║  │11-12│   35,600│    8│ ██████                     │        ║
║  │12-13│   68,900│   14│ ████████████               │        ║
║  │13-14│   42,100│    9│ ███████                    │        ║
║  │14-15│   18,500│    4│ ███                        │        ║
║  │15-16│   22,300│    5│ ████                       │        ║
║  │17-18│   45,200│    7│ ████████                   │        ║
║  │18-19│   42,550│    6│ ███████                    │        ║
║  ├─────┼──────────┼──────┼───────────────────────────┤        ║
║  │合計 │  287,450│   48│                            │        ║
║  └─────┴──────────┴──────┴───────────────────────────┘        ║
║                                                               ║
║  決済手段別:                                                  ║
║    現金:           ¥98,200（34.2%）                           ║
║    クレジットカード: ¥112,350（39.1%）                         ║
║    電子マネー:      ¥45,600（15.9%）                          ║
║    QRコード決済:    ¥31,300（10.9%）                           ║
╚═══════════════════════════════════════════════════════════════╝

2. `airpay payment` — 決済処理・照会

Airペイ経由の決済状況を確認します。

airpay payment list --date 2026-03-01 --status settled

出力例:

決済一覧（2026-03-01 / 確定済み）
┌──────┬────────┬────────────┬──────────┬───────────┬──────────┐
│ 時刻 │ 決済ID │ 決済手段   │ 金額     │ 手数料    │ 入金予定 │
├──────┼────────┼────────────┼──────────┼───────────┼──────────┤
│10:23 │ PY-001 │ VISA       │   8,800 │     285 │ 03-05   │
│11:05 │ PY-002 │ Suica      │   1,200 │      38 │ 03-05   │
│11:42 │ PY-003 │ PayPay     │   3,500 │     115 │ 03-10   │
│12:15 │ PY-004 │ Mastercard │  12,600 │     408 │ 03-05   │
│12:33 │ PY-005 │ iD         │   2,800 │      90 │ 03-05   │
│13:01 │ PY-006 │ JCB        │   6,400 │     214 │ 03-10   │
│13:28 │ PY-007 │ LINE Pay   │   4,200 │     138 │ 03-10   │
│14:55 │ PY-008 │ AMEX       │  15,800 │     512 │ 03-15   │
├──────┼────────┼────────────┼──────────┼───────────┼──────────┤
│      │        │ 合計       │  55,300 │   1,800 │          │
└──────┴────────┴────────────┴──────────┴───────────┴──────────┘

手数料率平均: 3.26%
入金予定総額: ¥53,500

3. `airpay inventory` — 在庫管理

商品の在庫状況を確認・更新します。

airpay inventory status --category "ドリンク" --alert-only

出力例:

在庫アラート（カテゴリ: ドリンク）
┌──────┬────────────────┬──────┬──────┬────────┬──────────┐
│ SKU  │ 商品名         │ 在庫 │ 閾値 │ 状態   │ 発注推奨 │
├──────┼────────────────┼──────┼──────┼────────┼──────────┤
│ D-12 │ オレンジジュース│    3 │    5 │ 要発注 │   24本  │
│ D-18 │ ジンジャーエール│    2 │    5 │ 要発注 │   24本  │
│ D-25 │ トニックウォーター│  1 │    5 │ 緊急   │   48本  │
└──────┴────────────────┴──────┴──────┴────────┴──────────┘

発注推奨量は過去30日間の平均販売数 x 7日分で算出
最終在庫更新: 2026-03-01 09:00

4. `airpay customer` — 顧客管理

顧客データの照会・分析を行います。

airpay customer top --period 2026-02 --limit 5

出力例:

優良顧客ランキング（2026年2月）
┌────┬──────────┬────────┬──────┬────────────┬──────────┐
│順位│ 顧客名   │ 来店数 │ 購入額│ 客単価     │ 会員区分 │
├────┼──────────┼────────┼──────┼────────────┼──────────┤
│  1 │ 佐藤 M.  │     12│ 89,400│     7,450 │ ゴールド │
│  2 │ 田中 K.  │      8│ 72,300│     9,037 │ ゴールド │
│  3 │ 鈴木 Y.  │     15│ 61,500│     4,100 │ シルバー │
│  4 │ 高橋 A.  │      6│ 54,200│     9,033 │ シルバー │
│  5 │ 渡辺 T.  │      9│ 48,600│     5,400 │ レギュラー│
└────┴──────────┴────────┼──────┼────────────┼──────────┘
                         │合計  │ 平均       │
                         │326,000│ 7,004    │

リピート率: 68.3%（前月比 +2.1%）
新規顧客: 23名 / リピーター: 49名

5. `airpay report` — 売上レポート

詳細な売上レポートを生成します。

airpay report monthly --month 2026-02 --format detailed

出力例:

月次売上レポート（2026年2月）
═══════════════════════════════════════════════════════════

  売上総額:       ¥4,523,800
  営業日数:       28日
  日平均売上:     ¥161,564
  前月比:         +5.2%（¥4,298,600）
  前年同月比:     +18.9%（¥3,804,200）

  カテゴリ別売上:
    フード:       ¥2,890,400（63.9%）
    ドリンク:     ¥1,205,200（26.6%）
    物販:         ¥428,200（9.5%）

  曜日別平均売上:
    月: ¥128,300  火: ¥132,500  水: ¥141,200
    木: ¥148,600  金: ¥198,400  土: ¥215,800
    日: ¥165,700

  決済手数料合計: ¥98,420（売上比 2.18%）
  純売上:         ¥4,425,380

  入金実績:
    3月5日入金予定:  ¥1,820,300
    3月10日入金予定: ¥1,205,400
    3月15日入金予定: ¥680,200
    3月20日入金予定: ¥719,480

6. `airpay staff` — スタッフ管理

スタッフのシフト管理と売上実績を確認します。

airpay staff performance --period 2026-02

出力例:

スタッフ実績（2026年2月）
┌────────┬──────────┬──────┬──────────┬────────┬──────────┐
│ ID     │ 名前     │勤務日│ 担当売上 │ 時給   │ 評価     │
├────────┼──────────┼──────┼──────────┼────────┼──────────┤
│ STF-01 │ 山田花子 │   22│ 1,280,000│  1,200│ ★★★★★ │
│ STF-02 │ 佐藤太郎 │   20│ 1,050,000│  1,150│ ★★★★   │
│ STF-03 │ 鈴木美咲 │   18│   890,000│  1,100│ ★★★★   │
│ STF-04 │ 高橋翔   │   15│   620,000│  1,050│ ★★★     │
│ STF-05 │ 田中優   │   12│   480,000│  1,050│ ★★★     │
└────────┴──────────┴──────┴──────────┴────────┴──────────┘

総人件費: ¥1,245,600
人件費率: 27.5%（目標30%以下: 達成）

7. `airpay settlement` — 入金管理

Airペイからの入金スケジュールと実績を確認します。

airpay settlement upcoming --month 2026-03

出力例:

入金スケジュール（2026年3月）
┌──────────┬──────────────┬──────────┬───────────┬────────┐
│ 入金日   │ 対象期間     │ 売上額   │ 手数料    │ 入金額 │
├──────────┼──────────────┼──────────┼───────────┼────────┤
│ 03-05    │ 02/16-02/20  │  458,200│   14,863 │443,337│
│ 03-10    │ 02/21-02/25  │  512,300│   16,619 │495,681│
│ 03-15    │ 02/26-02/28  │  345,600│   11,209 │334,391│
│ 03-20    │ 03/01-03/05  │  398,400│   12,924 │385,476│
│ 03-25    │ 03/06-03/10  │  467,500│   15,167 │452,333│
│ 03-31    │ 03/11-03/15  │  489,200│   15,871 │473,329│
├──────────┼──────────────┼──────────┼───────────┼────────┤
│ 合計     │              │2,671,200│   86,653 │2,584,547│
└──────────┴──────────────┴──────────┴───────────┴────────┘

入金先: 三菱UFJ銀行 渋谷支店 普通 1234567
平均手数料率: 3.24%

8. `airpay menu` — 商品・メニュー管理

商品マスタの登録・編集・一括管理を行います。

airpay menu add --name "季節のフルーツパフェ" \
  --category "デザート" --price 1280 \
  --tax-rate 10 --cost 420

出力例:

商品登録完了
  商品ID:     PRD-0156
  商品名:     季節のフルーツパフェ
  カテゴリ:   デザート
  販売価格:   ¥1,280（税込¥1,408）
  原価:       ¥420
  原価率:     32.8%（目標35%以下: 達成）
  税率:       10%（標準税率）
  バーコード: 自動生成済み
  表示順:     デザートカテゴリ末尾

  テイクアウト対応: 未設定
  → テイクアウト販売する場合は --takeout オプションを追加
    （軽減税率8%が自動適用されます）

Workflow Diagram

┌──────────────────────────────────────────────────────────────────┐
│                  Airpay Agent 店舗運営ワークフロー                 │
│                                                                   │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐   │
│  │ 開店準備 │───▶│ 営業中   │───▶│ レジ締め │───▶│ 日次集計 │   │
│  │          │    │          │    │          │    │          │   │
│  └──────────┘    └──────────┘    └──────────┘    └──────────┘   │
│       │               │              │               │          │
│       ▼               ▼              ▼               ▼          │
│  ┌──────────┐    ┌──────────┐   ┌──────────┐   ┌──────────┐    │
│  │在庫確認  │    │注文入力  │   │現金突合  │   │売上分析  │    │
│  │スタッフ  │    │決済処理  │   │過不足   │   │レポート  │    │
│  │確認      │    │レシート  │   │記録     │   │出力      │    │
│  └──────────┘    └──────────┘   └──────────┘   └──────────┘    │
│                       │                              │          │
│                       ▼                              ▼          │
│                 ┌──────────┐                    ┌──────────┐    │
│                 │在庫自動  │                    │月次決算  │    │
│                 │減算      │                    │会計連携  │    │
│                 │発注提案  │                    │税務出力  │    │
│                 └──────────┘                    └──────────┘    │
│                                                                   │
│  ──── 定期処理 ─────────────────────────────────────             │
│  │ 入金確認 │ 在庫棚卸 │ シフト作成 │ 売上予測 │                │
│  └──────────────────────────────────────────────┘               │
└──────────────────────────────────────────────────────────────────┘

Error Handling

Error 1: 決済端末通信エラー

[AIRPAY-E001] 決済端末との通信に失敗しました
  端末ID: trm_ap2_00123456
  エラー: Bluetooth接続がタイムアウトしました
  対処:
    1. 端末の電源を確認してください
    2. iPadのBluetooth設定を確認してください
    3. 端末を再起動して再接続してください
  フォールバック: 現金決済モードで取引を記録しますか？ [Y/n]

Error 2: 在庫数不整合

[AIRPAY-E002] 在庫数の不整合を検出しました
  商品: PRD-0089 オレンジジュース
  システム在庫: 15本
  実棚卸数:     12本
  差異: -3本
  対処: 差異の原因を選択してください
    1. 廃棄（消費期限切れ等）
    2. 破損
    3. 原因不明（ロス計上）
  選択: [1/2/3]

Error 3: カード決済拒否

[AIRPAY-E003] カード決済が拒否されました
  決済ID: PY-TMP-00456
  カード: VISA ****-****-****-7890
  金額: ¥15,800
  理由: 与信枠超過（カード発行会社による拒否）
  対処: お客様に別の決済手段をご案内ください。
  記録: 拒否ログに記録済み（監査用）

Error 4: レジ締め不一致

[AIRPAY-E004] レジ締め時の現金過不足
  レジ内現金:   ¥152,300
  システム計上: ¥153,800
  差異: -¥1,500（不足）
  対処: 過不足として記録しました。
    仕訳: 現金過不足 1,500 / 現金 1,500
  アラート: 管理者（山田花子）に通知済み

Error 5: API認証エラー

[AIRPAY-E005] API認証に失敗しました
  エラーコード: 401 Unauthorized
  原因: AIRPAY_API_KEY が無効または期限切れです
  対処:
    1. Airレジ管理画面からAPIキーを再発行してください
    2. AIRPAY_API_KEY 環境変数を更新してください
    3. airpay auth verify で認証状態を確認してください

Error 6: 複数店舗データ同期エラー

[AIRPAY-E006] 店舗間データ同期に失敗しました
  対象店舗: str_tokyo_shinjuku_002
  エラー: ネットワーク接続が不安定です
  影響: 商品マスタの更新が反映されていません
  対処:
    次回のネットワーク接続時に自動同期を実行します。
    手動同期: airpay sync --store str_tokyo_shinjuku_002 --force

FAQ

Q1: Airレジの初期費用はかかりますか？

Airレジアプリ自体は無料です。iPadとAirペイカードリーダー（実質無料キャンペーンあり）があれば導入できます。Airpay Agentも無料で利用可能です。

Q2: Airペイの決済手数料はいくらですか？

業界最安水準の3.24%です。VISA、Mastercard、JCB、AMEX、Diners Club、Discover、交通系ICカード（Suica等）、iD、QUICPayがすべて3.24%です。PayPay、d払い、au PAYなどのQRコード決済も対応しています。

Q3: 入金サイクルはどうなっていますか？

みずほ銀行・三菱UFJ銀行・三井住友銀行は月6回（5日ごと）の入金です。ゆうちょ銀行は月3回です。その他の銀行は月3回〜6回で、振込手数料は無料です。

Q4: 軽減税率にどのように対応していますか？

商品登録時にカテゴリと税率を設定することで自動判定します。飲食料品のテイクアウト（8%）とイートイン（10%）の切り替えは、注文時にオプションで指定できます。

Q5: 複数店舗を一括管理できますか？

AIRPAY_MULTI_STORE=true を設定することで、複数店舗のデータを統合管理できます。店舗間の売上比較、在庫移動指示、統合レポートの作成が可能です。

Q6: オフライン時でも使えますか？

Airレジはオフライン時でも注文入力とレシート発行が可能です。Airpay Agentはオフライン時のデータをローカルにキャッシュし、オンライン復帰後に自動同期します。ただし、カード決済はオンライン接続が必要です。

Q7: 既存のPOSシステムからデータ移行できますか？

CSVインポート機能により、他のPOSシステムからの商品マスタ、顧客データの移行に対応しています。airpay import csv --file products.csv --type menu で一括インポートできます。

Q8: 会計ソフトとの連携はできますか？

freee、弥生会計、マネーフォワードクラウドへの仕訳データ出力に対応しています。airpay export --format freee で各ソフトのインポート形式でエクスポートできます。

Q9: インボイス制度に対応したレシートは発行できますか？

対応しています。適格請求書発行事業者の登録番号を設定すれば、インボイス制度の要件を満たすレシート（簡易適格請求書）が自動発行されます。税率ごとの区分記載も自動で行われます。

Q10: セキュリティ対策はどうなっていますか？

Airペイは PCI DSS（Payment Card Industry Data Security Standard）に準拠しています。Airpay Agentではカード番号を一切保持せず、トークン化された決済IDのみを管理します。ローカルデータは AES-256 で暗号化保存されます。

Q11: スタッフごとの売上を追跡できますか？

各スタッフにログインIDを発行し、担当した取引を紐づけることで、スタッフ別の売上実績、客単価、取引件数を追跡できます。評価指標として活用可能です。

Q12: 在庫の自動発注はできますか？

在庫が閾値を下回った際に自動で発注推奨リストを生成します。過去の販売データから適正在庫数を算出し、発注数量を提案します。発注そのものは手動確認が必要です。

Data Storage

Airpay Agentのローカルデータは以下のディレクトリ構造で保存されます。

~/.airpay-agent/
├── config/
│   ├── settings.json           # エージェント設定
│   ├── stores/                 # 店舗設定
│   │   ├── str_tokyo_shibuya_001.json
│   │   └── str_tokyo_shinjuku_002.json
│   ├── tax-rates.json          # 税率マスタ
│   └── receipt-templates/      # レシートテンプレート
│       ├── default.json
│       └── invoice-compliant.json
├── data/
│   ├── sales/                  # 売上データ（日次）
│   │   └── 2026/
│   │       └── 03/
│   │           ├── 01.json
│   │           └── ...
│   ├── transactions/           # 決済トランザクション
│   │   └── 2026/
│   │       └── 03/
│   │           ├── PY-001.json
│   │           └── ...
│   ├── inventory/              # 在庫データ
│   │   ├── current.json        # 現在在庫
│   │   ├── history/            # 在庫変動履歴
│   │   └── alerts/             # 在庫アラート
│   ├── customers/              # 顧客データ（暗号化）
│   │   ├── CLT-0001.enc
│   │   └── ...
│   ├── staff/                  # スタッフデータ
│   │   ├── STF-01.json
│   │   └── shifts/
│   │       └── 2026-03.json
│   ├── menu/                   # 商品マスタ
│   │   ├── products.json
│   │   └── categories.json
│   ├── settlements/            # 入金データ
│   │   └── 2026/
│   │       └── 03/
│   └── reports/                # 生成レポート
│       ├── monthly_2026_02.pdf
│       └── monthly_2026_02.csv
├── logs/
│   ├── api.log                 # APIリクエストログ
│   ├── transactions.log        # 決済ログ
│   ├── audit.log               # 監査ログ
│   └── error.log               # エラーログ
├── cache/
│   ├── tokens.enc              # 認証トークン（暗号化）
│   ├── offline-queue.json      # オフライン時の未同期データ
│   └── product-cache.json      # 商品マスタキャッシュ
├── assets/
│   └── logo.png                # レシートロゴ
└── backup/
    └── 2026/
        ├── 02/
        └── 03/

Comparison Table

機能	Airpay Agent	Square	stera terminal	PayPay Biz
CLI操作	対応	非対応	非対応	非対応
Claude Code統合	対応	非対応	非対応	非対応
POSレジ機能	Airレジ(無料)	Square POS(無料)	有料	非対応
初期費用	実質無料	無料〜	端末有料	無料
決済手数料	3.24%均一	3.25%〜	3.24%〜	1.60%〜
クレジットカード	6ブランド	6ブランド	6ブランド	非対応
電子マネー	対応	一部対応	対応	非対応
QRコード決済	対応	非対応	対応	PayPayのみ
入金サイクル	月3〜6回	翌営業日	月2回	翌日
振込手数料	無料	無料	銀行による	無料
在庫管理	対応	対応	基本のみ	非対応
顧客管理	対応	対応	非対応	限定的
スタッフ管理	対応	対応	非対応	非対応
インボイス対応	対応	対応	対応	対応
複数店舗管理	対応	対応	限定的	非対応
売上分析・AI予測	対応	基本分析	基本分析	基本分析
会計ソフト連携	freee/弥生/MF	freee	非対応	非対応
オフライン対応	キャッシュ	対応	非対応	非対応
バッチ処理	対応	非対応	非対応	非対応
レポート出力	CSV/Excel/PDF	CSV/PDF	PDF	CSV
API公開	対応	対応	限定的	非対応

Airpay Agentの最大の優位性は、リクルートの「Air」エコシステム（Airレジ、Airペイ、Airシフト、Airリザーブ等）との統合的な連携と、Claude Codeからのコマンドライン操作が可能な点です。POSレジアプリが無料であること、決済手数料が業界最安水準の3.24%均一であること、そして振込手数料が無料であることは、特に中小規模の店舗にとって大きなメリットです。本スキルを導入することで、店舗オーナーはターミナルから売上分析・在庫管理・スタッフ管理をリアルタイムに実行でき、店舗運営のDXを加速させることができます。

License

MIT License - hanabi-jpn

Overview

アーキテクチャ概要

処理フロー

System Prompt（行動指針）

Environment Variables

Commands

1. airpay sales — 売上管理

2. airpay payment — 決済処理・照会

3. airpay inventory — 在庫管理

4. airpay customer — 顧客管理

5. airpay report — 売上レポート

6. airpay staff — スタッフ管理

7. airpay settlement — 入金管理

8. airpay menu — 商品・メニュー管理

Workflow Diagram

Error Handling

Error 1: 決済端末通信エラー

Error 2: 在庫数不整合

Error 3: カード決済拒否

Error 4: レジ締め不一致

Error 5: API認証エラー

Error 6: 複数店舗データ同期エラー

FAQ

Q1: Airレジの初期費用はかかりますか？

Q2: Airペイの決済手数料はいくらですか？

Q3: 入金サイクルはどうなっていますか？

Q4: 軽減税率にどのように対応していますか？

Q5: 複数店舗を一括管理できますか？

Q6: オフライン時でも使えますか？

Q7: 既存のPOSシステムからデータ移行できますか？

Q8: 会計ソフトとの連携はできますか？

Q9: インボイス制度に対応したレシートは発行できますか？

Q10: セキュリティ対策はどうなっていますか？

Q11: スタッフごとの売上を追跡できますか？

Q12: 在庫の自動発注はできますか？

Data Storage

Comparison Table

License

1. `airpay sales` — 売上管理

2. `airpay payment` — 決済処理・照会

3. `airpay inventory` — 在庫管理

4. `airpay customer` — 顧客管理

5. `airpay report` — 売上レポート

6. `airpay staff` — スタッフ管理

7. `airpay settlement` — 入金管理

8. `airpay menu` — 商品・メニュー管理