@cmarket/partner-sdk 3.0.1 → 4.0.1

package/README.md

@@ -2,16 +2,18 @@
 
 # CMARKET V6 Partner SDK
 
-CMARKET V6 Partner API 의 공식 클라이언트 SDK — 외부 ERP 가 입찰 등록부터 낙찰·계약서류·검수·정산까지 전 흐름을 연동하기 위한 7개 API 를 타입 안전하게 호출합니다.
+CMARKET V6 Partner API 의 공식 클라이언트 SDK — 외부 ERP 가 입찰 등록부터 낙찰·검수·정산까지 전 흐름을 타입 안전하게 연동합니다.
 
 > 이 상단 섹션(설치·인증·통합 순서·에러·예제)은 CMARKET 가 관리하는 quickstart 입니다. 그 아래 `---` 구분선 이후는 OpenAPI Generator 가 매 릴리스 생성하는 **전체 엔드포인트/모델 레퍼런스**입니다.
 
+신규 파트너는 **`/v2` (OAuth2)** 경로를 기본으로 사용하세요. **`/v1` (platform-auth)** 은 V5 호환 대체 경로입니다. `/v2` 는 8개 핵심 operation 으로 축소된 표면이며, 협상점수평가·분할계산서·계약서류조회·입찰결과 배치조회는 **`/v1` 에서만** 제공됩니다(아래 "통합 순서" 표 참조).
+
 ## 설치 (Installation)
 
 TypeScript / Node (npm):
 
 ```bash
-npm install @cmarket/partner-sdk@3.0.1
+npm install @cmarket/partner-sdk@4.0.1
 ```
 
 Java (Maven):
@@ -20,175 +22,273 @@ Java (Maven):
 <dependency>
   <groupId>net.c-market</groupId>
   <artifactId>partner-sdk</artifactId>
-  <version>3.0.1</version>
+  <version>4.0.1</version>
 </dependency>
 ```
 
 ## Base URL
 
-```
-https://partner-api.c-market.net   # 예시 — 확정 도메인 아님
-```
+단일 base URL 만 사용합니다 — operation 경로에 이미 `/v2` 또는 `/v1` 이 포함되므로 **base 에 버전을 붙이지 마세요**.
 
-환경별(staging/production) baseURL 과 client_id / client_secret 은 파트너 온보딩 시 개별 발급·안내됩니다. 아래 예제의 baseURL 은 발급받은 값으로 교체하세요.
+| 환경       | Base URL                                   |
+| ---------- | ------------------------------------------ |
+| production | `https://partner-api.c-market.net`         |
+| staging    | `https://partner-api.staging.c-market.net` |
 
-## 인증 (Authentication) — OAuth 2.0 Client Credentials
+`client_id` / `client_secret`(또는 `/v1` 의 platform id/secret)은 온보딩 시 CMARKET 운영팀이 파트너별로 발급·안내합니다.
 
-모든 호출은 OAuth 2.0 client_credentials 그랜트(RFC 6749 §4.4)로 발급한 JWT access token 을 `Authorization: Bearer <token>` 헤더로 실어야 합니다.
+## 인증 (Authentication)
 
-1. 토큰 발급: `POST {BASE}/v1/oauth/token`
+### `/v2` — OAuth2 Client Credentials (권장)
+
+`/v2` 호출은 OAuth2 client_credentials 그랜트(RFC 6749 §4.4)로 발급한 JWT access token 을 `Authorization: Bearer <token>` 헤더에 실어야 합니다.
+
+1. 토큰 발급: `POST {BASE}/oauth/token` (버전 prefix 없음)
    - body(form 또는 JSON): `grant_type=client_credentials`, `client_id`, `client_secret`, (선택) `scope` (space-separated)
    - 응답(RFC 6749 §5.1, snake_case): `{ access_token, token_type: "Bearer", expires_in, scope }`
