@cmarket/partner-sdk 9.7.0 → 10.0.0

package/api/partner-v2-api.ts

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 9.7.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -24,11 +24,11 @@ import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError
 // @ts-ignore
 import type { AcceptanceResultResponseDto } from '../models';
 // @ts-ignore
-import type { AwardRegisteredResponseDto } from '../models';
+import type { AwardRegisteredV2ResponseDto } from '../models';
 // @ts-ignore
-import type { BidCreatedResponseDto } from '../models';
+import type { BidFailedV2ResponseDto } from '../models';
 // @ts-ignore
-import type { BidFailedResponseDto } from '../models';
+import type { BidRegisteredResponseDto } from '../models';
 // @ts-ignore
 import type { BidResultsResponseDto } from '../models';
 // @ts-ignore
@@ -62,6 +62,10 @@ import type { ProblemDetailsDto } from '../models';
 // @ts-ignore
 import type { RegisterAwardRequestDto } from '../models';
 // @ts-ignore
+import type { SimulateSandboxBidRequestDto } from '../models';
+// @ts-ignore
+import type { SimulateSandboxBidResponseDto } from '../models';
+// @ts-ignore
 import type { TaxInvoiceIssuedResponseDto } from '../models';
 // @ts-ignore
 import type { UpdateBidRequestDto } from '../models';
@@ -122,7 +126,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`buy_payment_force_yn`, `buy_payment_yn`)와 계산서 발급 플래그(`taxbill`)가 `Y`로 기록됩니다. - 계산서 발급일자(`taxbill_date`)가 현재 시각으로 기록됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+         * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 정산 마감(송장 강제완료)
          * @param {string} bidId 
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
@@ -205,18 +209,15 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * V5 /entendrec 후속. scope bids:read.
+         * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
          * @summary 입찰 결과 조회
          * @param {string} bidId 
