@cmarket/partner-sdk 45.3.0 → 45.4.0

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

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 형식 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  이 형식을 쓰지 않는 엔드포인트는 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 이 형식을 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 45.3.0
+ * The version of the OpenAPI document: 45.4.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -120,7 +120,7 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.
+         * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.  확정한 `fileKey`는 `POST /v2/bids`의 `attachments`에 넣습니다.
          * @summary 대용량 업로드 2/2 — 업로드 확정
          * @param {string} fileKey 발급 응답의 fileKey(영문 대소문자·숫자 32자).
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -164,7 +164,7 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.
+         * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.  라이프사이클의 마지막 호출입니다. 이 뒤로 이어서 부를 오퍼레이션은 없습니다.
          * @summary 정산 마감
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -203,7 +203,7 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 업체의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 업체로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
+         * 발주기관이 특정 공급사에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 공급사의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 공급사로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약한 공급사가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 공급사로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
          * @summary 결제창 발행
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
          * @param {CreateCardPaymentDto} createCardPaymentDto
@@ -511,7 +511,7 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).
+         * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).  - 검수완료(`POST /v2/bids/{bidRef}/acceptance`)가 명세서 발행을 예약하므로, 그 전에 부르면 문서가 아직 없어 `documents`가 빈 배열입니다. - 금액은 공급가액·부가세로 나뉘어 있고 품목 라인의 단가는 부가세 별도입니다.  계약을 닫으려면 `POST /v2/bids/{bidRef}/settlement/complete`를 부릅니다.
          * @summary 거래명세서 조회
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {number} [paperCode] 거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요.
@@ -622,9 +622,9 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
+         * 계약한 공급사가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 공급사로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 공급사의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
          * @summary 공급사 카드결제 가능 여부
-         * @param {string} memberId 계약업체 회원 ID
+         * @param {string} memberId 공급사 회원 ID
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -726,7 +726,7 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.
+         * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.  낙찰자를 정했으면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
          * @summary 공고 결과 조회
          * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60;를 반복해 전달합니다. 최대 100건입니다.
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -859,9 +859,9 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 업체를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 업체명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
+         * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 공급사를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 공급사명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
          * @summary 공급사 조회
-         * @param {string} [keyword] 업체명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
+         * @param {string} [keyword] 공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
          * @param {string} [cursor] 이전 응답의 &#x60;meta.nextCursor&#x60; 를 그대로 넣습니다. 생략하면 첫 페이지입니다.
          * @param {number} [limit] 한 번에 받을 최대 건수(1~100). 기본 20건.
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -1030,7 +1030,7 @@ export const PartnerApiApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.
+         * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.  납품 검수가 끝나면 `POST /v2/bids/{bidRef}/acceptance`로 이어집니다.
          * @summary 낙찰 결과 전송
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -1504,7 +1504,7 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.
+         * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.  확정한 `fileKey`는 `POST /v2/bids`의 `attachments`에 넣습니다.
          * @summary 대용량 업로드 2/2 — 업로드 확정
          * @param {string} fileKey 발급 응답의 fileKey(영문 대소문자·숫자 32자).
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -1522,7 +1522,7 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.
+         * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.  라이프사이클의 마지막 호출입니다. 이 뒤로 이어서 부를 오퍼레이션은 없습니다.
          * @summary 정산 마감
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -1539,7 +1539,7 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 업체의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 업체로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
+         * 발주기관이 특정 공급사에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 공급사의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 공급사로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약한 공급사가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 공급사로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
          * @summary 결제창 발행
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
          * @param {CreateCardPaymentDto} createCardPaymentDto
@@ -1675,7 +1675,7 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).
+         * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).  - 검수완료(`POST /v2/bids/{bidRef}/acceptance`)가 명세서 발행을 예약하므로, 그 전에 부르면 문서가 아직 없어 `documents`가 빈 배열입니다. - 금액은 공급가액·부가세로 나뉘어 있고 품목 라인의 단가는 부가세 별도입니다.  계약을 닫으려면 `POST /v2/bids/{bidRef}/settlement/complete`를 부릅니다.
          * @summary 거래명세서 조회
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {number} [paperCode] 거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요.
@@ -1726,9 +1726,9 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
+         * 계약한 공급사가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 공급사로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 공급사의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
          * @summary 공급사 카드결제 가능 여부
-         * @param {string} memberId 계약업체 회원 ID
+         * @param {string} memberId 공급사 회원 ID
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1776,7 +1776,7 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.
+         * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.  낙찰자를 정했으면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
          * @summary 공고 결과 조회
          * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60;를 반복해 전달합니다. 최대 100건입니다.
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -1831,9 +1831,9 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 업체를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 업체명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
+         * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 공급사를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 공급사명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
          * @summary 공급사 조회
