docs: [finance] 계정코드 마이그레이션 이력 + 손익계산서 API 명세 업데이트
- 더존 3자리→KIS 5자리 코드 마이그레이션 기록 (832건) - 손익계산서 월별 API 명세 추가 - 당기/전기 토글, 월별 보기 화면 요구사항 추가
This commit is contained in:
@@ -120,9 +120,10 @@ interface LedgerItem {
|
||||
|
||||
| Method | Path | 설명 |
|
||||
|--------|------|------|
|
||||
| `GET` | `/api/v1/income-statement` | 손익계산서 조회 |
|
||||
| `GET` | `/api/v1/income-statement` | 기간 손익계산서 조회 |
|
||||
| `GET` | `/api/v1/income-statement/monthly` | 월별 손익계산서 조회 |
|
||||
|
||||
### 3.2 요청 파라미터
|
||||
### 3.2 기간 조회 파라미터
|
||||
|
||||
| 파라미터 | 타입 | 필수 | 설명 |
|
||||
|---------|------|:----:|------|
|
||||
@@ -131,6 +132,14 @@ interface LedgerItem {
|
||||
| `unit` | `string` | N | `won` (기본) / `thousand` / `million` |
|
||||
|
||||
> **전기**: API가 자동으로 전년 동기를 계산 (예: 2026 → 2025)
|
||||
> **기수**: 코드브릿지엑스 설립 2025-09-13 기준, 제1기 = 2025년, 제2기 = 2026년
|
||||
|
||||
### 3.2.1 월별 조회 파라미터
|
||||
|
||||
| 파라미터 | 타입 | 필수 | 설명 |
|
||||
|---------|------|:----:|------|
|
||||
| `year` | `integer` | Y | 조회 연도 (`2026`) |
|
||||
| `unit` | `string` | N | `won` (기본) / `thousand` / `million` |
|
||||
|
||||
### 3.3 응답 구조
|
||||
|
||||
@@ -165,6 +174,28 @@ interface PLItem {
|
||||
}
|
||||
```
|
||||
|
||||
### 3.3.1 월별 조회 응답 구조
|
||||
|
||||
```typescript
|
||||
interface MonthlyIncomeStatementResponse {
|
||||
success: boolean;
|
||||
message: string;
|
||||
data: {
|
||||
year: number; // 2026
|
||||
fiscal_year: number; // 2 (제2기)
|
||||
fiscal_label: string; // "제 2 기"
|
||||
unit: 'won' | 'thousand' | 'million';
|
||||
months: MonthPL[];
|
||||
};
|
||||
}
|
||||
|
||||
interface MonthPL {
|
||||
month: string; // "01", "02", ...
|
||||
label: string; // "1월", "2월", ...
|
||||
sections: PLSection[]; // 해당 월의 손익 항목 (current_amount만 유효, previous_amount는 0)
|
||||
}
|
||||
```
|
||||
|
||||
### 3.4 손익계산서 구조
|
||||
|
||||
```
|
||||
@@ -182,8 +213,11 @@ X. 당기순이익 = VIII - IX ← 계산
|
||||
|
||||
### 3.5 화면 요구사항
|
||||
|
||||
- **조회 필터**: 기간(date range) + 금액 단위 선택
|
||||
- **테이블**: 과목 | 당기 금액(2열) | 전기 금액(2열)
|
||||
- **보기 모드 토글**: `[기간 보기]` / `[월별 보기]`
|
||||
- **당기/전기 토글**: `[당기만]` / `[당기+전기]` (기간 보기에서만)
|
||||
- **조회 필터**: 기간(date range) 또는 연도 + 금액 단위 선택
|
||||
- **기간 보기 테이블**: 과목 | 당기 금액(2열) | 전기 금액(2열, 토글로 숨김 가능)
|
||||
- **월별 보기**: 연도 선택 → 월별 버튼(1~12월) → 개별 월 또는 전체 비교
|
||||
- **당기 컬럼 2열**: 세부 금액(왼쪽) + 소계(오른쪽)
|
||||
- 세부 항목이 있는 섹션: 마지막 행의 오른쪽 열에 소계 표시
|
||||
- 계산 항목(`is_calculated`): 오른쪽 열에만 금액 표시
|
||||
|
||||
Reference in New Issue
Block a user