ened/KissMe
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Working on DART api (half-time)

Browse Source
This commit is contained in:
ened
2023-07-10 09:27:55 +09:00
parent 5679950f4d
commit 6496d4e5a2
6 changed files with 1427 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

81
KissMe/Sources/Domestic/DART/DomesticDart.swift
View File

@@ -65,6 +65,83 @@ public struct DomesticDart {
/// 사업보고서
case annual = "11011"
}
public enum FinancialStatementDivision: String, Codable {
/// 연결재무제표
case consolated = "CFS"
/// 재무제표
case one = "OFS"
}
public enum StatementDivision: String, Codable {
/// 재무상태표
case basis = "BS"
/// 재무상태표 - 연결 - 유동/비유동법
case basis1 = "BS1"
/// 재무상태표 - 개별 - 유동/비유동법
case basis2 = "BS2"
/// 재무상태표 - 연결 - 유동성배열법
case basis3 = "BS3"
/// 재무상태표 - 개별 - 유동성배열법
case basis4 = "BS4"
/// 손익계산서
case income = "IS"
/// 별개의 손익계산서 - 연결 - 기능별분류
case income1 = "IS1"
/// 별개의 손익계산서 - 개별 - 기능별분류
case income2 = "IS2"
/// 별개의 손익계산서 - 연결 - 성격별분류
case income3 = "IS3"
/// 별개의 손익계산서 - 개별 - 성격별분류
case income4 = "IS4"
/// 포괄손익계산서
case comprehensiveIncome = "CIS"
/// 포괄손익계산서 - 연결 - 세후
case comprehensiveIncome1 = "CIS1"
/// 포괄손익계산서 - 개별 - 세후
case comprehensiveIncome2 = "CIS2"
/// 포괄손익계산서 - 연결 - 세전
case comprehensiveIncome3 = "CIS3"
/// 포괄손익계산서 - 개별 - 세전
case comprehensiveIncome4 = "CIS4"
/// 단일 포괄손익계산서
case singleComprehensiveIncome = "DCIS"
/// 단일 포괄손익계산서 - 연결 - 기능별분류 - 세후포괄손익
case singleComprehensiveIncome1 = "DCIS1"
/// 단일 포괄손익계산서 - 개별 - 기능별분류 - 세후포괄손익
case singleComprehensiveIncome2 = "DCIS2"
/// 단일 포괄손익계산서 - 연결 - 기능별분류 - 세전
case singleComprehensiveIncome3 = "DCIS3"
/// 단일 포괄손익계산서 - 개별 - 기능별분류 - 세전
case singleComprehensiveIncome4 = "DCIS4"
/// 단일 포괄손익계산서 - 연결 - 성격별분류 - 세후포괄손익
case singleComprehensiveIncome5 = "DCIS5"
/// 단일 포괄손익계산서 - 개별 - 성격별분류 - 세후포괄손익
case singleComprehensiveIncome6 = "DCIS6"
/// 단일 포괄손익계산서 - 연결 - 성격별분류 - 세전
case singleComprehensiveIncome7 = "DCIS7"
/// 단일 포괄손익계산서 - 개별 - 성격별분류 - 세전
case singleComprehensiveIncome8 = "DCIS8"
/// 현금흐름표
case cashFlow = "CF"
/// 현금흐름표 - 연결 - 직접법
case cashFlow1 = "CF1"
/// 현금흐름표 - 개별 - 직접법
case cashFlow2 = "CF2"
/// 현금흐름표 - 연결 - 간접법
case cashFlow3 = "CF3"
/// 현금흐름표 - 개별 - 간접법
case cashFlow4 = "CF4"
/// 자본변동표
case changesInEquity = "SCE"
/// 자본변동표 - 연결
case changesInEquity1 = "SCE1"
/// 자본변동표 - 개별
case changesInEquity2 = "SCE2"
}
}

956
KissMe/Sources/Domestic/DART/DomesticDartBusinessReport.swift
View File

File diff suppressed because it is too large Load Diff