-         * @param {string} [keyword] 업체명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
+         * @param {string} [keyword] 공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
          * @param {string} [cursor] 이전 응답의 &#x60;meta.nextCursor&#x60; 를 그대로 넣습니다. 생략하면 첫 페이지입니다.
          * @param {number} [limit] 한 번에 받을 최대 건수(1~100). 기본 20건.
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -1904,7 +1904,7 @@ export const PartnerApiApiFp = function (configuration) {
             });
         },
         /**
-         * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.
+         * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.  납품 검수가 끝나면 `POST /v2/bids/{bidRef}/acceptance`로 이어집니다.
          * @summary 낙찰 결과 전송
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -2113,7 +2113,7 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.
+         * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.  확정한 `fileKey`는 `POST /v2/bids`의 `attachments`에 넣습니다.
          * @summary 대용량 업로드 2/2 — 업로드 확정
          * @param {string} fileKey 발급 응답의 fileKey(영문 대소문자·숫자 32자).
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -2125,7 +2125,7 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.completeFileUpload(fileKey, idempotencyKey, completeUploadRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.
+         * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.  라이프사이클의 마지막 호출입니다. 이 뒤로 이어서 부를 오퍼레이션은 없습니다.
          * @summary 정산 마감
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -2136,7 +2136,7 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.completeInvoice(bidRef, idempotencyKey, options).then((request) => request(axios, basePath));
         },
         /**
-         * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 업체의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 업체로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
+         * 발주기관이 특정 공급사에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 공급사의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 공급사로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약한 공급사가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 공급사로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
          * @summary 결제창 발행
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
          * @param {CreateCardPaymentDto} createCardPaymentDto
@@ -2224,7 +2224,7 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.getBidSettlement(bidRef, ifNoneMatch, options).then((request) => request(axios, basePath));
         },
         /**
-         * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).
+         * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).  - 검수완료(`POST /v2/bids/{bidRef}/acceptance`)가 명세서 발행을 예약하므로, 그 전에 부르면 문서가 아직 없어 `documents`가 빈 배열입니다. - 금액은 공급가액·부가세로 나뉘어 있고 품목 라인의 단가는 부가세 별도입니다.  계약을 닫으려면 `POST /v2/bids/{bidRef}/settlement/complete`를 부릅니다.
          * @summary 거래명세서 조회
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {number} [paperCode] 거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요.
@@ -2257,9 +2257,9 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.getSemoContractTaxinvoiceStatus(externalContractId, options).then((request) => request(axios, basePath));
         },
         /**
-         * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
+         * 계약한 공급사가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 공급사로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 공급사의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
          * @summary 공급사 카드결제 가능 여부
-         * @param {string} memberId 계약업체 회원 ID
+         * @param {string} memberId 공급사 회원 ID
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2289,7 +2289,7 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.healthControllerCheck(ifNoneMatch, options).then((request) => request(axios, basePath));
         },
         /**
-         * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.
+         * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.  낙찰자를 정했으면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
          * @summary 공고 결과 조회
          * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60;를 반복해 전달합니다. 최대 100건입니다.
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -2326,9 +2326,9 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.listExternalContractDocuments(buyerId, bidType, options).then((request) => request(axios, basePath));
         },
         /**
-         * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 업체를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 업체명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
+         * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 공급사를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 공급사명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
          * @summary 공급사 조회
-         * @param {string} [keyword] 업체명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
+         * @param {string} [keyword] 공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
          * @param {string} [cursor] 이전 응답의 &#x60;meta.nextCursor&#x60; 를 그대로 넣습니다. 생략하면 첫 페이지입니다.
          * @param {number} [limit] 한 번에 받을 최대 건수(1~100). 기본 20건.
          * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -2375,7 +2375,7 @@ export const PartnerApiApiFactory = function (configuration, basePath, axios) {
             return localVarFp.markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.
+         * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.  납품 검수가 끝나면 `POST /v2/bids/{bidRef}/acceptance`로 이어집니다.
          * @summary 낙찰 결과 전송
          * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
          * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -2522,7 +2522,7 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.
+     * `uploadUrl`로 올린 파일을 확정합니다. 이 시점부터 `fileKey`를 공고 첨부로 쓸 수 있습니다. 스코프 `files:write` · `Idempotency-Key` 헤더 필수.  - 확정 전 `fileKey`를 첨부로 쓰면 공고 등록이 400입니다. - 신고한 `fileSize`가 아니라 실제 파일을 측정해 기록하며, 정책 상한을 넘으면 여기서 거절됩니다. - 같은 `fileKey`로 여러 번 호출해도 안전합니다.  확정한 `fileKey`는 `POST /v2/bids`의 `attachments`에 넣습니다.
      * @summary 대용량 업로드 2/2 — 업로드 확정
      * @param {string} fileKey 발급 응답의 fileKey(영문 대소문자·숫자 32자).
      * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -2534,7 +2534,7 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).completeFileUpload(fileKey, idempotencyKey, completeUploadRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.
+     * 공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.  라이프사이클의 마지막 호출입니다. 이 뒤로 이어서 부를 오퍼레이션은 없습니다.
      * @summary 정산 마감
      * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
      * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
@@ -2545,7 +2545,7 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).completeInvoice(bidRef, idempotencyKey, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 업체의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 업체로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
+     * 발주기관이 특정 공급사에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **카드 승인이 그 공급사의 가맹점으로 나갑니다.** 대금은 씨마켓을 거치지 않고 공급사로 직행합니다. 발행하면 자동 승인되어 바로 결제할 수 있고, 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다.  - 계약한 공급사가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다.   `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 공급사로 발행하면 400입니다. - 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. - 멱등키는 `externalRef`(파트너 측 거래 식별자)입니다. 같은 값으로 재요청하면 새로 만들지 않고   기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
      * @summary 결제창 발행
      * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
      * @param {CreateCardPaymentDto} createCardPaymentDto
@@ -2633,7 +2633,7 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).getBidSettlement(bidRef, ifNoneMatch, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).
+     * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).  - 검수완료(`POST /v2/bids/{bidRef}/acceptance`)가 명세서 발행을 예약하므로, 그 전에 부르면 문서가 아직 없어 `documents`가 빈 배열입니다. - 금액은 공급가액·부가세로 나뉘어 있고 품목 라인의 단가는 부가세 별도입니다.  계약을 닫으려면 `POST /v2/bids/{bidRef}/settlement/complete`를 부릅니다.
      * @summary 거래명세서 조회
      * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
      * @param {number} [paperCode] 거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요.
@@ -2666,9 +2666,9 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).getSemoContractTaxinvoiceStatus(externalContractId, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
+     * 계약한 공급사가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 공급사로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 공급사의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
      * @summary 공급사 카드결제 가능 여부
-     * @param {string} memberId 계약업체 회원 ID
+     * @param {string} memberId 공급사 회원 ID
      * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -2698,7 +2698,7 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).healthControllerCheck(ifNoneMatch, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.
+     * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  - 결과 확인은 공고를 하나씩 조회하지 말고 이 엔드포인트로 최대 100건씩 받습니다. 응답의 `ETag`를 다음 요청의 `If-None-Match`로 보내면 변화가 없을 때 본문 없이 `304`로 끝납니다. - 식별자는 `?bidRefs=A,B,C`와 `?bidRefs=A&bidRefs=B` 둘 다 됩니다. - 없거나 대행 범위 밖인 식별자는 오류가 아니라 응답에서 빠집니다. 보낸 값이 공고번호면 `bidId`, 구매번호면 `purchaseNo`로 대조합니다.  낙찰자를 정했으면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
      * @summary 공고 결과 조회
      * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60;를 반복해 전달합니다. 최대 100건입니다.
      * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -2735,9 +2735,9 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).listExternalContractDocuments(buyerId, bidType, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 업체를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 업체명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
+     * 지명공고에 넣을 공급사를 찾습니다. 스코프 `bids:write`.  - `POST /v2/bids` 의 `nominatedSuppliers[].memberId` 에 넣을 값을 여기서 얻습니다. ERP 자체 거래처 코드가 아니라 조달플랫폼 회원 id 입니다. - 즉시 참여 가능한 **활성 공급사만** 나옵니다. 휴면·탈퇴 공급사를 지명하면 아무도 참여할 수 없는 공고가 되기 때문입니다. - `keyword` 는 공급사명과 사업자등록번호를 함께 봅니다. 생략하면 전체를 페이지로 훑습니다. - 다음 페이지는 `meta.nextCursor` 를 `cursor` 로 넣어 받습니다. - 담당자 이름·연락처는 제공하지 않습니다. 낙찰 이후 담당자는 `GET /v2/bid-results` 가 알려 줍니다.
      * @summary 공급사 조회
-     * @param {string} [keyword] 업체명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
+     * @param {string} [keyword] 공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다.
      * @param {string} [cursor] 이전 응답의 &#x60;meta.nextCursor&#x60; 를 그대로 넣습니다. 생략하면 첫 페이지입니다.
      * @param {number} [limit] 한 번에 받을 최대 건수(1~100). 기본 20건.
      * @param {string} [ifNoneMatch] 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다.
@@ -2784,7 +2784,7 @@ export class PartnerApiApi extends BaseAPI {
         return PartnerApiApiFp(this.configuration).markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.
+     * 낙찰 결과를 등록합니다. 스코프 `awards:write` · `Idempotency-Key` 헤더 필수.  - 입찰 마감(입찰완료) 상태에서 호출합니다. - 낙찰 후 공고 상태는 계약진행(`CONTRACT_IN_PROGRESS`)입니다. `AWARDED` 공고 상태는 없으므로 낙찰 여부는 `participants[].isWinner`로 판단합니다. - 협상 방식(`NEGOTIATION`, `NEGOTIATION_AUTO`) 공고는 평가를 마쳐야 호출할 수 있습니다. 점수평가는 API로 제공하지 않으며 CMARKET 화면(임베드 포함)에서 진행합니다. - 발주기관은 API 키로 결정됩니다(`buyerId`를 보내지 않습니다). - 같은 키와 같은 body로 재전송하면 24시간 동안 캐시된 응답을 돌려줍니다.  납품 검수가 끝나면 `POST /v2/bids/{bidRef}/acceptance`로 이어집니다.
      * @summary 낙찰 결과 전송
      * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다.
      * @param {string} idempotencyKey 멱등키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: &#x60;bid-create-{구매번호}&#x60;). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.

package/dist/esm/api/products-api.d.ts

@@ -2,7 +2,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 형식 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  이 형식을 쓰지 않는 엔드포인트는 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 이 형식을 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 45.3.0
+ * The version of the OpenAPI document: 45.4.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/api/products-api.js

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 형식 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  이 형식을 쓰지 않는 엔드포인트는 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 이 형식을 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 45.3.0
+ * The version of the OpenAPI document: 45.4.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/api/webhooks-api.d.ts

@@ -2,7 +2,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 형식 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  이 형식을 쓰지 않는 엔드포인트는 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 이 형식을 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 45.3.0
+ * The version of the OpenAPI document: 45.4.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -35,7 +35,7 @@ export declare const WebhooksApiAxiosParamCreator: (configuration?: Configuratio
      */
     onBidAwardReverted: (webhookId: string, webhookEventType: string, webhookTimestamp: string, webhookSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
      * @summary 낙찰 확정.
      * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
      * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.
@@ -112,7 +112,7 @@ export declare const WebhooksApiFp: (configuration?: Configuration) => {
      */
     onBidAwardReverted(webhookId: string, webhookEventType: string, webhookTimestamp: string, webhookSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
-     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
      * @summary 낙찰 확정.
      * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
      * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.
@@ -189,7 +189,7 @@ export declare const WebhooksApiFactory: (configuration?: Configuration, basePat
      */
     onBidAwardReverted(webhookId: string, webhookEventType: string, webhookTimestamp: string, webhookSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
-     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
      * @summary 낙찰 확정.
      * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
      * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.
@@ -266,7 +266,7 @@ export declare class WebhooksApi extends BaseAPI {
      */
     onBidAwardReverted(webhookId: string, webhookEventType: string, webhookTimestamp: string, webhookSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
-     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
      * @summary 낙찰 확정.
      * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
      * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.

package/dist/esm/api/webhooks-api.js

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 형식 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  이 형식을 쓰지 않는 엔드포인트는 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 이 형식을 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 45.3.0
+ * The version of the OpenAPI document: 45.4.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -86,7 +86,7 @@ export const WebhooksApiAxiosParamCreator = function (configuration) {
             };
         }),
         /**
-         * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+         * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
          * @summary 낙찰 확정.
          * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
          * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.
@@ -384,7 +384,7 @@ export const WebhooksApiFp = function (configuration) {
             });
         },
         /**
-         * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+         * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
          * @summary 낙찰 확정.
          * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
          * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.
@@ -506,7 +506,7 @@ export const WebhooksApiFactory = function (configuration, basePath, axios) {
             return localVarFp.onBidAwardReverted(webhookId, webhookEventType, webhookTimestamp, webhookSignature, onBidAwardRevertedRequest, options).then((request) => request(axios, basePath));
         },
         /**
-         * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+         * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
          * @summary 낙찰 확정.
          * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
          * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.
@@ -596,7 +596,7 @@ export class WebhooksApi extends BaseAPI {
         return WebhooksApiFp(this.configuration).onBidAwardReverted(webhookId, webhookEventType, webhookTimestamp, webhookSignature, onBidAwardRevertedRequest, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+     * 낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
      * @summary 낙찰 확정.
      * @param {string} webhookId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
      * @param {string} webhookEventType 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다.