- 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.4 KiB
1.4 KiB
악성채권 추심관리 (Bad Debts)
최종 갱신: 2026-02-27
1. 개요
미수금이 장기 연체된 악성채권의 추심 관리. 상태 추적, 관련 서류 첨부, 메모 관리를 지원한다.
상태: collecting (추심중) → legal_action (법적조치) → recovered (회수완료) / bad_debt (대손처리)
2. 모델
| 모델 | 설명 |
|---|---|
BadDebt |
악성채권 마스터 (거래처, 금액, 상태, 연체일수, 담당자) |
BadDebtDocument |
추심 관련 서류 |
BadDebtMemo |
추심 메모/활동 기록 |
3. API 엔드포인트
| HTTP | URI | 설명 |
|---|---|---|
| GET | /v1/bad-debts |
악성채권 목록 |
| POST | /v1/bad-debts |
악성채권 등록 |
| GET | /v1/bad-debts/summary |
요약 |
| GET | /v1/bad-debts/{id} |
악성채권 상세 |
| PUT | /v1/bad-debts/{id} |
악성채권 수정 |
| DELETE | /v1/bad-debts/{id} |
악성채권 삭제 |
| PATCH | /v1/bad-debts/{id}/toggle |
활성 토글 |
| POST | /v1/bad-debts/{id}/documents |
서류 추가 |
| DELETE | /v1/bad-debts/{id}/documents/{documentId} |
서류 삭제 |
| POST | /v1/bad-debts/{id}/memos |
메모 추가 |
| DELETE | /v1/bad-debts/{id}/memos/{memoId} |
메모 삭제 |