SuperAPI AI Directory

gowid-expense

General & other

View repository

Updated 10-15 20:04

About this skill

Gowid expense assistant

A Claude Code / Codex shared skill that inquires about Gowid corporate card unsubmitted expenses and submits them by designating a purpose.

Check setup

When running the skill, be sure to first check the following:

# Codex 설치 경로
python3 ~/.codex/skills/gowid-expense/scripts/gowid.py whoami

# Claude Code 설치 경로
python3 ~/.claude/skills/gowid-expense/scripts/gowid.py whoami

# Windows 사용자는 python3 대신 python 사용
python ~/.codex/skills/gowid-expense/scripts/gowid.py whoami

The API key is embedded in the script, so no separate configuration is needed.

User identification

# git 이메일로 Gowid userId 조회
python3 ~/.codex/skills/gowid-expense/scripts/gowid.py whoami
# Claude Code: python3 ~/.claude/skills/gowid-expense/scripts/gowid.py whoami
# Windows: python ~/.codex/skills/gowid-expense/scripts/gowid.py whoami

whoami From the results, userIduse as the user identifier for all subsequent requests.

Helper script

All API calls are scripts/gowid.pyperformed through. Example installation path:

~/.codex/skills/gowid-expense/scripts/gowid.py
~/.claude/skills/gowid-expense/scripts/gowid.py

Workflow

1. Inquiry of my unsubmitted expenses

When the user requests "my expenses", "unsubmitted", "show me expenses", etc.:

# 기본: 이번 달 본인 경비
python3 ~/.claude/skills/gowid-expense/scripts/gowid.py my-expenses

# 지난달 / 특정 월 조회 — 사용자가 "3월 경비", "지난달 미제출" 등 요청 시
python3 ~/.claude/skills/gowid-expense/scripts/gowid.py my-expenses --month 202603

Display the results in a Korean table:

📋 미제출 경비 (N건)

| # | 날짜 | 가맹점 | 금액 | 추천 용도 | ID |
|---|------|--------|------|----------|-----|
| 1 | 03/26 | READ - MEETING ... | 30,430원 | IT서비스 이용료 | 32625805 |
  • If the amount is in a foreign currency such as USD/SGP, also display the converted amount in KRW
  • Purpose recommendations are based on auto_rules (handled by the helper)
  • --month If unspecified, only this month is returned — most inquiries like "I can't see last month's expenses" are due to a missing month parameter

2. Automatic expense classification recommendation (suggest)

When the user requests "What should I submit this as?", "Recommend 32625805", "Recommend a rule", etc.:

python3 ~/.claude/skills/gowid-expense/scripts/gowid.py suggest <expenseId>

