@cmarket/partner-sdk 0.1.0 → 0.2.1

package/docs/BidResultProductDto.md

@@ -0,0 +1,24 @@
+# BidResultProductDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**productName** | **string** | 품목명. | [default to undefined]
+**quantity** | **number** | 수량. | [optional] [default to undefined]
+**unitPrice** | **number** | 단가(원). | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { BidResultProductDto } from '@cmarket/partner-sdk';
+
+const instance: BidResultProductDto = {
+    productName,
+    quantity,
+    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/BidResultWinnerDto.md

@@ -0,0 +1,24 @@
+# BidResultWinnerDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**winnerMemberId** | **string** | 낙찰업체 ID. | [default to undefined]
+**winningAmount** | **number** | 낙찰금액(원). | [default to undefined]
+**winningDate** | **string** | 낙찰일시 (ISO 8601 UTC). | [default to undefined]
+
+## Example
+
+```typescript
+import { BidResultWinnerDto } from '@cmarket/partner-sdk';
+
+const instance: BidResultWinnerDto = {
+    winnerMemberId,
+    winningAmount,
+    winningDate,
+};
+```
+
+[[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/BidResultsBatchRequestDto.md

@@ -0,0 +1,22 @@
+# BidResultsBatchRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**buyerId** | **string** | 공고 명의 회원 ID (멀티테넌트). | [default to undefined]
+**bidIds** | **Array<string>** | 조회할 공고 식별자 목록. 빈 배열이면 빈 결과. 최대 100건. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidResultsBatchRequestDto } from '@cmarket/partner-sdk';
+
+const instance: BidResultsBatchRequestDto = {
+    buyerId,
+    bidIds,
+};
+```
+
+[[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/BidResultsResponseDto.md

@@ -0,0 +1,38 @@
+# BidResultsResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidId** | **string** | 공고 식별자. | [default to undefined]
+**status** | **string** | 공고 상태 코드 (BidStatus enum). | [default to undefined]
+**statusText** | **string** | 공고 상태 한국어 레이블. | [optional] [default to undefined]
+**isCancelled** | **boolean** | 공고 취소 여부 (status 와 직교하는 별도 레이어). | [optional] [default to undefined]
+**failureReasonCode** | **string** | 유찰사유 코드. | [optional] [default to undefined]
+**failureReasonText** | **string** | 유찰사유 텍스트. | [optional] [default to undefined]
+**participantCount** | **number** | 총 참여(투찰) 업체 수. | [default to undefined]
+**winner** | [**BidResultWinnerDto**](BidResultWinnerDto.md) | 낙찰 요약. 낙찰 정보가 없으면 null (유찰/진행중). | [default to undefined]
+**participants** | [**Array<BidResultParticipantDto>**](BidResultParticipantDto.md) | 참여(투찰) 업체 목록. 가격/신원은 backend 매트릭스 적용 결과. | [default to undefined]
+**products** | [**Array<BidResultProductDto>**](BidResultProductDto.md) | 공고 품목 목록. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidResultsResponseDto } from '@cmarket/partner-sdk';
+
+const instance: BidResultsResponseDto = {
+    bidId,
+    status,
+    statusText,
+    isCancelled,
+    failureReasonCode,
+    failureReasonText,
+    participantCount,
+    winner,
+    participants,
+    products,
+};
+```
+
+[[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/BidSettlementLineItemDto.md

@@ -0,0 +1,36 @@
+# BidSettlementLineItemDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**sequence** | **number** | 품목 순번 (V5 guds_seq). | [default to undefined]
+**productCode** | **string** | 품목 코드 (V5 guds_code). | [default to undefined]
+**productName** | **string** | 품목명 (V5 guds_name). | [default to undefined]
+**spec** | **string** | 규격 (V5 guds_standard). | [default to undefined]
+**quantity** | **number** | 수량 (V5 guds_qy). | [default to undefined]
+**unitPrice** | **number** | 단가(원) (V5 guds_untpc). | [default to undefined]
+**supplyAmount** | **number** | 공급가액(원) (V5 guds_splpc). | [default to undefined]
+**vat** | **number** | 부가세(원) (V5 guds_vat). | [default to undefined]
+**total** | **number** | 합계(원) (V5 guds_totpc). | [default to undefined]
+
+## Example
+
+```typescript
+import { BidSettlementLineItemDto } from '@cmarket/partner-sdk';
+
+const instance: BidSettlementLineItemDto = {
+    sequence,
+    productCode,
+    productName,
+    spec,
+    quantity,
+    unitPrice,
+    supplyAmount,
+    vat,
+    total,
+};
+```
+
+[[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/BidSettlementParticipantDto.md

@@ -0,0 +1,56 @@
+# BidSettlementParticipantDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**sequence** | **number** | 응찰 순번 (V5 buy_seq — 안정 키). | [default to undefined]
+**companyId** | **string** | 응찰 업체 ID (V5 join_id). | [default to undefined]
+**businessRegistrationNumber** | **string** | 사업자등록번호 (V5 cpn_bizrno). | [default to undefined]
+**taxType** | **string** | 과세(\'Y\')/면세(\'N\') 구분 (V5 cpn_tax_type). | [default to undefined]
+**subBusinessNumber** | **string** | 종사업자 번호 (V5 cpn_tax_bizrno). | [default to undefined]
+**representativeName** | **string** | 대표자명 (V5 cpn_cxfc). | [default to undefined]
+**businessType** | **string** | 업태 (V5 cpn_bizcnd). | [default to undefined]
+**businessItem** | **string** | 종목 (V5 cpn_induty). | [default to undefined]
+**zipCode** | **string** | 우편번호 (V5 cpn_zip). | [default to undefined]
+**address** | **string** | 사업장 주소 (V5 cpn_adres). | [default to undefined]
+**addressDetail** | **string** | 사업장 상세주소 (V5 cpn_adres_detail). | [default to undefined]
+**bankCode** | **string** | 은행 코드 (V5 cpn_bank_code). | [default to undefined]
+**bankName** | **string** | 은행명 (V5 cpn_bank_nm). | [default to undefined]
+**bankAccountNumber** | **string** | 계좌번호 (V5 cpn_bank_no). | [default to undefined]
+**bankAccountOwner** | **string** | 예금주 (V5 cpn_bank_own). | [default to undefined]
+**bidPrice** | **number** | 투찰 총액(원) (V5 join_price). | [default to undefined]
+**supplyAmount** | **number** | 공급가액(원) (V5 join_price_splpc). | [default to undefined]
+**vat** | **number** | 부가세(원) (V5 join_price_vat). | [default to undefined]
+**lineItems** | [**Array<BidSettlementLineItemDto>**](BidSettlementLineItemDto.md) | 응찰 품목 라인아이템 (R1, buy_seq 스코프). | [default to undefined]
+
+## Example
+
+```typescript
+import { BidSettlementParticipantDto } from '@cmarket/partner-sdk';
+
+const instance: BidSettlementParticipantDto = {
+    sequence,
+    companyId,
+    businessRegistrationNumber,
+    taxType,
+    subBusinessNumber,
+    representativeName,
+    businessType,
+    businessItem,
+    zipCode,
+    address,
+    addressDetail,
+    bankCode,
+    bankName,
+    bankAccountNumber,
+    bankAccountOwner,
+    bidPrice,
+    supplyAmount,
+    vat,
+    lineItems,
+};
+```
+
+[[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/BidSettlementResponseDto.md

@@ -0,0 +1,22 @@
+# BidSettlementResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidId** | **string** | 공고 식별자. | [default to undefined]
+**participants** | [**Array<BidSettlementParticipantDto>**](BidSettlementParticipantDto.md) | 응찰 업체별 정산정보 목록 (사업자·계좌·금액·품목내역). | [default to undefined]
+
+## Example
+
+```typescript
+import { BidSettlementResponseDto } from '@cmarket/partner-sdk';
+
+const instance: BidSettlementResponseDto = {
+    bidId,
+    participants,
+};
+```
+
+[[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/BidStatementResponseDto.md

@@ -0,0 +1,26 @@
+# BidStatementResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidNo** | **string** | 공고 구매번호. | [default to undefined]
+**winnerSequence** | **object** | 낙찰자 응찰 순번(buy_seq). 미낙찰 시 null. | [default to undefined]
+**documents** | [**Array<StatementDocumentDto>**](StatementDocumentDto.md) | 거래명세서 관련 문서 목록. | [default to undefined]
+**products** | [**Array<StatementProductDto>**](StatementProductDto.md) | 거래 품목 라인 목록. | [default to undefined]
+
+## Example
+
+```typescript
+import { BidStatementResponseDto } from '@cmarket/partner-sdk';
+
+const instance: BidStatementResponseDto = {
+    bidNo,
+    winnerSequence,
+    documents,
+    products,
+};
+```
+
+[[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/BidStatus.md

@@ -1,6 +1,6 @@
 # BidStatus
 
-공고 상태 (V5 b2b_buy.status SSOT enum)
+공고 상태 (b2b_buy.status SSOT enum)
 
 ## Enum
 

package/docs/BidSummaryResponseDto.md

@@ -5,10 +5,10 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**bidId** | **string** | 공고 식별자 (V5 b2b_buy.buy_idx). | [default to undefined]
-**title** | **string** | 공고 제목 (V5 b2b_buy.buy_title). | [default to undefined]
-**status** | [**BidStatus**](BidStatus.md) | 공고 상태 (V5 b2b_buy.status SSOT enum) | [default to undefined]
-**budget** | **number** | 예산 가격 (원, V5 b2b_buy.buy_price). | [default to undefined]
+**bidId** | **string** | 공고 식별자 (b2b_buy.buy_idx). | [default to undefined]
+**title** | **string** | 공고 제목 (b2b_buy.buy_title). | [default to undefined]
+**status** | [**BidStatus**](BidStatus.md) | 공고 상태 (b2b_buy.status SSOT enum) | [default to undefined]
+**budget** | **number** | 예산 가격 (원, b2b_buy.buy_price). | [default to undefined]
 
 ## Example
 

package/docs/CompleteAcceptanceRequestDto.md

@@ -0,0 +1,44 @@
+# CompleteAcceptanceRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**winnerMemberId** | **string** | 낙찰자(공급사) memberId. | [default to undefined]
+**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 검수완료 actor. V5 bid_branch_id. | [default to undefined]
+**buyerCompanyName** | **string** | 구매사 상호. | [optional] [default to undefined]
+**buyerRepresentative** | **string** | 구매사 대표자. | [optional] [default to undefined]
+**buyerBizRegNo** | **string** | 구매사 사업자등록번호. | [optional] [default to undefined]
+**buyerAddress** | **string** | 구매사 주소. | [optional] [default to undefined]
+**buyerBizType** | **string** | 구매사 업태. | [optional] [default to undefined]
+**buyerBizItem** | **string** | 구매사 종목. | [optional] [default to undefined]
+**managerName** | **string** | 담당자명. | [optional] [default to undefined]
+**managerDepartment** | **string** | 담당자 부서. | [optional] [default to undefined]
+**managerPhone** | **string** | 담당자 연락처. | [optional] [default to undefined]
+**managerEmail** | **string** | 담당자 이메일. | [optional] [default to undefined]
+**documentDate** | **string** | 문서 작성일자(YYYY-MM-DD). 미지정 시 backend 가 stamp 하지 않음. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { CompleteAcceptanceRequestDto } from '@cmarket/partner-sdk';
+
+const instance: CompleteAcceptanceRequestDto = {
+    winnerMemberId,
+    buyerId,
+    buyerCompanyName,
+    buyerRepresentative,
+    buyerBizRegNo,
+    buyerAddress,
+    buyerBizType,
+    buyerBizItem,
+    managerName,
+    managerDepartment,
+    managerPhone,
+    managerEmail,
+    documentDate,
+};
+```
+
+[[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/ContractDocumentItemDto.md

@@ -0,0 +1,26 @@
+# ContractDocumentItemDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**docType** | **string** | 서류 종류 코드. | [default to undefined]
+**paperCode** | **number** | 서식(paper) 코드. 자동생성 서식이 아니면 null. | [default to undefined]
+**fileName** | **string** | 파일명. 미발급 시 null. | [default to undefined]
+**fileUrl** | **string** | 파일 다운로드 URL. 미발급 시 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { ContractDocumentItemDto } from '@cmarket/partner-sdk';
+
+const instance: ContractDocumentItemDto = {
+    docType,
+    paperCode,
+    fileName,
+    fileUrl,
+};
+```
+
+[[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

@@ -26,7 +26,7 @@ Name | Type | Description | Notes
 **licenses** | **Array<string>** | 면허 코드 목록. | [optional] [default to undefined]
 **requiredLicenses** | **Array<string>** | 필수 면허 코드 목록. | [optional] [default to undefined]
 **preconditionDesc** | **string** | 자격조건 추가 기입 (최대 1000자). | [optional] [default to undefined]
-**preconditions** | [**PreconditionsDto**](PreconditionsDto.md) | precondition 구조체. V5 precondition 토큰 트리를 modern 명으로 표현. ACL이 backend conditions bag 으로 변환. | [optional] [default to undefined]
+**preconditions** | [**PreconditionsDto**](PreconditionsDto.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. | [optional] [default to undefined]
 **deliveryPeriodDays** | **number** | 납품소요일(일) (deliveryDateType=B 시 사용). 최대 999일(backend deliveryDays 3자리 제한). | [optional] [default to undefined]
@@ -38,6 +38,9 @@ Name | Type | Description | Notes
 **taxationType** | **string** | 과세 유형. A=과세, B=면세, C=면세(의제매입). backend BidTaxationType mirror. | [optional] [default to undefined]
 **isOptionalContract** | **string** | 수의계약 여부. Y=수의계약, N=일반. | [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]
 **contractManager** | [**BidManagerDto**](BidManagerDto.md) | 계약 담당자. | [default to undefined]
 **techManager** | [**BidManagerDto**](BidManagerDto.md) | 기술 담당자. | [default to undefined]
@@ -84,6 +87,9 @@ const instance: CreateBidRequestDto = {
     taxationType,
     isOptionalContract,
     isAnnualContract,
+    nominatedContract,
+    empId,
+    purchaseNo,
     isResultPublished,
     contractManager,
     techManager,

package/docs/MarkBidFailedRequestDto.md

@@ -0,0 +1,26 @@
+# MarkBidFailedRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 유찰 확정 actor. | [default to undefined]
+**bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). | [default to undefined]
+**failureReasonCode** | [**BidFailureReason**](BidFailureReason.md) | 유찰사유 코드(= V5 b2b_buy.sayou). 1~8. | [default to undefined]
+**failureReasonDetail** | **string** | 유찰사유 상세(= V5 b2b_buy.sa_desc). 코드 4[기타] 일 때 필수, 최대 150자. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { MarkBidFailedRequestDto } from '@cmarket/partner-sdk';
+
+const instance: MarkBidFailedRequestDto = {
+    buyerId,
+    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/NegotiationScoreDto.md

@@ -0,0 +1,24 @@
+# NegotiationScoreDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**sequence** | **number** | 응찰 순번(= V5 buy_seq = entendrec 응답의 sequence). | [default to undefined]
+**techPoint** | **number** | 기술점수(0~100, 소수 2자리). | [default to undefined]
+**bidPoint** | **number** | 가격점수 override(선택, = V5 bid_point). 미지정 시 backend 자동계산. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { NegotiationScoreDto } from '@cmarket/partner-sdk';
+
+const instance: NegotiationScoreDto = {
+    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

@@ -0,0 +1,24 @@
+# NegotiationScoredResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidNo** | **string** | 공고 구매번호. | [default to undefined]
+**evaluatedCount** | **number** | 점수 입력된 응찰자 수. | [default to undefined]
+**status** | **string** | 처리 상태. | [default to undefined]
+
+## Example
+
+```typescript
+import { NegotiationScoredResponseDto } from '@cmarket/partner-sdk';
+
+const instance: NegotiationScoredResponseDto = {
+    bidNo,
+    evaluatedCount,
+    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/PartnerV1Api.md

@@ -5,12 +5,12 @@ All URIs are relative to *http://localhost*
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
 |[**bidsControllerFindOne**](#bidscontrollerfindone) | **GET** /v1/bids/{bidId} | 공고 단건 조회|
-|[**healthControllerCheck**](#healthcontrollercheck) | **GET** /v1/health | Partner API 헬스체크 (V5 /check 후속)|
+|[**healthControllerCheck**](#healthcontrollercheck) | **GET** /v1/health | Partner API 헬스체크|
 
 # **bidsControllerFindOne**
 > BidSummaryResponseDto bidsControllerFindOne()
 
-V5 `GET /api/bid/{buyIdx}` 의 V6 후속. ERP 가 공고 정보를 조회합니다. 인증 필요 (스코프 `bids:read`).
+ERP 가 공고 정보를 조회합니다. 인증 필요 (스코프 `bids:read`).
 
 ### Example
 
@@ -62,7 +62,7 @@ const { status, data } = await apiInstance.bidsControllerFindOne(
 # **healthControllerCheck**
 > HealthResponseDto healthControllerCheck()
 
-V5 ApiController#check 의 V6 대체. ERP 연동 직전 회선·인증 endpoint 동작 확인용.
+ERP 연동 직전 회선·인증 endpoint 동작 확인용.
 
 ### Example