create-entity-app-server 0.0.3

package/src/app/plugins/taxinvoice/providers/barobill.ts

@@ -0,0 +1,273 @@
+/**
+ * 바로빌 (Barobill) 전자세금계산서 드라이버
+ *
+ * SOAP/XML 기반 API — https://barobill.co.kr/TAPI/TaxInvoiceService.asmx
+ */
+
+import type {
+    TaxInvoiceProviderConfig,
+    TaxInvoiceDriver,
+    InvoiceRequest,
+    IssueOptions,
+    ProviderState,
+    ProviderLog,
+    ProviderSummary,
+    ListFilter,
+} from "../types/index.ts";
+
+const BAROBILL_STATE_MAP: Record<number, string> = {
+    1000: "draft",
+    2010: "pre_issue_waiting",
+    3014: "issued",
+    3011: "issued",
+    4012: "refused",
+    5013: "cancelled",
+    5014: "issue_cancelled",
+};
+
+export class BarobillDriver implements TaxInvoiceDriver {
+    private certKey: string;
+    private corpNum: string;
+    private userID: string;
+    private endpoint: string;
+    private timeoutMs: number;
+
+    /** BarobillClient 인스턴스를 초기화한다 */
+    constructor(cfg: TaxInvoiceProviderConfig) {
+        this.certKey = cfg.cert_key ?? "";
+        this.corpNum = cfg.corp_num ?? "";
+        this.userID = cfg.user_id ?? "";
+        this.endpoint = cfg.api_endpoint;
+        this.timeoutMs = (cfg.timeout_sec ?? 30) * 1000;
+    }
+
+    /** 드라이버 이름을 반환한다 */
+    name(): string {
+        return "barobill";
+    }
+
+    /** 세금계산서 등록 및 즉시 발행 API를 호출한다 */
+    async registIssue(req: InvoiceRequest): Promise<ProviderState> {
+        const resp = await this.soapCall(
+            "RegistAndIssueTaxInvoice",
+            this.buildEnvelope("RegistAndIssueTaxInvoice"),
+        );
+        return this.parseProviderState(resp);
+    }
+
+    /** 세금계산서 임시 저장 API를 호출한다 */
+    async register(req: InvoiceRequest): Promise<ProviderState> {
+        const resp = await this.soapCall(
+            "RegistTaxInvoice",
+            this.buildEnvelope("RegistTaxInvoice"),
+        );
+        return this.parseProviderState(resp);
+    }
+
+    /** 세금계산서 발행 API를 호출한다 */
+    async issue(docKey: string, opts: IssueOptions): Promise<ProviderState> {
+        const resp = await this.soapCall(
+            "IssueTaxInvoice",
+            this.buildEnvelope("IssueTaxInvoice"),
+        );
+        return this.parseProviderState(resp);
+    }
+
+    /** 세금계산서 발행 취소 API를 호출한다 */
+    async cancelIssue(docKey: string, memo: string): Promise<void> {
+        await this.soapCall(
+            "CancelIssueTaxInvoice",
+            this.buildEnvelope("CancelIssueTaxInvoice"),
+        );
+    }
+
+    /** 역발행 요청 등록 API를 호출한다 */
+    async registReverseRequest(req: InvoiceRequest): Promise<ProviderState> {
+        const resp = await this.soapCall(
+            "RegistAndRequestReverseIssueTaxInvoice",
+            this.buildEnvelope("RegistAndRequestReverseIssueTaxInvoice"),
+        );
+        return this.parseProviderState(resp);
+    }
+
+    /** 역발행 요청 API를 호출한다 */
+    async reverseRequest(docKey: string, memo: string): Promise<void> {
+        await this.soapCall(
+            "RequestReverseIssueTaxInvoice",
+            this.buildEnvelope("RequestReverseIssueTaxInvoice"),
+        );
+    }
+
+    /** 역발행 요청 취소 API를 호출한다 */
+    async cancelReverseRequest(docKey: string, memo: string): Promise<void> {
+        await this.soapCall(
+            "CancelRequestReverseIssueTaxInvoice",
+            this.buildEnvelope("CancelRequestReverseIssueTaxInvoice"),
+        );
+    }
+
+    /** 역발행 거부 API를 호출한다 */
+    async refuse(docKey: string, memo: string): Promise<void> {
+        await this.soapCall(
+            "RefuseReverseIssueTaxInvoice",
+            this.buildEnvelope("RefuseReverseIssueTaxInvoice"),
+        );
+    }
+
+    /** 세금계산서 삭제 API를 호출한다 */
+    async delete(docKey: string): Promise<void> {
+        await this.soapCall(
+            "DeleteTaxInvoice",
+            this.buildEnvelope("DeleteTaxInvoice"),
+        );
+    }
+
+    /** 세금계산서 상태 조회 API를 호출한다 */
+    async getState(docKey: string): Promise<ProviderState> {
+        const resp = await this.soapCall(
+            "GetTaxInvoiceState",
+            this.buildEnvelope("GetTaxInvoiceState"),
+        );
+        return this.normalizeState(resp);
+    }
+
+    /** 세금계산서 상세 조회 API를 호출한다 */
+    async getDetail(docKey: string): Promise<unknown> {
+        const resp = await this.soapCall(
+            "GetTaxInvoice",
+            this.buildEnvelope("GetTaxInvoice"),
+        );
+        return resp;
+    }
+
+    /** 세금계산서 로그 조회 API를 호출한다 */
+    async getLogs(docKey: string): Promise<ProviderLog[]> {
+        await this.soapCall(
+            "GetTaxInvoiceLogs",
+            this.buildEnvelope("GetTaxInvoiceLogs"),
+        );
+        return [];
+    }
+
+    /** 세금계산서 목록 조회 API를 호출한다 */
+    async list(filter: ListFilter): Promise<ProviderSummary[]> {
+        await this.soapCall(
+            "GetTaxInvoiceList",
+            this.buildEnvelope("GetTaxInvoiceList"),
+        );
+        return [];
+    }
+
+    /** 세금계산서 이메일 전송 API를 호출한다 */
+    async sendEmail(docKey: string, emails: string[]): Promise<void> {
+        await this.soapCall(
+            "SendEmailTaxInvoice",
+            this.buildEnvelope("SendEmailTaxInvoice"),
+        );
+    }
+
+    /** 세금계산서 SMS 전송 API를 호출한다 */
+    async sendSMS(docKey: string, to: string): Promise<void> {
+        await this.soapCall(
+            "SendSMSTaxInvoice",
+            this.buildEnvelope("SendSMSTaxInvoice"),
+        );
+    }
+
+    /** 국세청 전송 API를 호출한다 */
+    async sendToNTS(docKey: string): Promise<void> {
+        await this.soapCall("SendToNTS", this.buildEnvelope("SendToNTS"));
+    }
+
+    // ── SOAP Transport ──
+
+    /** SOAP 요청을 전송한다 */
+    private async soapCall(action: string, envelope: string): Promise<string> {
+        const soapAction = `https://barobill.co.kr/${action}`;
+        const resp = await fetch(this.endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "text/xml; charset=utf-8",
+                SOAPAction: soapAction,
+            },
+            body: envelope,
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        const body = await resp.text();
+        if (!resp.ok) {
+            throw new Error(
+                `barobill SOAP ${action}: HTTP ${resp.status}: ${body}`,
+            );
+        }
+        return body;
+    }
+
+    /** SOAP 봉투 XML을 생성한다 */
+    private buildEnvelope(action: string): string {
+        return `<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:bar="https://barobill.co.kr/">
+  <soap:Body>
+    <bar:${action}>
+      <bar:CERTKEY>${this.certKey}</bar:CERTKEY>
+      <bar:CorpNum>${this.corpNum}</bar:CorpNum>
+      <bar:ID>${this.userID}</bar:ID>
+    </bar:${action}>
+  </soap:Body>
+</soap:Envelope>`;
+    }
+
+    /** SOAP 응답에서 Result 태그 값을 추출한다 */
+    private extractResultValue(xml: string, action: string): string {
+        // <{action}Result>VALUE</{action}Result> 패턴 매칭
+        const re = new RegExp(`<${action}Result>([^<]*)</${action}Result>`);
+        const m = xml.match(re);
+        return m?.[1] ?? "";
+    }
+
+    /** SOAP 응답에서 NTS 승인번호를 추출한다 */
+    private extractNtsConfirmNum(xml: string): string {
+        const m = xml.match(/<NTSConfirmNum>([^<]*)<\/NTSConfirmNum>/);
+        return m?.[1] ?? "";
+    }
+
+    /** 응답을 ProviderState로 파싱한다 */
+    private parseProviderState(resp: string): ProviderState {
+        // Barobill 등록/발행 API 는 Result 에 상태 코드(long)를 반환
+        const raw =
+            this.extractResultValue(resp, "RegistAndIssueTaxInvoiceResult") ||
+            this.extractResultValue(resp, "RegistTaxInvoiceResult") ||
+            this.extractResultValue(resp, "IssueTaxInvoiceResult") ||
+            this.extractResultValue(
+                resp,
+                "RegistAndRequestReverseIssueTaxInvoiceResult",
+            );
+        const code = parseInt(raw, 10);
+        const state =
+            code > 0 && BAROBILL_STATE_MAP[code]
+                ? BAROBILL_STATE_MAP[code]
+                : "draft";
+        const ntsConfirmNum = this.extractNtsConfirmNum(resp);
+        return {
+            state,
+            nts_state: ntsConfirmNum ? "confirmed" : "pending",
+            nts_confirm_num: ntsConfirmNum,
+            raw: resp,
+        };
+    }
+
+    /** GetTaxInvoiceState 상태 응답을 정규화한다 */
+    private normalizeState(resp: string): ProviderState {
+        const raw = this.extractResultValue(resp, "GetTaxInvoiceStateResult");
+        const code = parseInt(raw, 10);
+        const state =
+            code > 0 && BAROBILL_STATE_MAP[code]
+                ? BAROBILL_STATE_MAP[code]
+                : "draft";
+        const ntsConfirmNum = this.extractNtsConfirmNum(resp);
+        return {
+            state,
+            nts_state: ntsConfirmNum ? "confirmed" : "pending",
+            nts_confirm_num: ntsConfirmNum,
+            raw: resp,
+        };
+    }
+}

