apick-api 4.8.2 → 4.12.1

package/package.json

@@ -1,71 +1,71 @@
-{
-  "name": "apick-api",
-  "version": "4.8.2",
-  "description": "Official zero-dependency Node.js client for APICK data, AI, and image APIs. 에이픽 데이터·AI·이미지 API 공식 Node.js SDK.",
-  "type": "module",
-  "main": "./src/index.cjs",
-  "module": "./src/index.js",
-  "types": "./src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js",
-      "require": "./src/index.cjs"
-    }
-  },
-  "files": [
-    "src",
-    "docs",
-    "examples",
-    "README.md",
-    "CHANGELOG.md",
-    "SECURITY.md",
-    "LICENSE"
-  ],
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "test": "node --test && npm run test:types",
-    "test:types": "tsc -p tsconfig.json",
-    "test:coverage": "node --test --experimental-test-coverage",
-    "prepublishOnly": "npm test"
-  },
-  "devDependencies": {
-    "typescript": "^7.0.2"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lead788/apick-api.git"
-  },
-  "bugs": {
-    "url": "https://github.com/lead788/apick-api/issues"
-  },
-  "homepage": "https://apick.app/dev_guide",
-  "license": "MIT",
-  "author": "APICK",
-  "publishConfig": {
-    "access": "public",
-    "provenance": false
-  },
-  "keywords": [
-    "apick",
-    "api",
-    "sdk",
-    "korea",
-    "korean-api",
-    "business-registry",
-    "parcel-tracking",
-    "address",
-    "ocr",
-    "whois",
-    "dns",
-    "google-search",
-    "pdf",
-    "excel",
-    "tts-jobs",
-    "text-summary",
-    "image-generation"
-  ]
-}
+{
+  "name": "apick-api",
+  "version": "4.12.1",
+  "description": "Official zero-dependency Node.js client for APICK data, AI, and image APIs. 에이픽 데이터·AI·이미지 API 공식 Node.js SDK.",
+  "type": "module",
+  "main": "./src/index.cjs",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./src/index.cjs"
+    }
+  },
+  "files": [
+    "src",
+    "docs",
+    "examples",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test && npm run test:types",
+    "test:types": "tsc -p tsconfig.json",
+    "test:coverage": "node --test --experimental-test-coverage",
+    "prepublishOnly": "npm test"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lead788/apick-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lead788/apick-api/issues"
+  },
+  "homepage": "https://apick.app/dev_guide",
+  "license": "MIT",
+  "author": "APICK",
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "keywords": [
+    "apick",
+    "api",
+    "sdk",
+    "korea",
+    "korean-api",
+    "business-registry",
+    "parcel-tracking",
+    "address",
+    "ocr",
+    "whois",
+    "dns",
+    "google-search",
+    "pdf",
+    "excel",
+    "tts-jobs",
+    "text-summary",
+    "image-generation"
+  ]
+}

package/src/index.cjs

@@ -16,6 +16,13 @@ const AUTH_PROVIDERS = Object.freeze([
 	'kakao', 'naver', 'toss', 'pass', 'samsung', 'kb', 'shinhan', 'hana', 'woori', 'ibk', 'nh', 'kakaobank', 'banksalad'
 ]);
 const AUTH_PROVIDER_SET = new Set(AUTH_PROVIDERS);
