@cmarket/partner-sdk 33.1.0 → 35.0.0

package/docs/PartnerV2Api.md

@@ -4,113 +4,34 @@ All URIs are relative to *https://partner-api.c-market.net*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
-|[**acknowledgeProductReceipt**](#acknowledgeproductreceipt) | **POST** /v2/products/receipts | 물품 수신확인|
-|[**cancelBid**](#cancelbid) | **POST** /v2/bids/{bidId}/cancel | 공고 취소|
-|[**completeAcceptance**](#completeacceptance) | **POST** /v2/bids/{bidId}/acceptance | 검수완료 전송|
-|[**completeInvoice**](#completeinvoice) | **POST** /v2/bids/{bidId}/settlement/complete | 정산 마감(송장 강제완료)|
-|[**createCardPayment**](#createcardpayment) | **POST** /v2/card-payments | 결제창 발행|
+|[**cancelBid**](#cancelbid) | **POST** /v2/bids/{bidRef}/cancel | 공고 취소|
+|[**completeAcceptance**](#completeacceptance) | **POST** /v2/bids/{bidRef}/acceptance | 검수완료 전송|
+|[**completeInvoice**](#completeinvoice) | **POST** /v2/bids/{bidRef}/settlement/complete | 정산 마감(송장 강제완료)|
 |[**createCardPaymentRequest**](#createcardpaymentrequest) | **POST** /v2/card-payment-requests | 결제창 발행 (구 경로)|
 |[**createExternalContractDocuments**](#createexternalcontractdocuments) | **POST** /v2/contract-documents | 계약서류 생성|
-|[**createWebhookEndpoint**](#createwebhookendpoint) | **POST** /v2/webhook-endpoints | 웹훅 구독 등록|
-|[**deleteWebhookEndpoint**](#deletewebhookendpoint) | **DELETE** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 삭제|
 |[**downloadFile**](#downloadfile) | **GET** /files/{fileKey} | 파일 다운로드 — 안정 URL(302)|
-|[**getBid**](#getbid) | **GET** /v2/bids/{bidId} | 공고 단건(라이프사이클) 조회|
-|[**getBidResults**](#getbidresults) | **GET** /v2/bids/{bidId}/result | 공고 결과 조회|
-|[**getBidSettlement**](#getbidsettlement) | **GET** /v2/bids/{bidId}/settlement | 정산 정보 조회|
-|[**getBidStatement**](#getbidstatement) | **GET** /v2/bids/{bidId}/statement | 거래명세서 조회|
+|[**getBid**](#getbid) | **GET** /v2/bids/{bidRef} | 공고 상세 조회|
+|[**getBidSettlement**](#getbidsettlement) | **GET** /v2/bids/{bidRef}/settlement | 정산 정보 조회|
+|[**getBidStatement**](#getbidstatement) | **GET** /v2/bids/{bidRef}/statement | 거래명세서 조회|
 |[**getFileMeta**](#getfilemeta) | **GET** /v2/files/{fileKey} | 파일 조회(메타 + 내려받기 주소)|
 |[**getSemoContractTaxinvoiceStatus**](#getsemocontracttaxinvoicestatus) | **GET** /v2/semo-contracts/{externalContractId}/tax-invoice | 계산서 발행 상태 조회|
 |[**getSupplierCardPayable**](#getsuppliercardpayable) | **GET** /v2/card-payment-requests/suppliers/{memberId}/card-payable | 공급사 카드결제 가능 여부 (구 경로)|
-|[**getSupplierCardPayableV2**](#getsuppliercardpayablev2) | **GET** /v2/suppliers/{memberId}/card-payable | 공급사 카드결제 가능 여부|
-|[**getWebhookEndpoint**](#getwebhookendpoint) | **GET** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 단건 조회|
 |[**healthControllerCheck**](#healthcontrollercheck) | **GET** /health | Partner API 헬스체크|
 |[**listBidResults**](#listbidresults) | **GET** /v2/bid-results | 공고 결과 배치 조회|
 |[**listBids**](#listbids) | **GET** /v2/bids | 공고 목록 조회|
 |[**listExternalContractDocuments**](#listexternalcontractdocuments) | **GET** /v2/contract-documents | 거래에 필요한 계약서류 목록 조회|
-|[**listProducts**](#listproducts) | **GET** /v2/products | 물품 카탈로그 조회|
-|[**listWebhookDeliveries**](#listwebhookdeliveries) | **GET** /v2/webhook-deliveries | 웹훅 전송 이력 조회|
-|[**listWebhookEndpoints**](#listwebhookendpoints) | **GET** /v2/webhook-endpoints | 웹훅 구독 목록 조회|
-|[**markBidFailed**](#markbidfailed) | **POST** /v2/bids/{bidId}/fail | 유찰 처리|
-|[**publishBid**](#publishbid) | **POST** /v2/bids/{bidId}/publish | 공고 게시(초안 → 진행중)|
-|[**regenerateContractDocuments**](#regeneratecontractdocuments) | **POST** /v2/bids/{bidId}/contract-documents | 계약서류 생성(재생성)|
-|[**registerAward**](#registeraward) | **POST** /v2/bids/{bidId}/award | 낙찰 결과 전송|
+|[**markBidFailed**](#markbidfailed) | **POST** /v2/bids/{bidRef}/fail | 유찰 처리|
+|[**registerAward**](#registeraward) | **POST** /v2/bids/{bidRef}/award | 낙찰 결과 전송|
 |[**registerBid**](#registerbid) | **POST** /v2/bids | 공고 등록|
 |[**registerSemoContract**](#registersemocontract) | **POST** /v2/semo-contracts | 계약 발행대상 등록|
-|[**revertAward**](#revertaward) | **DELETE** /v2/bids/{bidId}/award | 낙찰 되돌리기|
-|[**rotateWebhookSecret**](#rotatewebhooksecret) | **POST** /v2/webhook-endpoints/{endpointId}/rotate-secret | 웹훅 서명 시크릿 재발급|
-|[**sendWebhookTestEvent**](#sendwebhooktestevent) | **POST** /v2/webhook-endpoints/{endpointId}/test | 웹훅 연결 확인 발송|
-|[**updateBid**](#updatebid) | **PATCH** /v2/bids/{bidId} | 공고 수정|
-|[**updateWebhookEndpoint**](#updatewebhookendpoint) | **PATCH** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 수정|
+|[**revertAward**](#revertaward) | **DELETE** /v2/bids/{bidRef}/award | 낙찰 되돌리기|
+|[**updateBid**](#updatebid) | **PATCH** /v2/bids/{bidRef} | 공고 수정|
 |[**uploadFile**](#uploadfile) | **POST** /v2/files | 공고 첨부파일 업로드(base64 또는 url) → fileKey|
 
-# **acknowledgeProductReceipt**
-> AcknowledgeProductReceipt200Response acknowledgeProductReceipt(acknowledgeProductsRequestDto)
-
-저장을 마친 물품을 전송완료로 표시해 다음 조회에서 제외합니다.  **되돌릴 수 없습니다.** 표시한 물품은 `GET /v2/products` 로 다시 내려오지 않으므로, 자기 시스템에 저장이 끝난 뒤에 호출하세요.  **표시 범위는 기관 그룹으로 잠깁니다.** 다른 기관의 물품 코드를 섞어 보내면 그 건은 표시되지 않고 `acknowledged` 가 요청 수보다 작게 돌아옵니다.  **필수 스코프:** `products:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration,
-    AcknowledgeProductsRequestDto
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
-let acknowledgeProductsRequestDto: AcknowledgeProductsRequestDto; //
-
-const { status, data } = await apiInstance.acknowledgeProductReceipt(
-    idempotencyKey,
-    acknowledgeProductsRequestDto
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **acknowledgeProductsRequestDto** | **AcknowledgeProductsRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
-
-
-### Return type
-
-**AcknowledgeProductReceipt200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수신확인 결과. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 backend 입력 거부(`…/upstream-invalid-input`). |  -  |
-|**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
-|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키의 대행 범위 밖(`…/buyer-scope-mismatch` — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(`type: …/idempotency-key-conflict` — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(`type: …/idempotency-key-reused`). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(`…/upstream-unprocessable`)도 이 상태다. |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`) — 전역 60/min per client_id. `Retry-After` + `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더 참조. `retryable: true`. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). `retryable: true`. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). `retryable: true`. |  -  |
-|**503** | backend 도달 불가(`type: …/service-unavailable`). `Retry-After` 헤더 참조. `retryable: true`. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
 # **cancelBid**
 > CancelBid200Response cancelBid(cancelBidRequestDto)
 
-진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다.  **전제조건:** 진행중(ONGOING) 상태여야 합니다.  **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403.  **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidId}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
+진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다.  **전제조건:** 진행중(ONGOING) 상태여야 합니다.  **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403.  **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
 
 ### Example
 
@@ -124,12 +45,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). (default to undefined)
 let cancelBidRequestDto: CancelBidRequestDto; //
 
 const { status, data } = await apiInstance.cancelBid(
-    bidId,
+    bidRef,
     idempotencyKey,
     cancelBidRequestDto
 );
@@ -140,7 +61,7 @@ const { status, data } = await apiInstance.cancelBid(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **cancelBidRequestDto** | **CancelBidRequestDto**|  | |
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). | defaults to undefined|
 
 
@@ -177,7 +98,7 @@ const { status, data } = await apiInstance.cancelBid(
 # **completeAcceptance**
 > CompleteAcceptance200Response completeAcceptance(completeAcceptanceRequestDto)
 
-낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **V5-compat 안내:** 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자 override(11종)는 modern v2 표면에서 제거됐습니다. 필요 시 V5 충실 카운터파트 `POST /v1/bids/{bidId}/acceptance`(`CompleteAcceptanceV1RequestDto`)를 사용하세요.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **V5-compat 안내:** 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자 override(11종)는 modern v2 표면에서 제거됐습니다. 필요 시 V5 충실 카운터파트 `POST /v1/bids/{bidRef}/acceptance`(`CompleteAcceptanceV1RequestDto`)를 사용하세요.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -191,12 +112,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 ID(= backend bidId = 등록 응답의 bidNo). (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
 let completeAcceptanceRequestDto: CompleteAcceptanceRequestDto; //
 
 const { status, data } = await apiInstance.completeAcceptance(
-    bidId,
+    bidRef,
     idempotencyKey,
     completeAcceptanceRequestDto
 );
@@ -207,7 +128,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **completeAcceptanceRequestDto** | **CompleteAcceptanceRequestDto**|  | |
-| **bidId** | [**string**] | 공고 ID(= backend bidId = 등록 응답의 bidNo). | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
@@ -257,11 +178,11 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; // (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
 
 const { status, data } = await apiInstance.completeInvoice(
-    bidId,
+    bidRef,
     idempotencyKey
 );
 ```
@@ -270,7 +191,7 @@ const { status, data } = await apiInstance.completeInvoice(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
@@ -304,10 +225,10 @@ const { status, data } = await apiInstance.completeInvoice(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **createCardPayment**
-> CreateCardPayment200Response createCardPayment(createCardPaymentRequestDto)
+# **createCardPaymentRequest**
+> CardPaymentRequestResponseDto createCardPaymentRequest(createCardPaymentRequestDto)
 
-발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
+발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
 
 ### Example
 
@@ -324,7 +245,7 @@ const apiInstance = new PartnerV2Api(configuration);
 let idempotencyKey: string; //재시도 안전을 위한 멱등 키. (default to undefined)
 let createCardPaymentRequestDto: CreateCardPaymentRequestDto; //
 
-const { status, data } = await apiInstance.createCardPayment(
+const { status, data } = await apiInstance.createCardPaymentRequest(
     idempotencyKey,
     createCardPaymentRequestDto
 );
@@ -340,7 +261,7 @@ const { status, data } = await apiInstance.createCardPayment(
 
 ### Return type
 
-**CreateCardPayment200Response**
+**CardPaymentRequestResponseDto**
 
 ### Authorization
 
@@ -368,10 +289,10 @@ const { status, data } = await apiInstance.createCardPayment(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **createCardPaymentRequest**
-> CardPaymentRequestResponseDto createCardPaymentRequest(createCardPaymentRequestDto)
+# **createExternalContractDocuments**
+> CreateExternalContractDocumentsResponseDto createExternalContractDocuments(createExternalContractDocumentsRequestDto)
 
-발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
+공고 없이 성사된 거래의 계약서류를 생성합니다.  **호출 시점:** 계약이 체결된 직후.  **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다.  **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요.  **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다.  **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422).  **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요.  **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다).  **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다.  **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다.  **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
 
 ### Example
 
@@ -379,18 +300,18 @@ const { status, data } = await apiInstance.createCardPayment(
 import {
     PartnerV2Api,
     Configuration,
-    CreateCardPaymentRequestDto
+    CreateExternalContractDocumentsRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let idempotencyKey: string; //재시도 안전을 위한 멱등 키. (default to undefined)
-let createCardPaymentRequestDto: CreateCardPaymentRequestDto; //
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let createExternalContractDocumentsRequestDto: CreateExternalContractDocumentsRequestDto; //
 
-const { status, data } = await apiInstance.createCardPaymentRequest(
+const { status, data } = await apiInstance.createExternalContractDocuments(
     idempotencyKey,
-    createCardPaymentRequestDto
+    createExternalContractDocumentsRequestDto
 );
 ```
 
@@ -398,13 +319,13 @@ const { status, data } = await apiInstance.createCardPaymentRequest(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **createCardPaymentRequestDto** | **CreateCardPaymentRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 재시도 안전을 위한 멱등 키. | defaults to undefined|
+| **createExternalContractDocumentsRequestDto** | **CreateExternalContractDocumentsRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
 
-**CardPaymentRequestResponseDto**
+**CreateExternalContractDocumentsResponseDto**
 
 ### Authorization
 
@@ -419,7 +340,7 @@ const { status, data } = await apiInstance.createCardPaymentRequest(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**201** | 계약서류 생성 완료. |  -  |
 |**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 backend 입력 거부(`…/upstream-invalid-input`). |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
 |**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키의 대행 범위 밖(`…/buyer-scope-mismatch` — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
@@ -432,29 +353,26 @@ const { status, data } = await apiInstance.createCardPaymentRequest(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **createExternalContractDocuments**
-> CreateExternalContractDocumentsResponseDto createExternalContractDocuments(createExternalContractDocumentsRequestDto)
+# **downloadFile**
+> downloadFile()
 
-공고 없이 성사된 거래의 계약서류를 생성합니다.  **호출 시점:** 계약이 체결된 직후.  **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다.  **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요.  **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다.  **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422).  **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요.  **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다).  **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다.  **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다.  **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidId}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
+무인증 — `fileKey` 자체가 capability 다(V5 `/download/{fileKey}` 와 같은 보안 모델). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`).  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
 
 ### Example
 
 ```typescript
 import {
     PartnerV2Api,
-    Configuration,
-    CreateExternalContractDocumentsRequestDto
+    Configuration
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
-let createExternalContractDocumentsRequestDto: CreateExternalContractDocumentsRequestDto; //
+let fileKey: string; //파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. (default to undefined)
 
-const { status, data } = await apiInstance.createExternalContractDocuments(
-    idempotencyKey,
-    createExternalContractDocumentsRequestDto
+const { status, data } = await apiInstance.downloadFile(
+    fileKey
 );
 ```
 
@@ -462,63 +380,50 @@ const { status, data } = await apiInstance.createExternalContractDocuments(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **createExternalContractDocumentsRequestDto** | **CreateExternalContractDocumentsRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+| **fileKey** | [**string**] | 파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. | defaults to undefined|
 
 
 ### Return type
 
-**CreateExternalContractDocumentsResponseDto**
+void (empty response body)
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+No authorization required
 
 ### HTTP request headers
 
- - **Content-Type**: application/json
- - **Accept**: application/json, application/problem+json
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 계약서류 생성 완료. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 backend 입력 거부(`…/upstream-invalid-input`). |  -  |
-|**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
-|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키의 대행 범위 밖(`…/buyer-scope-mismatch` — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(`type: …/idempotency-key-conflict` — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(`type: …/idempotency-key-reused`). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(`…/upstream-unprocessable`)도 이 상태다. |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`) — 전역 60/min per client_id. `Retry-After` + `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더 참조. `retryable: true`. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). `retryable: true`. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). `retryable: true`. |  -  |
-|**503** | backend 도달 불가(`type: …/service-unavailable`). `Retry-After` 헤더 참조. `retryable: true`. |  -  |
+|**302** | 해소된 다운로드 URL 로 리다이렉트 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **createWebhookEndpoint**
-> CreateWebhookEndpoint201Response createWebhookEndpoint(createWebhookEndpointRequestDto)
+# **getBid**
+> GetBid200Response getBid()
 
-수신 주소와 구독할 이벤트를 등록합니다.  **호출 시점:** 연동 초기 1회. 수신 주소가 바뀌면 새로 만들지 말고 `PATCH` 로 고치세요 — 그래야 시크릿과 전송 이력이 유지됩니다.  **서명 시크릿은 이 응답에서 한 번만 나갑니다.** 서버는 해시만 보관하므로 조회로 다시 받을 수 없습니다. 응답의 `secret` 을 즉시 안전한 곳에 보관하세요. 잃어버렸다면 복구가 아니라 `POST /v2/webhook-endpoints/{endpointId}/rotate-secret` 으로 **재발급**해야 합니다.  **거절되는 경우와 고치는 법:** - `400` — `url` 이 HTTPS 가 아니거나 형식이 잘못됨, `eventTypes` 가 비었거나 목록 밖 값   (`ping` 은 구독 불가). 값을 고쳐 재시도하세요. - `400` — `Idempotency-Key` 헤더 누락/형식 오류. UUID v4 를 실어 보내세요. - `403` — 토큰에 `webhooks:write` 스코프가 없음. 키 발급 설정을 넓혀야 합니다.  **필수 스코프:** `webhooks:write`  **멱등성:** `Idempotency-Key` 헤더 필수.  ### 서명 검증 (필수)  발송 요청마다 헤더 `X-CMarket-Signature` 가 실립니다.  ``` X-CMarket-Signature: t=<unix초>,v1=<hex> ```  `v1` 은 `HMAC-SHA256(secret, \"${t}.${요청 본문 원문}\")` 의 소문자 hex 입니다.  1. 헤더를 `t` 와 `v1` 로 나눕니다. 2. `\"${t}.${본문}\"` 을 만듭니다. **본문은 파싱 전 원문 바이트**여야 합니다 — JSON 을 다시    직렬화하면 공백·키 순서가 달라져 서명이 맞지 않습니다. 3. 등록 시 받은 시크릿으로 HMAC-SHA256 을 계산해 `v1` 과 비교합니다. 비교는 **상수 시간**    비교 함수를 쓰세요(Node `crypto.timingSafeEqual`, Java `MessageDigest.isEqual`). 4. `t` 가 현재 시각으로부터 **5분** 이상 지났으면 거절하세요(재전송 공격 방어).  ### 중복 제거  `X-CMarket-Event-Id` 헤더가 이벤트 식별자입니다. **재시도에도 같은 값이 옵니다** — 이미 처리한 값이면 무시하세요. 같은 이벤트를 두 번 받는 것은 정상 동작이며, 중복 제거는 수신측 책임입니다.  ### 응답과 재시도  2xx 를 돌려주면 성공입니다. 그 외(또는 무응답)는 실패로 보고 최대 7회 재시도합니다 — 간격은 10초 → 1분 → 5분 → 30분 → 2시간 → 6시간 → 24시간 입니다. 처리 시간이 길면 먼저 2xx 를 돌려주고 비동기로 처리하세요.  연속 실패가 20회에 닿으면 구독이 자동으로 `DISABLED` 로 내려가고 발송이 멈춥니다. 수신측을 고친 뒤 `PATCH /v2/webhook-endpoints/{endpointId}` 에 `{\"status\":\"ACTIVE\"}` 로 되살리세요.  ### 구독 가능한 이벤트  `bid.closed` · `bid.awarded` · `bid.failed` · `bid.canceled` · `bid.award_reverted`  `ping` 은 연결 확인 전용이라 구독할 수 없습니다 — 테스트 발송 경로에서만 나갑니다.  ### 놓친 이벤트 확인  `GET /v2/webhook-deliveries` 가 발송 시도 이력(본문·응답 상태·다음 재시도 시각)을 돌려줍니다. 수신측 장애 구간을 메울 때 이 엔드포인트를 폴링 대체 경로로 쓰세요.
+공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요.  **계약서류:** `contractDocuments[].generationState` 는 **관측 전용**입니다. `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태이며 API 로 되살릴 수 없습니다 — 운영에 문의하세요.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
 
 ### Example
 
 ```typescript
 import {
     PartnerV2Api,
-    Configuration,
-    CreateWebhookEndpointRequestDto
+    Configuration
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
-let createWebhookEndpointRequestDto: CreateWebhookEndpointRequestDto; //
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 
-const { status, data } = await apiInstance.createWebhookEndpoint(
-    idempotencyKey,
-    createWebhookEndpointRequestDto
+const { status, data } = await apiInstance.getBid(
+    bidRef
 );
 ```
 
@@ -526,13 +431,12 @@ const { status, data } = await apiInstance.createWebhookEndpoint(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **createWebhookEndpointRequestDto** | **CreateWebhookEndpointRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 
 
 ### Return type
 
-**CreateWebhookEndpoint201Response**
+**GetBid200Response**
 
 ### Authorization
 
@@ -540,19 +444,17 @@ const { status, data } = await apiInstance.createWebhookEndpoint(
 
 ### HTTP request headers
 
- - **Content-Type**: application/json
+ - **Content-Type**: Not defined
  - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 구독 등록 완료. &#x60;secret&#x60; 은 이 응답에만 실립니다. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
 |**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
 |**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 |**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -560,10 +462,10 @@ const { status, data } = await apiInstance.createWebhookEndpoint(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **deleteWebhookEndpoint**
-> deleteWebhookEndpoint()
+# **getBidSettlement**
+> GetBidSettlement200Response getBidSettlement()
 
-구독을 삭제합니다. 이후 그 주소로는 아무 이벤트도 발송되지 않습니다.  **호출 시점:** 연동을 종료할 때. 잠시만 멈추려면 삭제하지 말고 `PATCH … {\"status\":\"DISABLED\"}` 를 쓰세요 — 시크릿과 이벤트 구성이 남아 그대로 되살릴 수 있습니다.  **되돌릴 수 없습니다.** 다시 등록하면 새 구독이고 서명 시크릿도 새 값입니다.  **`If-Match` 가 필수입니다.** `GET` 으로 받은 `ETag` 를 실어 보내세요. - `428` — 헤더 누락. 조회 후 재시도하세요. - `412` — 그 사이 구독이 바뀌었습니다(누군가 수정했거나 발송기가 상태를 내렸습니다). 다시   조회해 정말 지울 대상이 맞는지 확인하고 최신 `ETag` 로 재시도하세요.  **필수 스코프:** `webhooks:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.  가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다.  **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
 
 ### Example
 
@@ -576,16 +478,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let endpointId: string; //구독 식별자(등록 응답의 `endpointId`). (default to undefined)
-let ifMatch: string; // (default to undefined)
-let ifMatch2: string; //직전 조회 응답의 `ETag` 값. 누락하면 428, 그 사이 구독이 바뀌었으면 412 로 거절되며 아무것도 변경되지 않습니다. (default to undefined)
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 
-const { status, data } = await apiInstance.deleteWebhookEndpoint(
-    endpointId,
-    ifMatch,
-    ifMatch2,
-    idempotencyKey
+const { status, data } = await apiInstance.getBidSettlement(
+    bidRef
 );
 ```
 
@@ -593,15 +489,12 @@ const { status, data } = await apiInstance.deleteWebhookEndpoint(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **endpointId** | [**string**] | 구독 식별자(등록 응답의 &#x60;endpointId&#x60;). | defaults to undefined|
-| **ifMatch** | [**string**] |  | defaults to undefined|
-| **ifMatch2** | [**string**] | 직전 조회 응답의 &#x60;ETag&#x60; 값. 누락하면 428, 그 사이 구독이 바뀌었으면 412 로 거절되며 아무것도 변경되지 않습니다. | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 
 
 ### Return type
 
-void (empty response body)
+**GetBidSettlement200Response**
 
 ### Authorization
 
@@ -610,20 +503,16 @@ void (empty response body)
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/problem+json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**204** | 구독 삭제 완료(본문 없음). |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**412** | &#x60;If-Match&#x60; 가 현재 구독 버전과 다릅니다(&#x60;type: …/precondition-failed&#x60;). 다시 조회해 최신 &#x60;ETag&#x60; 로 재시도하세요. |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
-|**428** | &#x60;If-Match&#x60; 헤더가 없습니다(&#x60;type: …/if-match-required&#x60;). 잃어버린 삭제 사고를 막기 위해 필수입니다. |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
 |**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
 |**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 |**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -631,10 +520,10 @@ void (empty response body)
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **downloadFile**
-> downloadFile()
+# **getBidStatement**
+> GetBidStatement200Response getBidStatement()
 
-무인증 — `fileKey` 자체가 capability 다(V5 `/download/{fileKey}` 와 같은 보안 모델). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`).  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
+낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다.  **필수 스코프:** `invoices:read` — 종전에는 `contracts:read` 를 요구했습니다. 금액이 실리는 정산 계열 문서라 계약서류 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
 
 ### Example
 
@@ -647,10 +536,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let fileKey: string; //파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
+let paperCode: number; // (optional) (default to undefined)
 
-const { status, data } = await apiInstance.downloadFile(
-    fileKey
+const { status, data } = await apiInstance.getBidStatement(
+    bidRef,
+    paperCode
 );
 ```
 
@@ -658,34 +549,42 @@ const { status, data } = await apiInstance.downloadFile(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **fileKey** | [**string**] | 파일 키 — 영문 대소문자·숫자 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
+| **paperCode** | [**number**] |  | (optional) defaults to undefined|
 
 
 ### Return type
 
-void (empty response body)
+**GetBidStatement200Response**
 
 ### Authorization
 
-No authorization required
+[partner-oauth2](../README.md#partner-oauth2)
 
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: Not defined
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**302** | 해소된 다운로드 URL 로 리다이렉트 |  -  |
+|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
+|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
+|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
+|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
+|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
+|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **getBid**
-> GetBid200Response getBid()
+# **getFileMeta**
+> GetFileMeta200Response getFileMeta()
 
-공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다.  **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요.  **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다.  **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다.  **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.  **필수 스코프:** `files:read`
 
 ### Example
 
@@ -698,10 +597,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
+let fileKey: string; //파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자). (default to undefined)
 
-const { status, data } = await apiInstance.getBid(
-    bidId
+const { status, data } = await apiInstance.getFileMeta(
+    fileKey
 );
 ```
 
@@ -709,12 +608,12 @@ const { status, data } = await apiInstance.getBid(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **fileKey** | [**string**] | 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자). | defaults to undefined|
 
 
 ### Return type
 
-**GetBid200Response**
+**GetFileMeta200Response**
 
 ### Authorization
 
@@ -740,10 +639,10 @@ const { status, data } = await apiInstance.getBid(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **getBidResults**
-> GetBidResults200Response getBidResults()
+# **getSemoContractTaxinvoiceStatus**
+> SemoContractTaxinvoiceStatusResponseDto getSemoContractTaxinvoiceStatus()
 
-공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
+등록한 계약의 계산서 발행 상태를 확인합니다.  **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API 로 되읽으세요.  **필수 스코프:** `contracts:read`
 
 ### Example
 
@@ -756,10 +655,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; // (default to undefined)
+let externalContractId: string; //등록할 때 보낸 파트너 측 계약 식별자. (default to undefined)
 
-const { status, data } = await apiInstance.getBidResults(
-    bidId
+const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
+    externalContractId
 );
 ```
 
@@ -767,12 +666,12 @@ const { status, data } = await apiInstance.getBidResults(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
+| **externalContractId** | [**string**] | 등록할 때 보낸 파트너 측 계약 식별자. | defaults to undefined|
 
 
 ### Return type
 
-**GetBidResults200Response**
+**SemoContractTaxinvoiceStatusResponseDto**
 
 ### Authorization
 
@@ -781,27 +680,20 @@ const { status, data } = await apiInstance.getBidResults(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
+ - **Accept**: application/json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
+|**200** |  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **getBidSettlement**
-> GetBidSettlement200Response getBidSettlement()
+# **getSupplierCardPayable**
+> SupplierCardPayableResponseDto getSupplierCardPayable()
 
-낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.  가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다.  **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
+계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **필수 스코프:** `payments:write`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
 
 ### Example
 
@@ -814,10 +706,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; // (default to undefined)
+let memberId: string; //계약업체 회원 ID (default to undefined)
 
-const { status, data } = await apiInstance.getBidSettlement(
-    bidId
+const { status, data } = await apiInstance.getSupplierCardPayable(
+    memberId
 );
 ```
 
@@ -825,12 +717,12 @@ const { status, data } = await apiInstance.getBidSettlement(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
+| **memberId** | [**string**] | 계약업체 회원 ID | defaults to undefined|
 
 
 ### Return type
 
-**GetBidSettlement200Response**
+**SupplierCardPayableResponseDto**
 
 ### Authorization
 
@@ -839,27 +731,20 @@ const { status, data } = await apiInstance.getBidSettlement(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
+ - **Accept**: application/json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
+|**200** |  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **getBidStatement**
-> GetBidStatement200Response getBidStatement()
+# **healthControllerCheck**
+> HealthControllerCheck200Response healthControllerCheck()
 
-낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다.  **필수 스코프:** `invoices:read` — 종전에는 `contracts:read` 를 요구했습니다. 금액이 실리는 정산 계열 문서라 계약서류 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
+ERP 연동 직전 회선·인증 endpoint 동작 확인용.
 
 ### Example
 
@@ -872,480 +757,20 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; // (default to undefined)
-let paperCode: number; // (optional) (default to undefined)
-
-const { status, data } = await apiInstance.getBidStatement(
-    bidId,
-    paperCode
-);
+const { status, data } = await apiInstance.healthControllerCheck();
 ```
 
 ### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
-| **paperCode** | [**number**] |  | (optional) defaults to undefined|
+This endpoint does not have any parameters.
 
 
 ### Return type
 
-**GetBidStatement200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getFileMeta**
-> GetFileMeta200Response getFileMeta()
-
-파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다.  **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요.  **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다.  **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다.  **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.  **필수 스코프:** `files:read`
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let fileKey: string; //파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자). (default to undefined)
-
-const { status, data } = await apiInstance.getFileMeta(
-    fileKey
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **fileKey** | [**string**] | 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자). | defaults to undefined|
-
-
-### Return type
-
-**GetFileMeta200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getSemoContractTaxinvoiceStatus**
-> SemoContractTaxinvoiceStatusResponseDto getSemoContractTaxinvoiceStatus()
-
-등록한 계약의 계산서 발행 상태를 확인합니다.  **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API 로 되읽으세요.  **필수 스코프:** `contracts:read`
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let externalContractId: string; //등록할 때 보낸 파트너 측 계약 식별자. (default to undefined)
-
-const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
-    externalContractId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **externalContractId** | [**string**] | 등록할 때 보낸 파트너 측 계약 식별자. | defaults to undefined|
-
-
-### Return type
-
-**SemoContractTaxinvoiceStatusResponseDto**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getSupplierCardPayable**
-> SupplierCardPayableResponseDto getSupplierCardPayable()
-
-계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **필수 스코프:** `payments:write`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let memberId: string; //계약업체 회원 ID (default to undefined)
-
-const { status, data } = await apiInstance.getSupplierCardPayable(
-    memberId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **memberId** | [**string**] | 계약업체 회원 ID | defaults to undefined|
-
-
-### Return type
-
-**SupplierCardPayableResponseDto**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getSupplierCardPayableV2**
-> GetSupplierCardPayableV2200Response getSupplierCardPayableV2()
-
-계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 를 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let memberId: string; //계약업체 회원 ID (default to undefined)
-
-const { status, data } = await apiInstance.getSupplierCardPayableV2(
-    memberId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **memberId** | [**string**] | 계약업체 회원 ID | defaults to undefined|
-
-
-### Return type
-
-**GetSupplierCardPayableV2200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getWebhookEndpoint**
-> GetWebhookEndpoint200Response getWebhookEndpoint()
-
-구독 1건의 현재 상태를 조회합니다. 서명 시크릿은 실리지 않습니다.  **수정·삭제 전에 먼저 호출하세요.** 응답 헤더 `ETag` 를 `If-Match` 에 그대로 실어야 `PATCH`/`DELETE` 가 통과합니다.  **`404`:** 없는 구독이거나 다른 파트너 키의 구독입니다 — `endpointId` 를 확인하세요.  **필수 스코프:** `webhooks:read`
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let endpointId: string; //구독 식별자(등록 응답의 `endpointId`). (default to undefined)
-
-const { status, data } = await apiInstance.getWebhookEndpoint(
-    endpointId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **endpointId** | [**string**] | 구독 식별자(등록 응답의 &#x60;endpointId&#x60;). | defaults to undefined|
-
-
-### Return type
-
-**GetWebhookEndpoint200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 웹훅 구독 상세. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **healthControllerCheck**
-> HealthControllerCheck200Response healthControllerCheck()
-
-ERP 연동 직전 회선·인증 endpoint 동작 확인용.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-const { status, data } = await apiInstance.healthControllerCheck();
-```
-
-### Parameters
-This endpoint does not have any parameters.
-
-
-### Return type
-
-**HealthControllerCheck200Response**
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **listBidResults**
-> ListBidResults200Response listBidResults()
-
-여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 가 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다.  **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다.  **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 — 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요.  **목록이 길어 URL 이 부담되면** `POST /v2/bid-results/query` 를 쓰세요. 응답은 같습니다.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let bidIds: string; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidIds` 를 반복해 전달합니다. 최대 100건. (default to undefined)
-
-const { status, data } = await apiInstance.listBidResults(
-    bidIds
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidIds** | [**string**] | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건. | defaults to undefined|
-
-
-### Return type
-
-**ListBidResults200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **listBids**
-> ListBids200Response listBids()
-
-발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 100) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let limit: number; //페이지 크기(1~100, 기본 100). (optional) (default to 100)
-let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다. (optional) (default to undefined)
-let bidIds: Array<string>; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. (optional) (default to undefined)
-let status: Array<BidPublicStatus>; //공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다. (optional) (default to undefined)
-let include: Array<'results' | 'products' | 'contacts'>; //행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). (optional) (default to undefined)
-
-const { status, data } = await apiInstance.listBids(
-    limit,
-    cursor,
-    bidIds,
-    status,
-    include
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **limit** | [**number**] | 페이지 크기(1~100, 기본 100). | (optional) defaults to 100|
-| **cursor** | [**string**] | 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다. | (optional) defaults to undefined|
-| **bidIds** | **Array&lt;string&gt;** | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. | (optional) defaults to undefined|
-| **status** | **Array&lt;BidPublicStatus&gt;** | 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다. | (optional) defaults to undefined|
-| **include** | **Array<&#39;results&#39; &#124; &#39;products&#39; &#124; &#39;contacts&#39;>** | 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). | (optional) defaults to undefined|
-
-
-### Return type
-
-**ListBids200Response**
+**HealthControllerCheck200Response**
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+No authorization required
 
 ### HTTP request headers
 
@@ -1357,199 +782,15 @@ const { status, data } = await apiInstance.listBids(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **listExternalContractDocuments**
-> ExternalContractDocumentsResponseDto listExternalContractDocuments()
-
-발주기관 회원과 거래유형으로 **그 거래에 필요한 계약서류 목록**을 조회합니다.  **용도:** 공고(입찰)를 거치지 않는 거래 — 예: 채팅 기반 견적 — 에서 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때.  **판정 기준:** 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다.  **응답 해석:** - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 **미리 체크된 상태로** 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market 이 데이터를 채워 PDF 로 만들어 주는 서류입니다. 생성 API 의 `paperCodes` 에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요.  **조회 가능한 회원 범위:** 이 API 키에 설정된 대행 범위(소속 그룹 전원 또는 지정 회원 목록) 안의 회원만 조회할 수 있습니다. 범위 밖이면 403 입니다. 대행 범위는 키 설정이며 스코프와는 별개 축입니다.  **필수 스코프:** `contracts:read`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidId}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let buyerId: string; //발주기관 회원 ID(c-market memberId). (default to undefined)
-let bidType: 'goods' | 'service' | 'construction' | 'sale'; //거래유형. (default to undefined)
-
-const { status, data } = await apiInstance.listExternalContractDocuments(
-    buyerId,
-    bidType
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **buyerId** | [**string**] | 발주기관 회원 ID(c-market memberId). | defaults to undefined|
-| **bidType** | [**&#39;goods&#39; | &#39;service&#39; | &#39;construction&#39; | &#39;sale&#39;**]**Array<&#39;goods&#39; &#124; &#39;service&#39; &#124; &#39;construction&#39; &#124; &#39;sale&#39;>** | 거래유형. | defaults to undefined|
-
-
-### Return type
-
-**ExternalContractDocumentsResponseDto**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 필요 계약서류 목록. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **listProducts**
-> ListProducts200Response listProducts()
-
-기관에 공유된 물품 중 **아직 전송되지 않은 것**을 조회합니다.  **증분 피드입니다.** 가져간 물품을 `POST /v2/products/receipts` 로 수신확인하면 다음 조회 결과에서 빠집니다. 수신확인을 하지 않으면 같은 물품이 계속 내려옵니다.  **권장 흐름:** 조회 → 자기 시스템에 저장 → 저장에 성공한 물품 코드만 수신확인. 저장 전에 수신확인하면 그 물품은 다시 받을 수 없습니다.  **조회 범위:** 요청 키가 대행하는 기관 그룹입니다. 기관 그룹이 설정되지 않은 키는 403 입니다.  **필수 스코프:** `products:read`
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-const { status, data } = await apiInstance.listProducts();
-```
-
-### Parameters
-This endpoint does not have any parameters.
-
-
-### Return type
-
-**ListProducts200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 미전송 물품 목록. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **listWebhookDeliveries**
-> ListWebhookDeliveries200Response listWebhookDeliveries()
-
-이 API 키의 웹훅 발송 시도를 최신순으로 조회합니다. 보낸 본문·수신측 응답 상태· 다음 재시도 예정 시각이 함께 실립니다.  **호출 시점:** - 수신측 장애로 놓친 이벤트를 메울 때. 이 엔드포인트가 웹훅의 **폴링 대체 경로**입니다 —   `status=EXHAUSTED` 로 걸러 다시 처리하면 됩니다. - \"이벤트가 안 온다\" 를 진단할 때. 발송 시도 자체가 없는지(구독·이벤트 타입 문제), 시도했지만   실패했는지(`responseStatus`·`responseBodyExcerpt`)를 여기서 가릅니다.  **같은 이벤트가 여러 행으로 보입니다.** 재시도마다 한 행이며 `eventId` 가 같고 `attempt` 만 올라갑니다. 처리 여부는 `eventId` 기준으로 판단하세요.  **페이지네이션:** `nextCursor` 를 다음 요청의 `cursor` 로 전달합니다. null 이면 마지막 페이지입니다.  **`400`:** `status` 가 허용 값 밖이거나 `limit` 이 범위를 벗어났습니다 — 값을 고쳐 재시도하세요.  **필수 스코프:** `webhooks:read`
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let endpointId: string; //이 구독의 전송만 조회합니다. 미지정이면 이 키의 모든 구독을 함께 조회합니다. (optional) (default to undefined)
-let status: PartnerWebhookDeliveryStatus; //전송 상태 필터. 미지정이면 전부. (optional) (default to undefined)
-let limit: number; //페이지 크기(1~200, 기본 50). (optional) (default to 50)
-let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달합니다. 미지정 시 첫 페이지. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.listWebhookDeliveries(
-    endpointId,
-    status,
-    limit,
-    cursor
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **endpointId** | [**string**] | 이 구독의 전송만 조회합니다. 미지정이면 이 키의 모든 구독을 함께 조회합니다. | (optional) defaults to undefined|
-| **status** | **PartnerWebhookDeliveryStatus** | 전송 상태 필터. 미지정이면 전부. | (optional) defaults to undefined|
-| **limit** | [**number**] | 페이지 크기(1~200, 기본 50). | (optional) defaults to 50|
-| **cursor** | [**string**] | 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달합니다. 미지정 시 첫 페이지. | (optional) defaults to undefined|
-
-
-### Return type
-
-**ListWebhookDeliveries200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 웹훅 전송 이력. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
 |**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
 |**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **listWebhookEndpoints**
-> ListWebhookEndpoints200Response listWebhookEndpoints()
+# **listBidResults**
+> ListBidResults200Response listBidResults()
 
-이 API 키가 등록한 웹훅 구독을 모두 조회합니다.  **호출 시점:** 연동 상태를 점검할 때, 또는 발송이 멈춘 이유(`status`·`consecutiveFailures`)를 확인할 때. 서명 시크릿은 여기에 실리지 않습니다.  **필수 스코프:** `webhooks:read`  ### 서명 검증 (필수)  발송 요청마다 헤더 `X-CMarket-Signature` 가 실립니다.  ``` X-CMarket-Signature: t=<unix초>,v1=<hex> ```  `v1` 은 `HMAC-SHA256(secret, \"${t}.${요청 본문 원문}\")` 의 소문자 hex 입니다.  1. 헤더를 `t` 와 `v1` 로 나눕니다. 2. `\"${t}.${본문}\"` 을 만듭니다. **본문은 파싱 전 원문 바이트**여야 합니다 — JSON 을 다시    직렬화하면 공백·키 순서가 달라져 서명이 맞지 않습니다. 3. 등록 시 받은 시크릿으로 HMAC-SHA256 을 계산해 `v1` 과 비교합니다. 비교는 **상수 시간**    비교 함수를 쓰세요(Node `crypto.timingSafeEqual`, Java `MessageDigest.isEqual`). 4. `t` 가 현재 시각으로부터 **5분** 이상 지났으면 거절하세요(재전송 공격 방어).  ### 중복 제거  `X-CMarket-Event-Id` 헤더가 이벤트 식별자입니다. **재시도에도 같은 값이 옵니다** — 이미 처리한 값이면 무시하세요. 같은 이벤트를 두 번 받는 것은 정상 동작이며, 중복 제거는 수신측 책임입니다.  ### 응답과 재시도  2xx 를 돌려주면 성공입니다. 그 외(또는 무응답)는 실패로 보고 최대 7회 재시도합니다 — 간격은 10초 → 1분 → 5분 → 30분 → 2시간 → 6시간 → 24시간 입니다. 처리 시간이 길면 먼저 2xx 를 돌려주고 비동기로 처리하세요.  연속 실패가 20회에 닿으면 구독이 자동으로 `DISABLED` 로 내려가고 발송이 멈춥니다. 수신측을 고친 뒤 `PATCH /v2/webhook-endpoints/{endpointId}` 에 `{\"status\":\"ACTIVE\"}` 로 되살리세요.  ### 구독 가능한 이벤트  `bid.closed` · `bid.awarded` · `bid.failed` · `bid.canceled` · `bid.award_reverted`  `ping` 은 연결 확인 전용이라 구독할 수 없습니다 — 테스트 발송 경로에서만 나갑니다.  ### 놓친 이벤트 확인  `GET /v2/webhook-deliveries` 가 발송 시도 이력(본문·응답 상태·다음 재시도 시각)을 돌려줍니다. 수신측 장애 구간을 메울 때 이 엔드포인트를 폴링 대체 경로로 쓰세요.
+여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 가 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다.  **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다.  **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 — 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요.  **단건 조회:** 공고 하나만 볼 때도 `bidIds` 에 하나만 넣거나 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요. 종전의 `GET /v2/bids/{bidRef}/result` 는 상세 응답의 부분집합이라 폐지됐습니다.
 
 ### Example
 
@@ -1562,16 +803,23 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-const { status, data } = await apiInstance.listWebhookEndpoints();
+let bidIds: string; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidIds` 를 반복해 전달합니다. 최대 100건. (default to undefined)
+
+const { status, data } = await apiInstance.listBidResults(
+    bidIds
+);
 ```
 
 ### Parameters
-This endpoint does not have any parameters.
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidIds** | [**string**] | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건. | defaults to undefined|
 
 
 ### Return type
 
-**ListWebhookEndpoints200Response**
+**ListBidResults200Response**
 
 ### Authorization
 
@@ -1586,7 +834,7 @@ This endpoint does not have any parameters.
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 웹훅 구독 목록. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
 |**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
@@ -1597,31 +845,34 @@ This endpoint does not have any parameters.
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **markBidFailed**
-> MarkBidFailed201Response markBidFailed(markBidFailedRequestDto)
+# **listBids**
+> ListBids200Response listBids()
 
-공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(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` 헤더 필수.
+발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 100) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
 
 ### Example
 
 ```typescript
 import {
     PartnerV2Api,
-    Configuration,
-    MarkBidFailedRequestDto
+    Configuration
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
-let markBidFailedRequestDto: MarkBidFailedRequestDto; //
+let limit: number; //페이지 크기(1~100, 기본 100). (optional) (default to 100)
+let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다. (optional) (default to undefined)
+let bidIds: Array<string>; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. (optional) (default to undefined)
+let status: Array<BidPublicStatus>; //공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다. (optional) (default to undefined)
+let include: Array<'results' | 'products' | 'contacts'>; //행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). (optional) (default to undefined)
 
-const { status, data } = await apiInstance.markBidFailed(
-    bidId,
-    idempotencyKey,
-    markBidFailedRequestDto
+const { status, data } = await apiInstance.listBids(
+    limit,
+    cursor,
+    bidIds,
+    status,
+    include
 );
 ```
 
@@ -1629,14 +880,16 @@ const { status, data } = await apiInstance.markBidFailed(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+| **limit** | [**number**] | 페이지 크기(1~100, 기본 100). | (optional) defaults to 100|
+| **cursor** | [**string**] | 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다. | (optional) defaults to undefined|
+| **bidIds** | **Array&lt;string&gt;** | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. | (optional) defaults to undefined|
+| **status** | **Array&lt;BidPublicStatus&gt;** | 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다. | (optional) defaults to undefined|
+| **include** | **Array<&#39;results&#39; &#124; &#39;products&#39; &#124; &#39;contacts&#39;>** | 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). | (optional) defaults to undefined|
 
 
 ### Return type
 
-**MarkBidFailed201Response**
+**ListBids200Response**
 
 ### Authorization
 
@@ -1644,19 +897,17 @@ const { status, data } = await apiInstance.markBidFailed(
 
 ### HTTP request headers
 
- - **Content-Type**: application/json
+ - **Content-Type**: Not defined
  - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 유찰 처리 완료. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
 |**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
 |**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 |**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1664,10 +915,10 @@ const { status, data } = await apiInstance.markBidFailed(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **publishBid**
-> PublishBid200Response publishBid()
+# **listExternalContractDocuments**
+> ExternalContractDocumentsResponseDto listExternalContractDocuments()
 
-초안(DRAFT) 상태로 등록된 공고를 진행중(ONGOING)으로 게시합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 연간/지명계약 등으로 초안 상태로 등록된 공고를 명시적으로 게시할 때. 등록 응답의 `status` 로 게시 필요 여부를 판별합니다.  **전제조건:** 초안(DRAFT) 상태이고 마감(bidEndAt)이 미래여야 합니다.  **거부:** 초안이 아니거나 마감이 지난 공고 → 409. 마감이 지났으면 먼저 마감일을 연장해야 합니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).  **멱등성:** `Idempotency-Key` 헤더 필수.
+발주기관 회원과 거래유형으로 **그 거래에 필요한 계약서류 목록**을 조회합니다.  **용도:** 공고(입찰)를 거치지 않는 거래 — 예: 채팅 기반 견적 — 에서 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때.  **판정 기준:** 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다.  **응답 해석:** - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 **미리 체크된 상태로** 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market 이 데이터를 채워 PDF 로 만들어 주는 서류입니다. 생성 API 의 `paperCodes` 에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요.  **조회 가능한 회원 범위:** 이 API 키에 설정된 대행 범위(소속 그룹 전원 또는 지정 회원 목록) 안의 회원만 조회할 수 있습니다. 범위 밖이면 403 입니다. 대행 범위는 키 설정이며 스코프와는 별개 축입니다.  **필수 스코프:** `contracts:read`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
 
 ### Example
 
@@ -1680,12 +931,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). (default to undefined)
+let buyerId: string; //발주기관 회원 ID(c-market memberId). (default to undefined)
+let bidType: 'goods' | 'service' | 'construction' | 'sale'; //거래유형. (default to undefined)
 
-const { status, data } = await apiInstance.publishBid(
-    bidId,
-    idempotencyKey
+const { status, data } = await apiInstance.listExternalContractDocuments(
+    buyerId,
+    bidType
 );
 ```
 
@@ -1693,13 +944,13 @@ const { status, data } = await apiInstance.publishBid(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). | defaults to undefined|
+| **buyerId** | [**string**] | 발주기관 회원 ID(c-market memberId). | defaults to undefined|
+| **bidType** | [**&#39;goods&#39; | &#39;service&#39; | &#39;construction&#39; | &#39;sale&#39;**]**Array<&#39;goods&#39; &#124; &#39;service&#39; &#124; &#39;construction&#39; &#124; &#39;sale&#39;>** | 거래유형. | defaults to undefined|
 
 
 ### Return type
 
-**PublishBid200Response**
+**ExternalContractDocumentsResponseDto**
 
 ### Authorization
 
@@ -1714,12 +965,10 @@ const { status, data } = await apiInstance.publishBid(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 공고 게시 완료. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**200** | 필요 계약서류 목록. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(&#x60;type: …/upstream-not-found&#x60;). |  -  |
 |**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
 |**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 |**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1727,28 +976,31 @@ const { status, data } = await apiInstance.publishBid(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **regenerateContractDocuments**
-> RegenerateContractDocuments201Response regenerateContractDocuments()
+# **markBidFailed**
+> MarkBidFailed201Response markBidFailed(markBidFailedRequestDto)
 
-공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts: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` 헤더 필수.
 
 ### Example
 
 ```typescript
 import {
     PartnerV2Api,
-    Configuration
+    Configuration,
+    MarkBidFailedRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고번호(buy_idx, 예 CM…) 또는 외부 구매번호(bid_puchase_no). (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let markBidFailedRequestDto: MarkBidFailedRequestDto; //
 
-const { status, data } = await apiInstance.regenerateContractDocuments(
-    bidId,
-    idempotencyKey
+const { status, data } = await apiInstance.markBidFailed(
+    bidRef,
+    idempotencyKey,
+    markBidFailedRequestDto
 );
 ```
 
@@ -1756,13 +1008,14 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] | 공고번호(buy_idx, 예 CM…) 또는 외부 구매번호(bid_puchase_no). | defaults to undefined|
+| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
 
-**RegenerateContractDocuments201Response**
+**MarkBidFailed201Response**
 
 ### Authorization
 
@@ -1770,14 +1023,14 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 
 ### HTTP request headers
 
- - **Content-Type**: Not defined
+ - **Content-Type**: application/json
  - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 계약서류 재생성 큐 등록 완료. |  -  |
+|**201** | 유찰 처리 완료. |  -  |
 |**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1793,7 +1046,7 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 # **registerAward**
 > RegisterAward201Response registerAward(registerAwardRequestDto)
 
-낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidId}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidId}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidId}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
 
 ### Example
 
@@ -1807,12 +1060,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
 let registerAwardRequestDto: RegisterAwardRequestDto; //
 
 const { status, data } = await apiInstance.registerAward(
-    bidId,
+    bidRef,
     idempotencyKey,
     registerAwardRequestDto
 );
@@ -1823,7 +1076,7 @@ const { status, data } = await apiInstance.registerAward(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **registerAwardRequestDto** | **RegisterAwardRequestDto**|  | |
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
@@ -1860,7 +1113,7 @@ const { status, data } = await apiInstance.registerAward(
 # **registerBid**
 > RegisterBid201Response registerBid(createBidRequestDto)
 
-입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
 
 ### Example
 
@@ -2002,12 +1255,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). (default to undefined)
 let revertAwardRequestDto: RevertAwardRequestDto; //
 
 const { status, data } = await apiInstance.revertAward(
-    bidId,
+    bidRef,
     idempotencyKey,
     revertAwardRequestDto
 );
@@ -2018,7 +1271,7 @@ const { status, data } = await apiInstance.revertAward(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **revertAwardRequestDto** | **RevertAwardRequestDto**|  | |
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). | defaults to undefined|
 
 
@@ -2052,132 +1305,6 @@ const { status, data } = await apiInstance.revertAward(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **rotateWebhookSecret**
-> CreateWebhookEndpoint201Response rotateWebhookSecret()
-
-서명 시크릿을 새로 발급합니다. 응답의 `secretVersion` 이 1 올라갑니다.  **호출 시점:** 시크릿을 분실했거나 유출이 의심될 때, 또는 주기적 교체 정책이 있을 때.  **새 시크릿은 이 응답에서 한 번만 나갑니다.** 조회로 다시 받을 수 없습니다.  **옛 시크릿은 즉시 무효입니다.** 유예 기간이 없으므로, 수신측이 새 값을 반영하기 전에 도착한 이벤트는 서명 검증에 실패합니다. 배포 순서를 이렇게 잡으세요 — ① 수신측이 옛 값과 새 값을 **둘 다** 받아들이도록 배포 → ② 이 엔드포인트 호출 → ③ 응답의 새 값을 반영 → ④ 옛 값 제거. 검증 실패로 non-2xx 를 돌려주면 실패로 집계되어 20회 연속 시 구독이 중지됩니다.  **필수 스코프:** `webhooks:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 같은 키로 재전송하면 **새로 발급하지 않고** 처음 발급한 값을 그대로 돌려줍니다(24시간) — 네트워크 오류로 응답을 놓쳤을 때 같은 키로 다시 부르세요.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let endpointId: string; //구독 식별자(등록 응답의 `endpointId`). (default to undefined)
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
-
-const { status, data } = await apiInstance.rotateWebhookSecret(
-    endpointId,
-    idempotencyKey
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **endpointId** | [**string**] | 구독 식별자(등록 응답의 &#x60;endpointId&#x60;). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
-
-
-### Return type
-
-**CreateWebhookEndpoint201Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 시크릿 재발급 완료. &#x60;secret&#x60; 은 이 응답에만 실립니다. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **sendWebhookTestEvent**
-> SendWebhookTestEvent200Response sendWebhookTestEvent()
-
-등록된 주소로 `ping` 이벤트를 즉시 1회 보내고 그 결과를 돌려줍니다.  **호출 시점:** 구독을 등록한 직후, 수신 주소를 바꾼 직후, 방화벽·인증서를 손본 뒤.  **응답은 발송 결과이지 요청 실패가 아닙니다.** 수신측이 받지 못해도 HTTP `200` 에 `delivered: false` 로 옵니다 — `responseStatus`(수신측 상태)와 `error`(연결 거부·타임아웃· TLS 오류)를 보고 원인을 좁히세요.  이 발송에도 실제 이벤트와 **똑같은 서명 헤더**가 실리므로 검증 코드를 그대로 시험할 수 있습니다. `ping` 은 구독 목록에 넣을 수 없는 타입이니, 수신측이 모르는 `eventType` 을 만나면 버리도록 짜여 있다면 이 확인만 실패할 수 있습니다.  **필수 스코프:** `webhooks:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 다시 보내려면 **새 키**를 쓰세요 — 같은 키는 24시간 동안 직전 결과를 그대로 돌려줍니다(재발송하지 않습니다).
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let endpointId: string; //구독 식별자(등록 응답의 `endpointId`). (default to undefined)
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
-
-const { status, data } = await apiInstance.sendWebhookTestEvent(
-    endpointId,
-    idempotencyKey
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **endpointId** | [**string**] | 구독 식별자(등록 응답의 &#x60;endpointId&#x60;). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
-
-
-### Return type
-
-**SendWebhookTestEvent200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 연결 확인 발송 결과. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
 # **updateBid**
 > UpdateBid200Response updateBid(updateBidRequestDto)
 
@@ -2195,14 +1322,14 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let ifMatch: string; // (default to undefined)
-let ifMatch2: string; //수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidId}` 응답의 `ETag` 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다. (default to undefined)
+let ifMatch2: string; //수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidRef}` 응답의 `ETag` 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다. (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. (default to undefined)
 let updateBidRequestDto: UpdateBidRequestDto; //
 
 const { status, data } = await apiInstance.updateBid(
-    bidId,
+    bidRef,
     ifMatch,
     ifMatch2,
     idempotencyKey,
@@ -2215,9 +1342,9 @@ const { status, data } = await apiInstance.updateBid(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **updateBidRequestDto** | **UpdateBidRequestDto**|  | |
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **ifMatch** | [**string**] |  | defaults to undefined|
-| **ifMatch2** | [**string**] | 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidId}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다. | defaults to undefined|
+| **ifMatch2** | [**string**] | 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. | defaults to undefined|
 
 
@@ -2253,81 +1380,6 @@ const { status, data } = await apiInstance.updateBid(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **updateWebhookEndpoint**
-> GetWebhookEndpoint200Response updateWebhookEndpoint(updateWebhookEndpointRequestDto)
-
-수신 주소·구독 이벤트·상태를 수정합니다. 보낸 필드만 바뀝니다.  **호출 시점:** 수신 주소가 바뀌었을 때, 구독 이벤트를 늘리거나 줄일 때, 연속 실패로 자동 중지된 구독을 고친 뒤 되살릴 때(`{\"status\":\"ACTIVE\"}`).  **`eventTypes` 는 치환입니다** — 보낸 목록이 곧 새 구독 목록입니다. 하나를 더하려면 기존 목록에 더한 **전체**를 보내세요.  **`If-Match` 가 필수입니다.** 먼저 `GET /v2/webhook-endpoints/{endpointId}` 로 현재 `ETag` 를 받아 그대로 실어 보내세요. 이 헤더가 없으면 두 요청이 앞서거니 뒤서거니 하며 먼저 한 수정을 조용히 덮어씁니다. - `428` — 헤더를 빼먹었습니다. 조회 후 `ETag` 를 실어 재시도하세요. - `412` — 그 사이 구독이 바뀌었습니다. 다시 조회해 최신 `ETag` 로 재시도하세요. 아무것도   수정되지 않았습니다.  **시크릿은 이 경로로 바뀌지 않습니다** — 재발급은 `rotate-secret` 입니다.  **필수 스코프:** `webhooks:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
-
-### Example
-
-```typescript
-import {
-    PartnerV2Api,
-    Configuration,
-    UpdateWebhookEndpointRequestDto
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV2Api(configuration);
-
-let endpointId: string; //구독 식별자(등록 응답의 `endpointId`). (default to undefined)
-let ifMatch: string; // (default to undefined)
-let ifMatch2: string; //직전 조회 응답의 `ETag` 값. 누락하면 428, 그 사이 구독이 바뀌었으면 412 로 거절되며 아무것도 변경되지 않습니다. (default to undefined)
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
-let updateWebhookEndpointRequestDto: UpdateWebhookEndpointRequestDto; //
-
-const { status, data } = await apiInstance.updateWebhookEndpoint(
-    endpointId,
-    ifMatch,
-    ifMatch2,
-    idempotencyKey,
-    updateWebhookEndpointRequestDto
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **updateWebhookEndpointRequestDto** | **UpdateWebhookEndpointRequestDto**|  | |
-| **endpointId** | [**string**] | 구독 식별자(등록 응답의 &#x60;endpointId&#x60;). | defaults to undefined|
-| **ifMatch** | [**string**] |  | defaults to undefined|
-| **ifMatch2** | [**string**] | 직전 조회 응답의 &#x60;ETag&#x60; 값. 누락하면 428, 그 사이 구독이 바뀌었으면 412 로 거절되며 아무것도 변경되지 않습니다. | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
-
-
-### Return type
-
-**GetWebhookEndpoint200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수정된 웹훅 구독. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 backend 입력 거부(&#x60;…/upstream-invalid-input&#x60;). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 backend 권한 거부(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 backend 도메인 상태 충돌(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**412** | &#x60;If-Match&#x60; 가 현재 구독 버전과 다릅니다(&#x60;type: …/precondition-failed&#x60;). 다시 조회해 최신 &#x60;ETag&#x60; 로 재시도하세요. |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. backend 가 내용상 처리 불가로 거부한 경우(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
-|**428** | &#x60;If-Match&#x60; 헤더가 없습니다(&#x60;type: …/if-match-required&#x60;). 잃어버린 갱신을 막기 위해 필수입니다. |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | backend 도달 불가(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
 # **uploadFile**
 > UploadFile201Response uploadFile(uploadFileRequestDto)