@cmarket/partner-sdk 10.0.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,14 +79,14 @@ 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)
 
@@ -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,11 +203,69 @@ 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)
 
@@ -256,12 +318,12 @@ 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)
 
@@ -314,12 +376,12 @@ 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)
 
@@ -375,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)
 
@@ -425,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)
 
-낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 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
 
@@ -485,14 +547,75 @@ 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)
 
@@ -513,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
 );
@@ -527,6 +652,7 @@ 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|
 
 
@@ -548,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)
 
@@ -610,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**
 > AwardRegisteredV2ResponseDto registerAward(registerAwardRequestDto)
 
-낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(H/K) 공고는 이 엔드포인트 전에 `/v1/awards/nego-eval` 로 평가 완료가 필요합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `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
 
@@ -638,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
 );
@@ -652,6 +842,7 @@ 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|
 
 
@@ -673,14 +864,14 @@ 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)
 
@@ -733,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)
 
@@ -798,11 +989,77 @@ 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)
 
@@ -861,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)
 
@@ -921,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)