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)
--monthIf 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:
- Expense details (
storeName,krwAmount,expenseTime) inquiry data/auto_rules.jsonof 331 patterns (in descending confidence)- Time-based automatic switching: Lunch meal expense (12556) ↔ Overtime meal expense (12555) — based on 18:00
- For Korean restaurants/delivery merchants, even if no rule matches, estimate lunch/overtime by time
- If there are required fields,
requirementAnswerMapauto-fill (using auto_rules'requirement_answeruse) - Ready-to-run
suggestedCommandstringalso 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":
- Check the merchant pattern, purpose, and notes
- 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:
purposesIn the command,hasRequirements: trueFor the purpose, therequirementsarray check- If the required field is SELECT/SELECT_MULTI type,
purpose-requirements <purposeId>look up the options with - After confirming the required field values with the user,
--requirementssubmit with the flag
# 필수항목 상세 조회
python3 gowid.py purpose-requirements 12551
# 필수항목 포함 제출
python3 gowid.py submit <expenseId> 12551 --requirements '{"126": ["서울역에서 강남역"]}' --memo "출장"
Utilizing auto-classification rules:
rulesThe command'srequirement_answerIf 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