391
KissMe/Sources/Domestic/DART/DomesticDartListedCompany.swift Normal file
View File

@@ -0,0 +1,391 @@
//
// DomesticDartListedCompany.swift
// KissMe
//
// Created by ened-book-m1 on 2023/07/10.
//
import Foundation
extension DomesticDart {
/// 상장기업 재무정보 - 1 단일회사 주요계정
///
public struct SingleAccountRequest: DartBalanceRequest {
public typealias KResult = AccountResult
public var url: String {
"/api/fnlttSinglAcnt.json"
}
public var result: KResult? = nil
public let openApiKey: String
public let corporationCode: String
public let businessYear: String
public let reportCode: ReportCode
public init(openApiKey: String, corporationCode: String, businessYear: String, reportCode: ReportCode) {
self.openApiKey = openApiKey
self.corporationCode = corporationCode
self.businessYear = businessYear
self.reportCode = reportCode
}
}
/// 상장기업 재무정보 - 2 다중회사 주요계정
///
public struct MultipleAccountRequest: DartBalanceRequest {
public typealias KResult = AccountResult
public var url: String {
"/api/fnlttMultiAcnt.json"
}
public var result: KResult? = nil
public let openApiKey: String
public let corporationCode: String
public let businessYear: String
public let reportCode: ReportCode
public init(openApiKey: String, corporationCode: String, businessYear: String, reportCode: ReportCode) {
self.openApiKey = openApiKey
self.corporationCode = corporationCode
self.businessYear = businessYear
self.reportCode = reportCode
}
}
/// 상장기업 재무정보 - 3 재무제표 원본파일(XBRL)
///
public struct XBRLRequest: DartRequest {
public typealias KResult = Data // Zip file
public var url: String {
"/api/fnlttXbrl.xml"
}
public var method: Method { .get }
public var header: [String : String?] {
[:]
}
public var body: [String: Any] {
return [
"crtfc_key": openApiKey,
"rcept_no": receiptNo,
"reprt_code": reportCode.rawValue,
]
}
public var result: KResult? = nil
public let openApiKey: String
public let receiptNo: String
public let reportCode: ReportCode
public init(openApiKey: String, receiptNo: String, reportCode: ReportCode) {
self.openApiKey = openApiKey
self.receiptNo = receiptNo
self.reportCode = reportCode
}
}
/// 상장기업 재무정보 - 4 단일회사 전체 재무제표
///
public struct SingleAccountAllFinancialStatementRequest: DartRequest {
public typealias KResult = SingleAccountAllFinancialStatementResult
public var url: String {
"/api/fnlttSinglAcntAll.json"
}
public var method: Method { .get }
public var header: [String : String?] {
[:]
}
public var body: [String: Any] {
return [
"crtfc_key": openApiKey,
"corp_code": corporationCode,
"bsns_year": businessYear,
"reprt_code": reportCode.rawValue,
"fs_div": financialStatementDivision.rawValue
]
}
public var result: KResult? = nil
public let openApiKey: String
let corporationCode: String
let businessYear: String
let reportCode: ReportCode
let financialStatementDivision: FinancialStatementDivision
public init(openApiKey: String, corporationCode: String, businessYear: String, reportCode: ReportCode, financialStatementDivision: FinancialStatementDivision) {
self.openApiKey = openApiKey
self.corporationCode = corporationCode
self.businessYear = businessYear
self.reportCode = reportCode
self.financialStatementDivision = financialStatementDivision
}
}
/// 상장기업 재무정보 - 5 XBRL택사노미재무제표양식
///
public struct XBRLTaxonomyRequest: DartRequest {
public typealias KResult = XBRLTaxonomyResult
public var url: String {
"/api/xbrlTaxonomy.json"
}
public var method: Method { .get }
public var header: [String : String?] {
[:]
}
public var body: [String: Any] {
return [
"crtfc_key": openApiKey,
"sj_div": statementDivision.rawValue,
]
}
public var result: KResult? = nil
public let openApiKey: String
let statementDivision: StatementDivision
init(openApiKey: String, statementDivision: StatementDivision) {
self.openApiKey = openApiKey
self.statementDivision = statementDivision
}
}
}
extension DomesticDart {
public struct AccountResult: Codable {
public let result: Result
public struct Result: Codable {
public let status: String
public let message: String
public let list: [Item]
private enum CodingKeys: String, CodingKey {
case status
case message
case list
}
}
public struct Item: Codable {
/// 접수번호
public let receiptNo: String
/// 사업연도
public let businessYear: String
/// 종목코드
public let productNo: String
/// 보고서 코드
public let reportCode: ReportCode
/// 계정명
public let accountName: String
/// 개별/연결구분
public let financialStatementDivision: String
/// 개별/연결명
public let financialStatementName: String
/// 재무제표구분
public let statementDivision: StatementDivision
/// 재무제표명
public let statementName: String
/// 당기명
public let thisTermName: String
/// 당기일자
public let thisTermDate: String
/// 당기금액
public let thisTermAmount: String
/// 당기누적금액
public let thisTermAccumulatedAmount: String
/// 전기명
public let formerTermName: String
/// 전기일자
public let formerTermDate: String
/// 전기금액
public let formerTermAmount: String
/// 전기누적금액
public let formerTermAccumulatedAmount: String
/// 전전기명
public let beforeFormerTermName: String
/// 전전기일자
public let beforeFormerTermDate: String
/// 전전기금액
public let beforeFormerTermAmount: String
/// 계정과목 정렬순서
public let order: String
/// 통화 단위
public let currency: String
private enum CodingKeys: String, CodingKey {
case receiptNo = "rcept_no"
case businessYear = "bsns_year"
case productNo = "stock_code"
case reportCode = "reprt_code"
case accountName = "account_nm"
case financialStatementDivision = "fs_div"
case financialStatementName = "fs_nm"
case statementDivision = "sj_div"
case statementName = "sj_nm"
case thisTermName = "thstrm_nm"
case thisTermDate = "thstrm_dt"
case thisTermAmount = "thstrm_amount"
case thisTermAccumulatedAmount = "thstrm_add_amount"
case formerTermName = "frmtrm_nm"
case formerTermDate = "frmtrm_dt"
case formerTermAmount = "frmtrm_amount"
case formerTermAccumulatedAmount = "frmtrm_add_amount"
case beforeFormerTermName = "bfefrmtrm_nm"
case beforeFormerTermDate = "bfefrmtrm_dt"
case beforeFormerTermAmount = "bfefrmtrm_amount"
case order = "ord"
case currency = "currency"
}
}
}
public struct SingleAccountAllFinancialStatementResult: Codable {
public let result: Result
public struct Result: Codable {
public let status: String
public let message: String
public let list: [Item]
private enum CodingKeys: String, CodingKey {
case status
case message
case list
}
}
public struct Item: Codable {
/// 접수번호
public let receiptNo: String
/// 보고서 코드
public let reportCode: ReportCode
/// 사업연도
public let businessYear: String
/// 고유번호
public let corporationCode: String
/// 재무제표구분
public let statementDivision: StatementDivision
/// 재무제표명
public let statementName: String
/// 계정ID
public let accountId: String
/// 계정명
public let accountName: String
/// 계정상세
public let accountDetail: String
/// 당기명
public let thisTermName: String
/// 당기금액
public let thisTermAmount: String
/// 당기누적금액
public let thisTermAccumulatedAmount: String
/// 전기명
public let formerTermName: String
/// 전기금액
public let formerTermAmount: String
/// 전기명(분/반기)
public let formerTermQuaterName: String
/// 전기금액(분/반기)
public let formerTermQuaterAmount: String
/// 전기누적금액
public let formerTermAccumulatedAmount: String
/// 전전기명
public let beforeFormerTermName: String
/// 전전기금액
public let beforeFormerTermAmount: String
/// 계정과목 정렬순서
public let order: String
/// 통화 단위
public let currency: String
private enum CodingKeys: String, CodingKey {
case receiptNo = "rcept_no"
case reportCode = "reprt_code"
case businessYear = "bsns_year"
case corporationCode = "corp_code"
case statementDivision = "sj_div"
case statementName = "sj_nm"
case accountId = "account_id"
case accountName = "account_nm"
case accountDetail = "account_detail"
case thisTermName = "thstrm_nm"
case thisTermAmount = "thstrm_amount"
case thisTermAccumulatedAmount = "thstrm_add_amount"
case formerTermName = "frmtrm_nm"
case formerTermAmount = "frmtrm_amount"
case formerTermQuaterName = "frmtrm_q_nm"
case formerTermQuaterAmount = "frmtrm_q_amount"
case formerTermAccumulatedAmount = "frmtrm_add_amount"
case beforeFormerTermName = "bfefrmtrm_nm"
case beforeFormerTermAmount = "bfefrmtrm_amount"
case order = "ord"
case currency = "currency"
}
}
}
public struct XBRLTaxonomyResult: Codable {
public let result: Result
public struct Result: Codable {
public let status: String
public let message: String
public let list: [Item]
private enum CodingKeys: String, CodingKey {
case status
case message
case list
}
}
public struct Item: Codable {
/// 재무제표구분
public let statementDivision: StatementDivision
/// 계정ID
public let accountId: String
/// 계정명
public let accountName: String
/// 기준일
public let businessDate: String
/// 한글 출력명
public let labelKorean: String
/// 영문 출력명
public let labelEnglish: String
/// 데이터 유형
public let dataType: String
/// IFRS Reference
public let ifrsReference: String
private enum CodingKeys: String, CodingKey {
case statementDivision = "sj_div"
case accountId = "account_id"
case accountName = "account_nm"
case businessDate = "bsns_de"
case labelKorean = "label_kor"
case labelEnglish = "label_eng"
case dataType = "data_tp"
case ifrsReference = "ifrs_ref"
}
}
}
}