-   - access_token TTL 은 짧습니다(현재 900초/15분) — 만료 시 재발급하세요.
-2. 이후 모든 비즈니스 호출에 `Authorization: Bearer <access_token>` 부착.
+   - access_token 은 JWT 이며 TTL 900초(15분) — `iss=cmarket-partner-api`, `aud=cmarket-v6-partners`. 만료 시 재발급하세요.
+2. 이후 모든 `/v2` 호출에 `Authorization: Bearer <access_token>` 부착.
+
+### `/v1` — platform-auth (V5 호환 대체)
 
-### 스코프 (Scopes)
+`/v1` 은 V5 와 동일한 platform-auth 방식입니다. OAuth·스코프 없이 두 헤더로 인증하며, 권한은 group_code 로 결정됩니다.
 
-토큰은 파트너에 부여된 스코프 범위 내에서 발급되며, 각 엔드포인트는 아래 스코프를 요구합니다(미보유 시 403).
+- `X-Platform-Id`: `cate_set.api_id`
+- `X-Platform-Secret`: `cate_set.api_secret` (MD5-hex)
+- 자격증명이 유효하지 않으면 **503** 으로 응답합니다(V5 충실 동작).
 
-| Scope             | 용도                                                                       |
-| ----------------- | -------------------------------------------------------------------------- |
-| `bids:read`       | 입찰 결과/정산 조회 (getBidResults, getBidSettlement)                      |
-| `bids:write`      | 입찰 등록 (registerBid)                                                    |
-| `awards:write`    | 낙찰·유찰·협상점수 (registerAward, markBidFailed, submitNegotiationScores) |
-| `contracts:read`  | 계약서류·거래명세서 조회 (getBidContractDocuments, getBidStatement)        |
-| `contracts:write` | 검수완료 (completeAcceptance)                                              |
-| `invoices:write`  | 분할 계산서 요청 (requestSplitInvoice)                                     |
-| `files:write`     | 첨부파일 업로드 (uploadFile)                                               |
+## 스코프 (Scopes) — `/v2` 8개 operation
+
+토큰은 파트너에 부여된 스코프 범위 내에서만 발급됩니다. 각 `/v2` operation 이 요구하는 스코프는 다음과 같습니다(미보유 시 403 `insufficient-scope`, `WWW-Authenticate` 헤더에 필요한 scope 명시).
+
+| operation            | 메서드 / 경로    | scope             | 용도                          |
+| -------------------- | ---------------- | ----------------- | ----------------------------- |
+| `registerBid`        | POST `/v2/bids`  | `bids:write`      | 입찰 등록                     |
+| `getBidResults`      | GET `/v2/...`    | `bids:read`       | 응찰 결과 조회                |
+| `getBidSettlement`   | GET `/v2/...`    | `bids:read`       | 정산(사업자·계좌·공급가) 조회 |
+| `getBidStatement`    | GET `/v2/...`    | `contracts:read`  | 거래명세서 조회               |
+| `completeAcceptance` | POST `/v2/...`   | `contracts:write` | 검수완료 통지                 |
+| `registerAward`      | POST `/v2/...`   | `awards:write`    | 낙찰 결과 전송                |
+| `markBidFailed`      | POST `/v2/...`   | `awards:write`    | 유찰 처리                     |
+| `uploadFile`         | POST `/v2/files` | `files:write`     | 첨부파일 업로드               |
+
+> 정확한 경로·요청/응답 스키마는 `---` 아래 자동 생성 레퍼런스를 정본(canonical)으로 삼으세요.
 
 ## 멱등성 (Idempotency)
 
 모든 write(POST) 엔드포인트는 `Idempotency-Key` 헤더가 **필수**입니다.
 
-- 키 포맷: 1~255자, `[A-Za-z0-9_-]`. 호출 단위로 클라이언트가 고유 값(예: UUID) 생성.
-- 같은 키 + 같은 body 로 재전송하면 핸들러를 다시 실행하지 않고 **최초 응답을 그대로 replay**(기본 24시간) — 네트워크 재시도가 안전합니다.
-- 대상: registerBid, registerAward, markBidFailed, submitNegotiationScores, completeAcceptance, requestSplitInvoice, uploadFile.
+- 대상(`/v2`): `registerBid`, `completeAcceptance`, `registerAward`, `markBidFailed`, `uploadFile`.
+- 키 포맷: 1~255자, `[A-Za-z0-9_-]` (예: UUID). 호출 단위로 클라이언트가 고유 값을 생성.
+- 같은 키 + 같은 body 로 재전송하면 핸들러를 재실행하지 않고 **최초 응답을 그대로 replay**(24시간) — 네트워크 재시도가 안전합니다.
+- 같은 키에 다른 body 를 보내면 409 `idempotency-key-conflict`.
 
