Embed badge
Show
Style
[](https://versuz.dev/skills/traygerbig-clawhub-skills-finance-accounting-pack-airpay-agent)Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.
npx versuz@latest install traygerbig-clawhub-skills-finance-accounting-pack-airpay-agentgit clone https://github.com/traygerbig/clawhub-skills.gitcp clawhub-skills/SKILL.MD ~/.claude/skills/traygerbig-clawhub-skills-finance-accounting-pack-airpay-agent/SKILL.md---
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`
[](https://github.com/hanabi-jpn/clawhub-skills)
[](https://github.com/hanabi-jpn/clawhub-skills/blob/main/LICENSE)
[](https://airregi.jp/)
[](https://github.com/hanabi-jpn/clawhub-skills)
[](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