@cmarket/partner-sdk 9.7.0 → 10.0.0

package/dist/api/partner-v2-api.d.ts

@@ -2,7 +2,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).
@@ -13,9 +13,9 @@ import type { Configuration } from '../configuration';
 import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import { type RequestArgs, BaseAPI } from '../base';
 import type { AcceptanceResultResponseDto } from '../models';
-import type { AwardRegisteredResponseDto } from '../models';
-import type { BidCreatedResponseDto } from '../models';
-import type { BidFailedResponseDto } from '../models';
+import type { AwardRegisteredV2ResponseDto } from '../models';
+import type { BidFailedV2ResponseDto } from '../models';
+import type { BidRegisteredResponseDto } from '../models';
 import type { BidResultsResponseDto } from '../models';
 import type { BidSettlementResponseDto } from '../models';
 import type { BidStatementResponseDto } from '../models';
@@ -31,6 +31,8 @@ import type { InvoiceCompletedResponseDto } from '../models';
 import type { IssueTaxInvoiceRequestDto } from '../models';
 import type { MarkBidFailedRequestDto } from '../models';
 import type { RegisterAwardRequestDto } from '../models';
+import type { SimulateSandboxBidRequestDto } from '../models';
+import type { SimulateSandboxBidResponseDto } from '../models';
 import type { TaxInvoiceIssuedResponseDto } from '../models';
 import type { UpdateBidRequestDto } from '../models';
 import type { UploadFileRequestDto } from '../models';