package/src/app/plugins/taxinvoice/providers/bolta.ts

@@ -0,0 +1,193 @@
+/**
+ * 볼타 (Bolta) 전자세금계산서 드라이버
+ *
+ * REST/JSON + Basic Auth — https://xapi.bolta.io/v1
+ */
+
+import type {
+    TaxInvoiceProviderConfig,
+    TaxInvoiceDriver,
+    InvoiceRequest,
+    IssueOptions,
+    ProviderState,
+    ProviderLog,
+    ProviderSummary,
+    ListFilter,
+} from "../types/index.ts";
+
+export class BoltaDriver implements TaxInvoiceDriver {
+    private apiKey: string;
+    private customerKey: string;
+    private endpoint: string;
+    private timeoutMs: number;
+
+    /** BoltaClient 인스턴스를 초기화한다 */
+    constructor(cfg: TaxInvoiceProviderConfig) {
+        this.apiKey = cfg.api_key ?? "";
+        this.customerKey = cfg.customer_key ?? "";
+        this.endpoint = cfg.api_endpoint;
+        this.timeoutMs = (cfg.timeout_sec ?? 30) * 1000;
+    }
+
+    /** 드라이버 이름을 반환한다 */
+    name(): string {
+        return "bolta";
+    }
+
+    /** 세금계산서 등록 및 즉시 발행 API를 호출한다 */
+    async registIssue(req: InvoiceRequest): Promise<ProviderState> {
+        const resp = await this.apiCall("POST", "/taxInvoices/issue", req);
+        return this.parseProviderState(resp);
+    }
+
+    /** 세금계산서 임시 저장 API를 호출한다 */
+    async register(req: InvoiceRequest): Promise<ProviderState> {
+        const resp = await this.apiCall("POST", "/taxInvoices", req);
+        return this.parseProviderState(resp);
+    }
+
+    /** 세금계산서 발행 API를 호출한다 */
+    async issue(docKey: string, opts: IssueOptions): Promise<ProviderState> {
+        const resp = await this.apiCall("POST", `/taxInvoices/${docKey}/issue`);
+        return this.parseProviderState(resp);
+    }
+
+    /** 세금계산서 발행 취소 API를 호출한다 */
+    async cancelIssue(docKey: string, memo: string): Promise<void> {
+        await this.apiCall("POST", `/taxInvoices/${docKey}/cancel`, { memo });
+    }
+
+    /** 역발행 요청 등록 API를 호출한다 */
+    async registReverseRequest(req: InvoiceRequest): Promise<ProviderState> {
+        const resp = await this.apiCall(
+            "POST",
+            "/taxInvoices/issueRequest",
+            req,
+        );
+        return this.parseProviderState(resp);
+    }
+
+    /** 역발행 승인 URL 조회 API를 호출한다 */
+    async reverseRequest(docKey: string, memo: string): Promise<void> {
+        await this.apiCall("GET", `/taxInvoices/${docKey}/issueRequest/grant`);
+    }
+
+    /** 역발행 요청 취소 API를 호출한다 */
+    async cancelReverseRequest(docKey: string, memo: string): Promise<void> {
+        await this.apiCall("PUT", `/taxInvoices/${docKey}/issueRequest/cancel`);
+    }
+
+    /** 역발행 거부 API를 호출한다 */
+    async refuse(docKey: string, memo: string): Promise<void> {
+        await this.apiCall("POST", `/taxInvoices/${docKey}/refuse`, { memo });
+    }
+
+    /** 세금계산서 삭제 API를 호출한다 */
+    async delete(docKey: string): Promise<void> {
+        await this.apiCall("DELETE", `/taxInvoices/${docKey}`);
+    }
+
+    /** 세금계산서 상태 조회 API를 호출한다 (내용 조회로 대체) */
+    async getState(docKey: string): Promise<ProviderState> {
+        const resp = await this.apiCall("GET", `/taxInvoices/${docKey}`);
+        return this.parseProviderState(resp);
+    }
+
+    /** 세금계산서 상세 조회 API를 호출한다 */
+    async getDetail(docKey: string): Promise<unknown> {
+        const resp = await this.apiCall("GET", `/taxInvoices/${docKey}`);
+        return JSON.parse(resp);
+    }
+
+    /** 세금계산서 로그 조회 API를 호출한다 */
+    async getLogs(docKey: string): Promise<ProviderLog[]> {
+        return [];
+    }
+
+    /** 세금계산서 목록 조회 API를 호출한다 */
+    async list(filter: ListFilter): Promise<ProviderSummary[]> {
+        return [];
+    }
+
+    /** 세금계산서 이메일 전송 API를 호출한다 */
+    async sendEmail(docKey: string, emails: string[]): Promise<void> {
+        await this.apiCall("POST", `/taxInvoices/${docKey}/email`, {
+            emails,
+        });
+    }
+
+    /** 세금계산서 SMS 전송 API를 호출한다 */
+    async sendSMS(docKey: string, to: string): Promise<void> {
+        await this.apiCall("POST", `/taxInvoices/${docKey}/sms`, { to });
+    }
+
+    /** 국세청 전송 API를 호출한다 */
+    async sendToNTS(docKey: string): Promise<void> {
+        await this.apiCall("POST", `/taxInvoices/${docKey}/nts`);
+    }
+
+    // ── Internal ──
+
+    /** REST API 요청을 전송한다 */
+    private async apiCall(
+        method: string,
+        path: string,
+        body?: unknown,
+    ): Promise<string> {
+        const url = this.endpoint + path;
+        const basicAuth = Buffer.from(`${this.apiKey}:`).toString("base64");
+
+        const init: RequestInit = {
+            method,
+            headers: {
+                "Content-Type": "application/json; charset=utf-8",
+                Authorization: `Basic ${basicAuth}`,
+                "Customer-Key": this.customerKey,
+            },
+            signal: AbortSignal.timeout(this.timeoutMs),
+        };
+
+        if (body && method !== "GET" && method !== "DELETE") {
+            init.body = JSON.stringify(body);
+        }
+
+        const resp = await fetch(url, init);
+        const text = await resp.text();
+        if (resp.status >= 400) {
+            throw new Error(
+                `bolta ${method} ${path}: HTTP ${resp.status}: ${text}`,
+            );
+        }
+        return text;
+    }
+
+    /** 응답을 ProviderState로 파싱한다 */
+    private parseProviderState(resp: string): ProviderState {
+        try {
+            const result = JSON.parse(resp);
+            // issue 응답: { issuanceKey: "..." } — issuanceKey가 있으면 발행 성공
+            if (result.issuanceKey) {
+                return {
+                    state: "issued",
+                    nts_state: result.ntsState ?? "pending",
+                    nts_confirm_num: result.ntsConfirmNumber ?? "",
+                    raw: result,
+                };
+            }
+            // 조회 응답: 전체 세금계산서 객체
+            return {
+                state: result.status ?? result.state ?? "draft",
+                nts_state: result.ntsState ?? result.nts_state ?? "pending",
+                nts_confirm_num:
+                    result.ntsConfirmNumber ?? result.nts_confirm_num ?? "",
+                raw: result,
+            };
+        } catch {
+            return {
+                state: "draft",
+                nts_state: "pending",
+                nts_confirm_num: "",
+            };
+        }
+    }
+}

