하이패스 영수증 발급

このスキルの説明

公式ハイパスホームページ(https://www.hipass.co.kr)ですでにログイン済みのブラウザセッションを再利用して:

• 使用内訳の照会
• 特定行の選択
• 領収書ポップアップ/印刷画面への進入
• セッション失効検知後の再ログイン案内

を半自動で支援する。

Hard limits

• ログインは必ずユーザーが直接行わなければならない。
• このスキルはログイン済みのセッションのみで動作する。
• ID/PW、認証コード、OTP、公同認証書の手順を自動入力しない。
• JSESSIONID クッキーのみを保存して長時間再利用する方式には対応していない。
• 推奨セッション形式はPlaywright persistent contextまたはChrome user-data-dir / remote-debugging の再利用である。
• セッションが失効したら即座に中止して再ログインする必要がある。

このデザインの理由

現在の公開ページ基準で:

• ログインページとメインページに session_time=1200 が公開されている。
• セッション延長は /comm/sessionCheck.do
• セッション終了は /comm//sessionout.do
• 未ログイン/セッション終了の保護応答は mgs_type 11/12 の後 /comm/lginpg.do にリダイレクトされる。
• 使用内訳照会は /usepculr/InitUsePculrTabSearch.do → hpForm submit → /usepculr/UsePculrTabSearchList.do のフローである。
• 領収書は /usepculr/UsePculrReceiptPrint.do ポップアップ進入で続く。

つまり v1は**「ログイン済みChrome セッションの再利用」**が最も現実的である。

Prerequisites

• macOSまたはChrome実行可能な環境
• npm install hipass-receipt またはこのリポジトリで npm install (playwright-core を含む)
• Chrome リモートデバッグポート利用可能
• ユーザーが直接ハイパスにログイン可能

Workflow

1. 専用Chromeプロファイルでログインブラウザを起動する

hipass-receipt chrome-command --profile-dir "$HOME/.cache/k-skill/hipass-chrome" --debugging-port 9222

上記コマンドが出力したChrome実行文でブラウザを起動した後、ユーザーが直接 https://www.hipass.co.kr/comm/lginpg.do にログインする。

2. 使用内訳を照会する

hipass-receipt list \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --page-size 30

• カード会社/暗号化カード番号を知っていれば --encrypted-card-number などでさらに絞り込める。
• --encrypted-card-number はCLIの既存 --ecd-no エイリアスである。
• 結果JSONから rowIndex を確認する。

3. 特定行の領収書ポップアップを開く

hipass-receipt receipt \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --row-index 1

• 選択した行の 領収書/印刷 control をクリックする。
• ポップアップが開いたらURL/titleを返す。

Response policy

• 「ログイン必須」「セッション失効時に再ログイン必要」を常に明確に記す。
• ハイパス口座パスワードを受け取り保存したり、新しいenv varを作成しない。
• セッション失効時は即座に失敗させ、/comm/lginpg.do 再ログイン案内のみを提供する。
• v1範囲を超える完全無人ログイン維持/バックグラウンド再認証は約束しない。

Verification

• 自動検証: fixture ベースの query/parser/session-detection テスト
• smoke 検証: hipass-receipt fixture-demo --fixture ...
• 最終本番検証: ログイン済みセッションでの手動smoke test

完了条件

• ログイン済みセッションで使用内訳照会が可能である。
• 特定行を選択して領収書ポップアップ進入を試みることができる。
• セッション終了応答を検知すると再ログインを要求する。