16
KissMe/Sources/Domestic/DART/DomesticDartNotice.swift
View File

@@ -10,7 +10,7 @@ import Foundation
extension DomesticDart {
/// 공시정보 - 공시검색
/// 공시정보 - 1 공시검색
///
public struct NoticeListRequest: DartRequest {
public typealias KResult = NoticeListResult
@@ -62,7 +62,7 @@ extension DomesticDart {
}
/// 공시정보 - 기업개황
/// 공시정보 - 2 기업개황
///
public struct CompanyRequest: DartRequest {
public typealias KResult = CompanyResult
@@ -94,7 +94,7 @@ extension DomesticDart {
}
/// 공시정보 - 공시서류원본파일
/// 공시정보 - 3 공시서류원본파일
///
public struct DocumentRequest: DartRequest {
public typealias KResult = Data
@@ -126,7 +126,7 @@ extension DomesticDart {
}
/// 공시정보 - 고유번호
/// 공시정보 - 4 고유번호
///
public struct CorporationCodesRequest: DartRequest {
public typealias KResult = CorporationCodesResult
@@ -230,7 +230,7 @@ extension DomesticDart {
/// 종목명(상장사) 또는 약식명칭(기타법인)
public let stockName: String
/// 상장회사인 경우 주식의 종목코드
public let productCode: String
public let productNo: String
/// 대표자명
public let ceoName: String
/// 법인구분
@@ -263,7 +263,7 @@ extension DomesticDart {
case corporationName = "corp_name"
case englishCorporationName = "corp_name_eng"
case stockName = "stock_name"
case productCode = "stock_code"
case productNo = "stock_code"
case ceoName = "ceo_nm"
case marketType = "corp_cls"
case corporationNo = "jurir_no"
@@ -302,14 +302,14 @@ extension DomesticDart {
/// 정식명칭
public let corporationName: String
/// 종목코드
public let productCode: String
public let productNo: String
/// 최종변경일자
public let modifyDate: String
private enum CodingKeys: String, CodingKey {
case corporationCode = "corp_code"
case corporationName = "corp_name"
case productCode = "stock_code"
case productNo = "stock_code"
case modifyDate = "modify_date"
}
}

2
bin/data

Submodule bin/data updated: b0a2e701b7...18519a34fd

4
projects/macos/KissMe.xcodeproj/project.pbxproj
View File

@@ -43,6 +43,7 @@
34C1BA4F2A5A603F00423D64 /* DomesticExtra.swift in Sources */ = {isa = PBXBuildFile; fileRef = 34C1BA4E2A5A603F00423D64 /* DomesticExtra.swift */; };
34C1BA512A5A607D00423D64 /* DomesticDart.swift in Sources */ = {isa = PBXBuildFile; fileRef = 34C1BA502A5A607D00423D64 /* DomesticDart.swift */; };
34C1BA532A5A683D00423D64 /* DomesticDartBusinessReport.swift in Sources */ = {isa = PBXBuildFile; fileRef = 34C1BA522A5A683D00423D64 /* DomesticDartBusinessReport.swift */; };
34C1BA552A5B033E00423D64 /* DomesticDartListedCompany.swift in Sources */ = {isa = PBXBuildFile; fileRef = 34C1BA542A5B033E00423D64 /* DomesticDartListedCompany.swift */; };
34D3680F2A2AA0BE005E6756 /* PropertyIterable.swift in Sources */ = {isa = PBXBuildFile; fileRef = 34D3680E2A2AA0BE005E6756 /* PropertyIterable.swift */; };
34E7B9112A49BD2800B3AB9F /* DomesticIndex.swift in Sources */ = {isa = PBXBuildFile; fileRef = 34E7B9102A49BD2800B3AB9F /* DomesticIndex.swift */; };
34F1900C2A41982A0068C697 /* KissIndexResult.swift in Sources */ = {isa = PBXBuildFile; fileRef = 34F1900B2A41982A0068C697 /* KissIndexResult.swift */; };
@@ -98,6 +99,7 @@
34C1BA4E2A5A603F00423D64 /* DomesticExtra.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DomesticExtra.swift; sourceTree = "<group>"; };
34C1BA502A5A607D00423D64 /* DomesticDart.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DomesticDart.swift; sourceTree = "<group>"; };
34C1BA522A5A683D00423D64 /* DomesticDartBusinessReport.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DomesticDartBusinessReport.swift; sourceTree = "<group>"; };
34C1BA542A5B033E00423D64 /* DomesticDartListedCompany.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DomesticDartListedCompany.swift; sourceTree = "<group>"; };
34D3680E2A2AA0BE005E6756 /* PropertyIterable.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PropertyIterable.swift; sourceTree = "<group>"; };
34E7B9102A49BD2800B3AB9F /* DomesticIndex.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DomesticIndex.swift; sourceTree = "<group>"; };
34F1900B2A41982A0068C697 /* KissIndexResult.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = KissIndexResult.swift; sourceTree = "<group>"; };
@@ -237,6 +239,7 @@
34C1BA502A5A607D00423D64 /* DomesticDart.swift */,
34C1BA4C2A59CD3400423D64 /* DomesticDartNotice.swift */,
34C1BA522A5A683D00423D64 /* DomesticDartBusinessReport.swift */,
34C1BA542A5B033E00423D64 /* DomesticDartListedCompany.swift */,
);
path = DART;
sourceTree = "<group>";
@@ -388,6 +391,7 @@
340A4DCE2A4EA5D8005A1FBA /* Runner.swift in Sources */,
341F5F0B2A15115400962D48 /* KissShop.swift in Sources */,
3435A7F72A35D82000D604F1 /* DomesticShortSelling.swift in Sources */,
34C1BA552A5B033E00423D64 /* DomesticDartListedCompany.swift in Sources */,
341F5F072A14634F00962D48 /* Foundation+Extensions.swift in Sources */,
341F5F032A11A2BC00962D48 /* Credential.swift in Sources */,
341F5EB02A0A80EC00962D48 /* KissMe.docc in Sources */,