+// 정부24 통합 조회에서 고를 수 있는 상품 키. 서버 공개 목록과 같다.
+const GOV24_BUNDLE_PRODUCTS = Object.freeze([
+	'resident_registration', 'resident_registration_cho', 'driving_license', 'health_checkup',
+	'police_penalty', 'parking_fine_target', 'mortgage_loan', 'housing_refund_balance',
+	'housing_pension_balance', 'housing_loan_stage', 'mortgage_application', 'confirm_verify', 'power_bill'
+]);
+const GOV24_BUNDLE_PRODUCT_SET = new Set(GOV24_BUNDLE_PRODUCTS);
 
 const SERVICE_DEFINITIONS = Object.freeze({
 	businessDetails: { endpoint: '/rest/biz_detail', timeoutMs: 50_000, output: 'json' },
@@ -53,6 +60,12 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	linkedinProfile: { endpoint: '/rest/linkedin_profile', timeoutMs: 110_000, output: 'json' },
 	linkedinCompany: { endpoint: '/rest/linkedin_company', timeoutMs: 110_000, output: 'json' },
 	linkedinJob: { endpoint: '/rest/linkedin_job', timeoutMs: 110_000, output: 'json' },
+	courtAuction: { endpoint: '/rest/court_auction', timeoutMs: 45_000, output: 'json' },
+	bidNotice: { endpoint: '/rest/bid_notice', timeoutMs: 45_000, output: 'json' },
+	bidAward: { endpoint: '/rest/bid_award', timeoutMs: 45_000, output: 'json' },
+	rtmsTrade: { endpoint: '/rest/rtms_trade', timeoutMs: 45_000, output: 'json' },
+	rtmsRent: { endpoint: '/rest/rtms_rent', timeoutMs: 45_000, output: 'json' },
+	registryDocVerify: { endpoint: '/rest/registry_doc_verify', timeoutMs: 30_000, output: 'json' },
 	screenshot: { endpoint: '/rest/url_screenshot', timeoutMs: 75_000, output: 'binary', filename: 'screenshot.jpeg' },
 	youtubeMetadata: { endpoint: '/rest/youtube_metadata', timeoutMs: 60_000, output: 'json' },
 	youtubeThumbnail: { endpoint: '/rest/youtube_thumbnail', timeoutMs: 60_000, output: 'binary', filename: 'thumbnail.jpg' },
@@ -78,7 +91,20 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	requestDrivingLicense: { endpoint: '/rest/req_driving_license', timeoutMs: 35_000, output: 'json' },
 	requestHealthCheckup: { endpoint: '/rest/req_health_checkup', timeoutMs: 35_000, output: 'json' },
 	requestCashReceiptDeduction: { endpoint: '/rest/req_cash_receipt_deduction', timeoutMs: 35_000, output: 'json' },
-	requestTaxReturnHistory: { endpoint: '/rest/req_tax_return_history', timeoutMs: 35_000, output: 'json' }
+	requestTaxReturnHistory: { endpoint: '/rest/req_tax_return_history', timeoutMs: 35_000, output: 'json' },
+	requestIncomeAmountCert: { endpoint: '/rest/req_income_amount_cert', timeoutMs: 60_000, output: 'json' },
+	requestPensionCreditCert: { endpoint: '/rest/req_pension_credit_cert', timeoutMs: 60_000, output: 'json' },
+	requestFactCert: { endpoint: '/rest/req_fact_cert', timeoutMs: 60_000, output: 'json' },
+	requestTaxClearanceCert: { endpoint: '/rest/req_tax_clearance_cert', timeoutMs: 60_000, output: 'json' },
+	requestIncomeCertBundle: { endpoint: '/rest/req_income_cert_bundle', timeoutMs: 60_000, output: 'json' },
+	requestBusinessCertBundle: { endpoint: '/rest/req_business_cert_bundle', timeoutMs: 60_000, output: 'json' },
+	requestBusinessRegistrationCert: { endpoint: '/rest/req_business_registration_cert', timeoutMs: 60_000, output: 'json' },
+	requestVatTaxBaseCert: { endpoint: '/rest/req_vat_tax_base_cert', timeoutMs: 60_000, output: 'json' },
+	requestFinancialStatementCert: { endpoint: '/rest/req_financial_statement_cert', timeoutMs: 60_000, output: 'json' },
+	requestClosureCert: { endpoint: '/rest/req_closure_cert', timeoutMs: 60_000, output: 'json' },
+	requestResidentRegistration: { endpoint: '/rest/req_resident_registration', timeoutMs: 35_000, output: 'json' },
+	requestResidentRegistrationCho: { endpoint: '/rest/req_resident_registration_cho', timeoutMs: 35_000, output: 'json' },
+	requestGov24Bundle: { endpoint: '/rest/req_gov24_bundle', timeoutMs: 35_000, output: 'json' }
 });
 
 const SERVICES = Object.freeze(Object.fromEntries(
@@ -151,6 +177,57 @@ function normalizeBusinessNumber(value) {
 	return normalized;
 }
 
+const BID_BIZ_TYPES = ['물품', '공사', '용역', '외자'];
+const RTMS_PROPERTY_TYPES = ['apt', 'rh', 'sh', 'offi'];
+
+// 입찰공고·낙찰 조회 입력. bizType·기간·공고번호·업종코드·페이지를 정규화한다.
+function bidQueryInput(options) {
+	const config = options || {};
+	const input = {};
+	if (config.bizType !== undefined) {
+		if (!BID_BIZ_TYPES.includes(config.bizType)) {
+			throw new TypeError('bizType must be one of 물품, 공사, 용역, 외자.');
+		}
+		input.bizType = config.bizType;
+	}
+	for (const key of ['startDate', 'endDate']) {
+		if (config[key] === undefined) continue;
+		const digits = requiredString(key, config[key], 12).replace(/[^0-9]/g, '');
+		if (digits.length !== 8 && digits.length !== 12) {
+			throw new TypeError(`${key} must be YYYYMMDD or YYYYMMDDHHMM.`);
+		}
+		input[key] = digits;
+	}
+	if (config.bidNtceNo !== undefined) {
+		input.bidNtceNo = requiredString('bidNtceNo', config.bidNtceNo, 20).replace(/[^0-9]/g, '');
+	}
+	if (config.indstrytyCd !== undefined) {
+		input.indstrytyCd = requiredString('indstrytyCd', config.indstrytyCd, 10).replace(/[^0-9]/g, '');
+	}
+	if (config.pageNo !== undefined) input.pageNo = positiveInteger('pageNo', config.pageNo);
+	if (config.numOfRows !== undefined) input.numOfRows = positiveInteger('numOfRows', config.numOfRows);
+	return input;
+}
+
+// 실거래 분석 입력. 지역코드 5자리와 계약년월 6자리를 요구한다.
+function rtmsQueryInput(lawdCd, dealYmd, options) {
+	const code = requiredString('lawdCd', lawdCd, 5).replace(/[^0-9]/g, '');
+	if (!/^\d{5}$/.test(code)) throw new TypeError('lawdCd must contain exactly 5 digits.');
+	const month = requiredString('dealYmd', dealYmd, 6).replace(/[^0-9]/g, '');
+	if (!/^\d{6}$/.test(month)) throw new TypeError('dealYmd must be YYYYMM.');
+	const config = options || {};
+	const input = { lawdCd: code, dealYmd: month };
+	if (config.propertyType !== undefined) {
+		if (!RTMS_PROPERTY_TYPES.includes(config.propertyType)) {
+			throw new TypeError('propertyType must be one of apt, rh, sh, offi.');
+		}
+		input.propertyType = config.propertyType;
+	}
+	if (config.pageNo !== undefined) input.pageNo = positiveInteger('pageNo', config.pageNo);
+	if (config.numOfRows !== undefined) input.numOfRows = positiveInteger('numOfRows', config.numOfRows);
+	return input;
+}
+
 function normalizeUrl(value) {
 	const input = requiredString('url', value);
 	let parsed;
@@ -241,6 +318,81 @@ function dataRequestInput(input) {
 	};
 }
 
+// 홈택스 민원증명. 발급 조건은 REST 필드명 그대로 보낸다(서버가 최상위 평면 이름을 읽는다).
+// 공통 인증 입력(name·birthDate·phone·authProvider)은 dataRequestInput 이 만든다.
+const INCOME_AMOUNT_CERT_OPTIONS = Object.freeze(['year', 'use_purpose', 'submit_to', 'delivery', 'format', 'engl_yn', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const PENSION_CREDIT_CERT_OPTIONS = Object.freeze(['year', 'use_purpose', 'submit_to', 'delivery', 'format', 'address_open_yn', 'resno_open_yn', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const FACT_CERT_OPTIONS = Object.freeze(['year', 'start_month', 'end_month', 'itrf_cd', 'issuance', 'engl_yn', 'use_purpose', 'submit_to', 'delivery', 'format', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const TAX_CLEARANCE_CERT_OPTIONS = Object.freeze(['cert_type', 'year', 'start_month', 'end_month', 'itrf_cd', 'issuance', 'submit_to', 'delivery', 'format', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const BUSINESS_REGISTRATION_CERT_OPTIONS = Object.freeze(['business_no', 'engl_yn', 'use_purpose', 'submit_to', 'delivery', 'format', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const VAT_TAX_BASE_CERT_OPTIONS = Object.freeze(['business_no', 'year', 'period', 'engl_yn', 'use_purpose', 'submit_to', 'delivery', 'format', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const FINANCIAL_STATEMENT_CERT_OPTIONS = Object.freeze(['business_no', 'year', 'engl_yn', 'use_purpose', 'submit_to', 'delivery', 'format', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const CLOSURE_CERT_OPTIONS = Object.freeze(['business_no', 'engl_yn', 'use_purpose', 'submit_to', 'delivery', 'format', 'quantity', 'email', 'fax_no', 'wallet_address']);
+
+// 증빙서류 묶음. 승인 한 번으로 담긴 증명을 함께 발급하며 담긴 증명이 같은 발급 입력을 공유한다.
+const INCOME_CERT_BUNDLE_OPTIONS = Object.freeze(['year', 'use_purpose', 'submit_to', 'delivery', 'format', 'amount_open_yn', 'income_source_open_yn', 'withholding_all_print_yn', 'address_open_yn', 'resno_open_yn', 'quantity', 'email', 'fax_no', 'wallet_address']);
+const BUSINESS_CERT_BUNDLE_OPTIONS = Object.freeze(['year', 'period', 'engl_yn', 'use_purpose', 'submit_to', 'delivery', 'format', 'quantity', 'email', 'fax_no', 'wallet_address', 'bind_id']);
+
+function hometaxCertInput(input, keys) {
+	const config = input || {};
+	const payload = dataRequestInput(config);
+	keys.forEach(function (key) {
+		const value = config[key];
+		if (value === undefined || value === null || value === '') return;
+		payload[key] = String(value);
+	});
+	if (payload.format === undefined) payload.format = 'both';
+	return payload;
+}
+
+// 사업자 증빙서류 묶음은 대표자 본인 확인을 받는다. bind_id 가 없으면 agreed=true 가 있어야
+// 서버가 접수하므로, 빠진 요청은 서버를 부르기 전에 막는다.
+function businessCertBundleInput(input) {
+	const config = input || {};
+	const payload = hometaxCertInput(config, BUSINESS_CERT_BUNDLE_OPTIONS);
+	payload.business_no = normalizeBusinessNumber(config.business_no);
+	if (config.agreed === true) payload.agreed = 'true';
+	else if (config.agreed !== undefined && config.agreed !== false) throw new TypeError('agreed must be a boolean.');
+	if (!payload.bind_id && payload.agreed !== 'true') {
+		throw new TypeError('agreed must be true when bind_id is not provided.');
+	}
+	return payload;
+}
+
+// 주민등록표 발급은 주민등록 주소지(시도·시군구)로 처리기관을 정한다. 서버가 이 값을 필수로 본다.
+function residentAddressInput(config) {
+	return {
+		sido: requiredString('sido', config.sido, 40),
+		sigungu: requiredString('sigungu', config.sigungu, 40)
+	};
+}
+
+// 등본·초본의 선택 입력. Y/N 은 서버가 그대로 해석하므로 다른 값은 보내지 않는다.
+function residentOptionsInput(config, payload) {
+	const purposeCd = optionalText('purposeCd', config.purposeCd, 8);
+	if (purposeCd !== undefined) payload.purposeCd = purposeCd;
+	const submitTarget = optionalText('submitTarget', config.submitTarget, 100);
+	if (submitTarget !== undefined) payload.submitTarget = submitTarget;
+	const includeAddressHistory = optionalChoice('includeAddressHistory', config.includeAddressHistory, ['Y', 'N']);
+	if (includeAddressHistory !== undefined) payload.includeAddressHistory = includeAddressHistory;
+	const includeHousehold = optionalChoice('includeHousehold', config.includeHousehold, ['Y', 'N']);
+	if (includeHousehold !== undefined) payload.includeHousehold = includeHousehold;
+	return payload;
+}
+
+// 통합 조회는 고른 상품 키를 쉼표로 이어 보낸다. 서버는 배열과 쉼표 문자열을 모두 받는다.
+function gov24BundleProductsInput(value) {
+	const list = Array.isArray(value) ? value : String(value === undefined || value === null ? '' : value).split(',');
+	const keys = list.map(function(item) { return String(item).trim(); }).filter(Boolean);
+	if (!keys.length) throw new TypeError('products must select at least one product key.');
+	keys.forEach(function(key) {
+		if (!GOV24_BUNDLE_PRODUCT_SET.has(key)) {
+			throw new RangeError(`products contains an unsupported key: ${key}.`);
+		}
+	});
+	return Array.from(new Set(keys)).join(',');
+}
+
 const SKILL_CATEGORIES = Object.freeze(['data', 'ai', 'dev', 'document', 'marketing', 'finance', 'productivity', 'video', 'etc']);
 const SKILL_CATEGORY_SET = new Set(SKILL_CATEGORIES);
 const SKILL_SORTS = Object.freeze(['recommended', 'popular', 'used', 'likes', 'rating', 'new', 'mine', 'liked']);
@@ -715,6 +867,42 @@ class ApickClient {
 		return this._call('linkedinJob', linkedinInput(url));
 	}
 
+	// 법원 경매사건. 사건번호와 법원(이름 또는 법원 코드)이 함께 필요하다.
+	courtAuction(caseNo, court) {
+		return this._call('courtAuction', {
+			case_no: requiredString('caseNo', caseNo, 64),
+			court: requiredString('court', court, 64)
+		});
+	}
+
+	// 등기사항증명서 등 발급확인. issueNo 는 증명서에 인쇄된 발급확인번호 12자리다.
+	registryDocVerify(issueNo, options) {
+		const config = options || {};
+		const input = { issue_no: requiredString('issueNo', issueNo, 32) };
+		if (config.kind !== undefined) input.kind = requiredString('kind', config.kind, 16);
+		return this._call('registryDocVerify', input);
+	}
+
+	// 입찰공고 분석. bizType 미지정 시 용역이며, 기간은 최대 31일이다.
+	bidNotice(options) {
+		return this._call('bidNotice', bidQueryInput(options));
+	}
+
+	// 낙찰 경쟁 분석. 입력은 bidNotice 와 같다.
+	bidAward(options) {
+		return this._call('bidAward', bidQueryInput(options));
+	}
+
+	// 매매 실거래 분석. 지역코드 5자리와 계약년월 6자리가 필요하다.
+	rtmsTrade(lawdCd, dealYmd, options) {
+		return this._call('rtmsTrade', rtmsQueryInput(lawdCd, dealYmd, options));
+	}
+
+	// 전월세 실거래 분석. 같은 단지 매매가로 전세가율을 계산해 돌려준다.
+	rtmsRent(lawdCd, dealYmd, options) {
+		return this._call('rtmsRent', rtmsQueryInput(lawdCd, dealYmd, options));
+	}
+
 	screenshot(url) {
 		return this._call('screenshot', { url: normalizeUrl(url) });
 	}
@@ -1125,6 +1313,134 @@ class ApickClient {
 		return this._call('requestTaxReturnHistory', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_tax_return_history' });
 	}
 
+	// 홈택스 민원증명 발급. 신청인 본인명의이고 발급 1건 60P 정액이다.
+	// 응답은 format(pdf·json·both)으로 고른다. json 이면 발급된 PDF를 파싱한 PDF데이터가 함께 온다.
+	requestIncomeAmountCert(input) {
+		return this._call('requestIncomeAmountCert', hometaxCertInput(input, INCOME_AMOUNT_CERT_OPTIONS));
+	}
+
+	getIncomeAmountCert(transactionId) {
+		return this._call('requestIncomeAmountCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_income_amount_cert' });
+	}
+
+	requestPensionCreditCert(input) {
+		return this._call('requestPensionCreditCert', hometaxCertInput(input, PENSION_CREDIT_CERT_OPTIONS));
+	}
+
+	getPensionCreditCert(transactionId) {
+		return this._call('requestPensionCreditCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_pension_credit_cert' });
+	}
+
+	requestFactCert(input) {
+		return this._call('requestFactCert', hometaxCertInput(input, FACT_CERT_OPTIONS));
+	}
+
+	getFactCert(transactionId) {
+		return this._call('requestFactCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_fact_cert' });
+	}
+
+	requestTaxClearanceCert(input) {
+		return this._call('requestTaxClearanceCert', hometaxCertInput(input, TAX_CLEARANCE_CERT_OPTIONS));
+	}
+
+	getTaxClearanceCert(transactionId) {
+		return this._call('requestTaxClearanceCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_tax_clearance_cert' });
+	}
+
+	// 소득 증빙서류 통합발급. 소득금액증명·연금보험료등 소득세액 공제확인서를 승인 한 번으로 발급한다.
+	// 결과는 result.incomeAmountCert·result.pensionCreditCert 로 나뉘어 온다. 접수 20P, 최초 결과 84P.
+	requestIncomeCertBundle(input) {
+		return this._call('requestIncomeCertBundle', hometaxCertInput(input, INCOME_CERT_BUNDLE_OPTIONS));
+	}
+
+	getIncomeCertBundle(transactionId) {
+		return this._call('requestIncomeCertBundle', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_income_cert_bundle' });
+	}
+
+	// 사업자 증빙서류 통합발급. 사업자등록증명·부가가치세 과세표준증명·표준재무제표증명을 함께 발급한다.
+	// 결과는 result.businessRegistrationCert·vatTaxBaseCert·financialStatementCert 로 나뉜다. 최초 결과 126P.
+	requestBusinessCertBundle(input) {
+		return this._call('requestBusinessCertBundle', businessCertBundleInput(input));
+	}
+
+	getBusinessCertBundle(transactionId) {
+		return this._call('requestBusinessCertBundle', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_business_cert_bundle' });
+	}
+
+	// 사업자 단위 증명. business_no 는 증명 대상 사업자등록번호 10자리다.
+	requestBusinessRegistrationCert(input) {
+		return this._call('requestBusinessRegistrationCert', hometaxCertInput(input, BUSINESS_REGISTRATION_CERT_OPTIONS));
+	}
+
+	getBusinessRegistrationCert(transactionId) {
+		return this._call('requestBusinessRegistrationCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_business_registration_cert' });
+	}
+
+	requestVatTaxBaseCert(input) {
+		return this._call('requestVatTaxBaseCert', hometaxCertInput(input, VAT_TAX_BASE_CERT_OPTIONS));
+	}
+
+	getVatTaxBaseCert(transactionId) {
+		return this._call('requestVatTaxBaseCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_vat_tax_base_cert' });
+	}
+
+	requestFinancialStatementCert(input) {
+		return this._call('requestFinancialStatementCert', hometaxCertInput(input, FINANCIAL_STATEMENT_CERT_OPTIONS));
+	}
+
+	getFinancialStatementCert(transactionId) {
+		return this._call('requestFinancialStatementCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_financial_statement_cert' });
+	}
+
+	requestClosureCert(input) {
+		return this._call('requestClosureCert', hometaxCertInput(input, CLOSURE_CERT_OPTIONS));
+	}
+
+	getClosureCert(transactionId) {
+		return this._call('requestClosureCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_closure_cert' });
+	}
+
+	// 주민등록표 등본·초본 발급. 건당 80P 정액이고 결과에 PDF 원본(base64)·해시가 함께 온다.
+	requestResidentRegistration(input) {
+		const config = input || {};
+		const payload = Object.assign(dataRequestInput(config), residentAddressInput(config));
+		residentOptionsInput(config, payload);
+		return this._call('requestResidentRegistration', payload);
+	}
+
+	getResidentRegistration(transactionId) {
+		return this._call('requestResidentRegistration', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_resident_registration' });
+	}
+
+	requestResidentRegistrationCho(input) {
+		const config = input || {};
+		const payload = Object.assign(dataRequestInput(config), residentAddressInput(config));
+		residentOptionsInput(config, payload);
+		return this._call('requestResidentRegistrationCho', payload);
+	}
+
+	getResidentRegistrationCho(transactionId) {
+		return this._call('requestResidentRegistrationCho', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_resident_registration_cho' });
+	}
+
+	// 정부24 통합 조회. 한 번의 인증으로 고른 상품만 조회하고, 단가는 고른 상품의 합으로 정해진다.
+	requestGov24Bundle(input) {
+		const config = input || {};
+		const products = gov24BundleProductsInput(config.products);
+		const payload = dataRequestInput(config);
+		payload.products = products;
+		// 등본·초본을 고를 때만 주민등록 주소지가 필요하다.
+		if (products.split(',').some(function(key) { return key.indexOf('resident_registration') === 0; })) {
+			Object.assign(payload, residentAddressInput(config));
+			residentOptionsInput(config, payload);
+		}
+		return this._call('requestGov24Bundle', payload);
+	}
+
+	getGov24Bundle(transactionId) {
+		return this._call('requestGov24Bundle', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_gov24_bundle' });
+	}
+
 	// Skills: 요청·응답이 모두 JSON 이고 data·api 봉투 없이 응답 항목이 최상위에 온다.
 	// 오류는 { error: { code, message, details } } 형식이며 code 를 serviceCode 로 돌려준다.
 	async _skills(method, path, options) {
@@ -1314,6 +1630,7 @@ module.exports = {
 	SERVICES,
 	TTS_VOICE_IDS,
 	AUTH_PROVIDERS,
+	GOV24_BUNDLE_PRODUCTS,
 	SKILL_CATEGORIES,
 	SKILL_SORTS,
 	DEFAULT_BASE_URL