@cmarket/partner-sdk 25.2.0 → 31.1.0

package/docs/PartnerV2Api.md

@@ -4,53 +4,72 @@ All URIs are relative to *https://partner-api.c-market.net*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
-|[**closeSandboxBid**](#closesandboxbid) | **POST** /v2/sandbox/bids/{bidId}/close | 샌드박스 공고 마감 (영업 데모 전용)|
+|[**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 | 결제창 발행|
 |[**createCardPaymentRequest**](#createcardpaymentrequest) | **POST** /v2/card-payment-requests | 결제창 발행|
-|[**createEmbedLaunch**](#createembedlaunch) | **POST** /v2/embed/launch | 임베드 launch code 발급 (iframe SSO)|
 |[**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}/results | 입찰 결과 조회|
+|[**getBidAcceptance**](#getbidacceptance) | **GET** /v2/bids/{bidId}/acceptance | 검수 현황 조회|
+|[**getBidResults**](#getbidresults) | **GET** /v2/bids/{bidId}/result | 입찰 결과 조회|
 |[**getBidSettlement**](#getbidsettlement) | **GET** /v2/bids/{bidId}/settlement | 입찰결과 정산정보 조회|
 |[**getBidStatement**](#getbidstatement) | **GET** /v2/bids/{bidId}/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 헬스체크|
-|[**issueTaxInvoice**](#issuetaxinvoice) | **POST** /v2/bids/{bidId}/tax-invoice | 세금계산서 발행|
+|[**listBidContractDocuments**](#listbidcontractdocuments) | **GET** /v2/bids/{bidId}/contract-documents | 계약서류 목록 조회|
+|[**listBidParticipants**](#listbidparticipants) | **GET** /v2/bids/{bidId}/participants | 응찰 현황 조회|
+|[**listBidResults**](#listbidresults) | **GET** /v2/bid-results | 입찰 결과 배치 조회|
 |[**listBids**](#listbids) | **GET** /v2/bids | 공고 목록 조회|
 |[**listExternalContractDocuments**](#listexternalcontractdocuments) | **GET** /v2/contract-documents | 거래에 필요한 계약서류 목록 조회|
-|[**markBidFailed**](#markbidfailed) | **POST** /v2/bids/{bidId}/award/fail | 유찰 처리|
+|[**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 | 공고 게시(초안 → 진행중)|
+|[**queryBidResults**](#querybidresults) | **POST** /v2/bid-results/query | 입찰 결과 배치 조회 (본문 전달)|
 |[**regenerateContractDocuments**](#regeneratecontractdocuments) | **POST** /v2/bids/{bidId}/contract-documents | 계약서류 생성(재생성)|
 |[**registerAward**](#registeraward) | **POST** /v2/bids/{bidId}/award | 낙찰 결과 전송|
 |[**registerBid**](#registerbid) | **POST** /v2/bids | 입찰 정보 전송(등록)|
 |[**registerSemoContract**](#registersemocontract) | **POST** /v2/semo-contracts | 계약 발행대상 등록|
-|[**submitNegotiationScores**](#submitnegotiationscores) | **POST** /v2/bids/{bidId}/negotiation-scores | 협상 점수평가|
+|[**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} | 웹훅 구독 수정|
 |[**uploadFile**](#uploadfile) | **POST** /v2/files | 입찰 첨부파일 업로드(base64 또는 url) → fileKey|
 
-# **closeSandboxBid**
-> CloseSandboxBidResponseDto closeSandboxBid()
+# **acknowledgeProductReceipt**
+> AcknowledgeProductReceipt200Response acknowledgeProductReceipt(acknowledgeProductsRequestDto)
 
-샌드박스 공고를 마감하는 **영업 데모 전용** 엔드포인트입니다.  **가짜 상태 주입이 아닙니다.** backend 가 스케줄러가 부르는 것과 동일한 실제 `CloseBidCommand` 를 dispatch 합니다 — 개찰이 실제로 수행되고, `status=\'B\'` 커밋 직전 투찰가 동기 복호화가 실제로 일어납니다(복호화 실패 시 마감이 중단됩니다). 즉 이 엔드포인트는 데모인 동시에 살아있는 e2e 스모크입니다.  **데모 공고 전용:** backend 가 공고 명의 == 데모 발주처인 공고에 한해서만 마감합니다. 실 발주처 공고는 절대 마감하지 않습니다.  **마감 불가:** 이미 마감됐거나 마감 불가 상태면 409(`type: …/upstream-conflict`)를 반환합니다.  **필수 스코프:** `bids:write`
+저장을 마친 물품을 전송완료로 표시해 다음 조회에서 제외합니다.  **되돌릴 수 없습니다.** 표시한 물품은 `GET /v2/products` 로 다시 내려오지 않으므로, 자기 시스템에 저장이 끝난 뒤에 호출하세요.  **표시 범위는 기관 그룹으로 잠깁니다.** 다른 기관의 물품 코드를 섞어 보내면 그 건은 표시되지 않고 `acknowledged` 가 요청 수보다 작게 돌아옵니다.  **필수 스코프:** `products:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
 ### Example
 
 ```typescript
 import {
     PartnerV2Api,
-    Configuration
+    Configuration,
+    AcknowledgeProductsRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //샌드박스 공고 ID(= backend bidId). (default to undefined)
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let acknowledgeProductsRequestDto: AcknowledgeProductsRequestDto; //
 
-const { status, data } = await apiInstance.closeSandboxBid(
-    bidId
+const { status, data } = await apiInstance.acknowledgeProductReceipt(
+    idempotencyKey,
+    acknowledgeProductsRequestDto
 );
 ```
 
@@ -58,12 +77,13 @@ const { status, data } = await apiInstance.closeSandboxBid(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] | 샌드박스 공고 ID(= backend bidId). | defaults to undefined|
+| **acknowledgeProductsRequestDto** | **AcknowledgeProductsRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
 
-**CloseSandboxBidResponseDto**
+**AcknowledgeProductReceipt200Response**
 
 ### Authorization
 
@@ -71,19 +91,86 @@ const { status, data } = await apiInstance.closeSandboxBid(
 
 ### HTTP request headers
 
- - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **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`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    CancelBidRequestDto
+} 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_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). (default to undefined)
+let cancelBidRequestDto: CancelBidRequestDto; //
+
+const { status, data } = await apiInstance.cancelBid(
+    bidId,
+    idempotencyKey,
+    cancelBidRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **cancelBidRequestDto** | **CancelBidRequestDto**|  | |
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). | defaults to undefined|
+
+
+### Return type
+
+**CancelBid200Response**
+
+### 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`). |  -  |
+|**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** | backend 도메인 충돌 — 마감 불가 상태(이미 마감 등). `type: …/upstream-conflict`. |  -  |
-|**422** | backend 가 형식은 맞지만 내용상 처리 불가로 거부(`type: …/upstream-unprocessable`). |  -  |
+|**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`. |  -  |
@@ -92,7 +179,7 @@ const { status, data } = await apiInstance.closeSandboxBid(
 [[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)
 
 # **completeAcceptance**
-> AcceptanceResultResponseDto completeAcceptance(completeAcceptanceRequestDto)
+> 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` 헤더 필수.
 
@@ -130,7 +217,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 
 ### Return type
 
-**AcceptanceResultResponseDto**
+**CompleteAcceptance200Response**
 
 ### Authorization
 
@@ -139,7 +226,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -159,7 +246,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 [[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)
 
 # **completeInvoice**
-> InvoiceCompletedResponseDto completeInvoice()
+> CompleteInvoice200Response completeInvoice()
 
 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
@@ -193,7 +280,7 @@ const { status, data } = await apiInstance.completeInvoice(
 
 ### Return type
 
-**InvoiceCompletedResponseDto**
+**CompleteInvoice200Response**
 
 ### Authorization
 
@@ -202,7 +289,7 @@ const { status, data } = await apiInstance.completeInvoice(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -221,10 +308,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)
 
-# **createCardPaymentRequest**
-> CardPaymentRequestResponseDto createCardPaymentRequest(createCardPaymentRequestDto)
+# **createCardPayment**
+> CreateCardPayment200Response createCardPayment(createCardPaymentRequestDto)
 
-발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
+발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
 
 ### Example
 
@@ -241,7 +328,7 @@ const apiInstance = new PartnerV2Api(configuration);
 let idempotencyKey: string; //재시도 안전을 위한 멱등 키. (default to undefined)
 let createCardPaymentRequestDto: CreateCardPaymentRequestDto; //
 
-const { status, data } = await apiInstance.createCardPaymentRequest(
+const { status, data } = await apiInstance.createCardPayment(
     idempotencyKey,
     createCardPaymentRequestDto
 );
@@ -257,7 +344,7 @@ const { status, data } = await apiInstance.createCardPaymentRequest(
 
 ### Return type
 
-**CardPaymentRequestResponseDto**
+**CreateCardPayment200Response**
 
 ### Authorization
 
@@ -266,7 +353,7 @@ const { status, data } = await apiInstance.createCardPaymentRequest(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -285,10 +372,10 @@ 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)
 
-# **createEmbedLaunch**
-> EmbedLaunchResponseDto createEmbedLaunch(embedLaunchRequestDto)
+# **createCardPaymentRequest**
+> CardPaymentRequestResponseDto createCardPaymentRequest(createCardPaymentRequestDto)
 
-스코프 `embed:launch` 필수. 발주기관 담당자(memberId)용 일회성 launch code(60초 TTL)를 발급한다. code 는 URL 에 싣지 말고 @cmarket/embed SDK 의 postMessage 핸드셰이크로만 iframe 에 전달할 것. memberId 가 이 API 키의 발주처 소속이 아니면 403, 미허용 screen 은 400.
+발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 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
 
@@ -296,16 +383,18 @@ const { status, data } = await apiInstance.createCardPaymentRequest(
 import {
     PartnerV2Api,
     Configuration,
-    EmbedLaunchRequestDto
+    CreateCardPaymentRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let embedLaunchRequestDto: EmbedLaunchRequestDto; //
+let idempotencyKey: string; //재시도 안전을 위한 멱등 키. (default to undefined)
+let createCardPaymentRequestDto: CreateCardPaymentRequestDto; //
 
-const { status, data } = await apiInstance.createEmbedLaunch(
-    embedLaunchRequestDto
+const { status, data } = await apiInstance.createCardPaymentRequest(
+    idempotencyKey,
+    createCardPaymentRequestDto
 );
 ```
 
@@ -313,12 +402,13 @@ const { status, data } = await apiInstance.createEmbedLaunch(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **embedLaunchRequestDto** | **EmbedLaunchRequestDto**|  | |
+| **createCardPaymentRequestDto** | **CreateCardPaymentRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 재시도 안전을 위한 멱등 키. | defaults to undefined|
 
 
 ### Return type
 
-**EmbedLaunchResponseDto**
+**CardPaymentRequestResponseDto**
 
 ### Authorization
 
@@ -327,17 +417,18 @@ const { status, data } = await apiInstance.createEmbedLaunch(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** |  |  -  |
-|**400** | 쿼리/본문 입력 검증 실패(`type: …/validation-failed`). |  -  |
+|**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`). |  -  |
-|**422** | backend 가 형식은 맞지만 내용상 처리 불가로 거부(`type: …/upstream-unprocessable`). |  -  |
+|**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`. |  -  |
@@ -348,7 +439,7 @@ const { status, data } = await apiInstance.createEmbedLaunch(
 # **createExternalContractDocuments**
 > CreateExternalContractDocumentsResponseDto createExternalContractDocuments(createExternalContractDocumentsRequestDto)
 
-공고 없이 성사된 거래의 계약서류를 생성합니다.  **호출 시점:** 계약이 체결된 직후.  **요청한 `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` 헤더 필수.
+공고 없이 성사된 거래의 계약서류를 생성합니다.  **호출 시점:** 계약이 체결된 직후.  **요청한 `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 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
 
 ### Example
 
@@ -390,7 +481,7 @@ const { status, data } = await apiInstance.createExternalContractDocuments(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -409,26 +500,29 @@ const { status, data } = await apiInstance.createExternalContractDocuments(
 
 [[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()
+# **createWebhookEndpoint**
+> CreateWebhookEndpoint201Response createWebhookEndpoint(createWebhookEndpointRequestDto)
 
-무인증 — `fileKey` 자체가 capability 다(V5 `/download/{fileKey}` 와 같은 보안 모델). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`).
+수신 주소와 구독할 이벤트를 등록합니다.  **호출 시점:** 연동 초기 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` 가 발송 시도 이력(본문·응답 상태·다음 재시도 시각)을 돌려줍니다. 수신측 장애 구간을 메울 때 이 엔드포인트를 폴링 대체 경로로 쓰세요.
 
 ### Example
 
 ```typescript
 import {
     PartnerV2Api,
-    Configuration
+    Configuration,
+    CreateWebhookEndpointRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let fileKey: string; //파일 키 — UUIDv4 hex 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. (default to undefined)
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let createWebhookEndpointRequestDto: CreateWebhookEndpointRequestDto; //
 
-const { status, data } = await apiInstance.downloadFile(
-    fileKey
+const { status, data } = await apiInstance.createWebhookEndpoint(
+    idempotencyKey,
+    createWebhookEndpointRequestDto
 );
 ```
 
@@ -436,34 +530,44 @@ const { status, data } = await apiInstance.downloadFile(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **fileKey** | [**string**] | 파일 키 — UUIDv4 hex 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. | defaults to undefined|
+| **createWebhookEndpointRequestDto** | **CreateWebhookEndpointRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
 
-void (empty response body)
+**CreateWebhookEndpoint201Response**
 
 ### Authorization
 
-No authorization required
+[partner-oauth2](../README.md#partner-oauth2)
 
 ### HTTP request headers
 
- - **Content-Type**: Not defined
- - **Accept**: Not defined
+ - **Content-Type**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**302** | 해소된 다운로드 URL 로 리다이렉트 |  -  |
+|**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;). |  -  |
+|**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)
 
-# **getBid**
-> BidDetailResponseDto getBid()
+# **deleteWebhookEndpoint**
+> deleteWebhookEndpoint()
 
-공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+구독을 삭제합니다. 이후 그 주소로는 아무 이벤트도 발송되지 않습니다.  **호출 시점:** 연동을 종료할 때. 잠시만 멈추려면 삭제하지 말고 `PATCH … {\"status\":\"DISABLED\"}` 를 쓰세요 — 시크릿과 이벤트 구성이 남아 그대로 되살릴 수 있습니다.  **되돌릴 수 없습니다.** 다시 등록하면 새 구독이고 서명 시크릿도 새 값입니다.  **`If-Match` 가 필수입니다.** `GET` 으로 받은 `ETag` 를 실어 보내세요. - `428` — 헤더 누락. 조회 후 재시도하세요. - `412` — 그 사이 구독이 바뀌었습니다(누군가 수정했거나 발송기가 상태를 내렸습니다). 다시   조회해 정말 지울 대상이 맞는지 확인하고 최신 `ETag` 로 재시도하세요.  **필수 스코프:** `webhooks:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -476,10 +580,16 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
+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)
 
-const { status, data } = await apiInstance.getBid(
-    bidId
+const { status, data } = await apiInstance.deleteWebhookEndpoint(
+    endpointId,
+    ifMatch,
+    ifMatch2,
+    idempotencyKey
 );
 ```
 
@@ -487,12 +597,15 @@ const { status, data } = await apiInstance.getBid(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **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
 
-**BidDetailResponseDto**
+void (empty response body)
 
 ### Authorization
 
@@ -501,16 +614,20 @@ const { status, data } = await apiInstance.getBid(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**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;). |  -  |
 |**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;). |  -  |
+|**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;. |  -  |
@@ -518,10 +635,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**
-> BidResultsResponseDto getBidResults()
+# **downloadFile**
+> downloadFile()
 
-공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
+무인증 — `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
 
@@ -534,10 +651,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; // (default to undefined)
+let fileKey: string; //파일 키 — UUIDv4 hex 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. (default to undefined)
 
-const { status, data } = await apiInstance.getBidResults(
-    bidId
+const { status, data } = await apiInstance.downloadFile(
+    fileKey
 );
 ```
 
@@ -545,41 +662,34 @@ const { status, data } = await apiInstance.getBidResults(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
+| **fileKey** | [**string**] | 파일 키 — UUIDv4 hex 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. | defaults to undefined|
 
 
 ### Return type
 
-**BidResultsResponseDto**
+void (empty response body)
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+No authorization required
 
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: Not defined
 
 
 ### 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;. |  -  |
+|**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)
 
-# **getBidSettlement**
-> BidSettlementResponseDto getBidSettlement()
+# **getBid**
+> GetBid200Response getBid()
 
-낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
+공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
 
 ### Example
 
@@ -592,9 +702,9 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; // (default to undefined)
+let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
 
-const { status, data } = await apiInstance.getBidSettlement(
+const { status, data } = await apiInstance.getBid(
     bidId
 );
 ```
@@ -603,12 +713,12 @@ const { status, data } = await apiInstance.getBidSettlement(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
 
 
 ### Return type
 
-**BidSettlementResponseDto**
+**GetBid200Response**
 
 ### Authorization
 
@@ -617,13 +727,13 @@ const { status, data } = await apiInstance.getBidSettlement(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**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;). |  -  |
@@ -634,10 +744,10 @@ const { status, data } = await apiInstance.getBidSettlement(
 
 [[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**
-> BidStatementResponseDto getBidStatement()
+# **getBidAcceptance**
+> GetBidAcceptance200Response getBidAcceptance()
 
-낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
+공고의 납품·검수·계약완료 진행 상태를 조회합니다. 검수완료 전송의 읽기 카운터파트입니다.  **세 축은 서로 다른 사건입니다.** - `delivered`: 낙찰 공급사가 납품(결과확인)을 보고했습니다. - `confirmed`/`confirmedAt`: 발주기관이 검수를 확인했습니다. - `contractCompletedAt`: 검수완료 전송이 원장에 반영된 시각입니다.  검수완료 전송(`POST /v2/bids/{bidId}/acceptance`)이 성사되었는지는 `contractCompletedAt` 이 채워졌는지로 확인하세요.  **필수 스코프:** `contracts:read`
 
 ### Example
 
@@ -650,12 +760,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; // (default to undefined)
-let paperCode: number; // (optional) (default to undefined)
+let bidId: string; //공고 ID(= backend bidId = 등록 응답의 bidNo). (default to undefined)
 
-const { status, data } = await apiInstance.getBidStatement(
-    bidId,
-    paperCode
+const { status, data } = await apiInstance.getBidAcceptance(
+    bidId
 );
 ```
 
@@ -663,13 +771,12 @@ const { status, data } = await apiInstance.getBidStatement(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
-| **paperCode** | [**number**] |  | (optional) defaults to undefined|
+| **bidId** | [**string**] | 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo). | defaults to undefined|
 
 
 ### Return type
 
-**BidStatementResponseDto**
+**GetBidAcceptance200Response**
 
 ### Authorization
 
@@ -678,13 +785,13 @@ const { status, data } = await apiInstance.getBidStatement(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**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;). |  -  |
@@ -695,10 +802,10 @@ const { status, data } = await apiInstance.getBidStatement(
 
 [[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()
+# **getBidResults**
+> GetBidResults200Response getBidResults()
 
-등록한 계약의 계산서 발행 상태를 확인합니다.  **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API 로 되읽으세요.  **필수 스코프:** `contracts:read`
+공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
 
 ### Example
 
@@ -711,10 +818,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let externalContractId: string; //등록할 때 보낸 파트너 측 계약 식별자. (default to undefined)
+let bidId: string; // (default to undefined)
 
-const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
-    externalContractId
+const { status, data } = await apiInstance.getBidResults(
+    bidId
 );
 ```
 
@@ -722,12 +829,12 @@ const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **externalContractId** | [**string**] | 등록할 때 보낸 파트너 측 계약 식별자. | defaults to undefined|
+| **bidId** | [**string**] |  | defaults to undefined|
 
 
 ### Return type
 
-**SemoContractTaxinvoiceStatusResponseDto**
+**GetBidResults200Response**
 
 ### Authorization
 
@@ -736,20 +843,27 @@ const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**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)
 
-# **getSupplierCardPayable**
-> SupplierCardPayableResponseDto getSupplierCardPayable()
+# **getBidSettlement**
+> GetBidSettlement200Response getBidSettlement()
 
-계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **필수 스코프:** `payments:write`
+낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.  가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다.  **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
 
 ### Example
 
@@ -762,10 +876,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let memberId: string; //계약업체 회원 ID (default to undefined)
+let bidId: string; // (default to undefined)
 
-const { status, data } = await apiInstance.getSupplierCardPayable(
-    memberId
+const { status, data } = await apiInstance.getBidSettlement(
+    bidId
 );
 ```
 
@@ -773,12 +887,12 @@ const { status, data } = await apiInstance.getSupplierCardPayable(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **memberId** | [**string**] | 계약업체 회원 ID | defaults to undefined|
+| **bidId** | [**string**] |  | defaults to undefined|
 
 
 ### Return type
 
-**SupplierCardPayableResponseDto**
+**GetBidSettlement200Response**
 
 ### Authorization
 
@@ -787,20 +901,27 @@ const { status, data } = await apiInstance.getSupplierCardPayable(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**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**
-> HealthResponseDto healthControllerCheck()
+# **getBidStatement**
+> GetBidStatement200Response getBidStatement()
 
-ERP 연동 직전 회선·인증 endpoint 동작 확인용.
+낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다.  **필수 스코프:** `invoices:read` — 종전에는 `contracts:read` 를 요구했습니다. 금액이 실리는 정산 계열 문서라 계약서류 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
 
 ### Example
 
@@ -813,61 +934,451 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-const { status, data } = await apiInstance.healthControllerCheck();
+let bidId: string; // (default to undefined)
+let paperCode: number; // (optional) (default to undefined)
+
+const { status, data } = await apiInstance.getBidStatement(
+    bidId,
+    paperCode
+);
 ```
 
 ### Parameters
-This endpoint does not have any parameters.
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidId** | [**string**] |  | defaults to undefined|
+| **paperCode** | [**number**] |  | (optional) defaults to undefined|
 
 
 ### Return type
 
-**HealthResponseDto**
+**GetBidStatement200Response**
 
 ### Authorization
 
-No authorization required
+[partner-oauth2](../README.md#partner-oauth2)
 
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**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)
 
-# **issueTaxInvoice**
-> TaxInvoiceIssuedResponseDto issueTaxInvoice(issueTaxInvoiceRequestDto)
+# **getFileMeta**
+> GetFileMeta200Response getFileMeta()
 
-낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **분할 청구:** 세금계산서 **분할 발급**은 `/v2` 에 제공되지 않습니다 — `/v1` 전용(`POST /v1/invoices/split-requests`)입니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다.  **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요.  **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다.  **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다.  **형식이 틀린 키는 404 가 아니라 400 입니다.** 하이픈 없는 16진수 32자가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다.  **필수 스코프:** `files:read`
 
 ### Example
 
 ```typescript
 import {
     PartnerV2Api,
-    Configuration,
-    IssueTaxInvoiceRequestDto
+    Configuration
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let fileKey: string; //파일 키 — 업로드 응답의 fileKey(하이픈 없는 16진수 32자). (default to undefined)
+
+const { status, data } = await apiInstance.getFileMeta(
+    fileKey
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **fileKey** | [**string**] | 파일 키 — 업로드 응답의 fileKey(하이픈 없는 16진수 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)
+
+# **listBidContractDocuments**
+> ListBidContractDocuments200Response listBidContractDocuments()
+
+공고의 계약서류 목록과 내려받기 주소를 조회합니다.  **목록에 실리는 것:** 공고 전체에 공통인 서류(약관·자동생성 공통본)와 낙찰자에게 귀속된 서류를 함께 싣습니다. 낙찰자 귀속 서류는 `winnerSequence` 에 그 낙찰자의 응찰 순번이 들어갑니다.  **아직 없는 서류도 실립니다.** 공고가 제출을 요구했지만 아직 올라오지 않은 서류는 `fileKey: null` 로 나타나므로, 제출 여부는 이 값으로 판정하세요.  **자동생성 서류:** `autoGenerated: true` 인 서류는 c-market 이 만들어 줍니다. 만드는 중이면 `generationState` 가 `QUEUED`/`PROCESSING` 이고 `downloadUrl` 이 아직 없습니다. `DEAD_LETTER` 는 생성이 실패해 멈춘 상태이며, 같은 경로의 POST(재생성)로 다시 큐에 올립니다.  **내려받기:** `downloadUrl` 은 유효기간 1시간의 서명 주소입니다. 저장해 두고 재사용하지 마시고 필요할 때 이 엔드포인트를 다시 호출하세요. 기간에 얽매이지 않으려면 `fileKey` 를 보관하시고 파일 내려받기 경로를 사용하세요.  **보이는 범위:** 서버가 공고 낙찰방법과 진행 단계로 결정합니다. 응답을 그대로 사용하시고 클라이언트에서 다시 거르지 마세요.  **필수 스코프:** `contracts:read`
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration
+} 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)
+
+const { status, data } = await apiInstance.listBidContractDocuments(
+    bidId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidId** | [**string**] | 공고번호(buy_idx, 예 CM…) 또는 외부 구매번호(bid_puchase_no). | defaults to undefined|
+
+
+### Return type
+
+**ListBidContractDocuments200Response**
+
+### 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)
+
+# **listBidParticipants**
+> ListBidParticipants200Response listBidParticipants()
+
+공고에 응찰한 업체 목록을 조회합니다. 스코프 `bids:read` 필수.  **보이는 범위는 공고의 낙찰방법과 진행 단계가 결정합니다.** 개찰 전에는 업체명이 가려지고 (`companyName: null`), 순위는 산정 전까지 `null` 입니다. 이 판정은 서버가 소유하므로 응답을 그대로 사용하시고 클라이언트에서 다시 계산하지 마세요.  같은 목록이 `GET /v2/bids/{bidId}` 응답의 `participants` 에도 실립니다 — 응찰 현황만 필요하면 이 엔드포인트가 가볍습니다.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    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 issueTaxInvoiceRequestDto: IssueTaxInvoiceRequestDto; //
 
-const { status, data } = await apiInstance.issueTaxInvoice(
-    bidId,
-    idempotencyKey,
-    issueTaxInvoiceRequestDto
+const { status, data } = await apiInstance.listBidParticipants(
+    bidId
 );
 ```
 
@@ -875,14 +1386,12 @@ const { status, data } = await apiInstance.issueTaxInvoice(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **issueTaxInvoiceRequestDto** | **IssueTaxInvoiceRequestDto**|  | |
 | **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
 
-**TaxInvoiceIssuedResponseDto**
+**ListBidParticipants200Response**
 
 ### Authorization
 
@@ -890,19 +1399,75 @@ const { status, data } = await apiInstance.issueTaxInvoice(
 
 ### HTTP request headers
 
- - **Content-Type**: application/json
- - **Accept**: application/json
+ - **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;). |  -  |
+|**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;. |  -  |
+|**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)
+
+# **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; //조회할 공고 식별자 목록. 쉼표로 구분하거나 `bidIds` 를 반복해 전달합니다. 최대 100건. (default to undefined)
+
+const { status, data } = await apiInstance.listBidResults(
+    bidIds
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidIds** | [**string**] | 조회할 공고 식별자 목록. 쉼표로 구분하거나 &#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;. |  -  |
@@ -911,7 +1476,7 @@ const { status, data } = await apiInstance.issueTaxInvoice(
 [[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**
-> ListBidsResponseDto listBids()
+> ListBids200Response listBids()
 
 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 100) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
 
@@ -932,12 +1497,192 @@ let bidIds: Array<string>; //조회할 공고 식별자 CSV(최대 100건). 지
 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,
+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;** | 조회할 공고 식별자 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**
+
+### 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)
+
+# **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,
-    include
+    limit,
+    cursor
 );
 ```
 
@@ -945,16 +1690,15 @@ const { status, data } = await apiInstance.listBids(
 
 |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;** | 조회할 공고 식별자 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|
+| **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
 
-**ListBidsResponseDto**
+**ListWebhookDeliveries200Response**
 
 ### Authorization
 
@@ -963,13 +1707,13 @@ const { status, data } = await apiInstance.listBids(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**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;). |  -  |
@@ -980,10 +1724,10 @@ const { status, data } = await apiInstance.listBids(
 
 [[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()
+# **listWebhookEndpoints**
+> ListWebhookEndpoints200Response listWebhookEndpoints()
 
-발주기관 회원과 거래유형으로 **그 거래에 필요한 계약서류 목록**을 조회합니다.  **용도:** 공고(입찰)를 거치지 않는 거래 — 예: 채팅 기반 견적 — 에서 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때.  **판정 기준:** 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다.  **응답 해석:** - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 **미리 체크된 상태로** 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market 이 데이터를 채워 PDF 로 만들어 주는 서류입니다. 생성 API 의 `paperCodes` 에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요.  **조회 가능한 회원 범위:** 이 API 키에 설정된 대행 범위(소속 그룹 전원 또는 지정 회원 목록) 안의 회원만 조회할 수 있습니다. 범위 밖이면 403 입니다. 대행 범위는 키 설정이며 스코프와는 별개 축입니다.  **필수 스코프:** `contracts:read`
+이 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` 가 발송 시도 이력(본문·응답 상태·다음 재시도 시각)을 돌려줍니다. 수신측 장애 구간을 메울 때 이 엔드포인트를 폴링 대체 경로로 쓰세요.
 
 ### Example
 
@@ -996,26 +1740,16 @@ import {
 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
-);
+const { status, data } = await apiInstance.listWebhookEndpoints();
 ```
 
 ### 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|
+This endpoint does not have any parameters.
 
 
 ### Return type
 
-**ExternalContractDocumentsResponseDto**
+**ListWebhookEndpoints200Response**
 
 ### Authorization
 
@@ -1024,13 +1758,13 @@ const { status, data } = await apiInstance.listExternalContractDocuments(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 필요 계약서류 목록. |  -  |
+|**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;). |  -  |
@@ -1042,7 +1776,7 @@ const { status, data } = await apiInstance.listExternalContractDocuments(
 [[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**
-> BidFailedV2ResponseDto markBidFailed(markBidFailedRequestDto)
+> MarkBidFailed201Response markBidFailed(markBidFailedRequestDto)
 
 공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(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` 헤더 필수.
 
@@ -1080,7 +1814,7 @@ const { status, data } = await apiInstance.markBidFailed(
 
 ### Return type
 
-**BidFailedV2ResponseDto**
+**MarkBidFailed201Response**
 
 ### Authorization
 
@@ -1089,7 +1823,7 @@ const { status, data } = await apiInstance.markBidFailed(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -1109,7 +1843,7 @@ 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**
-> BidPublishedResponseDto publishBid()
+> PublishBid200Response publishBid()
 
 초안(DRAFT) 상태로 등록된 공고를 진행중(ONGOING)으로 게시합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 연간/지명계약 등으로 초안 상태로 등록된 공고를 명시적으로 게시할 때. 등록 응답의 `status` 로 게시 필요 여부를 판별합니다.  **전제조건:** 초안(DRAFT) 상태이고 마감(bidEndAt)이 미래여야 합니다.  **거부:** 초안이 아니거나 마감이 지난 공고 → 409. 마감이 지났으면 먼저 마감일을 연장해야 합니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).  **멱등성:** `Idempotency-Key` 헤더 필수.
 
@@ -1143,7 +1877,7 @@ const { status, data } = await apiInstance.publishBid(
 
 ### Return type
 
-**BidPublishedResponseDto**
+**PublishBid200Response**
 
 ### Authorization
 
@@ -1152,7 +1886,7 @@ const { status, data } = await apiInstance.publishBid(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -1171,8 +1905,67 @@ 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)
 
+# **queryBidResults**
+> ListBidResults200Response queryBidResults(bidResultsBatchRequestDto)
+
+`GET /v2/bid-results` 와 **완전히 같은 조회**이며, 식별자 목록을 본문으로 받습니다. 스코프 `bids:read`.  공고 식별자 100건이면 URL 이 1KB를 넘습니다 — 중간 프록시가 긴 URL 을 자르는 환경을 위한 대체 경로입니다.  **부수효과가 없으므로 `Idempotency-Key` 는 필요하지 않습니다.** POST 인 것은 전송 형태의 문제일 뿐이며, 가능하면 캐시·`ETag` 가 동작하는 `GET` 쪽을 쓰세요.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    BidResultsBatchRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let bidResultsBatchRequestDto: BidResultsBatchRequestDto; //
+
+const { status, data } = await apiInstance.queryBidResults(
+    bidResultsBatchRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidResultsBatchRequestDto** | **BidResultsBatchRequestDto**|  | |
+
+
+### Return type
+
+**ListBidResults200Response**
+
+### 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** |  |  -  |
+|**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)
+
 # **regenerateContractDocuments**
-> ContractDocumentsRegeneratedResponseDto regenerateContractDocuments()
+> RegenerateContractDocuments201Response regenerateContractDocuments()
 
 공고의 자동생성 계약서류(발주서·공고결과·표준계약서 등)를 생성/재생성합니다.  **V6 대응:** `RegenerateAllContractPdfsCommand` — 웹 어드민의 \"계약 서류 일괄 재생성\"과 동일 경로.  **호출 시점:** 낙찰(계약 시작) 후 계약서류가 필요하거나, 생성에 실패한 서류를 다시 만들 때.  **부수효과:** - 생성 실패(DEAD_LETTER) 상태의 자동생성 PDF 가 재생성 큐에 등록됩니다(비동기). - 승낙사항(ACCEPTANCE) 계열은 운영자 승인 워크플로가 필요해 이 경로에서 제외됩니다.  **응답:** 즉시 파일이 아니라 큐 등록 결과(`enqueuedCount`/`skippedCount`)를 반환합니다. 잠시 후 자동 생성됩니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
@@ -1206,7 +1999,7 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 
 ### Return type
 
-**ContractDocumentsRegeneratedResponseDto**
+**RegenerateContractDocuments201Response**
 
 ### Authorization
 
@@ -1215,7 +2008,7 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -1235,7 +2028,7 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 [[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)
 
 # **registerAward**
-> AwardRegisteredV2ResponseDto registerAward(registerAwardRequestDto)
+> 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시간 내 캐시 응답 반환.
 
@@ -1273,7 +2066,7 @@ const { status, data } = await apiInstance.registerAward(
 
 ### Return type
 
-**AwardRegisteredV2ResponseDto**
+**RegisterAward201Response**
 
 ### Authorization
 
@@ -1282,7 +2075,7 @@ const { status, data } = await apiInstance.registerAward(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -1302,7 +2095,7 @@ const { status, data } = await apiInstance.registerAward(
 [[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)
 
 # **registerBid**
-> BidRegisteredResponseDto registerBid(createBidRequestDto)
+> RegisterBid201Response registerBid(createBidRequestDto)
 
 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
 
@@ -1318,9 +2111,11 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. (default to undefined)
 let createBidRequestDto: CreateBidRequestDto; //
 
 const { status, data } = await apiInstance.registerBid(
+    idempotencyKey,
     createBidRequestDto
 );
 ```
@@ -1330,11 +2125,12 @@ const { status, data } = await apiInstance.registerBid(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **createBidRequestDto** | **CreateBidRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. | defaults to undefined|
 
 
 ### Return type
 
-**BidRegisteredResponseDto**
+**RegisterBid201Response**
 
 ### Authorization
 
@@ -1343,7 +2139,7 @@ const { status, data } = await apiInstance.registerBid(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -1407,7 +2203,7 @@ const { status, data } = await apiInstance.registerSemoContract(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -1426,10 +2222,10 @@ const { status, data } = await apiInstance.registerSemoContract(
 
 [[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)
 
-# **submitNegotiationScores**
-> NegotiationScoredV2ResponseDto submitNegotiationScores(submitNegotiationScoresRequestDto)
+# **revertAward**
+> RevertAward200Response revertAward(revertAwardRequestDto)
 
-협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다.  **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidId}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다.  **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다.  **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다)  **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
 
 ### Example
 
@@ -1437,20 +2233,20 @@ const { status, data } = await apiInstance.registerSemoContract(
 import {
     PartnerV2Api,
     Configuration,
-    SubmitNegotiationScoresRequestDto
+    RevertAwardRequestDto
 } 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 submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto; //
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). (default to undefined)
+let revertAwardRequestDto: RevertAwardRequestDto; //
 
-const { status, data } = await apiInstance.submitNegotiationScores(
+const { status, data } = await apiInstance.revertAward(
     bidId,
     idempotencyKey,
-    submitNegotiationScoresRequestDto
+    revertAwardRequestDto
 );
 ```
 
@@ -1458,14 +2254,14 @@ const { status, data } = await apiInstance.submitNegotiationScores(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **submitNegotiationScoresRequestDto** | **SubmitNegotiationScoresRequestDto**|  | |
+| **revertAwardRequestDto** | **RevertAwardRequestDto**|  | |
 | **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). | defaults to undefined|
 
 
 ### Return type
 
-**NegotiationScoredV2ResponseDto**
+**RevertAward200Response**
 
 ### Authorization
 
@@ -1474,13 +2270,139 @@ const { status, data } = await apiInstance.submitNegotiationScores(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: 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;). |  -  |
+|**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)
+
+# **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 |
 |-------------|-------------|------------------|
-|**201** | 협상 점수평가 완료. |  -  |
+|**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;). |  -  |
@@ -1494,7 +2416,7 @@ const { status, data } = await apiInstance.submitNegotiationScores(
 [[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**
-> BidUpdatedResponseDto updateBid(updateBidRequestDto)
+> UpdateBid200Response updateBid(updateBidRequestDto)
 
 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
 
@@ -1511,11 +2433,15 @@ const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
 let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
+let ifMatch: string; // (default to undefined)
+let ifMatch2: string; //수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidId}` 응답의 `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,
+    ifMatch,
+    ifMatch2,
     idempotencyKey,
     updateBidRequestDto
 );
@@ -1527,12 +2453,14 @@ const { status, data } = await apiInstance.updateBid(
 |------------- | ------------- | ------------- | -------------|
 | **updateBidRequestDto** | **UpdateBidRequestDto**|  | |
 | **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | 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|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. | defaults to undefined|
 
 
 ### Return type
 
-**BidUpdatedResponseDto**
+**UpdateBid200Response**
 
 ### Authorization
 
@@ -1541,7 +2469,7 @@ const { status, data } = await apiInstance.updateBid(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
@@ -1552,7 +2480,84 @@ const { status, data } = await apiInstance.updateBid(
 |**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;). 그 사이 다른 요청이 공고를 바꿨습니다 — 다시 조회해 최신 ETag 로 재시도하세요. |  -  |
+|**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)
+
+# **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;. |  -  |
@@ -1561,7 +2566,7 @@ 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)
 
 # **uploadFile**
-> FileUploadedResponseDto uploadFile(uploadFileRequestDto)
+> UploadFile201Response uploadFile(uploadFileRequestDto)
 
 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
 
@@ -1593,7 +2598,7 @@ const { status, data } = await apiInstance.uploadFile(
 
 ### Return type
 
-**FileUploadedResponseDto**
+**UploadFile201Response**
 
 ### Authorization
 
@@ -1602,7 +2607,7 @@ const { status, data } = await apiInstance.uploadFile(
 ### HTTP request headers
 
  - **Content-Type**: application/json
- - **Accept**: application/json
+ - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details