@cmarket/partner-sdk 9.10.0 → 11.0.0

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

@@ -1,8 +1,8 @@
 /**
  * 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) 헤더로 전송.
+ * 외부 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) 헤더로 전송.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
  *
- * The version of the OpenAPI document: 9.10.0
+ * The version of the OpenAPI document: 11.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -13,9 +13,11 @@ 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 { BidDetailResponseDto } from '../models';
+import type { BidFailedV2ResponseDto } from '../models';
+import type { BidPublishedResponseDto } from '../models';
+import type { BidRegisteredResponseDto } from '../models';
 import type { BidResultsResponseDto } from '../models';
 import type { BidSettlementResponseDto } from '../models';
 import type { BidStatementResponseDto } from '../models';
@@ -29,10 +31,13 @@ import type { FileUploadedResponseDto } from '../models';
 import type { HealthResponseDto } from '../models';
 import type { InvoiceCompletedResponseDto } from '../models';
 import type { IssueTaxInvoiceRequestDto } from '../models';
+import type { ListBidsResponseDto } from '../models';
 import type { MarkBidFailedRequestDto } from '../models';
+import type { NegotiationScoredV2ResponseDto } from '../models';
 import type { RegisterAwardRequestDto } from '../models';
 import type { SimulateSandboxBidRequestDto } from '../models';
 import type { SimulateSandboxBidResponseDto } from '../models';
+import type { SubmitNegotiationScoresRequestDto } from '../models';
 import type { TaxInvoiceIssuedResponseDto } from '../models';
 import type { UpdateBidRequestDto } from '../models';
 import type { UploadFileRequestDto } from '../models';
@@ -51,7 +56,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 권장.
@@ -68,16 +73,23 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     createEmbedLaunch: (embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * V5 /entendrec 후속. scope bids:read.
+     * 공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+     * @summary 공고 단건(라이프사이클) 조회
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBid: (bidId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. 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.
@@ -85,7 +97,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
@@ -101,9 +113,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.  **분할 청구:** 세금계산서 **분할 발급**은 `/v2` 에 제공되지 않습니다 — `/v1` 전용(`POST /v1/invoices/split-requests`)입니다.  **필수 스코프:** `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.
@@ -111,14 +123,33 @@ 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` 헤더 필수.
+     * 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 20) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
+     * @summary 공고 목록 조회
+     * @param {number} [limit] 페이지 크기(1~100, 기본 20).
+     * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listBids: (limit?: number, cursor?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(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} bidId 공고 식별자(등록 응답의 bidId).
      * @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<RequestArgs>;
+    markBidFailed: (bidId: string, idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 초안(DRAFT) 상태로 등록된 공고를 진행중(ONGOING)으로 게시합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 연간/지명계약 등으로 초안 상태로 등록된 공고를 명시적으로 게시할 때. 등록 응답의 `status` 로 게시 필요 여부를 판별합니다.  **전제조건:** 초안(DRAFT) 상태이고 마감(bidEndAt)이 미래여야 합니다.  **거부:** 초안이 아니거나 마감이 지난 공고 → 409. 마감이 지났으면 먼저 마감일을 연장해야 합니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 공고 게시(초안 → 진행중)
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    publishBid: (bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계약서류 생성(재생성)
@@ -129,14 +160,15 @@ 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)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidId}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
      * @summary 낙찰 결과 전송
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
      * @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<RequestArgs>;
+    registerAward: (bidId: string, idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
      * @summary 입찰 정보 전송(등록)
@@ -155,9 +187,19 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
      */
     simulateSandboxBid: (bidId: string, simulateSandboxBidRequestDto: SimulateSandboxBidRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+     * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다.  **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidId}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다.  **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 협상 점수평가
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores: (bidId: string, idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, 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.
@@ -188,7 +230,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 권장.
@@ -205,16 +247,23 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<EmbedLaunchResponseDto>>;
     /**
-     * V5 /entendrec 후속. scope bids:read.
+     * 공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+     * @summary 공고 단건(라이프사이클) 조회
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBid(bidId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidDetailResponseDto>>;
+    /**
+     * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. 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.
@@ -222,7 +271,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
@@ -238,9 +287,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.  **분할 청구:** 세금계산서 **분할 발급**은 `/v2` 에 제공되지 않습니다 — `/v1` 전용(`POST /v1/invoices/split-requests`)입니다.  **필수 스코프:** `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.
@@ -248,14 +297,33 @@ 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` 헤더 필수.
+     * 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 20) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
+     * @summary 공고 목록 조회
+     * @param {number} [limit] 페이지 크기(1~100, 기본 20).
+     * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listBids(limit?: number, cursor?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListBidsResponseDto>>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(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} bidId 공고 식별자(등록 응답의 bidId).
      * @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(bidId: string, idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedV2ResponseDto>>;
+    /**
+     * 초안(DRAFT) 상태로 등록된 공고를 진행중(ONGOING)으로 게시합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 연간/지명계약 등으로 초안 상태로 등록된 공고를 명시적으로 게시할 때. 등록 응답의 `status` 로 게시 필요 여부를 판별합니다.  **전제조건:** 초안(DRAFT) 상태이고 마감(bidEndAt)이 미래여야 합니다.  **거부:** 초안이 아니거나 마감이 지난 공고 → 409. 마감이 지났으면 먼저 마감일을 연장해야 합니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 공고 게시(초안 → 진행중)
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    publishBid(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidPublishedResponseDto>>;
     /**
      * 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계약서류 생성(재생성)
@@ -266,14 +334,15 @@ 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)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidId}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
      * @summary 낙찰 결과 전송
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
      * @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(bidId: string, idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredV2ResponseDto>>;
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
      * @summary 입찰 정보 전송(등록)
@@ -281,7 +350,7 @@ 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 샌드박스 응찰/마감 시뮬 (영업 데모 전용)
@@ -292,9 +361,19 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
      */
     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)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+     * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다.  **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidId}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다.  **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 협상 점수평가
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores(bidId: string, idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NegotiationScoredV2ResponseDto>>;
+    /**
+     * 등록된 공고의 내용을 수정합니다. 스코프 `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.
@@ -325,7 +404,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 권장.
@@ -342,16 +421,23 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<EmbedLaunchResponseDto>;
     /**
-     * V5 /entendrec 후속. scope bids:read.
+     * 공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+     * @summary 공고 단건(라이프사이클) 조회
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBid(bidId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidDetailResponseDto>;
+    /**
+     * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. 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.
@@ -359,7 +445,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
@@ -375,9 +461,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.  **분할 청구:** 세금계산서 **분할 발급**은 `/v2` 에 제공되지 않습니다 — `/v1` 전용(`POST /v1/invoices/split-requests`)입니다.  **필수 스코프:** `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.
@@ -385,14 +471,33 @@ 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` 헤더 필수.
+     * 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 20) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
+     * @summary 공고 목록 조회
+     * @param {number} [limit] 페이지 크기(1~100, 기본 20).
+     * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listBids(limit?: number, cursor?: string, options?: RawAxiosRequestConfig): AxiosPromise<ListBidsResponseDto>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(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} bidId 공고 식별자(등록 응답의 bidId).
      * @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(bidId: string, idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedV2ResponseDto>;
+    /**
+     * 초안(DRAFT) 상태로 등록된 공고를 진행중(ONGOING)으로 게시합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 연간/지명계약 등으로 초안 상태로 등록된 공고를 명시적으로 게시할 때. 등록 응답의 `status` 로 게시 필요 여부를 판별합니다.  **전제조건:** 초안(DRAFT) 상태이고 마감(bidEndAt)이 미래여야 합니다.  **거부:** 초안이 아니거나 마감이 지난 공고 → 409. 마감이 지났으면 먼저 마감일을 연장해야 합니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 공고 게시(초안 → 진행중)
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    publishBid(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): AxiosPromise<BidPublishedResponseDto>;
     /**
      * 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계약서류 생성(재생성)
@@ -403,14 +508,15 @@ 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)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidId}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
      * @summary 낙찰 결과 전송
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
      * @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(bidId: string, idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredV2ResponseDto>;
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
      * @summary 입찰 정보 전송(등록)
@@ -418,7 +524,7 @@ 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>;
     /**
      * 샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `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 샌드박스 응찰/마감 시뮬 (영업 데모 전용)
@@ -429,9 +535,19 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
      */
     simulateSandboxBid(bidId: string, simulateSandboxBidRequestDto: SimulateSandboxBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SimulateSandboxBidResponseDto>;
     /**
-     * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+     * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다.  **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidId}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다.  **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 협상 점수평가
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores(bidId: string, idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<NegotiationScoredV2ResponseDto>;
+    /**
+     * 등록된 공고의 내용을 수정합니다. 스코프 `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.
@@ -462,7 +578,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 권장.
@@ -479,16 +595,23 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<EmbedLaunchResponseDto, any, {}>>;
     /**
-     * V5 /entendrec 후속. scope bids:read.
+     * 공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+     * @summary 공고 단건(라이프사이클) 조회
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBid(bidId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidDetailResponseDto, any, {}>>;
+    /**
+     * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. 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.
@@ -496,7 +619,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
@@ -512,9 +635,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.  **분할 청구:** 세금계산서 **분할 발급**은 `/v2` 에 제공되지 않습니다 — `/v1` 전용(`POST /v1/invoices/split-requests`)입니다.  **필수 스코프:** `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.
@@ -522,14 +645,33 @@ 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` 헤더 필수.
+     * 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 20) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
+     * @summary 공고 목록 조회
+     * @param {number} [limit] 페이지 크기(1~100, 기본 20).
+     * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listBids(limit?: number, cursor?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ListBidsResponseDto, any, {}>>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(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} bidId 공고 식별자(등록 응답의 bidId).
      * @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(bidId: string, idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidFailedV2ResponseDto, any, {}>>;
+    /**
+     * 초안(DRAFT) 상태로 등록된 공고를 진행중(ONGOING)으로 게시합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 연간/지명계약 등으로 초안 상태로 등록된 공고를 명시적으로 게시할 때. 등록 응답의 `status` 로 게시 필요 여부를 판별합니다.  **전제조건:** 초안(DRAFT) 상태이고 마감(bidEndAt)이 미래여야 합니다.  **거부:** 초안이 아니거나 마감이 지난 공고 → 409. 마감이 지났으면 먼저 마감일을 연장해야 합니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 공고 게시(초안 → 진행중)
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    publishBid(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidPublishedResponseDto, any, {}>>;
     /**
      * 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
      * @summary 계약서류 생성(재생성)
@@ -540,14 +682,15 @@ 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)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidId}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
      * @summary 낙찰 결과 전송
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
      * @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(bidId: string, idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AwardRegisteredV2ResponseDto, any, {}>>;
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
      * @summary 입찰 정보 전송(등록)
@@ -555,7 +698,7 @@ 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 샌드박스 응찰/마감 시뮬 (영업 데모 전용)
@@ -566,9 +709,19 @@ export declare class PartnerV2Api extends BaseAPI {
      */
     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)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+     * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다.  **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidId}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다.  **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 협상 점수평가
+     * @param {string} bidId 공고 식별자(등록 응답의 bidId).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores(bidId: string, idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<NegotiationScoredV2ResponseDto, any, {}>>;
+    /**
+     * 등록된 공고의 내용을 수정합니다. 스코프 `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.