48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
|
# 악성채권 추심관리 (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}` | 메모 삭제 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 관련 문서
|
||
|
|
|
||
|
|
- [재무관리 개요](README.md)
|
||
|
|
- [채권현황](receivables-ledger.md)
|
||
|
|
- Swagger: `/api-docs` → BadDebts 섹션
|