@cmarket/partner-sdk 43.0.2 → 44.1.0

package/docs/BidDetailResponseDto.md

@@ -24,6 +24,23 @@ Name | Type | Description | Notes
 **participants** | [**Array<BidResultParticipantDto>**](BidResultParticipantDto.md) | 응찰 참여자 목록입니다(투찰가·순위·낙찰 여부 포함). 낙찰자는 `isWinner` 값으로 확인합니다. 어떤 항목이 보이는지는 낙찰방법과 진행단계에 따라 이미 정해진 결과가 그대로 내려옵니다 — 개찰 전에는 업체명·투찰가가 null로 내려옵니다. 클라이언트에서 다시 계산하지 마세요. | [default to undefined]
 **contractDocuments** | [**Array<BidContractDocumentDto>**](BidContractDocumentDto.md) | 계약서류 목록(공고 공통 + 낙찰자 귀속). `downloadUrl`은 요청 시점에 서명한 1시간짜리 주소이므로 저장하지 말고 매번 이 응답에서 다시 받으세요. | [default to undefined]
 **acceptance** | [**BidAcceptanceDto**](BidAcceptanceDto.md) | 검수 진행 상태. | [default to undefined]
+**categoryType** | [**BidCategoryPublic**](BidCategoryPublic.md) | 공고 카테고리. 원천에 값이 없으면 null. | [default to undefined]
+**biddingStyle** | [**BiddingStylePublic**](BiddingStylePublic.md) | 참여 대상 지정 방식. `NOMINATED` 는 발주기관이 지명한 업체만 참여할 수 있습니다. 지역 제한은 `regions` 를 보세요. | [default to undefined]
+**buyerName** | **string** | 발주기관명. 미상이면 null. | [default to undefined]
+**budgetPublic** | **boolean** | 예산(예정)금액을 공급사에게 공개하는 공고인지. false 면 공고상세에서 금액이 비공개로 표시됩니다. `budgetAmount` 를 볼 수 있는지와는 별개 축입니다. | [default to undefined]
+**noticeContent** | **string** | 공고문 본문. **HTML** 이므로 표시하기 전에 신뢰할 수 있는 새니타이저를 거치세요. 본문이 없으면 null. | [default to undefined]
+**attachments** | [**Array<BidAttachmentDto>**](BidAttachmentDto.md) | 공고 첨부파일. | [default to undefined]
+**qualifications** | **Array<string>** | 참가자격 안내 문장. 발주기관이 고른 참가 조건을 문장으로 풀어 놓은 값이며 순서대로 표시하면 공고상세 화면과 같습니다. | [default to undefined]
+**regions** | [**BidRegionRestrictionDto**](BidRegionRestrictionDto.md) | 참여 가능 지역 제한. | [default to undefined]
+**requiredLicenses** | [**BidLicenseRequirementDto**](BidLicenseRequirementDto.md) | 면허·인증 요건. 요구가 없으면 null. | [default to undefined]
+**awardMethodDetail** | [**BidAwardMethodDetailDto**](BidAwardMethodDetailDto.md) | 낙찰방법 부가 조건(제한적 최저가 계열). 해당 없으면 null. | [default to undefined]
+**siteBriefing** | [**BidSiteBriefingDto**](BidSiteBriefingDto.md) | 현장 방문·설명회 요건. 요구가 없으면 null. | [default to undefined]
+**requiredDocuments** | [**Array<BidRequiredDocumentDto>**](BidRequiredDocumentDto.md) | 낙찰 시 제출해야 할 서류 종류. 발급된 파일 목록인 `contractDocuments` 와는 다른 축이며 마감 전에도 채워집니다. | [default to undefined]
+**customDocuments** | **Array<string>** | 발주기관이 직접 입력한 제출서류명(코드가 없는 서류). | [default to undefined]
+**mustReadNotices** | [**Array<BidMustReadNoticeDto>**](BidMustReadNoticeDto.md) | 공고상세 \"필수 유의사항\" 항목. 해당 사항이 없으면 빈 배열. | [default to undefined]
+**cancellation** | [**BidCancellationDto**](BidCancellationDto.md) | 취소 정보. 취소되지 않았으면 null. | [default to undefined]
+**deadlineExtensionCount** | **number** | 마감 자동연장 횟수. 연장 이력이 없으면 0. | [default to undefined]
+**preliminaryPrice** | [**BidPreliminaryPriceDto**](BidPreliminaryPriceDto.md) | 복수예비가격 산출내역. 낙찰방법·진행단계·권한을 함께 본 판정 결과이며 볼 수 없는 시야에서는 null 입니다. | [default to undefined]
 
 ## Example
 
