@cmarket/partner-sdk 47.0.0 → 49.0.0

package/docs/PartnerApiApi.md

@@ -4,167 +4,23 @@ All URIs are relative to *https://partner-api.c-market.net*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
-|[**cancelBid**](#cancelbid) | **POST** /v2/bids/{bidRef}/cancel | 공고 취소|
-|[**cancelKclMroOrder**](#cancelkclmroorder) | **POST** /v2/kcl-mro-orders/cancel | 몰 주문 취소 표시|
 |[**completeAcceptance**](#completeacceptance) | **POST** /v2/bids/{bidRef}/acceptance | 검수완료 전송|
-|[**completeFileUpload**](#completefileupload) | **POST** /v2/files/{fileKey}/complete | 대용량 업로드 2/2 — 업로드 확정|
-|[**completeInvoice**](#completeinvoice) | **POST** /v2/bids/{bidRef}/settlement/complete | 정산 마감|
 |[**createCardPayment**](#createcardpayment) | **POST** /v2/card-payments | 결제창 발행|
 |[**createExternalContractDocuments**](#createexternalcontractdocuments) | **POST** /v2/contract-documents | 계약서류 생성|
-|[**createFileUploadUrl**](#createfileuploadurl) | **POST** /v2/files/upload-url | 대용량 업로드 1/2 — 업로드 주소 발급|
 |[**downloadFile**](#downloadfile) | **GET** /files/{fileKey} | 파일 다운로드|
-|[**getBid**](#getbid) | **GET** /v2/bids/{bidRef} | 공고 상세 조회|
-|[**getBidSettlement**](#getbidsettlement) | **GET** /v2/bids/{bidRef}/settlement | 정산 정보 조회|
 |[**getBidStatement**](#getbidstatement) | **GET** /v2/bids/{bidRef}/statement | 거래명세서 조회|
-|[**getKclMroOrderStatus**](#getkclmroorderstatus) | **GET** /v2/kcl-mro-orders/{orderNo} | 몰 주문 중계 상태 조회|
 |[**getSemoContractTaxinvoiceStatus**](#getsemocontracttaxinvoicestatus) | **GET** /v2/semo-contracts/{externalContractId}/tax-invoice | 계산서 발행 상태 조회|
 |[**getSupplierCardPayableV2**](#getsuppliercardpayablev2) | **GET** /v2/suppliers/{memberId}/card-payable | 공급사 카드결제 가능 여부|
 |[**healthControllerCheck**](#healthcontrollercheck) | **GET** /health | Partner API 헬스체크|
 |[**listBidResults**](#listbidresults) | **GET** /v2/bid-results | 공고 결과 조회|
-|[**listBids**](#listbids) | **GET** /v2/bids | 공고 목록 조회|
 |[**listExternalContractDocuments**](#listexternalcontractdocuments) | **GET** /v2/contract-documents | 거래에 필요한 계약서류 목록 조회|
-|[**listSuppliers**](#listsuppliers) | **GET** /v2/suppliers | 공급사 조회|
 |[**markBidFailed**](#markbidfailed) | **POST** /v2/bids/{bidRef}/fail | 유찰 처리|
 |[**registerAward**](#registeraward) | **POST** /v2/bids/{bidRef}/award | 낙찰 결과 전송|
 |[**registerBid**](#registerbid) | **POST** /v2/bids | 공고 등록|
 |[**registerSemoContract**](#registersemocontract) | **POST** /v2/semo-contracts | 계약 발행대상 등록|
-|[**relayKclMroOrder**](#relaykclmroorder) | **POST** /v2/kcl-mro-orders | 몰 주문 중계 적재|
 |[**requestInvoiceSplit**](#requestinvoicesplit) | **POST** /v2/bids/{bidRef}/invoice-splits | 계산서 분할 발급 청구|
-|[**revertAward**](#revertaward) | **DELETE** /v2/bids/{bidRef}/award | 낙찰 되돌리기|
-|[**updateBid**](#updatebid) | **PATCH** /v2/bids/{bidRef} | 공고 수정|
 |[**uploadFile**](#uploadfile) | **POST** /v2/files | 공고 첨부파일 업로드 (기본)|
 
-# **cancelBid**
-> CancelBid200Response cancelBid(cancelBidRequestDto)
-
-진행중(`ONGOING`) 공고를 취소합니다. 스코프 `bids:write` · `Idempotency-Key` 헤더 필수.  - 되돌릴 수 없습니다. 취소 사유는 필수이고 공고 이력에 남습니다. - 진행중이 아니거나 이미 취소된 공고는 409, 다른 발주기관의 공고는 403입니다. - 응찰은 받았으나 낙찰자를 정하지 못한 종료는 취소가 아니라 유찰(`POST /v2/bids/{bidRef}/fail`)입니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration,
-    CancelBidRequestDto
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let cancelBidRequestDto: CancelBidRequestDto; //
-
-const { status, data } = await apiInstance.cancelBid(
-    bidRef,
-    idempotencyKey,
-    cancelBidRequestDto
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **cancelBidRequestDto** | **CancelBidRequestDto**|  | |
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
-
-
-### Return type
-
-**CancelBid200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 공고 취소 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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)
-
-# **cancelKclMroOrder**
-> CancelKclMroOrder200Response cancelKclMroOrder(cancelKclMroOrderRequestDto)
-
-적재된 주문을 취소로 표시합니다. 스코프 `orders:write`.  **구매요구번호가 이미 채번된 주문은 취소되지 않습니다**(`canceled=false`). 그때는 기관 ERP 안에서 결재가 진행 중이라, 중계 테이블만 지우면 양쪽 장부가 어긋납니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration,
-    CancelKclMroOrderRequestDto
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let cancelKclMroOrderRequestDto: CancelKclMroOrderRequestDto; //
-
-const { status, data } = await apiInstance.cancelKclMroOrder(
-    idempotencyKey,
-    cancelKclMroOrderRequestDto
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **cancelKclMroOrderRequestDto** | **CancelKclMroOrderRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
-
-
-### Return type
-
-**CancelKclMroOrder200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 취소 결과 |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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)
-
 # **completeAcceptance**
 > CompleteAcceptance200Response completeAcceptance(completeAcceptanceRequestDto)
 
@@ -232,136 +88,6 @@ const { status, data } = await apiInstance.completeAcceptance(
 
 [[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)
 
-# **completeFileUpload**
-> UploadFile201Response completeFileUpload(completeUploadRequestDto)
-
-`uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.  확정한 `fileKey`는 `POST /v2/bids`의 `attachments`에 넣습니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration,
-    CompleteUploadRequestDto
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let fileKey: string; //발급 응답의 fileKey(영문 대소문자·숫자 32자). (default to undefined)
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let completeUploadRequestDto: CompleteUploadRequestDto; //
-
-const { status, data } = await apiInstance.completeFileUpload(
-    fileKey,
-    idempotencyKey,
-    completeUploadRequestDto
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **completeUploadRequestDto** | **CompleteUploadRequestDto**|  | |
-| **fileKey** | [**string**] | 발급 응답의 fileKey(영문 대소문자·숫자 32자). | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
-
-
-### Return type
-
-**UploadFile201Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 업로드 확정 완료. 이제 &#x60;fileKey&#x60;를 공고 등록·수정의 첨부 필드에 실을 수 있습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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)
-
-# **completeInvoice**
-> CompleteInvoice200Response completeInvoice()
-
-공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.  라이프사이클의 마지막 호출입니다. 이 뒤로 이어서 부를 오퍼레이션은 없습니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-
-const { status, data } = await apiInstance.completeInvoice(
-    bidRef,
-    idempotencyKey
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
-
-
-### Return type
-
-**CompleteInvoice200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 정산 마감 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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)
-
 # **createCardPayment**
 > CreateCardPayment200Response createCardPayment(createCardPaymentDto)
 
@@ -490,29 +216,26 @@ const { status, data } = await apiInstance.createExternalContractDocuments(
 
 [[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)
 
-# **createFileUploadUrl**
-> CreateFileUploadUrl201Response createFileUploadUrl(createUploadUrlRequestDto)
+# **downloadFile**
+> downloadFile()
 
-파일을 스토리지로 직접 올리기 위한 1회용 서명 URL을 발급합니다(100MB까지). 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  1. 이 호출로 `fileKey`와 `uploadUrl`을 받습니다. 2. `uploadUrl`에 파일 바이트를 그대로 `PUT` 합니다. 응답의 `contentType`을 `Content-Type` 헤더에 싣고, `Authorization` 헤더는 붙이지 않습니다(주소 자체가 자격증명입니다). 3. `POST /v2/files/{fileKey}/complete`로 확정합니다.  ```bash curl -X PUT \"$uploadUrl\" -H \"Content-Type: $contentType\" --upload-file 시방서.pdf ```  - 2단계는 요청이 스토리지로 가므로 이 명세에 오퍼레이션이 없고, 실패 본문도 problem+json이 아닙니다. 만료(400)·중복 업로드(409)면 1단계부터 다시 합니다. - `uploadUrl`은 1회용이며 `expiresIn`초 뒤 만료됩니다. 주소가 곧 자격증명이므로 로그에 남기지 않습니다. - 30MB 이하는 `POST /v2/files` 한 번으로 끝납니다.
+무인증 — `fileKey` 자체가 capability입니다(키를 아는 쪽이 곧 접근 권한을 가집니다). 파트너 응답의 `fileUrl`/`fullUrl`이 이 URL을 가리킵니다. 요청 시점에 서명하므로 URL을 저장해 두어도 만료되지 않습니다. 응답은 실제 저장소 URL로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`).  ---  **응답 형태가 동결된 엔드포인트입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 공통 응답 형식을 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}`가 파일 메타와 `downloadUrl`을 v2 응답 규약으로 돌려줍니다. 이 안정 URL은 파트너 응답의 `fileUrl`/`fullUrl`이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
 
 ### Example
 
 ```typescript
 import {
     PartnerApiApi,
-    Configuration,
-    CreateUploadUrlRequestDto
+    Configuration
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let createUploadUrlRequestDto: CreateUploadUrlRequestDto; //
+let fileKey: string; //파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex가 아닌 문자가 들어갑니다. (default to undefined)
 
-const { status, data } = await apiInstance.createFileUploadUrl(
-    idempotencyKey,
-    createUploadUrlRequestDto
+const { status, data } = await apiInstance.downloadFile(
+    fileKey
 );
 ```
 
@@ -520,584 +243,34 @@ const { status, data } = await apiInstance.createFileUploadUrl(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **createUploadUrlRequestDto** | **CreateUploadUrlRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
+| **fileKey** | [**string**] | 파일 키 — 영문 대소문자·숫자 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex가 아닌 문자가 들어갑니다. | defaults to undefined|
 
 
 ### Return type
 
-**CreateFileUploadUrl201Response**
+void (empty response body)
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**201** | 업로드 주소 발급 완료. 이 주소로 파일 본문을 직접 PUT 한 뒤 반드시 확정(2/2)을 호출해야 &#x60;fileKey&#x60;가 유효해집니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
+No authorization required
 
-[[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)
-
-# **downloadFile**
-> downloadFile()
-
-무인증 — `fileKey` 자체가 capability입니다(키를 아는 쪽이 곧 접근 권한을 가집니다). 파트너 응답의 `fileUrl`/`fullUrl`이 이 URL을 가리킵니다. 요청 시점에 서명하므로 URL을 저장해 두어도 만료되지 않습니다. 응답은 실제 저장소 URL로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`).  ---  **응답 형태가 동결된 엔드포인트입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 공통 응답 형식을 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}`가 파일 메타와 `downloadUrl`을 v2 응답 규약으로 돌려줍니다. 이 안정 URL은 파트너 응답의 `fileUrl`/`fullUrl`이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let fileKey: string; //파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex가 아닌 문자가 들어갑니다. (default to undefined)
-
-const { status, data } = await apiInstance.downloadFile(
-    fileKey
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **fileKey** | [**string**] | 파일 키 — 영문 대소문자·숫자 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex가 아닌 문자가 들어갑니다. | defaults to undefined|
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**302** | 해소된 다운로드 URL로 리다이렉트 |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
-
-# **getBid**
-> GetBid200Response getBid()
-
-공고 한 건의 전체 정보를 조회합니다 — 기본 정보, 납품·대금 조건, 담당자, 품목, 응찰 참여자, 계약서류, 검수 상태. 스코프 `bids:read`.  - 낙찰 여부는 `status`가 아니라 `participants[].isWinner`로 판단합니다. `AWARDED` 상태는 없어(낙찰 직후 `CONTRACT_IN_PROGRESS`) `status === \'AWARDED\'` 폴링은 끝나지 않습니다. - 계약서류는 `contractDocuments[]`에 실립니다. 따로 받는 엔드포인트는 없습니다. - 여러 건은 `GET /v2/bid-results`로 한 번에 받습니다. - 다른 발주기관의 공고는 403입니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.getBid(
-    bidRef,
-    ifNoneMatch
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
-
-
-### Return type
-
-**GetBid200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 공고 상세. 마감 전에는 참가자 신원이 가려져 나가고, 마감 이후 낙찰 여부는 &#x60;participants[].isWinner&#x60;로 읽습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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**
-> GetBidSettlement200Response getBidSettlement()
-
-낙찰 공급사의 사업자·계좌 정보와 공급가액·부가세, 응찰 품목내역을 조회합니다. 대금 지급에 필요한 값입니다. 스코프 `invoices:read`(종전 `bids:read`에서 변경).  다른 조회에서 참가자 정보가 가려지는 경우와 무관하게 이 응답은 항상 그대로 나갑니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.getBidSettlement(
-    bidRef,
-    ifNoneMatch
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
-
-
-### Return type
-
-**GetBidSettlement200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 낙찰 공급사의 사업자·계좌 정보와 공급가액/부가세, 응찰 품목내역. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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**
-> GetBidStatement200Response getBidStatement()
-
-낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).  - 검수완료(`POST /v2/bids/{bidRef}/acceptance`)가 명세서 발행을 예약하므로, 그 전에 부르면 문서가 아직 없어 `documents`가 빈 배열입니다. - 금액은 공급가액·부가세로 나뉘어 있고 품목 라인의 단가는 부가세 별도입니다.  계약을 닫으려면 `POST /v2/bids/{bidRef}/settlement/complete`를 부릅니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let paperCode: number; //거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요. (optional) (default to undefined)
-let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.getBidStatement(
-    bidRef,
-    paperCode,
-    ifNoneMatch
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **paperCode** | [**number**] | 거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요. | (optional) defaults to undefined|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
-
-
-### Return type
-
-**GetBidStatement200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 거래명세서 본문과 발행 메타. 정산 마감 전후 어느 시점에도 조회할 수 있습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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)
-
-# **getKclMroOrderStatus**
-> GetKclMroOrderStatus200Response getKclMroOrderStatus()
-
-중계 테이블에서 이 주문이 어디까지 갔는지 돌려줍니다. 스코프 `orders:read`.  구매요구번호 회신은 씨마켓이 외부 플랫폼에 통지하지만, 그 통지가 유실될 수 있어 되읽을 경로를 함께 둡니다. 방아쇠를 하나만 두면 그 하나가 실패한 날 주문이 영영 멈춥니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let orderNo: string; //조회할 몰 주문의 구매번호입니다. (default to undefined)
-let buyerMemberId: string; //발주기관 회원 ID (default to undefined)
-let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.getKclMroOrderStatus(
-    orderNo,
-    buyerMemberId,
-    ifNoneMatch
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **orderNo** | [**string**] | 조회할 몰 주문의 구매번호입니다. | defaults to undefined|
-| **buyerMemberId** | [**string**] | 발주기관 회원 ID | defaults to undefined|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
-
-
-### Return type
-
-**GetKclMroOrderStatus200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 중계 진행 상태 |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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)
-
-# **getSemoContractTaxinvoiceStatus**
-> SemoContractTaxinvoiceStatusResponseDto getSemoContractTaxinvoiceStatus()
-
-등록한 계약의 계산서 발행 상태를 확인합니다.  **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API로 되읽으세요.  **필수 스코프:** `contracts:read`
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let externalContractId: string; //등록할 때 보낸 파트너 측 계약 식별자. (default to undefined)
-
-const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
-    externalContractId
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **externalContractId** | [**string**] | 등록할 때 보낸 파트너 측 계약 식별자. | defaults to undefined|
-
-
-### Return type
-
-**SemoContractTaxinvoiceStatusResponseDto**
-
-### 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** | 세금계산서 발행 상태. 동결된 엔드포인트라 &#x60;{data}&#x60; 공통 응답 형식을 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-
-[[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)
-
-# **getSupplierCardPayableV2**
-> GetSupplierCardPayableV2200Response getSupplierCardPayableV2()
-
-계약한 공급사가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 공급사로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 공급사의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let memberId: string; //공급사 회원 ID (default to undefined)
-let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.getSupplierCardPayableV2(
-    memberId,
-    ifNoneMatch
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **memberId** | [**string**] | 공급사 회원 ID | defaults to undefined|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
-
-
-### Return type
-
-**GetSupplierCardPayableV2200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 해당 공급사에 카드결제가 가능한지와, 불가하면 그 사유. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
-
-[[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**
-> HealthControllerCheck200Response healthControllerCheck()
-
-ERP 연동 직전 회선·인증 endpoint 동작 확인용.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.healthControllerCheck(
-    ifNoneMatch
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
-
-
-### Return type
-
-**HealthControllerCheck200Response**
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 프로세스가 살아 있음. 의존성은 보지 않습니다(readiness가 그 역할). |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#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)
-
-# **listBidResults**
-> ListBidResults200Response listBidResults()
-
-여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.  낙찰자를 정했으면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
-
-### Example
-
-```typescript
-import {
-    PartnerApiApi,
-    Configuration
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new PartnerApiApi(configuration);
-
-let bidRefs: string; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidRefs`를 반복해 전달합니다. 최대 100건입니다. (default to undefined)
-let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
-
-const { status, data } = await apiInstance.listBidResults(
-    bidRefs,
-    ifNoneMatch
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **bidRefs** | [**string**] | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60;를 반복해 전달합니다. 최대 100건입니다. | defaults to undefined|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
-
-
-### Return type
-
-**ListBidResults200Response**
-
-### Authorization
-
-[partner-oauth2](../README.md#partner-oauth2)
-
-### HTTP request headers
-
- - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 요청한 공고의 응찰 결과 목록. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**302** | 해소된 다운로드 URL로 리다이렉트 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **listBids**
-> ListBids200Response listBids()
+# **getBidStatement**
+> GetBidStatement200Response getBidStatement()
 
-API 키에 연결된 발주기관의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`.  - 발주기관은 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 페이지네이션: `limit`(1~100, 기본 100)과 `cursor`. 응답 `meta.nextCursor`를 다음 요청의 `cursor`로 보내고, `meta.hasMore`가 `false`면 마지막 페이지입니다. - 낙찰 여부는 공고 상태가 아니라 `GET /v2/bid-results`의 `participants[].isWinner`로 판단합니다. `AWARDED` 상태는 없습니다.
+낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).  - 검수완료(`POST /v2/bids/{bidRef}/acceptance`)가 명세서 발행을 예약하므로, 그 전에 부르면 문서가 아직 없어 `documents`가 빈 배열입니다. - 금액은 공급가액·부가세로 나뉘어 있고 품목 라인의 단가는 부가세 별도입니다.  계약을 닫으려면 `POST /v2/bids/{bidRef}/settlement/complete`를 부릅니다.
 
 ### Example
 
@@ -1110,19 +283,13 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let limit: number; //페이지 크기(1~100, 기본 100). (optional) (default to 100)
-let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor`를 그대로 보냅니다. 생략하면 첫 페이지이고, `nextCursor`가 `null`이면 마지막 페이지입니다. (optional) (default to undefined)
-let bidRefs: Array<string>; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. (optional) (default to undefined)
-let status: Array<BidPublicStatus>; //공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다. (optional) (default to undefined)
-let include: Array<'results' | 'products' | 'contacts'>; //행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않습니다(응답이 가볍고 조회 비용도 들지 않습니다). (optional) (default to undefined)
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
+let paperCode: number; //거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요. (optional) (default to undefined)
 let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
-const { status, data } = await apiInstance.listBids(
-    limit,
-    cursor,
-    bidRefs,
-    status,
-    include,
+const { status, data } = await apiInstance.getBidStatement(
+    bidRef,
+    paperCode,
     ifNoneMatch
 );
 ```
@@ -1131,17 +298,14 @@ const { status, data } = await apiInstance.listBids(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **limit** | [**number**] | 페이지 크기(1~100, 기본 100). | (optional) defaults to 100|
-| **cursor** | [**string**] | 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60;를 그대로 보냅니다. 생략하면 첫 페이지이고, &#x60;nextCursor&#x60;가 &#x60;null&#x60;이면 마지막 페이지입니다. | (optional) defaults to undefined|
-| **bidRefs** | **Array&lt;string&gt;** | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. | (optional) defaults to undefined|
-| **status** | **Array&lt;BidPublicStatus&gt;** | 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다. | (optional) defaults to undefined|
-| **include** | **Array<&#39;results&#39; &#124; &#39;products&#39; &#124; &#39;contacts&#39;>** | 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않습니다(응답이 가볍고 조회 비용도 들지 않습니다). | (optional) defaults to undefined|
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
+| **paperCode** | [**number**] | 거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요. | (optional) defaults to undefined|
 | **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
 
-**ListBids200Response**
+**GetBidStatement200Response**
 
 ### Authorization
 
@@ -1156,7 +320,7 @@ const { status, data } = await apiInstance.listBids(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 공고 요약 목록. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
+|**200** | 거래명세서 본문과 발행 메타. 정산 마감 전후 어느 시점에도 조회할 수 있습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
 |**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
@@ -1169,10 +333,10 @@ const { status, data } = await apiInstance.listBids(
 
 [[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)
 
-# **listExternalContractDocuments**
-> ExternalContractDocumentsResponseDto listExternalContractDocuments()
+# **getSemoContractTaxinvoiceStatus**
+> SemoContractTaxinvoiceStatusResponseDto getSemoContractTaxinvoiceStatus()
 
-발주기관 회원과 거래유형으로 그 거래에 필요한 계약서류 목록을 조회합니다. 스코프 `contracts:read`.  공고(입찰)를 거치지 않는 거래에서 씁니다 — 채팅 기반 견적 같은 자리에서, 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때입니다.  목록은 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. 대행 범위 밖 회원을 조회하면 403 입니다(대행 범위는 키 설정이며 스코프와 별개 축입니다).  응답 세 값의 뜻은 이렇습니다.  - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 미리 체크된 상태로 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market이 데이터를 채워 PDF로 만들어 주는 서류입니다. 생성 API의 `paperCodes`에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요.  ---  **응답 형태가 동결된 엔드포인트입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 공통 응답 형식을 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents`가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)를 대체할 새 경로는 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
+등록한 계약의 계산서 발행 상태를 확인합니다.  **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API로 되읽으세요.  **필수 스코프:** `contracts:read`
 
 ### Example
 
@@ -1185,12 +349,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let buyerId: string; //발주기관 회원 ID(c-market memberId). (default to undefined)
-let bidType: 'goods' | 'service' | 'construction' | 'sale'; //거래유형. (default to undefined)
+let externalContractId: string; //등록할 때 보낸 파트너 측 계약 식별자. (default to undefined)
 
-const { status, data } = await apiInstance.listExternalContractDocuments(
-    buyerId,
-    bidType
+const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
+    externalContractId
 );
 ```
 
@@ -1198,13 +360,12 @@ const { status, data } = await apiInstance.listExternalContractDocuments(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **buyerId** | [**string**] | 발주기관 회원 ID(c-market memberId). | defaults to undefined|
-| **bidType** | [**&#39;goods&#39; | &#39;service&#39; | &#39;construction&#39; | &#39;sale&#39;**]**Array<&#39;goods&#39; &#124; &#39;service&#39; &#124; &#39;construction&#39; &#124; &#39;sale&#39;>** | 거래유형. | defaults to undefined|
+| **externalContractId** | [**string**] | 등록할 때 보낸 파트너 측 계약 식별자. | defaults to undefined|
 
 
 ### Return type
 
-**ExternalContractDocumentsResponseDto**
+**SemoContractTaxinvoiceStatusResponseDto**
 
 ### Authorization
 
@@ -1213,28 +374,20 @@ const { status, data } = await apiInstance.listExternalContractDocuments(
 ### HTTP request headers
 
  - **Content-Type**: Not defined
- - **Accept**: application/json, application/problem+json
+ - **Accept**: application/json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 필요 계약서류 목록. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
-|**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
+|**200** | 세금계산서 발행 상태. 동결된 엔드포인트라 &#x60;{data}&#x60; 공통 응답 형식을 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 
 [[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)
 
-# **listSuppliers**
-> ListSuppliers200Response listSuppliers()
+# **getSupplierCardPayableV2**
+> GetSupplierCardPayableV2200Response getSupplierCardPayableV2()
 
-지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 공급사를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 공급사명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
+계약한 공급사가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 공급사로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 공급사의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
 
 ### Example
 
@@ -1247,15 +400,11 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let keyword: string; //공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다. (optional) (default to undefined)
-let cursor: string; //이전 응답의 `meta.nextCursor` 를 그대로 넣습니다. 생략하면 첫 페이지입니다. (optional) (default to undefined)
-let limit: number; //한 번에 받을 최대 건수(1~100). 기본 20건. (optional) (default to 20)
+let memberId: string; //공급사 회원 ID (default to undefined)
 let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
-const { status, data } = await apiInstance.listSuppliers(
-    keyword,
-    cursor,
-    limit,
+const { status, data } = await apiInstance.getSupplierCardPayableV2(
+    memberId,
     ifNoneMatch
 );
 ```
@@ -1264,15 +413,13 @@ const { status, data } = await apiInstance.listSuppliers(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **keyword** | [**string**] | 공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다. | (optional) defaults to undefined|
-| **cursor** | [**string**] | 이전 응답의 &#x60;meta.nextCursor&#x60; 를 그대로 넣습니다. 생략하면 첫 페이지입니다. | (optional) defaults to undefined|
-| **limit** | [**number**] | 한 번에 받을 최대 건수(1~100). 기본 20건. | (optional) defaults to 20|
+| **memberId** | [**string**] | 공급사 회원 ID | defaults to undefined|
 | **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
 
-**ListSuppliers200Response**
+**GetSupplierCardPayableV2200Response**
 
 ### Authorization
 
@@ -1287,7 +434,7 @@ const { status, data } = await apiInstance.listSuppliers(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 활성 공급사 목록. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
+|**200** | 해당 공급사에 카드결제가 가능한지와, 불가하면 그 사유. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
 |**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
@@ -1300,31 +447,26 @@ const { status, data } = await apiInstance.listSuppliers(
 
 [[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**
-> MarkBidFailed201Response markBidFailed(markBidFailedRequestDto)
+# **healthControllerCheck**
+> HealthControllerCheck200Response healthControllerCheck()
 
-공고를 유찰 처리합니다. 입찰 마감 상태에서 호출합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  공고 상태가 유찰(`FAILED`)로 바뀌고 유찰사유가 기록됩니다. 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다).  | `failureReasonCode` | 의미 | | --- | --- | | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | | `OTHER` | 기타(`failureReasonDetail` 필수) |
+ERP 연동 직전 회선·인증 endpoint 동작 확인용.
 
 ### Example
 
 ```typescript
 import {
     PartnerApiApi,
-    Configuration,
-    MarkBidFailedRequestDto
+    Configuration
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let markBidFailedRequestDto: MarkBidFailedRequestDto; //
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
-const { status, data } = await apiInstance.markBidFailed(
-    bidRef,
-    idempotencyKey,
-    markBidFailedRequestDto
+const { status, data } = await apiInstance.healthControllerCheck(
+    ifNoneMatch
 );
 ```
 
@@ -1332,66 +474,55 @@ const { status, data } = await apiInstance.markBidFailed(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
 
-**MarkBidFailed201Response**
+**HealthControllerCheck200Response**
 
 ### Authorization
 
-[partner-oauth2](../README.md#partner-oauth2)
+No authorization required
 
 ### HTTP request headers
 
- - **Content-Type**: application/json
+ - **Content-Type**: Not defined
  - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 유찰 처리 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
-|**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
-|**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
+|**200** | 프로세스가 살아 있음. 의존성은 보지 않습니다(readiness가 그 역할). |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
 
 [[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**
-> RegisterAward201Response registerAward(registerAwardRequestDto)
+# **listBidResults**
+> ListBidResults200Response listBidResults()
 
-낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.  납품 검수가 끝나면 `POST /v2/bids/{bidRef}/acceptance`로 이어집니다.
+여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.  낙찰자를 정했으면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
 
 ### Example
 
 ```typescript
 import {
     PartnerApiApi,
-    Configuration,
-    RegisterAwardRequestDto
+    Configuration
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let registerAwardRequestDto: RegisterAwardRequestDto; //
+let bidRefs: string; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidRefs`를 반복해 전달합니다. 최대 100건입니다. (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
-const { status, data } = await apiInstance.registerAward(
-    bidRef,
-    idempotencyKey,
-    registerAwardRequestDto
+const { status, data } = await apiInstance.listBidResults(
+    bidRefs,
+    ifNoneMatch
 );
 ```
 
@@ -1399,14 +530,13 @@ const { status, data } = await apiInstance.registerAward(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **registerAwardRequestDto** | **RegisterAwardRequestDto**|  | |
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
+| **bidRefs** | [**string**] | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60;를 반복해 전달합니다. 최대 100건입니다. | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
 
-**RegisterAward201Response**
+**ListBidResults200Response**
 
 ### Authorization
 
@@ -1414,19 +544,19 @@ const { status, data } = await apiInstance.registerAward(
 
 ### HTTP request headers
 
- - **Content-Type**: application/json
+ - **Content-Type**: Not defined
  - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 낙찰 등록 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
+|**200** | 요청한 공고의 응찰 결과 목록. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
+|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1434,29 +564,28 @@ 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**
-> RegisterBid201Response registerBid(createBidRequestDto)
+# **listExternalContractDocuments**
+> ExternalContractDocumentsResponseDto listExternalContractDocuments()
 
-공고를 등록합니다. 스코프 `bids:write` · `Idempotency-Key` 헤더 필수.  첨부는 두 방법 중 하나입니다. - `attachments` 원소에 `{ fileName, url }` 또는 `{ fileName, base64 }`를 그대로 넣습니다. - 여러 공고에서 재사용할 파일은 `POST /v2/files`로 먼저 올려 받은 `fileKey`를 넣습니다.  등록한 공고의 응찰 결과는 마감 뒤 `GET /v2/bid-results`로 조회하고, 낙찰자를 정하면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
+발주기관 회원과 거래유형으로 그 거래에 필요한 계약서류 목록을 조회합니다. 스코프 `contracts:read`.  공고(입찰)를 거치지 않는 거래에서 씁니다 — 채팅 기반 견적 같은 자리에서, 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때입니다.  목록은 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. 대행 범위 밖 회원을 조회하면 403 입니다(대행 범위는 키 설정이며 스코프와 별개 축입니다).  응답 세 값의 뜻은 이렇습니다.  - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 미리 체크된 상태로 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market이 데이터를 채워 PDF로 만들어 주는 서류입니다. 생성 API의 `paperCodes`에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요.  ---  **응답 형태가 동결된 엔드포인트입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 공통 응답 형식을 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents`가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)를 대체할 새 경로는 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
 
 ### Example
 
 ```typescript
 import {
     PartnerApiApi,
-    Configuration,
-    CreateBidRequestDto
+    Configuration
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let createBidRequestDto: CreateBidRequestDto; //
+let buyerId: string; //발주기관 회원 ID(c-market memberId). (default to undefined)
+let bidType: 'goods' | 'service' | 'construction' | 'sale'; //거래유형. (default to undefined)
 
-const { status, data } = await apiInstance.registerBid(
-    idempotencyKey,
-    createBidRequestDto
+const { status, data } = await apiInstance.listExternalContractDocuments(
+    buyerId,
+    bidType
 );
 ```
 
@@ -1464,13 +593,13 @@ const { status, data } = await apiInstance.registerBid(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **createBidRequestDto** | **CreateBidRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
+| **buyerId** | [**string**] | 발주기관 회원 ID(c-market memberId). | defaults to undefined|
+| **bidType** | [**&#39;goods&#39; | &#39;service&#39; | &#39;construction&#39; | &#39;sale&#39;**]**Array<&#39;goods&#39; &#124; &#39;service&#39; &#124; &#39;construction&#39; &#124; &#39;sale&#39;>** | 거래유형. | defaults to undefined|
 
 
 ### Return type
 
-**RegisterBid201Response**
+**ExternalContractDocumentsResponseDto**
 
 ### Authorization
 
@@ -1478,19 +607,18 @@ const { status, data } = await apiInstance.registerBid(
 
 ### HTTP request headers
 
- - **Content-Type**: application/json
+ - **Content-Type**: Not defined
  - **Accept**: application/json, application/problem+json
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 공고 등록 완료. 발급된 &#x60;bidId&#x60;(c-market 공고번호)와 보낸 &#x60;purchaseNo&#x60;를 함께 돌려주므로 이후 조회에 어느 쪽을 써도 됩니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
+|**200** | 필요 계약서류 목록. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60;. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
+|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1498,10 +626,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)
 
-# **registerSemoContract**
-> SemoContractRegisteredResponseDto registerSemoContract(registerSemoContractRequestDto)
+# **markBidFailed**
+> MarkBidFailed201Response markBidFailed(markBidFailedRequestDto)
 
-외부에서 맺어진 계약 1건을 씨마켓의 세금계산서 발행 대상으로 등록합니다. 스코프 `contracts:write`.  등록하면 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 공급자는 공급기업, 공급받는자는 발주기관입니다. 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다.  - **`supplyPrice` 는 부가세를 뺀 과세 공급가액입니다.** 결제창 API가 부가세 포함가를 받는 것과 다릅니다. 과세·면세 공급가액이 모두 0 이면 400 입니다. - 두 회원 ID가 씨마켓에 실재해야 합니다. 회원 ID가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. - 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. - 멱등키는 `externalContractId` 입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
+공고를 유찰 처리합니다. 입찰 마감 상태에서 호출합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  공고 상태가 유찰(`FAILED`)로 바뀌고 유찰사유가 기록됩니다. 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다).  | `failureReasonCode` | 의미 | | --- | --- | | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | | `OTHER` | 기타(`failureReasonDetail` 필수) |
 
 ### Example
 
@@ -1509,18 +637,20 @@ const { status, data } = await apiInstance.registerBid(
 import {
     PartnerApiApi,
     Configuration,
-    RegisterSemoContractRequestDto
+    MarkBidFailedRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let registerSemoContractRequestDto: RegisterSemoContractRequestDto; //
+let markBidFailedRequestDto: MarkBidFailedRequestDto; //
 
-const { status, data } = await apiInstance.registerSemoContract(
+const { status, data } = await apiInstance.markBidFailed(
+    bidRef,
     idempotencyKey,
-    registerSemoContractRequestDto
+    markBidFailedRequestDto
 );
 ```
 
@@ -1528,13 +658,14 @@ const { status, data } = await apiInstance.registerSemoContract(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **registerSemoContractRequestDto** | **RegisterSemoContractRequestDto**|  | |
+| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**|  | |
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
 
 
 ### Return type
 
-**SemoContractRegisteredResponseDto**
+**MarkBidFailed201Response**
 
 ### Authorization
 
@@ -1549,7 +680,7 @@ const { status, data } = await apiInstance.registerSemoContract(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 외부 계약 등록 완료. 동결된 엔드포인트라 &#x60;{data}&#x60; 공통 응답 형식을 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**201** | 유찰 처리 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1562,10 +693,10 @@ const { status, data } = await apiInstance.registerSemoContract(
 
 [[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)
 
-# **relayKclMroOrder**
-> RelayKclMroOrder200Response relayKclMroOrder(relayKclMroOrderRequestDto)
+# **registerAward**
+> RegisterAward201Response registerAward(registerAwardRequestDto)
 
-자체몰 주문의 **견적 마감 결과**를 기관 ERP 가 읽는 중계 테이블에 적재합니다. 스코프 `orders:write`.  자체몰 주문은 곧바로 오지 않습니다 — 외부 플랫폼의 견적 공고로 올라가 경쟁을 거치고, 마감된 뒤에 그 결과가 옵니다. 품목·수량은 담은 그대로이고 `quoteResult` 가 「얼마에 · 누구에게서」를 말합니다. **응답이 0건이어도 보냅니다** — 그 사실이 가야 담당자가 다시 올릴지 정합니다.  - **멱등입니다.** 같은 `orderNo` 로 다시 보내면 `reused=true` 로 돌려주고 **덮어쓰지 않습니다.** 기관 ERP 가 이미 가져간 뒤에 내용이 바뀌면 구매요구와 중계 테이블이 서로 다른 값을 갖게 되기 때문입니다. - **단가의 세금 축을 반드시 보내십시오**(`priceTaxType`). 씨마켓이 기관 ERP 가 기대하는 축으로 변환해 채웁니다. 면세·영세 품목은 변환하지 않습니다. - **적재된 주문은 아직 계약이 아닙니다.** 계약은 발주기관이 견적 중 하나를 골라야 섭니다 — 이 행은 기관 ERP 가 구매요구를 만들 재료입니다.
+낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.  납품 검수가 끝나면 `POST /v2/bids/{bidRef}/acceptance`로 이어집니다.
 
 ### Example
 
@@ -1573,18 +704,20 @@ const { status, data } = await apiInstance.registerSemoContract(
 import {
     PartnerApiApi,
     Configuration,
-    RelayKclMroOrderRequestDto
+    RegisterAwardRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
+let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let relayKclMroOrderRequestDto: RelayKclMroOrderRequestDto; //
+let registerAwardRequestDto: RegisterAwardRequestDto; //
 
-const { status, data } = await apiInstance.relayKclMroOrder(
+const { status, data } = await apiInstance.registerAward(
+    bidRef,
     idempotencyKey,
-    relayKclMroOrderRequestDto
+    registerAwardRequestDto
 );
 ```
 
@@ -1592,13 +725,14 @@ const { status, data } = await apiInstance.relayKclMroOrder(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **relayKclMroOrderRequestDto** | **RelayKclMroOrderRequestDto**|  | |
+| **registerAwardRequestDto** | **RegisterAwardRequestDto**|  | |
+| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
 
 
 ### Return type
 
-**RelayKclMroOrder200Response**
+**RegisterAward201Response**
 
 ### Authorization
 
@@ -1613,7 +747,7 @@ const { status, data } = await apiInstance.relayKclMroOrder(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 적재 결과 |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**201** | 낙찰 등록 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1626,10 +760,10 @@ const { status, data } = await apiInstance.relayKclMroOrder(
 
 [[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)
 
-# **requestInvoiceSplit**
-> RequestInvoiceSplit200Response requestInvoiceSplit(requestInvoiceSplitRequestDto)
+# **registerBid**
+> RegisterBid201Response registerBid(createBidRequestDto)
 
-한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write` · `Idempotency-Key` 헤더 필수.  - 청구만 접수합니다. 발행은 정산 파이프라인이 처리하며 진행 여부는 `GET /v2/bids/{bidRef}`의 `taxInvoiceRequested`로 확인합니다. - `supplyAmount`와 `vat`는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 **새 `Idempotency-Key`**로 한 번 더 청구합니다. 같은 키는 앞선 청구의 응답을 그대로 돌려줍니다. - `issueDate`는 선택이며 미래 일자는 400입니다.
+공고를 등록합니다. 스코프 `bids:write` · `Idempotency-Key` 헤더 필수.  첨부는 두 방법 중 하나입니다. - `attachments` 원소에 `{ fileName, url }` 또는 `{ fileName, base64 }`를 그대로 넣습니다. - 여러 공고에서 재사용할 파일은 `POST /v2/files`로 먼저 올려 받은 `fileKey`를 넣습니다.  등록한 공고의 응찰 결과는 마감 뒤 `GET /v2/bid-results`로 조회하고, 낙찰자를 정하면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
 
 ### Example
 
@@ -1637,20 +771,18 @@ const { status, data } = await apiInstance.relayKclMroOrder(
 import {
     PartnerApiApi,
     Configuration,
-    RequestInvoiceSplitRequestDto
+    CreateBidRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let requestInvoiceSplitRequestDto: RequestInvoiceSplitRequestDto; //
+let createBidRequestDto: CreateBidRequestDto; //
 
-const { status, data } = await apiInstance.requestInvoiceSplit(
-    bidRef,
+const { status, data } = await apiInstance.registerBid(
     idempotencyKey,
-    requestInvoiceSplitRequestDto
+    createBidRequestDto
 );
 ```
 
@@ -1658,14 +790,13 @@ const { status, data } = await apiInstance.requestInvoiceSplit(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **requestInvoiceSplitRequestDto** | **RequestInvoiceSplitRequestDto**|  | |
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
+| **createBidRequestDto** | **CreateBidRequestDto**|  | |
 | **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
 
 
 ### Return type
 
-**RequestInvoiceSplit200Response**
+**RegisterBid201Response**
 
 ### Authorization
 
@@ -1680,7 +811,7 @@ const { status, data } = await apiInstance.requestInvoiceSplit(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 청구 접수 결과. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**201** | 공고 등록 완료. 발급된 &#x60;bidId&#x60;(c-market 공고번호)와 보낸 &#x60;purchaseNo&#x60;를 함께 돌려주므로 이후 조회에 어느 쪽을 써도 됩니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1693,10 +824,10 @@ const { status, data } = await apiInstance.requestInvoiceSplit(
 
 [[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)
 
-# **revertAward**
-> RevertAward200Response revertAward(revertAwardRequestDto)
+# **registerSemoContract**
+> SemoContractRegisteredResponseDto registerSemoContract(registerSemoContractRequestDto)
 
-확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수.  **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다.  **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다)  **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다.  **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
+외부에서 맺어진 계약 1건을 씨마켓의 세금계산서 발행 대상으로 등록합니다. 스코프 `contracts:write`.  등록하면 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 공급자는 공급기업, 공급받는자는 발주기관입니다. 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다.  - **`supplyPrice` 는 부가세를 뺀 과세 공급가액입니다.** 결제창 API가 부가세 포함가를 받는 것과 다릅니다. 과세·면세 공급가액이 모두 0 이면 400 입니다. - 두 회원 ID가 씨마켓에 실재해야 합니다. 회원 ID가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. - 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. - 멱등키는 `externalContractId` 입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
 
 ### Example
 
@@ -1704,20 +835,18 @@ const { status, data } = await apiInstance.requestInvoiceSplit(
 import {
     PartnerApiApi,
     Configuration,
-    RevertAwardRequestDto
+    RegisterSemoContractRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
 let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let revertAwardRequestDto: RevertAwardRequestDto; //
+let registerSemoContractRequestDto: RegisterSemoContractRequestDto; //
 
-const { status, data } = await apiInstance.revertAward(
-    bidRef,
+const { status, data } = await apiInstance.registerSemoContract(
     idempotencyKey,
-    revertAwardRequestDto
+    registerSemoContractRequestDto
 );
 ```
 
@@ -1725,14 +854,13 @@ const { status, data } = await apiInstance.revertAward(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **revertAwardRequestDto** | **RevertAwardRequestDto**|  | |
-| **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
+| **registerSemoContractRequestDto** | **RegisterSemoContractRequestDto**|  | |
 | **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
 
 
 ### Return type
 
-**RevertAward200Response**
+**SemoContractRegisteredResponseDto**
 
 ### Authorization
 
@@ -1747,7 +875,7 @@ const { status, data } = await apiInstance.revertAward(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 낙찰 되돌리기 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**200** | 외부 계약 등록 완료. 동결된 엔드포인트라 &#x60;{data}&#x60; 공통 응답 형식을 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1760,10 +888,10 @@ const { status, data } = await apiInstance.revertAward(
 
 [[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**
-> UpdateBid200Response updateBid(updateBidRequestDto)
+# **requestInvoiceSplit**
+> RequestInvoiceSplit200Response requestInvoiceSplit(requestInvoiceSplitRequestDto)
 
-등록된 공고의 내용을 수정합니다. 스코프 `bids:write` · `Idempotency-Key` 헤더 필수.  - 진행중·초안 상태만 수정할 수 있습니다. 마감·취소된 공고는 거부됩니다. - 낙찰방법(`awardMethod`)은 수정할 수 없고, 참여자가 있으면 입찰방식·면허·예산·품목 일부가 잠깁니다. - 한 섹션을 수정하려면 그 섹션의 필수 필드를 함께 보냅니다. - `hideEditHistory=true`면 변경이력을 비공개로 남기고 노출 카운터를 올리지 않습니다.
+한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write` · `Idempotency-Key` 헤더 필수.  - 청구만 접수합니다. 발행은 정산 파이프라인이 처리하며 진행 여부는 `GET /v2/bids/{bidRef}`의 `taxInvoiceRequested`로 확인합니다. - `supplyAmount`와 `vat`는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 **새 `Idempotency-Key`**로 한 번 더 청구합니다. 같은 키는 앞선 청구의 응답을 그대로 돌려줍니다. - `issueDate`는 선택이며 미래 일자는 400입니다.
 
 ### Example
 
@@ -1771,22 +899,20 @@ const { status, data } = await apiInstance.revertAward(
 import {
     PartnerApiApi,
     Configuration,
-    UpdateBidRequestDto
+    RequestInvoiceSplitRequestDto
 } from '@cmarket/partner-sdk';
 
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let ifMatch: string; //수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidRef}` 응답의 `ETag` 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412로 거절되며 아무것도 수정되지 않습니다. (default to undefined)
 let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
-let updateBidRequestDto: UpdateBidRequestDto; //
+let requestInvoiceSplitRequestDto: RequestInvoiceSplitRequestDto; //
 
-const { status, data } = await apiInstance.updateBid(
+const { status, data } = await apiInstance.requestInvoiceSplit(
     bidRef,
-    ifMatch,
     idempotencyKey,
-    updateBidRequestDto
+    requestInvoiceSplitRequestDto
 );
 ```
 
@@ -1794,15 +920,14 @@ const { status, data } = await apiInstance.updateBid(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **updateBidRequestDto** | **UpdateBidRequestDto**|  | |
+| **requestInvoiceSplitRequestDto** | **RequestInvoiceSplitRequestDto**|  | |
 | **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **ifMatch** | [**string**] | 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412로 거절되며 아무것도 수정되지 않습니다. | defaults to undefined|
 | **idempotencyKey** | [**string**] | 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
 
 
 ### Return type
 
-**UpdateBid200Response**
+**RequestInvoiceSplit200Response**
 
 ### Authorization
 
@@ -1817,14 +942,12 @@ const { status, data } = await apiInstance.updateBid(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 공고 수정 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**200** | 청구 접수 결과. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
 |**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
-|**412** | &#x60;If-Match&#x60; 값이 현재 리소스와 다름(&#x60;…/precondition-failed&#x60;). 다시 조회해 최신 &#x60;ETag&#x60;로 재시도합니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
-|**428** | &#x60;If-Match&#x60; 헤더 누락(&#x60;…/if-match-required&#x60;). |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |