@cmarket/partner-sdk 9.7.0 → 10.0.0

package/docs/PartnerV1Api.md

@@ -15,7 +15,7 @@ All URIs are relative to *https://partner-api.c-market.net*
 |[**v1SubmitNegotiationScores**](#v1submitnegotiationscores) | **POST** /v1/awards/nego-eval | 협상(H/K) 점수평가 — V5 충실|
 
 # **v1CompleteAcceptance**
-> AcceptanceResultResponseDto v1CompleteAcceptance(completeAcceptanceV1RequestDto)
+> AcceptanceResultV1ResponseDto v1CompleteAcceptance(completeAcceptanceV1RequestDto)
 
 V5 `/acceptanceCompleteSend` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
@@ -50,7 +50,7 @@ const { status, data } = await apiInstance.v1CompleteAcceptance(
 
 ### Return type
 
-**AcceptanceResultResponseDto**
+**AcceptanceResultV1ResponseDto**
 
 ### Authorization
 
@@ -76,7 +76,7 @@ const { status, data } = await apiInstance.v1CompleteAcceptance(
 [[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)
 
 # **v1GetBidContractDocumentsBatch**
-> Array<BidContractDocumentsResponseDto> v1GetBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto)
+> Array<BidContractDocumentsV1ResponseDto> v1GetBidContractDocumentsBatch(bidContractDocumentsBatchV1RequestDto)
 
 V5 `/contractDocumentRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
@@ -86,16 +86,16 @@ V5 `/contractDocumentRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secre
 import {
     PartnerV1Api,
     Configuration,
-    BidContractDocumentsBatchRequestDto
+    BidContractDocumentsBatchV1RequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-let bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto; //
+let bidContractDocumentsBatchV1RequestDto: BidContractDocumentsBatchV1RequestDto; //
 
 const { status, data } = await apiInstance.v1GetBidContractDocumentsBatch(
-    bidContractDocumentsBatchRequestDto
+    bidContractDocumentsBatchV1RequestDto
 );
 ```
 
@@ -103,12 +103,12 @@ const { status, data } = await apiInstance.v1GetBidContractDocumentsBatch(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidContractDocumentsBatchRequestDto** | **BidContractDocumentsBatchRequestDto**|  | |
+| **bidContractDocumentsBatchV1RequestDto** | **BidContractDocumentsBatchV1RequestDto**|  | |
 
 
 ### Return type
 
-**Array<BidContractDocumentsResponseDto>**
+**Array<BidContractDocumentsV1ResponseDto>**
 
 ### Authorization
 
@@ -133,7 +133,7 @@ const { status, data } = await apiInstance.v1GetBidContractDocumentsBatch(
 [[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)
 
 # **v1GetBidResultsBatch**
-> Array<BidResultsV1ResponseDto> v1GetBidResultsBatch(bidResultsBatchRequestDto)
+> Array<BidResultsV1ResponseDto> v1GetBidResultsBatch(bidResultsBatchV1RequestDto)
 
 V5 `/entendRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정. resolveBidId 도 이 엔드포인트를 사용한다.
 
@@ -143,16 +143,16 @@ V5 `/entendRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_se
 import {
     PartnerV1Api,
     Configuration,
-    BidResultsBatchRequestDto
+    BidResultsBatchV1RequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-let bidResultsBatchRequestDto: BidResultsBatchRequestDto; //
+let bidResultsBatchV1RequestDto: BidResultsBatchV1RequestDto; //
 
 const { status, data } = await apiInstance.v1GetBidResultsBatch(
-    bidResultsBatchRequestDto
+    bidResultsBatchV1RequestDto
 );
 ```
 
@@ -160,7 +160,7 @@ const { status, data } = await apiInstance.v1GetBidResultsBatch(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **bidResultsBatchRequestDto** | **BidResultsBatchRequestDto**|  | |
+| **bidResultsBatchV1RequestDto** | **BidResultsBatchV1RequestDto**|  | |
 
 
 ### Return type
@@ -424,7 +424,7 @@ const { status, data } = await apiInstance.v1RegisterBid(
 [[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)
 
 # **v1RequestSplitInvoice**
-> SplitInvoiceResponseDto v1RequestSplitInvoice(requestSplitInvoiceRequestDto)
+> SplitInvoiceV1ResponseDto v1RequestSplitInvoice(requestSplitInvoiceV1RequestDto)
 
 V5 `splitInvoiceRequest` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
 
@@ -434,16 +434,16 @@ V5 `splitInvoiceRequest` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId
 import {
     PartnerV1Api,
     Configuration,
-    RequestSplitInvoiceRequestDto
+    RequestSplitInvoiceV1RequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerV1Api(configuration);
 
-let requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto; //
+let requestSplitInvoiceV1RequestDto: RequestSplitInvoiceV1RequestDto; //
 
 const { status, data } = await apiInstance.v1RequestSplitInvoice(
-    requestSplitInvoiceRequestDto
+    requestSplitInvoiceV1RequestDto
 );
 ```
 
@@ -451,12 +451,12 @@ const { status, data } = await apiInstance.v1RequestSplitInvoice(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **requestSplitInvoiceRequestDto** | **RequestSplitInvoiceRequestDto**|  | |
+| **requestSplitInvoiceV1RequestDto** | **RequestSplitInvoiceV1RequestDto**|  | |
 
 
 ### Return type
 
-**SplitInvoiceResponseDto**
+**SplitInvoiceV1ResponseDto**
 
 ### Authorization
 

package/docs/PartnerV2Api.md

@@ -16,6 +16,7 @@ All URIs are relative to *https://partner-api.c-market.net*
 |[**regenerateContractDocuments**](#regeneratecontractdocuments) | **POST** /v2/bids/{bidId}/contract-documents | 계약서류 생성(재생성)|
 |[**registerAward**](#registeraward) | **POST** /v2/awards | 낙찰 결과 전송|
 |[**registerBid**](#registerbid) | **POST** /v2/bids | 입찰 정보 전송(등록)|
+|[**simulateSandboxBid**](#simulatesandboxbid) | **POST** /v2/sandbox/bids/{bidId}/simulate | 샌드박스 응찰/마감 시뮬 (영업 데모 전용)|
 |[**updateBid**](#updatebid) | **PATCH** /v2/bids/{bidId} | 입찰 공고 수정|
 |[**uploadFile**](#uploadfile) | **POST** /v2/files | 입찰 첨부파일 업로드(base64 또는 url) → fileKey|
 
@@ -88,7 +89,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 # **completeInvoice**
 > InvoiceCompletedResponseDto completeInvoice()
 
-공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료 플래그(`buy_payment_force_yn`, `buy_payment_yn`)와 계산서 발급 플래그(`taxbill`)가 `Y`로 기록됩니다. - 계산서 발급일자(`taxbill_date`)가 현재 시각으로 기록됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다.  **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때.  **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다.  **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403).  **이미 완료:** 이미 완료처리된 공고 재호출 → 409.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -209,7 +210,7 @@ const { status, data } = await apiInstance.createEmbedLaunch(
 # **getBidResults**
 > BidResultsResponseDto getBidResults()
 
-V5 /entendrec 후속. scope bids:read.
+공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
 
 ### Example
 
@@ -223,11 +224,9 @@ const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
 let bidId: string; // (default to undefined)
-let buyerId: string; //공고 명의 회원 ID (멀티테넌트 가시성 키). (default to undefined)
 
 const { status, data } = await apiInstance.getBidResults(
-    bidId,
-    buyerId
+    bidId
 );
 ```
 
@@ -236,7 +235,6 @@ const { status, data } = await apiInstance.getBidResults(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **bidId** | [**string**] |  | defaults to undefined|
-| **buyerId** | [**string**] | 공고 명의 회원 ID (멀티테넌트 가시성 키). | defaults to undefined|
 
 
 ### Return type
@@ -270,7 +268,7 @@ const { status, data } = await apiInstance.getBidResults(
 # **getBidSettlement**
 > BidSettlementResponseDto getBidSettlement()
 
-V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회한다. scope bids:read. 가시성 마스킹과 직교한 정산 데이터 — read-only.
 
 ### Example
 
@@ -328,7 +326,7 @@ const { status, data } = await apiInstance.getBidSettlement(
 # **getBidStatement**
 > BidStatementResponseDto getBidStatement()
 
-V5 /getGrm 후속. scope contracts:read.
+낙찰 계약의 거래명세서(문서·품목 라인)를 조회한다. scope contracts:read.
 
 ### Example
 
@@ -435,7 +433,7 @@ No authorization required
 # **issueTaxInvoice**
 > TaxInvoiceIssuedResponseDto issueTaxInvoice(issueTaxInvoiceRequestDto)
 
-낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다(Popbill).  **V5 대응:** `B2B_BUY_POP_BILL_S1` 발행 경로의 V6 후속.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 `b2b_buy.taxbill=\'Y\'` 로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+낙찰 공급사가 확정된 공고에 대해 세금계산서를 발행합니다.  **호출 시점:** 낙찰자 선정(계약진행) 이후. 과세/면세를 자동 분리해 발행합니다.  **부수효과:** - 세금계산서가 국세청에 발행되고 공고가 발행 완료로 마킹됩니다. - 이미 발행됐거나 분할 청구가 진행 중이면 409 로 거절됩니다.  **소유권:** 발행 대상 공고가 API 키에 바인딩된 발주처 소유가 아니면 403.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
 
 ### Example
 
@@ -449,7 +447,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고번호(등록 응답의 bidNo). (default to undefined)
+let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
 let issueTaxInvoiceRequestDto: IssueTaxInvoiceRequestDto; //
 
@@ -465,7 +463,7 @@ const { status, data } = await apiInstance.issueTaxInvoice(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **issueTaxInvoiceRequestDto** | **IssueTaxInvoiceRequestDto**|  | |
-| **bidId** | [**string**] | 공고번호(등록 응답의 bidNo). | defaults to undefined|
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
 
 
@@ -499,9 +497,9 @@ const { status, data } = await apiInstance.issueTaxInvoice(
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **markBidFailed**
-> BidFailedResponseDto markBidFailed(markBidFailedRequestDto)
+> BidFailedV2ResponseDto markBidFailed(markBidFailedRequestDto)
 
-공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+공고를 유찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다.  **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 |  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
 
 ### Example
 
@@ -534,7 +532,7 @@ const { status, data } = await apiInstance.markBidFailed(
 
 ### Return type
 
-**BidFailedResponseDto**
+**BidFailedV2ResponseDto**
 
 ### Authorization
 
@@ -624,9 +622,9 @@ const { status, data } = await apiInstance.regenerateContractDocuments(
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **registerAward**
-> AwardRegisteredResponseDto registerAward(registerAwardRequestDto)
+> AwardRegisteredV2ResponseDto registerAward(registerAwardRequestDto)
 
-낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 협상 방식(H/K) 공고는 이 엔드포인트 전에 `/v1/awards/nego-eval` 로 평가 완료가 필요합니다.  **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
 
 ### Example
 
@@ -659,7 +657,7 @@ const { status, data } = await apiInstance.registerAward(
 
 ### Return type
 
-**AwardRegisteredResponseDto**
+**AwardRegisteredV2ResponseDto**
 
 ### Authorization
 
@@ -687,7 +685,7 @@ const { status, data } = await apiInstance.registerAward(
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **registerBid**
-> BidCreatedResponseDto registerBid(createBidRequestDto)
+> BidRegisteredResponseDto registerBid(createBidRequestDto)
 
 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
 
@@ -719,7 +717,7 @@ const { status, data } = await apiInstance.registerBid(
 
 ### Return type
 
-**BidCreatedResponseDto**
+**BidRegisteredResponseDto**
 
 ### Authorization
 
@@ -746,10 +744,72 @@ 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)
 
+# **simulateSandboxBid**
+> SimulateSandboxBidResponseDto simulateSandboxBid(simulateSandboxBidRequestDto)
+
+샌드박스 공고에 합성 응찰을 추가하거나 낙찰대기로 마감하는 **영업 데모 전용** 시뮬입니다.  **샌드박스 키 전용:** 토큰에 `sandboxBuyerId` 가 없는 운영 키로는 호출할 수 없습니다(403 `sandbox-only`).  **단계(`phase`):** - `join` — 합성 공급사 명의로 응찰 1건을 추가합니다(멱등 — 최대 2건, 이미 2건이면 no-op). - `close` — 공고를 낙찰대기(PENDING_AWARD)로 전이해 낙찰결과 조회 게이트를 엽니다(이미 마감이면 no-op).  **안전장치:** 실제 write(합성 응찰 INSERT·상태 전이)는 backend 가 `SANDBOX_BUYER_ID` 소유 공고에 한해서만 수행합니다. 실 발주처 공고는 절대 건드리지 않습니다(fail-closed).  **필수 스코프:** `bids:write`
+
+### Example
+
+```typescript
+import {
+    PartnerV2Api,
+    Configuration,
+    SimulateSandboxBidRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new PartnerV2Api(configuration);
+
+let bidId: string; //샌드박스 공고 ID(= backend bidId). (default to undefined)
+let simulateSandboxBidRequestDto: SimulateSandboxBidRequestDto; //
+
+const { status, data } = await apiInstance.simulateSandboxBid(
+    bidId,
+    simulateSandboxBidRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **simulateSandboxBidRequestDto** | **SimulateSandboxBidRequestDto**|  | |
+| **bidId** | [**string**] | 샌드박스 공고 ID(= backend bidId). | defaults to undefined|
+
+
+### Return type
+
+**SimulateSandboxBidResponseDto**
+
+### 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`). |  -  |
+|**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` 헤더 참조. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **updateBid**
 > BidUpdatedResponseDto updateBid(updateBidRequestDto)
 
-등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  **V5 대응:** modifyBid — 진행중(ONGOING)/임시저장(DRAFT) 공고만 수정 가능합니다.  **부수효과:** - 변경 필드가 `b2b_buy` 에 반영되고 `b2b_buy_mod_history` 에 수정이력이 남습니다. - `hideEdit=\'Y\'` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약(도메인 정책):** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
+등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
 
 ### Example
 
@@ -763,7 +823,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerV2Api(configuration);
 
-let bidId: string; //공고번호(등록 응답의 bidNo) 또는 발주처 조달번호. (default to undefined)
+let bidId: string; //공고 식별자(등록 응답의 bidId). (default to undefined)
 let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. (default to undefined)
 let updateBidRequestDto: UpdateBidRequestDto; //
 
@@ -779,7 +839,7 @@ const { status, data } = await apiInstance.updateBid(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **updateBidRequestDto** | **UpdateBidRequestDto**|  | |
-| **bidId** | [**string**] | 공고번호(등록 응답의 bidNo) 또는 발주처 조달번호. | defaults to undefined|
+| **bidId** | [**string**] | 공고 식별자(등록 응답의 bidId). | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환. | defaults to undefined|
 
 

package/docs/PreconditionsDto.md

@@ -5,16 +5,16 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**bidBond** | [**BidBondDto**](BidBondDto.md) | 입찰보증금 설정 (A 토큰 계열). | [optional] [default to undefined]
-**businessRegistered** | **boolean** | B: 사업자등록증 납부 관련업체. | [optional] [default to undefined]
-**distributor** | **boolean** | C: 총판/대리점. | [optional] [default to undefined]
-**manufacturer** | **boolean** | D: 제조사. | [optional] [default to undefined]
-**directProduction** | **boolean** | E: 직접생산확인증명. | [optional] [default to undefined]
-**legalMandatory** | **Array<string>** | 법적의무구매(XX 우산). I/J/K/L/O1/O2/O3 | [optional] [default to undefined]
-**excellentProcurement** | **Array<string>** | 기술개발제품(XX 우산). P0/P101-P113 | [optional] [default to undefined]
-**greenProduct** | **Array<string>** | 녹색제품(XX 우산). Q0/Q101/Q102/Q103 | [optional] [default to undefined]
-**startup** | **boolean** | R: 창업기업 (XX 우산). | [optional] [default to undefined]
-**social** | **boolean** | S: 사회적기업 (XX 우산). | [optional] [default to undefined]
+**bidBond** | [**BidBondDto**](BidBondDto.md) | 입찰보증금 설정. | [optional] [default to undefined]
+**businessRegistered** | **boolean** | 사업자등록증 납부 관련업체 자격 제한. | [optional] [default to undefined]
+**distributor** | **boolean** | 총판/대리점 자격 제한. | [optional] [default to undefined]
+**manufacturer** | **boolean** | 제조사 자격 제한. | [optional] [default to undefined]
+**directProduction** | **boolean** | 직접생산확인증명 보유 업체로 제한. | [optional] [default to undefined]
+**legalMandatory** | **Array<string>** | 법적의무구매 대상 코드. I=중증장애인생산품, K=중소기업, L=여성기업, O1=장애인표준사업장, O2=장애인기업, O3=사회적협동조합. | [optional] [default to undefined]
+**excellentProcurement** | **Array<string>** | 기술개발제품 인증 코드. P0=전체, P101~P113=개별 인증(우수조달물품·NEP·GS·성능인증 등). | [optional] [default to undefined]
+**greenProduct** | **Array<string>** | 녹색제품 인증 코드. Q0=전체, Q101=환경표지, Q102=저탄소, Q103=우수재활용(GR). | [optional] [default to undefined]
+**startup** | **boolean** | 창업기업 자격 제한. | [optional] [default to undefined]
+**social** | **boolean** | 사회적기업 자격 제한. | [optional] [default to undefined]
 
 ## Example
 

package/docs/PreconditionsV1Dto.md

@@ -0,0 +1,38 @@
+# PreconditionsV1Dto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidBond** | [**BidBondV1Dto**](BidBondV1Dto.md) | 입찰보증금 설정. | [optional] [default to undefined]
+**businessRegistered** | **boolean** | 사업자등록증 납부 관련업체 자격 제한. | [optional] [default to undefined]
+**distributor** | **boolean** | 총판/대리점 자격 제한. | [optional] [default to undefined]
+**manufacturer** | **boolean** | 제조사 자격 제한. | [optional] [default to undefined]
+**directProduction** | **boolean** | 직접생산확인증명 보유 업체로 제한. | [optional] [default to undefined]
+**legalMandatory** | **Array<string>** | 법적의무구매 대상 코드. I=중증장애인생산품, K=중소기업, L=여성기업, O1=장애인표준사업장, O2=장애인기업, O3=사회적협동조합. | [optional] [default to undefined]
+**excellentProcurement** | **Array<string>** | 기술개발제품 인증 코드. P0=전체, P101~P113=개별 인증(우수조달물품·NEP·GS·성능인증 등). | [optional] [default to undefined]
+**greenProduct** | **Array<string>** | 녹색제품 인증 코드. Q0=전체, Q101=환경표지, Q102=저탄소, Q103=우수재활용(GR). | [optional] [default to undefined]
+**startup** | **boolean** | 창업기업 자격 제한. | [optional] [default to undefined]
+**social** | **boolean** | 사회적기업 자격 제한. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { PreconditionsV1Dto } from '@cmarket/partner-sdk';
+
+const instance: PreconditionsV1Dto = {
+    bidBond,
+    businessRegistered,
+    distributor,
+    manufacturer,
+    directProduction,
+    legalMandatory,
+    excellentProcurement,
+    greenProduct,
+    startup,
+    social,
+};
+```
+
+[[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/RegisterAwardRequestDto.md

@@ -5,11 +5,10 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 낙찰 확정 actor. 생략 시 backend 가 bid 소유자에서 파생한다(멀티테넌트). | [optional] [default to undefined]
-**bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). | [default to undefined]
-**winnerMemberId** | **string** | 낙찰자(공급사) memberId. winnerSequence 가 없으면 필수(낙찰자 식별). winnerSequence 가 있으면 생략 가능(backend 가 응찰행으로 해소). | [optional] [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]
+**bidId** | **string** | 공고 ID(등록 응답의 bidId). | [default to undefined]
+**winnerMemberId** | **string** | 낙찰자(공급사) 회원 ID. winnerSequence 가 없으면 필수(낙찰자 식별). winnerSequence 가 있으면 생략 가능. | [optional] [default to undefined]
+**winnerSequence** | **number** | 낙찰자 응찰 순번(낙찰 결과 조회의 sequence). 복수 응찰 시 정확한 응찰 건을 지정한다. 없으면 winnerMemberId 로 첫 응찰 건을 해소한다. | [optional] [default to undefined]
+**deliveryDateOverride** | **string** | 납품희망일 override(YYYY-MM-DD). 지정하면 공고의 납품일자를 이 값으로 덮어쓴다. 없으면 공고 등록 시 지정한 납품일자를 유지한다. | [optional] [default to undefined]
 
 ## Example
 
@@ -17,11 +16,10 @@ Name | Type | Description | Notes
 import { RegisterAwardRequestDto } from '@cmarket/partner-sdk';
 
 const instance: RegisterAwardRequestDto = {
-    buyerId,
-    bidNo,
+    bidId,
     winnerMemberId,
     winnerSequence,
-    accDeliDate,
+    deliveryDateOverride,
 };
 ```
 

package/docs/{RequestSplitInvoiceRequestDto.md → RequestSplitInvoiceV1RequestDto.md}

@@ -1,4 +1,4 @@
-# RequestSplitInvoiceRequestDto
+# RequestSplitInvoiceV1RequestDto
 
 
 ## Properties
@@ -14,9 +14,9 @@ Name | Type | Description | Notes
 ## Example
 
 ```typescript
-import { RequestSplitInvoiceRequestDto } from '@cmarket/partner-sdk';
+import { RequestSplitInvoiceV1RequestDto } from '@cmarket/partner-sdk';
 
-const instance: RequestSplitInvoiceRequestDto = {
+const instance: RequestSplitInvoiceV1RequestDto = {
     bidNo,
     buyerId,
     supplyAmount,

package/docs/SimulateSandboxBidRequestDto.md

@@ -0,0 +1,20 @@
+# SimulateSandboxBidRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**phase** | **string** | 시뮬 단계. `join`=합성 응찰 1건 추가(멱등), `close`=낙찰대기 전이(마감). | [default to undefined]
+
+## Example
+
+```typescript
+import { SimulateSandboxBidRequestDto } from '@cmarket/partner-sdk';
+
+const instance: SimulateSandboxBidRequestDto = {
+    phase,
+};
+```
+
+[[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/SimulateSandboxBidResponseDto.md

@@ -0,0 +1,26 @@
+# SimulateSandboxBidResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidId** | **string** | 공고 ID(= backend bidId). | [default to undefined]
+**phase** | **string** | 수행한 시뮬 단계. | [default to undefined]
+**joinCount** | **number** | 현재 응찰 건수(join 후 반영값). | [default to undefined]
+**closed** | **boolean** | 공고가 낙찰대기로 마감됐는지. | [default to undefined]
+
+## Example
+
+```typescript
+import { SimulateSandboxBidResponseDto } from '@cmarket/partner-sdk';
+
+const instance: SimulateSandboxBidResponseDto = {
+    bidId,
+    phase,
+    joinCount,
+    closed,
+};
+```
+
+[[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 → SplitInvoiceV1ResponseDto.md}

@@ -1,4 +1,4 @@
-# SplitInvoiceResponseDto
+# SplitInvoiceV1ResponseDto
 
 
 ## Properties
@@ -11,9 +11,9 @@ Name | Type | Description | Notes
 ## Example
 
 ```typescript
-import { SplitInvoiceResponseDto } from '@cmarket/partner-sdk';
+import { SplitInvoiceV1ResponseDto } from '@cmarket/partner-sdk';
 
-const instance: SplitInvoiceResponseDto = {
+const instance: SplitInvoiceV1ResponseDto = {
     bidNo,
     requested,
 };

package/docs/StatementDocumentDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**fSeq** | **number** | 파일 순번 (V5 f_seq) — documents 배열 내 1-indexed 위치(결정적 순서). V5 응답의 f_seq 대응. | [default to undefined]
+**sequence** | **number** | 파일 순번 — documents 배열 내 1-indexed 위치(결정적 순서). | [default to undefined]
 **paperCode** | **number** | 문서 종류 코드 (paperCode). | [default to undefined]
 **fileName** | **object** | 파일명. 미발급 시 null. | [default to undefined]
 **fileUrl** | **object** | 파일 다운로드 URL. 미발급 시 null. | [default to undefined]
@@ -16,7 +16,7 @@ Name | Type | Description | Notes
 import { StatementDocumentDto } from '@cmarket/partner-sdk';
 
 const instance: StatementDocumentDto = {
-    fSeq,
+    sequence,
     paperCode,
     fileName,
     fileUrl,

package/docs/StatementProductDto.md

@@ -12,7 +12,7 @@ Name | Type | Description | Notes
 **vat** | **number** | 부가세. | [default to undefined]
 **total** | **number** | 합계금액 (공급가액 + 부가세). | [default to undefined]
 **lineSeq** | **object** | 품목 라인 순번. 미설정 시 null. | [default to undefined]
-**productCode** | **object** | 품목 코드. 미설정 시 null. | [default to undefined]
+**itemCode** | **object** | 품목 코드. 미설정 시 null. | [default to undefined]
 **spec** | **object** | 규격. 미설정 시 null. | [default to undefined]
 
 ## Example
@@ -28,7 +28,7 @@ const instance: StatementProductDto = {
     vat,
     total,
     lineSeq,
-    productCode,
+    itemCode,
     spec,
 };
 ```

package/docs/SupplierTaxType.md

@@ -0,0 +1,11 @@
+# SupplierTaxType
+
+낙찰 공급사 사업자의 과세유형. 공고 자체의 과세유형(`taxationType`)과 혼동 금지.
+
+## Enum
+
+* `Taxable` (value: `'TAXABLE'`)
+
+* `TaxFree` (value: `'TAX_FREE'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)