@cmarket/partner-sdk 0.11.0 → 1.0.0

package/docs/PartnerV1Api.md

@@ -4,26 +4,20 @@ All URIs are relative to *http://localhost*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
-|[**completeAcceptance**](#completeacceptance) | **POST** /v1/bids/{bidId}/acceptance | 검수완료 전송|
-|[**getBidContractDocuments**](#getbidcontractdocuments) | **GET** /v1/bids/{bidId}/contract-documents | 계약서류 수신 조회|
-|[**getBidContractDocumentsBatch**](#getbidcontractdocumentsbatch) | **POST** /v1/bids/contract-documents/batch | 계약서류 수신 배치 조회|
-|[**getBidResults**](#getbidresults) | **GET** /v1/bids/{bidId}/results | 입찰 결과 조회|
-|[**getBidResultsBatch**](#getbidresultsbatch) | **POST** /v1/bids/results/batch | 입찰결과 배치 조회|
-|[**getBidSettlement**](#getbidsettlement) | **GET** /v1/bids/{bidId}/settlement | 입찰결과 정산정보 조회|
-|[**getBidStatement**](#getbidstatement) | **GET** /v1/bids/{bidId}/statement | 거래명세서 조회|
-|[**healthControllerCheck**](#healthcontrollercheck) | **GET** /v1/health | Partner API 헬스체크|
-|[**markBidFailed**](#markbidfailed) | **POST** /v1/awards/fail | 유찰 처리|
-|[**recordParityResult**](#recordparityresult) | **POST** /v1/parity-results | V5→V6 마이그레이션 패리티 결과 기록|
-|[**registerAward**](#registeraward) | **POST** /v1/awards | 낙찰 결과 전송|
-|[**registerBid**](#registerbid) | **POST** /v1/bids | 입찰 정보 전송(등록)|
-|[**requestSplitInvoice**](#requestsplitinvoice) | **POST** /v1/invoices/split-requests | 계산서 분할 발급 청구|
-|[**submitNegotiationScores**](#submitnegotiationscores) | **POST** /v1/awards/nego-eval | 협상(H/K) 점수평가|
-|[**uploadFile**](#uploadfile) | **POST** /v1/files | 입찰 첨부파일 업로드(base64 또는 url) → fileKey|
-
-# **completeAcceptance**
-> AcceptanceResultResponseDto completeAcceptance(completeAcceptanceRequestDto)
-
-낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+|[**v1CompleteAcceptance**](#v1completeacceptance) | **POST** /v1/bids/{bidId}/acceptance | 검수완료 전송 — V5 충실|
+|[**v1GetBidContractDocumentsBatch**](#v1getbidcontractdocumentsbatch) | **POST** /v1/bids/contract-documents/batch | 계약서류 수신 배치 조회 — V5 충실|
+|[**v1GetBidResultsBatch**](#v1getbidresultsbatch) | **POST** /v1/bids/results/batch | 입찰결과 배치 조회 — V5 충실|
+|[**v1GetBidStatement**](#v1getbidstatement) | **GET** /v1/bids/{bidId}/statement | 거래명세서 조회 — V5 충실|
+|[**v1MarkBidFailed**](#v1markbidfailed) | **POST** /v1/awards/fail | 유찰 처리 — V5 충실|
+|[**v1RegisterAward**](#v1registeraward) | **POST** /v1/awards | 낙찰 결과 전송 — V5 충실|
+|[**v1RegisterBid**](#v1registerbid) | **POST** /v1/bids | 입찰 정보 전송(등록) — V5 충실|
+|[**v1RequestSplitInvoice**](#v1requestsplitinvoice) | **POST** /v1/invoices/split-requests | 계산서 분할 발급 청구 — V5 충실|
+|[**v1SubmitNegotiationScores**](#v1submitnegotiationscores) | **POST** /v1/awards/nego-eval | 협상(H/K) 점수평가 — V5 충실|
+
+# **v1CompleteAcceptance**
+> AcceptanceResultResponseDto v1CompleteAcceptance(completeAcceptanceRequestDto)
+
+V5 `/acceptanceCompleteSend` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
 ### Example
 
@@ -37,13 +31,11 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-let bidId: string; //공고 ID(= backend bidId = 등록 응답의 bidNo). (default to undefined)
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let bidId: string; // (default to undefined)
 let completeAcceptanceRequestDto: CompleteAcceptanceRequestDto; //
 
-const { status, data } = await apiInstance.completeAcceptance(
+const { status, data } = await apiInstance.v1CompleteAcceptance(
     bidId,
-    idempotencyKey,
     completeAcceptanceRequestDto
 );
 ```
@@ -53,8 +45,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **completeAcceptanceRequestDto** | **CompleteAcceptanceRequestDto**|  | |
-| **bidId** | [**string**] | 공고 ID(= backend bidId = 등록 응답의 bidNo). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+| **bidId** | [**string**] |  | defaults to undefined|
 
 
 ### Return type
@@ -63,7 +54,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -71,65 +62,6 @@ const { status, data } = await apiInstance.completeAcceptance(
  - **Accept**: application/json
 
 
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 검수완료 처리 결과. |  -  |
-|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락(`type: …/idempotency-key-required`). |  -  |
-|**401** | Bearer 토큰 없음 또는 만료(`type: …/unauthorized`). |  -  |
-|**403** | 스코프 부족(`type: …/insufficient-scope`) 또는 buyerId 가 키 보유자와 불일치(`type: …/buyer-scope-mismatch`). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). |  -  |
-|**502** | backend 도메인 거부 — 공고 상태 불일치, 낙찰자 미존재 등(`type: …/upstream-rejected`). |  -  |
-
-[[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)
-
-# **getBidContractDocuments**
-> BidContractDocumentsResponseDto getBidContractDocuments()
-
-V5 /contractDocumentRec 후속. scope contracts:read.
-
-### Example
-
-```typescript
-import {
-    PartnerV1Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV1Api(configuration);
-
-let bidId: string; // (default to undefined)
-let buyerId: string; //공고 명의 회원 ID(b2b_member.member_id). (default to undefined)
-
-const { status, data } = await apiInstance.getBidContractDocuments(
-    bidId,
-    buyerId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
-| **buyerId** | [**string**] | 공고 명의 회원 ID(b2b_member.member_id). | defaults to undefined|
-
-
-### Return type
-
-**BidContractDocumentsResponseDto**
-
-### 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 |
 |-------------|-------------|------------------|
@@ -137,10 +69,10 @@ const { status, data } = await apiInstance.getBidContractDocuments(
 
 [[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)
 
-# **getBidContractDocumentsBatch**
-> Array<BidContractDocumentsResponseDto> getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto)
+# **v1GetBidContractDocumentsBatch**
+> Array<BidContractDocumentsResponseDto> v1GetBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto)
 
-V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 한 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
+V5 `/contractDocumentRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
 ### Example
 
@@ -156,7 +88,7 @@ const apiInstance = new PartnerV1Api(configuration);
 
 let bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto; //
 
-const { status, data } = await apiInstance.getBidContractDocumentsBatch(
+const { status, data } = await apiInstance.v1GetBidContractDocumentsBatch(
     bidContractDocumentsBatchRequestDto
 );
 ```
@@ -174,7 +106,7 @@ const { status, data } = await apiInstance.getBidContractDocumentsBatch(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -189,64 +121,10 @@ const { status, data } = await apiInstance.getBidContractDocumentsBatch(
 
 [[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()
+# **v1GetBidResultsBatch**
+> Array<BidResultsResponseDto> v1GetBidResultsBatch(bidResultsBatchRequestDto)
 
-V5 /entendrec 후속. scope bids:read.
-
-### Example
-
-```typescript
-import {
-    PartnerV1Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV1Api(configuration);
-
-let bidId: string; // (default to undefined)
-let buyerId: string; //공고 명의 회원 ID (멀티테넌트 가시성 키). (default to undefined)
-
-const { status, data } = await apiInstance.getBidResults(
-    bidId,
-    buyerId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
-| **buyerId** | [**string**] | 공고 명의 회원 ID (멀티테넌트 가시성 키). | defaults to undefined|
-
-
-### Return type
-
-**BidResultsResponseDto**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getBidResultsBatch**
-> Array<BidResultsResponseDto> getBidResultsBatch(bidResultsBatchRequestDto)
-
-V5 entendRec(bid_puchase_no_list) 후속 — 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos 는 각 PO 의 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
+V5 `/entendRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정. resolveBidId 도 이 엔드포인트를 사용한다.
 
 ### Example
 
@@ -262,7 +140,7 @@ const apiInstance = new PartnerV1Api(configuration);
 
 let bidResultsBatchRequestDto: BidResultsBatchRequestDto; //
 
-const { status, data } = await apiInstance.getBidResultsBatch(
+const { status, data } = await apiInstance.v1GetBidResultsBatch(
     bidResultsBatchRequestDto
 );
 ```
@@ -280,7 +158,7 @@ const { status, data } = await apiInstance.getBidResultsBatch(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -295,61 +173,10 @@ const { status, data } = await apiInstance.getBidResultsBatch(
 
 [[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.
-
-### Example
-
-```typescript
-import {
-    PartnerV1Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV1Api(configuration);
-
-let bidId: string; // (default to undefined)
-
-const { status, data } = await apiInstance.getBidSettlement(
-    bidId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidId** | [**string**] |  | defaults to undefined|
-
-
-### Return type
-
-**BidSettlementResponseDto**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getBidStatement**
-> BidStatementResponseDto getBidStatement()
+# **v1GetBidStatement**
+> BidStatementResponseDto v1GetBidStatement()
 
-V5 /getGrm 후속. scope contracts:read.
+V5 `/getGrm` 후속. 인증 = body `ID`/`Secret`(cate_set). group_code 스코프로 가시성 적용.
 
 ### Example
 
@@ -365,7 +192,7 @@ const apiInstance = new PartnerV1Api(configuration);
 let bidId: string; // (default to undefined)
 let paperCode: number; // (default to undefined)
 
-const { status, data } = await apiInstance.getBidStatement(
+const { status, data } = await apiInstance.v1GetBidStatement(
     bidId,
     paperCode
 );
@@ -385,7 +212,7 @@ const { status, data } = await apiInstance.getBidStatement(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -400,54 +227,10 @@ const { status, data } = await apiInstance.getBidStatement(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **healthControllerCheck**
-> HealthResponseDto healthControllerCheck()
+# **v1MarkBidFailed**
+> BidFailedResponseDto v1MarkBidFailed(markBidFailedRequestDto)
 
-ERP 연동 직전 회선·인증 endpoint 동작 확인용.
-
-### Example
-
-```typescript
-import {
-    PartnerV1Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV1Api(configuration);
-
-const { status, data } = await apiInstance.healthControllerCheck();
-```
-
-### Parameters
-This endpoint does not have any parameters.
-
-
-### Return type
-
-**HealthResponseDto**
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** |  |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **markBidFailed**
-> BidFailedResponseDto 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` 헤더 필수.
+V5 `scsbidSend`(type=U) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
 ### Example
 
@@ -461,11 +244,9 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-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(
-    idempotencyKey,
+const { status, data } = await apiInstance.v1MarkBidFailed(
     markBidFailedRequestDto
 );
 ```
@@ -475,7 +256,6 @@ const { status, data } = await apiInstance.markBidFailed(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
@@ -484,7 +264,7 @@ const { status, data } = await apiInstance.markBidFailed(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -495,70 +275,14 @@ const { status, data } = await apiInstance.markBidFailed(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 유찰 처리 완료. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) 또는 Idempotency-Key 헤더 누락(&#x60;type: …/idempotency-key-required&#x60;). 코드 4 인데 failureReasonDetail 없으면 400. |  -  |
-|**401** | Bearer 토큰 없음 또는 만료(&#x60;type: …/unauthorized&#x60;). |  -  |
-|**403** | 스코프 부족(&#x60;type: …/insufficient-scope&#x60;) 또는 buyerId 가 키 보유자와 불일치(&#x60;type: …/buyer-scope-mismatch&#x60;). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(&#x60;type: …/idempotency-key-conflict&#x60;). |  -  |
-|**502** | backend 도메인 거부 — 공고 상태 불일치 등(&#x60;type: …/upstream-rejected&#x60;). |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **recordParityResult**
-> recordParityResult(body)
-
-V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
-
-### Example
-
-```typescript
-import {
-    PartnerV1Api,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV1Api(configuration);
-
-let body: object; //
-
-const { status, data } = await apiInstance.recordParityResult(
-    body
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **body** | **object**|  | |
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**204** | 적재 완료(본문 없음). |  -  |
+|**201** |  |  -  |
 
 [[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)
+# **v1RegisterAward**
+> AwardRegisteredResponseDto v1RegisterAward(registerAwardRequestDto)
 
-낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+V5 `scsbidSend`(type=W) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
 ### Example
 
@@ -572,11 +296,9 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-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(
-    idempotencyKey,
+const { status, data } = await apiInstance.v1RegisterAward(
     registerAwardRequestDto
 );
 ```
@@ -586,7 +308,6 @@ const { status, data } = await apiInstance.registerAward(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **registerAwardRequestDto** | **RegisterAwardRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
@@ -595,7 +316,7 @@ const { status, data } = await apiInstance.registerAward(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -606,19 +327,14 @@ const { status, data } = await apiInstance.registerAward(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 낙찰 등록 완료. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) 또는 Idempotency-Key 헤더 누락(&#x60;type: …/idempotency-key-required&#x60;). |  -  |
-|**401** | Bearer 토큰 없음 또는 만료(&#x60;type: …/unauthorized&#x60;). |  -  |
-|**403** | 스코프 부족(&#x60;type: …/insufficient-scope&#x60;) 또는 buyerId 가 키 보유자와 불일치(&#x60;type: …/buyer-scope-mismatch&#x60;). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(&#x60;type: …/idempotency-key-conflict&#x60;). |  -  |
-|**502** | backend 도메인 거부 — 공고 상태 불일치, 낙찰자 미존재 등(&#x60;type: …/upstream-rejected&#x60;). |  -  |
+|**201** |  |  -  |
 
 [[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)
+# **v1RegisterBid**
+> BidCreatedResponseDto v1RegisterBid(createBidRequestDto)
 
-입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+V5 `scsbidSend`(type=B) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
 ### Example
 
@@ -634,7 +350,7 @@ const apiInstance = new PartnerV1Api(configuration);
 
 let createBidRequestDto: CreateBidRequestDto; //
 
-const { status, data } = await apiInstance.registerBid(
+const { status, data } = await apiInstance.v1RegisterBid(
     createBidRequestDto
 );
 ```
@@ -652,7 +368,7 @@ const { status, data } = await apiInstance.registerBid(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -667,10 +383,10 @@ const { status, data } = await apiInstance.registerBid(
 
 [[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)
 
-# **requestSplitInvoice**
-> SplitInvoiceResponseDto requestSplitInvoice(requestSplitInvoiceRequestDto)
+# **v1RequestSplitInvoice**
+> SplitInvoiceResponseDto v1RequestSplitInvoice(requestSplitInvoiceRequestDto)
 
-세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+V5 `splitInvoiceRequest` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
 ### Example
 
@@ -684,11 +400,9 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
 let requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto; //
 
-const { status, data } = await apiInstance.requestSplitInvoice(
-    idempotencyKey,
+const { status, data } = await apiInstance.v1RequestSplitInvoice(
     requestSplitInvoiceRequestDto
 );
 ```
@@ -698,7 +412,6 @@ const { status, data } = await apiInstance.requestSplitInvoice(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **requestSplitInvoiceRequestDto** | **RequestSplitInvoiceRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
@@ -707,7 +420,7 @@ const { status, data } = await apiInstance.requestSplitInvoice(
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers
 
@@ -718,19 +431,14 @@ const { status, data } = await apiInstance.requestSplitInvoice(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 분할 발급 청구 접수 완료. |  -  |
-|**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) 또는 Idempotency-Key 헤더 누락(&#x60;type: …/idempotency-key-required&#x60;). issueDate 가 미래 일자인 경우도 400. |  -  |
-|**401** | Bearer 토큰 없음 또는 만료(&#x60;type: …/unauthorized&#x60;). |  -  |
-|**403** | 스코프 부족(&#x60;type: …/insufficient-scope&#x60;) 또는 buyerId 가 키 보유자와 불일치(&#x60;type: …/buyer-scope-mismatch&#x60;). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(&#x60;type: …/idempotency-key-conflict&#x60;). |  -  |
-|**502** | backend 도메인 거부 — 공고 상태 불일치, 이미 청구 완료 등(&#x60;type: …/upstream-rejected&#x60;). |  -  |
+|**200** |  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **submitNegotiationScores**
-> NegotiationScoredResponseDto submitNegotiationScores(submitNegotiationScoresRequestDto)
+# **v1SubmitNegotiationScores**
+> NegotiationScoredResponseDto v1SubmitNegotiationScores(submitNegotiationScoresRequestDto)
 
-협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+V5 `scsbidSend`(type=nego) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
 ### Example
 
@@ -744,11 +452,9 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-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(
-    idempotencyKey,
+const { status, data } = await apiInstance.v1SubmitNegotiationScores(
     submitNegotiationScoresRequestDto
 );
 ```
@@ -758,7 +464,6 @@ const { status, data } = await apiInstance.submitNegotiationScores(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **submitNegotiationScoresRequestDto** | **SubmitNegotiationScoresRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
 ### Return type
@@ -767,64 +472,7 @@ const { status, data } = await apiInstance.submitNegotiationScores(
 
 ### 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** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) 또는 Idempotency-Key 헤더 누락(&#x60;type: …/idempotency-key-required&#x60;). scores 배열이 비어 있거나 sequence 중복 시 400. |  -  |
-|**401** | Bearer 토큰 없음 또는 만료(&#x60;type: …/unauthorized&#x60;). |  -  |
-|**403** | 스코프 부족(&#x60;type: …/insufficient-scope&#x60;) 또는 buyerId 가 키 보유자와 불일치(&#x60;type: …/buyer-scope-mismatch&#x60;). |  -  |
-|**409** | 동일 Idempotency-Key 로 다른 body 재전송(&#x60;type: …/idempotency-key-conflict&#x60;). |  -  |
-|**502** | backend 도메인 거부 — 공고 상태 불일치, 응찰자 미존재 등(&#x60;type: …/upstream-rejected&#x60;). |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **uploadFile**
-> FileUploadedResponseDto uploadFile(uploadFileRequestDto)
-
-스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
-
-### Example
-
-```typescript
-import {
-    PartnerV1Api,
-    Configuration,
-    UploadFileRequestDto
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerV1Api(configuration);
-
-let uploadFileRequestDto: UploadFileRequestDto; //
-
-const { status, data } = await apiInstance.uploadFile(
-    uploadFileRequestDto
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **uploadFileRequestDto** | **UploadFileRequestDto**|  | |
-
-
-### Return type
-
-**FileUploadedResponseDto**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
+[platform-auth](../README.md#platform-auth)
 
 ### HTTP request headers