-         * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getBidResults: async (bidId: string, buyerId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        getBidResults: async (bidId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'bidId' is not null or undefined
             assertParamExists('getBidResults', 'bidId', bidId)
-            // verify required parameter 'buyerId' is not null or undefined
-            assertParamExists('getBidResults', 'buyerId', buyerId)
             const localVarPath = `/v2/bids/{bidId}/results`
                 .replace('{bidId}', encodeURIComponent(String(bidId)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
@@ -234,10 +235,6 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (buyerId !== undefined) {
-                localVarQueryParameter['buyerId'] = buyerId;
-            }
-
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -250,7 +247,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+         * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
          * @summary 입찰결과 정산정보 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
@@ -288,7 +285,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * V5 /getGrm 후속. scope contracts:read.
+         * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
          * @summary 거래명세서 조회
          * @param {string} bidId 
          * @param {number} paperCode 
@@ -363,9 +360,9 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(Popbill).  **V5 대응:** `B2B_BUY_POP_BILL_S1` 발행 경로의 V6 후속.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 `b2b_buy.taxbill=\'Y\'` 로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+         * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
          * @summary 세금계산서 발행
-         * @param {string} bidId 공고번호(등록 응답의 bidNo).
+         * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {IssueTaxInvoiceRequestDto} issueTaxInvoiceRequestDto 
          * @param {*} [options] Override http request option.
@@ -412,7 +409,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 공고를 유찰 상태로 전환합니다.  **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` 헤더 필수.
+         * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다.  **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 |  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 유찰 처리
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {MarkBidFailedRequestDto} markBidFailedRequestDto 
@@ -501,7 +498,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(H/K) 공고는 이 엔드포인트 전에 `/v1/awards/nego-eval` 로 평가 완료가 필요합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
          * @summary 낙찰 결과 전송
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {RegisterAwardRequestDto} registerAwardRequestDto 
@@ -585,9 +582,52 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             };
         },
         /**
-         * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+         * 샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `sandboxBuyerId` 가 없는 운영 키로는 호출할 수 없습니다(403 `sandbox-only`).  **단계(`phase`):** - `join` — 합성 공급사 명의로 응찰 1건을 추가합니다(멱등 — 최대 2건, 이미 2건이면 no-op). - `close` — 공고를 낙찰대기(PENDING_AWARD)로 전이해 낙찰결과 조회 게이트를 엽니다(이미 마감이면 no-op).  **안전장치:** 실제 write(합성 응찰 INSERT·상태 전이)는 backend 가 `SANDBOX_BUYER_ID` 소유 공고에 한해서만 수행합니다. 실 발주처 공고는 절대 건드리지 않습니다(fail-closed).  **필수 스코프:** `bids:write`
+         * @summary 샌드박스 응찰/마감 시뮬 (영업 데모 전용)
+         * @param {string} bidId 샌드박스 공고 ID(&#x3D; backend bidId).
+         * @param {SimulateSandboxBidRequestDto} simulateSandboxBidRequestDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        simulateSandboxBid: async (bidId: string, simulateSandboxBidRequestDto: SimulateSandboxBidRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'bidId' is not null or undefined
+            assertParamExists('simulateSandboxBid', 'bidId', bidId)
+            // verify required parameter 'simulateSandboxBidRequestDto' is not null or undefined
+            assertParamExists('simulateSandboxBid', 'simulateSandboxBidRequestDto', simulateSandboxBidRequestDto)
+            const localVarPath = `/v2/sandbox/bids/{bidId}/simulate`
+                .replace('{bidId}', encodeURIComponent(String(bidId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication partner-oauth2 required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(simulateSandboxBidRequestDto, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
          * @summary 입찰 공고 수정
-         * @param {string} bidId 공고번호(등록 응답의 bidNo) 또는 발주처 조달번호.
+         * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
          * @param {UpdateBidRequestDto} updateBidRequestDto 
          * @param {*} [options] Override http request option.
@@ -697,7 +737,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`buy_payment_force_yn`, `buy_payment_yn`)와 계산서 발급 플래그(`taxbill`)가 `Y`로 기록됩니다. - 계산서 발급일자(`taxbill_date`)가 현재 시각으로 기록됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+         * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 정산 마감(송장 강제완료)
          * @param {string} bidId 
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
@@ -724,21 +764,20 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * V5 /entendrec 후속. scope bids:read.
+         * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
          * @summary 입찰 결과 조회
          * @param {string} bidId 
-         * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidResultsResponseDto>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getBidResults(bidId, buyerId, options);
+        async getBidResults(bidId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidResultsResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getBidResults(bidId, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV2Api.getBidResults']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+         * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
          * @summary 입찰결과 정산정보 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
@@ -751,7 +790,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * V5 /getGrm 후속. scope contracts:read.
+         * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
          * @summary 거래명세서 조회
          * @param {string} bidId 
          * @param {number} paperCode 
@@ -777,9 +816,9 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(Popbill).  **V5 대응:** `B2B_BUY_POP_BILL_S1` 발행 경로의 V6 후속.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 `b2b_buy.taxbill=\'Y\'` 로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+         * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
          * @summary 세금계산서 발행
-         * @param {string} bidId 공고번호(등록 응답의 bidNo).
+         * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {IssueTaxInvoiceRequestDto} issueTaxInvoiceRequestDto 
          * @param {*} [options] Override http request option.
@@ -792,14 +831,14 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 공고를 유찰 상태로 전환합니다.  **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` 헤더 필수.
+         * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다.  **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 |  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `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(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedResponseDto>> {
+        async markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedV2ResponseDto>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.markBidFailed(idempotencyKey, markBidFailedRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV2Api.markBidFailed']?.[localVarOperationServerIndex]?.url;
@@ -820,14 +859,14 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(H/K) 공고는 이 엔드포인트 전에 `/v1/awards/nego-eval` 로 평가 완료가 필요합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `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(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredResponseDto>> {
+        async registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredV2ResponseDto>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.registerAward(idempotencyKey, registerAwardRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV2Api.registerAward']?.[localVarOperationServerIndex]?.url;
@@ -840,16 +879,30 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidCreatedResponseDto>> {
+        async registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidRegisteredResponseDto>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.registerBid(createBidRequestDto, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['PartnerV2Api.registerBid']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+         * 샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `sandboxBuyerId` 가 없는 운영 키로는 호출할 수 없습니다(403 `sandbox-only`).  **단계(`phase`):** - `join` — 합성 공급사 명의로 응찰 1건을 추가합니다(멱등 — 최대 2건, 이미 2건이면 no-op). - `close` — 공고를 낙찰대기(PENDING_AWARD)로 전이해 낙찰결과 조회 게이트를 엽니다(이미 마감이면 no-op).  **안전장치:** 실제 write(합성 응찰 INSERT·상태 전이)는 backend 가 `SANDBOX_BUYER_ID` 소유 공고에 한해서만 수행합니다. 실 발주처 공고는 절대 건드리지 않습니다(fail-closed).  **필수 스코프:** `bids:write`
+         * @summary 샌드박스 응찰/마감 시뮬 (영업 데모 전용)
+         * @param {string} bidId 샌드박스 공고 ID(&#x3D; backend bidId).
+         * @param {SimulateSandboxBidRequestDto} simulateSandboxBidRequestDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async simulateSandboxBid(bidId: string, simulateSandboxBidRequestDto: SimulateSandboxBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SimulateSandboxBidResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.simulateSandboxBid(bidId, simulateSandboxBidRequestDto, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PartnerV2Api.simulateSandboxBid']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
          * @summary 입찰 공고 수정
-         * @param {string} bidId 공고번호(등록 응답의 bidNo) 또는 발주처 조달번호.
+         * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
          * @param {UpdateBidRequestDto} updateBidRequestDto 
          * @param {*} [options] Override http request option.
@@ -896,7 +949,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
             return localVarFp.completeAcceptance(bidId, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`buy_payment_force_yn`, `buy_payment_yn`)와 계산서 발급 플래그(`taxbill`)가 `Y`로 기록됩니다. - 계산서 발급일자(`taxbill_date`)가 현재 시각으로 기록됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+         * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
          * @summary 정산 마감(송장 강제완료)
          * @param {string} bidId 
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
@@ -917,18 +970,17 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
             return localVarFp.createEmbedLaunch(embedLaunchRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * V5 /entendrec 후속. scope bids:read.
+         * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
          * @summary 입찰 결과 조회
          * @param {string} bidId 
-         * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidResultsResponseDto> {
-            return localVarFp.getBidResults(bidId, buyerId, options).then((request) => request(axios, basePath));
+        getBidResults(bidId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidResultsResponseDto> {
+            return localVarFp.getBidResults(bidId, options).then((request) => request(axios, basePath));
         },
         /**
-         * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+         * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
          * @summary 입찰결과 정산정보 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
@@ -938,7 +990,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
             return localVarFp.getBidSettlement(bidId, options).then((request) => request(axios, basePath));
         },
         /**
-         * V5 /getGrm 후속. scope contracts:read.
+         * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
          * @summary 거래명세서 조회
          * @param {string} bidId 
          * @param {number} paperCode 
@@ -958,9 +1010,9 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
             return localVarFp.healthControllerCheck(options).then((request) => request(axios, basePath));
         },
         /**
-         * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(Popbill).  **V5 대응:** `B2B_BUY_POP_BILL_S1` 발행 경로의 V6 후속.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 `b2b_buy.taxbill=\'Y\'` 로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+         * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
          * @summary 세금계산서 발행
-         * @param {string} bidId 공고번호(등록 응답의 bidNo).
+         * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
          * @param {IssueTaxInvoiceRequestDto} issueTaxInvoiceRequestDto 
          * @param {*} [options] Override http request option.
@@ -970,14 +1022,14 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
             return localVarFp.issueTaxInvoice(bidId, idempotencyKey, issueTaxInvoiceRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * 공고를 유찰 상태로 전환합니다.  **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` 헤더 필수.
+         * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다.  **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 |  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `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(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedResponseDto> {
+        markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedV2ResponseDto> {
             return localVarFp.markBidFailed(idempotencyKey, markBidFailedRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
@@ -992,14 +1044,14 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
             return localVarFp.regenerateContractDocuments(bidId, idempotencyKey, options).then((request) => request(axios, basePath));
         },
         /**
-         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+         * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(H/K) 공고는 이 엔드포인트 전에 `/v1/awards/nego-eval` 로 평가 완료가 필요합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `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(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredResponseDto> {
+        registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredV2ResponseDto> {
             return localVarFp.registerAward(idempotencyKey, registerAwardRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
@@ -1009,13 +1061,24 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidCreatedResponseDto> {
+        registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidRegisteredResponseDto> {
             return localVarFp.registerBid(createBidRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+         * 샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `sandboxBuyerId` 가 없는 운영 키로는 호출할 수 없습니다(403 `sandbox-only`).  **단계(`phase`):** - `join` — 합성 공급사 명의로 응찰 1건을 추가합니다(멱등 — 최대 2건, 이미 2건이면 no-op). - `close` — 공고를 낙찰대기(PENDING_AWARD)로 전이해 낙찰결과 조회 게이트를 엽니다(이미 마감이면 no-op).  **안전장치:** 실제 write(합성 응찰 INSERT·상태 전이)는 backend 가 `SANDBOX_BUYER_ID` 소유 공고에 한해서만 수행합니다. 실 발주처 공고는 절대 건드리지 않습니다(fail-closed).  **필수 스코프:** `bids:write`
+         * @summary 샌드박스 응찰/마감 시뮬 (영업 데모 전용)
+         * @param {string} bidId 샌드박스 공고 ID(&#x3D; backend bidId).
+         * @param {SimulateSandboxBidRequestDto} simulateSandboxBidRequestDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        simulateSandboxBid(bidId: string, simulateSandboxBidRequestDto: SimulateSandboxBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SimulateSandboxBidResponseDto> {
+            return localVarFp.simulateSandboxBid(bidId, simulateSandboxBidRequestDto, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
          * @summary 입찰 공고 수정
-         * @param {string} bidId 공고번호(등록 응답의 bidNo) 또는 발주처 조달번호.
+         * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
          * @param {UpdateBidRequestDto} updateBidRequestDto 
          * @param {*} [options] Override http request option.
@@ -1055,7 +1118,7 @@ export class PartnerV2Api extends BaseAPI {
     }
 
     /**
-     * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`buy_payment_force_yn`, `buy_payment_yn`)와 계산서 발급 플래그(`taxbill`)가 `Y`로 기록됩니다. - 계산서 발급일자(`taxbill_date`)가 현재 시각으로 기록됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 정산 마감(송장 강제완료)
      * @param {string} bidId 
      * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
@@ -1078,19 +1141,18 @@ export class PartnerV2Api extends BaseAPI {
     }
 
     /**
-     * V5 /entendrec 후속. scope bids:read.
+     * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
      * @summary 입찰 결과 조회
      * @param {string} bidId 
-     * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig) {
-        return PartnerV2ApiFp(this.configuration).getBidResults(bidId, buyerId, options).then((request) => request(this.axios, this.basePath));
+    public getBidResults(bidId: string, options?: RawAxiosRequestConfig) {
+        return PartnerV2ApiFp(this.configuration).getBidResults(bidId, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
      * @summary 입찰결과 정산정보 조회
      * @param {string} bidId 
      * @param {*} [options] Override http request option.
@@ -1101,7 +1163,7 @@ export class PartnerV2Api extends BaseAPI {
     }
 
     /**
-     * V5 /getGrm 후속. scope contracts:read.
+     * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
      * @summary 거래명세서 조회
      * @param {string} bidId 
      * @param {number} paperCode 
@@ -1123,9 +1185,9 @@ export class PartnerV2Api extends BaseAPI {
     }
 
     /**
-     * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(Popbill).  **V5 대응:** `B2B_BUY_POP_BILL_S1` 발행 경로의 V6 후속.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 `b2b_buy.taxbill=\'Y\'` 로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
      * @summary 세금계산서 발행
-     * @param {string} bidId 공고번호(등록 응답의 bidNo).
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
      * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {IssueTaxInvoiceRequestDto} issueTaxInvoiceRequestDto 
      * @param {*} [options] Override http request option.
@@ -1136,7 +1198,7 @@ export class PartnerV2Api extends BaseAPI {
     }
 
     /**
-     * 공고를 유찰 상태로 전환합니다.  **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` 헤더 필수.
+     * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다.  **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 |  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 유찰 처리
      * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {MarkBidFailedRequestDto} markBidFailedRequestDto 
@@ -1160,7 +1222,7 @@ export class PartnerV2Api extends BaseAPI {
     }
 
     /**
-     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(H/K) 공고는 이 엔드포인트 전에 `/v1/awards/nego-eval` 로 평가 완료가 필요합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
      * @summary 낙찰 결과 전송
      * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
      * @param {RegisterAwardRequestDto} registerAwardRequestDto 
@@ -1183,9 +1245,21 @@ export class PartnerV2Api extends BaseAPI {
     }
 
     /**
-     * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+     * 샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `sandboxBuyerId` 가 없는 운영 키로는 호출할 수 없습니다(403 `sandbox-only`).  **단계(`phase`):** - `join` — 합성 공급사 명의로 응찰 1건을 추가합니다(멱등 — 최대 2건, 이미 2건이면 no-op). - `close` — 공고를 낙찰대기(PENDING_AWARD)로 전이해 낙찰결과 조회 게이트를 엽니다(이미 마감이면 no-op).  **안전장치:** 실제 write(합성 응찰 INSERT·상태 전이)는 backend 가 `SANDBOX_BUYER_ID` 소유 공고에 한해서만 수행합니다. 실 발주처 공고는 절대 건드리지 않습니다(fail-closed).  **필수 스코프:** `bids:write`
+     * @summary 샌드박스 응찰/마감 시뮬 (영업 데모 전용)
+     * @param {string} bidId 샌드박스 공고 ID(&#x3D; backend bidId).
+     * @param {SimulateSandboxBidRequestDto} simulateSandboxBidRequestDto 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public simulateSandboxBid(bidId: string, simulateSandboxBidRequestDto: SimulateSandboxBidRequestDto, options?: RawAxiosRequestConfig) {
+        return PartnerV2ApiFp(this.configuration).simulateSandboxBid(bidId, simulateSandboxBidRequestDto, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
      * @summary 입찰 공고 수정
-     * @param {string} bidId 공고번호(등록 응답의 bidNo) 또는 발주처 조달번호.
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
      * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
      * @param {UpdateBidRequestDto} updateBidRequestDto 
      * @param {*} [options] Override http request option.

package/api.ts

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 9.7.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/base.ts

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 9.7.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/common.ts

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 9.7.0
+ * The version of the OpenAPI document: 10.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).