@@ -49,7 +51,7 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     completeAcceptance: (bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`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 권장.
@@ -66,16 +68,15 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     createEmbedLaunch: (embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 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) => Promise<RequestArgs>;
+    getBidResults: (bidId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
      * @summary 입찰결과 정산정보 조회
      * @param {string} bidId
      * @param {*} [options] Override http request option.
@@ -83,7 +84,7 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     getBidSettlement: (bidId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * V5 /getGrm 후속. scope contracts:read.
+     * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
      * @summary 거래명세서 조회
      * @param {string} bidId
      * @param {number} paperCode
@@ -99,9 +100,9 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     healthControllerCheck: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(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.
@@ -109,7 +110,7 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     issueTaxInvoice: (bidId: string, idempotencyKey: string, issueTaxInvoiceRequestDto: IssueTaxInvoiceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 공고를 유찰 상태로 전환합니다.  **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
@@ -127,7 +128,7 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     regenerateContractDocuments: (bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **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
@@ -144,9 +145,18 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     registerBid: (createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 등록된 공고의 내용을 수정합니다. 스코프 `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) => Promise<RequestArgs>;
+    /**
+     * 등록된 공고의 내용을 수정합니다. 스코프 `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.
@@ -177,7 +187,7 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AcceptanceResultResponseDto>>;
     /**
-     * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`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 권장.
@@ -194,16 +204,15 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<EmbedLaunchResponseDto>>;
     /**
-     * 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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidResultsResponseDto>>;
+    getBidResults(bidId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidResultsResponseDto>>;
     /**
-     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
      * @summary 입찰결과 정산정보 조회
      * @param {string} bidId
      * @param {*} [options] Override http request option.
@@ -211,7 +220,7 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidSettlementResponseDto>>;
     /**
-     * V5 /getGrm 후속. scope contracts:read.
+     * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
      * @summary 거래명세서 조회
      * @param {string} bidId
      * @param {number} paperCode
@@ -227,9 +236,9 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     healthControllerCheck(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<HealthResponseDto>>;
     /**
-     * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(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.
@@ -237,14 +246,14 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     issueTaxInvoice(bidId: string, idempotencyKey: string, issueTaxInvoiceRequestDto: IssueTaxInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<TaxInvoiceIssuedResponseDto>>;
     /**
-     * 공고를 유찰 상태로 전환합니다.  **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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedResponseDto>>;
+    markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedV2ResponseDto>>;
     /**
      * 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계약서류 생성(재생성)
@@ -255,14 +264,14 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     regenerateContractDocuments(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ContractDocumentsRegeneratedResponseDto>>;
     /**
-     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredResponseDto>>;
+    registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredV2ResponseDto>>;
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
      * @summary 입찰 정보 전송(등록)
@@ -270,11 +279,20 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidCreatedResponseDto>>;
+    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidRegisteredResponseDto>>;
+    /**
+     * 샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `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): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SimulateSandboxBidResponseDto>>;
     /**
-     * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+     * 등록된 공고의 내용을 수정합니다. 스코프 `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.
@@ -305,7 +323,7 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AcceptanceResultResponseDto>;
     /**
-     * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`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 권장.
@@ -322,16 +340,15 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<EmbedLaunchResponseDto>;
     /**
-     * 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>;
+    getBidResults(bidId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidResultsResponseDto>;
     /**
-     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
      * @summary 입찰결과 정산정보 조회
      * @param {string} bidId
      * @param {*} [options] Override http request option.
@@ -339,7 +356,7 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidSettlementResponseDto>;
     /**
-     * V5 /getGrm 후속. scope contracts:read.
+     * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
      * @summary 거래명세서 조회
      * @param {string} bidId
      * @param {number} paperCode
@@ -355,9 +372,9 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     healthControllerCheck(options?: RawAxiosRequestConfig): AxiosPromise<HealthResponseDto>;
     /**
-     * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(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.
@@ -365,14 +382,14 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     issueTaxInvoice(bidId: string, idempotencyKey: string, issueTaxInvoiceRequestDto: IssueTaxInvoiceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<TaxInvoiceIssuedResponseDto>;
     /**
-     * 공고를 유찰 상태로 전환합니다.  **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>;
     /**
      * 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계약서류 생성(재생성)
@@ -383,14 +400,14 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     regenerateContractDocuments(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): AxiosPromise<ContractDocumentsRegeneratedResponseDto>;
     /**
-     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **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>;
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
      * @summary 입찰 정보 전송(등록)
@@ -398,11 +415,20 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidCreatedResponseDto>;
+    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidRegisteredResponseDto>;
     /**
-     * 등록된 공고의 내용을 수정합니다. 스코프 `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>;
+    /**
+     * 등록된 공고의 내용을 수정합니다. 스코프 `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.
@@ -433,7 +459,7 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AcceptanceResultResponseDto, any, {}>>;
     /**
-     * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`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 권장.
@@ -450,16 +476,15 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<EmbedLaunchResponseDto, any, {}>>;
     /**
-     * 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): Promise<import("axios").AxiosResponse<BidResultsResponseDto, any, {}>>;
+    getBidResults(bidId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidResultsResponseDto, any, {}>>;
     /**
-     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
      * @summary 입찰결과 정산정보 조회
      * @param {string} bidId
      * @param {*} [options] Override http request option.
@@ -467,7 +492,7 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidSettlementResponseDto, any, {}>>;
     /**
-     * V5 /getGrm 후속. scope contracts:read.
+     * 낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
      * @summary 거래명세서 조회
      * @param {string} bidId
      * @param {number} paperCode
@@ -483,9 +508,9 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     healthControllerCheck(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<HealthResponseDto, any, {}>>;
     /**
-     * 낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(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.
@@ -493,14 +518,14 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     issueTaxInvoice(bidId: string, idempotencyKey: string, issueTaxInvoiceRequestDto: IssueTaxInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<TaxInvoiceIssuedResponseDto, any, {}>>;
     /**
-     * 공고를 유찰 상태로 전환합니다.  **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): Promise<import("axios").AxiosResponse<BidFailedResponseDto, any, {}>>;
+    markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidFailedV2ResponseDto, any, {}>>;
     /**
      * 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계약서류 생성(재생성)
@@ -511,14 +536,14 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     regenerateContractDocuments(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ContractDocumentsRegeneratedResponseDto, any, {}>>;
     /**
-     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **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): Promise<import("axios").AxiosResponse<AwardRegisteredResponseDto, any, {}>>;
+    registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AwardRegisteredV2ResponseDto, any, {}>>;
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
      * @summary 입찰 정보 전송(등록)
@@ -526,11 +551,20 @@ export declare class PartnerV2Api extends BaseAPI {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidCreatedResponseDto, any, {}>>;
+    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidRegisteredResponseDto, any, {}>>;
+    /**
+     * 샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `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): Promise<import("axios").AxiosResponse<SimulateSandboxBidResponseDto, any, {}>>;
     /**
-     * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+     * 등록된 공고의 내용을 수정합니다. 스코프 `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.