@cmarket/partner-sdk 39.0.0 → 40.0.0

package/docs/BidFailedV2ResponseDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**bidId** | **string** | 공고 ID입니다(요청한 bidId 를 그대로 돌려줍니다). | [default to undefined]
+**bidId** | **string** | 공고 ID입니다(요청한 bidId를 그대로 돌려줍니다). | [default to undefined]
 **status** | **string** | 처리 상태입니다. | [default to undefined]
 
 ## Example

package/docs/BidRegisteredResponseDto.md

@@ -6,7 +6,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **bidId** | **string** | 생성된 공고 식별자. | [default to undefined]
-**purchaseNo** | **string** | 확정된 발주처 조달번호. 등록 요청의 `purchaseNo` **에코가 아니라 서버가 확정한 값**이다 — 동일 조달번호의 선행 공고가 전부 취소/유찰이면 재입찰로 새 번호가 채번된다(`PO-1` → `PO-1(2)`). ERP 원장에 저장할 키는 이 값이다. 등록 요청에 조달번호가 없었으면 null. | [default to undefined]
+**purchaseNo** | **string** | 확정된 발주기관 조달번호. 등록 요청의 `purchaseNo` **에코가 아니라 서버가 확정한 값**입니다. 같은 조달번호의 선행 공고가 전부 취소·유찰이면 재입찰로 새 번호가 채번됩니다(`PO-1` → `PO-1(2)`). ERP에 저장할 키는 이 값입니다. 등록 요청에 조달번호가 없었으면 `null`. | [default to undefined]
 
 ## Example
 

package/docs/BidResultParticipantAttachmentDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**fileBucket** | **number** | 파일 버킷 구분값(500~599 범위). 순번이 아니라 첨부 종류를 나타내는 버킷 코드다. | [default to undefined]
+**fileBucket** | **number** | 파일 버킷 구분값(500~599). 순번이 아니라 첨부 종류를 나타냅니다. | [default to undefined]
 **fileName** | **string** | 파일명. | [default to undefined]
 
 ## Example

package/docs/BidResultParticipantDto.md

@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 **companyName** | **string** | 참여 업체명. | [optional] [default to undefined]
 **bidPrice** | **number** | 투찰금액(원). 진행중·마스킹 시 미노출. | [optional] [default to undefined]
 **rank** | **number** | 순위 (낙찰 정렬 기준). | [optional] [default to undefined]
-**isWinner** | **boolean** | 낙찰 여부. 다수업체 낙찰에서는 여러 업체가 동시에 true 일 수 있다. | [default to undefined]
+**isWinner** | **boolean** | 낙찰 여부. 다수업체 낙찰에서는 여러 업체가 동시에 `true`일 수 있습니다. | [default to undefined]
 **quoteFileName** | **string** | 견적서 PDF 파일명. 신원 마스킹 또는 미첨부 시 null. | [optional] [default to undefined]
 **managerName** | **string** | 담당자명. 마스킹 시 null. | [optional] [default to undefined]
 **managerPhone** | **string** | 담당자 연락처. 마스킹 시 null. | [optional] [default to undefined]

package/docs/BidResultsResponseDto.md

@@ -6,9 +6,9 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **bidId** | **string** | 공고 식별자. | [default to undefined]
-**purchaseNo** | **string** | 외부 ERP 가 공고 등록 시 보낸 자체 발주(PO) 번호. 미설정 시 null. | [optional] [default to undefined]
-**status** | [**BidPublicStatus**](BidPublicStatus.md) | 공고 상태. `DRAFT`(미발행 초안) → `ONGOING`(진행중) → `PENDING_AWARD`(마감·낙찰대기) → `CONTRACT_IN_PROGRESS`(계약진행) → `CONTRACT_COMPLETED`(계약완료), 유찰 시 `FAILED`. 낙찰 여부는 이 필드가 아니라 `participants[].isWinner` 로 판별한다 — 낙찰 직후 공고는 `CONTRACT_IN_PROGRESS` 로 전이하며 별도의 \'AWARDED\' 상태는 존재하지 않습니다. | [default to undefined]
-**participants** | [**Array<BidResultParticipantDto>**](BidResultParticipantDto.md) | 참여(투찰) 업체 목록. 가격·신원은 발주처 시야로 마스킹된 결과. | [default to undefined]
+**purchaseNo** | **string** | 외부 ERP가 공고 등록 시 보낸 자체 발주(PO) 번호. 미설정 시 null. | [optional] [default to undefined]
+**status** | [**BidPublicStatus**](BidPublicStatus.md) | 공고 상태. `DRAFT`(미발행 초안) → `ONGOING`(진행중) → `PENDING_AWARD`(마감·낙찰대기) → `CONTRACT_IN_PROGRESS`(계약진행) → `CONTRACT_COMPLETED`(계약완료), 유찰 시 `FAILED`. 낙찰 여부는 이 필드가 아니라 `participants[].isWinner`로 판별한다 — 낙찰 직후 공고는 `CONTRACT_IN_PROGRESS`로 전이하며 별도의 \'AWARDED\' 상태는 존재하지 않습니다. | [default to undefined]
+**participants** | [**Array<BidResultParticipantDto>**](BidResultParticipantDto.md) | 참여(투찰) 업체 목록. 가격·신원은 발주기관 시야로 마스킹된 결과입니다. | [default to undefined]
 
 ## Example
 

package/docs/BidSummaryDto.md

@@ -8,7 +8,7 @@ Name | Type | Description | Notes
 **bidId** | **string** | 공고 식별자. | [default to undefined]
 **purchaseNo** | **string** | 외부 ERP 조달(PO) 번호. 등록 시 지정하지 않았으면 null. | [default to undefined]
 **title** | **string** | 공고명. | [default to undefined]
-**status** | [**BidPublicStatus**](BidPublicStatus.md) | 공고 상태(공개값). 낙찰 여부는 이 값이 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측한다(AWARDED 상태는 없다 — 낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 간다). | [default to undefined]
+**status** | [**BidPublicStatus**](BidPublicStatus.md) | 공고 상태(공개값). 낙찰 여부는 이 값이 아니라 낙찰 결과 조회의 `participants[].isWinner`로 관측한다(AWARDED 상태는 없다 — 낙찰 직후 공고는 CONTRACT_IN_PROGRESS로 간다). | [default to undefined]
 **awardMethod** | [**AwardMethodPublic**](AwardMethodPublic.md) | 낙찰방법(공개값). 아래 7종 밖의 방법으로 진행된 공고이면 null. | [default to undefined]
 **bidStartAt** | **string** | 입찰 시작(게시) 시각(ISO 8601 UTC). 없으면 null. | [default to undefined]
 **bidEndAt** | **string** | 입찰 마감 시각(ISO 8601 UTC). 없으면 null. | [default to undefined]

