- features/esign/README.md: 전자서명 (4모델, 16 API) - features/documents/README.md: 문서관리 (12모델, EAV 기반, 15 API) - features/ai/README.md: AI 리포트 (Gemini 2.0, 4 API) - features/equipment/README.md: 설비관리 (MNG 전용) - features/finance/ 9개 하위문서: 입출금, 급여, 가지급금, 세금계산서, 악성채권, 어음, 카드, 미지급비용, 채권현황, CEO 대시보드 - features/finance/README.md 재구조화 (14개 하위문서 목록) - features/barobill-kakaotalk/README.md 확장 (API 설정 + 세금계산서) - rules/numbering-rules.md: 채번규칙 (6세그먼트, 원자적 UPSERT) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
카드관리 (Cards & Card Transactions)
최종 갱신: 2026-02-27
1. 개요
법인카드 등록·관리 및 카드 사용내역 조회·계정과목 배정.
2. API 엔드포인트
카드 관리
| HTTP | URI | 설명 |
|---|---|---|
| GET | /v1/cards |
카드 목록 |
| POST | /v1/cards |
카드 등록 |
| GET | /v1/cards/active |
활성 카드 목록 |
| GET | /v1/cards/{id} |
카드 상세 |
| PUT | /v1/cards/{id} |
카드 수정 |
| DELETE | /v1/cards/{id} |
카드 삭제 |
| PATCH | /v1/cards/{id}/toggle |
상태 토글 |
Card 모델 특이사항:
card_number_encrypted: 카드번호 자동 암호화card_password_encrypted: 비밀번호 자동 암호화getMaskedCardNumber(): 마스킹 처리된 번호 반환
카드 거래내역
| HTTP | URI | 설명 |
|---|---|---|
| GET | /v1/card-transactions |
거래 목록 |
| POST | /v1/card-transactions |
거래 등록 |
| GET | /v1/card-transactions/summary |
요약 |
| GET | /v1/card-transactions/dashboard |
대시보드 |
| PUT | /v1/card-transactions/bulk-update-account |
계정과목 일괄 수정 |
| GET | /v1/card-transactions/{id} |
거래 상세 |
| PUT | /v1/card-transactions/{id} |
거래 수정 |
| DELETE | /v1/card-transactions/{id} |
거래 삭제 |
관련 문서
- 재무관리 개요
- 법인카드·차량 관리 — 차량 관련 카드 사용
- Swagger:
/api-docs→ Cards / CardTransactions 섹션