Gowid Expense

Gowid 경비 어시스턴트

Gowid 법인카드 미제출 경비를 조회하고, 용도를 지정하여 제출하는 Claude Code / Codex 공용 스킬.

셋업 확인

스킬 실행 시 반드시 먼저 아래를 확인:

# 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

API 키는 스크립트에 내장되어 있어 별도 설정 불필요.

사용자 식별

# 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 결과에서 userId를 이후 모든 요청의 사용자 식별자로 사용.

헬퍼 스크립트

모든 API 호출은 scripts/gowid.py를 통해 수행. 설치 경로 예시:

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

워크플로우

1. 내 미제출 경비 조회

사용자가 "내 경비", "미제출", "경비 보여줘" 등 요청 시:

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

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

결과를 한국어 테이블로 표시:

📋 미제출 경비 (N건)

| # | 날짜 | 가맹점 | 금액 | 추천 용도 | ID |
|---|------|--------|------|----------|-----|
| 1 | 03/26 | READ - MEETING ... | 30,430원 | IT서비스 이용료 | 32625805 |

• 금액이 USD/SGP 등 해외인 경우 원화 환산 금액도 함께 표시
• 용도 추천은 auto_rules 기반 (헬퍼가 처리)
• --month 미지정 시 이번 달만 반환 — "지난달 경비 안 보여요" 문의는 대부분 월 파라미터 누락

2. 경비 자동 분류 추천 (suggest)

사용자가 "이거 뭐로 제출해야 해?", "32625805 추천해줘", "규칙 추천" 등 요청 시:

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

내부 동작:

1. 경비 상세(storeName, krwAmount, expenseTime) 조회
2. data/auto_rules.json의 331개 패턴과 매칭 (confidence 내림차순)
3. 시간 기반 자동 전환: 점심식비(12556) ↔ 야근식비(12555) — 18시 기준
4. 한국 식당/배달 가맹점이면 규칙 미매칭 시에도 시간으로 점심/야근 추정
5. 필수항목이 있으면 requirementAnswerMap 자동 채움 (auto_rules의 requirement_answer 활용)
6. 바로 실행 가능한 suggestedCommand 문자열까지 생성해서 반환

출력 예:

{
  "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 워크스페이스\"]}'"
}

사용자에게는 top 매칭 1건을 한국어로 요약해서 보여주고, 동의하면 suggestedCommand를 그대로 실행:

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

제출할까요? [y/N]

언제 유용한가:

• 규칙이 있는 가맹점(Anthropic, GitHub, Vercel, AWS, Slack 등) → 즉시 Tier 1 자동 제출
• 한국 식당 → 시간대 자동 판단 (점심/야근)
• 필수항목 있는 용도(업무교통비, 도서구입비 등) → requirement_answer가 규칙에 있으면 자동 기입

3. 경비 제출

사용자가 "이거 식비로 제출해", "32625805 IT서비스로 제출" 등 요청 시:

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

식비 제출 시:

• 인당 한도 초과(점심 12,000원, 야근 12,000원, 금요미식회 15,000원)면 참석자 필수
• "누구랑 먹었어요?" 물어보기
• 참석자 이름 → userId 변환은 gowid.py members로 조회

IT서비스 제출 시:

• 서비스,프로그램명 기입 필드(purposeRequirementAnswerMap["360"])에 서비스명 자동 기입 (예: "Notion 워크스페이스")
• --memo로 서비스명을 받아도 헬퍼가 해당 필드로 자동 변환한다. 메모는 추가 설명이 있을 때만 사용

4. 용도 목록 조회

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

5. 팀원 목록 (참석자 선택용)

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

6. 경비 상세 조회

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

7. 자동 분류 규칙 조회

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

8. 규칙 추가 제안

사용자가 "이 가맹점 규칙 추가해줘" 요청 시:

1. 가맹점 패턴, 용도, 메모를 확인
2. GitHub Issue 생성 제안:

gh issue create --repo EO-Studio-Dev/gowid-expense-bot \
  --title "규칙 추가: <가맹점> → <용도>" \
  --body "패턴: <pattern>\n용도: <purposeName> (ID: <purposeId>)\n메모: <memo>\n제안자: $(git config user.email)"

용도 ID 빠른 참조

필수항목(Requirements) 있는 용도 제출

일부 용도는 필수 입력항목이 있다 (예: 업무교통비 → 출발지/도착지, 도서구입비 → 책 제목). 모든 필수항목은 현재 TEXT 타입이며, purposeRequirementAnswerMap으로 API 제출 가능.

제출 워크플로우:

1. purposes 커맨드에서 hasRequirements: true인 용도의 requirements 배열 확인
2. 필수항목이 SELECT/SELECT_MULTI 타입이면 purpose-requirements <purposeId>로 선택지 조회
3. 사용자에게 필수항목 값 확인 후, --requirements 플래그로 제출

# 필수항목 상세 조회
python3 gowid.py purpose-requirements 12551

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

자동 분류 규칙 활용:

• rules 커맨드의 requirement_answer 값이 있으면 TEXT 타입 필수항목의 답으로 활용 가능
• IT서비스(12532), 멤버십(70602), 매거진(12536)은 isRequired: false여도 자동 제출 시 필수항목 답변을 채운다

필수항목 미입력 시: 400 Bad Request 에러 반환 (이전에는 500이었으나 2026-04 수정됨)

이미 제출된 건(SUBMITTED)은 API로 변경/취소 불가:

• 제출 취소 엔드포인트 없음 (DELETE, cancel 모두 404)
• SUBMITTED 상태에서 용도 변경 PUT → 500 에러
• 잘못 제출된 건은 반드시 Gowid 웹에서 수정해야 함
• Gowid 확인 (2026-04): 제출 후 수정/취소 API는 현재 미지원이며, 향후 개선 검토 중

주의사항

• 이 스킬은 본인 경비만 조회/제출합니다
• API 키는 회사 공용입니다. 외부에 절대 공유하지 마세요
• 제출 후 Gowid에서 관리자 승인을 기다리면 됩니다
• 이미 제출된 건은 자동으로 건너뜁니다 (중복 제출 방지)
• 필수항목 강제 용도는 API 제출 불가 — Gowid 웹에서 직접 제출 안내