@cmarket/partner-sdk 25.2.0 → 31.1.0

package/docs/PartnerWebhookDeliveryStatus.md

@@ -0,0 +1,14 @@
+# PartnerWebhookDeliveryStatus
+
+
+## Enum
+
+* `Pending` (value: `'PENDING'`)
+
+* `Delivered` (value: `'DELIVERED'`)
+
+* `Failed` (value: `'FAILED'`)
+
+* `Exhausted` (value: `'EXHAUSTED'`)
+
+[[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/PartnerWebhookEndpointStatus.md

@@ -0,0 +1,11 @@
+# PartnerWebhookEndpointStatus
+
+구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}` 로 되살립니다.
+
+## Enum
+
+* `Active` (value: `'ACTIVE'`)
+
+* `Disabled` (value: `'DISABLED'`)
+
+[[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/PartnerWebhookEventType.md

@@ -0,0 +1,17 @@
+# PartnerWebhookEventType
+
+구독한 이벤트 타입.
+
+## Enum
+
+* `BidClosed` (value: `'bid.closed'`)
+
+* `BidAwarded` (value: `'bid.awarded'`)
+
+* `BidFailed` (value: `'bid.failed'`)
+
+* `BidCanceled` (value: `'bid.canceled'`)
+
+* `BidAwardReverted` (value: `'bid.award_reverted'`)
+
+[[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/ProblemDetailsDto.md

@@ -11,7 +11,8 @@ Name | Type | Description | Notes
 **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]
-**correlationId** | **string** | 요청 상관관계 id — `X-Correlation-Id` 응답 헤더와 동일. 문의·로그 추적 키. | [optional] [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]
 
 ## Example
@@ -26,6 +27,7 @@ const instance: ProblemDetailsDto = {
     detail,
     instance,
     retryable,
+    traceId,
     correlationId,
     invalid_params,
 };

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/PublishBid200Response.md

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

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

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

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

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

@@ -0,0 +1,20 @@
+# RevertAwardRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**reason** | **string** | 낙찰을 되돌리는 사유. 공고 이력에 남습니다. | [default to undefined]
+
+## Example
+
+```typescript
+import { RevertAwardRequestDto } from '@cmarket/partner-sdk';
+
+const instance: RevertAwardRequestDto = {
+    reason,
+};
+```
+
+[[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/SendWebhookTestEvent200Response.md

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

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

@@ -0,0 +1,24 @@
+# UpdateWebhookEndpointRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**url** | **string** | 새 수신 주소(HTTPS). | [optional] [default to undefined]
+**eventTypes** | [**Set<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독 이벤트 타입 **전체 치환**. 최소 1개, 중복 불가. | [optional] [default to undefined]
+**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. 연속 실패로 자동 중지(`DISABLED`)된 구독을 고친 뒤 `ACTIVE` 로 되살릴 때 씁니다. 잠시 발송을 멈추려면 `DISABLED` 로 보내세요. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { UpdateWebhookEndpointRequestDto } from '@cmarket/partner-sdk';
+
+const instance: UpdateWebhookEndpointRequestDto = {
+    url,
+    eventTypes,
+    status,
+};
+```
+
+[[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/UploadFile201Response.md

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

@@ -0,0 +1,42 @@
+# WebhookDeliveryDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**deliveryId** | **string** | 전송 시도 식별자. | [default to undefined]
+**endpointId** | **string** | 이 전송이 속한 구독 식별자. | [default to undefined]
+**eventId** | **string** | 이벤트 식별자. 재시도해도 같은 값이며 `X-CMarket-Event-Id` 헤더로 실려 갑니다 — 수신측 중복 제거 키로 쓰세요. | [default to undefined]
+**eventType** | **string** | 이벤트 타입. | [default to undefined]
+**status** | [**PartnerWebhookDeliveryStatus**](PartnerWebhookDeliveryStatus.md) | 전송 상태. `PENDING`=대기·재시도 예정, `DELIVERED`=2xx 수신, `FAILED`=실패했고 재시도가 남음, `EXHAUSTED`=재시도 소진(더 보내지 않음). | [default to undefined]
+**attempt** | **number** | 몇 번째 시도인가(1 부터). | [default to undefined]
+**payload** | **{ [key: string]: any; }** | 보낸(보낼) 이벤트 본문. 수신측이 실제로 받는 JSON 그대로입니다. | [default to undefined]
+**responseStatus** | **number** | 수신측이 돌려준 HTTP 상태. 아직 보내지 않았거나 연결 자체가 실패했으면 null. | [default to undefined]
+**responseBodyExcerpt** | **string** | 수신측 응답 본문 앞부분(진단용, 길이 제한). 없으면 null. | [default to undefined]
+**nextAttemptAt** | **string** | 다음 재시도 예정 일시(ISO 8601, UTC). 재시도 예정이 없으면 null. | [default to undefined]
+**createdAt** | **string** | 이 시도가 만들어진 일시(ISO 8601, UTC). | [default to undefined]
+**deliveredAt** | **string** | 2xx 를 받은 일시(ISO 8601, UTC). 성공하지 않았으면 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { WebhookDeliveryDto } from '@cmarket/partner-sdk';
+
+const instance: WebhookDeliveryDto = {
+    deliveryId,
+    endpointId,
+    eventId,
+    eventType,
+    status,
+    attempt,
+    payload,
+    responseStatus,
+    responseBodyExcerpt,
+    nextAttemptAt,
+    createdAt,
+    deliveredAt,
+};
+```
+
+[[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/WebhookEndpointDto.md

@@ -0,0 +1,38 @@
+# WebhookEndpointDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**endpointId** | **string** | 구독 식별자. | [default to undefined]
+**url** | **string** | 이벤트를 받을 수신 주소(HTTPS). | [default to undefined]
+**eventTypes** | [**Array<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독한 이벤트 타입. | [default to undefined]
+**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}` 로 되살립니다. | [default to undefined]
+**consecutiveFailures** | **number** | 연속 실패 횟수. 2xx 를 한 번 받으면 0 으로 돌아갑니다. 임계치에 닿으면 구독이 자동으로 `DISABLED` 됩니다. | [default to undefined]
+**secretVersion** | **number** | 서명 시크릿 세대. 재발급할 때마다 1 씩 올라갑니다 — 수신측이 어느 시크릿으로 검증해야 하는지 대조하는 용도입니다. | [default to undefined]
+**createdAt** | **string** | 등록 일시(ISO 8601, UTC). | [default to undefined]
+**updatedAt** | **string** | 최종 수정 일시(ISO 8601, UTC). | [default to undefined]
+**disabledAt** | **string** | `DISABLED` 로 내려간 일시(ISO 8601, UTC). 활성 구독이면 null. | [default to undefined]
+**lastSuccessAt** | **string** | 마지막으로 2xx 를 받은 일시(ISO 8601, UTC). 한 번도 성공한 적이 없으면 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { WebhookEndpointDto } from '@cmarket/partner-sdk';
+
+const instance: WebhookEndpointDto = {
+    endpointId,
+    url,
+    eventTypes,
+    status,
+    consecutiveFailures,
+    secretVersion,
+    createdAt,
+    updatedAt,
+    disabledAt,
+    lastSuccessAt,
+};
+```
+
+[[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/WebhookEndpointWithSecretDto.md

@@ -0,0 +1,40 @@
+# WebhookEndpointWithSecretDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**endpointId** | **string** | 구독 식별자. | [default to undefined]
+**url** | **string** | 이벤트를 받을 수신 주소(HTTPS). | [default to undefined]
+**eventTypes** | [**Array<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독한 이벤트 타입. | [default to undefined]
+**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}` 로 되살립니다. | [default to undefined]
+**consecutiveFailures** | **number** | 연속 실패 횟수. 2xx 를 한 번 받으면 0 으로 돌아갑니다. 임계치에 닿으면 구독이 자동으로 `DISABLED` 됩니다. | [default to undefined]
+**secretVersion** | **number** | 서명 시크릿 세대. 재발급할 때마다 1 씩 올라갑니다 — 수신측이 어느 시크릿으로 검증해야 하는지 대조하는 용도입니다. | [default to undefined]
+**createdAt** | **string** | 등록 일시(ISO 8601, UTC). | [default to undefined]
+**updatedAt** | **string** | 최종 수정 일시(ISO 8601, UTC). | [default to undefined]
+**disabledAt** | **string** | `DISABLED` 로 내려간 일시(ISO 8601, UTC). 활성 구독이면 null. | [default to undefined]
+**lastSuccessAt** | **string** | 마지막으로 2xx 를 받은 일시(ISO 8601, UTC). 한 번도 성공한 적이 없으면 null. | [default to undefined]
+**secret** | **string** | 서명 시크릿. `X-CMarket-Signature` 검증에 쓰며 **이 응답에서만** 확인할 수 있습니다. 안전한 곳에 즉시 보관하세요. | [default to undefined]
+
+## Example
+
+```typescript
+import { WebhookEndpointWithSecretDto } from '@cmarket/partner-sdk';
+
+const instance: WebhookEndpointWithSecretDto = {
+    endpointId,
+    url,
+    eventTypes,
+    status,
+    consecutiveFailures,
+    secretVersion,
+    createdAt,
+    updatedAt,
+    disabledAt,
+    lastSuccessAt,
+    secret,
+};
+```
+
+[[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/WebhookTestResultDto.md

@@ -0,0 +1,24 @@
+# WebhookTestResultDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**delivered** | **boolean** | 수신측이 2xx 로 응답했는가. | [default to undefined]
+**responseStatus** | **number** | 수신측이 돌려준 HTTP 상태. 연결 자체가 실패했으면 null. | [default to undefined]
+**error** | **string** | 실패 사유(연결 거부·타임아웃·TLS 오류 등). 성공했으면 null. 수신측 주소·방화벽·인증서를 확인하는 데 쓰세요. | [default to undefined]
+
+## Example
+
+```typescript
+import { WebhookTestResultDto } from '@cmarket/partner-sdk';
+
+const instance: WebhookTestResultDto = {
+    delivered,
+    responseStatus,
+    error,
+};
+```
+
+[[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/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 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `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 를 되돌릴 것.  ## 레이트 리밋 전역 **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) 헤더가 실린다 — 그 전까지는 두 헤더가 나가지 않는다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ * 외부 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 를 되돌릴 것.  ## 레이트 리밋 전역 **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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
  *
- * The version of the OpenAPI document: 25.2.0
+ * The version of the OpenAPI document: 31.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 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `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 를 되돌릴 것.  ## 레이트 리밋 전역 **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) 헤더가 실린다 — 그 전까지는 두 헤더가 나가지 않는다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ * 외부 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 를 되돌릴 것.  ## 레이트 리밋 전역 **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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
  *
- * The version of the OpenAPI document: 25.2.0
+ * The version of the OpenAPI document: 31.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-v1-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 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `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 를 되돌릴 것.  ## 레이트 리밋 전역 **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) 헤더가 실린다 — 그 전까지는 두 헤더가 나가지 않는다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ * 외부 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 를 되돌릴 것.  ## 레이트 리밋 전역 **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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
  *
- * The version of the OpenAPI document: 25.2.0
+ * The version of the OpenAPI document: 31.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).