-## 에러 (Errors) — RFC 9457 problem+json
+## 에러 (Errors)
 
-오류 응답은 `application/problem+json` 입니다.
+비즈니스 엔드포인트는 RFC 9457 `application/problem+json` 을 반환합니다.
 
 ```json
 {
-  "type": "https://.../errors/...",
+  "type": "https://problems.cmarket.io/partner/validation-failed",
   "title": "사람이 읽는 요약",
   "status": 400,
-  "detail": "구체적 원인"
+  "detail": "구체적 원인",
+  "instance": "/v2/bids"
 }
 ```
 
-`status` 로 분기하고 `detail` 을 로깅하세요. 401 = 토큰 누락/만료, 403 = 스코프 부족, 409 = idempotency 충돌(동일 키 다른 body) 등.
-
-## 통합 순서 (7개 API — V5 → V6 매핑)
-
-V5 push/pull 7개 API 의 V6 후속입니다. 표준 흐름:
-
-| 단계 | V6 operation                              | scope                           | 비고                                                             |
-| ---- | ----------------------------------------- | ------------------------------- | ---------------------------------------------------------------- |
-| 1    | `registerBid`                             | bids:write                      | 입찰 정보 등록 (필요 시 `uploadFile` 선행)                       |
-| 2    | `getBidResults` / `getBidSettlement`      | bids:read                       | 응찰 결과 / 정산(사업자·계좌·공급가) 조회                        |
-| 3a   | (협상 H/K) `submitNegotiationScores`      | awards:write                    | 낙찰 전 기술/가격 점수 평가 — `complete=true` 로 평가완료 게이트 |
-| 3b   | `registerAward`                           | awards:write                    | 낙찰 결과 전송                                                   |
-| 3c   | (유찰 시) `markBidFailed`                 | awards:write                    | 유찰 사유 코드와 함께 처리 (3b 와 택일)                          |
-| 4    | `getBidContractDocuments`                 | contracts:read                  | 계약서류 조회                                                    |
-| 5    | `completeAcceptance`                      | contracts:write                 | 검수완료 통지                                                    |
-| 6    | `getBidStatement` / `requestSplitInvoice` | contracts:read / invoices:write | 거래명세서 조회 / 분할 계산서 요청                               |
-
-> 협상에 의한 계약(H/K)일 때만 3a(submitNegotiationScores)가 3b(registerAward) 보다 선행합니다. 그 외 낙찰방법은 2 → 3b 로 진행합니다.
+OAuth 토큰 엔드포인트(`/oauth/token`)만 예외로, RFC 6749 §5.2 형식 `{ error, error_description }` 을 반환합니다.
+
+> **분기 기준은 HTTP `status`** (4xx 는 추가로 `type`)로 하세요. `type` 단독 분기는 위험합니다 — 예를 들어 `upstream-rejected` 는 400/403/404/409/502 에 모두 걸칩니다.
+
+### 에러 카탈로그 (비즈니스 엔드포인트, problem+json)
+
+| `type` slug                | status              | 의미 / 대처                                                                                     |
+| -------------------------- | ------------------- | ----------------------------------------------------------------------------------------------- |
+| `validation-failed`        | 400                 | 입력 검증 실패                                                                                  |
+| `idempotency-key-required` | 400                 | write 인데 `Idempotency-Key` 누락                                                               |
+| `idempotency-key-invalid`  | 400                 | 키 포맷 위반                                                                                    |
+| `idempotency-key-conflict` | 409                 | 같은 키에 다른 body                                                                             |
+| `buyer-id-required`        | 400                 | `/v1` 입찰 등록에 buyerId 누락                                                                  |
+| `missing-bearer-token`     | 401                 | (`/v2`) Bearer 토큰 누락                                                                        |
+| `invalid-token`            | 401                 | (`/v2`) 토큰 만료/무효 — 재발급                                                                 |
+| `unbound-partner-key`      | 403                 | 키 설정 오류(미바인딩) — 운영팀 문의                                                            |
+| `ip-not-allowed`           | 403                 | 호출 IP 가 allowlist 에 없음                                                                    |
+| `insufficient-scope`       | 403                 | 토큰 스코프 부족 (`WWW-Authenticate` 헤더 참조)                                                 |
+| `buyer-scope-mismatch`     | 403                 | 키에 바인딩되지 않은 buyer 사용                                                                 |
+| `upstream-rejected`        | 400/403/404/409/502 | 백엔드 도메인 거절 — `status` 로 분기, `detail` 은 불투명하므로 correlation id 를 지원팀에 전달 |
+| `payload-too-large`        | 413                 | 본문 50MB 초과                                                                                  |
+| `too-many-requests`        | 429                 | rate limit — `Retry-After` 준수                                                                 |
+| `service-unavailable`      | 503                 | 백엔드 다운 또는 `/v1` platform-auth 실패 — `Retry-After` 준수                                  |
+| `internal-server-error`    | 500                 | 서버 오류 — 재시도 + correlation id 보고                                                        |
+
+### OAuth 토큰 엔드포인트 (RFC 6749)
+
+| `error`                  | status | 의미                          |
+| ------------------------ | ------ | ----------------------------- |
+| `invalid_request`        | 400    | 필수 파라미터 누락/형식 오류  |
+| `unsupported_grant_type` | 400    | `client_credentials` 외 grant |
+| `invalid_client`         | 401    | client_id/secret 불일치       |
+| `invalid_scope`          | 400    | 허용되지 않은 scope 요청      |
+
+## Rate limit
+
+| 대상                  | 한도          |
+| --------------------- | ------------- |
+| `POST /oauth/token`   | 5 req/min/IP  |
+| 그 외 모든 엔드포인트 | 60 req/min/IP |
+
+- 초과 시 HTTP **429** `too-many-requests` (problem+json) + `Retry-After` 헤더(초). throttle 될 때는 **`Retry-After` 를 신뢰**해 backoff 하세요.
+- `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset` 헤더는 **성공 응답에만** 포함되며, 429 응답 자체에는 없습니다.
+
+## 통합 순서 (표준 흐름 — `/v2`)
+
+V5 push/pull 흐름의 V6 후속입니다. `/v2` 기준 표준 단계:
+
+| 단계 | operation            | scope             | 비고                                         |
+| ---- | -------------------- | ----------------- | -------------------------------------------- |
+| 1    | `uploadFile`         | `files:write`     | (선택) 첨부파일 선행 업로드                  |
+| 2    | `registerBid`        | `bids:write`      | 입찰 정보 등록                               |
+| 3    | `getBidResults`      | `bids:read`       | 응찰 결과 조회                               |
+| 4    | `getBidSettlement`   | `bids:read`       | 정산(사업자·계좌·공급가) 조회                |
+| 5    | `registerAward`      | `awards:write`    | 낙찰 전송 (유찰이면 `markBidFailed` 로 택일) |
+| 6    | `getBidStatement`    | `contracts:read`  | 거래명세서 조회                              |
+| 7    | `completeAcceptance` | `contracts:write` | 검수완료 통지                                |
+
+### `/v1` 전용 operation (`/v2` 미제공)
+
+다음 작업은 `/v2` 에 없습니다. 필요한 파트너는 `/v1` (platform-auth) 을 사용하세요. 거래명세서(`getBidStatement` / `v1GetBidStatement`)는 양쪽 모두 제공됩니다.
+
+| 작업              | `/v1` SDK 메서드                 | 비고                        |
+| ----------------- | -------------------------------- | --------------------------- |
+| 협상점수평가      | `v1SubmitNegotiationScores`      | 협상 계약(H/K) 낙찰 전 평가 |
+| 분할계산서 요청   | `v1RequestSplitInvoice`          | —                           |
+| 계약서류 조회     | `v1GetBidContractDocumentsBatch` | —                           |
+| 입찰결과 배치조회 | `v1GetBidResultsBatch`           | 다건 결과 일괄 조회         |
 
 ## SDK 호출 예제
 
