@cmarket/partner-sdk 0.6.2 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -2
- package/api/partner-v1-api.ts +106 -59
- package/dist/api/partner-v1-api.d.ts +64 -44
- package/dist/api/partner-v1-api.js +104 -59
- package/dist/esm/api/partner-v1-api.d.ts +64 -44
- package/dist/esm/api/partner-v1-api.js +104 -59
- package/dist/esm/models/bid-document-dto.d.ts +4 -4
- package/dist/esm/models/index.d.ts +1 -0
- package/dist/esm/models/index.js +1 -0
- package/dist/esm/models/problem-details-dto.d.ts +33 -0
- package/dist/esm/models/problem-details-dto.js +14 -0
- package/dist/models/bid-document-dto.d.ts +4 -4
- package/dist/models/index.d.ts +1 -0
- package/dist/models/index.js +1 -0
- package/dist/models/problem-details-dto.d.ts +33 -0
- package/dist/models/problem-details-dto.js +15 -0
- package/docs/BidDocumentDto.md +2 -2
- package/docs/PartnerV1Api.md +52 -12
- package/docs/ProblemDetailsDto.md +28 -0
- package/models/bid-document-dto.ts +4 -4
- package/models/index.ts +1 -0
- package/models/problem-details-dto.ts +39 -0
- package/package.json +1 -1
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CMARKET V6 Partner API
|
|
3
|
+
* 외부 ERP 연동용 RESTful API.
|
|
4
|
+
*
|
|
5
|
+
* The version of the OpenAPI document: 1.0
|
|
6
|
+
*
|
|
7
|
+
*
|
|
8
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
9
|
+
* https://openapi-generator.tech
|
|
10
|
+
* Do not edit the class manually.
|
|
11
|
+
*/
|
|
12
|
+
export interface ProblemDetailsDto {
|
|
13
|
+
/**
|
|
14
|
+
* RFC 9457 에러 식별 URI. SDK 분기 키.
|
|
15
|
+
*/
|
|
16
|
+
'type': string;
|
|
17
|
+
/**
|
|
18
|
+
* 에러 제목(human-readable 요약).
|
|
19
|
+
*/
|
|
20
|
+
'title': string;
|
|
21
|
+
/**
|
|
22
|
+
* HTTP 상태 코드.
|
|
23
|
+
*/
|
|
24
|
+
'status': number;
|
|
25
|
+
/**
|
|
26
|
+
* 에러 상세 설명(human-readable). ValidationPipe 오류 시 세미콜론 구분 목록.
|
|
27
|
+
*/
|
|
28
|
+
'detail': string;
|
|
29
|
+
/**
|
|
30
|
+
* 요청 경로(에러 발생 URI).
|
|
31
|
+
*/
|
|
32
|
+
'instance'?: string;
|
|
33
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/* tslint:disable */
|
|
3
|
+
/* eslint-disable */
|
|
4
|
+
/**
|
|
5
|
+
* CMARKET V6 Partner API
|
|
6
|
+
* 외부 ERP 연동용 RESTful API.
|
|
7
|
+
*
|
|
8
|
+
* The version of the OpenAPI document: 1.0
|
|
9
|
+
*
|
|
10
|
+
*
|
|
11
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
12
|
+
* https://openapi-generator.tech
|
|
13
|
+
* Do not edit the class manually.
|
|
14
|
+
*/
|
|
15
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
package/docs/BidDocumentDto.md
CHANGED
|
@@ -5,9 +5,9 @@
|
|
|
5
5
|
|
|
6
6
|
Name | Type | Description | Notes
|
|
7
7
|
------------ | ------------- | ------------- | -------------
|
|
8
|
-
**paperCode** | **number** | 서류 코드(paperCode). | [default to undefined]
|
|
8
|
+
**paperCode** | **number** | 서류 코드(paperCode). 생략 시 backend 가 paperName 으로 해소. | [optional] [default to undefined]
|
|
9
9
|
**paperName** | **string** | 서류명. | [default to undefined]
|
|
10
|
-
**isAutoGenerated** | **boolean** | 자동생성 여부. | [default to undefined]
|
|
10
|
+
**isAutoGenerated** | **boolean** | 자동생성 여부. 생략 시 backend 가 paper master 기준으로 파생. | [optional] [default to undefined]
|
|
11
11
|
|
|
12
12
|
## Example
|
|
13
13
|
|
package/docs/PartnerV1Api.md
CHANGED
|
@@ -23,7 +23,7 @@ All URIs are relative to *http://localhost*
|
|
|
23
23
|
# **completeAcceptance**
|
|
24
24
|
> AcceptanceResultResponseDto completeAcceptance(completeAcceptanceRequestDto)
|
|
25
25
|
|
|
26
|
-
V5
|
|
26
|
+
낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문. **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
27
27
|
|
|
28
28
|
### Example
|
|
29
29
|
|
|
@@ -37,11 +37,13 @@ import {
|
|
|
37
37
|
const configuration = new Configuration();
|
|
38
38
|
const apiInstance = new PartnerV1Api(configuration);
|
|
39
39
|
|
|
40
|
-
let bidId: string;
|
|
40
|
+
let bidId: string; //공고 ID(= backend bidId = 등록 응답의 bidNo). (default to undefined)
|
|
41
|
+
let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
|
|
41
42
|
let completeAcceptanceRequestDto: CompleteAcceptanceRequestDto; //
|
|
42
43
|
|
|
43
44
|
const { status, data } = await apiInstance.completeAcceptance(
|
|
44
45
|
bidId,
|
|
46
|
+
idempotencyKey,
|
|
45
47
|
completeAcceptanceRequestDto
|
|
46
48
|
);
|
|
47
49
|
```
|
|
@@ -51,7 +53,8 @@ const { status, data } = await apiInstance.completeAcceptance(
|
|
|
51
53
|
|Name | Type | Description | Notes|
|
|
52
54
|
|------------- | ------------- | ------------- | -------------|
|
|
53
55
|
| **completeAcceptanceRequestDto** | **CompleteAcceptanceRequestDto**| | |
|
|
54
|
-
| **bidId** | [**string**] |
|
|
56
|
+
| **bidId** | [**string**] | 공고 ID(= backend bidId = 등록 응답의 bidNo). | defaults to undefined|
|
|
57
|
+
| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
|
|
55
58
|
|
|
56
59
|
|
|
57
60
|
### Return type
|
|
@@ -71,7 +74,12 @@ const { status, data } = await apiInstance.completeAcceptance(
|
|
|
71
74
|
### HTTP response details
|
|
72
75
|
| Status code | Description | Response headers |
|
|
73
76
|
|-------------|-------------|------------------|
|
|
74
|
-
|**200** |
|
|
77
|
+
|**200** | 검수완료 처리 결과. | - |
|
|
78
|
+
|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락(`type: …/idempotency-key-required`). | - |
|
|
79
|
+
|**401** | Bearer 토큰 없음 또는 만료(`type: …/unauthorized`). | - |
|
|
80
|
+
|**403** | 스코프 부족(`type: …/insufficient-scope`) 또는 buyerId 가 키 보유자와 불일치(`type: …/buyer-scope-mismatch`). | - |
|
|
81
|
+
|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). | - |
|
|
82
|
+
|**502** | backend 도메인 거부 — 공고 상태 불일치, 낙찰자 미존재 등(`type: …/upstream-rejected`). | - |
|
|
75
83
|
|
|
76
84
|
[[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)
|
|
77
85
|
|
|
@@ -439,7 +447,7 @@ No authorization required
|
|
|
439
447
|
# **markBidFailed**
|
|
440
448
|
> BidFailedResponseDto markBidFailed(markBidFailedRequestDto)
|
|
441
449
|
|
|
442
|
-
유찰
|
|
450
|
+
공고를 유찰 상태로 전환합니다. **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다. **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 | **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
443
451
|
|
|
444
452
|
### Example
|
|
445
453
|
|
|
@@ -453,9 +461,11 @@ import {
|
|
|
453
461
|
const configuration = new Configuration();
|
|
454
462
|
const apiInstance = new PartnerV1Api(configuration);
|
|
455
463
|
|
|
464
|
+
let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
|
|
456
465
|
let markBidFailedRequestDto: MarkBidFailedRequestDto; //
|
|
457
466
|
|
|
458
467
|
const { status, data } = await apiInstance.markBidFailed(
|
|
468
|
+
idempotencyKey,
|
|
459
469
|
markBidFailedRequestDto
|
|
460
470
|
);
|
|
461
471
|
```
|
|
@@ -465,6 +475,7 @@ const { status, data } = await apiInstance.markBidFailed(
|
|
|
465
475
|
|Name | Type | Description | Notes|
|
|
466
476
|
|------------- | ------------- | ------------- | -------------|
|
|
467
477
|
| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**| | |
|
|
478
|
+
| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
|
|
468
479
|
|
|
469
480
|
|
|
470
481
|
### Return type
|
|
@@ -484,7 +495,12 @@ const { status, data } = await apiInstance.markBidFailed(
|
|
|
484
495
|
### HTTP response details
|
|
485
496
|
| Status code | Description | Response headers |
|
|
486
497
|
|-------------|-------------|------------------|
|
|
487
|
-
|**201** |
|
|
498
|
+
|**201** | 유찰 처리 완료. | - |
|
|
499
|
+
|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락(`type: …/idempotency-key-required`). 코드 4 인데 failureReasonDetail 없으면 400. | - |
|
|
500
|
+
|**401** | Bearer 토큰 없음 또는 만료(`type: …/unauthorized`). | - |
|
|
501
|
+
|**403** | 스코프 부족(`type: …/insufficient-scope`) 또는 buyerId 가 키 보유자와 불일치(`type: …/buyer-scope-mismatch`). | - |
|
|
502
|
+
|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). | - |
|
|
503
|
+
|**502** | backend 도메인 거부 — 공고 상태 불일치 등(`type: …/upstream-rejected`). | - |
|
|
488
504
|
|
|
489
505
|
[[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)
|
|
490
506
|
|
|
@@ -542,7 +558,7 @@ void (empty response body)
|
|
|
542
558
|
# **registerAward**
|
|
543
559
|
> AwardRegisteredResponseDto registerAward(registerAwardRequestDto)
|
|
544
560
|
|
|
545
|
-
낙찰
|
|
561
|
+
낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다. **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다. **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다. **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
546
562
|
|
|
547
563
|
### Example
|
|
548
564
|
|
|
@@ -556,9 +572,11 @@ import {
|
|
|
556
572
|
const configuration = new Configuration();
|
|
557
573
|
const apiInstance = new PartnerV1Api(configuration);
|
|
558
574
|
|
|
575
|
+
let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
|
|
559
576
|
let registerAwardRequestDto: RegisterAwardRequestDto; //
|
|
560
577
|
|
|
561
578
|
const { status, data } = await apiInstance.registerAward(
|
|
579
|
+
idempotencyKey,
|
|
562
580
|
registerAwardRequestDto
|
|
563
581
|
);
|
|
564
582
|
```
|
|
@@ -568,6 +586,7 @@ const { status, data } = await apiInstance.registerAward(
|
|
|
568
586
|
|Name | Type | Description | Notes|
|
|
569
587
|
|------------- | ------------- | ------------- | -------------|
|
|
570
588
|
| **registerAwardRequestDto** | **RegisterAwardRequestDto**| | |
|
|
589
|
+
| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
|
|
571
590
|
|
|
572
591
|
|
|
573
592
|
### Return type
|
|
@@ -587,7 +606,12 @@ const { status, data } = await apiInstance.registerAward(
|
|
|
587
606
|
### HTTP response details
|
|
588
607
|
| Status code | Description | Response headers |
|
|
589
608
|
|-------------|-------------|------------------|
|
|
590
|
-
|**201** |
|
|
609
|
+
|**201** | 낙찰 등록 완료. | - |
|
|
610
|
+
|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락(`type: …/idempotency-key-required`). | - |
|
|
611
|
+
|**401** | Bearer 토큰 없음 또는 만료(`type: …/unauthorized`). | - |
|
|
612
|
+
|**403** | 스코프 부족(`type: …/insufficient-scope`) 또는 buyerId 가 키 보유자와 불일치(`type: …/buyer-scope-mismatch`). | - |
|
|
613
|
+
|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). | - |
|
|
614
|
+
|**502** | backend 도메인 거부 — 공고 상태 불일치, 낙찰자 미존재 등(`type: …/upstream-rejected`). | - |
|
|
591
615
|
|
|
592
616
|
[[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)
|
|
593
617
|
|
|
@@ -646,7 +670,7 @@ const { status, data } = await apiInstance.registerBid(
|
|
|
646
670
|
# **requestSplitInvoice**
|
|
647
671
|
> SplitInvoiceResponseDto requestSplitInvoice(requestSplitInvoiceRequestDto)
|
|
648
672
|
|
|
649
|
-
V5
|
|
673
|
+
세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다. **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속. **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다. **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용. **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액. **필수 스코프:** `invoices:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
650
674
|
|
|
651
675
|
### Example
|
|
652
676
|
|
|
@@ -660,9 +684,11 @@ import {
|
|
|
660
684
|
const configuration = new Configuration();
|
|
661
685
|
const apiInstance = new PartnerV1Api(configuration);
|
|
662
686
|
|
|
687
|
+
let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
|
|
663
688
|
let requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto; //
|
|
664
689
|
|
|
665
690
|
const { status, data } = await apiInstance.requestSplitInvoice(
|
|
691
|
+
idempotencyKey,
|
|
666
692
|
requestSplitInvoiceRequestDto
|
|
667
693
|
);
|
|
668
694
|
```
|
|
@@ -672,6 +698,7 @@ const { status, data } = await apiInstance.requestSplitInvoice(
|
|
|
672
698
|
|Name | Type | Description | Notes|
|
|
673
699
|
|------------- | ------------- | ------------- | -------------|
|
|
674
700
|
| **requestSplitInvoiceRequestDto** | **RequestSplitInvoiceRequestDto**| | |
|
|
701
|
+
| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
|
|
675
702
|
|
|
676
703
|
|
|
677
704
|
### Return type
|
|
@@ -691,14 +718,19 @@ const { status, data } = await apiInstance.requestSplitInvoice(
|
|
|
691
718
|
### HTTP response details
|
|
692
719
|
| Status code | Description | Response headers |
|
|
693
720
|
|-------------|-------------|------------------|
|
|
694
|
-
|**200** |
|
|
721
|
+
|**200** | 분할 발급 청구 접수 완료. | - |
|
|
722
|
+
|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락(`type: …/idempotency-key-required`). issueDate 가 미래 일자인 경우도 400. | - |
|
|
723
|
+
|**401** | Bearer 토큰 없음 또는 만료(`type: …/unauthorized`). | - |
|
|
724
|
+
|**403** | 스코프 부족(`type: …/insufficient-scope`) 또는 buyerId 가 키 보유자와 불일치(`type: …/buyer-scope-mismatch`). | - |
|
|
725
|
+
|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). | - |
|
|
726
|
+
|**502** | backend 도메인 거부 — 공고 상태 불일치, 이미 청구 완료 등(`type: …/upstream-rejected`). | - |
|
|
695
727
|
|
|
696
728
|
[[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)
|
|
697
729
|
|
|
698
730
|
# **submitNegotiationScores**
|
|
699
731
|
> NegotiationScoredResponseDto submitNegotiationScores(submitNegotiationScoresRequestDto)
|
|
700
732
|
|
|
701
|
-
협상에의한계약(H/K) 응찰자별 기술/가격
|
|
733
|
+
협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다. **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속. **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다. **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다. **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
702
734
|
|
|
703
735
|
### Example
|
|
704
736
|
|
|
@@ -712,9 +744,11 @@ import {
|
|
|
712
744
|
const configuration = new Configuration();
|
|
713
745
|
const apiInstance = new PartnerV1Api(configuration);
|
|
714
746
|
|
|
747
|
+
let idempotencyKey: string; //멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. (default to undefined)
|
|
715
748
|
let submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto; //
|
|
716
749
|
|
|
717
750
|
const { status, data } = await apiInstance.submitNegotiationScores(
|
|
751
|
+
idempotencyKey,
|
|
718
752
|
submitNegotiationScoresRequestDto
|
|
719
753
|
);
|
|
720
754
|
```
|
|
@@ -724,6 +758,7 @@ const { status, data } = await apiInstance.submitNegotiationScores(
|
|
|
724
758
|
|Name | Type | Description | Notes|
|
|
725
759
|
|------------- | ------------- | ------------- | -------------|
|
|
726
760
|
| **submitNegotiationScoresRequestDto** | **SubmitNegotiationScoresRequestDto**| | |
|
|
761
|
+
| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장. | defaults to undefined|
|
|
727
762
|
|
|
728
763
|
|
|
729
764
|
### Return type
|
|
@@ -743,7 +778,12 @@ const { status, data } = await apiInstance.submitNegotiationScores(
|
|
|
743
778
|
### HTTP response details
|
|
744
779
|
| Status code | Description | Response headers |
|
|
745
780
|
|-------------|-------------|------------------|
|
|
746
|
-
|**201** |
|
|
781
|
+
|**201** | 점수 입력 완료. | - |
|
|
782
|
+
|**400** | 입력 검증 실패(`type: …/validation-failed`) 또는 Idempotency-Key 헤더 누락(`type: …/idempotency-key-required`). scores 배열이 비어 있거나 sequence 중복 시 400. | - |
|
|
783
|
+
|**401** | Bearer 토큰 없음 또는 만료(`type: …/unauthorized`). | - |
|
|
784
|
+
|**403** | 스코프 부족(`type: …/insufficient-scope`) 또는 buyerId 가 키 보유자와 불일치(`type: …/buyer-scope-mismatch`). | - |
|
|
785
|
+
|**409** | 동일 Idempotency-Key 로 다른 body 재전송(`type: …/idempotency-key-conflict`). | - |
|
|
786
|
+
|**502** | backend 도메인 거부 — 공고 상태 불일치, 응찰자 미존재 등(`type: …/upstream-rejected`). | - |
|
|
747
787
|
|
|
748
788
|
[[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)
|
|
749
789
|
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# ProblemDetailsDto
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
## Properties
|
|
5
|
+
|
|
6
|
+
Name | Type | Description | Notes
|
|
7
|
+
------------ | ------------- | ------------- | -------------
|
|
8
|
+
**type** | **string** | RFC 9457 에러 식별 URI. SDK 분기 키. | [default to undefined]
|
|
9
|
+
**title** | **string** | 에러 제목(human-readable 요약). | [default to undefined]
|
|
10
|
+
**status** | **number** | HTTP 상태 코드. | [default to undefined]
|
|
11
|
+
**detail** | **string** | 에러 상세 설명(human-readable). ValidationPipe 오류 시 세미콜론 구분 목록. | [default to undefined]
|
|
12
|
+
**instance** | **string** | 요청 경로(에러 발생 URI). | [optional] [default to undefined]
|
|
13
|
+
|
|
14
|
+
## Example
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
import { ProblemDetailsDto } from '@cmarket/partner-sdk';
|
|
18
|
+
|
|
19
|
+
const instance: ProblemDetailsDto = {
|
|
20
|
+
type,
|
|
21
|
+
title,
|
|
22
|
+
status,
|
|
23
|
+
detail,
|
|
24
|
+
instance,
|
|
25
|
+
};
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
|
|
@@ -16,16 +16,16 @@
|
|
|
16
16
|
|
|
17
17
|
export interface BidDocumentDto {
|
|
18
18
|
/**
|
|
19
|
-
* 서류 코드(paperCode).
|
|
19
|
+
* 서류 코드(paperCode). 생략 시 backend 가 paperName 으로 해소.
|
|
20
20
|
*/
|
|
21
|
-
'paperCode'
|
|
21
|
+
'paperCode'?: number;
|
|
22
22
|
/**
|
|
23
23
|
* 서류명.
|
|
24
24
|
*/
|
|
25
25
|
'paperName': string;
|
|
26
26
|
/**
|
|
27
|
-
* 자동생성 여부.
|
|
27
|
+
* 자동생성 여부. 생략 시 backend 가 paper master 기준으로 파생.
|
|
28
28
|
*/
|
|
29
|
-
'isAutoGenerated'
|
|
29
|
+
'isAutoGenerated'?: boolean;
|
|
30
30
|
}
|
|
31
31
|
|
package/models/index.ts
CHANGED
|
@@ -29,6 +29,7 @@ export * from './mark-bid-failed-request-dto';
|
|
|
29
29
|
export * from './negotiation-score-dto';
|
|
30
30
|
export * from './negotiation-scored-response-dto';
|
|
31
31
|
export * from './preconditions-dto';
|
|
32
|
+
export * from './problem-details-dto';
|
|
32
33
|
export * from './register-award-request-dto';
|
|
33
34
|
export * from './request-split-invoice-request-dto';
|
|
34
35
|
export * from './split-invoice-response-dto';
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* CMARKET V6 Partner API
|
|
5
|
+
* 외부 ERP 연동용 RESTful API.
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 1.0
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
export interface ProblemDetailsDto {
|
|
18
|
+
/**
|
|
19
|
+
* RFC 9457 에러 식별 URI. SDK 분기 키.
|
|
20
|
+
*/
|
|
21
|
+
'type': string;
|
|
22
|
+
/**
|
|
23
|
+
* 에러 제목(human-readable 요약).
|
|
24
|
+
*/
|
|
25
|
+
'title': string;
|
|
26
|
+
/**
|
|
27
|
+
* HTTP 상태 코드.
|
|
28
|
+
*/
|
|
29
|
+
'status': number;
|
|
30
|
+
/**
|
|
31
|
+
* 에러 상세 설명(human-readable). ValidationPipe 오류 시 세미콜론 구분 목록.
|
|
32
|
+
*/
|
|
33
|
+
'detail': string;
|
|
34
|
+
/**
|
|
35
|
+
* 요청 경로(에러 발생 URI).
|
|
36
|
+
*/
|
|
37
|
+
'instance'?: string;
|
|
38
|
+
}
|
|
39
|
+
|