@connextable/popbill-spec 1.0.0

package/dist/get-info-PUH8dt9f.d.mts

@@ -0,0 +1,2061 @@
+//#region src/headers.d.ts
+/**
+ * Popbill Common Header Raw Types
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/getting-started/authorization
+ * - https://developers.popbill.com/api-reference/taxinvoice/getting-started/etc-header
+ */
+/**
+ * Bearer 인증 헤더 값(raw).
+ *
+ * HTTP 헤더 `Authorization: Bearer {session_token}` 형식으로 전달한다.
+ */
+type PopbillAuthorizationHeader = `Bearer ${string}`;
+/**
+ * 응답 압축 설정 헤더 값(raw).
+ *
+ * 문서 기본값은 `gzip`이며, 런타임 호환을 위해 일반 문자열 확장을 허용한다.
+ */
+interface PopbillAcceptEncodingMap {
+  /**
+   * Gzip 압축 응답.
+   */
+  Gzip: 'gzip';
+}
+/**
+ * 응답 압축 설정 헤더 값(raw).
+ *
+ * 문서 기본값은 `gzip`이며, 런타임 호환을 위해 일반 문자열 확장을 허용한다.
+ */
+type PopbillAcceptEncoding = PopbillAcceptEncodingMap[keyof PopbillAcceptEncodingMap] | (string & {});
+/**
+ * 팝빌 응답 메시지 기본 언어(raw).
+ *
+ * `Accept-Language` 헤더를 생략하면 기본값 `ko-KR`(한글)로 응답한다.
+ */
+declare const PopbillDefaultResponseLanguage: "ko-KR";
+/**
+ * 응답 언어 설정 헤더 값(raw).
+ *
+ * 기본은 `ko-KR`이며, `en-US`를 설정하면 영문 응답을 요청할 수 있다.
+ */
+interface PopbillAcceptLanguageMap {
+  /**
+   * 한글 응답.
+   */
+  KoreanKorea: typeof PopbillDefaultResponseLanguage;
+  /**
+   * 영문 응답.
+   */
+  EnglishUnitedStates: 'en-US';
+}
+/**
+ * 응답 언어 설정 헤더 값 상수(raw).
+ */
+declare const PopbillAcceptLanguages: {
+  readonly KoreanKorea: "ko-KR";
+  readonly EnglishUnitedStates: "en-US";
+};
+/**
+ * 응답 언어 설정 헤더 값(raw).
+ *
+ * `Accept-Language` 헤더는 선택사항이다.
+ * 헤더를 명시할 때는 `ko-KR` 또는 `en-US`를 사용한다.
+ */
+type PopbillAcceptLanguage = (typeof PopbillAcceptLanguages)[keyof typeof PopbillAcceptLanguages];
+/**
+ * X-HTTP-Method-Override 헤더 값(raw).
+ */
+declare const PopbillHttpMethodOverrides: {
+  readonly BulkIssue: "BULKISSUE";
+};
+/**
+ * X-HTTP-Method-Override 헤더 값(raw).
+ */
+type PopbillHttpMethodOverride = (typeof PopbillHttpMethodOverrides)[keyof typeof PopbillHttpMethodOverrides];
+/**
+ * 팝빌 공통 API 요청 헤더(raw).
+ */
+interface PopbillApiRequestHeaders {
+  /**
+   * 세션 토큰 기반 Bearer 인증 헤더.
+   */
+  Authorization?: PopbillAuthorizationHeader;
+  /**
+   * 응답 압축 방식.
+   *
+   * HTTP 헤더 `Accept-Encoding`으로 전달한다.
+   */
+  AcceptEncoding?: PopbillAcceptEncoding;
+  /**
+   * 응답 메시지 언어.
+   *
+   * HTTP 헤더 `Accept-Language`로 전달한다.
+   * 헤더를 생략하면 기본 한글(`ko-KR`) 응답을 사용한다.
+   */
+  AcceptLanguage?: PopbillAcceptLanguage;
+}
+/**
+ * 대량발행(Bulk) 요청 헤더(raw).
+ */
+interface PopbillBulkIssueRequestHeaders extends PopbillApiRequestHeaders {
+  /**
+   * 대량발행 API 메서드 오버라이드.
+   *
+   * HTTP 헤더 `X-HTTP-Method-Override`로 전달한다.
+   */
+  MethodOverride: PopbillHttpMethodOverride;
+  /**
+   * 요청 본문 무결성 검증용 Message Digest.
+   *
+   * HTTP 헤더 `X-PB-MESSAGE-DIGEST`로 전달한다.
+   */
+  MessageDigest: string;
+  /**
+   * 파트너가 할당한 제출아이디.
+   *
+   * HTTP 헤더 `X-PB-SUBMIT-ID`로 전달한다.
+   */
+  SubmitID: string;
+}
+//#endregion
+//#region src/request.d.ts
+/**
+ * Popbill Common Request Raw Types
+ */
+/**
+ * 팝빌 API 공통 요청(raw).
+ *
+ * `path/query/body/headers`를 전송 위치별로 분리하여 명세한다.
+ */
+interface PopbillApiRequest<TPath = never, TQuery = never, TBody = never, THeaders = PopbillApiRequestHeaders> {
+  /**
+   * 팝빌회원 사업자번호.
+   *
+   * `-` 없이 입력한다.
+   */
+  corpNum: string;
+  /**
+   * 팝빌회원 아이디.
+   */
+  userId?: string;
+  /**
+   * URL path 파라미터(raw).
+   */
+  path?: TPath;
+  /**
+   * URL query 파라미터(raw).
+   */
+  query?: TQuery;
+  /**
+   * HTTP 요청 본문(raw).
+   */
+  body?: TBody;
+  /**
+   * HTTP 요청 헤더(raw).
+   */
+  headers?: THeaders;
+}
+/**
+ * 요청 타입의 특정 필드를 필수화하는 유틸리티 타입.
+ */
+type PopbillRequireRequestFields<T, K extends keyof T> = Omit<T, K> & { [P in K]-?: T[P] };
+//#endregion
+//#region src/tax-invoice/common.d.ts
+/**
+ * Tax Invoice Common Raw Types
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/issue
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/etc
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/cert
+ * - https://developers.popbill.com/api-reference/taxinvoice/response-code
+ */
+/**
+ * Taxinvoice 공통 요청 헤더(raw).
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/cashbill/getting-started/authorization
+ * - https://developers.popbill.com/api-reference/cashbill/getting-started/etc-header
+ */
+type TaxInvoiceApiRequestHeaders = PopbillApiRequestHeaders;
+/**
+ * Taxinvoice 대량발행(Bulk) 요청 헤더(raw).
+ */
+type TaxInvoiceBulkIssueRequestHeaders = PopbillBulkIssueRequestHeaders;
+/**
+ * Taxinvoice 공통 요청(raw).
+ */
+type TaxInvoiceApiRequest<TPath = never, TQuery = never, TBody = never, THeaders = TaxInvoiceApiRequestHeaders> = PopbillApiRequest<TPath, TQuery, TBody, THeaders>;
+/**
+ * Taxinvoice 요청 타입의 특정 필드를 필수화하는 유틸리티 타입.
+ */
+type TaxInvoiceRequireRequestFields<T, K extends keyof T> = PopbillRequireRequestFields<T, K>;
+/**
+ * Taxinvoice API 공통 처리결과(raw).
+ */
+interface TaxInvoiceApiResponseBase {
+  /**
+   * 처리 결과코드.
+   */
+  code: number;
+  /**
+   * 처리 결과메시지.
+   */
+  message: string;
+}
+/**
+ * 문서번호 유형(raw).
+ *
+ * - `SELL`: 매출
+ * - `BUY`: 매입
+ * - `TRUSTEE`: 위수탁
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info#Search
+ */
+interface TaxInvoiceMgtKeyTypeMap {
+  /**
+   * 매출 문서번호 유형.
+   */
+  Sell: 'SELL';
+  /**
+   * 매입 문서번호 유형.
+   */
+  Buy: 'BUY';
+  /**
+   * 위수탁 문서번호 유형.
+   */
+  Trustee: 'TRUSTEE';
+}
+/**
+ * 문서번호 유형(raw).
+ */
+type TaxInvoiceMgtKeyType = TaxInvoiceMgtKeyTypeMap[keyof TaxInvoiceMgtKeyTypeMap];
+/**
+ * 과세 형태(raw).
+ *
+ * - `과세`: 일반 과세
+ * - `영세`: 영세율
+ * - `면세`: 면세
+ */
+interface TaxTypeMap {
+  /**
+   * 일반 과세.
+   */
+  Taxable: '과세';
+  /**
+   * 영세율.
+   */
+  ZeroRated: '영세';
+  /**
+   * 면세.
+   */
+  Exempt: '면세';
+}
+/**
+ * 과세 형태(raw).
+ */
+type TaxType = TaxTypeMap[keyof TaxTypeMap];
+/**
+ * 발행 형태(raw).
+ *
+ * - `정발행`: 공급자 중심 발행
+ * - `역발행`: 공급받는자 요청 기반 발행
+ * - `위수탁`: 수탁자 대행 발행
+ */
+interface IssueTypeMap {
+  /**
+   * 정발행.
+   */
+  Normal: '정발행';
+  /**
+   * 역발행.
+   */
+  Reverse: '역발행';
+  /**
+   * 위수탁 발행.
+   */
+  Trustee: '위수탁';
+}
+/**
+ * 발행 형태(raw).
+ */
+type IssueType = IssueTypeMap[keyof IssueTypeMap];
+/**
+ * 영수/청구 유형(raw).
+ *
+ * - `영수`: 영수 목적
+ * - `청구`: 청구 목적
+ * - `없음`: 구분 없음
+ */
+interface PurposeTypeMap {
+  /**
+   * 영수 목적.
+   */
+  Receipt: '영수';
+  /**
+   * 청구 목적.
+   */
+  Claim: '청구';
+  /**
+   * 구분 없음.
+   */
+  None: '없음';
+}
+/**
+ * 영수/청구 유형(raw).
+ */
+type PurposeType = PurposeTypeMap[keyof PurposeTypeMap];
+/**
+ * 공급받는자 유형(raw).
+ *
+ * - `사업자`: 사업자 등록번호 기준
+ * - `개인`: 주민등록번호 기준
+ * - `외국인`: 외국인 식별번호 기준
+ */
+interface InvoiceeTypeMap {
+  /**
+   * 사업자.
+   */
+  Corporation: '사업자';
+  /**
+   * 개인.
+   */
+  Individual: '개인';
+  /**
+   * 외국인.
+   */
+  Foreigner: '외국인';
+}
+/**
+ * 공급받는자 유형(raw).
+ */
+type InvoiceeType = InvoiceeTypeMap[keyof InvoiceeTypeMap];
+/**
+ * 휴폐업 상태(raw).
+ *
+ * - `null`: 미확인
+ * - `0`: 미등록
+ * - `1`: 사업중
+ * - `2`: 폐업
+ * - `3`: 휴업
+ * - `4`: 확인실패
+ */
+interface CloseDownStateMap {
+  /**
+   * 미확인.
+   */
+  NotChecked: null;
+  /**
+   * 미등록.
+   */
+  NotRegistered: 0;
+  /**
+   * 사업중.
+   */
+  Operating: 1;
+  /**
+   * 폐업.
+   */
+  Closed: 2;
+  /**
+   * 휴업.
+   */
+  Suspended: 3;
+  /**
+   * 확인실패.
+   */
+  CheckFailed: 4;
+}
+/**
+ * 휴폐업 상태(raw).
+ */
+type CloseDownState = CloseDownStateMap[keyof CloseDownStateMap];
+/**
+ * Search API 휴폐업상태 필터(raw).
+ *
+ * - `N`: 미확인
+ * - `0`: 미등록
+ * - `1`: 사업중
+ * - `2`: 폐업
+ * - `3`: 휴업
+ * - `4`: 확인실패
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info#Search
+ */
+interface TaxInvoiceSearchCloseDownStateMap {
+  /**
+   * 미확인.
+   */
+  NotChecked: 'N';
+  /**
+   * 미등록.
+   */
+  NotRegistered: '0';
+  /**
+   * 사업중.
+   */
+  Operating: '1';
+  /**
+   * 폐업.
+   */
+  Closed: '2';
+  /**
+   * 휴업.
+   */
+  Suspended: '3';
+  /**
+   * 확인실패.
+   */
+  CheckFailed: '4';
+}
+/**
+ * Search API 휴폐업상태 필터(raw).
+ */
+type TaxInvoiceSearchCloseDownState = TaxInvoiceSearchCloseDownStateMap[keyof TaxInvoiceSearchCloseDownStateMap];
+/**
+ * 검색일자 유형(raw).
+ *
+ * - `R`: 등록일자
+ * - `W`: 작성일자
+ * - `I`: 발행일자
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info#Search
+ */
+interface TaxInvoiceDateTypeMap {
+  /**
+   * 등록일자.
+   */
+  Registered: 'R';
+  /**
+   * 작성일자.
+   */
+  Written: 'W';
+  /**
+   * 발행일자.
+   */
+  Issued: 'I';
+}
+/**
+ * 검색일자 유형(raw).
+ */
+type TaxInvoiceDateType = TaxInvoiceDateTypeMap[keyof TaxInvoiceDateTypeMap];
+/**
+ * 정렬 방향(raw).
+ *
+ * - `D`: 내림차순
+ * - `A`: 오름차순
+ */
+interface TaxInvoiceSortOrderMap {
+  /**
+   * 내림차순.
+   */
+  Descending: 'D';
+  /**
+   * 오름차순.
+   */
+  Ascending: 'A';
+}
+/**
+ * 정렬 방향(raw).
+ */
+type TaxInvoiceSortOrder = TaxInvoiceSortOrderMap[keyof TaxInvoiceSortOrderMap];
+/**
+ * 수정세금계산서 사유코드(raw).
+ *
+ * - `1`: 기재사항 착오정정
+ * - `2`: 공급가액 변동
+ * - `3`: 환입
+ * - `4`: 계약의 해제
+ * - `5`: 내국신용장 사후개설
+ * - `6`: 착오에 의한 이중발급
+ */
+interface TaxInvoiceModifyCodeMap {
+  /**
+   * 기재사항 착오정정.
+   */
+  CorrectingEntryErrors: 1;
+  /**
+   * 공급가액 변동.
+   */
+  SupplyAmountAdjustment: 2;
+  /**
+   * 환입.
+   */
+  ReturnedGoods: 3;
+  /**
+   * 계약의 해제.
+   */
+  ContractCancellation: 4;
+  /**
+   * 내국신용장 사후개설.
+   */
+  LocalLetterOfCreditOpenedAfterSupply: 5;
+  /**
+   * 착오에 의한 이중발급.
+   */
+  DuplicateIssuanceByMistake: 6;
+}
+/**
+ * 수정세금계산서 사유코드(raw).
+ */
+type TaxInvoiceModifyCode = TaxInvoiceModifyCodeMap[keyof TaxInvoiceModifyCodeMap];
+/**
+ * 이메일 설정 구분(raw).
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/etc#UpdateEmailConfig
+ *
+ * 문서/legacy 공통 사용값:
+ * - `ETC_CERT_EXPIRATION`: 인증서 만료 안내
+ * - `TAX_CANCEL_ISSUE`: 발행취소
+ * - `TAX_CANCEL_REQUEST`: 역발행 요청 취소
+ * - `TAX_CHECK`: 수신확인
+ * - `TAX_CLOSEDOWN`: 휴폐업 알림
+ * - `TAX_ISSUE`: 발행완료(수신자)
+ * - `TAX_ISSUE_INVOICER`: 발행완료(공급자)
+ * - `TAX_NTSFAIL_INVOICER`: 국세청 전송실패(공급자)
+ * - `TAX_REFUSE`: 역발행 거부
+ * - `TAX_REQUEST`: 역발행 요청
+ * - `TAX_REVERSE_ISSUE`: 역발행 완료
+ * - `TAX_TRUST_CANCEL_ISSUE`: 위수탁 발행취소
+ * - `TAX_TRUST_CANCEL_ISSUE_INVOICER`: 위수탁 발행취소(공급자)
+ * - `TAX_TRUST_ISSUE`: 위수탁 발행완료
+ * - `TAX_TRUST_ISSUE_INVOICER`: 위수탁 발행완료(공급자)
+ * - `TAX_TRUST_ISSUE_TRUSTEE`: 위수탁 발행완료(수탁자)
+ * - `TAX_ACCEPT`: 역발행 승인(legacy)
+ * - `TAX_DENY`: 역발행 거부(legacy)
+ * - `TAX_CANCEL_SEND`: 발행안함 취소(legacy)
+ */
+interface TaxInvoiceEmailTypeMap {
+  /**
+   * 인증서 만료 안내.
+   */
+  EtcCertExpiration: 'ETC_CERT_EXPIRATION';
+  /**
+   * 발행취소.
+   */
+  TaxCancelIssue: 'TAX_CANCEL_ISSUE';
+  /**
+   * 역발행 요청 취소.
+   */
+  TaxCancelRequest: 'TAX_CANCEL_REQUEST';
+  /**
+   * 수신확인.
+   */
+  TaxCheck: 'TAX_CHECK';
+  /**
+   * 휴폐업 알림.
+   */
+  TaxClosedown: 'TAX_CLOSEDOWN';
+  /**
+   * 발행완료(수신자).
+   */
+  TaxIssue: 'TAX_ISSUE';
+  /**
+   * 발행완료(공급자).
+   */
+  TaxIssueInvoicer: 'TAX_ISSUE_INVOICER';
+  /**
+   * 국세청 전송실패(공급자).
+   */
+  TaxNtsFailInvoicer: 'TAX_NTSFAIL_INVOICER';
+  /**
+   * 역발행 거부.
+   */
+  TaxRefuse: 'TAX_REFUSE';
+  /**
+   * 역발행 요청.
+   */
+  TaxRequest: 'TAX_REQUEST';
+  /**
+   * 역발행 완료.
+   */
+  TaxReverseIssue: 'TAX_REVERSE_ISSUE';
+  /**
+   * 위수탁 발행취소.
+   */
+  TaxTrustCancelIssue: 'TAX_TRUST_CANCEL_ISSUE';
+  /**
+   * 위수탁 발행취소(공급자).
+   */
+  TaxTrustCancelIssueInvoicer: 'TAX_TRUST_CANCEL_ISSUE_INVOICER';
+  /**
+   * 위수탁 발행완료.
+   */
+  TaxTrustIssue: 'TAX_TRUST_ISSUE';
+  /**
+   * 위수탁 발행완료(공급자).
+   */
+  TaxTrustIssueInvoicer: 'TAX_TRUST_ISSUE_INVOICER';
+  /**
+   * 위수탁 발행완료(수탁자).
+   */
+  TaxTrustIssueTrustee: 'TAX_TRUST_ISSUE_TRUSTEE';
+  /**
+   * 역발행 승인(legacy).
+   */
+  TaxAccept: 'TAX_ACCEPT';
+  /**
+   * 역발행 거부(legacy).
+   */
+  TaxDeny: 'TAX_DENY';
+  /**
+   * 발행안함 취소(legacy).
+   */
+  TaxCancelSend: 'TAX_CANCEL_SEND';
+}
+/**
+ * 이메일 설정 구분(raw).
+ */
+type TaxInvoiceEmailType = TaxInvoiceEmailTypeMap[keyof TaxInvoiceEmailTypeMap];
+/**
+ * 작성일/일시 문자열(raw).
+ */
+type TaxInvoiceDateString = string;
+//#endregion
+//#region src/tax-invoice/response-codes.d.ts
+/**
+ * Tax Invoice Response / Status Codes
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/response-code
+ */
+/**
+ * 세금계산서 상태코드 정의.
+ */
+interface TaxInvoiceStateCodeDefinition {
+  code: number;
+  message: string;
+  description: string;
+}
+/**
+ * 국세청 결과코드 정의.
+ */
+interface TaxInvoiceNtsResultCodeDefinition {
+  code: string;
+  description: string;
+}
+/**
+ * 세금계산서 상태코드(`stateCode`) 상수.
+ *
+ * 문서 분류(정발행/역발행/위수탁) 기준으로 구분한다.
+ */
+declare const TAX_INVOICE_STATE_CODES: {
+  /**
+   * 정발행 상태코드.
+   */
+  readonly REGULAR: {
+    readonly TEMPORARY_SAVED: {
+      readonly code: 100;
+      readonly message: "임시저장";
+      readonly description: "공급자가 작성한 세금계산서가 임시저장된 상태";
+    };
+    readonly ISSUED: {
+      readonly code: 300;
+      readonly message: "발행완료";
+      readonly description: "전자세금계산서 발행이 완료된 상태";
+    };
+    readonly BEFORE_NTS_TRANSMISSION: {
+      readonly code: 301;
+      readonly message: "전송전";
+      readonly description: "팝빌에서 국세청 전송을 준비중인 상태";
+    };
+    readonly PENDING_NTS_TRANSMISSION: {
+      readonly code: 302;
+      readonly message: "전송대기";
+      readonly description: "팝빌에서 국세청 전송을 대기중인 상태";
+    };
+    readonly TRANSMITTING_TO_NTS: {
+      readonly code: 303;
+      readonly message: "전송중";
+      readonly description: "팝빌에서 국세청 전송을 진행중인 상태";
+    };
+    readonly NTS_TRANSMISSION_SUCCESS: {
+      readonly code: 304;
+      readonly message: "전송성공";
+      readonly description: "전자세금계산서 국세청 신고가 정상적으로 완료된 상태";
+    };
+    readonly NTS_TRANSMISSION_FAILED: {
+      readonly code: 305;
+      readonly message: "전송실패";
+      readonly description: "국세청이 특정사유로 전자세금계산서 신고를 반려한 상태";
+    };
+    readonly ISSUE_CANCELED: {
+      readonly code: 600;
+      readonly message: "발행취소";
+      readonly description: "공급자가 발행완료된 전자세금계산서를 취소한 상태 (국세청 전송 대상에서 제외)";
+    };
+  };
+  /**
+   * 역발행 상태코드.
+   */
+  readonly REVERSE: {
+    readonly TEMPORARY_SAVED: {
+      readonly code: 100;
+      readonly message: "임시저장";
+      readonly description: "공급받는자가 작성한 세금계산서가 임시저장된 상태";
+    };
+    readonly REVERSE_ISSUE_PENDING: {
+      readonly code: 200;
+      readonly message: "(역)발행대기";
+      readonly description: "공급자에게 전자세금계산서 (역)발행을 요청한 상태";
+    };
+    readonly ISSUED: {
+      readonly code: 300;
+      readonly message: "발행완료";
+      readonly description: "전자세금계산서 발행이 완료된 상태";
+    };
+    readonly BEFORE_NTS_TRANSMISSION: {
+      readonly code: 301;
+      readonly message: "전송전";
+      readonly description: "팝빌에서 국세청 전송을 준비중인 상태";
+    };
+    readonly PENDING_NTS_TRANSMISSION: {
+      readonly code: 302;
+      readonly message: "전송대기";
+      readonly description: "팝빌에서 국세청 전송을 대기중인 상태";
+    };
+    readonly TRANSMITTING_TO_NTS: {
+      readonly code: 303;
+      readonly message: "전송중";
+      readonly description: "팝빌에서 국세청 전송을 진행중인 상태";
+    };
+    readonly NTS_TRANSMISSION_SUCCESS: {
+      readonly code: 304;
+      readonly message: "전송성공";
+      readonly description: "전자세금계산서 국세청 신고가 정상적으로 완료된 상태";
+    };
+    readonly NTS_TRANSMISSION_FAILED: {
+      readonly code: 305;
+      readonly message: "전송실패";
+      readonly description: "국세청이 특정사유로 전자세금계산서 신고를 반려한 상태";
+    };
+    readonly REVERSE_ISSUE_REJECTED: {
+      readonly code: 400;
+      readonly message: "(역)발행거부";
+      readonly description: "공급자가 (역)발행대기 세금계산서를 거부한 상태";
+    };
+    readonly REVERSE_ISSUE_CANCELED: {
+      readonly code: 500;
+      readonly message: "(역)발행취소";
+      readonly description: "공급받는자가 (역)발행대기 세금계산서를 취소한 상태";
+    };
+    readonly ISSUE_CANCELED: {
+      readonly code: 600;
+      readonly message: "발행취소";
+      readonly description: "공급자가 발행완료된 전자세금계산서를 취소한 상태 (국세청 전송 대상에서 제외)";
+    };
+  };
+  /**
+   * 위수탁 상태코드.
+   */
+  readonly TRUSTEE: {
+    readonly TEMPORARY_SAVED: {
+      readonly code: 100;
+      readonly message: "임시저장";
+      readonly description: "수탁자가 작성한 세금계산서가 임시저장된 상태";
+    };
+    readonly ISSUED: {
+      readonly code: 300;
+      readonly message: "발행완료";
+      readonly description: "전자세금계산서 발행이 완료된 상태";
+    };
+    readonly BEFORE_NTS_TRANSMISSION: {
+      readonly code: 301;
+      readonly message: "전송전";
+      readonly description: "팝빌에서 국세청 전송을 준비중인 상태";
+    };
+    readonly PENDING_NTS_TRANSMISSION: {
+      readonly code: 302;
+      readonly message: "전송대기";
+      readonly description: "팝빌에서 국세청 전송을 대기중인 상태";
+    };
+    readonly TRANSMITTING_TO_NTS: {
+      readonly code: 303;
+      readonly message: "전송중";
+      readonly description: "팝빌에서 국세청 전송을 진행중인 상태";
+    };
+    readonly NTS_TRANSMISSION_SUCCESS: {
+      readonly code: 304;
+      readonly message: "전송성공";
+      readonly description: "전자세금계산서 국세청 신고가 정상적으로 완료된 상태";
+    };
+    readonly NTS_TRANSMISSION_FAILED: {
+      readonly code: 305;
+      readonly message: "전송실패";
+      readonly description: "국세청이 특정사유로 전자세금계산서 신고를 반려한 상태";
+    };
+    readonly ISSUE_CANCELED: {
+      readonly code: 600;
+      readonly message: "발행취소";
+      readonly description: "수탁자가 발행완료된 전자세금계산서를 취소한 상태 (국세청 전송 대상에서 제외)";
+    };
+  };
+};
+/**
+ * 국세청 결과코드(`ntssendErrCode`) 상수.
+ *
+ * - `SUCCESS`: 팝빌 상태코드 `304`(전송성공)에 해당
+ * - `FAILURE`: 팝빌 상태코드 `305`(전송실패)에 해당
+ */
+declare const TAX_INVOICE_NTS_RESULT_CODES: {
+  readonly SUCCESS: {
+    readonly SUC001: {
+      readonly code: "SUC001";
+      readonly description: "국세청의 검증 과정을 통과하여 전자세금계산서 신고가 정상적으로 완료된 경우";
+    };
+  };
+  readonly FAILURE: {
+    readonly SYN002: {
+      readonly code: "SYN002";
+      readonly description: "전자세금계산서의 전자서명이 유효하지 않은 경우";
+    };
+    readonly SYN003: {
+      readonly code: "SYN003";
+      readonly description: "국세청에 중복된 국세청승인번호가 존재하는 경우";
+    };
+    readonly SYN004: {
+      readonly code: "SYN004";
+      readonly description: "전자세금계산서의 국세청 신고 형식이 유효하지 않은 경우";
+    };
+    readonly ERR001: {
+      readonly code: "ERR001";
+      readonly description: "공급자의 사업자번호가 국세청에 등록되지 않은 경우";
+    };
+    readonly ERR002: {
+      readonly code: "ERR002";
+      readonly description: "공급받는자의 사업자번호 또는 주민등록번호가 국세청에 등록되지 않은 경우";
+    };
+    readonly ERR003: {
+      readonly code: "ERR003";
+      readonly description: "수탁자의 사업자번호가 국세청에 등록되지 않은 경우";
+    };
+    readonly ERR005: {
+      readonly code: "ERR005";
+      readonly description: "발행일시가 유효하지 않는 경우";
+    };
+    readonly ERR006: {
+      readonly code: "ERR006";
+      readonly description: "작성일자가 유효하지 않는 경우";
+    };
+    readonly ERR007: {
+      readonly code: "ERR007";
+      readonly description: "공급가액 또는 세액이 유효하지 않은 경우";
+    };
+    readonly ERR008: {
+      readonly code: "ERR008";
+      readonly description: "수정세금계산서의 수정 사유코드가 유효하지 않은 경우";
+    };
+    readonly ERR009: {
+      readonly code: "ERR009";
+      readonly description: "폐업된 사업자번호로 폐업신고일자 이후 전자세금계산서를 발행한 경우";
+    };
+    readonly ERR010: {
+      readonly code: "ERR010";
+      readonly description: "시스템사업자의 등록번호가 국세청승인번호와 동일하지 않은 경우";
+    };
+    readonly ERR011: {
+      readonly code: "ERR011";
+      readonly description: "수정세금계산서의 당초 국세청승인번호가 존재하지 않는 경우";
+    };
+    readonly ERR099: {
+      readonly code: "ERR099";
+      readonly description: "사전에 정의되지 않은 기타오류가 발생한 경우";
+    };
+  };
+};
+/**
+ * 하위 호환용 응답코드 네임스페이스.
+ *
+ * `stateCode`와 `ntssendErrCode`를 함께 노출한다.
+ */
+declare const TAX_INVOICE_RESPONSE_CODES: {
+  readonly state: {
+    /**
+     * 정발행 상태코드.
+     */
+    readonly REGULAR: {
+      readonly TEMPORARY_SAVED: {
+        readonly code: 100;
+        readonly message: "임시저장";
+        readonly description: "공급자가 작성한 세금계산서가 임시저장된 상태";
+      };
+      readonly ISSUED: {
+        readonly code: 300;
+        readonly message: "발행완료";
+        readonly description: "전자세금계산서 발행이 완료된 상태";
+      };
+      readonly BEFORE_NTS_TRANSMISSION: {
+        readonly code: 301;
+        readonly message: "전송전";
+        readonly description: "팝빌에서 국세청 전송을 준비중인 상태";
+      };
+      readonly PENDING_NTS_TRANSMISSION: {
+        readonly code: 302;
+        readonly message: "전송대기";
+        readonly description: "팝빌에서 국세청 전송을 대기중인 상태";
+      };
+      readonly TRANSMITTING_TO_NTS: {
+        readonly code: 303;
+        readonly message: "전송중";
+        readonly description: "팝빌에서 국세청 전송을 진행중인 상태";
+      };
+      readonly NTS_TRANSMISSION_SUCCESS: {
+        readonly code: 304;
+        readonly message: "전송성공";
+        readonly description: "전자세금계산서 국세청 신고가 정상적으로 완료된 상태";
+      };
+      readonly NTS_TRANSMISSION_FAILED: {
+        readonly code: 305;
+        readonly message: "전송실패";
+        readonly description: "국세청이 특정사유로 전자세금계산서 신고를 반려한 상태";
+      };
+      readonly ISSUE_CANCELED: {
+        readonly code: 600;
+        readonly message: "발행취소";
+        readonly description: "공급자가 발행완료된 전자세금계산서를 취소한 상태 (국세청 전송 대상에서 제외)";
+      };
+    };
+    /**
+     * 역발행 상태코드.
+     */
+    readonly REVERSE: {
+      readonly TEMPORARY_SAVED: {
+        readonly code: 100;
+        readonly message: "임시저장";
+        readonly description: "공급받는자가 작성한 세금계산서가 임시저장된 상태";
+      };
+      readonly REVERSE_ISSUE_PENDING: {
+        readonly code: 200;
+        readonly message: "(역)발행대기";
+        readonly description: "공급자에게 전자세금계산서 (역)발행을 요청한 상태";
+      };
+      readonly ISSUED: {
+        readonly code: 300;
+        readonly message: "발행완료";
+        readonly description: "전자세금계산서 발행이 완료된 상태";
+      };
+      readonly BEFORE_NTS_TRANSMISSION: {
+        readonly code: 301;
+        readonly message: "전송전";
+        readonly description: "팝빌에서 국세청 전송을 준비중인 상태";
+      };
+      readonly PENDING_NTS_TRANSMISSION: {
+        readonly code: 302;
+        readonly message: "전송대기";
+        readonly description: "팝빌에서 국세청 전송을 대기중인 상태";
+      };
+      readonly TRANSMITTING_TO_NTS: {
+        readonly code: 303;
+        readonly message: "전송중";
+        readonly description: "팝빌에서 국세청 전송을 진행중인 상태";
+      };
+      readonly NTS_TRANSMISSION_SUCCESS: {
+        readonly code: 304;
+        readonly message: "전송성공";
+        readonly description: "전자세금계산서 국세청 신고가 정상적으로 완료된 상태";
+      };
+      readonly NTS_TRANSMISSION_FAILED: {
+        readonly code: 305;
+        readonly message: "전송실패";
+        readonly description: "국세청이 특정사유로 전자세금계산서 신고를 반려한 상태";
+      };
+      readonly REVERSE_ISSUE_REJECTED: {
+        readonly code: 400;
+        readonly message: "(역)발행거부";
+        readonly description: "공급자가 (역)발행대기 세금계산서를 거부한 상태";
+      };
+      readonly REVERSE_ISSUE_CANCELED: {
+        readonly code: 500;
+        readonly message: "(역)발행취소";
+        readonly description: "공급받는자가 (역)발행대기 세금계산서를 취소한 상태";
+      };
+      readonly ISSUE_CANCELED: {
+        readonly code: 600;
+        readonly message: "발행취소";
+        readonly description: "공급자가 발행완료된 전자세금계산서를 취소한 상태 (국세청 전송 대상에서 제외)";
+      };
+    };
+    /**
+     * 위수탁 상태코드.
+     */
+    readonly TRUSTEE: {
+      readonly TEMPORARY_SAVED: {
+        readonly code: 100;
+        readonly message: "임시저장";
+        readonly description: "수탁자가 작성한 세금계산서가 임시저장된 상태";
+      };
+      readonly ISSUED: {
+        readonly code: 300;
+        readonly message: "발행완료";
+        readonly description: "전자세금계산서 발행이 완료된 상태";
+      };
+      readonly BEFORE_NTS_TRANSMISSION: {
+        readonly code: 301;
+        readonly message: "전송전";
+        readonly description: "팝빌에서 국세청 전송을 준비중인 상태";
+      };
+      readonly PENDING_NTS_TRANSMISSION: {
+        readonly code: 302;
+        readonly message: "전송대기";
+        readonly description: "팝빌에서 국세청 전송을 대기중인 상태";
+      };
+      readonly TRANSMITTING_TO_NTS: {
+        readonly code: 303;
+        readonly message: "전송중";
+        readonly description: "팝빌에서 국세청 전송을 진행중인 상태";
+      };
+      readonly NTS_TRANSMISSION_SUCCESS: {
+        readonly code: 304;
+        readonly message: "전송성공";
+        readonly description: "전자세금계산서 국세청 신고가 정상적으로 완료된 상태";
+      };
+      readonly NTS_TRANSMISSION_FAILED: {
+        readonly code: 305;
+        readonly message: "전송실패";
+        readonly description: "국세청이 특정사유로 전자세금계산서 신고를 반려한 상태";
+      };
+      readonly ISSUE_CANCELED: {
+        readonly code: 600;
+        readonly message: "발행취소";
+        readonly description: "수탁자가 발행완료된 전자세금계산서를 취소한 상태 (국세청 전송 대상에서 제외)";
+      };
+    };
+  };
+  readonly ntsResult: {
+    readonly SUCCESS: {
+      readonly SUC001: {
+        readonly code: "SUC001";
+        readonly description: "국세청의 검증 과정을 통과하여 전자세금계산서 신고가 정상적으로 완료된 경우";
+      };
+    };
+    readonly FAILURE: {
+      readonly SYN002: {
+        readonly code: "SYN002";
+        readonly description: "전자세금계산서의 전자서명이 유효하지 않은 경우";
+      };
+      readonly SYN003: {
+        readonly code: "SYN003";
+        readonly description: "국세청에 중복된 국세청승인번호가 존재하는 경우";
+      };
+      readonly SYN004: {
+        readonly code: "SYN004";
+        readonly description: "전자세금계산서의 국세청 신고 형식이 유효하지 않은 경우";
+      };
+      readonly ERR001: {
+        readonly code: "ERR001";
+        readonly description: "공급자의 사업자번호가 국세청에 등록되지 않은 경우";
+      };
+      readonly ERR002: {
+        readonly code: "ERR002";
+        readonly description: "공급받는자의 사업자번호 또는 주민등록번호가 국세청에 등록되지 않은 경우";
+      };
+      readonly ERR003: {
+        readonly code: "ERR003";
+        readonly description: "수탁자의 사업자번호가 국세청에 등록되지 않은 경우";
+      };
+      readonly ERR005: {
+        readonly code: "ERR005";
+        readonly description: "발행일시가 유효하지 않는 경우";
+      };
+      readonly ERR006: {
+        readonly code: "ERR006";
+        readonly description: "작성일자가 유효하지 않는 경우";
+      };
+      readonly ERR007: {
+        readonly code: "ERR007";
+        readonly description: "공급가액 또는 세액이 유효하지 않은 경우";
+      };
+      readonly ERR008: {
+        readonly code: "ERR008";
+        readonly description: "수정세금계산서의 수정 사유코드가 유효하지 않은 경우";
+      };
+      readonly ERR009: {
+        readonly code: "ERR009";
+        readonly description: "폐업된 사업자번호로 폐업신고일자 이후 전자세금계산서를 발행한 경우";
+      };
+      readonly ERR010: {
+        readonly code: "ERR010";
+        readonly description: "시스템사업자의 등록번호가 국세청승인번호와 동일하지 않은 경우";
+      };
+      readonly ERR011: {
+        readonly code: "ERR011";
+        readonly description: "수정세금계산서의 당초 국세청승인번호가 존재하지 않는 경우";
+      };
+      readonly ERR099: {
+        readonly code: "ERR099";
+        readonly description: "사전에 정의되지 않은 기타오류가 발생한 경우";
+      };
+    };
+  };
+};
+type TaxInvoiceResponseCodeGroups = keyof typeof TAX_INVOICE_RESPONSE_CODES;
+type ValueOf<T> = T[keyof T];
+type TaxInvoiceStateCodeDefinitionValue = ValueOf<ValueOf<typeof TAX_INVOICE_STATE_CODES>>;
+type TaxInvoiceStateCode = TaxInvoiceStateCodeDefinitionValue['code'];
+type TaxInvoiceNtsResultCodeDefinitionValue = ValueOf<ValueOf<typeof TAX_INVOICE_NTS_RESULT_CODES>>;
+type TaxInvoiceNtsResultCode = TaxInvoiceNtsResultCodeDefinitionValue['code'];
+//#endregion
+//#region src/tax-invoice/models.d.ts
+type ExtensibleTaxInvoiceStateCode = TaxInvoiceStateCode | (number & {}) | (string & {});
+type ExtensibleTaxInvoiceNtsResultCode = TaxInvoiceNtsResultCode | (string & {});
+/**
+ * Tax Invoice Domain Raw Models
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/issue
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/etc
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/cert
+ */
+/**
+ * 세금계산서 상세항목(raw).
+ */
+interface TaxInvoiceDetailApiModel {
+  /**
+   * 일련번호.
+   *
+   * detailList 항목에서 필수 입력값.
+   */
+  serialNum: number;
+  /**
+   * 거래일자
+   */
+  purchaseDT?: TaxInvoiceDateString;
+  /**
+   * 품목명
+   */
+  itemName?: string;
+  /**
+   * 규격
+   */
+  spec?: string;
+  /**
+   * 수량
+   */
+  qty?: string;
+  /**
+   * 단가
+   */
+  unitCost?: string;
+  /**
+   * 공급가액
+   */
+  supplyCost?: string;
+  /**
+   * 세액
+   */
+  tax?: string;
+  /**
+   * 비고
+   */
+  remark?: string;
+}
+/**
+ * 세금계산서 추가 담당자(raw).
+ */
+interface TaxInvoiceAdditionalContactApiModel {
+  /**
+   * 일련번호.
+   *
+   * addContactList 항목에서 필수 입력값.
+   */
+  serialNum: number;
+  /**
+   * 담당자명
+   */
+  contactName?: string;
+  /**
+   * 이메일주소.
+   *
+   * addContactList 항목에서 필수 입력값.
+   */
+  email: string;
+}
+/**
+ * 세금계산서 문서 본문(raw).
+ */
+interface TaxInvoiceApiModel {
+  /**
+   * 거래명세서 동시작성 여부
+   */
+  writeSpecification?: boolean;
+  /**
+   * 작성일자
+   */
+  writeDate?: TaxInvoiceDateString;
+  /**
+   * 정과금/역과금
+   */
+  chargeDirection?: string;
+  /**
+   * 발행형태 [정발행,역발행,위수탁]
+   */
+  issueType?: IssueType;
+  /**
+   * 영수/청구
+   */
+  purposeType?: PurposeType;
+  /**
+   * 발행시기
+   */
+  issueTiming?: string;
+  /**
+   * 과세형태 [과세,영세,면세]
+   */
+  taxType?: TaxType;
+  /**
+   * 공급자 사업자번호
+   */
+  invoicerCorpNum?: string;
+  /**
+   * [공급자] 문서번호
+   */
+  invoicerMgtKey?: string;
+  /**
+   * 공급자 종사업장 식별번호, 필요시 기재. 형식은 숫자 4자리.
+   */
+  invoicerTaxRegID?: string;
+  /**
+   * 공급자 상호
+   */
+  invoicerCorpName?: string;
+  /**
+   * 공급자 대표자 성명
+   */
+  invoicerCEOName?: string;
+  /**
+   * 공급자 주소
+   */
+  invoicerAddr?: string;
+  /**
+   * 공급자 업태
+   */
+  invoicerBizClass?: string;
+  /**
+   * 공급자 종목
+   */
+  invoicerBizType?: string;
+  /**
+   * 공급자 담당자명
+   */
+  invoicerContactName?: string;
+  /**
+   * 공급자 담당자 연락처
+   */
+  invoicerTEL?: string;
+  /**
+   * 공급자 담당자 휴대폰번호
+   */
+  invoicerHP?: string;
+  /**
+   * 공급자 담당자 이메일
+   */
+  invoicerEmail?: string;
+  /**
+   * 공급자 담당자 휴대폰번호 문자발송 여부
+   */
+  invoicerSMSSendYN?: boolean | string;
+  /**
+   * 공급자 인쇄여부
+   */
+  invoicerPrintYN?: boolean | string;
+  /**
+   * 공급자 주민번호
+   */
+  invoicerRDN?: string;
+  /**
+   * 공급자 외국인번호
+   */
+  invoicerOLN?: string;
+  /**
+   * 공급자 종사업자번호
+   */
+  invoicerTaxNum?: string;
+  /**
+   * 공급자 종사업자 일련번호
+   */
+  invoicerPSerialNum?: string;
+  /**
+   * 공급자 법인구분 [개인, 법인]
+   */
+  invoicerCorpCls?: string;
+  /**
+   * 공급자 부서명
+   */
+  invoicerDeptName?: string;
+  /**
+   * 공급받는자 구분 [사업자,개인,외국인]
+   */
+  invoiceeType?: InvoiceeType;
+  /**
+   * 공급받는자 사업자번호 [개인:주민등록번호 / 외국인:외국인등록번호]
+   */
+  invoiceeCorpNum?: string;
+  /**
+   * [공급받는자] 문서번호
+   */
+  invoiceeMgtKey?: string;
+  /**
+   * 공급받는자 종사업장 식별번호, 필요시 기재. 형식은 숫자 4자리.
+   */
+  invoiceeTaxRegID?: string;
+  /**
+   * 공급받는자 상호
+   */
+  invoiceeCorpName?: string;
+  /**
+   * 공급받는자 대표자 성명
+   */
+  invoiceeCEOName?: string;
+  /**
+   * 공급받는자 주소
+   */
+  invoiceeAddr?: string;
+  /**
+   * 공급받는자 업태
+   */
+  invoiceeBizClass?: string;
+  /**
+   * 공급받는자 종목
+   */
+  invoiceeBizType?: string;
+  /**
+   * 공급받는자 담당자명
+   */
+  invoiceeContactName1?: string;
+  /**
+   * 공급받는자 담당자 연락처
+   */
+  invoiceeTEL1?: string;
+  /**
+   * 공급받는자 담당자 휴대폰번호
+   */
+  invoiceeHP1?: string;
+  /**
+   * 공급받는자 담당자 이메일
+   */
+  invoiceeEmail1?: string;
+  /**
+   * 공급받는자 예비 담당자명
+   */
+  invoiceeContactName2?: string;
+  /**
+   * 공급받는자 예비 담당자 연락처
+   */
+  invoiceeTEL2?: string;
+  /**
+   * 공급받는자 예비 담당자 휴대폰번호
+   */
+  invoiceeHP2?: string;
+  /**
+   * 공급받는자 예비 담당자 이메일
+   */
+  invoiceeEmail2?: string;
+  /**
+   * 공급받는자 담당자 휴대폰번호 문자발송 여부
+   */
+  invoiceeSMSSendYN?: boolean | string;
+  /**
+   * 공급받는자 인쇄여부
+   */
+  invoiceePrintYN?: boolean | string;
+  /**
+   * 공급받는자 주민번호
+   */
+  invoiceeRDN?: string;
+  /**
+   * 공급받는자 외국인번호
+   */
+  invoiceeOLN?: string;
+  /**
+   * 공급받는자 종사업자번호
+   */
+  invoiceeTaxNum?: string;
+  /**
+   * 공급받는자 종사업자 일련번호
+   */
+  invoiceePSerialNum?: string;
+  /**
+   * 공급받는자 법인구분 [개인, 법인]
+   */
+  invoiceeCorpCls?: string;
+  /**
+   * 공급받는자 부서명
+   */
+  invoiceeDeptName1?: string;
+  /**
+   * 공급받는자 예비부서명
+   */
+  invoiceeDeptName2?: string;
+  /**
+   * 공급받는자 휴폐업 상태 [null,0,1,2,3,4]
+   */
+  closeDownState?: CloseDownState;
+  /**
+   * 공급받는자 휴폐업일자
+   */
+  closeDownStateDate?: TaxInvoiceDateString;
+  /**
+   * 수탁자 사업자번호
+   */
+  trusteeCorpNum?: string;
+  /**
+   * [수탁자] 문서번호
+   */
+  trusteeMgtKey?: string;
+  /**
+   * 수탁자 종사업장 식별번호, 필요시 기재. 형식은 숫자 4자리.
+   */
+  trusteeTaxRegID?: string;
+  /**
+   * 수탁자 상호
+   */
+  trusteeCorpName?: string;
+  /**
+   * 수탁자 대표자 성명
+   */
+  trusteeCEOName?: string;
+  /**
+   * 수탁자 주소
+   */
+  trusteeAddr?: string;
+  /**
+   * 수탁자 업태
+   */
+  trusteeBizClass?: string;
+  /**
+   * 수탁자 종목
+   */
+  trusteeBizType?: string;
+  /**
+   * 수탁자 담당자명
+   */
+  trusteeContactName?: string;
+  /**
+   * 수탁자 담당자 연락처
+   */
+  trusteeTEL?: string;
+  /**
+   * 수탁자 담당자 휴대폰번호
+   */
+  trusteeHP?: string;
+  /**
+   * 수탁자 담당자 이메일
+   */
+  trusteeEmail?: string;
+  /**
+   * 수탁자 담당자 휴대폰번호 문자발송 여부
+   */
+  trusteeSMSSendYN?: boolean | string;
+  /**
+   * 수탁자 인쇄여부
+   */
+  trusteePrintYN?: boolean | string;
+  /**
+   * 수탁자 주민번호
+   */
+  trusteeRDN?: string;
+  /**
+   * 수탁자 외국인번호
+   */
+  trusteeOLN?: string;
+  /**
+   * 수탁자 종사업자번호
+   */
+  trusteeTaxNum?: string;
+  /**
+   * 수탁자 종사업자 일련번호
+   */
+  trusteePSerialNum?: string;
+  /**
+   * 수탁자 법인구분 [개인, 법인]
+   */
+  trusteeCorpCls?: string;
+  /**
+   * 수탁자 부서명
+   */
+  trusteeDeptName?: string;
+  /**
+   * 세액합계
+   */
+  taxTotal?: string;
+  /**
+   * 공급가액 합계
+   */
+  supplyCostTotal?: string;
+  /**
+   * 합계금액 합계
+   */
+  totalAmount?: string;
+  /**
+   * 수정세금계산서 사유코드
+   */
+  modifyCode?: TaxInvoiceModifyCode;
+  /**
+   * 수정세금계산서 작성시 원본세금계산서의 국세청승인번호
+   */
+  orgNTSConfirmNum?: string;
+  /**
+   * 기재상 일련번호
+   */
+  serialNum?: string;
+  /**
+   * 현금
+   */
+  cash?: string;
+  /**
+   * 수표
+   */
+  chkBill?: string;
+  /**
+   * 어음
+   */
+  note?: string;
+  /**
+   * 외상
+   */
+  credit?: string;
+  /**
+   * 비고1
+   */
+  remark1?: string;
+  /**
+   * 비고2
+   */
+  remark2?: string;
+  /**
+   * 비고3
+   */
+  remark3?: string;
+  /**
+   * 책번호 '권' 항목
+   */
+  kwon?: string;
+  /**
+   * 책번호 '호' 항목
+   */
+  ho?: string;
+  /**
+   * 사업자등록증 이미지 첨부여부
+   */
+  businessLicenseYN?: boolean | string;
+  /**
+   * 통장사본 이미지 첨부여부
+   */
+  bankBookYN?: boolean | string;
+  /**
+   * 발행일시
+   */
+  issueDT?: string;
+  /**
+   * 상태코드
+   */
+  stateCode?: ExtensibleTaxInvoiceStateCode;
+  /**
+   * 상태코드 갱신일시
+   */
+  stateDT?: string;
+  /**
+   * 지연발행 여부
+   */
+  lateIssueYN?: boolean | string;
+  /**
+   * 개봉 여부
+   */
+  openYN?: boolean | string;
+  /**
+   * 개봉일시
+   */
+  openDT?: string;
+  /**
+   * 국세청승인번호
+   */
+  ntsconfirmNum?: string;
+  /**
+   * 국세청 전송결과
+   */
+  ntsresult?: string;
+  /**
+   * 국세청 전송일시
+   */
+  ntssendDT?: string;
+  /**
+   * 국세청 결과 수신일시
+   */
+  ntsresultDT?: string;
+  /**
+   * 국세청 전송결과코드
+   */
+  ntssendErrCode?: ExtensibleTaxInvoiceNtsResultCode;
+  /**
+   * 정발행 역발행 여부
+   */
+  interOPYN?: boolean | string;
+  /**
+   * 상세항목
+   */
+  detailList?: TaxInvoiceDetailApiModel[];
+  /**
+   * 추가담당자
+   */
+  addContactList?: TaxInvoiceAdditionalContactApiModel[];
+  [key: string]: unknown;
+}
+/**
+ * 세금계산서 요약정보(raw).
+ */
+interface TaxInvoiceInfoApiModel {
+  /**
+   * 문서 아이템키
+   */
+  itemKey: string;
+  /**
+   * 과세형태 [과세,영세,면세]
+   */
+  taxType: TaxType;
+  /**
+   * 작성일자
+   */
+  writeDate: TaxInvoiceDateString;
+  /**
+   * 등록일시
+   */
+  regDT: string;
+  /**
+   * 발행형태 [정발행,역발행,위수탁]
+   */
+  issueType: IssueType;
+  /**
+   * 공급가액 합계
+   */
+  supplyCostTotal: string;
+  /**
+   * 세액 합계
+   */
+  taxTotal: string;
+  /**
+   * 영수/청구
+   */
+  purposeType: PurposeType;
+  /**
+   * 발행일시
+   */
+  issueDT: string;
+  /**
+   * 지연발행여부
+   */
+  lateIssueYN: boolean | string;
+  /**
+   * 개봉 여부
+   */
+  openYN: boolean | string;
+  /**
+   * 개봉일시
+   */
+  openDT?: string;
+  /**
+   * 상태메모
+   */
+  stateMemo: string;
+  /**
+   * 상태코드
+   */
+  stateCode: ExtensibleTaxInvoiceStateCode;
+  /**
+   * 상태코드 갱신일시
+   */
+  stateDT: string;
+  /**
+   * 국세청승인번호
+   */
+  ntsconfirmNum?: string;
+  /**
+   * 국세청 전송결과
+   */
+  ntsresult?: string;
+  /**
+   * 국세청 전송일시
+   */
+  ntssendDT?: string;
+  /**
+   * 국세청 결과 수신일시
+   */
+  ntsresultDT?: string;
+  /**
+   * 국세청 전송결과코드
+   */
+  ntssendErrCode?: ExtensibleTaxInvoiceNtsResultCode;
+  /**
+   * 수정세금계산서 사유코드
+   */
+  modifyCode?: TaxInvoiceModifyCode;
+  /**
+   * 정발행 역발행 여부
+   */
+  interOPYN: boolean | string;
+  /**
+   * 공급자 상호
+   */
+  invoicerCorpName: string;
+  /**
+   * 공급자 사업자번호
+   */
+  invoicerCorpNum: string;
+  /**
+   * 공급자 문서번호
+   */
+  invoicerMgtKey?: string;
+  /**
+   * 공급자 인쇄여부
+   */
+  invoicerPrintYN: boolean | string;
+  /**
+   * 공급받는자 상호
+   */
+  invoiceeCorpName: string;
+  /**
+   * 공급받는자 사업자번호
+   */
+  invoiceeCorpNum: string;
+  /**
+   * 공급받는자 문서번호
+   */
+  invoiceeMgtKey?: string;
+  /**
+   * 공급받는자 인쇄여부
+   */
+  invoiceePrintYN: boolean | string;
+  /**
+   * 휴폐업 상태 [미등록, 휴업, 폐업]
+   */
+  closeDownState?: CloseDownState;
+  /**
+   * 휴폐업일자
+   */
+  closeDownStateDate?: TaxInvoiceDateString;
+  /**
+   * 수탁자 상호
+   */
+  trusteeCorpName?: string;
+  /**
+   * 수탁자 사업자번호
+   */
+  trusteeCorpNum?: string;
+  /**
+   * 수탁자 문서번호
+   */
+  trusteeMgtKey?: string;
+  /**
+   * 수탁자 인쇄여부
+   */
+  trusteePrintYN?: boolean | string;
+  [key: string]: unknown;
+}
+/**
+ * 전자서명 이력(raw).
+ */
+interface TaxInvoiceLogApiModel {
+  /**
+   * 문서이력 유형
+   */
+  docLogType?: number | string;
+  /**
+   * 로그
+   */
+  log?: string;
+  /**
+   * 처리형태
+   */
+  procType?: string;
+  /**
+   * 처리회사명
+   */
+  procCorpName?: string;
+  /**
+   * 처리담당자
+   */
+  procContactName?: string;
+  /**
+   * 처리형태명
+   */
+  procMemo?: string;
+  /**
+   * 등록일시
+   */
+  regDT?: string;
+  /**
+   * IP주소
+   */
+  ip?: string;
+  [key: string]: unknown;
+}
+/**
+ * 첨부파일 메타(raw).
+ */
+interface TaxInvoiceFileMetaApiModel {
+  /**
+   * 파일아이디
+   */
+  serialNum?: number;
+  /**
+   * 첨부파일명
+   */
+  attachedFile?: string;
+  /**
+   * 표시명
+   */
+  displayName?: string;
+  /**
+   * 등록일시
+   */
+  regDT?: string;
+  [key: string]: unknown;
+}
+/**
+ * Search 결과 list 항목(raw).
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info#Search
+ *
+ * Search 응답 list는 `GetInfo` 응답 구성과 동일하다.
+ */
+type TaxInvoiceSearchResultItemApiModel = TaxInvoiceInfoApiModel;
+/**
+ * 세금계산서 Search 응답(raw).
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info#Search
+ */
+interface TaxInvoiceSearchResultApiModel extends TaxInvoiceApiResponseBase {
+  /**
+   * 검색결과 전체 건수
+   */
+  total?: number | string;
+  /**
+   * 페이지당 목록개수
+   */
+  perPage?: number | string;
+  /**
+   * 페이지 번호
+   */
+  pageNum?: number | string;
+  /**
+   * 페이지수
+   */
+  pageCount?: number | string;
+  /**
+   * 검색결과 목록
+   */
+  list?: TaxInvoiceSearchResultItemApiModel[];
+}
+/**
+ * 즉시발행 결과(raw).
+ */
+interface TaxInvoiceIssueResponseApiModel extends TaxInvoiceApiResponseBase {
+  /**
+   * 국세청승인번호
+   */
+  ntsConfirmNum?: string;
+  /**
+   * 발행일시
+   */
+  issueDT?: string;
+}
+/**
+ * 대량접수 결과(raw).
+ */
+interface TaxInvoiceBulkSubmitResponseApiModel extends TaxInvoiceApiResponseBase {
+  /**
+   * 접수아이디
+   */
+  receiptID?: string;
+}
+/**
+ * 대량접수 상세 결과(raw).
+ */
+interface TaxInvoiceBulkResultItemApiModel {
+  /**
+   * 문서번호 유형
+   */
+  keyType?: TaxInvoiceMgtKeyType;
+  /**
+   * [공급자] 문서번호
+   */
+  invoicerMgtKey?: string;
+  /**
+   * [수탁자] 문서번호
+   */
+  trusteeMgtKey?: string;
+  /**
+   * 처리결과 코드
+   */
+  code?: number | string;
+  /**
+   * 처리결과 메시지
+   */
+  message?: string;
+  /**
+   * 국세청승인번호
+   */
+  ntsconfirmNum?: string;
+  /**
+   * 접수일시
+   */
+  receiptDT?: string;
+  /**
+   * 발행일시
+   */
+  issueDT?: string;
+  [key: string]: unknown;
+}
+/**
+ * 대량접수 조회(raw).
+ */
+interface TaxInvoiceBulkResultApiModel extends TaxInvoiceApiResponseBase {
+  /**
+   * 접수아이디
+   */
+  receiptID?: string;
+  /**
+   * 제출아이디
+   */
+  submitID?: string;
+  /**
+   * 제출건수
+   */
+  submitCount?: number | string;
+  /**
+   * 성공건수
+   */
+  successCount?: number | string;
+  /**
+   * 실패건수
+   */
+  failCount?: number | string;
+  /**
+   * 처리상태 [0:미처리, 1:처리중, 2:완료]
+   */
+  txState?: number | string;
+  /**
+   * 처리시작일시
+   */
+  txStartDT?: string;
+  /**
+   * 처리완료일시
+   */
+  txEndDT?: string;
+  /**
+   * 처리결과코드
+   */
+  txResultCode?: number | string;
+  /**
+   * 세금계산서 발행처리 결과
+   */
+  issueResult?: TaxInvoiceBulkResultItemApiModel[];
+}
+/**
+ * 국세청 인증서 정보(raw).
+ */
+interface TaxInvoiceTaxCertInfoApiModel {
+  /**
+   * 등록일시
+   *
+   * `yyyyMMddHHmmss` 형식.
+   */
+  regDT?: string;
+  /**
+   * 만료일시
+   *
+   * `yyyyMMddHHmmss` 형식.
+   */
+  expireDT?: string;
+  /**
+   * 발급자 Distinguished Name
+   */
+  issuerDN?: string;
+  /**
+   * 인증서 Distinguished Name
+   */
+  subjectDN?: string;
+  /**
+   * 인증서 종류
+   */
+  issuerName?: string;
+  /**
+   * 인증서 정책 OID
+   */
+  OID?: string;
+  /**
+   * 등록 담당자 성명
+   */
+  regContactName?: string;
+  /**
+   * 등록 담당자 아이디
+   */
+  regContactID?: string;
+  [key: string]: unknown;
+}
+/**
+ * 이메일 발송설정(raw).
+ */
+interface TaxInvoiceEmailConfigApiModel {
+  /**
+   * 메일전송 설정 구분코드
+   */
+  emailType?: TaxInvoiceEmailType;
+  /**
+   * 전송여부
+   */
+  sendYN?: boolean | string;
+  [key: string]: unknown;
+}
+//#endregion
+//#region src/tax-invoice/info/get-info.d.ts
+/**
+ * TaxInvoice GetInfo Raw Spec
+ *
+ * Source
+ * - https://developers.popbill.com/api-reference/taxinvoice/api/info#GetInfo
+ */
+/**
+ * GetInfo API path 파라미터.
+ */
+interface TaxInvoiceGetInfoApiRequestPath {
+  /**
+   * 문서번호 유형.
+   *
+   * - `SELL`: 매출
+   * - `BUY`: 매입
+   * - `TRUSTEE`: 위수탁
+   */
+  MgtKeyType: TaxInvoiceMgtKeyType;
+  /**
+   * 파트너가 할당한 문서번호.
+   *
+   * 최대 24자.
+   */
+  MgtKey: string;
+}
+/**
+ * GetInfo API query 파라미터.
+ */
+type TaxInvoiceGetInfoApiRequestQuery = never;
+/**
+ * GetInfo API body.
+ */
+type TaxInvoiceGetInfoApiRequestBody = never;
+/**
+ * GetInfo API 요청(raw).
+ */
+type TaxInvoiceGetInfoApiRequest = TaxInvoiceRequireRequestFields<TaxInvoiceApiRequest<TaxInvoiceGetInfoApiRequestPath, TaxInvoiceGetInfoApiRequestQuery, TaxInvoiceGetInfoApiRequestBody>, 'path'>;
+type TaxInvoiceGetInfoApiResponse = TaxInvoiceInfoApiModel;
+type TaxInvoiceInfoApiResponse = TaxInvoiceGetInfoApiResponse;
+//#endregion
+export { TaxInvoiceSearchCloseDownState as $, TaxInvoiceStateCodeDefinitionValue as A, TaxInvoiceApiRequestHeaders as B, TAX_INVOICE_STATE_CODES as C, TaxInvoiceResponseCodeGroups as D, TaxInvoiceNtsResultCodeDefinitionValue as E, IssueType as F, TaxInvoiceDateTypeMap as G, TaxInvoiceBulkIssueRequestHeaders as H, IssueTypeMap as I, TaxInvoiceMgtKeyType as J, TaxInvoiceEmailType as K, PurposeType as L, CloseDownStateMap as M, InvoiceeType as N, TaxInvoiceStateCode as O, InvoiceeTypeMap as P, TaxInvoiceRequireRequestFields as Q, PurposeTypeMap as R, TAX_INVOICE_RESPONSE_CODES as S, TaxInvoiceNtsResultCodeDefinition as T, TaxInvoiceDateString as U, TaxInvoiceApiResponseBase as V, TaxInvoiceDateType as W, TaxInvoiceModifyCode as X, TaxInvoiceMgtKeyTypeMap as Y, TaxInvoiceModifyCodeMap as Z, TaxInvoiceLogApiModel as _, PopbillHttpMethodOverrides as _t, TaxInvoiceGetInfoApiResponse as a, PopbillApiRequest as at, TaxInvoiceTaxCertInfoApiModel as b, TaxInvoiceApiModel as c, PopbillAcceptEncodingMap as ct, TaxInvoiceBulkSubmitResponseApiModel as d, PopbillAcceptLanguages as dt, TaxInvoiceSearchCloseDownStateMap as et, TaxInvoiceDetailApiModel as f, PopbillApiRequestHeaders as ft, TaxInvoiceIssueResponseApiModel as g, PopbillHttpMethodOverride as gt, TaxInvoiceInfoApiModel as h, PopbillDefaultResponseLanguage as ht, TaxInvoiceGetInfoApiRequestQuery as i, TaxTypeMap as it, CloseDownState as j, TaxInvoiceStateCodeDefinition as k, TaxInvoiceBulkResultApiModel as l, PopbillAcceptLanguage as lt, TaxInvoiceFileMetaApiModel as m, PopbillBulkIssueRequestHeaders as mt, TaxInvoiceGetInfoApiRequestBody as n, TaxInvoiceSortOrderMap as nt, TaxInvoiceInfoApiResponse as o, PopbillRequireRequestFields as ot, TaxInvoiceEmailConfigApiModel as p, PopbillAuthorizationHeader as pt, TaxInvoiceEmailTypeMap as q, TaxInvoiceGetInfoApiRequestPath as r, TaxType as rt, TaxInvoiceAdditionalContactApiModel as s, PopbillAcceptEncoding as st, TaxInvoiceGetInfoApiRequest as t, TaxInvoiceSortOrder as tt, TaxInvoiceBulkResultItemApiModel as u, PopbillAcceptLanguageMap as ut, TaxInvoiceSearchResultApiModel as v, TaxInvoiceNtsResultCode as w, TAX_INVOICE_NTS_RESULT_CODES as x, TaxInvoiceSearchResultItemApiModel as y, TaxInvoiceApiRequest as z };