-### TypeScript
+### TypeScript (`/v2`)
 
 ```ts
-import {
-  Configuration,
-  OauthApi,
-  PartnerV1Api,
-  type CreateBidRequestDto,
-} from '@cmarket/partner-sdk';
+import { Configuration, OauthApi, PartnerV2Api } from '@cmarket/partner-sdk';
 
-const BASE = 'https://partner-api.c-market.net'; // 발급받은 baseURL 로 교체
+const BASE = 'https://partner-api.c-market.net'; // staging: https://partner-api.staging.c-market.net
 
 async function main() {
-  // 1) 토큰 발급 (/v1/oauth/token)
+  // 1) 토큰 발급 (/oauth/token — 버전 prefix 없음)
   const oauth = new OauthApi(new Configuration({ basePath: BASE }));
   const { data: token } = await oauth.token({
     grant_type: 'client_credentials',
     client_id: process.env.CMARKET_CLIENT_ID!,
     client_secret: process.env.CMARKET_CLIENT_SECRET!,
-    scope: 'bids:write',
+    scope: 'bids:write bids:read',
   });
 
-  // 2) access_token 으로 인증된 클라이언트 구성
-  const v1 = new PartnerV1Api(
+  // 2) access_token 으로 인증된 /v2 클라이언트 구성
+  const v2 = new PartnerV2Api(
     new Configuration({ basePath: BASE, accessToken: token.access_token }),
   );
 
   // 3) 입찰 등록 — write 는 Idempotency-Key 헤더 필수
-  const body: CreateBidRequestDto = {
-    buyerId: 'BUYER-001',
-    projectName: '2026 사무용품 구매',
-    // ...나머지 필드는 CreateBidRequestDto 타입 참조
-  } as CreateBidRequestDto;
-
-  const { data } = await v1.registerBid(body, {
-    headers: { 'Idempotency-Key': crypto.randomUUID() },
-  });
+  const { data } = await v2.registerBid(
+    {
+      buyerId: 'BUYER-001',
+      projectName: '2026 사무용품 구매',
+      // ...나머지 필드는 아래 레퍼런스의 registerBid 요청 스키마 참조
+    },
+    { headers: { 'Idempotency-Key': crypto.randomUUID() } },
+  );
   console.log('created bid:', data);
 }
 
 main().catch(console.error);
 ```
 