package/docs/CompleteAcceptanceRequestDto.md

@@ -6,8 +6,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **buyerId** | **string** | 검수완료를 처리하는 발주기관(공고 명의)의 회원 ID입니다. 생략하면 공고를 등록한 발주기관으로 자동 처리됩니다. | [optional] [default to undefined]
-**supplyAmount** | **number** | 협의 감액 공급가액(원, 부가세 별도). `vat` 와 함께 지정해야 하며, 지정하면 이 금액으로 세금계산서 발행을 요청한다. 생략 시 낙찰금액에서 파생(종전 동작). | [optional] [default to undefined]
-**vat** | **number** | 협의 감액 부가세(원). 면세면 0. `supplyAmount` 와 함께 지정합니다. | [optional] [default to undefined]
+**supplyAmount** | **number** | 협의 감액 공급가액(원, 부가세 별도). `vat`와 함께 지정해야 하며, 지정하면 이 금액으로 세금계산서 발행을 요청합니다. 생략하면 낙찰금액에서 파생합니다. | [optional] [default to undefined]
+**vat** | **number** | 협의 감액 부가세(원). 면세면 0. `supplyAmount`와 함께 지정합니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/ContractRestrictionConfirmInputDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**answers** | **Array<string>** | 서식 ①~⑧에 대한 **계약상대자**의 답변 — 정확히 8개, 순서대로. c-market 이 대신 만들어낼 수 없는 값이라 호출자가 계약상대자로부터 직접 받아 전달해야 합니다.  「공직자의 이해충돌 방지법」 별지 제14호 서식의 문항 원문(순서대로):  ① 발주기관의 소속 고위공직자, 배우자, 고위공작자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ② 계약 업무을 법령상·사실상 담당하는 공직자, 배우자, 공직자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ③ 발주기관(산하기관)의 감독기관 소속 고위공직자, 배우자, 고위공직자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ④ 발주기관(자회사)의 모회사 소속 고위공직자, 배우자, 고위공직자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ⑤ 상임위원회 위원의 국회의원, 배우자, 국회의원의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ⑥ 공공기관을 감사 또는 조사하는 지방의회의 의원, 배우자, 의원의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ⑦ ①부터 ⑥까지 어느 하나에 해당하는 사람이 대표자인 법인 또는 단체에 해당하는가?  ⑧ ①부터 ⑥까지 어느 하나에 해당하는 사람과 특수한 관계의 사업자(공직자, 배우자, 공직자의 직계존속·비속, 생계를 같이하는 배우자의 직계존속·비속이 단독으로 또는 합산하여 ① 발행주식 총수의 100분의 30 이상, ② 출자지분 총수의 100분의 30 이상, ③ 자본금 총액의 100분의 50 이상을 소유하고 있는 법인 또는 단체)에 해당하는가? | [default to undefined]
+**answers** | **Array<string>** | 서식 ①~⑧에 대한 **계약상대자**의 답변 — 정확히 8개, 순서대로. c-market이 대신 만들어낼 수 없는 값이라 호출자가 계약상대자로부터 직접 받아 전달해야 합니다.  「공직자의 이해충돌 방지법」 별지 제14호 서식의 문항 원문(순서대로):  ① 발주기관의 소속 고위공직자, 배우자, 고위공작자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ② 계약 업무을 법령상·사실상 담당하는 공직자, 배우자, 공직자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ③ 발주기관(산하기관)의 감독기관 소속 고위공직자, 배우자, 고위공직자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ④ 발주기관(자회사)의 모회사 소속 고위공직자, 배우자, 고위공직자의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ⑤ 상임위원회 위원의 국회의원, 배우자, 국회의원의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ⑥ 공공기관을 감사 또는 조사하는 지방의회의 의원, 배우자, 의원의 직계존속·비속 또는 생계를 같이하는 배우자의 직계존속·비속에 해당하는가?  ⑦ ①부터 ⑥까지 어느 하나에 해당하는 사람이 대표자인 법인 또는 단체에 해당하는가?  ⑧ ①부터 ⑥까지 어느 하나에 해당하는 사람과 특수한 관계의 사업자(공직자, 배우자, 공직자의 직계존속·비속, 생계를 같이하는 배우자의 직계존속·비속이 단독으로 또는 합산하여 ① 발행주식 총수의 100분의 30 이상, ② 출자지분 총수의 100분의 30 이상, ③ 자본금 총액의 100분의 50 이상을 소유하고 있는 법인 또는 단체)에 해당하는가? | [default to undefined]
 **buyerConfirmation** | **string** | ⑨ 발주자 확인사항 — ①~⑧ 중 \"예\"가 있을 때 발주기관이 답합니다. 생략하면 빈칸으로 인쇄됩니다. | [optional] [default to undefined]
 
 ## Example

package/docs/CreateBidRequestDto.md

@@ -9,9 +9,9 @@ Name | Type | Description | Notes
 **projectName** | **string** | 공고명. | [default to undefined]
 **noticeContent** | **string** | 공고 상세 내용. (길이 제한 없음) | [default to undefined]
 **disclosePlannedAmount** | **boolean** | 예정금액(예산) 공개 여부. | [default to undefined]
-**attachments** | [**Array<BidAttachmentInputDto>**](BidAttachmentInputDto.md) | 공고 첨부파일 목록. 원소마다 `fileKey`(이미 올린 파일) · `url` · `base64` 중 **하나**를 담습니다. `url`·`base64` 를 쓰면 별도 업로드 호출 없이 이 요청 하나로 끝납니다. 큰 파일이나 여러 공고에 재사용할 파일은 `POST /v2/files/upload-url` 로 먼저 올리고 `fileKey` 로 참조하세요. | [optional] [default to undefined]
+**attachments** | [**Array<BidAttachmentInputDto>**](BidAttachmentInputDto.md) | 공고 첨부파일 목록. 원소마다 `fileKey`(이미 올린 파일) · `url` · `base64` 중 **하나**를 담습니다. `url`·`base64`를 쓰면 별도 업로드 호출 없이 이 요청 하나로 끝납니다. 큰 파일이나 여러 공고에 재사용할 파일은 `POST /v2/files/upload-url`로 먼저 올리고 `fileKey`로 참조하세요. | [optional] [default to undefined]
 **items** | [**Array<BidItemDto>**](BidItemDto.md) | 품목 목록(1개 이상). | [default to undefined]
