@cmarket/partner-sdk 0.1.0 → 0.2.1

package/docs/PartnerV2Api.md

@@ -4,14 +4,448 @@ 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 | 거래명세서 조회|
+|[**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 후속. scope 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; // (default to undefined)
+let completeAcceptanceRequestDto: CompleteAcceptanceRequestDto; //
+
+const { status, data } = await apiInstance.completeAcceptance(
+    bidId,
+    completeAcceptanceRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **completeAcceptanceRequestDto** | **CompleteAcceptanceRequestDto**|  | |
+| **bidId** | [**string**] |  | 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** |  |  -  |
+
+[[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; // (default to undefined)
+
+const { status, data } = await apiInstance.getBidContractDocuments(
+    bidId,
+    buyerId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidId** | [**string**] |  | defaults to undefined|
+| **buyerId** | [**string**] |  | 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; // (default to undefined)
+
+const { status, data } = await apiInstance.getBidResults(
+    bidId,
+    buyerId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **bidId** | [**string**] |  | defaults to undefined|
+| **buyerId** | [**string**] |  | 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, 단건 유지). 입력 순서를 보존한다. 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)
+
+# **markBidFailed**
+> BidFailedResponseDto markBidFailed(markBidFailedRequestDto)
+
+유찰 처리(V5 yoochal 패리티). 유찰사유 코드(1~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 markBidFailedRequestDto: MarkBidFailedRequestDto; //
+
+const { status, data } = await apiInstance.markBidFailed(
+    markBidFailedRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
+
+
+### 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** |  |  -  |
+
+[[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 후속. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+낙찰 결과 등록. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -63,7 +497,7 @@ const { status, data } = await apiInstance.registerAward(
 # **registerBid**
 > BidCreatedResponseDto registerBid(createBidRequestDto)
 
-V5 /bidsend 후속. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -105,6 +539,110 @@ const { status, data } = await apiInstance.registerBid(
  - **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 후속. scope invoices:write + Idempotency-Key.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    RequestSplitInvoiceRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto; //
+
+const { status, data } = await apiInstance.requestSplitInvoice(
+    requestSplitInvoiceRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **requestSplitInvoiceRequestDto** | **RequestSplitInvoiceRequestDto**|  | |
+
+
+### 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** |  |  -  |
+
+[[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 nego-eval 패리티). complete=true 면 평가완료 게이트까지 적용해 낙찰 진입 가능. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    SubmitNegotiationScoresRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto; //
+
+const { status, data } = await apiInstance.submitNegotiationScores(
+    submitNegotiationScoresRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **submitNegotiationScoresRequestDto** | **SubmitNegotiationScoresRequestDto**|  | |
+
+
+### 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 |
 |-------------|-------------|------------------|

package/docs/RegisterAwardRequestDto.md

@@ -5,9 +5,11 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 낙찰 확정 actor. V5 bid_branch_id. | [default to undefined]
+**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 낙찰 확정 actor. | [default to undefined]
 **bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). | [default to undefined]
 **winnerMemberId** | **string** | 낙찰자(공급사) memberId. | [default to undefined]
+**winnerSequence** | **number** | 낙찰자 응찰 순번(= V5 entendrec 응답의 sequence = buy_seq). 복수응찰 시 정확한 응찰행을 지정. 없으면 winnerMemberId 로 첫 응찰행 해소(기존 폴백). | [optional] [default to undefined]
+**accDeliDate** | **string** | 납품일자 override(= V5 acc_deli_date). buy_deli_day_type 이 A/B 면 delivery_date(앞 10자), 그 외면 buy_deli_day(자유텍스트)를 덮어쓴다. 없으면 공고 기존 납품일자 유지. | [optional] [default to undefined]
 
 ## Example
 
@@ -18,6 +20,8 @@ const instance: RegisterAwardRequestDto = {
     buyerId,
     bidNo,
     winnerMemberId,
+    winnerSequence,
+    accDeliDate,
 };
 ```
 

package/docs/RequestSplitInvoiceRequestDto.md

@@ -0,0 +1,28 @@
+# RequestSplitInvoiceRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). | [default to undefined]
+**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id). | [default to undefined]
+**supplyAmount** | **number** | 공급가액(원). | [default to undefined]
+**vat** | **number** | 부가세(원). | [default to undefined]
+**issueDate** | **string** | 발급 희망일(ISO 8601 date). 미지정 시 backend 기본값. 미래일자는 거부(I5). | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { RequestSplitInvoiceRequestDto } from '@cmarket/partner-sdk';
+
+const instance: RequestSplitInvoiceRequestDto = {
+    bidNo,
+    buyerId,
+    supplyAmount,
+    vat,
+    issueDate,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/SplitInvoiceResponseDto.md

@@ -0,0 +1,22 @@
+# SplitInvoiceResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidNo** | **string** | 공고 구매번호. | [default to undefined]
+**requested** | **boolean** | 분할 발급 청구 접수 여부. | [default to undefined]
+
+## Example
+
+```typescript
+import { SplitInvoiceResponseDto } from '@cmarket/partner-sdk';
+
+const instance: SplitInvoiceResponseDto = {
+    bidNo,
+    requested,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/StatementDocumentDto.md

@@ -0,0 +1,24 @@
+# StatementDocumentDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**paperCode** | **number** | 문서 종류 코드 (paperCode). | [default to undefined]
+**fileName** | **object** | 파일명. 미발급 시 null. | [default to undefined]
+**fileUrl** | **object** | 파일 다운로드 URL. 미발급 시 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { StatementDocumentDto } from '@cmarket/partner-sdk';
+
+const instance: StatementDocumentDto = {
+    paperCode,
+    fileName,
+    fileUrl,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/StatementProductDto.md

@@ -0,0 +1,36 @@
+# StatementProductDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**productName** | **object** | 품목명. 미지정 시 null. | [default to undefined]
+**quantity** | **number** | 수량. | [default to undefined]
+**unitPrice** | **number** | 단가. | [default to undefined]
+**supplyAmount** | **number** | 공급가액. | [default to undefined]
+**vat** | **number** | 부가세. | [default to undefined]
+**total** | **number** | 합계금액 (공급가액 + 부가세). | [default to undefined]
+**lineSeq** | **object** | 품목 라인 순번. 미설정 시 null. | [default to undefined]
+**productCode** | **object** | 품목 코드. 미설정 시 null. | [default to undefined]
+**spec** | **object** | 규격. 미설정 시 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { StatementProductDto } from '@cmarket/partner-sdk';
+
+const instance: StatementProductDto = {
+    productName,
+    quantity,
+    unitPrice,
+    supplyAmount,
+    vat,
+    total,
+    lineSeq,
+    productCode,
+    spec,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)