@cmarket/partner-sdk 9.10.0 → 11.0.0

package/docs/PartnerV2Api.md

@@ -5,18 +5,22 @@ All URIs are relative to *https://partner-api.c-market.net*
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
 |[**completeAcceptance**](#completeacceptance) | **POST** /v2/bids/{bidId}/acceptance | 검수완료 전송|
-|[**completeInvoice**](#completeinvoice) | **POST** /v2/bids/{bidId}/invoice/complete | 정산 마감(송장 강제완료)|
+|[**completeInvoice**](#completeinvoice) | **POST** /v2/bids/{bidId}/settlement/complete | 정산 마감(송장 강제완료)|
 |[**createEmbedLaunch**](#createembedlaunch) | **POST** /v2/embed/launch | 임베드 launch code 발급 (iframe SSO)|
+|[**getBid**](#getbid) | **GET** /v2/bids/{bidId} | 공고 단건(라이프사이클) 조회|
 |[**getBidResults**](#getbidresults) | **GET** /v2/bids/{bidId}/results | 입찰 결과 조회|
 |[**getBidSettlement**](#getbidsettlement) | **GET** /v2/bids/{bidId}/settlement | 입찰결과 정산정보 조회|
 |[**getBidStatement**](#getbidstatement) | **GET** /v2/bids/{bidId}/statement | 거래명세서 조회|
 |[**healthControllerCheck**](#healthcontrollercheck) | **GET** /health | Partner API 헬스체크|
 |[**issueTaxInvoice**](#issuetaxinvoice) | **POST** /v2/bids/{bidId}/tax-invoice | 세금계산서 발행|
-|[**markBidFailed**](#markbidfailed) | **POST** /v2/awards/fail | 유찰 처리|
+|[**listBids**](#listbids) | **GET** /v2/bids | 공고 목록 조회|
+|[**markBidFailed**](#markbidfailed) | **POST** /v2/bids/{bidId}/award/fail | 유찰 처리|
+|[**publishBid**](#publishbid) | **POST** /v2/bids/{bidId}/publish | 공고 게시(초안 → 진행중)|
 |[**regenerateContractDocuments**](#regeneratecontractdocuments) | **POST** /v2/bids/{bidId}/contract-documents | 계약서류 생성(재생성)|
-|[**registerAward**](#registeraward) | **POST** /v2/awards | 낙찰 결과 전송|
+|[**registerAward**](#registeraward) | **POST** /v2/bids/{bidId}/award | 낙찰 결과 전송|
 |[**registerBid**](#registerbid) | **POST** /v2/bids | 입찰 정보 전송(등록)|
 |[**simulateSandboxBid**](#simulatesandboxbid) | **POST** /v2/sandbox/bids/{bidId}/simulate | 샌드박스 응찰/마감 시뮬 (영업 데모 전용)|
+|[**submitNegotiationScores**](#submitnegotiationscores) | **POST** /v2/bids/{bidId}/negotiation-scores | 협상 점수평가|
 |[**updateBid**](#updatebid) | **PATCH** /v2/bids/{bidId} | 입찰 공고 수정|
 |[**uploadFile**](#uploadfile) | **POST** /v2/files | 입찰 첨부파일 업로드(base64 또는 url) → fileKey|
 
@@ -75,21 +79,21 @@ const { status, data } = await apiInstance.completeAcceptance(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 검수완료 처리 결과. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **completeInvoice**
 > InvoiceCompletedResponseDto completeInvoice()
 
-공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`buy_payment_force_yn`, `buy_payment_yn`)와 계산서 발급 플래그(`taxbill`)가 `Y`로 기록됩니다. - 계산서 발급일자(`taxbill_date`)가 현재 시각으로 기록됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -137,14 +141,14 @@ const { status, data } = await apiInstance.completeInvoice(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 정산 마감 완료. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
@@ -199,18 +203,76 @@ const { status, data } = await apiInstance.createEmbedLaunch(
 |**201** |  |  -  |
 |**400** | 쿼리/본문 입력 검증 실패(`type: …/validation-failed`). |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
-|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), 또는 buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
+
+# **getBid**
+> BidDetailResponseDto getBid()
+
+공고의 현재 상태와 라이프사이클 하위 상태(계약서류 생성·정산·세금계산서)를 조회합니다. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감·세금계산서 발행 등)의 성사를 관측합니다.  **낙찰 여부:** 이 응답의 `status` 가 아니라 낙찰 결과 조회(`GET /v2/bids/{bidId}/results`)의 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+
+### 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)
+
+const { status, data } = await apiInstance.getBid(
+    bidId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+
+
+### Return type
+
+**BidDetailResponseDto**
+
+### 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** |  |  -  |
+|**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-not-found`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **getBidResults**
 > BidResultsResponseDto getBidResults()
 
-V5 /entendrec 후속. scope bids:read.
+공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
 
 ### Example
 
@@ -224,11 +286,9 @@ const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
 let bidId: string; // (default to undefined)
-let buyerId: string; //공고 명의 회원 ID (멀티테넌트 가시성 키). (default to undefined)
 
 const { status, data } = await apiInstance.getBidResults(
-    bidId,
-    buyerId
+    bidId
 );
 ```
 
@@ -237,7 +297,6 @@ const { status, data } = await apiInstance.getBidResults(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **bidId** | [**string**] |  | defaults to undefined|
-| **buyerId** | [**string**] | 공고 명의 회원 ID (멀티테넌트 가시성 키). | defaults to undefined|
 
 
 ### Return type
@@ -259,19 +318,19 @@ const { status, data } = await apiInstance.getBidResults(
 |-------------|-------------|------------------|
 |**200** |  |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
-|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), 또는 buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-rejected`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-not-found`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **getBidSettlement**
 > BidSettlementResponseDto getBidSettlement()
 
-V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
 
 ### Example
 
@@ -317,19 +376,19 @@ const { status, data } = await apiInstance.getBidSettlement(
 |-------------|-------------|------------------|
 |**200** |  |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
-|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), 또는 buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-rejected`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-not-found`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **getBidStatement**
 > BidStatementResponseDto getBidStatement()
 
-V5 /getGrm 후속. scope contracts:read.
+낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
 
 ### Example
 
@@ -378,12 +437,12 @@ const { status, data } = await apiInstance.getBidStatement(
 |-------------|-------------|------------------|
 |**200** |  |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
-|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), 또는 buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`). |  -  |
-|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-rejected`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-not-found`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
@@ -428,15 +487,15 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** |  |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
+|**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`. |  -  |
 
 [[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)
 
-낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(Popbill).  **V5 대응:** `B2B_BUY_POP_BILL_S1` 발행 경로의 V6 후속.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 `b2b_buy.taxbill=\'Y\'` 로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **분할 청구:** 세금계산서 **분할 발급**은 `/v2` 에 제공되지 않습니다 — `/v1` 전용(`POST /v1/invoices/split-requests`)입니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
 
 ### Example
 
@@ -450,7 +509,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고번호(등록 응답의 bidNo). (default to undefined)
+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; //
 
@@ -466,7 +525,7 @@ const { status, data } = await apiInstance.issueTaxInvoice(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **issueTaxInvoiceRequestDto** | **IssueTaxInvoiceRequestDto**|  | |
-| **bidId** | [**string**] | 공고번호(등록 응답의 bidNo). | defaults to undefined|
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
@@ -488,21 +547,82 @@ const { status, data } = await apiInstance.issueTaxInvoice(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 세금계산서 발행 완료. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
+
+# **listBids**
+> ListBidsResponseDto listBids()
+
+발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다).  **페이지네이션(cursor):** `limit`(1~100, 기본 20) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다.  **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let limit: number; //페이지 크기(1~100, 기본 20). (optional) (default to 20)
+let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다. (optional) (default to undefined)
+
+const { status, data } = await apiInstance.listBids(
+    limit,
+    cursor
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **limit** | [**number**] | 페이지 크기(1~100, 기본 20). | (optional) defaults to 20|
+| **cursor** | [**string**] | 다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다. | (optional) defaults to undefined|
+
+
+### Return type
+
+**ListBidsResponseDto**
+
+### 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** |  |  -  |
+|**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**404** | 대상 리소스 없음 — backend 거부 패스스루(`type: …/upstream-not-found`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **markBidFailed**
-> BidFailedResponseDto markBidFailed(markBidFailedRequestDto)
+> BidFailedV2ResponseDto markBidFailed(markBidFailedRequestDto)
 
-공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다.  **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 |  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -516,10 +636,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
+let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
 let markBidFailedRequestDto: MarkBidFailedRequestDto; //
 
 const { status, data } = await apiInstance.markBidFailed(
+    bidId,
     idempotencyKey,
     markBidFailedRequestDto
 );
@@ -530,12 +652,13 @@ const { status, data } = await apiInstance.markBidFailed(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
 
-**BidFailedResponseDto**
+**BidFailedV2ResponseDto**
 
 ### Authorization
 
@@ -551,14 +674,76 @@ const { status, data } = await apiInstance.markBidFailed(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 유찰 처리 완료. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
+
+# **publishBid**
+> BidPublishedResponseDto publishBid()
+
+초안(DRAFT) 상태로 등록된 공고를 진행중(ONGOING)으로 게시합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 연간/지명계약 등으로 초안 상태로 등록된 공고를 명시적으로 게시할 때. 등록 응답의 `status` 로 게시 필요 여부를 판별합니다.  **전제조건:** 초안(DRAFT) 상태이고 마감(bidEndAt)이 미래여야 합니다.  **거부:** 초안이 아니거나 마감이 지난 공고 → 409. 마감이 지났으면 먼저 마감일을 연장해야 합니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).  **멱등성:** `Idempotency-Key` 헤더 필수.
+
+### 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_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). (default to undefined)
+
+const { status, data } = await apiInstance.publishBid(
+    bidId,
+    idempotencyKey
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 재전송 시 캐시 응답 반환(24시간). | defaults to undefined|
+
+
+### Return type
+
+**BidPublishedResponseDto**
+
+### 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** | 공고 게시 완료. |  -  |
+|**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`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
@@ -613,21 +798,21 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 계약서류 재생성 큐 등록 완료. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **registerAward**
-> AwardRegisteredResponseDto registerAward(registerAwardRequestDto)
+> AwardRegisteredV2ResponseDto registerAward(registerAwardRequestDto)
 
-낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidId}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
 
 ### Example
 
@@ -641,10 +826,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
+let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
 let registerAwardRequestDto: RegisterAwardRequestDto; //
 
 const { status, data } = await apiInstance.registerAward(
+    bidId,
     idempotencyKey,
     registerAwardRequestDto
 );
@@ -655,12 +842,13 @@ const { status, data } = await apiInstance.registerAward(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **registerAwardRequestDto** | **RegisterAwardRequestDto**|  | |
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
 
-**AwardRegisteredResponseDto**
+**AwardRegisteredV2ResponseDto**
 
 ### Authorization
 
@@ -676,19 +864,19 @@ const { status, data } = await apiInstance.registerAward(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 낙찰 등록 완료. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **registerBid**
-> BidCreatedResponseDto registerBid(createBidRequestDto)
+> BidRegisteredResponseDto registerBid(createBidRequestDto)
 
 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
 
@@ -720,7 +908,7 @@ const { status, data } = await apiInstance.registerBid(
 
 ### Return type
 
-**BidCreatedResponseDto**
+**BidRegisteredResponseDto**
 
 ### Authorization
 
@@ -736,14 +924,14 @@ const { status, data } = await apiInstance.registerBid(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** |  |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
@@ -801,18 +989,84 @@ const { status, data } = await apiInstance.simulateSandboxBid(
 |**200** | 시뮬 결과(현재 응찰 수·마감 여부). |  -  |
 |**400** | 쿼리/본문 입력 검증 실패(`type: …/validation-failed`). |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
-|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), 또는 buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
+
+# **submitNegotiationScores**
+> NegotiationScoredV2ResponseDto submitNegotiationScores(submitNegotiationScoresRequestDto)
+
+협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다.  **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidId}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다.  **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    SubmitNegotiationScoresRequestDto
+} 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; //
+
+const { status, data } = await apiInstance.submitNegotiationScores(
+    bidId,
+    idempotencyKey,
+    submitNegotiationScoresRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **submitNegotiationScoresRequestDto** | **SubmitNegotiationScoresRequestDto**|  | |
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+
+
+### Return type
+
+**NegotiationScoredV2ResponseDto**
+
+### Authorization
+
+[partner-oauth2](../README.md#partner-oauth2)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**201** | 협상 점수평가 완료. |  -  |
+|**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 backend 입력 거부(`…/upstream-invalid-input`). |  -  |
+|**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
 # **updateBid**
 > BidUpdatedResponseDto updateBid(updateBidRequestDto)
 
-등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
 
 ### Example
 
@@ -826,7 +1080,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고번호(등록 응답의 bidNo) 또는 발주처 조달번호. (default to undefined)
+let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. (default to undefined)
 let updateBidRequestDto: UpdateBidRequestDto; //
 
@@ -842,7 +1096,7 @@ const { status, data } = await apiInstance.updateBid(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **updateBidRequestDto** | **UpdateBidRequestDto**|  | |
-| **bidId** | [**string**] | 공고번호(등록 응답의 bidNo) 또는 발주처 조달번호. | defaults to undefined|
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. | defaults to undefined|
 
 
@@ -864,14 +1118,14 @@ const { status, data } = await apiInstance.updateBid(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 공고 수정 완료. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)
 
@@ -924,15 +1178,15 @@ const { status, data } = await apiInstance.uploadFile(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** |  |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`). |  -  |
+|**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`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키 보유자와 불일치(`…/buyer-scope-mismatch`), 또는 backend 권한 거부(`…/upstream-forbidden`). |  -  |
+|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`) 또는 backend 도메인 상태 충돌(`…/upstream-conflict`). |  -  |
 |**413** | 요청 본문 크기 초과(`type: …/payload-too-large`). |  -  |
-|**429** | rate limit 초과(`type: …/too-many-requests`). `Retry-After` 헤더 참조. |  -  |
-|**500** | 서버 내부 오류(`type: …/internal-server-error`). |  -  |
-|**502** | backend 도메인 거부 또는 backend 5xx(`type: …/upstream-rejected`). |  -  |
-|**503** | backend 도달 불가 또는 /v1 platform-auth 실패(`type: …/service-unavailable`). `Retry-After` 헤더 참조. |  -  |
+|**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 도달 불가 또는 /v1 platform-auth 실패(`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)