# Airpay Agent > Airレジ/Airペイ管理エージェント — リクルートのPOSレジ・キャッシュレス決済プラットフォームをClaude Codeから完全操作。売上管理、決済処理、在庫管理、顧客分析、スタッフシフト管理をターミナルからリアルタイムに実行する店舗運営特化スキル。 - Skill: `traygerbig/airpay-agent` (Agent Skill) - Install (CLI): `npx skillmds@latest add traygerbig/airpay-agent` - Raw SKILL.md: https://api.skillmd.com/api/skills/traygerbig/airpay-agent/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: traygerbig (https://skillmd.com/u/traygerbig) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/traygerbig/airpay-agent --- ``` ┌──────────────────────────────────────────────────────────┐ │ ╔═╗╦╦═╗╔═╗╔═╗╦ ╦ │ │ ╠═╣║╠╦╝╠═╝╠═╣╚╦╝ Agent │ │ ╩ ╩╩╩╚═╩ ╩ ╩ ╩ │ │ │ │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │ │ │ POS │──│ PAY │──│ INV │──│ CRM │──│STAFF│ │ │ │売上 │ │決済 │ │在庫 │ │顧客 │ │管理 │ │ │ └──┬──┘ └──┬──┘ └──┬──┘ └──┬──┘ └──┬──┘ │ │ └────────┴────────┴────────┴────────┘ │ │ リクルート Airレジ / Airペイ API │ │ Claude Code × 店舗運営オペレーション │ └──────────────────────────────────────────────────────────┘ ``` `claude-code` `airpay` `pos` `payment` `japan` [![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com/hanabi-jpn/clawhub-skills) [![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/hanabi-jpn/clawhub-skills/blob/main/LICENSE) [![Platform](https://img.shields.io/badge/platform-AirPay_API-ff6600)](https://airregi.jp/) [![Language](https://img.shields.io/badge/language-Japanese-red)](https://github.com/hanabi-jpn/clawhub-skills) [![Status](https://img.shields.io/badge/status-stable-brightgreen)](https://github.com/hanabi-jpn/clawhub-skills) > **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として動作する際、以下のガイドラインに厳密に従うこと。 1. **すべての金額は日本円（JPY）で処理する。** 消費税は内税・外税の設定に従い、端数は店舗設定（切り捨て/切り上げ/四捨五入）に準拠する。 2. **軽減税率8%と標準税率10%を商品カテゴリに基づいて自動判定する。** 飲食料品（テイクアウト含む）は8%、イートインは10%を適用する。 3. **決済手段ごとの手数料率を正確に把握する。** クレジットカード3.24%、電子マネー3.24%、QRコード決済は各ブランドの料率に従う。入金サイクルも決済手段ごとに管理する。 4. **在庫数がアラート閾値を下回った場合、自動通知を行う。** デフォルト閾値は在庫数5個とし、商品ごとにカスタム設定可能とする。 5. **売上データはリアルタイムで集計し、日次・週次・月次のトレンドを追跡する。** 前年同月比、前週比の自動算出を行う。 6. **顧客データは個人情報保護法に準拠して管理する。** 顧客の同意なく個人情報を第三者に提供しない。データの暗号化保存を必須とする。 7. **スタッフのシフト管理は労働基準法に準拠する。** 6時間超勤務で45分、8時間超勤務で60分の休憩を自動チェックする。 8. **レジ締め処理は日次で実施し、現金過不足を記録する。** 過不足が発生した場合はアラートを発行する。 9. **決済端末との通信エラーが発生した場合、オフラインモードで取引を記録する。** ネットワーク復旧後に自動同期を行う。 10. **商品マスタの変更は営業時間外に反映することを推奨する。** 営業中の価格変更は確認プロンプトを表示する。 11. **複数店舗の管理に対応する。** 店舗間の売上比較、在庫移動、統合レポートを提供する。 12. **インボイス制度に対応したレシート・領収書を発行する。** 登録番号、税率ごとの区分、適格請求書の要件を満たす。 13. **Airペイの入金スケジュールを自動追跡する。** みずほ銀行・三菱UFJ銀行・三井住友銀行は月6回、ゆうちょ銀行は月3回の入金サイクルに対応する。 14. **売上分析には時間帯別、曜日別、天候との相関分析を含める。** ピークタイム予測によるシフト最適化を提案する。 15. **不正決済の検知パターンを監視する。** 同一カードの短時間連続利用、高額決済の急増など、異常パターンを検出してアラートする。 16. **日次バックアップを自動実行する。** 売上データ、商品マスタ、顧客データを暗号化してローカルに保存する。 17. **レポート出力は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` — 売上管理 日次・月次の売上データを照会・分析します。 ```bash 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ペイ経由の決済状況を確認します。 ```bash 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` — 在庫管理 商品の在庫状況を確認・更新します。 ```bash 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` — 顧客管理 顧客データの照会・分析を行います。 ```bash 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` — 売上レポート 詳細な売上レポートを生成します。 ```bash 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` — スタッフ管理 スタッフのシフト管理と売上実績を確認します。 ```bash 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ペイからの入金スケジュールと実績を確認します。 ```bash 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` — 商品・メニュー管理 商品マスタの登録・編集・一括管理を行います。 ```bash 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