-**totalBudget** | **number** | 총 예산금액(원). items 합계 대신 별도 totalBudget 으로 override 할 때 사용. | [optional] [default to undefined]
+**totalBudget** | **number** | 총 예산금액(원). items 합계 대신 별도 totalBudget으로 override 할 때 사용. | [optional] [default to undefined]
 **awardMethod** | **string** | 낙찰 방법(필수). LOWEST_PRICE=최저가, APPROPRIATE_PRICE=적정가, HIGHEST_PRICE=최고가, MAX_QUANTITY=최다수량, NEGOTIATION=협상(임의), LIMITED_LOWEST=제한적최저가, NEGOTIATION_AUTO=협상(자동계산). | [default to undefined]
 **quoteCondition** | **string** | 견적서 제출 조건. UNIT_AUTO=자동생성(단가), TOTAL_AUTO=자동생성(총액), FILE=직접첨부, NONE=미제출. | [optional] [default to undefined]
 **preliminaryPriceRegion** | **string** | 예비가격 범위 (awardMethod=LIMITED_LOWEST 필수). PLUS_MINUS_2=±2%, PLUS_MINUS_3=±3%, PLUS_MINUS_4=±4%. | [optional] [default to undefined]
@@ -39,7 +39,7 @@ Name | Type | Description | Notes
 **isAnnualContract** | **boolean** | 연간계약 여부. true=연간계약, false=일반. | [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]
+**purchaseNo** | **string** | 발주기관 지정 조달번호(외부 ERP의 구매번호). 동일 PO의 선행 입찰이 전부 취소/유찰이면 재입찰로 새 번호가 채번되고, 진행 중이면 중복으로 거부됩니다. | [optional] [default to undefined]
 **isResultPublished** | **boolean** | 결과 공개 여부. true=공개, false=비공개. | [optional] [default to undefined]
 **contractManager** | [**BidManagerDto**](BidManagerDto.md) | 계약 담당자. | [default to undefined]
 **techManager** | [**BidManagerDto**](BidManagerDto.md) | 기술 담당자. | [default to undefined]

package/docs/CreateExternalContractDocumentsRequestDto.md

@@ -6,8 +6,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **buyerId** | **string** | 발주기관 회원 ID(c-market memberId). 필요 서류 판정의 그룹 해소에 쓰입니다. | [default to undefined]
-**supplierId** | **string** | 공급사 회원 ID(c-market memberId). 상호·사업자번호·대표자·주소·직인은 이 ID 로 c-market 이 해소합니다. | [default to undefined]
-**paperCodes** | **Array<number>** | 생성할 계약서류 코드 목록. 목록 조회 응답의 `autoGenerated=true` 인 코드만 허용됩니다(그 외는 400 으로 전체 거절). 공급사 사전등록 3종(회사직인 11 · 사업자등록증사본 12 · 입금통장사본 13)은 공급사 프로필에 등록된 파일을 참조하므로 `contract` 스냅샷이 필요 없고, 공급사가 등록해 두지 않았으면 422 로 전체 거절됩니다. | [default to undefined]
+**supplierId** | **string** | 공급사 회원 ID(c-market memberId). 상호·사업자번호·대표자·주소·직인은 이 ID로 c-market이 해소합니다. | [default to undefined]
+**paperCodes** | **Array<number>** | 생성할 계약서류 코드 목록. 목록 조회 응답의 `autoGenerated=true` 인 코드만 허용됩니다(그 외는 400으로 전체 거절). 공급사 사전등록 3종(회사직인 11 · 사업자등록증사본 12 · 입금통장사본 13)은 공급사 프로필에 등록된 파일을 참조하므로 `contract` 스냅샷이 필요 없고, 공급사가 등록해 두지 않았으면 422로 전체 거절됩니다. | [default to undefined]
 **externalContractId** | **string** | 외부 시스템의 계약 식별자. 저장 경로와 감사 추적에 사용됩니다. 경로 세그먼트가 되므로 **영숫자·하이픈(-)·언더스코어(_) 1~64자**만 허용합니다(UUID 그대로 써도 됩니다). | [default to undefined]
 **contract** | [**ExternalContractSnapshotDto**](ExternalContractSnapshotDto.md) | 계약 스냅샷. 템플릿 렌더가 필요한 서류(예: 표준계약서 176/177)가 포함되면 필수이며, 정적 약관(201~207)만 요청하면 생략할 수 있습니다. | [optional] [default to undefined]
 **documentInputs** | [**ExternalDocumentInputsDto**](ExternalDocumentInputsDto.md) | 서류별 전용 입력(135 확인 답변, 164 퇴직자 명단). 해당 서류를 요청하지 않으면 생략할 수 있습니다. | [optional] [default to undefined]

package/docs/CreateWebhookEndpointRequestDto.md