package/src/app/plugins/taxinvoice/providers/esero.ts

@@ -0,0 +1,201 @@
+/**
+ * 이세로 (eSero / 국세청 직접) 전자세금계산서 드라이버
+ *
+ * XML + XMLDSig — https://esero.go.kr/api/v1
+ * 공동인증서(.pfx) 전자서명을 사용한 국세청 직접 제출
+ */
+
+import type {
+    TaxInvoiceProviderConfig,
+    TaxInvoiceDriver,
+    InvoiceRequest,
+    IssueOptions,
+    ProviderState,
+    ProviderLog,
+    ProviderSummary,
+    ListFilter,
+} from "../types/index.ts";
+
+const ERR_NOT_SUPPORTED = "esero: operation not supported";
+
+export class EseroDriver implements TaxInvoiceDriver {
+    private certPath: string;
+    private certPass: string;
+    private corpNum: string;
+    private endpoint: string;
+    private timeoutMs: number;
+
+    /** EseroClient 인스턴스를 초기화한다 */
+    constructor(cfg: TaxInvoiceProviderConfig) {
+        this.certPath = cfg.cert_path ?? "";
+        this.certPass = cfg.cert_pass ?? "";
+        this.corpNum = cfg.corp_num ?? "";
+        this.endpoint = cfg.api_endpoint;
+        this.timeoutMs = (cfg.timeout_sec ?? 60) * 1000;
+    }
+
+    /** 드라이버 이름을 반환한다 */
+    name(): string {
+        return "esero";
+    }
+
+    /** 세금계산서 등록 및 즉시 발행 API를 호출한다 */
+    async registIssue(req: InvoiceRequest): Promise<ProviderState> {
+        const xmlData = buildKFTCXML(req);
+        const signed = signXML(xmlData, this.certPath, this.certPass);
+        const resp = await this.submitToNTS(signed);
+        const confirmNum = parseNTSConfirmNum(resp);
+        if (confirmNum) {
+            return {
+                state: "issued",
+                nts_state: "completed",
+                nts_confirm_num: confirmNum,
+                raw: resp,
+            };
+        }
+        return {
+            state: "issued",
+            nts_state: "waiting",
+            nts_confirm_num: "",
+            raw: resp,
+        };
+    }
+
+    /** 세금계산서 임시 저장 API를 호출한다 */
+    async register(_req: InvoiceRequest): Promise<ProviderState> {
+        return { state: "draft", nts_state: "pending", nts_confirm_num: "" };
+    }
+
+    /** 세금계산서 발행 API를 호출한다 */
+    async issue(_docKey: string, _opts: IssueOptions): Promise<ProviderState> {
+        throw new Error(
+            "esero Issue: use Service.RegistIssue() which delegates to RegistIssue",
+        );
+    }
+
+    /** 세금계산서 발행 취소 API를 호출한다 */
+    async cancelIssue(docKey: string, _memo: string): Promise<void> {
+        const cancelXML = `<?xml version="1.0" encoding="utf-8"?><CancelRequest><ID>${docKey}</ID><CorpNum>${this.corpNum}</CorpNum></CancelRequest>`;
+        const signed = signXML(cancelXML, this.certPath, this.certPass);
+        await this.submitToNTS(signed);
+    }
+
+    /** 역발행 요청 등록 API를 호출한다 */
+    async registReverseRequest(_req: InvoiceRequest): Promise<ProviderState> {
+        throw new Error(ERR_NOT_SUPPORTED);
+    }
+
+    /** 역발행 요청 API를 호출한다 */
+    async reverseRequest(_docKey: string, _memo: string): Promise<void> {
+        throw new Error(ERR_NOT_SUPPORTED);
+    }
+
+    /** 역발행 요청 취소 API를 호출한다 */
+    async cancelReverseRequest(_docKey: string, _memo: string): Promise<void> {
+        throw new Error(ERR_NOT_SUPPORTED);
+    }
+
+    /** 역발행 거부 API를 호출한다 */
+    async refuse(_docKey: string, _memo: string): Promise<void> {
+        throw new Error(ERR_NOT_SUPPORTED);
+    }
+
+    /** 세금계산서 삭제 API를 호출한다 */
+    async delete(_docKey: string): Promise<void> {
+        // no-op
+    }
+
+    /** 세금계산서 상태 조회 API를 호출한다 */
+    async getState(docKey: string): Promise<ProviderState> {
+        const queryXML = `<?xml version="1.0" encoding="utf-8"?><StateQuery><ID>${docKey}</ID><CorpNum>${this.corpNum}</CorpNum></StateQuery>`;
+        const signed = signXML(queryXML, this.certPath, this.certPass);
+        const resp = await this.submitToNTS(signed);
+        return {
+            state: "issued",
+            nts_state: "completed",
+            nts_confirm_num: "",
+            raw: resp,
+        };
+    }
+
+    /** 세금계산서 상세 조회 API를 호출한다 */
+    async getDetail(docKey: string): Promise<unknown> {
+        const queryXML = `<?xml version="1.0" encoding="utf-8"?><DetailQuery><ID>${docKey}</ID><CorpNum>${this.corpNum}</CorpNum></DetailQuery>`;
+        const signed = signXML(queryXML, this.certPath, this.certPass);
+        const resp = await this.submitToNTS(signed);
+        return resp;
+    }
+
+    /** 세금계산서 로그 조회 API를 호출한다 */
+    async getLogs(_docKey: string): Promise<ProviderLog[]> {
+        return [];
+    }
+
+    /** 세금계산서 목록 조회 API를 호출한다 */
+    async list(_filter: ListFilter): Promise<ProviderSummary[]> {
+        return [];
+    }
+
+    /** 세금계산서 이메일 전송 API를 호출한다 */
+    async sendEmail(_docKey: string, _emails: string[]): Promise<void> {
+        throw new Error(ERR_NOT_SUPPORTED);
+    }
+
+    /** 세금계산서 SMS 전송 API를 호출한다 */
+    async sendSMS(_docKey: string, _to: string): Promise<void> {
+        throw new Error(ERR_NOT_SUPPORTED);
+    }
+
+    /** 국세청 전송 API를 호출한다 */
+    async sendToNTS(_docKey: string): Promise<void> {
+        // esero는 RegistIssue에서 이미 국세청 직접 제출하므로 no-op
+    }
+
+    // ── Internal ──
+
+    /** 서명된 XML을 국세청에 제출한다 */
+    private async submitToNTS(signedXML: string): Promise<string> {
+        const resp = await fetch(`${this.endpoint}/submit`, {
+            method: "POST",
+            headers: { "Content-Type": "application/xml; charset=utf-8" },
+            body: signedXML,
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        const body = await resp.text();
+        if (!resp.ok) {
+            throw new Error(`esero submit: HTTP ${resp.status}: ${body}`);
+        }
+        return body;
+    }
+}
+
+// ── XML Helpers ──
+
+/** KFTC 표준전자세금계산서 XML을 생성한다 */
+function buildKFTCXML(req: InvoiceRequest): string {
+    // KFTC 표준전자세금계산서 XML 빌드
+    // TODO: 전체 필드 매핑 (현재는 최소 골격만)
+    return `<?xml version="1.0" encoding="utf-8"?>
+<TaxInvoice xmlns="urn:kr:or:kec:standard:Tax:ReusableAggregateBusinessInformationEntitySchemaModule:1:0" version="3.0">
+  <ExchangedDocument>
+    <ID>${req.mgt_key}</ID>
+  </ExchangedDocument>
+</TaxInvoice>`;
+}
+
+/** XML 전자서명을 수행한다 */
+function signXML(
+    xmlData: string,
+    _certPath: string,
+    _certPass: string,
+): string {
+    // TODO: XMLDSig enveloped-signature 구현
+    return xmlData;
+}
+
+/** 국세청 승인번호를 파싱한다 */
+function parseNTSConfirmNum(resp: string): string {
+    // 단순 정규식으로 ConfirmNum 파싱
+    const match = resp.match(/<ConfirmNum>([^<]+)<\/ConfirmNum>/);
+    return match?.[1] ?? "";
+}