-### Java
+### Java (`/v2`)
 
 ```java
 import net.cmarket.partner.client.ApiClient;
 import net.cmarket.partner.client.api.OauthApi;
-import net.cmarket.partner.client.api.PartnerV1Api;
+import net.cmarket.partner.client.api.PartnerV2Api;
 import net.cmarket.partner.client.model.*;
 import java.util.Map;
 import java.util.UUID;
 
 public class Quickstart {
   public static void main(String[] args) throws Exception {
-    String base = "https://partner-api.c-market.net"; // 발급받은 baseURL 로 교체
+    String base = "https://partner-api.c-market.net"; // staging: https://partner-api.staging.c-market.net
 
-    // 1) 토큰 발급 (/v1/oauth/token)
-    ApiClient authClient = new ApiClient().setBasePath(base);
-    OauthApi oauth = new OauthApi(authClient);
+    // 1) 토큰 발급 (/oauth/token)
+    OauthApi oauth = new OauthApi(new ApiClient().setBasePath(base));
     TokenResponseDto token = oauth.token(new TokenRequestDto()
         .grantType(TokenRequestDto.GrantTypeEnum.CLIENT_CREDENTIALS)
         .clientId(System.getenv("CMARKET_CLIENT_ID"))
         .clientSecret(System.getenv("CMARKET_CLIENT_SECRET"))
-        .scope("bids:write"));
+        .scope("bids:write bids:read"));
 
-    // 2) access_token 을 Authorization 헤더로 부착
+    // 2) access_token 을 Authorization 헤더로 부착한 /v2 클라이언트
     ApiClient apiClient = new ApiClient()
         .setBasePath(base)
         .setRequestInterceptor(req ->
             req.header("Authorization", "Bearer " + token.getAccessToken()));
-    PartnerV1Api v1 = new PartnerV1Api(apiClient);
+    PartnerV2Api v2 = new PartnerV2Api(apiClient);
 
     // 3) 입찰 등록 — write 는 Idempotency-Key 헤더 필수
     CreateBidRequestDto body = new CreateBidRequestDto()
         .buyerId("BUYER-001")
         .projectName("2026 사무용품 구매");
-        // ...나머지 필드는 CreateBidRequestDto 참조
+        // ...나머지 필드는 레퍼런스의 registerBid 요청 스키마 참조
 
-    BidCreatedResponseDto created = v1.registerBid(
+    BidCreatedResponseDto created = v2.registerBid(
         body, Map.of("Idempotency-Key", UUID.randomUUID().toString()));
     System.out.println("created bid: " + created);
   }
 }
 ```
 