@@ -5,8 +5,8 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**url** | **string** | 이벤트를 받을 수신 주소. **HTTPS 만 허용합니다** — 서명된 페이로드를 평문 구간에 실을 수 없습니다. | [default to undefined]
-**eventTypes** | [**Set<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독할 이벤트 타입. 최소 1개, 중복 불가. `ping` 은 연결 확인 전용이라 구독할 수 없습니다. | [default to undefined]
+**url** | **string** | 이벤트를 받을 수신 주소. **HTTPS만 허용합니다** — 서명된 페이로드를 평문 구간에 실을 수 없습니다. | [default to undefined]
+**eventTypes** | [**Set<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독할 이벤트 타입. 최소 1개, 중복 불가. `ping`은 연결 확인 전용이라 구독할 수 없습니다. | [default to undefined]
 
 ## Example
 

package/docs/EmbedApi.md

@@ -4,12 +4,12 @@ All URIs are relative to *https://partner-api.c-market.net*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
-|[**createEmbedLaunch**](#createembedlaunch) | **POST** /v2/embed/launch | 임베드 launch 발급 (SSO — iframe 또는 새 탭)|
+|[**createEmbedLaunch**](#createembedlaunch) | **POST** /v2/embed/launch | 임베드 launch 발급|
 
 # **createEmbedLaunch**
 > CreateEmbedLaunch201Response createEmbedLaunch(embedLaunchRequestDto)
 
-스코프 `embed:launch` 필수. 발주기관 담당자(`memberId`)용 일회성 launch(60초 TTL)를 발급합니다. 이 값으로 CMARKET 화면이 ERP 사용자에게 로그인 없이 열립니다 — REST 로 UI 를 다시 만들지 않는 연동 방식입니다.  **응답은 `launchUrl` 하나입니다.** iframe `src` 에 걸거나 새 탭으로 그대로 엽니다 — 설치할 스크립트도, 붙일 SDK 도 없습니다. 1. **iframe 임베드(권장)**: 발급 요청에 `parentOrigin` 을 함께 주면, 등록 완료·취소·공고선택·세션만료를 그 origin 으로 `postMessage` 통지합니다. **허용 origin 등록이 선행**되어야 합니다(미등록이면 이 요청이 400). 2. **새 탭(iframe 불가 환경)**: `parentOrigin` 없이 발급해 URL 을 그대로 엽니다. origin 등록이 필요 없는 대신 통지가 없어 결과는 조회 API 로 확인합니다.  **프런트에서 직접 호출하지 마세요.** 이 API 는 파트너 자격증명을 쓰므로 ERP **백엔드**가 호출하고, 프런트에는 자체 엔드포인트(예: `POST /api/embed/launch`)로 감싸 노출합니다.  `memberId` 가 이 API 키의 대행 범위 밖이면 403, 화이트리스트 밖 `screen`·`components` 는 400 입니다.
+발주기관 담당자(`memberId`)용 1회성 `launchUrl`을 발급합니다(TTL 60초). 이 주소로 CMARKET 화면이 ERP 사용자에게 로그인 없이 열립니다. 스코프 `embed:launch`.  - 응답은 `launchUrl` 하나입니다. iframe `src`에 걸거나 새 탭으로 엽니다. 설치할 스크립트도 SDK도 없습니다. - **iframe(권장)**: 발급 요청에 `parentOrigin`을 함께 보내면 등록 완료·취소·공고선택·세션만료를 그 origin으로 `postMessage` 통지합니다. 허용 origin 등록이 선행되어야 하며, 미등록이면 이 요청이 400입니다. - **새 탭**: `parentOrigin` 없이 발급합니다. origin 등록이 필요 없는 대신 통지가 없어 결과는 조회 API로 확인합니다. - 파트너 자격증명을 쓰므로 ERP **백엔드**에서 호출하고, 프런트에는 자체 엔드포인트(예: `POST /api/embed/launch`)로 감싸 노출합니다. - `memberId`가 이 API 키의 대행 범위 밖이면 403, 허용 목록 밖 `screen`·`components`는 400입니다.
 
 ### Example
 
@@ -54,15 +54,15 @@ const { status, data } = await apiInstance.createEmbedLaunch(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** | 1회성 launch URL 발급 완료(TTL 60초). iframe·새 탭 어느 쪽이든 이 URL 하나를 그대로 씁니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0 에 가까워지면 요청 간격을 늘리세요 — 429 를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
-|**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;). |  -  |
-|**422** | 형식은 맞지만 내용상 처리할 수 없는 요청입니다(&#x60;type: …/upstream-unprocessable&#x60;). |  -  |
-|**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. 대기 시간은 &#x60;Retry-After&#x60;(초)가 우선하고, 잔여 쿼터·정책은 표준 필드 &#x60;RateLimit&#x60;/&#x60;RateLimit-Policy&#x60;(draft-ietf-httpapi-ratelimit-headers)로 나갑니다. 관용 헤더 &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#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;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;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
+|**201** | 1회성 launch URL 발급 완료(TTL 60초). iframe·새 탭 어느 쪽이든 이 URL 하나를 그대로 씁니다. |  * 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;). |  -  |
+|**422** | 내용상 처리 불가(&#x60;…/upstream-unprocessable&#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)
 

package/docs/EmbedBidPrefillDto.md

@@ -0,0 +1,46 @@
+# EmbedBidPrefillDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**prefillVersion** | **number** | 계약 버전. 현재 유일한 값은 `1` 이며, 다른 값은 400입니다. | [default to undefined]
+**purchaseNo** | **string** | 발주기관 구매번호(ERP 구매번호). 공고 등록(`POST /v2/bids`)과 **같은 식별 축**이니 같은 값을 쓰세요. 숫자로 시작하면 CMARKET 공고번호로 오인되니 알파벳 접두사를 붙입니다. (화면: `bid-register`) | [optional] [default to undefined]
+**bidId** | **string** | 대상 공고의 CMARKET 공고번호. 등록 완료 통지(`cmarket:success`)가 준 `bidId`를 그대로 되돌려 보내는 값입니다. (화면: `payment` 전용 — 공고등록 화면은 무시) | [optional] [default to undefined]
+**projectName** | **string** | 공고명. (화면: `bid-register`) | [optional] [default to undefined]
+**noticeContent** | **string** | 공고 내용. (화면: `bid-register`) | [optional] [default to undefined]
+**bidEndAt** | **string** | 입찰 마감 일시 (ISO-8601, offset 필수). (화면: `bid-register`) | [optional] [default to undefined]
+**deliveryDate** | **string** | 납품 희망일(`YYYY-MM-DD`). 폼의 납품기한 \"지정일\" 로 들어갑니다. (화면: `bid-register`) | [optional] [default to undefined]
+**items** | [**Array<EmbedBidPrefillItemDto>**](EmbedBidPrefillItemDto.md) | 품목 행. (화면: `bid-register`) | [optional] [default to undefined]
+**categoryType** | **string** | 공고 유형 셀렉터 초기값. (화면: `bid-register`) | [optional] [default to undefined]
+**deliveryAddress** | **string** | 납품 장소(도로명 주소). (화면: `bid-register`) | [optional] [default to undefined]
+**paymentMethod** | **string** | 결제 방법. 공고 등록(`POST /v2/bids`)과 같은 값집합입니다. `payment` 화면은 `CARD` 일 때만 카드결제 진입을 그립니다(비권위 — 최종 판정은 서버). (화면: `bid-register` · `payment`) | [optional] [default to undefined]
+**paymentDays** | **string** | 대금지급 기한(일 단위 숫자 문자열). (화면: `bid-register`) | [optional] [default to undefined]
+**contractManager** | [**EmbedBidPrefillManagerDto**](EmbedBidPrefillManagerDto.md) | 계약 담당자. (화면: `bid-register`) | [optional] [default to undefined]
+**techManager** | [**EmbedBidPrefillManagerDto**](EmbedBidPrefillManagerDto.md) | 기술 담당자. (화면: `bid-register`) | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { EmbedBidPrefillDto } from '@cmarket/partner-sdk';
+
+const instance: EmbedBidPrefillDto = {
+    prefillVersion,
+    purchaseNo,
+    bidId,
+    projectName,
+    noticeContent,
+    bidEndAt,
+    deliveryDate,
+    items,
+    categoryType,
+    deliveryAddress,
+    paymentMethod,
+    paymentDays,
+    contractManager,
+    techManager,
+};
+```
+
+[[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/EmbedBidPrefillItemDto.md

@@ -0,0 +1,28 @@
+# EmbedBidPrefillItemDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**productName** | **string** | 품목명. | [default to undefined]
+**spec** | **string** | 규격. | [optional] [default to undefined]
+**quantity** | **number** | 수량(정수). | [default to undefined]
+**unit** | **string** | 단위. | [optional] [default to undefined]
+**unitPrice** | **number** | 단가(VAT 포함). 임베드 공고등록 폼의 **필수 입력**이라, 빼면 총 예정금액이 0 원으로 시작합니다. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { EmbedBidPrefillItemDto } from '@cmarket/partner-sdk';
+
+const instance: EmbedBidPrefillItemDto = {
+    productName,
+    spec,
+    quantity,
+    unit,
+    unitPrice,
+};
+```
+
+[[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/EmbedBidPrefillManagerDto.md

@@ -0,0 +1,24 @@
+# EmbedBidPrefillManagerDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**name** | **string** | 담당자명. | [default to undefined]
+**phone** | **string** | 연락처. | [default to undefined]
+**email** | **string** | 이메일. | [default to undefined]
+
+## Example
+
+```typescript
+import { EmbedBidPrefillManagerDto } from '@cmarket/partner-sdk';
+
+const instance: EmbedBidPrefillManagerDto = {
+    name,
+    phone,
+    email,
+};
+```
+
+[[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/EmbedLaunchRequestDto.md

@@ -5,12 +5,12 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**memberId** | **string** | 임베드 세션을 열 발주기관 담당자의 회원 ID입니다. 요청한 파트너(발주처) 소속이 아니면 403 이 반환됩니다. | [default to undefined]
-**screen** | **string** | 임베드를 열었을 때 **처음 보일 화면**입니다. bid-register=공고등록, bid-list=공고목록, bid-detail=공고상세, assistant=AI 리포트 어시스트, payment=대금결제. 허용되지 않은 값이면 400 이 반환됩니다. 이 세션으로 쓸 수 있는 화면 전체는 components 로 정합니다. | [default to undefined]
-**components** | **Array<string>** | 이 세션으로 쓸 수 있는 화면(=컴포넌트) 집합입니다. 여러 개를 주면 임베드가 상단 탭으로 그리고, 사용자가 새 launch URL 없이 그 사이를 오갑니다. screen 은 자동으로 포함됩니다. **표시 목록이 아니라 권한입니다** — 여기에 없는 화면의 기능은 서버가 403 으로 거절합니다. 담당자 역할이 여럿이면(등록만 가능한 실무자 / 결제까지 가능한 결재자) 역할에 맞춰 좁혀서 발급하세요. 생략하면 screen 하나만 열린 세션이 됩니다. | [optional] [default to undefined]
-**targetBidId** | **string** | 임베드 세션을 특정 공고로 스코프할 대상 공고 식별자(구매번호 또는 등록 응답의 공고번호). 지정하면 이 파트너 키가 소유한 공고여야 하며(타 발주처 소유 → 403), 세션은 그 공고에만 스코프된다. 생략하면 화면 전역(member-scoped) 세션. | [optional] [default to undefined]
-**parentOrigin** | **string** | iframe 을 띄울 **부모 페이지의 origin** 입니다(`https://erp.example.com`). 이 값을 주면 임베드가 완료·취소·공고선택·세션만료를 그 origin 으로 `postMessage` 통지하므로, ERP 가 결과를 즉시 받을 수 있습니다.  파트너 키에 등록된 허용 origin 과 대조하며 **미등록이면 400** 입니다(등록은 CMARKET 담당자에게 요청하세요 — 브라우저 `frame-ancestors` 설정도 함께 필요합니다).  생략하면 통지 없이 화면만 열립니다 — 새 탭으로 여는 경우가 그렇습니다. | [optional] [default to undefined]
-**prefill** | **object** | 공고등록 화면(`bid-register`)을 미리 채워 열기 위한 값입니다. 필드 정의는 공고 등록(`POST /v2/bids`)과 같은 축을 씁니다 — `purchaseNo` 는 발주처 구매번호이고, 숫자로 시작하면 공고번호로 오인되니 알파벳 접두사를 붙이세요.  **비권위 값입니다.** 스키마에 맞지 않으면 화면이 조용히 무시하고 빈 폼으로 엽니다(오류가 아닙니다). 최종 검증은 제출 시점의 서버가 합니다. 낙찰방법처럼 상태머신에 얽힌 값은 받지 않습니다. | [optional] [default to undefined]
+**memberId** | **string** | 임베드 세션을 열 발주기관 담당자의 회원 ID입니다. 요청한 파트너(발주기관) 소속이 아니면 403입니다. | [default to undefined]
+**screen** | **string** | 임베드를 열었을 때 **처음 보일 화면**입니다. bid-register=공고등록, bid-list=공고목록, bid-detail=공고상세, assistant=AI 리포트 어시스트, payment=대금결제. 허용되지 않은 값이면 400이 반환됩니다. 이 세션으로 쓸 수 있는 화면 전체는 components로 정합니다. | [default to undefined]
+**components** | **Array<string>** | 이 세션으로 쓸 수 있는 화면(=컴포넌트) 집합입니다. 여러 개를 주면 임베드가 상단 탭으로 그리고, 사용자가 새 launch URL 없이 그 사이를 오갑니다. screen은 자동으로 포함됩니다. **표시 목록이 아니라 권한입니다** — 여기에 없는 화면의 기능은 서버가 403으로 거절합니다. 담당자 역할이 여럿이면(등록만 가능한 실무자 / 결제까지 가능한 결재자) 역할에 맞춰 좁혀서 발급하세요. 생략하면 screen 하나만 열린 세션이 됩니다. | [optional] [default to undefined]
+**targetBidId** | **string** | 임베드 세션을 특정 공고로 스코프할 대상 공고 식별자(구매번호 또는 등록 응답의 공고번호). 지정하면 이 파트너 키가 소유한 공고여야 하고(다른 발주기관의 공고는 403), 세션은 그 공고에만 적용됩니다. 생략하면 화면 전역(member-scoped) 세션. | [optional] [default to undefined]
+**parentOrigin** | **string** | iframe을 띄울 **부모 페이지의 origin** 입니다(`https://erp.example.com`). 이 값을 주면 임베드가 완료·취소·공고선택·세션만료를 그 origin으로 `postMessage` 통지하므로, ERP가 결과를 즉시 받을 수 있습니다.  파트너 키에 등록된 허용 origin과 대조하며 **미등록이면 400** 입니다(등록은 CMARKET 담당자에게 요청하세요 — 브라우저 `frame-ancestors` 설정도 함께 필요합니다).  생략하면 통지 없이 화면만 열립니다 — 새 탭으로 여는 경우가 그렇습니다. | [optional] [default to undefined]
+**prefill** | [**EmbedBidPrefillDto**](EmbedBidPrefillDto.md) | 화면을 미리 채워 열기 위한 값입니다. 필드마다 읽는 화면이 다릅니다 — `bid-register`는 폼 기본값 전체를, `payment`는 `bidId`·`paymentMethod`를 읽습니다. 자기 화면이 읽지 않는 필드는 무시될 뿐 오류가 아닙니다(한 세션이 `components`로 탭을 여러 개 열면 그 화면들이 이 한 객체를 함께 봅니다).  `purchaseNo`는 공고 등록(`POST /v2/bids`)과 같은 축입니다 — 숫자로 시작하면 공고번호로 오인되니 알파벳 접두사를 붙이세요.  **값은 비권위입니다** — 폼 기본값일 뿐이고 최종 검증은 제출 시점의 서버가 합니다. 낙찰방법처럼 상태머신에 얽힌 값은 받지 않습니다. 다만 **모양은 여기서 검증합니다** — 미인식 필드나 타입 불일치는 400입니다(전 표면 공통 규약). 통과시켜 놓고 화면이 조용히 버리면 연동사는 빈 폼만 보고 원인을 찾지 못합니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/EmbedLaunchResponseDto.md

@@ -5,8 +5,8 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**launchUrl** | **string** | 이 URL 하나로 임베드가 열립니다 — **iframe `src` 에 걸거나, 새 탭으로 그대로 여세요.** 별도 SDK·스크립트가 필요 없습니다.  launch code 는 쿼리가 아니라 fragment(`#code=`)에 실려 서버 액세스 로그·Referer 에 남지 않고, CMARKET 화면이 소비 즉시 주소창에서 지웁니다. 다만 URL 자체가 60초짜리 자격증명이므로 메일·메신저로 재전달하지 말고, 사용자 클릭 시점에 발급해 바로 여세요.  완료·취소 통지(`cmarket:success` 등)를 받으려면 발급 요청에 `parentOrigin` 을 함께 주세요. 새 탭 모드에는 통지 경로가 없어 결과를 조회 API 로 확인합니다. | [default to undefined]
-**expiresIn** | **number** | launch URL 의 유효기간(초)입니다. 만료 후에 열면 화면이 만료 안내를 띄웁니다 — 캐시하지 말고 필요할 때 발급하세요. | [default to undefined]
+**launchUrl** | **string** | 이 URL 하나로 임베드가 열립니다 — **iframe `src`에 걸거나, 새 탭으로 그대로 여세요.** 별도 SDK·스크립트가 필요 없습니다.  launch code는 쿼리가 아니라 fragment(`#code=`)에 실려 서버 액세스 로그·Referer에 남지 않고, CMARKET 화면이 소비 즉시 주소창에서 지웁니다. 다만 URL 자체가 60초짜리 자격증명이므로 메일·메신저로 재전달하지 말고, 사용자 클릭 시점에 발급해 바로 여세요.  완료·취소 통지(`cmarket:success` 등)를 받으려면 발급 요청에 `parentOrigin`을 함께 주세요. 새 탭 모드에는 통지 경로가 없어 결과를 조회 API로 확인합니다. | [default to undefined]
+**expiresIn** | **number** | launch URL의 유효기간(초)입니다. 만료 후에 열면 화면이 만료 안내를 띄웁니다 — 캐시하지 말고 필요할 때 발급하세요. | [default to undefined]
 
 ## Example
 

package/docs/ExternalContractDocumentItemDto.md

@@ -8,7 +8,7 @@ Name | Type | Description | Notes
 **paperCode** | **number** | 계약서류 코드(paper_code) | [default to undefined]
 **name** | **string** | 계약서류명 | [default to undefined]
 **isDefault** | **boolean** | 해당 거래유형의 기본 서류 여부 | [default to undefined]
-**autoGenerated** | **boolean** | c-market 이 데이터를 채워 PDF 로 만들어 주는 서류인지 여부. true 면 생성 요청(`POST /v2/contract-documents`)의 `paperCodes` 에 넣을 수 있습니다. false 면 목록에는 뜨지만 시스템이 만들지 않으므로 사용자가 직접 첨부해야 합니다 — 목록에서 감추지 말고 수기 제출을 안내하세요. | [default to undefined]
+**autoGenerated** | **boolean** | c-market이 데이터를 채워 PDF로 만들어 주는 서류인지 여부. true 면 생성 요청(`POST /v2/contract-documents`)의 `paperCodes`에 넣을 수 있습니다. false 면 목록에는 뜨지만 시스템이 만들지 않으므로 사용자가 직접 첨부해야 합니다 — 목록에서 감추지 말고 수기 제출을 안내하세요. | [default to undefined]
 
 ## Example
 

package/docs/ExternalContractSnapshotDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**contractNo** | **string** | 계약번호. 감사 추적(렌더 payload 기록)에 남습니다. 현행 표준계약서(176/177) 서식은 계약번호 칸이 발급 후 수기 기재용 빈칸이라 PDF 에는 출력되지 않습니다 — PDF 상단에 찍히는 식별자는 `externalContractId` 입니다. | [default to undefined]
+**contractNo** | **string** | 계약번호. 감사 추적(렌더 payload 기록)에 남습니다. 현행 표준계약서(176/177) 서식은 계약번호 칸이 발급 후 수기 기재용 빈칸이라 PDF 에는 출력되지 않습니다 — PDF 상단에 찍히는 식별자는 `externalContractId`입니다. | [default to undefined]
 **contractDate** | **string** | 계약일자(yyyy-mm-dd) | [default to undefined]
 **totalAmount** | **number** | 계약 총액(원) | [default to undefined]
 **deliveryMethod** | **string** | 납품방법 | [optional] [default to undefined]
@@ -13,8 +13,8 @@ Name | Type | Description | Notes
 **deliveryDate** | **string** | 납품일자(yyyy-mm-dd) | [optional] [default to undefined]
 **items** | [**Array<ExternalContractItemDto>**](ExternalContractItemDto.md) | 계약 품목(1건 이상) | [default to undefined]
 **subject** | **string** | 발주내용. **수의계약체결제한여부확인서(135)를 요청하면 필수**입니다(서식의 \"발주내용\" 칸). 퇴직자영입현황확인서(164)를 요청하면 이 값이 서식의 \"수의계약 대상건명\" 칸으로 인쇄되므로 역시 필수입니다. 승낙사항(4·184·185·186·189·197·208)을 요청하면 서식 상단 \"건명\" 칸으로 인쇄되므로 역시 필수입니다. | [optional] [default to undefined]
-**category** | **string** | 계약구분. **135 를 요청하면 필수**이며 서식의 물품/공사/용역/기타 체크에 대응합니다. | [optional] [default to undefined]
-**buyerDepartment** | **string** | 발주부서. **135 를 요청하면 필수**입니다 — c-market 에 공고가 없어 해소할 수 없는 값입니다. | [optional] [default to undefined]
+**category** | **string** | 계약구분. **135를 요청하면 필수**이며 서식의 물품/공사/용역/기타 체크에 대응합니다. | [optional] [default to undefined]
+**buyerDepartment** | **string** | 발주부서. **135를 요청하면 필수**입니다 — c-market에 공고가 없어 해소할 수 없는 값입니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/GeneratedExternalContractDocumentDto.md

@@ -6,8 +6,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **paperCode** | **number** | 계약서류 코드(paper_code) | [default to undefined]
-**name** | **string** | 계약서류명. 목록 조회(`GET /v2/contract-documents`)의 `name` 과 같은 값입니다 — 같은 `paperCode` 는 두 응답에서 같은 이름으로 옵니다. 파일명이 필요하면 `fileName` 을 쓰세요. | [default to undefined]
-**fileName** | **string** | 실제 파일명(확장자 포함). 시스템이 렌더한 서류는 발급 시 만든 PDF 파일명이고, 공급사 사전등록 3종(11·12·13)과 정적 약관은 등록된 원본 파일명입니다. `fileUrl` 을 GET 하면 같은 이름이 `Content-Disposition` 으로도 내려옵니다 — 다운로드 전에 파일명이 필요할 때 쓰세요. | [default to undefined]
+**name** | **string** | 계약서류명. 목록 조회(`GET /v2/contract-documents`)의 `name`과 같은 값입니다 — 같은 `paperCode`는 두 응답에서 같은 이름으로 옵니다. 파일명이 필요하면 `fileName`을 쓰세요. | [default to undefined]
+**fileName** | **string** | 실제 파일명(확장자 포함). 시스템이 렌더한 서류는 발급 시 만든 PDF 파일명이고, 공급사 사전등록 3종(11·12·13)과 정적 약관은 등록된 원본 파일명입니다. `fileUrl`을 GET 하면 같은 이름이 `Content-Disposition` 으로도 내려옵니다 — 다운로드 전에 파일명이 필요할 때 쓰세요. | [default to undefined]
 **fileUrl** | **string** | 다운로드 URL — 만료되지 않는 안정 URL 이라 그대로 저장해 두어도 됩니다. | [default to undefined]
 
 ## Example

package/docs/IntrospectRequestDto.md

@@ -5,12 +5,12 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**token** | **string** | 검사할 토큰. 이 API 는 access token 만 발급합니다. | [default to undefined]
-**token_type_hint** | **string** | 토큰 종류 힌트. 이 API 는 access_token 만 발급하므로 무시됩니다. | [optional] [default to undefined]
+**token** | **string** | 검사할 토큰. 이 API는 access token만 발급합니다. | [default to undefined]
+**token_type_hint** | **string** | 토큰 종류 힌트. 이 API는 access_token만 발급하므로 무시됩니다. | [optional] [default to undefined]
 **client_id** | **string** | client_id (Basic 인증 헤더를 쓰지 않는 경우) | [optional] [default to undefined]
 **client_secret** | **string** | client_secret (Basic 인증 헤더를 쓰지 않는 경우) | [optional] [default to undefined]
 **client_assertion** | **string** | RFC 7523 private_key_jwt 인증용 서명 JWT (공개키가 등록된 키). | [optional] [default to undefined]
-**client_assertion_type** | **string** | client_assertion 의 종류. RFC 7523 이 정한 고정 URN 만 허용합니다. | [optional] [default to undefined]
+**client_assertion_type** | **string** | client_assertion의 종류. RFC 7523이 정한 고정 URN만 허용합니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/IntrospectionResponseDto.md

@@ -8,11 +8,11 @@ Name | Type | Description | Notes
 **active** | **boolean** | 토큰이 지금 유효한지. false 면 다른 필드는 실리지 않습니다. | [default to undefined]
 **scope** | **string** | 토큰의 스코프 (space-separated). | [optional] [default to undefined]
 **client_id** | **string** | 이 토큰을 발급받은 client_id. | [optional] [default to undefined]
-**sub** | **string** | 토큰의 주체. client_credentials 라 client_id 와 같습니다. | [optional] [default to undefined]
+**sub** | **string** | 토큰의 주체. client_credentials 라 client_id와 같습니다. | [optional] [default to undefined]
 **exp** | **number** | 만료 시각(epoch 초). | [optional] [default to undefined]
 **iat** | **number** | 발급 시각(epoch 초). | [optional] [default to undefined]
 **jti** | **string** | 토큰 식별자(jti). | [optional] [default to undefined]
-**token_type** | **string** | 토큰 종류. 항상 `Bearer` 입니다. | [optional] [default to undefined]
+**token_type** | **string** | 토큰 종류. 항상 `Bearer`입니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/ListBids200ResponseMeta.md

@@ -6,7 +6,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**nextCursor** | **string** | 다음 페이지 커서(불투명 토큰). 그대로 `cursor` 쿼리에 실어 다음 페이지를 받습니다. `null` 이면 커서 페이지네이션이 없거나 마지막 페이지입니다. | [default to undefined]
+**nextCursor** | **string** | 다음 페이지 커서(불투명 토큰). 그대로 `cursor` 쿼리에 실어 다음 페이지를 받습니다. `null`이면 커서 페이지네이션이 없거나 마지막 페이지입니다. | [default to undefined]
 **hasMore** | **boolean** | 가져올 것이 더 남았는지. 커서 목록은 `nextCursor` 유무와 같고, 수신확인 기반 피드(`GET /v2/products`)는 커서 없이 이 값만으로 반복 여부를 판단합니다. | [default to undefined]
 
 ## Example

package/docs/ListWebhookDeliveriesResponseDto.md

@@ -6,7 +6,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **items** | [**Array<WebhookDeliveryDto>**](WebhookDeliveryDto.md) | 전송 시도 목록(최신순). | [default to undefined]
-**nextCursor** | **string** | 다음 페이지 커서(불투명). null 이면 마지막 페이지. | [default to undefined]
+**nextCursor** | **string** | 다음 페이지 커서(불투명). null이면 마지막 페이지. | [default to undefined]
 
 ## Example
 

package/docs/NegotiationScoredV2ResponseDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**bidId** | **string** | 공고 ID입니다(요청 경로의 bidId 를 그대로 돌려줍니다). | [default to undefined]
+**bidId** | **string** | 공고 ID입니다(요청 경로의 bidId를 그대로 돌려줍니다). | [default to undefined]
 **evaluatedCount** | **number** | 점수를 입력한 응찰자 수입니다. | [default to undefined]
 **status** | **string** | 처리 상태입니다. | [default to undefined]
 

package/docs/OauthApi.md

@@ -6,12 +6,12 @@ All URIs are relative to *https://partner-api.c-market.net*
 |------------- | ------------- | -------------|
 |[**introspect**](#introspect) | **POST** /oauth/introspect | OAuth 2.0 토큰 검사 (Token Introspection, RFC 7662)|
 |[**revoke**](#revoke) | **POST** /oauth/revoke | OAuth 2.0 토큰 폐기 (Token Revocation, RFC 7009)|
-|[**token**](#token) | **POST** /oauth/token | OAuth 2.0 access token 발급 (client_credentials)|
+|[**token**](#token) | **POST** /oauth/token | 액세스 토큰 발급|
 
 # **introspect**
 > IntrospectionResponseDto introspect(introspectRequestDto)
 
-가지고 있는 access token 이 지금도 유효한지, 어떤 스코프를 갖는지 확인합니다. 자기 토큰만 조회할 수 있습니다 — 위조·만료·폐기됐거나 다른 client 의 토큰이면 이유를 구분하지 않고 `{\"active\": false}` 로 답합니다(RFC 7662 §4).
+가지고 있는 access token이 지금도 유효한지, 어떤 스코프를 갖는지 확인합니다. 자기 토큰만 조회할 수 있습니다 — 위조·만료·폐기됐거나 다른 client의 토큰이면 이유를 구분하지 않고 `{\"active\": false}`로 답합니다(RFC 7662 §4).
 
 ### Example
 
@@ -56,7 +56,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 토큰 상태. RFC 7662 대로 유효하지 않은 토큰도 오류가 아니라 &#x60;active: false&#x60; 로 응답합니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0 에 가까워지면 요청 간격을 늘리세요 — 429 를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**200** | 토큰 상태. RFC 7662 대로 유효하지 않은 토큰도 오류가 아니라 &#x60;active: false&#x60;로 응답합니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**401** | RFC 6749 §5.2 오류 envelope — client 인증 실패(&#x60;error: invalid_client&#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)
@@ -64,7 +64,7 @@ No authorization required
 # **revoke**
 > revoke(revokeRequestDto)
 
-발급받은 access token 을 즉시 무효화합니다. 유출을 확인했을 때 TTL(15분) 만료를 기다리지 않고 끊는 경로입니다. RFC 7009 §2.2 에 따라 이미 만료됐거나 알 수 없는 토큰을 보내도 200 으로 응답합니다.
+발급받은 access token을 즉시 무효화합니다. 유출을 확인했을 때 TTL(15분) 만료를 기다리지 않고 끊는 경로입니다. RFC 7009 §2.2에 따라 이미 만료됐거나 알 수 없는 토큰을 보내도 200으로 응답합니다.
 
 ### Example
 
@@ -109,7 +109,7 @@ No authorization required
 ### 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>  |
 |**401** | RFC 6749 §5.2 오류 envelope — client 인증 실패(&#x60;error: invalid_client&#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)
@@ -117,7 +117,7 @@ No authorization required
 # **token**
 > TokenResponseDto token(tokenRequestDto)
 
-파트너 ERP 가 client_id/secret 로 단명 JWT access token 을 발급받습니다 (TTL 15분). 이후 모든 보호 endpoint 는 Authorization: Bearer <token> 헤더로 호출합니다.
+`client_id`·`client_secret`으로 액세스 토큰을 발급합니다(`client_credentials`, TTL 15분). 이후 모든 요청은 `Authorization: Bearer <token>` 헤더로 호출합니다.
 
 ### Example
 
@@ -162,7 +162,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | access token 발급 성공. RFC 6749 가 본문 형태를 규정하므로 이 응답만 &#x60;{data}&#x60; 봉투를 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0 에 가까워지면 요청 간격을 늘리세요 — 429 를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**200** | 토큰 발급 성공. RFC 6749가 본문 형태를 정하므로 이 응답만 공통 응답 형식(&#x60;{data}&#x60;)을 쓰지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**400** | RFC 6749 §5.2 오류 envelope — 필수 파라미터 누락/형식 오류(&#x60;error: invalid_request&#x60;), 미지원 grant_type(&#x60;unsupported_grant_type&#x60;), 허용되지 않은 scope(&#x60;invalid_scope&#x60;). |  -  |
 |**401** | RFC 6749 §5.2 오류 envelope — client 인증 실패 또는 IP 미허용(&#x60;error: invalid_client&#x60;). |  -  |
 |**429** | rate limit 초과(5회/분/IP) — problem+json &#x60;type: …/too-many-requests&#x60;. &#x60;Retry-After&#x60; 헤더 참조. |  -  |