@cmarket/partner-sdk 35.1.0 → 36.1.0

package/docs/CreateBidV1RequestDto.md

@@ -1,114 +0,0 @@
-# CreateBidV1RequestDto
-
-
-## Properties
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id). 한 파트너 키가 그룹 내 여러 회원 명의로 등록(멀티테넌트). 생략 시 backend 가 1:1 키 바인딩에서 명의를 완결한다(group 키는 필수 — 어느 명의인지 키가 못 정함). | [optional] [default to undefined]
-**categoryType** | **string** | 공고 카테고리 (PRODUCT: 물품, CONSTRUCTION: 공사, SERVICE: 용역, SALES: 매각). backend BidCategoryType mirror. | [optional] [default to undefined]
-**projectName** | **string** | 공고명. | [default to undefined]
-**noticeContent** | **string** | 공고 상세 내용. (저장 컬럼 buy_desc 는 무제한 — 상한 없음) | [default to undefined]
-**disclosePlannedAmount** | **boolean** | 예정금액(예산) 공개 여부. | [default to undefined]
-**attachments** | [**Array<BidAttachmentV1Dto>**](BidAttachmentV1Dto.md) | 공고 첨부파일 목록 — `{ fileKey, fileName? }` 객체 배열. fileKey 는 POST /v1/files 응답에서 받은 키다. **하위호환**: 원소를 fileKey 문자열로만 보내던 기존 요청(`[\"abc…\"]`)도 계속 수용하며, 이 경우 fileName 없이 등록된다. | [optional] [default to undefined]
-**items** | [**Array<BidItemV1Dto>**](BidItemV1Dto.md) | 품목 목록(1개 이상). | [default to undefined]
-**totalBudget** | **number** | 총 예산금액(원, **부가세 별도**). 지정하면 items 합계(단가 × 수량)를 무시하고 이 값으로 배정예산을 정한다. 배정예산은 부가세 포함으로 표기하므로 서버가 부가세 10% 를 더해 원 단위로 반올림한 값을 저장한다 (예: 25,000,000 → 27,500,000). 부가세가 이미 포함된 금액을 보내면 이중 과세가 되니 공급가액을 보낼 것. | [optional] [default to undefined]
-**awardMethod** | **string** | 낙찰 방법. A=최저가, B=적정가, C=최고가, D=최다수량, E=협상(임의), F=제한적최저가, H=협상(자동계산). backend AwardMethod mirror. | [optional] [default to undefined]
-**quoteCondition** | **string** | 견적서 제출 조건. UNIT_AUTO=자동생성(단가), TOTAL_AUTO=자동생성(총액), FILE=직접첨부, NONE=미제출. backend BidQuoteCondition mirror. | [optional] [default to undefined]
-**preliminaryPriceRegion** | **string** | 예비가격 범위 (awardMethod=F 필수). A=±2%, B=±3%, C=±4%. backend BidPreliminaryPriceRegion mirror. | [optional] [default to undefined]
-**preliminaryPriceCount** | **number** | 예비가격 선택수 (awardMethod=F 필수). 2/3/4 중 하나. | [optional] [default to undefined]
-**lowestBidPercent** | **number** | 낙찰하한율(%) (awardMethod=F 필수). 0-100 범위. | [optional] [default to undefined]
-**negotiationBidRatio** | **number** | 배정비율(가격:기술 배점) (awardMethod=H 필수). 0=100:0 / 10=90:10 / 20=80:20 / 30=70:30. V5 부분집합이라 40/50 은 /v1 에서 거부된다(웹은 지원). | [optional] [default to undefined]
-**negotiationStandard** | **string** | 협상 기준 (awardMethod=H 필수). A=없음, B=차등점수제, C=원가절감적정성(→ negotiationStandardRatio 추가 필수). V5 부분집합이라 D(기타)는 /v1 에서 거부된다(웹은 지원). | [optional] [default to undefined]
-**negotiationStandardRatio** | **number** | 기준금액비율 (negotiationStandard=C 필수). 60/70/80 중 하나. | [optional] [default to undefined]
-**qualificationStyle** | **string** | 참가자격 유형(V5 buy_style). A=전국경쟁, B=지명경쟁, C1=광역시도 지역제한, C2=시군구 지역제한. B 를 쓰면 `nomineeMemberIds` 가 필수다. backend BidQualificationStyle mirror. | [optional] [default to undefined]
-**nomineeMemberIds** | **Set<string>** | 지명업체 회원 ID 목록 (V5 `buy_style_corpId`). `qualificationStyle=B`(지명경쟁) 일 때 **필수이며 1개 이상**이어야 한다 — 비어 있으면 아무도 응찰할 수 없는 공고가 된다. V5 는 콤마 구분 문자열이지만 v1 은 배열로 받는다(CSV 파싱은 계약이 아니다). B 가 아니면 무시된다. 상호(sangho)는 서버가 b2b_member 에서 파생하므로 보내지 않는다. | [optional] [default to undefined]
-**selectedRegions** | [**Array<HierarchicalRegionV1Dto>**](HierarchicalRegionV1Dto.md) | 지역제한 지역 목록 (qualificationStyle=C1/C2 시 사용). | [optional] [default to undefined]
-**requiredLicenses** | **Array<string>** | 필수 면허 코드 목록. | [optional] [default to undefined]
-**preconditionDesc** | **string** | 자격조건 추가 기입 (최대 1000자). | [optional] [default to undefined]
-**preconditions** | [**PreconditionsV1Dto**](PreconditionsV1Dto.md) | precondition 구조체. 조건 토큰 트리를 modern 명으로 표현. ACL이 backend conditions bag 으로 변환. | [optional] [default to undefined]
-**deliveryDateType** | **string** | 납품기한 유형. A=직접설정(deliveryDate 필요), B=계약후지정(deliveryPeriodDays 필요), C=계약후협의. backend BidDeliveryDateType mirror. | [optional] [default to undefined]
-**deliveryDate** | **string** | 납품기한 일시 (deliveryDateType=A 시 사용). 형식: `YYYY-MM-DD-HH`(가이드 규정, 시 단위) 또는 `YYYY-MM-DD`(시 생략). 시(HH)는 잘라내지 않고 그대로 저장된다. | [optional] [default to undefined]
-**deliveryPeriodDays** | **number** | 납품소요일(일) (deliveryDateType=B 시 사용). 최대 999일(backend deliveryDays 3자리 제한). | [optional] [default to undefined]
-**deliveryMethod** | **string** | 납품 방법. A=택배(직납가능), B=직접납품, C=납품및설치. backend BidDeliveryMethod mirror. | [optional] [default to undefined]
-**deliveryAddress** | **string** | 납품지 주소. V5 패리티로 **생략 가능**(`b2b_buy.buy_deli_location` 은 nullable) — 매각(SALES) 공고처럼 납품지가 없는 건이 있다. /v2 는 필수. | [optional] [default to undefined]
-**paymentMethod** | **string** | 결제 방법. A=현금, B=카드. backend BidPaymentMethod mirror. | [optional] [default to undefined]
-**paymentDays** | **string** | 대금지급 기한(일). 숫자만. | [default to undefined]
-**documents** | [**Array<BidDocumentV1Dto>**](BidDocumentV1Dto.md) | 제출 서류 목록(1개 이상). | [default to undefined]
-**taxationType** | **string** | 과세 유형. A=과세, B=면세, C=면세(의제매입). backend BidTaxationType mirror. | [optional] [default to undefined]
-**isOptionalContract** | **string** | 수의계약 여부. Y=수의계약, N=일반. | [optional] [default to undefined]
-**bidMethod** | **string** | 입찰방식 (V5 buy_method). N=전자입찰, Y=역경매. 공사/용역/매각(CONSTRUCTION/SERVICE/SALES)은 backend 가 N 강제. 생략 시 N(전자입찰). backend BidType mirror. | [optional] [default to undefined]
-**isAnnualContract** | **string** | 연간계약 여부. Y=연간계약, N=일반. (backend 갭1: annual_contract) | [optional] [default to undefined]
-**nominatedContract** | **string** | 지명계약 여부. Y=지명계약(등록 시 검수대기 status=R 라우팅), N=일반. 지명업체 리스트는 미지원(V5 에도 없음) — Y/N 플래그만. (V5 nominated_contract 패리티) | [optional] [default to undefined]
-**empId** | **string** | 발주기관 담당자 사번 (V5 emp_id). 외부 ERP 담당자 식별자. | [optional] [default to undefined]
-**purchaseNo** | **string** | 발주처 지정 조달번호 (V5 bid_puchase_no). 외부 ERP 자체 PO 번호. 동일 PO 의 선행 입찰이 전부 취소/유찰이면 재입찰로 새 번호가 채번되고, 진행 중이면 중복으로 거부된다. (V5 again_chk 패리티) | [optional] [default to undefined]
-**isResultPublished** | **string** | 결과 공개 여부. Y=공개, N=비공개. | [optional] [default to undefined]
-**urgentYn** | **string** | 긴급입찰 여부 (V5 urgent_yn). Y=긴급, N=일반. 생략 시 N. → b2b_buy.urgent_yn. | [optional] [default to undefined]
-**businessRegistrationNo** | **string** | 사업자등록번호 override (V5 bid_bizrno). 생략 시 backend 가 명의 회원의 사업자번호를 스냅샷한다(COALESCE). 외부 ERP 가 발주처 사업자번호를 명시할 때만 전달. → b2b_buy.bid_bizrno. | [optional] [default to undefined]
-**presentationEval** | **boolean** | 발표평가(현장설명) 실시 여부 (V5 presentation_exec). true=실시, false=미실시. 공사/용역(gjy_ok=G/CONSTRUCTION) 맥락. → b2b_buy.presentation_exec. | [optional] [default to undefined]
-**presentationNote** | **string** | 발표평가(현장설명) 장소·시간 비고 (V5 presentation_note). → b2b_buy.presentation_note. | [optional] [default to undefined]
-**byProductCode** | **string** | 상품코드 기반 자동단가 견적 flag (V5 by_product_code). Y=KCL shop_product 코드기반 자동단가. ⚠️ partner-api 충실(faithful) 등록 경로는 by_product_code 컬럼을 적재하지 않음 — backend gateway 까지만 전달되고 b2b_buy 에는 미반영(향후 연결). | [optional] [default to undefined]
-**contractManager** | [**BidManagerV1Dto**](BidManagerV1Dto.md) | 계약 담당자. email 은 필수(가이드 mem_email). | [default to undefined]
-**techManager** | [**BidManagerV1Dto**](BidManagerV1Dto.md) | 기술 담당자. | [default to undefined]
-**bidStartAt** | **string** | 입찰 시작 일시(ISO-8601 UTC). | [default to undefined]
-**bidEndAt** | **string** | 입찰 마감 일시(ISO-8601 UTC). | [default to undefined]
-**isTemp** | **boolean** | 임시저장 여부. true=임시저장(b2b_buy_imsi), false/undefined=공식등록(b2b_buy). | [optional] [default to undefined]
-
-## Example
-
-```typescript
-import { CreateBidV1RequestDto } from '@cmarket/partner-sdk';
-
-const instance: CreateBidV1RequestDto = {
-    buyerId,
-    categoryType,
-    projectName,
-    noticeContent,
-    disclosePlannedAmount,
-    attachments,
-    items,
-    totalBudget,
-    awardMethod,
-    quoteCondition,
-    preliminaryPriceRegion,
-    preliminaryPriceCount,
-    lowestBidPercent,
-    negotiationBidRatio,
-    negotiationStandard,
-    negotiationStandardRatio,
-    qualificationStyle,
-    nomineeMemberIds,
-    selectedRegions,
-    requiredLicenses,
-    preconditionDesc,
-    preconditions,
-    deliveryDateType,
-    deliveryDate,
-    deliveryPeriodDays,
-    deliveryMethod,
-    deliveryAddress,
-    paymentMethod,
-    paymentDays,
-    documents,
-    taxationType,
-    isOptionalContract,
-    bidMethod,
-    isAnnualContract,
-    nominatedContract,
-    empId,
-    purchaseNo,
-    isResultPublished,
-    urgentYn,
-    businessRegistrationNo,
-    presentationEval,
-    presentationNote,
-    byProductCode,
-    contractManager,
-    techManager,
-    bidStartAt,
-    bidEndAt,
-    isTemp,
-};
-```
-
-[[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/FileUploadedV1ResponseDto.md

@@ -1,20 +0,0 @@
-# FileUploadedV1ResponseDto
-
-
-## Properties
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**fileKey** | **string** | 업로드된 파일의 저장소 키. `POST /v1/bids` 의 attachments[] 에 그대로 사용. | [default to undefined]
-
-## Example
-
-```typescript
-import { FileUploadedV1ResponseDto } from '@cmarket/partner-sdk';
-
-const instance: FileUploadedV1ResponseDto = {
-    fileKey,
-};
-```
-
-[[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/HierarchicalRegionV1Dto.md

@@ -1,22 +0,0 @@
-# HierarchicalRegionV1Dto
-
-
-## Properties
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**province** | **string** | 광역시도명. | [default to undefined]
-**districts** | **Array<string>** | 시군구 목록 (빈 배열 = 광역시도 전체). | [default to undefined]
-
-## Example
-
-```typescript
-import { HierarchicalRegionV1Dto } from '@cmarket/partner-sdk';
-
-const instance: HierarchicalRegionV1Dto = {
-    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/MarkBidFailedV1RequestDto.md

@@ -1,24 +0,0 @@
-# MarkBidFailedV1RequestDto
-
-
-## Properties
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). V5 `bid_puchase_no`. | [default to undefined]
-**failureReasonCode** | [**BidFailureReason**](BidFailureReason.md) | 유찰사유 코드(= V5 b2b_buy.sayou). 1~8.  - `1` 금액초과 · `2` 조건불일치 · `3` 전문성요구 · `4` 기타 · `5` 응찰업체없음 - `6` 단일 업체 참여(V5 화면에서 주석 처리된 레거시 옵션 — 신규 사용 비권장) - **`7` 참여 3곳 미만** — SDK 상수명은 `LESS_THAN_TWO` 이지만 실제 의미는 **참여 업체가 3곳 미만**이다(V5 가이드 규정). 상수명을 신뢰하지 말 것. - `8` 전원 하한가미달 | [default to undefined]
-**failureReasonDetail** | **string** | 유찰사유 상세(= V5 b2b_buy.sa_desc). 코드 4[기타] 일 때 필수, 최대 150자. | [optional] [default to undefined]
-
-## Example
-
-```typescript
-import { MarkBidFailedV1RequestDto } from '@cmarket/partner-sdk';
-
-const instance: MarkBidFailedV1RequestDto = {
-    bidNo,
-    failureReasonCode,
-    failureReasonDetail,
-};
-```
-
-[[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/NegotiationScoreV1Dto.md

@@ -1,24 +0,0 @@
-# NegotiationScoreV1Dto
-
-
-## Properties
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**sequence** | **number** | 응찰 순번(= V5 buy_seq = 입찰결과 조회 응답의 sequence). | [default to undefined]
-**techPoint** | **number** | 기술점수(= V5 tech_point). 0~100, 소수 1자리까지. 실제 상한은 `100 − 가격점수 배정비율`(배정비율 0/10/20/30 → 100/90/80/70)이며 backend 가 집행한다. | [default to undefined]
-**bidPoint** | **number** | 가격점수(= V5 bid_point). 0~100, 소수 1자리까지. V5 는 이 값을 필수로 요구한다(null 이면 거부). 자동계산 낙찰방법에서는 backend 가 0~50 범위를 집행한다. | [default to undefined]
-
-## Example
-
-```typescript
-import { NegotiationScoreV1Dto } from '@cmarket/partner-sdk';
-
-const instance: NegotiationScoreV1Dto = {
-    sequence,
-    techPoint,
-    bidPoint,
-};
-```
-
-[[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/NegotiationScoredResponseDto.md

@@ -1,20 +0,0 @@
-# NegotiationScoredResponseDto
-
-
-## Properties
-
-Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
-**bidNo** | **string** | 공고 구매번호. | [default to undefined]
-
-## Example
-
-```typescript
-import { NegotiationScoredResponseDto } from '@cmarket/partner-sdk';
-
-const instance: NegotiationScoredResponseDto = {
-    bidNo,
-};
-```
-
-[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)