@cmarket/partner-sdk 0.7.0 → 0.8.0

package/README.md

@@ -188,7 +188,7 @@ public class Quickstart {
 
 ---
 
-## @cmarket/partner-sdk@0.7.0
+## @cmarket/partner-sdk@0.8.0
 
 This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
 
@@ -226,7 +226,7 @@ navigate to the folder of your consuming project and run one of the following co
 _published:_
 
 ```
-npm install @cmarket/partner-sdk@0.7.0 --save
+npm install @cmarket/partner-sdk@0.8.0 --save
 ```
 
 _unPublished (not recommended):_
@@ -292,6 +292,7 @@ Class | Method | HTTP request | Description
  - [NegotiationScoreDto](docs/NegotiationScoreDto.md)
  - [NegotiationScoredResponseDto](docs/NegotiationScoredResponseDto.md)
  - [PreconditionsDto](docs/PreconditionsDto.md)
+ - [ProblemDetailsDto](docs/ProblemDetailsDto.md)
  - [RegisterAwardRequestDto](docs/RegisterAwardRequestDto.md)
  - [RequestSplitInvoiceRequestDto](docs/RequestSplitInvoiceRequestDto.md)
  - [SplitInvoiceResponseDto](docs/SplitInvoiceResponseDto.md)

package/api/partner-v1-api.ts

@@ -54,6 +54,8 @@ import type { MarkBidFailedRequestDto } from '../models';
 // @ts-ignore
 import type { NegotiationScoredResponseDto } from '../models';
 // @ts-ignore
+import type { ProblemDetailsDto } from '../models';
+// @ts-ignore
 import type { RegisterAwardRequestDto } from '../models';
 // @ts-ignore
 import type { RequestSplitInvoiceRequestDto } from '../models';
@@ -69,16 +71,19 @@ import type { UploadFileRequestDto } from '../models';
 export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * V5 /acceptanceCompleteSend 후속. scope contracts:write + Idempotency-Key.
+         * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 검수완료 전송
-         * @param {string} bidId 
+         * @param {string} bidId 공고 ID(= backend bidId = 등록 응답의 bidNo).
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        completeAcceptance: async (bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        completeAcceptance: async (bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'bidId' is not null or undefined
             assertParamExists('completeAcceptance', 'bidId', bidId)
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            assertParamExists('completeAcceptance', 'idempotencyKey', idempotencyKey)
             // verify required parameter 'completeAcceptanceRequestDto' is not null or undefined
             assertParamExists('completeAcceptance', 'completeAcceptanceRequestDto', completeAcceptanceRequestDto)
             const localVarPath = `/v1/bids/{bidId}/acceptance`
@@ -101,6 +106,9 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -393,13 +401,16 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 유찰 처리(V5 yoochal 패리티). 유찰사유 코드(1~8)·상세를 받아 공고를 유찰 상태로 전환. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 유찰 처리
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {MarkBidFailedRequestDto} markBidFailedRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        markBidFailed: async (markBidFailedRequestDto: MarkBidFailedRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        markBidFailed: async (idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            assertParamExists('markBidFailed', 'idempotencyKey', idempotencyKey)
             // verify required parameter 'markBidFailedRequestDto' is not null or undefined
             assertParamExists('markBidFailed', 'markBidFailedRequestDto', markBidFailedRequestDto)
             const localVarPath = `/v1/awards/fail`;
@@ -421,6 +432,9 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -470,13 +484,16 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 낙찰 결과 등록. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
          * @summary 낙찰 결과 전송
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {RegisterAwardRequestDto} registerAwardRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        registerAward: async (registerAwardRequestDto: RegisterAwardRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        registerAward: async (idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            assertParamExists('registerAward', 'idempotencyKey', idempotencyKey)
             // verify required parameter 'registerAwardRequestDto' is not null or undefined
             assertParamExists('registerAward', 'registerAwardRequestDto', registerAwardRequestDto)
             const localVarPath = `/v1/awards`;
@@ -498,6 +515,9 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -548,13 +568,16 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * V5 /splitInvoiceRequest 후속. scope invoices:write + Idempotency-Key.
+         * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 계산서 분할 발급 청구
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        requestSplitInvoice: async (requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        requestSplitInvoice: async (idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            assertParamExists('requestSplitInvoice', 'idempotencyKey', idempotencyKey)
             // verify required parameter 'requestSplitInvoiceRequestDto' is not null or undefined
             assertParamExists('requestSplitInvoice', 'requestSplitInvoiceRequestDto', requestSplitInvoiceRequestDto)
             const localVarPath = `/v1/invoices/split-requests`;
@@ -576,6 +599,9 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -587,13 +613,16 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 협상에의한계약(H/K) 응찰자별 기술/가격 점수 일괄 입력(V5 nego-eval 패리티). complete=true 면 평가완료 게이트까지 적용해 낙찰 진입 가능. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 협상(H/K) 점수평가
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        submitNegotiationScores: async (submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        submitNegotiationScores: async (idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            assertParamExists('submitNegotiationScores', 'idempotencyKey', idempotencyKey)
             // verify required parameter 'submitNegotiationScoresRequestDto' is not null or undefined
             assertParamExists('submitNegotiationScores', 'submitNegotiationScoresRequestDto', submitNegotiationScoresRequestDto)
             const localVarPath = `/v1/awards/nego-eval`;
@@ -615,6 +644,9 @@ export const PartnerV1ApiAxiosParamCreator = function (configuration?: Configura
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -674,15 +706,16 @@ export const PartnerV1ApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = PartnerV1ApiAxiosParamCreator(configuration)
     return {
         /**
-         * V5 /acceptanceCompleteSend 후속. scope contracts:write + Idempotency-Key.
+         * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 검수완료 전송
-         * @param {string} bidId 
+         * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async completeAcceptance(bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AcceptanceResultResponseDto>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.completeAcceptance(bidId, completeAcceptanceRequestDto, options);
+        async completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AcceptanceResultResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV1Api.completeAcceptance']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -781,14 +814,15 @@ export const PartnerV1ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 유찰 처리(V5 yoochal 패리티). 유찰사유 코드(1~8)·상세를 받아 공고를 유찰 상태로 전환. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 유찰 처리
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {MarkBidFailedRequestDto} markBidFailedRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async markBidFailed(markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedResponseDto>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.markBidFailed(markBidFailedRequestDto, options);
+        async markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.markBidFailed(idempotencyKey, markBidFailedRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV1Api.markBidFailed']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -807,14 +841,15 @@ export const PartnerV1ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 낙찰 결과 등록. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
          * @summary 낙찰 결과 전송
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {RegisterAwardRequestDto} registerAwardRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async registerAward(registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredResponseDto>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.registerAward(registerAwardRequestDto, options);
+        async registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.registerAward(idempotencyKey, registerAwardRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV1Api.registerAward']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -833,27 +868,29 @@ export const PartnerV1ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * V5 /splitInvoiceRequest 후속. scope invoices:write + Idempotency-Key.
+         * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 계산서 분할 발급 청구
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async requestSplitInvoice(requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SplitInvoiceResponseDto>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.requestSplitInvoice(requestSplitInvoiceRequestDto, options);
+        async requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SplitInvoiceResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.requestSplitInvoice(idempotencyKey, requestSplitInvoiceRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV1Api.requestSplitInvoice']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 협상에의한계약(H/K) 응찰자별 기술/가격 점수 일괄 입력(V5 nego-eval 패리티). complete=true 면 평가완료 게이트까지 적용해 낙찰 진입 가능. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 협상(H/K) 점수평가
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async submitNegotiationScores(submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NegotiationScoredResponseDto>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.submitNegotiationScores(submitNegotiationScoresRequestDto, options);
+        async submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NegotiationScoredResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV1Api.submitNegotiationScores']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -881,15 +918,16 @@ export const PartnerV1ApiFactory = function (configuration?: Configuration, base
     const localVarFp = PartnerV1ApiFp(configuration)
     return {
         /**
-         * V5 /acceptanceCompleteSend 후속. scope contracts:write + Idempotency-Key.
+         * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 검수완료 전송
-         * @param {string} bidId 
+         * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        completeAcceptance(bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AcceptanceResultResponseDto> {
-            return localVarFp.completeAcceptance(bidId, completeAcceptanceRequestDto, options).then((request) => request(axios, basePath));
+        completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AcceptanceResultResponseDto> {
+            return localVarFp.completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * V5 /contractDocumentRec 후속. scope contracts:read.
@@ -964,14 +1002,15 @@ export const PartnerV1ApiFactory = function (configuration?: Configuration, base
             return localVarFp.healthControllerCheck(options).then((request) => request(axios, basePath));
         },
         /**
-         * 유찰 처리(V5 yoochal 패리티). 유찰사유 코드(1~8)·상세를 받아 공고를 유찰 상태로 전환. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 유찰 처리
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {MarkBidFailedRequestDto} markBidFailedRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        markBidFailed(markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedResponseDto> {
-            return localVarFp.markBidFailed(markBidFailedRequestDto, options).then((request) => request(axios, basePath));
+        markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedResponseDto> {
+            return localVarFp.markBidFailed(idempotencyKey, markBidFailedRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
@@ -984,14 +1023,15 @@ export const PartnerV1ApiFactory = function (configuration?: Configuration, base
             return localVarFp.recordParityResult(body, options).then((request) => request(axios, basePath));
         },
         /**
-         * 낙찰 결과 등록. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
          * @summary 낙찰 결과 전송
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {RegisterAwardRequestDto} registerAwardRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        registerAward(registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredResponseDto> {
-            return localVarFp.registerAward(registerAwardRequestDto, options).then((request) => request(axios, basePath));
+        registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredResponseDto> {
+            return localVarFp.registerAward(idempotencyKey, registerAwardRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
@@ -1004,24 +1044,26 @@ export const PartnerV1ApiFactory = function (configuration?: Configuration, base
             return localVarFp.registerBid(createBidRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * V5 /splitInvoiceRequest 후속. scope invoices:write + Idempotency-Key.
+         * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 계산서 분할 발급 청구
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        requestSplitInvoice(requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SplitInvoiceResponseDto> {
-            return localVarFp.requestSplitInvoice(requestSplitInvoiceRequestDto, options).then((request) => request(axios, basePath));
+        requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SplitInvoiceResponseDto> {
+            return localVarFp.requestSplitInvoice(idempotencyKey, requestSplitInvoiceRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * 협상에의한계약(H/K) 응찰자별 기술/가격 점수 일괄 입력(V5 nego-eval 패리티). complete=true 면 평가완료 게이트까지 적용해 낙찰 진입 가능. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+         * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 협상(H/K) 점수평가
+         * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        submitNegotiationScores(submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<NegotiationScoredResponseDto> {
-            return localVarFp.submitNegotiationScores(submitNegotiationScoresRequestDto, options).then((request) => request(axios, basePath));
+        submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<NegotiationScoredResponseDto> {
+            return localVarFp.submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
@@ -1041,15 +1083,16 @@ export const PartnerV1ApiFactory = function (configuration?: Configuration, base
  */
 export class PartnerV1Api extends BaseAPI {
     /**
-     * V5 /acceptanceCompleteSend 후속. scope contracts:write + Idempotency-Key.
+     * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 검수완료 전송
-     * @param {string} bidId 
+     * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public completeAcceptance(bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig) {
-        return PartnerV1ApiFp(this.configuration).completeAcceptance(bidId, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
+    public completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig) {
+        return PartnerV1ApiFp(this.configuration).completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
@@ -1132,14 +1175,15 @@ export class PartnerV1Api extends BaseAPI {
     }
 
     /**
-     * 유찰 처리(V5 yoochal 패리티). 유찰사유 코드(1~8)·상세를 받아 공고를 유찰 상태로 전환. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+     * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 유찰 처리
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {MarkBidFailedRequestDto} markBidFailedRequestDto 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public markBidFailed(markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig) {
-        return PartnerV1ApiFp(this.configuration).markBidFailed(markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
+    public markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig) {
+        return PartnerV1ApiFp(this.configuration).markBidFailed(idempotencyKey, markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
@@ -1154,14 +1198,15 @@ export class PartnerV1Api extends BaseAPI {
     }
 
     /**
-     * 낙찰 결과 등록. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
      * @summary 낙찰 결과 전송
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {RegisterAwardRequestDto} registerAwardRequestDto 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public registerAward(registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig) {
-        return PartnerV1ApiFp(this.configuration).registerAward(registerAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
+    public registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig) {
+        return PartnerV1ApiFp(this.configuration).registerAward(idempotencyKey, registerAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
@@ -1176,25 +1221,27 @@ export class PartnerV1Api extends BaseAPI {
     }
 
     /**
-     * V5 /splitInvoiceRequest 후속. scope invoices:write + Idempotency-Key.
+     * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계산서 분할 발급 청구
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public requestSplitInvoice(requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig) {
-        return PartnerV1ApiFp(this.configuration).requestSplitInvoice(requestSplitInvoiceRequestDto, options).then((request) => request(this.axios, this.basePath));
+    public requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig) {
+        return PartnerV1ApiFp(this.configuration).requestSplitInvoice(idempotencyKey, requestSplitInvoiceRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * 협상에의한계약(H/K) 응찰자별 기술/가격 점수 일괄 입력(V5 nego-eval 패리티). complete=true 면 평가완료 게이트까지 적용해 낙찰 진입 가능. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+     * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 협상(H/K) 점수평가
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public submitNegotiationScores(submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig) {
-        return PartnerV1ApiFp(this.configuration).submitNegotiationScores(submitNegotiationScoresRequestDto, options).then((request) => request(this.axios, this.basePath));
+    public submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig) {
+        return PartnerV1ApiFp(this.configuration).submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**