@@ -50,6 +67,23 @@ const instance: BidDetailResponseDto = {
     participants,
     contractDocuments,
     acceptance,
+    categoryType,
+    biddingStyle,
+    buyerName,
+    budgetPublic,
+    noticeContent,
+    attachments,
+    qualifications,
+    regions,
+    requiredLicenses,
+    awardMethodDetail,
+    siteBriefing,
+    requiredDocuments,
+    customDocuments,
+    mustReadNotices,
+    cancellation,
+    deadlineExtensionCount,
+    preliminaryPrice,
 };
 ```
 

package/docs/BidLicenseRequirementDto.md

@@ -0,0 +1,24 @@
+# BidLicenseRequirementDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**licenses** | **Array<string>** | 요구 면허명. | [default to undefined]
+**certifications** | **Array<string>** | 요구 인증서명. | [default to undefined]
+**mode** | [**LicenseCombinationMode**](LicenseCombinationMode.md) | 면허 결합 방식. `AND`=모두 보유, `OR`=하나 이상 보유. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidLicenseRequirementDto } from '@cmarket/partner-sdk';
+
+const instance: BidLicenseRequirementDto = {
+    licenses,
+    certifications,
+    mode,
+};
+```
+
+[[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/BidMustReadNoticeDto.md

@@ -0,0 +1,22 @@
+# BidMustReadNoticeDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**title** | **string** | 유의사항 제목. | [default to undefined]
+**content** | **string** | 유의사항 본문. 줄바꿈(`\\n`)이 포함될 수 있다. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidMustReadNoticeDto } from '@cmarket/partner-sdk';
+
+const instance: BidMustReadNoticeDto = {
+    title,
+    content,
+};
+```
+
+[[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/BidPreliminaryPriceDto.md

@@ -0,0 +1,30 @@
+# BidPreliminaryPriceDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**basePrice** | **number** | 기초금액(원). | [default to undefined]
+**slots** | [**Array<BidPreliminaryPriceSlotDto>**](BidPreliminaryPriceSlotDto.md) | 슬롯 표(보통 15칸). | [default to undefined]
+**selectedSlots** | **Array<string>** | 추첨된 슬롯 번호. | [default to undefined]
+**averagePrice** | **string** | 예정가격(추첨 슬롯 평균). | [default to undefined]
+**floorPrice** | **string** | 낙찰하한가. | [default to undefined]
+**appliedLowestPercent** | **number** | 적용 낙찰하한율(%). | [default to undefined]
+
+## Example
+
+```typescript
+import { BidPreliminaryPriceDto } from '@cmarket/partner-sdk';
+
+const instance: BidPreliminaryPriceDto = {
+    basePrice,
+    slots,
+    selectedSlots,
+    averagePrice,
+    floorPrice,
+    appliedLowestPercent,
+};
+```
+
+[[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/BidPreliminaryPriceSlotDto.md

@@ -0,0 +1,24 @@
+# BidPreliminaryPriceSlotDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**slot** | **number** | 슬롯 번호(1~15). | [default to undefined]
+**price** | **number** | 슬롯 가격(원). | [default to undefined]
+**pickCount** | **number** | 이 슬롯을 고른 응찰 수. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidPreliminaryPriceSlotDto } from '@cmarket/partner-sdk';
+
+const instance: BidPreliminaryPriceSlotDto = {
+    slot,
+    price,
+    pickCount,
+};
+```
+
+[[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/BidRegionDto.md

@@ -0,0 +1,22 @@
+# BidRegionDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**province** | **string** | 광역시도명. | [default to undefined]
+**districts** | **Array<string>** | 선택된 시군구. 광역 전체를 고른 경우 그 광역의 시군구가 모두 들어온다. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidRegionDto } from '@cmarket/partner-sdk';
+
+const instance: BidRegionDto = {
+    province,
+    districts,
+};
+```
+
+[[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/BidRegionRestrictionDto.md

@@ -0,0 +1,22 @@
+# BidRegionRestrictionDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**regions** | [**Array<BidRegionDto>**](BidRegionDto.md) | 선택된 지역. 비어 있으면 제한 없음(전국)이다. | [default to undefined]
+**sameRegionOnly** | **boolean** | 발주기관 인근 지역만 허용하는지(견적 도메인 전용 축). true 면 `regions` 와 무관하게 인근 지역 제한이다. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidRegionRestrictionDto } from '@cmarket/partner-sdk';
+
+const instance: BidRegionRestrictionDto = {
+    regions,
+    sameRegionOnly,
+};
+```
+
+[[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/BidRequiredDocumentDto.md

@@ -0,0 +1,24 @@
+# BidRequiredDocumentDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**paperCode** | **number** | 서류 코드. | [default to undefined]
+**paperName** | **string** | 서류명. | [default to undefined]
+**isAutoGenerated** | **boolean** | 시스템이 자동 생성하는 서류인지. false 면 공급사가 직접 제출한다. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidRequiredDocumentDto } from '@cmarket/partner-sdk';
+
+const instance: BidRequiredDocumentDto = {
+    paperCode,
+    paperName,
+    isAutoGenerated,
+};
+```
+
+[[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/BidSiteBriefingDto.md

@@ -0,0 +1,22 @@
+# BidSiteBriefingDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**required** | **boolean** | 현장설명 참석이 필수인지. | [default to undefined]
+**note** | **string** | 장소·일시 안내. 없으면 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidSiteBriefingDto } from '@cmarket/partner-sdk';
+
+const instance: BidSiteBriefingDto = {
+    required,
+    note,
+};
+```
+
+[[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/BiddingStylePublic.md

@@ -0,0 +1,11 @@
+# BiddingStylePublic
+
+참여 대상 지정 방식. `NOMINATED` 는 발주기관이 지명한 업체만 참여할 수 있습니다. 지역 제한은 `regions` 를 보세요.
+
+## Enum
+
+* `Open` (value: `'OPEN'`)
+
+* `Nominated` (value: `'NOMINATED'`)
+
+[[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/CreateBidRequestDto.md

@@ -11,7 +11,7 @@ Name | Type | Description | Notes
 **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]
 **items** | [**Array<BidItemDto>**](BidItemDto.md) | 품목 목록(1개 이상). | [default to undefined]
-**totalBudget** | **number** | 총 예산금액(원). items 합계 대신 별도 totalBudget으로 override 할 때 사용. | [optional] [default to undefined]
+**totalBudget** | **number** | 총 예산금액(원, **부가세 포함**). 생략하면 품목 합계(단가 × 수량)가 배정예산이 됩니다. 낙찰금액도 부가세 포함 금액이라 두 값은 같은 축입니다 — 공급가액(부가세 별도)을 보내면 절감액이 실제보다 크게 계산됩니다. (`/v1`은 이 필드를 부가세 **별도**로 받아 서버가 10%를 가산합니다. 두 표면의 축이 다르므로 v1에서 옮겨올 때 값을 그대로 쓰지 마세요.) | [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]

package/docs/LicenseCombinationMode.md

@@ -0,0 +1,11 @@
+# LicenseCombinationMode
+
+면허 결합 방식. `AND`=모두 보유, `OR`=하나 이상 보유.
+
+## Enum
+
+* `And` (value: `'AND'`)
+
+* `Or` (value: `'OR'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)