@cmarket/partner-sdk 0.1.0 → 0.3.0

package/docs/RegisterAwardRequestDto.md

@@ -5,9 +5,11 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 낙찰 확정 actor. V5 bid_branch_id. | [default to undefined]
+**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 낙찰 확정 actor. | [default to undefined]
 **bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). | [default to undefined]
 **winnerMemberId** | **string** | 낙찰자(공급사) memberId. | [default to undefined]
+**winnerSequence** | **number** | 낙찰자 응찰 순번(= V5 entendrec 응답의 sequence = buy_seq). 복수응찰 시 정확한 응찰행을 지정. 없으면 winnerMemberId 로 첫 응찰행 해소(기존 폴백). | [optional] [default to undefined]
+**accDeliDate** | **string** | 납품일자 override(= V5 acc_deli_date). buy_deli_day_type 이 A/B 면 delivery_date(앞 10자), 그 외면 buy_deli_day(자유텍스트)를 덮어쓴다. 없으면 공고 기존 납품일자 유지. | [optional] [default to undefined]
 
 ## Example
 
@@ -18,6 +20,8 @@ const instance: RegisterAwardRequestDto = {
     buyerId,
     bidNo,
     winnerMemberId,
+    winnerSequence,
+    accDeliDate,
 };
 ```
 

package/docs/RequestSplitInvoiceRequestDto.md

@@ -0,0 +1,28 @@
+# RequestSplitInvoiceRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). | [default to undefined]
+**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id). | [default to undefined]
+**supplyAmount** | **number** | 공급가액(원). | [default to undefined]
+**vat** | **number** | 부가세(원). | [default to undefined]
+**issueDate** | **string** | 발급 희망일(ISO 8601 date). 미지정 시 backend 기본값. 미래일자는 거부(I5). | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { RequestSplitInvoiceRequestDto } from '@cmarket/partner-sdk';
+
+const instance: RequestSplitInvoiceRequestDto = {
+    bidNo,
+    buyerId,
+    supplyAmount,
+    vat,
+    issueDate,
+};
+```
+
+[[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/SplitInvoiceResponseDto.md

@@ -0,0 +1,22 @@
+# SplitInvoiceResponseDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidNo** | **string** | 공고 구매번호. | [default to undefined]
+**requested** | **boolean** | 분할 발급 청구 접수 여부. | [default to undefined]
+
+## Example
+
+```typescript
+import { SplitInvoiceResponseDto } from '@cmarket/partner-sdk';
+
+const instance: SplitInvoiceResponseDto = {
+    bidNo,
+    requested,
+};
+```
+
+[[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/StatementDocumentDto.md

@@ -0,0 +1,24 @@
+# StatementDocumentDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**paperCode** | **number** | 문서 종류 코드 (paperCode). | [default to undefined]
+**fileName** | **object** | 파일명. 미발급 시 null. | [default to undefined]
+**fileUrl** | **object** | 파일 다운로드 URL. 미발급 시 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { StatementDocumentDto } from '@cmarket/partner-sdk';
+
+const instance: StatementDocumentDto = {
+    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/StatementProductDto.md

@@ -0,0 +1,36 @@
+# StatementProductDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**productName** | **object** | 품목명. 미지정 시 null. | [default to undefined]
+**quantity** | **number** | 수량. | [default to undefined]
+**unitPrice** | **number** | 단가. | [default to undefined]
+**supplyAmount** | **number** | 공급가액. | [default to undefined]
+**vat** | **number** | 부가세. | [default to undefined]
+**total** | **number** | 합계금액 (공급가액 + 부가세). | [default to undefined]
+**lineSeq** | **object** | 품목 라인 순번. 미설정 시 null. | [default to undefined]
+**productCode** | **object** | 품목 코드. 미설정 시 null. | [default to undefined]
+**spec** | **object** | 규격. 미설정 시 null. | [default to undefined]
+
+## Example
+
+```typescript
+import { StatementProductDto } from '@cmarket/partner-sdk';
+
+const instance: StatementProductDto = {
+    productName,
+    quantity,
+    unitPrice,
+    supplyAmount,
+    vat,
+    total,
+    lineSeq,
+    productCode,
+    spec,
+};
+```
+
+[[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/SubmitNegotiationScoresRequestDto.md

@@ -0,0 +1,26 @@
+# SubmitNegotiationScoresRequestDto
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**buyerId** | **string** | 공고 명의 회원 ID(b2b_member.member_id) = 평가 actor. | [default to undefined]
+**bidNo** | **string** | 공고 구매번호(등록 응답의 bidNo). | [default to undefined]
+**scores** | [**Array<NegotiationScoreDto>**](NegotiationScoreDto.md) | 응찰자별 점수 배열(= V5 evals). sequence(= buy_seq) 키, 1명 이상·중복 불가. | [default to undefined]
+**complete** | **boolean** | true 면 점수 입력 직후 평가완료 게이트까지 적용(낙찰 진입 가능). 생략 시 점수만 입력. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { SubmitNegotiationScoresRequestDto } from '@cmarket/partner-sdk';
+
+const instance: SubmitNegotiationScoresRequestDto = {
+    buyerId,
+    bidNo,
+    scores,
+    complete,
+};
+```
+
+[[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,7 +2,7 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API. V5 17개 엔드포인트의 V6 후속.
+ * 외부 ERP 연동용 RESTful API.
  *
  * The version of the OpenAPI document: 1.0
  * 

package/models/acceptance-result-response-dto.ts

@@ -0,0 +1,27 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface AcceptanceResultResponseDto {
+    /**
+     * 공고 ID(= backend bidId).
+     */
+    'bidId': string;
+    /**
+     * 검수완료 처리 여부.
+     */
+    'accepted': boolean;
+}
+

package/models/award-registered-response-dto.ts

@@ -2,7 +2,7 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API. V5 17개 엔드포인트의 V6 후속.
+ * 외부 ERP 연동용 RESTful API.
  *
  * The version of the OpenAPI document: 1.0
  * 

package/models/bid-bond-dto.ts

@@ -2,7 +2,7 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API. V5 17개 엔드포인트의 V6 후속.
+ * 외부 ERP 연동용 RESTful API.
  *
  * The version of the OpenAPI document: 1.0
  * 

package/models/bid-contract-documents-batch-request-dto.ts

@@ -0,0 +1,27 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface BidContractDocumentsBatchRequestDto {
+    /**
+     * 조회할 공고 구매번호(등록 응답의 bidNo) 목록.
+     */
+    'bidNos': Array<string>;
+    /**
+     * 공고 명의 회원 ID(b2b_member.member_id).
+     */
+    'buyerId': string;
+}
+

package/models/bid-contract-documents-response-dto.ts

@@ -0,0 +1,34 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+// May contain unused imports in some cases
+// @ts-ignore
+import type { ContractDocumentItemDto } from './contract-document-item-dto';
+
+export interface BidContractDocumentsResponseDto {
+    /**
+     * 공고 구매번호.
+     */
+    'bidNo': string;
+    /**
+     * 계약 서류 파일 목록.
+     */
+    'documents': Array<ContractDocumentItemDto>;
+    /**
+     * 납품 기한 (ISO 날짜). 미설정 시 null.
+     */
+    'deliveryDate': string | null;
+}
+

package/models/bid-created-response-dto.ts

@@ -2,7 +2,7 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API. V5 17개 엔드포인트의 V6 후속.
+ * 외부 ERP 연동용 RESTful API.
  *
  * The version of the OpenAPI document: 1.0
  * 

package/models/bid-document-dto.ts

@@ -2,7 +2,7 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API. V5 17개 엔드포인트의 V6 후속.
+ * 외부 ERP 연동용 RESTful API.
  *
  * The version of the OpenAPI document: 1.0
  * 

package/models/bid-failed-response-dto.ts

@@ -0,0 +1,27 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface BidFailedResponseDto {
+    /**
+     * 공고 구매번호.
+     */
+    'bidNo': string;
+    /**
+     * 처리 상태.
+     */
+    'status': string;
+}
+

package/models/bid-failure-reason.ts

@@ -0,0 +1,35 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+/**
+ * 유찰사유 코드(= V5 b2b_buy.sayou). 1~8.
+ */
+
+export const BidFailureReason = {
+    _1: '1',
+    _2: '2',
+    _3: '3',
+    _4: '4',
+    _5: '5',
+    _6: '6',
+    _7: '7',
+    _8: '8',
+} as const;
+
+export type BidFailureReason = typeof BidFailureReason[keyof typeof BidFailureReason];
+
+
+

package/models/bid-item-dto.ts

@@ -2,7 +2,7 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API. V5 17개 엔드포인트의 V6 후속.
+ * 외부 ERP 연동용 RESTful API.
  *
  * The version of the OpenAPI document: 1.0
  * 

package/models/bid-manager-dto.ts

@@ -2,7 +2,7 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API. V5 17개 엔드포인트의 V6 후속.
+ * 외부 ERP 연동용 RESTful API.
  *
  * The version of the OpenAPI document: 1.0
  * 
@@ -27,5 +27,13 @@ export interface BidManagerDto {
      * 이메일.
      */
     'email': string;
+    /**
+     * 부서. (계약담당자 → V5 mem_part)
+     */
+    'department'?: string;
+    /**
+     * 팩스. 계약담당자에만 적용 (V5 mem_fax) — 기술담당자에는 미반영.
+     */
+    'fax'?: string;
 }
 

package/models/bid-result-participant-dto.ts

@@ -0,0 +1,71 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface BidResultParticipantDto {
+    /**
+     * 참여 순번.
+     */
+    'sequence': number;
+    /**
+     * 참여 업체 ID (마감 후 발주기관만 확인 가능).
+     */
+    'companyId'?: string;
+    /**
+     * 참여 업체명.
+     */
+    'companyName'?: string;
+    /**
+     * 투찰금액(원). 진행중·마스킹 시 미노출.
+     */
+    'bidPrice'?: number;
+    /**
+     * 순위 (낙찰 매트릭스 정렬 기준).
+     */
+    'rank'?: number;
+    /**
+     * 낙찰 여부. 다수업체 낙찰(M)에서는 여러 row 가 동시에 true 가능.
+     */
+    'isWinner': boolean;
+    /**
+     * 참여일시 (ISO 8601 UTC).
+     */
+    'joinedAt'?: string;
+    /**
+     * 납품가능 총 수량 — 최다수량(D) 낙찰방법에서만 의미를 가진다 (V5 join_bid_count, 낙찰 비교 기준값). 그 외 공고·마스킹 시 null.
+     */
+    'bidCount'?: number;
+    /**
+     * 견적서 PDF 파일명 (V5 join_file). 신원 마스킹 또는 미첨부 시 null. 다운로드는 quoteFileKey 사용.
+     */
+    'quoteFileName'?: string;
+    /**
+     * 견적서 PDF 파일키 (32자 nanoid). backend storage 다운로드 엔드포인트에 전달. V5 legacy 단일컬럼 폴백/마스킹 시 null.
+     */
+    'quoteFileKey'?: string;
+    /**
+     * 담당자명 (V5 mem_name). 마스킹 시 null.
+     */
+    'managerName'?: string;
+    /**
+     * 담당자 연락처 (V5 mem_tel/mem_phon). 마스킹 시 null.
+     */
+    'managerPhone'?: string;
+    /**
+     * 담당자 이메일 (V5 mem_email). 마스킹 시 null.
+     */
+    'managerEmail'?: string;
+}
+

package/models/bid-result-product-dto.ts

@@ -0,0 +1,31 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface BidResultProductDto {
+    /**
+     * 품목명.
+     */
+    'productName': string;
+    /**
+     * 수량.
+     */
+    'quantity'?: number;
+    /**
+     * 단가(원).
+     */
+    'unitPrice'?: number;
+}
+

package/models/bid-result-winner-dto.ts

@@ -0,0 +1,31 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface BidResultWinnerDto {
+    /**
+     * 낙찰업체 ID.
+     */
+    'winnerMemberId': string | null;
+    /**
+     * 낙찰금액(원).
+     */
+    'winningAmount': number | null;
+    /**
+     * 낙찰일시 (ISO 8601 UTC).
+     */
+    'winningDate': string | null;
+}
+

package/models/bid-results-batch-request-dto.ts

@@ -0,0 +1,27 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+export interface BidResultsBatchRequestDto {
+    /**
+     * 공고 명의 회원 ID (멀티테넌트).
+     */
+    'buyerId': string;
+    /**
+     * 조회할 공고 식별자 목록. 빈 배열이면 빈 결과. 최대 100건.
+     */
+    'bidIds': Array<string>;
+}
+

package/models/bid-results-response-dto.ts

@@ -0,0 +1,68 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.
+ *
+ * The version of the OpenAPI document: 1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+// May contain unused imports in some cases
+// @ts-ignore
+import type { BidResultParticipantDto } from './bid-result-participant-dto';
+// May contain unused imports in some cases
+// @ts-ignore
+import type { BidResultProductDto } from './bid-result-product-dto';
+// May contain unused imports in some cases
+// @ts-ignore
+import type { BidResultWinnerDto } from './bid-result-winner-dto';
+
+export interface BidResultsResponseDto {
+    /**
+     * 공고 식별자.
+     */
+    'bidId': string;
+    /**
+     * 공고 상태 코드 (BidStatus enum).
+     */
+    'status': string;
+    /**
+     * 공고 상태 한국어 레이블.
+     */
+    'statusText'?: string;
+    /**
+     * 공고 취소 여부 (status 와 직교하는 별도 레이어).
+     */
+    'isCancelled'?: boolean;
+    /**
+     * 유찰사유 코드.
+     */
+    'failureReasonCode'?: string;
+    /**
+     * 유찰사유 텍스트.
+     */
+    'failureReasonText'?: string;
+    /**
+     * 총 참여(투찰) 업체 수.
+     */
+    'participantCount': number;
+    /**
+     * 낙찰 요약. 낙찰 정보가 없으면 null (유찰/진행중).
+     */
+    'winner': BidResultWinnerDto | null;
+    /**
+     * 참여(투찰) 업체 목록. 가격/신원은 backend 매트릭스 적용 결과.
+     */
+    'participants': Array<BidResultParticipantDto>;
+    /**
+     * 공고 품목 목록.
+     */
+    'products': Array<BidResultProductDto>;
+}
+