@cmarket/partner-sdk 0.6.2 → 0.8.0

package/dist/api/partner-v1-api.js

@@ -35,16 +35,19 @@ const base_1 = require("../base");
 const PartnerV1ApiAxiosParamCreator = function (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: (bidId_1, completeAcceptanceRequestDto_1, ...args_1) => __awaiter(this, [bidId_1, completeAcceptanceRequestDto_1, ...args_1], void 0, function* (bidId, completeAcceptanceRequestDto, options = {}) {
+        completeAcceptance: (bidId_1, idempotencyKey_1, completeAcceptanceRequestDto_1, ...args_1) => __awaiter(this, [bidId_1, idempotencyKey_1, completeAcceptanceRequestDto_1, ...args_1], void 0, function* (bidId, idempotencyKey, completeAcceptanceRequestDto, options = {}) {
             // verify required parameter 'bidId' is not null or undefined
             (0, common_1.assertParamExists)('completeAcceptance', 'bidId', bidId);
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            (0, common_1.assertParamExists)('completeAcceptance', 'idempotencyKey', idempotencyKey);
             // verify required parameter 'completeAcceptanceRequestDto' is not null or undefined
             (0, common_1.assertParamExists)('completeAcceptance', 'completeAcceptanceRequestDto', completeAcceptanceRequestDto);
             const localVarPath = `/v1/bids/{bidId}/acceptance`
@@ -63,6 +66,9 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -317,13 +323,16 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 유찰 처리(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_1, ...args_1) => __awaiter(this, [markBidFailedRequestDto_1, ...args_1], void 0, function* (markBidFailedRequestDto, options = {}) {
+        markBidFailed: (idempotencyKey_1, markBidFailedRequestDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, markBidFailedRequestDto_1, ...args_1], void 0, function* (idempotencyKey, markBidFailedRequestDto, options = {}) {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            (0, common_1.assertParamExists)('markBidFailed', 'idempotencyKey', idempotencyKey);
             // verify required parameter 'markBidFailedRequestDto' is not null or undefined
             (0, common_1.assertParamExists)('markBidFailed', 'markBidFailedRequestDto', markBidFailedRequestDto);
             const localVarPath = `/v1/awards/fail`;
@@ -341,6 +350,9 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -384,13 +396,16 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 낙찰 결과 등록. 스코프 `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_1, ...args_1) => __awaiter(this, [registerAwardRequestDto_1, ...args_1], void 0, function* (registerAwardRequestDto, options = {}) {
+        registerAward: (idempotencyKey_1, registerAwardRequestDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, registerAwardRequestDto_1, ...args_1], void 0, function* (idempotencyKey, registerAwardRequestDto, options = {}) {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            (0, common_1.assertParamExists)('registerAward', 'idempotencyKey', idempotencyKey);
             // verify required parameter 'registerAwardRequestDto' is not null or undefined
             (0, common_1.assertParamExists)('registerAward', 'registerAwardRequestDto', registerAwardRequestDto);
             const localVarPath = `/v1/awards`;
@@ -408,6 +423,9 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -452,13 +470,16 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 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_1, ...args_1) => __awaiter(this, [requestSplitInvoiceRequestDto_1, ...args_1], void 0, function* (requestSplitInvoiceRequestDto, options = {}) {
+        requestSplitInvoice: (idempotencyKey_1, requestSplitInvoiceRequestDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, requestSplitInvoiceRequestDto_1, ...args_1], void 0, function* (idempotencyKey, requestSplitInvoiceRequestDto, options = {}) {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            (0, common_1.assertParamExists)('requestSplitInvoice', 'idempotencyKey', idempotencyKey);
             // verify required parameter 'requestSplitInvoiceRequestDto' is not null or undefined
             (0, common_1.assertParamExists)('requestSplitInvoice', 'requestSplitInvoiceRequestDto', requestSplitInvoiceRequestDto);
             const localVarPath = `/v1/invoices/split-requests`;
@@ -476,6 +497,9 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -486,13 +510,16 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 협상에의한계약(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_1, ...args_1) => __awaiter(this, [submitNegotiationScoresRequestDto_1, ...args_1], void 0, function* (submitNegotiationScoresRequestDto, options = {}) {
+        submitNegotiationScores: (idempotencyKey_1, submitNegotiationScoresRequestDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, submitNegotiationScoresRequestDto_1, ...args_1], void 0, function* (idempotencyKey, submitNegotiationScoresRequestDto, options = {}) {
+            // verify required parameter 'idempotencyKey' is not null or undefined
+            (0, common_1.assertParamExists)('submitNegotiationScores', 'idempotencyKey', idempotencyKey);
             // verify required parameter 'submitNegotiationScoresRequestDto' is not null or undefined
             (0, common_1.assertParamExists)('submitNegotiationScores', 'submitNegotiationScoresRequestDto', submitNegotiationScoresRequestDto);
             const localVarPath = `/v1/awards/nego-eval`;
@@ -510,6 +537,9 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
             yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
+            if (idempotencyKey != null) {
+                localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
+            }
             (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -563,17 +593,18 @@ const PartnerV1ApiFp = function (configuration) {
     const localVarAxiosParamCreator = (0, exports.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(= 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(bidId, completeAcceptanceRequestDto, options) {
+        completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.completeAcceptance(bidId, completeAcceptanceRequestDto, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV1Api.completeAcceptance']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -694,16 +725,17 @@ const PartnerV1ApiFp = function (configuration) {
             });
         },
         /**
-         * 유찰 처리(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, options) {
+        markBidFailed(idempotencyKey, markBidFailedRequestDto, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.markBidFailed(markBidFailedRequestDto, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.markBidFailed(idempotencyKey, markBidFailedRequestDto, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV1Api.markBidFailed']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -726,16 +758,17 @@ const PartnerV1ApiFp = function (configuration) {
             });
         },
         /**
-         * 낙찰 결과 등록. 스코프 `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, options) {
+        registerAward(idempotencyKey, registerAwardRequestDto, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.registerAward(registerAwardRequestDto, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.registerAward(idempotencyKey, registerAwardRequestDto, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV1Api.registerAward']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -758,32 +791,34 @@ const PartnerV1ApiFp = function (configuration) {
             });
         },
         /**
-         * 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, options) {
+        requestSplitInvoice(idempotencyKey, requestSplitInvoiceRequestDto, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.requestSplitInvoice(requestSplitInvoiceRequestDto, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.requestSplitInvoice(idempotencyKey, requestSplitInvoiceRequestDto, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV1Api.requestSplitInvoice']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.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}
          */
-        submitNegotiationScores(submitNegotiationScoresRequestDto, options) {
+        submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c;
-                const localVarAxiosArgs = yield localVarAxiosParamCreator.submitNegotiationScores(submitNegotiationScoresRequestDto, options);
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options);
                 const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
                 const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV1Api.submitNegotiationScores']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -815,15 +850,16 @@ const PartnerV1ApiFactory = function (configuration, basePath, axios) {
     const localVarFp = (0, exports.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(= 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(bidId, completeAcceptanceRequestDto, options) {
-            return localVarFp.completeAcceptance(bidId, completeAcceptanceRequestDto, options).then((request) => request(axios, basePath));
+        completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options) {
+            return localVarFp.completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * V5 /contractDocumentRec 후속. scope contracts:read.
@@ -898,14 +934,15 @@ const PartnerV1ApiFactory = function (configuration, basePath, axios) {
             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, options) {
-            return localVarFp.markBidFailed(markBidFailedRequestDto, options).then((request) => request(axios, basePath));
+        markBidFailed(idempotencyKey, markBidFailedRequestDto, options) {
+            return localVarFp.markBidFailed(idempotencyKey, markBidFailedRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
@@ -918,14 +955,15 @@ const PartnerV1ApiFactory = function (configuration, basePath, axios) {
             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, options) {
-            return localVarFp.registerAward(registerAwardRequestDto, options).then((request) => request(axios, basePath));
+        registerAward(idempotencyKey, registerAwardRequestDto, options) {
+            return localVarFp.registerAward(idempotencyKey, registerAwardRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
@@ -938,24 +976,26 @@ const PartnerV1ApiFactory = function (configuration, basePath, axios) {
             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, options) {
-            return localVarFp.requestSplitInvoice(requestSplitInvoiceRequestDto, options).then((request) => request(axios, basePath));
+        requestSplitInvoice(idempotencyKey, requestSplitInvoiceRequestDto, options) {
+            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, options) {
-            return localVarFp.submitNegotiationScores(submitNegotiationScoresRequestDto, options).then((request) => request(axios, basePath));
+        submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options) {
+            return localVarFp.submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
          * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
@@ -975,15 +1015,16 @@ exports.PartnerV1ApiFactory = PartnerV1ApiFactory;
  */
 class PartnerV1Api extends base_1.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(= 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(bidId, completeAcceptanceRequestDto, options) {
-        return (0, exports.PartnerV1ApiFp)(this.configuration).completeAcceptance(bidId, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
+    completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options) {
+        return (0, exports.PartnerV1ApiFp)(this.configuration).completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * V5 /contractDocumentRec 후속. scope contracts:read.
@@ -1058,14 +1099,15 @@ class PartnerV1Api extends base_1.BaseAPI {
         return (0, exports.PartnerV1ApiFp)(this.configuration).healthControllerCheck(options).then((request) => request(this.axios, this.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, options) {
-        return (0, exports.PartnerV1ApiFp)(this.configuration).markBidFailed(markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
+    markBidFailed(idempotencyKey, markBidFailedRequestDto, options) {
+        return (0, exports.PartnerV1ApiFp)(this.configuration).markBidFailed(idempotencyKey, markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
@@ -1078,14 +1120,15 @@ class PartnerV1Api extends base_1.BaseAPI {
         return (0, exports.PartnerV1ApiFp)(this.configuration).recordParityResult(body, options).then((request) => request(this.axios, this.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, options) {
-        return (0, exports.PartnerV1ApiFp)(this.configuration).registerAward(registerAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
+    registerAward(idempotencyKey, registerAwardRequestDto, options) {
+        return (0, exports.PartnerV1ApiFp)(this.configuration).registerAward(idempotencyKey, registerAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
@@ -1098,24 +1141,26 @@ class PartnerV1Api extends base_1.BaseAPI {
         return (0, exports.PartnerV1ApiFp)(this.configuration).registerBid(createBidRequestDto, options).then((request) => request(this.axios, this.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, options) {
-        return (0, exports.PartnerV1ApiFp)(this.configuration).requestSplitInvoice(requestSplitInvoiceRequestDto, options).then((request) => request(this.axios, this.basePath));
+    requestSplitInvoice(idempotencyKey, requestSplitInvoiceRequestDto, options) {
+        return (0, exports.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}
      */
-    submitNegotiationScores(submitNegotiationScoresRequestDto, options) {
-        return (0, exports.PartnerV1ApiFp)(this.configuration).submitNegotiationScores(submitNegotiationScoresRequestDto, options).then((request) => request(this.axios, this.basePath));
+    submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options) {
+        return (0, exports.PartnerV1ApiFp)(this.configuration).submitNegotiationScores(idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
     /**
      * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.