-각 operation 의 정확한 요청/응답 타입과 전체 엔드포인트 목록은 아래 자동 생성 레퍼런스를 참고하세요.
+### Raw HTTP (계약 정본 baseline)
+
+SDK 없이 직접 호출할 때의 contract-truthful 형태입니다.
+
+```bash
+# 1) 토큰 발급 — RFC 6749 (성공 시 snake_case 응답)
+curl -X POST "$BASE/oauth/token" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "grant_type": "client_credentials",
+    "client_id": "'"$CMARKET_CLIENT_ID"'",
+    "client_secret": "'"$CMARKET_CLIENT_SECRET"'",
+    "scope": "bids:write bids:read"
+  }'
+# => { "access_token": "...", "token_type": "Bearer", "expires_in": 900, "scope": "bids:write bids:read" }
+
+# 2) 입찰 등록 — Bearer + Idempotency-Key 필수
+curl -X POST "$BASE/v2/bids" \
+  -H "Authorization: Bearer $ACCESS_TOKEN" \
+  -H "Idempotency-Key: $(uuidgen)" \
+  -H "Content-Type: application/json" \
+  -d '{ "buyerId": "BUYER-001", "projectName": "2026 사무용품 구매" }'
+```
+
+## 첫 성공 확인 (First success)
+
+1. `/oauth/token` 호출이 200 + `access_token` 을 반환하면 자격증명·스코프가 유효합니다(401 `invalid_client` 면 client_id/secret 확인).
+2. 발급한 토큰으로 `getBidResults`(읽기, `bids:read`) 를 1회 호출해 2xx 가 오면 토큰·네트워크·스코프가 정상입니다 — write 보다 안전한 첫 검증입니다.
+3. `registerBid` 가 2xx 를 반환하면 입찰이 등록된 것입니다. 같은 `Idempotency-Key` + 같은 body 로 재호출하면 동일 응답이 replay 됩니다.
+4. 403 `insufficient-scope` 면 토큰 발급 시 `scope` 에 해당 권한을 포함했는지(그리고 키에 그 스코프가 부여됐는지) 확인하세요.
+
+## 버전 정책
+
+- URI versioning. `/v1`, `/v2` 모두 운영 중이며 어느 쪽도 deprecated 아닙니다.
+- SDK 버전은 API 계약을 따릅니다(SemVer; breaking 변경 = major).
+- 변경 이력은 [CHANGELOG.md](./CHANGELOG.md) 참조.
+
+각 operation 의 정확한 경로·요청/응답 타입과 전체 엔드포인트 목록은 아래 자동 생성 레퍼런스를 정본으로 참고하세요.
 
 ---
 
-## @cmarket/partner-sdk@3.0.1
+## @cmarket/partner-sdk@4.0.1
 
 This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
 