Internal behavior:

  1. Expense details (storeName, krwAmount, expenseTime) inquiry
  2. data/auto_rules.jsonof 331 patterns (in descending confidence)
  3. Time-based automatic switching: Lunch meal expense (12556) ↔ Overtime meal expense (12555) — based on 18:00
  4. For Korean restaurants/delivery merchants, even if no rule matches, estimate lunch/overtime by time
  5. If there are required fields, requirementAnswerMap auto-fill (using auto_rules' requirement_answer use)
  6. Ready-to-run suggestedCommand stringalso generate and return

Output example:

{
  "storeName": "NOTION.SO",
  "amount": 12500,
  "matches": [
    {"purposeName": "IT서비스 이용료", "purposeId": 12532, "confidence": 1.0, "requirementAnswerMap": {"360": ["Notion 워크스페이스"]}}
  ],
  "suggestedCommand": "gowid.py submit 32625805 12532 --requirements '{\"360\": [\"Notion 워크스페이스\"]}'"
}

To the user, summarize the top match in Korean and show it, and if they agree, suggestedCommandrun as is:

💡 NOTION.SO 12,500원 → IT서비스 이용료 (confidence 1.0)
   서비스명: Notion 워크스페이스

제출할까요? [y/N]

When it is useful:

  • Merchants with rules (Anthropic, GitHub, Vercel, AWS, Slack, etc.) → immediate Tier 1 automatic submission
  • Korean restaurants → automatic time-based determination (lunch/overtime)
  • Purposes with required fields (business transportation expense, book purchase expense, etc.) → requirement_answerif in the rules, automatically enter

3. Expense submission

When the user requests "Submit this as a meal expense", "Submit 32625805 as IT service", etc.:

# 용도 지정 + 제출
python3 ~/.claude/skills/gowid-expense/scripts/gowid.py submit <expenseId> <purposeId> [--memo "메모"] [--participants "id1,id2"]

When submitting a meal expense:

  • If the per-person limit is exceeded (lunch 12,000 KRW, overtime 12,000 KRW, Friday gourmet club 15,000 KRW), attendees are required
  • Ask "Who did you eat with?"
  • Attendee name → userId conversion is gowid.py membersinquiry with

When submitting IT service:

  • 서비스,프로그램명 기입 field (purposeRequirementAnswerMap["360"]) automatically enter the service name (e.g., "Notion workspace")
  • --memoEven when receiving the service name, the helper automatically converts it to the corresponding field. Notes are used only when there is additional explanation.

4. Purpose list lookup

python3 ~/.claude/skills/gowid-expense/scripts/gowid.py purposes

5. Team member list (for attendee selection)

python3 ~/.claude/skills/gowid-expense/scripts/gowid.py members

6. Expense detail lookup

python3 ~/.claude/skills/gowid-expense/scripts/gowid.py detail <expenseId>

7. Auto-classification rule lookup

python3 ~/.claude/skills/gowid-expense/scripts/gowid.py rules [검색어]

8. Rule addition suggestion

When the user requests "add a rule for this merchant":

  1. Check the merchant pattern, purpose, and notes
  2. GitHub Issue creation suggestion:
gh issue create --repo EO-Studio-Dev/gowid-expense-bot \
  --title "규칙 추가: <가맹점> → <용도>" \
  --body "패턴: <pattern>\n용도: <purposeName> (ID: <purposeId>)\n메모: <memo>\n제안자: $(git config user.email)"

Purpose ID quick reference

ID Purpose API submission Remarks
12556 Lunch expense ✅ Available 12,000 KRW per person
12555 Overtime meal expense ✅ Available 12,000 KRW per person
131887 Friday Gourmet Club (lunch expense) ✅ Available 15,000 KRW per person
12553 Dining expense ✅ Available
12552 Other meal expense ✅ Available
12532 IT service usage fee ✅ Available 서비스,프로그램명 기입Service name in
70602 Membership subscription fee ✅ Available Enter the service name/subscription name in the required field
12536 Magazine subscription fee ✅ Available Enter the media name/subscription name in the required field
12546 Postage ✅ Available
72341 Communication expense ✅ Available
72017 Laptop rental (recurring payment) ✅ Available
12533 Supplies expense (100,000 KRW or less) ✅ Available
12551 Business transportation expense ✅ Available Required fields: origin/destination (--requirements)
12550 Overtime transportation expense ✅ Available Required fields: commute time (--requirements)
12537 Book purchase expense ✅ Available Required field: book title (--requirements)
12531 Document issuance fee ✅ Available Required field: project name (--requirements)
85747 Business entertainment expense (staff meals, filming beverages) ✅ Available Project required
12530 Online marketing ✅ Available Project required

Submit a purpose with required fields (Requirements)

Some purposes have required input fields (e.g., business transportation expense → origin/destination, book purchase expense → book title). All required fields are currently TEXT type, and purposeRequirementAnswerMapAPI submission is possible.

Submission workflow:

  1. purposes In the command, hasRequirements: trueFor the purpose, the requirements array check
  2. If the required field is SELECT/SELECT_MULTI type, purpose-requirements <purposeId>look up the options with
  3. After confirming the required field values with the user, --requirements submit with the flag
# 필수항목 상세 조회
python3 gowid.py purpose-requirements 12551

# 필수항목 포함 제출
python3 gowid.py submit <expenseId> 12551 --requirements '{"126": ["서울역에서 강남역"]}' --memo "출장"

Utilizing auto-classification rules:

  • rules The command's requirement_answer If a value exists, it can be used as the answer to a required TEXT-type field
  • IT service (12532), membership (70602), magazine (12536) are isRequired: falseeven so, when auto-submitting, required fields are filled in

When required fields are not entered: returns a 400 Bad Request error (previously 500, fixed in 2026-04)

Already submitted items (SUBMITTED) cannot be changed/canceled via API:

  • No submission cancellation endpoint (both DELETE and cancel return 404)
  • Changing purpose via PUT in SUBMITTED state → 500 error
  • Incorrectly submitted items must be corrected on the Gowid web
  • Gowid confirmation (2026-04): post-submission edit/cancel API is currently unsupported, and improvements are under review for the future

Precautions

  • This skill only your own expenses views/submits
  • The API key is shared company-wide. Never share it externally
  • After submission, wait for administrator approval in Gowid
  • Already submitted items are automatically skipped (prevents duplicate submission)
  • Purposes with required fields cannot be submitted via API — guide to submit directly on the Gowid web