@cmarket/partner-sdk 35.1.0 → 36.1.0

package/docs/PaymentMethodPublic.md

@@ -0,0 +1,11 @@
+# PaymentMethodPublic
+
+결제 방법(공개값). 미지정이면 null.
+
+## Enum
+
+* `Cash` (value: `'CASH'`)
+
+* `Card` (value: `'CARD'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/PreconditionsDto.md

@@ -10,11 +10,9 @@ Name | Type | Description | Notes
 **distributor** | **boolean** | 총판/대리점 자격 제한. | [optional] [default to undefined]
 **manufacturer** | **boolean** | 제조사 자격 제한. | [optional] [default to undefined]
 **directProduction** | **boolean** | 직접생산확인증명 보유 업체로 제한. | [optional] [default to undefined]
-**legalMandatory** | **Array<string>** | 법적의무구매 대상 코드. I=중증장애인생산품, K=중소기업, L=여성기업, O1=장애인표준사업장, O2=장애인기업, O3=사회적협동조합. | [optional] [default to undefined]
-**excellentProcurement** | **Array<string>** | 기술개발제품 인증 코드. P0=전체, P101~P113=개별 인증(우수조달물품·NEP·GS·성능인증 등). | [optional] [default to undefined]
-**greenProduct** | **Array<string>** | 녹색제품 인증 코드. Q0=전체, Q101=환경표지, Q102=저탄소, Q103=우수재활용(GR). | [optional] [default to undefined]
-**startup** | **boolean** | 창업기업 자격 제한. | [optional] [default to undefined]
-**social** | **boolean** | 사회적기업 자격 제한. | [optional] [default to undefined]
+**legalMandatory** | [**Array<LegalMandatoryPublic>**](LegalMandatoryPublic.md) | 법적의무구매 대상. SEVERE_DISABLED=중증장애인생산품, DISABLED_STANDARD=장애인표준사업장, DISABLED_ENTERPRISE=장애인기업, SOCIAL_COOP=사회적협동조합, WOMEN_ENTERPRISE=여성기업, STARTUP=창업기업, SOCIAL_ENTERPRISE=사회적기업, SME_ENTERPRISE=중소기업. | [optional] [default to undefined]
+**excellentProcurement** | [**Array<ExcellentProcurementPublic>**](ExcellentProcurementPublic.md) | 기술개발제품 인증. TECH_PRODUCT_ALL=전체, 그 외는 개별 인증(EXCELLENT_PROCUREMENT=우수조달물품지정, NEP=신제품인증, GS=GS인증, PERFORMANCE=성능인증, NET=신기술인증 등). | [optional] [default to undefined]
+**greenProduct** | [**Array<GreenProductPublic>**](GreenProductPublic.md) | 녹색제품 인증. GREEN_PRODUCT_ALL=전체, ECO_LABEL=환경표지, LOW_CARBON=저탄소제품, GR_CERT=우수재활용(GR)인증. | [optional] [default to undefined]
 
 ## Example
 
@@ -30,8 +28,6 @@ const instance: PreconditionsDto = {
     legalMandatory,
     excellentProcurement,
     greenProduct,
-    startup,
-    social,
 };
 ```
 

package/docs/ProblemDetailsDto.md

@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 **status** | **number** | HTTP 상태 코드. | [default to undefined]
 **detail** | **string** | 에러 상세 설명(human-readable). ValidationPipe 오류 시 세미콜론 구분 목록. | [default to undefined]
 **instance** | **string** | 요청 경로(에러 발생 URI). | [optional] [default to undefined]
-**retryable** | **boolean** | 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도 가능, `false`(그 외 4xx)면 요청을 고쳐야 한다. `Retry-After` 헤더가 있으면 그 대기값을 존중한다. | [default to undefined]
+**retryable** | **boolean** | 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도 가능, `false`(그 외 4xx)면 요청을 고쳐야 합니다. `Retry-After` 헤더가 있으면 그 대기값을 존중하세요. | [default to undefined]
 **traceId** | **string** | 요청 추적 id — `X-Correlation-Id` 응답 헤더와 같은 값입니다. 문의할 때 이 값을 첨부하세요. | [optional] [default to undefined]
 **correlationId** | **string** | `traceId` 와 같은 값의 옛 이름입니다. 기존 연동 호환으로 함께 실립니다 — 새 연동은 `traceId` 를 읽으세요. | [optional] [default to undefined]
 **invalid_params** | [**Array<InvalidParamDto>**](InvalidParamDto.md) | RFC 9457 확장 — 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(값 없음). 그 외 에러엔 부재. | [optional] [default to undefined]

package/docs/ProductReceiptResponseDto.md

@@ -0,0 +1,20 @@
+# ProductReceiptResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**acknowledged** | **number** | 전송완료로 표시된 물품 수입니다. 요청한 수보다 적으면 이미 표시됐거나 기관 범위 밖인 물품이 섞여 있다는 뜻입니다. | [default to undefined]
+
+## Example
+
+```typescript
+import { ProductReceiptResponseDto } from '@cmarket/partner-sdk';
+
+const instance: ProductReceiptResponseDto = {
+    acknowledged,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ProductResponseDto.md

@@ -0,0 +1,50 @@
+# ProductResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**productCode** | **number** | 물품 코드. 수신확인(`POST /v2/products/receipts`)에 이 값을 되돌려주세요. | [default to undefined]
+**productName** | **string** | 물품명. | [default to undefined]
+**itemCode** | **string** | 품목코드 — 발주기관 ERP 의 품번과 대조하는 축입니다. | [default to undefined]
+**spec** | **string** | 규격. | [default to undefined]
+**unit** | **string** | 단위. | [default to undefined]
+**capacity** | **string** | 용량. | [default to undefined]
+**capacityCode** | **number** | 용량 코드. | [default to undefined]
+**unitPrice** | **number** | 단가(원). | [default to undefined]
+**brandName** | **string** | 브랜드명. | [default to undefined]
+**casNumber** | **string** | CAS 번호(화학물질 식별번호). 해당 없으면 빈 문자열. | [default to undefined]
+**categoryName** | **string** | 분류명. 해당 없으면 빈 문자열. | [default to undefined]
+**categoryCode** | **string** | 분류 코드. 해당 없으면 빈 문자열. | [default to undefined]
+**institutionCategoryCode** | **string** | 발주기관 카테고리 코드(기관이 정의한 분류 체계의 코드). | [default to undefined]
+**imageUrl** | **string** | 대표 이미지 주소. 만료되지 않는 안정 주소라 그대로 저장해도 됩니다 — 요청 시점에 실제 저장소로 302 됩니다. 이미지가 없는 물품은 공용 빈 이미지가 내려갑니다. | [default to undefined]
+**thumbnailUrl** | **string** | 썸네일 주소. 외부 도메인에 원본이 있는 물품은 그 주소를 그대로 내보내므로 이 필드만 호스트가 다를 수 있습니다. | [default to undefined]
+**supplierMemberId** | **string** | 물품을 등록한 공급사 회원 ID. 기관에 따라 포함되지 않습니다. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { ProductResponseDto } from '@cmarket/partner-sdk';
+
+const instance: ProductResponseDto = {
+    productCode,
+    productName,
+    itemCode,
+    spec,
+    unit,
+    capacity,
+    capacityCode,
+    unitPrice,
+    brandName,
+    casNumber,
+    categoryName,
+    categoryCode,
+    institutionCategoryCode,
+    imageUrl,
+    thumbnailUrl,
+    supplierMemberId,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ProductsApi.md

@@ -0,0 +1,124 @@
+# ProductsApi
+
+All URIs are relative to *https://partner-api.c-market.net*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**acknowledgeProductReceipt**](#acknowledgeproductreceipt) | **POST** /v2/products/receipts | 물품 수신확인|
+|[**listProducts**](#listproducts) | **GET** /v2/products | 물품 카탈로그 조회|
+
+# **acknowledgeProductReceipt**
+> AcknowledgeProductReceipt200Response acknowledgeProductReceipt(acknowledgeProductsRequestDto)
+
+저장을 마친 물품을 전송완료로 표시해 다음 조회에서 제외합니다.  **되돌릴 수 없습니다.** 표시한 물품은 `GET /v2/products` 로 다시 내려오지 않으므로, 자기 시스템에 저장이 끝난 뒤에 호출하세요.  **표시 범위는 기관 그룹으로 잠깁니다.** 다른 기관의 물품 코드를 섞어 보내면 그 건은 표시되지 않고 `acknowledged` 가 요청 수보다 작게 돌아옵니다.  **필수 스코프:** `products:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+
+### Example
+
+```typescript
+import {
+    ProductsApi,
+    Configuration,
+    AcknowledgeProductsRequestDto
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new ProductsApi(configuration);
+
+let idempotencyKey: string; //멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다. (default to undefined)
+let acknowledgeProductsRequestDto: AcknowledgeProductsRequestDto; //
+
+const { status, data } = await apiInstance.acknowledgeProductReceipt(
+    idempotencyKey,
+    acknowledgeProductsRequestDto
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **acknowledgeProductsRequestDto** | **AcknowledgeProductsRequestDto**|  | |
+| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다. | defaults to undefined|
+
+
+### Return type
+
+**AcknowledgeProductReceipt200Response**
+
+### 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** | 수신확인 결과. |  -  |
+|**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 요청 내용이 유효하지 않음(`…/upstream-invalid-input`). |  -  |
+|**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
+|**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라이언트 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키의 대행 범위 밖(`…/buyer-scope-mismatch` — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(`…/upstream-forbidden`). |  -  |
+|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(`type: …/idempotency-key-conflict` — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 현재 상태와 충돌하는 요청(`…/upstream-conflict`). |  -  |
+|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(`type: …/idempotency-key-reused`). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. 형식은 맞지만 내용상 처리할 수 없는 요청(`…/upstream-unprocessable`)도 이 상태다. |  -  |
+|**429** | rate limit 초과(`type: …/too-many-requests`) — 전역 60/min per client_id. `Retry-After` + `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더 참조. `retryable: true`. |  -  |
+|**500** | 서버 내부 오류(`type: …/internal-server-error`). `retryable: true`. |  -  |
+|**502** | 요청을 처리하지 못했습니다(`type: …/upstream-rejected`). `retryable: true`. |  -  |
+|**503** | 일시적으로 처리할 수 없습니다(`type: …/service-unavailable`). `Retry-After` 헤더 참조. `retryable: true`. |  -  |
+
+[[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)
+
+# **listProducts**
+> ListProducts200Response listProducts()
+
+기관에 공유된 물품 중 **아직 전송되지 않은 것**을 조회합니다.  **증분 피드입니다.** 가져간 물품을 `POST /v2/products/receipts` 로 수신확인하면 다음 조회 결과에서 빠집니다. 수신확인을 하지 않으면 같은 물품이 계속 내려옵니다.  **권장 흐름:** 조회 → 자기 시스템에 저장 → 저장에 성공한 물품 코드만 수신확인. 저장 전에 수신확인하면 그 물품은 다시 받을 수 없습니다.  **조회 범위:** 요청 키가 대행하는 기관 그룹입니다. 기관 그룹이 설정되지 않은 키는 403 입니다.  **필수 스코프:** `products:read`
+
+### Example
+
+```typescript
+import {
+    ProductsApi,
+    Configuration
+} from '@cmarket/partner-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new ProductsApi(configuration);
+
+const { status, data } = await apiInstance.listProducts();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**ListProducts200Response**
+
+### 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** | 미전송 물품 목록. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
+|**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
+|**404** | 대상을 찾을 수 없습니다(&#x60;type: …/upstream-not-found&#x60;). |  -  |
+|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. &#x60;Retry-After&#x60; + &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  -  |
+|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
+|**502** | 요청을 처리하지 못했습니다(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
+|**503** | 일시적으로 처리할 수 없습니다(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#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)
+

package/docs/RegisterAwardRequestDto.md

@@ -6,8 +6,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **winnerMemberId** | **string** | 낙찰자(공급사) 회원 ID. winnerSequence 가 없으면 필수(낙찰자 식별). winnerSequence 가 있으면 생략 가능. | [optional] [default to undefined]
-**winnerSequence** | **number** | 낙찰자 응찰 순번(낙찰 결과 조회의 sequence). 복수 응찰 시 정확한 응찰 건을 지정한다. 없으면 winnerMemberId 로 첫 응찰 건을 해소한다. | [optional] [default to undefined]
-**deliveryDateOverride** | **string** | 납품희망일 override(YYYY-MM-DD). 지정하면 공고의 납품일자를 이 값으로 덮어쓴다. 없으면 공고 등록 시 지정한 납품일자를 유지한다. | [optional] [default to undefined]
+**winnerSequence** | **number** | 낙찰자 응찰 순번(낙찰 결과 조회의 sequence). 복수 응찰 시 정확한 응찰 건을 지정합니다. 없으면 winnerMemberId 로 첫 응찰 건을 해소합니다. | [optional] [default to undefined]
+**deliveryDateOverride** | **string** | 납품희망일 override(YYYY-MM-DD). 지정하면 공고의 납품일자를 이 값으로 덮어쓴다. 없으면 공고 등록 시 지정한 납품일자를 유지합니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/RequestInvoiceSplit200Response.md

@@ -0,0 +1,22 @@
+# RequestInvoiceSplit200Response
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | [**InvoiceSplitResponseDto**](InvoiceSplitResponseDto.md) |  | [default to undefined]
+**meta** | **{ [key: string]: any; }** | 부가 정보. 목록 응답의 커서(`nextCursor`·`hasMore`)처럼 리소스 자체가 아닌 값이 실립니다. 실을 것이 없으면 이 키는 나가지 않습니다. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { RequestInvoiceSplit200Response } from '@cmarket/partner-sdk';
+
+const instance: RequestInvoiceSplit200Response = {
+    data,
+    meta,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/RequestInvoiceSplitRequestDto.md

@@ -0,0 +1,24 @@
+# RequestInvoiceSplitRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**supplyAmount** | **number** | 분할 발급할 공급가액(원). | [default to undefined]
+**vat** | **number** | 분할 발급할 부가세(원). 면세면 0 입니다. | [default to undefined]
+**issueDate** | **string** | 발급 희망일(`YYYY-MM-DD`). 미지정 시 서버 기본값을 씁니다. 미래 일자는 400 으로 거절됩니다. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { RequestInvoiceSplitRequestDto } from '@cmarket/partner-sdk';
+
+const instance: RequestInvoiceSplitRequestDto = {
+    supplyAmount,
+    vat,
+    issueDate,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/StatementProductDto.md

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

package/docs/SubmitNegotiationScores201Response.md

@@ -0,0 +1,22 @@
+# SubmitNegotiationScores201Response
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | [**NegotiationScoredV2ResponseDto**](NegotiationScoredV2ResponseDto.md) |  | [default to undefined]
+**meta** | **{ [key: string]: any; }** | 부가 정보. 목록 응답의 커서(`nextCursor`·`hasMore`)처럼 리소스 자체가 아닌 값이 실립니다. 실을 것이 없으면 이 키는 나가지 않습니다. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { SubmitNegotiationScores201Response } from '@cmarket/partner-sdk';
+
+const instance: SubmitNegotiationScores201Response = {
+    data,
+    meta,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/SubmitNegotiationScoresRequestDto.md

@@ -0,0 +1,22 @@
+# SubmitNegotiationScoresRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**scores** | [**Set<NegotiationScoreDto>**](NegotiationScoreDto.md) | 응찰자별 점수 배열. sequence(응찰 순번) 키, 1명 이상·중복 불가. | [default to undefined]
+**complete** | **boolean** | true 면 점수 입력 직후 평가완료 게이트까지 적용(낙찰 진입 가능). 생략 시 점수만 입력. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { SubmitNegotiationScoresRequestDto } from '@cmarket/partner-sdk';
+
+const instance: SubmitNegotiationScoresRequestDto = {
+    scores,
+    complete,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/UpdateBidRequestDto.md

@@ -23,7 +23,7 @@ Name | Type | Description | Notes
 **qualificationStyle** | **string** | 참가자격 유형. OPEN_NATIONWIDE=전국경쟁, REGION_PROVINCE=광역시도 지역제한, REGION_DISTRICT=시군구 지역제한. | [optional] [default to undefined]
 **selectedRegions** | [**Array<HierarchicalRegionDto>**](HierarchicalRegionDto.md) | 지역제한 지역 목록 (qualificationStyle=REGION_PROVINCE/REGION_DISTRICT 시 사용). | [optional] [default to undefined]
 **requiredLicenses** | **Array<string>** | 필수 면허 코드 목록. | [optional] [default to undefined]
-**preconditionDesc** | **string** | 자격조건 추가 기입 (최대 1000자). | [optional] [default to undefined]
+**preconditionDescription** | **string** | 자격조건 추가 기입 (최대 1000자). | [optional] [default to undefined]
 **preconditions** | [**PreconditionsDto**](PreconditionsDto.md) | 참가자격 조건 구조체 (입찰보증금·법적의무구매·기술개발제품·녹색제품 등). | [optional] [default to undefined]
 **deliveryDateType** | **string** | 납품기한 유형. FIXED_DATE=직접설정(deliveryDate 필요), DAYS_AFTER_CONTRACT=계약후지정(deliveryPeriodDays 필요), NEGOTIATED_AFTER_CONTRACT=계약후협의. | [optional] [default to undefined]
 **deliveryDate** | **string** | 납품기한 일자 (deliveryDateType=FIXED_DATE 시 사용). | [optional] [default to undefined]
@@ -37,16 +37,16 @@ Name | Type | Description | Notes
 **isNegotiatedContract** | **boolean** | 수의계약 여부. true=수의계약, false=일반. | [optional] [default to undefined]
 **bidType** | **string** | 입찰방식. ELECTRONIC=전자입찰(기본), REVERSE_AUCTION=역경매. 공사/용역/매각은 전자입찰로 강제됩니다. | [optional] [default to undefined]
 **isAnnualContract** | **boolean** | 연간계약 여부. true=연간계약, false=일반. | [optional] [default to undefined]
-**nominatedContract** | **boolean** | 지명계약 여부. true=지명계약(등록 시 초안 상태로 저장되어 별도 게시가 필요), false=일반. 지명업체 목록은 미지원(true/false 플래그만). | [optional] [default to undefined]
-**empId** | **string** | 발주기관 담당자 식별자. | [optional] [default to undefined]
+**isNominatedContract** | **boolean** | 지명계약 여부. true=지명계약(등록 시 초안 상태로 저장되어 별도 게시가 필요), false=일반. 지명업체 목록은 미지원(true/false 플래그만). | [optional] [default to undefined]
+**buyerManagerId** | **string** | 발주기관 담당자 식별자. | [optional] [default to undefined]
 **purchaseNo** | **string** | 발주처 지정 조달번호 (외부 ERP 자체 PO 번호). 동일 PO 의 선행 입찰이 전부 취소/유찰이면 재입찰로 새 번호가 채번되고, 진행 중이면 중복으로 거부됩니다. | [optional] [default to undefined]
 **isResultPublished** | **boolean** | 결과 공개 여부. true=공개, false=비공개. | [optional] [default to undefined]
 **contractManager** | [**BidManagerDto**](BidManagerDto.md) | 계약 담당자. | [optional] [default to undefined]
 **techManager** | [**BidManagerDto**](BidManagerDto.md) | 기술 담당자. | [optional] [default to undefined]
 **bidStartAt** | **string** | 입찰 시작 일시(ISO-8601 UTC). | [optional] [default to undefined]
 **bidEndAt** | **string** | 입찰 마감 일시(ISO-8601 UTC). | [optional] [default to undefined]
-**editContent** | **string** | 변경이력 본문 (구매자가 작성한 수정 사유). | [optional] [default to undefined]
-**hideEdit** | **boolean** | true 면 변경이력을 공개에서 숨기고 노출 카운터 증가도 생략. 기본 false(공개). | [optional] [default to undefined]
+**editReason** | **string** | 변경이력 본문 (구매자가 작성한 수정 사유). | [optional] [default to undefined]
+**hideEditHistory** | **boolean** | true 면 변경이력을 공개에서 숨기고 노출 카운터 증가도 생략. 기본 false(공개). | [optional] [default to undefined]
 
 ## Example
 
@@ -72,7 +72,7 @@ const instance: UpdateBidRequestDto = {
     qualificationStyle,
     selectedRegions,
     requiredLicenses,
-    preconditionDesc,
+    preconditionDescription,
     preconditions,
     deliveryDateType,
     deliveryDate,
@@ -86,16 +86,16 @@ const instance: UpdateBidRequestDto = {
     isNegotiatedContract,
     bidType,
     isAnnualContract,
-    nominatedContract,
-    empId,
+    isNominatedContract,
+    buyerManagerId,
     purchaseNo,
     isResultPublished,
     contractManager,
     techManager,
     bidStartAt,
     bidEndAt,
-    editContent,
-    hideEdit,
+    editReason,
+    hideEditHistory,
 };
 ```
 

package/docs/UploadFileRequestDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**fileName** | **string** | 파일명 (확장자 포함). 최대 255자. 허용 형식: PDF, HWP, HWPX, HWT, DOC, DOCX, XLS, XLSX, CELL, PPT, PPTX, SHOW, TXT, CSV, ZIP, JPG, JPEG, PNG, GIF, BMP, TIFF, TIF, DWG, DXF, STEP, STP, IGES, IGS, STL (accept: `.pdf,.hwp,.hwpx,.hwt,.doc,.docx,.xls,.xlsx,.cell,.ppt,.pptx,.show,.txt,.csv,.zip,.jpg,.jpeg,.png,.gif,.bmp,.tiff,.tif,.dwg,.dxf,.step,.stp,.iges,.igs,.stl`). 그 외 확장자는 backend 에서 거부된다. | [default to undefined]
+**fileName** | **string** | 파일명입니다(확장자 포함, 최대 255자). 허용 형식: PDF, HWP, HWPX, HWT, DOC, DOCX, XLS, XLSX, CELL, PPT, PPTX, SHOW, TXT, CSV, ZIP, JPG, JPEG, PNG, GIF, BMP, TIFF, TIF, DWG, DXF, STEP, STP, IGES, IGS, STL (accept: `.pdf,.hwp,.hwpx,.hwt,.doc,.docx,.xls,.xlsx,.cell,.ppt,.pptx,.show,.txt,.csv,.zip,.jpg,.jpeg,.png,.gif,.bmp,.tiff,.tif,.dwg,.dxf,.step,.stp,.iges,.igs,.stl`). 그 외 확장자는 거부됩니다. | [default to undefined]
 **base64** | **string** | Base64 인코딩된 파일 데이터. url 이 없을 때 필수. 디코딩 후 최대 23MB. | [optional] [default to undefined]
 **url** | **string** | 다운로드 가능한 파일 URL. base64 가 없을 때 필수. | [optional] [default to undefined]
 

package/index.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403 입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json` 입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body 를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug 은 **HTTP status 로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 35.1.0
+ * The version of the OpenAPI document: 36.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/models/acceptance-result-response-dto.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403 입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json` 입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body 를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug 은 **HTTP status 로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 35.1.0
+ * The version of the OpenAPI document: 36.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -16,7 +16,7 @@
 
 export interface AcceptanceResultResponseDto {
     /**
-     * 공고 ID(= backend bidId).
+     * 공고 ID입니다.
      */
     'bidId': string;
     /**

package/models/acknowledge-product-receipt200-response.ts

@@ -0,0 +1,27 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403 입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json` 입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body 를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug 은 **HTTP status 로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ *
+ * The version of the OpenAPI document: 36.1.0
+ * Contact: semo.io.kr@gmail.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+// May contain unused imports in some cases
+// @ts-ignore
+import type { ProductReceiptResponseDto } from './product-receipt-response-dto';
+
+export interface AcknowledgeProductReceipt200Response {
+    'data': ProductReceiptResponseDto;
+    /**
+     * 부가 정보. 목록 응답의 커서(`nextCursor`·`hasMore`)처럼 리소스 자체가 아닌 값이 실립니다. 실을 것이 없으면 이 키는 나가지 않습니다.
+     */
+    'meta'?: { [key: string]: any; };
+}
+

package/models/acknowledge-products-request-dto.ts

@@ -0,0 +1,23 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403 입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json` 입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body 를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug 은 **HTTP status 로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ *
+ * The version of the OpenAPI document: 36.1.0
+ * Contact: semo.io.kr@gmail.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface AcknowledgeProductsRequestDto {
+    /**
+     * 전송완료로 표시할 물품 코드 목록입니다. 1~1000건. `GET /v2/products` 응답의 `productCode` 를 그대로 되돌려주세요.
+     */
+    'productCodes': Array<number>;
+}
+