@@ -226,7 +326,7 @@ navigate to the folder of your consuming project and run one of the following co
 _published:_
 
 ```
-npm install @cmarket/partner-sdk@3.0.1 --save
+npm install @cmarket/partner-sdk@4.0.1 --save
 ```
 
 _unPublished (not recommended):_
@@ -237,7 +337,7 @@ npm install PATH_TO_GENERATED_PACKAGE --save
 
 ### Documentation for API Endpoints
 
-All URIs are relative to *http://localhost*
+All URIs are relative to *https://partner-api.c-market.net*
 
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
@@ -295,10 +395,12 @@ Class | Method | HTTP request | Description
  - [MarkBidFailedRequestDto](docs/MarkBidFailedRequestDto.md)
  - [NegotiationScoreDto](docs/NegotiationScoreDto.md)
  - [NegotiationScoredResponseDto](docs/NegotiationScoredResponseDto.md)
+ - [OAuthErrorResponseDto](docs/OAuthErrorResponseDto.md)
  - [PreconditionsDto](docs/PreconditionsDto.md)
  - [ProblemDetailsDto](docs/ProblemDetailsDto.md)
  - [RegisterAwardRequestDto](docs/RegisterAwardRequestDto.md)
  - [RequestSplitInvoiceRequestDto](docs/RequestSplitInvoiceRequestDto.md)
+ - [ResultConfirmStatus](docs/ResultConfirmStatus.md)
  - [SplitInvoiceResponseDto](docs/SplitInvoiceResponseDto.md)
  - [StatementDocumentDto](docs/StatementDocumentDto.md)
  - [StatementProductDto](docs/StatementProductDto.md)

package/api/oauth-api.ts

@@ -4,8 +4,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- * 
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech
@@ -22,6 +22,10 @@ import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObj
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
 // @ts-ignore
+import type { OAuthErrorResponseDto } from '../models';
+// @ts-ignore
+import type { ProblemDetailsDto } from '../models';
+// @ts-ignore
 import type { TokenRequestDto } from '../models';
 // @ts-ignore
 import type { TokenResponseDto } from '../models';

package/api/partner-v1-api.ts

@@ -4,8 +4,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- * 
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech
@@ -48,6 +48,8 @@ import type { MarkBidFailedRequestDto } from '../models';
 // @ts-ignore
 import type { NegotiationScoredResponseDto } from '../models';
 // @ts-ignore
+import type { ProblemDetailsDto } from '../models';
+// @ts-ignore
 import type { RegisterAwardRequestDto } from '../models';
 // @ts-ignore
 import type { RequestSplitInvoiceRequestDto } from '../models';

package/api/partner-v2-api.ts

@@ -4,8 +4,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- * 
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/api.ts

@@ -4,8 +4,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- * 
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/base.ts

@@ -4,8 +4,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- * 
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech
@@ -19,7 +19,7 @@ import type { Configuration } from './configuration';
 import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import globalAxios from 'axios';
 
-export const BASE_PATH = "http://localhost".replace(/\/+$/, "");
+export const BASE_PATH = "https://partner-api.c-market.net".replace(/\/+$/, "");
 
 export const COLLECTION_FORMATS = {
     csv: ",",

package/common.ts

@@ -4,8 +4,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- * 
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/configuration.ts

@@ -3,8 +3,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- * 
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api/oauth-api.d.ts

@@ -2,8 +2,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api/oauth-api.js

@@ -5,8 +5,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api/partner-v1-api.d.ts

@@ -2,8 +2,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api/partner-v1-api.js

@@ -5,8 +5,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api/partner-v2-api.d.ts

@@ -2,8 +2,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api/partner-v2-api.js

@@ -5,8 +5,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api.d.ts

@@ -2,8 +2,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech

package/dist/api.js

@@ -5,8 +5,8 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.
  *
- * The version of the OpenAPI document: 3.0.1
- *
+ * The version of the OpenAPI document: 4.0.1
+ * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
  * https://openapi-generator.tech