@cmarket/partner-sdk 0.11.0 → 1.0.0

package/docs/PartnerV2Api.md

@@ -0,0 +1,789 @@
+# PartnerV2Api
+
+All URIs are relative to *http://localhost*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**completeAcceptance**](#completeacceptance) | **POST** /v2/bids/{bidId}/acceptance | 검수완료 전송|
+|[**getBidContractDocuments**](#getbidcontractdocuments) | **GET** /v2/bids/{bidId}/contract-documents | 계약서류 수신 조회|
+|[**getBidContractDocumentsBatch**](#getbidcontractdocumentsbatch) | **POST** /v2/bids/contract-documents/batch | 계약서류 수신 배치 조회|
+|[**getBidResults**](#getbidresults) | **GET** /v2/bids/{bidId}/results | 입찰 결과 조회|
+|[**getBidResultsBatch**](#getbidresultsbatch) | **POST** /v2/bids/results/batch | 입찰결과 배치 조회|
+|[**getBidSettlement**](#getbidsettlement) | **GET** /v2/bids/{bidId}/settlement | 입찰결과 정산정보 조회|
+|[**getBidStatement**](#getbidstatement) | **GET** /v2/bids/{bidId}/statement | 거래명세서 조회|
+|[**healthControllerCheck**](#healthcontrollercheck) | **GET** /health | Partner API 헬스체크|
+|[**markBidFailed**](#markbidfailed) | **POST** /v2/awards/fail | 유찰 처리|
+|[**registerAward**](#registeraward) | **POST** /v2/awards | 낙찰 결과 전송|
+|[**registerBid**](#registerbid) | **POST** /v2/bids | 입찰 정보 전송(등록)|
+|[**requestSplitInvoice**](#requestsplitinvoice) | **POST** /v2/invoices/split-requests | 계산서 분할 발급 청구|
+|[**submitNegotiationScores**](#submitnegotiationscores) | **POST** /v2/awards/nego-eval | 협상(H/K) 점수평가|
+|[**uploadFile**](#uploadfile) | **POST** /v2/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` 헤더 필수.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    CompleteAcceptanceRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(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 completeAcceptanceRequestDto: CompleteAcceptanceRequestDto; //
+
+const { status, data } = await apiInstance.completeAcceptance(
+    bidId,
+    idempotencyKey,
+    completeAcceptanceRequestDto
+);
+```
+
+### Parameters
+
+|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|
+
+
+### Return type
+
+**AcceptanceResultResponseDto**
+
+### 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 |
+|-------------|-------------|------------------|
+|**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 {
+    PartnerV2Api,
+    Configuration
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(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 |
+|-------------|-------------|------------------|
+|**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)
+
+# **getBidContractDocumentsBatch**
+> Array<BidContractDocumentsResponseDto> getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto)
+
+V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 한 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    BidContractDocumentsBatchRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto; //
+
+const { status, data } = await apiInstance.getBidContractDocumentsBatch(
+    bidContractDocumentsBatchRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidContractDocumentsBatchRequestDto** | **BidContractDocumentsBatchRequestDto**|  | |
+
+
+### Return type
+
+**Array<BidContractDocumentsResponseDto>**
+
+### 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 |
+|-------------|-------------|------------------|
+|**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)
+
+# **getBidResults**
+> BidResultsResponseDto getBidResults()
+
+V5 /entendrec 후속. scope bids:read.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration
+} from '@cmarket/partner-sdk';
+
+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
+);
+```
+
+### 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.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    BidResultsBatchRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let bidResultsBatchRequestDto: BidResultsBatchRequestDto; //
+
+const { status, data } = await apiInstance.getBidResultsBatch(
+    bidResultsBatchRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidResultsBatchRequestDto** | **BidResultsBatchRequestDto**|  | |
+
+
+### Return type
+
+**Array<BidResultsResponseDto>**
+
+### 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 |
+|-------------|-------------|------------------|
+|**200** |  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getBidSettlement**
+> BidSettlementResponseDto getBidSettlement()
+
+V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(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()
+
+V5 /getGrm 후속. scope contracts:read.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let bidId: string; // (default to undefined)
+let paperCode: number; // (default to undefined)
+
+const { status, data } = await apiInstance.getBidStatement(
+    bidId,
+    paperCode
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidId** | [**string**] |  | defaults to undefined|
+| **paperCode** | [**number**] |  | defaults to undefined|
+
+
+### Return type
+
+**BidStatementResponseDto**
+
+### 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)
+
+# **healthControllerCheck**
+> HealthResponseDto healthControllerCheck()
+
+ERP 연동 직전 회선·인증 endpoint 동작 확인용.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+const { status, data } = await apiInstance.healthControllerCheck();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**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` 헤더 필수.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    MarkBidFailedRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let markBidFailedRequestDto: MarkBidFailedRequestDto; //
+
+const { status, data } = await apiInstance.markBidFailed(
+    idempotencyKey,
+    markBidFailedRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+
+
+### Return type
+
+**BidFailedResponseDto**
+
+### 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;). 코드 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)
+
+# **registerAward**
+> AwardRegisteredResponseDto registerAward(registerAwardRequestDto)
+
+낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    RegisterAwardRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let registerAwardRequestDto: RegisterAwardRequestDto; //
+
+const { status, data } = await apiInstance.registerAward(
+    idempotencyKey,
+    registerAwardRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **registerAwardRequestDto** | **RegisterAwardRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+
+
+### Return type
+
+**AwardRegisteredResponseDto**
+
+### 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;). |  -  |
+|**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)
+
+# **registerBid**
+> BidCreatedResponseDto registerBid(createBidRequestDto)
+
+입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    CreateBidRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let createBidRequestDto: CreateBidRequestDto; //
+
+const { status, data } = await apiInstance.registerBid(
+    createBidRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **createBidRequestDto** | **CreateBidRequestDto**|  | |
+
+
+### Return type
+
+**BidCreatedResponseDto**
+
+### 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** |  |  -  |
+
+[[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)
+
+세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    RequestSplitInvoiceRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto; //
+
+const { status, data } = await apiInstance.requestSplitInvoice(
+    idempotencyKey,
+    requestSplitInvoiceRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **requestSplitInvoiceRequestDto** | **RequestSplitInvoiceRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+
+
+### Return type
+
+**SplitInvoiceResponseDto**
+
+### 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 |
+|-------------|-------------|------------------|
+|**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;). |  -  |
+
+[[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)
+
+협상에의한계약(낙찰방법 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` 헤더 필수.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    SubmitNegotiationScoresRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
+let submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto; //
+
+const { status, data } = await apiInstance.submitNegotiationScores(
+    idempotencyKey,
+    submitNegotiationScoresRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **submitNegotiationScoresRequestDto** | **SubmitNegotiationScoresRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
+
+
+### Return type
+
+**NegotiationScoredResponseDto**
+
+### 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 {
+    PartnerV2Api,
+    Configuration,
+    UploadFileRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(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)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**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)
+