apick-api 4.8.1 → 4.11.0

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,8 @@ 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' },
+	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 +87,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(
@@ -241,6 +263,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 +812,22 @@ 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);
+	}
+
 	screenshot(url) {
 		return this._call('screenshot', { url: normalizeUrl(url) });
 	}
@@ -1125,6 +1238,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 +1555,7 @@ module.exports = {
 	SERVICES,
 	TTS_VOICE_IDS,
 	AUTH_PROVIDERS,
+	GOV24_BUNDLE_PRODUCTS,
 	SKILL_CATEGORIES,
 	SKILL_SORTS,
 	DEFAULT_BASE_URL

package/src/index.d.ts

@@ -246,6 +246,57 @@ export interface LinkedinCompany {
 	readonly updates: readonly { readonly title: string; readonly link: string; readonly date: string; readonly text: string }[];
 }
 
+export interface CourtAuctionItem {
+	readonly itemNo: number | null;
+	readonly address: string;
+	readonly propertyKind: string;
+	readonly appraisedPrice: number | null;
+	readonly minimumPrice: number | null;
+	readonly failedCount: number;
+	readonly saleDate: string;
+	readonly saleTime: string;
+	readonly depositRate: number | null;
+}
+
+export interface CourtAuction {
+	readonly result: number;
+	readonly msg: string;
+	readonly success: number;
+	readonly case: {
+		readonly caseNo: string;
+		readonly court: string;
+		readonly caseName: string;
+		readonly receivedAt: string;
+		readonly claimAmount: number | null;
+		readonly judgeDept: string;
+		readonly judgeDeptTel: string;
+		readonly executorTel: string;
+		readonly auctionStatus: string;
+		readonly completedAt: string;
+		readonly suspended: boolean;
+		readonly suspensionReason: string;
+	};
+	readonly items: readonly CourtAuctionItem[];
+	readonly saleSchedule: readonly {
+		readonly saleDate: string;
+		readonly saleTime: string;
+		readonly items: readonly { readonly itemNo: number | null; readonly minimumPrice: number | null }[];
+	}[];
+	readonly claimDeadline: string;
+	readonly relatedCases: readonly { readonly caseNo: string; readonly court: string; readonly kind: string }[];
+	readonly count: number;
+}
+
+export interface RegistryDocVerify {
+	readonly verified: boolean;
+	readonly status: 'confirmed' | 'not_found' | 'count_exhausted' | 'invalid_format' | 'not_opened' | 'unknown';
+	readonly message: string;
+	readonly kind: 'realestate' | 'corporate' | 'movable';
+	readonly document: string | null;
+	readonly issued_date: string | null;
+	readonly registry_office: string | null;
+}
+
 export interface LinkedinJob {
 	readonly job_posting_id: string;
 	readonly title: string;
@@ -359,6 +410,12 @@ export interface MaskResidentNumberOptions extends OcrOptions {
 export const AUTH_PROVIDERS: readonly [
 	'kakao', 'naver', 'toss', 'pass', 'samsung', 'kb', 'shinhan', 'hana', 'woori', 'ibk', 'nh', 'kakaobank', 'banksalad'
 ];
+/** 정부24 통합 조회에서 고를 수 있는 상품 키. */
+export const GOV24_BUNDLE_PRODUCTS: readonly [
+	'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'
+];
 export type AuthProvider = typeof AUTH_PROVIDERS[number];
 
 /** 간편인증 기반 조회 상품(재직·소득·연금·면허·건강검진 등)의 공통 입력. */
@@ -377,6 +434,109 @@ export interface RequestDrivingLicenseInput extends DataRequestInput {}
 export interface RequestHealthCheckupInput extends DataRequestInput {}
 export interface RequestCashReceiptDeductionInput extends DataRequestInput { incomeYears?: number; }
 export interface RequestTaxReturnHistoryInput extends DataRequestInput { years?: number; }
+/** 주민등록표 발급 공통 입력. `sido`·`sigungu` 는 주민등록 주소지다. */
+export interface ResidentRegistrationOptions {
+	sido: string;
+	sigungu: string;
+	purposeCd?: string;
+	submitTarget?: string;
+	includeAddressHistory?: 'Y' | 'N';
+	includeHousehold?: 'Y' | 'N';
+}
+export interface RequestResidentRegistrationInput extends DataRequestInput, ResidentRegistrationOptions {}
+export interface RequestResidentRegistrationChoInput extends DataRequestInput, ResidentRegistrationOptions {}
+/**
+ * 정부24 통합 조회 입력. `products` 로 조회할 상품 키를 고른다.
+ * 등본·초본을 고르면 `sido`·`sigungu` 가 필요하다.
+ */
+export interface RequestGov24BundleInput extends DataRequestInput {
+	products: string[] | string;
+	sido?: string;
+	sigungu?: string;
+	purposeCd?: string;
+	submitTarget?: string;
+	includeAddressHistory?: 'Y' | 'N';
+	includeHousehold?: 'Y' | 'N';
+}
+
+/**
+ * 홈택스 민원증명 발급 조건. 신청인 본인명의 발급이고 발급 1건 60P 정액이다.
+ * `format` 은 응답 형식이고, `json`·`both` 이면 발급된 PDF를 파싱한 `PDF데이터` 가 함께 온다.
+ * 코드 값(`use_purpose`·`submit_to`·`itrf_cd`)은 정부 공통코드다.
+ */
+export interface HometaxCertificateOptions extends DataRequestInput {
+	year?: string;
+	use_purpose?: string;
+	submit_to?: string;
+	delivery?: '06' | '10' | '04' | '12';
+	format?: 'pdf' | 'json' | 'both';
+	engl_yn?: 'Y' | 'N';
+	quantity?: number;
+	email?: string;
+	fax_no?: string;
+	wallet_address?: string;
+}
+export interface RequestIncomeAmountCertInput extends HometaxCertificateOptions {}
+export interface RequestPensionCreditCertInput extends HometaxCertificateOptions {
+	address_open_yn?: 'Y' | 'N';
+	resno_open_yn?: 'Y' | 'N';
+}
+export interface RequestFactCertInput extends HometaxCertificateOptions {
+	start_month?: string;
+	end_month?: string;
+	itrf_cd?: string;
+	issuance?: '1' | '2';
+}
+/** 소득 증빙서류 통합발급 입력. `year`·`use_purpose`·`submit_to`·`delivery` 가 필수다. */
+export interface RequestIncomeCertBundleInput extends HometaxCertificateOptions {
+	year: string;
+	use_purpose: string;
+	submit_to: string;
+	delivery: '06' | '10' | '04' | '12';
+	amount_open_yn?: 'Y' | 'N';
+	income_source_open_yn?: 'Y' | 'N';
+	withholding_all_print_yn?: 'Y' | 'N';
+	address_open_yn?: 'Y' | 'N';
+	resno_open_yn?: 'Y' | 'N';
+}
+/**
+ * 사업자 증빙서류 통합발급 입력. `business_no` 와 발급 입력이 필수이고,
+ * `bind_id` 가 없으면 대표자 본인 확인 동의 `agreed: true` 가 있어야 접수된다.
+ */
+export interface RequestBusinessCertBundleInput extends HometaxCertificateOptions {
+	business_no: string;
+	year: string;
+	use_purpose: string;
+	submit_to: string;
+	delivery: '06' | '10' | '04' | '12';
+	period?: '1' | '2' | 'all';
+	agreed?: boolean;
+	bind_id?: string;
+}
+export interface RequestTaxClearanceCertInput extends RequestFactCertInput {
+	cert_type?: 'B0006' | 'B0010';
+}
+/** 발급 PDF를 열어 글자를 뽑고 라벨 기준으로 만든 값. 필드는 비어 있을 수 있다. */
+export interface HometaxPdfData {
+	사용가능: boolean;
+	페이지수: number;
+	필드: Record<string, string | number>;
+	텍스트: string;
+	사유?: string;
+}
+/** 홈택스 민원증명 결과. `format` 이 json·both 이면 `발급문서`(base64)와 `PDF데이터` 가 함께 온다. */
+export interface HometaxCertificateResultPayload {
+	문서확인번호: string;
+	귀속연도?: string;
+	소득금액?: string;
+	응답형식?: 'pdf' | 'json' | 'both';
+	발급문서?: string;
+	문서파일명?: string;
+	문서해시?: string;
+	문서크기?: number;
+	PDF데이터?: HometaxPdfData;
+	[key: string]: unknown;
+}
 
 export type DataRequestStatus =
 	| 'AUTH_REQUESTED' | 'AUTH_WAITING' | 'AUTH_COMPLETED' | 'AUTH_REJECTED' | 'AUTH_EXPIRED'
@@ -522,6 +682,36 @@ export interface TaxReturnHistoryInfo {
 }
 export interface TaxReturnHistoryResultPayload { taxReturnHistory: TaxReturnHistoryInfo; }
 
+/** 주민등록표 등본·초본 발급 결과. `발급문서` 는 PDF 원본의 base64 다. */
+export interface ResidentRegistrationInfo {
+	문서확인번호: string;
+	발급일자: string;
+	성명: string;
+	발급문서: string;
+	문서파일명: string;
+	문서해시?: string;
+	문서크기?: number;
+	조회결과?: string;
+}
+export interface ResidentRegistrationResultPayload { residentRegistration: ResidentRegistrationInfo; }
+export interface ResidentRegistrationChoResultPayload { residentRegistrationCho: ResidentRegistrationInfo; }
+/** 통합 조회는 고른 상품의 섹션만 담는다. 섹션 키는 상품 키의 camelCase 다. */
+/** 소득 증빙서류 통합발급 결과. 증명마다 섹션이 따로 오며 일부만 발급되면 status 가 PARTIAL_SUCCESS 다. */
+export type IncomeCertBundleResultPayload = Record<string, unknown> & {
+	incomeAmountCert?: HometaxCertificateResultPayload;
+	pensionCreditCert?: HometaxCertificateResultPayload;
+};
+/** 사업자 증빙서류 통합발급 결과. 성공 응답에 다음 조회에 쓸 `bind_id` 가 함께 올 수 있다. */
+export type BusinessCertBundleResultPayload = Record<string, unknown> & {
+	businessRegistrationCert?: HometaxCertificateResultPayload;
+	vatTaxBaseCert?: HometaxCertificateResultPayload;
+	financialStatementCert?: HometaxCertificateResultPayload;
+};
+export type Gov24BundleResultPayload = Record<string, unknown> & {
+	residentRegistration?: ResidentRegistrationInfo;
+	residentRegistrationCho?: ResidentRegistrationInfo;
+};
+
 export interface YoutubeThumbnail { url: string; width: number; height: number; }
 export interface YoutubeChapter { title: string; start_time: number | null; end_time: number | null; }
 export interface YoutubeMetadata {
@@ -648,7 +838,9 @@ export const SERVICES: Readonly<Record<string, Readonly<{
 /** Brand, model name, model year and trim — all optional. With no `model` the call returns the brand/model list and is free. */
 export interface VehicleModelInfoOptions {
 	maker?: string;
+	/** 차명과 등급·연식·좌석을 함께 입력할 수 있습니다. Free text, e.g. PANAMERA GTS 19년. */
 	model?: string;
+	/** 2자리 또는 4자리 연식. Two or four digits; must agree with the year in model. */
 	modelYear?: string;
 	trim?: string;
 }
@@ -694,6 +886,8 @@ export class ApickClient {
 	linkedinProfile(url: string): Promise<ApickResult<LinkedinProfile>>;
 	linkedinCompany(url: string): Promise<ApickResult<LinkedinCompany>>;
 	linkedinJob(url: string): Promise<ApickResult<LinkedinJob>>;
+	courtAuction(caseNo: string, court: string): Promise<ApickResult<CourtAuction>>;
+	registryDocVerify(issueNo: string, options?: { readonly kind?: 'realestate' | 'corporate' | 'movable' }): Promise<ApickResult<RegistryDocVerify>>;
 	screenshot(url: string): Promise<ApickBinaryResult>;
 	youtubeMetadata(url: string): Promise<ApickResult<YoutubeMetadata>>;
 	youtubeThumbnail(url: string): Promise<ApickBinaryResult>;
@@ -750,6 +944,24 @@ export class ApickClient {
 	getCashReceiptDeduction(transactionId: string): Promise<ApickResult<DataRequestResult<CashReceiptDeductionResultPayload>>>;
 	requestTaxReturnHistory(input: RequestTaxReturnHistoryInput): Promise<ApickResult<DataRequestAcceptedData>>;
 	getTaxReturnHistory(transactionId: string): Promise<ApickResult<DataRequestResult<TaxReturnHistoryResultPayload>>>;
+	requestIncomeAmountCert(input: RequestIncomeAmountCertInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getIncomeAmountCert(transactionId: string): Promise<ApickResult<DataRequestResult<HometaxCertificateResultPayload>>>;
+	requestPensionCreditCert(input: RequestPensionCreditCertInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getPensionCreditCert(transactionId: string): Promise<ApickResult<DataRequestResult<HometaxCertificateResultPayload>>>;
+	requestFactCert(input: RequestFactCertInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getFactCert(transactionId: string): Promise<ApickResult<DataRequestResult<HometaxCertificateResultPayload>>>;
+	requestTaxClearanceCert(input: RequestTaxClearanceCertInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getTaxClearanceCert(transactionId: string): Promise<ApickResult<DataRequestResult<HometaxCertificateResultPayload>>>;
+	requestIncomeCertBundle(input: RequestIncomeCertBundleInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getIncomeCertBundle(transactionId: string): Promise<ApickResult<DataRequestResult<IncomeCertBundleResultPayload>>>;
+	requestBusinessCertBundle(input: RequestBusinessCertBundleInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getBusinessCertBundle(transactionId: string): Promise<ApickResult<DataRequestResult<BusinessCertBundleResultPayload>>>;
+	requestResidentRegistration(input: RequestResidentRegistrationInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getResidentRegistration(transactionId: string): Promise<ApickResult<DataRequestResult<ResidentRegistrationResultPayload>>>;
+	requestResidentRegistrationCho(input: RequestResidentRegistrationChoInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getResidentRegistrationCho(transactionId: string): Promise<ApickResult<DataRequestResult<ResidentRegistrationChoResultPayload>>>;
+	requestGov24Bundle(input: RequestGov24BundleInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getGov24Bundle(transactionId: string): Promise<ApickResult<DataRequestResult<Gov24BundleResultPayload>>>;
 	searchSkills(options?: SkillSearchOptions): Promise<ApickResult<SkillPage<SkillSummary>>>;
 	/** Public measured results and methods; model scores are not accuracy guarantees. */
 	getSkillPerformance(): Promise<ApickResult<SkillPerformanceReport>>;