@cmarket/partner-sdk 45.2.0 → 45.4.0

package/docs/PartnerApiApi.md

@@ -110,7 +110,7 @@ const { status, data } = await apiInstance.cancelBid(
 # **completeAcceptance**
 > CompleteAcceptance200Response completeAcceptance(completeAcceptanceRequestDto)
 
-납품 검수 완료를 기록합니다. 낙찰 처리된 공고에서 호출합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 현금 결제 공고는 세금계산서 발행요청이 등록되고 낙찰자에게 알림·문자가 나갑니다. 카드 결제 공고는 발행요청이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 협의로 계약금액이 줄었으면 `supplyAmount`와 `vat`를 함께 보냅니다. 현금 결제·낙찰자 1인·감액일 때만 허용하며 어긋나면 409입니다. 생략하면 낙찰금액에서 파생합니다. - 문서에 찍히는 구매사 사업자정보·담당자·작성일자와 낙찰자는 등록된 값에서 채워지며 요청으로 바꿀 수 없습니다.
+납품 검수 완료를 기록합니다. 낙찰 처리된 공고에서 호출합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 현금 결제 공고는 세금계산서 발행요청이 등록되고 낙찰자에게 알림·문자가 나갑니다. 카드 결제 공고는 발행요청이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 협의로 계약금액이 줄었으면 `supplyAmount`와 `vat`를 함께 보냅니다. 현금 결제·낙찰자 1인·감액일 때만 허용하며 어긋나면 409입니다. 생략하면 낙찰금액에서 파생합니다. - 문서에 찍히는 구매사 사업자정보·담당자·작성일자와 낙찰자는 등록된 값에서 채워지며 요청으로 바꿀 수 없습니다.  공급사에게 계산서를 받으면 `POST /v2/bids/{bidRef}/settlement/complete`로 계약을 닫습니다.
 
 ### Example
 
@@ -177,7 +177,7 @@ const { status, data } = await apiInstance.completeAcceptance(
 # **completeFileUpload**
 > UploadFile201Response completeFileUpload(completeUploadRequestDto)
 
-`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`에 넣습니다.
 
 ### Example
 
@@ -244,7 +244,7 @@ const { status, data } = await apiInstance.completeFileUpload(
 # **completeInvoice**
 > CompleteInvoice200Response completeInvoice()
 
-공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.
+공급사에게 계산서를 수령한 뒤 계약을 완료처리합니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 결제완료·계산서 발급 상태가 기록되고 발급일자는 현재 시각이 됩니다. - 이미 완료된 공고는 409, 다른 발주기관의 공고는 403입니다.  라이프사이클의 마지막 호출입니다. 이 뒤로 이어서 부를 오퍼레이션은 없습니다.
 
 ### Example
 
@@ -307,7 +307,7 @@ const { status, data } = await apiInstance.completeInvoice(
 # **createCardPayment**
 > CreateCardPayment200Response createCardPayment(createCardPaymentDto)
 
-발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 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` 헤더도 함께 보내세요.
 
 ### Example
 
@@ -371,7 +371,7 @@ const { status, data } = await apiInstance.createCardPayment(
 # **createExternalContractDocuments**
 > CreateExternalContractDocumentsResponseDto createExternalContractDocuments(createExternalContractDocumentsRequestDto)
 
-공고 없이 성사된 거래의 계약서류를 생성합니다. 계약이 체결된 직후에 부릅니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다. 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킵니다. - 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. - `name` 의 출처는 서류마다 다릅니다. 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 공급사가 등록한 원본 파일명입니다 — 채팅 첨부 라벨로 그대로 쓰세요. - **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면 400 이고 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). - 응답의 `fileUrl` 은 만료되지 않습니다. 채팅 메시지 등에 그대로 저장해 두어도 됩니다. - 대행 범위 밖 회원이면 403 입니다. 조회와 같은 축입니다.  ### 서류별 추가 입력  `135`(수의계약체결제한여부확인서) — `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수입니다. `documentInputs.contractRestrictionConfirm.answers` 에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담습니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation` 으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명에 있습니다.  `164`(퇴직자영입현황확인서) — `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). 퇴직자가 없으면 `rows` 를 **빈 배열로** 보내세요 — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다).  승낙사항(`4`·`184`·`185`·`186`·`189`·`197`·`208`) — `contract.subject`(계약건명)가 필수입니다. 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다. 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents`가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
+공고 없이 성사된 거래의 계약서류를 생성합니다. 계약이 체결된 직후에 부릅니다. 스코프 `contracts:write` · `Idempotency-Key` 헤더 필수.  - 요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다. 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킵니다. - 발주기관·공급사는 회원 ID만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. - `name` 의 출처는 서류마다 다릅니다. 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 공급사가 등록한 원본 파일명입니다 — 채팅 첨부 라벨로 그대로 쓰세요. - **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면 400 이고 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). - 응답의 `fileUrl` 은 만료되지 않습니다. 채팅 메시지 등에 그대로 저장해 두어도 됩니다. - 대행 범위 밖 회원이면 403 입니다. 조회와 같은 축입니다.  ### 서류별 추가 입력  `135`(수의계약체결제한여부확인서) — `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수입니다. `documentInputs.contractRestrictionConfirm.answers` 에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담습니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation` 으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명에 있습니다.  `164`(퇴직자영입현황확인서) — `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). 퇴직자가 없으면 `rows` 를 **빈 배열로** 보내세요 — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다).  승낙사항(`4`·`184`·`185`·`186`·`189`·`197`·`208`) — `contract.subject`(계약건명)가 필수입니다. 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다. 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF는 그 기관 서식으로 발급됩니다.  ---  **응답 형태가 동결된 엔드포인트입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 공통 응답 형식을 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents`가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)를 대체할 새 경로는 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
 
 ### Example
 
@@ -631,7 +631,7 @@ void (empty response body)
 # **downloadFile**
 > downloadFile()
 
-무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 곧 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl`이 이 URL을 가리킨다. 요청 시점에 서명하므로 URL을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`).  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}`가 파일 메타와 `downloadUrl`을 v2 응답 규약으로 돌려줍니다. 이 안정 URL은 파트너 응답의 `fileUrl`/`fullUrl`이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
+무인증 — `fileKey` 자체가 capability입니다(키를 아는 쪽이 곧 접근 권한을 가집니다). 파트너 응답의 `fileUrl`/`fullUrl`이 이 URL을 가리킵니다. 요청 시점에 서명하므로 URL을 저장해 두어도 만료되지 않습니다. 응답은 실제 저장소 URL로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`).  ---  **응답 형태가 동결된 엔드포인트입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 공통 응답 형식을 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}`가 파일 메타와 `downloadUrl`을 v2 응답 규약으로 돌려줍니다. 이 안정 URL은 파트너 응답의 `fileUrl`/`fullUrl`이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
 
 ### Example
 
@@ -808,7 +808,7 @@ const { status, data } = await apiInstance.getBidSettlement(
 # **getBidStatement**
 > GetBidStatement200Response getBidStatement()
 
-낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).
+낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. 스코프 `invoices:read`(종전 `contracts:read`에서 변경).  - 검수완료(`POST /v2/bids/{bidRef}/acceptance`)가 명세서 발행을 예약하므로, 그 전에 부르면 문서가 아직 없어 `documents`가 빈 배열입니다. - 금액은 공급가액·부가세로 나뉘어 있고 품목 라인의 단가는 부가세 별도입니다.  계약을 닫으려면 `POST /v2/bids/{bidRef}/settlement/complete`를 부릅니다.
 
 ### Example
 
@@ -937,7 +937,7 @@ const { status, data } = await apiInstance.getFileMeta(
 # **getSemoContractTaxinvoiceStatus**
 > SemoContractTaxinvoiceStatusResponseDto getSemoContractTaxinvoiceStatus()
 
-등록한 계약의 계산서 발행 상태를 확인합니다.  **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API 로 되읽으세요.  **필수 스코프:** `contracts:read`
+등록한 계약의 계산서 발행 상태를 확인합니다.  **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API로 되읽으세요.  **필수 스코프:** `contracts:read`
 
 ### Example
 
@@ -981,14 +981,14 @@ const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 세금계산서 발행 상태. 동결 표면이라 &#x60;{data}&#x60; 봉투를 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**200** | 세금계산서 발행 상태. 동결된 엔드포인트라 &#x60;{data}&#x60; 공통 응답 형식을 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **getSupplierCardPayableV2**
 > GetSupplierCardPayableV2200Response getSupplierCardPayableV2()
 
-계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
+계약한 공급사가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 공급사로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **응답은 가부와 사유뿐입니다.** 공급사의 상호·사업자번호 같은 식별정보는 싣지 않습니다.  **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write`를 요구했습니다. 그쪽은 동결된 엔드포인트라 그대로 둡니다.
 
 ### Example
 
@@ -1001,7 +1001,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let memberId: string; //계약업체 회원 ID (default to undefined)
+let memberId: string; //공급사 회원 ID (default to undefined)
 let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getSupplierCardPayableV2(
@@ -1014,7 +1014,7 @@ const { status, data } = await apiInstance.getSupplierCardPayableV2(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **memberId** | [**string**] | 계약업체 회원 ID | defaults to undefined|
+| **memberId** | [**string**] | 공급사 회원 ID | defaults to undefined|
 | **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
@@ -1168,7 +1168,7 @@ No authorization required
 # **listBidResults**
 > ListBidResults200Response listBidResults()
 
-여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `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`로 보냅니다.
 
 ### Example
 
@@ -1248,7 +1248,7 @@ let limit: number; //페이지 크기(1~100, 기본 100). (optional) (default to
 let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor`를 그대로 보냅니다. 생략하면 첫 페이지이고, `nextCursor`가 `null`이면 마지막 페이지입니다. (optional) (default to undefined)
 let bidRefs: Array<string>; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. (optional) (default to undefined)
 let status: Array<BidPublicStatus>; //공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다. (optional) (default to undefined)
-let include: Array<'results' | 'products' | 'contacts'>; //행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). (optional) (default to undefined)
+let include: Array<'results' | 'products' | 'contacts'>; //행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않습니다(응답이 가볍고 조회 비용도 들지 않습니다). (optional) (default to undefined)
 let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.listBids(
@@ -1269,7 +1269,7 @@ const { status, data } = await apiInstance.listBids(
 | **cursor** | [**string**] | 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60;를 그대로 보냅니다. 생략하면 첫 페이지이고, &#x60;nextCursor&#x60;가 &#x60;null&#x60;이면 마지막 페이지입니다. | (optional) defaults to undefined|
 | **bidRefs** | **Array&lt;string&gt;** | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 연결된 발주기관 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. | (optional) defaults to undefined|
 | **status** | **Array&lt;BidPublicStatus&gt;** | 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다. | (optional) defaults to undefined|
-| **include** | **Array<&#39;results&#39; &#124; &#39;products&#39; &#124; &#39;contacts&#39;>** | 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). | (optional) defaults to undefined|
+| **include** | **Array<&#39;results&#39; &#124; &#39;products&#39; &#124; &#39;contacts&#39;>** | 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않습니다(응답이 가볍고 조회 비용도 들지 않습니다). | (optional) defaults to undefined|
 | **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
@@ -1306,7 +1306,7 @@ const { status, data } = await apiInstance.listBids(
 # **listExternalContractDocuments**
 > ExternalContractDocumentsResponseDto listExternalContractDocuments()
 
-발주기관 회원과 거래유형으로 그 거래에 필요한 계약서류 목록을 조회합니다. 스코프 `contracts:read`.  공고(입찰)를 거치지 않는 거래에서 씁니다 — 채팅 기반 견적 같은 자리에서, 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때입니다.  목록은 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. 대행 범위 밖 회원을 조회하면 403 입니다(대행 범위는 키 설정이며 스코프와 별개 축입니다).  응답 세 값의 뜻은 이렇습니다.  - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 미리 체크된 상태로 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market이 데이터를 채워 PDF로 만들어 주는 서류입니다. 생성 API의 `paperCodes`에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents`가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
+발주기관 회원과 거래유형으로 그 거래에 필요한 계약서류 목록을 조회합니다. 스코프 `contracts:read`.  공고(입찰)를 거치지 않는 거래에서 씁니다 — 채팅 기반 견적 같은 자리에서, 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때입니다.  목록은 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. 대행 범위 밖 회원을 조회하면 403 입니다(대행 범위는 키 설정이며 스코프와 별개 축입니다).  응답 세 값의 뜻은 이렇습니다.  - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 미리 체크된 상태로 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market이 데이터를 채워 PDF로 만들어 주는 서류입니다. 생성 API의 `paperCodes`에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요.  ---  **응답 형태가 동결된 엔드포인트입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 공통 응답 형식을 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents`가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)를 대체할 새 경로는 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
 
 ### Example
 
@@ -1368,7 +1368,7 @@ const { status, data } = await apiInstance.listExternalContractDocuments(
 # **listSuppliers**
 > ListSuppliers200Response listSuppliers()
 
-지명공고에 넣을 공급사를 찾습니다. 스코프 `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` 가 알려 줍니다.
 
 ### Example
 
@@ -1381,7 +1381,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-let keyword: string; //업체명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다. (optional) (default to undefined)
+let keyword: string; //공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다. (optional) (default to undefined)
 let cursor: string; //이전 응답의 `meta.nextCursor` 를 그대로 넣습니다. 생략하면 첫 페이지입니다. (optional) (default to undefined)
 let limit: number; //한 번에 받을 최대 건수(1~100). 기본 20건. (optional) (default to 20)
 let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304`로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
@@ -1398,7 +1398,7 @@ const { status, data } = await apiInstance.listSuppliers(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **keyword** | [**string**] | 업체명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다. | (optional) defaults to undefined|
+| **keyword** | [**string**] | 공급사명 또는 사업자등록번호로 검색합니다. 생략하면 전체를 페이지로 훑습니다. | (optional) defaults to undefined|
 | **cursor** | [**string**] | 이전 응답의 &#x60;meta.nextCursor&#x60; 를 그대로 넣습니다. 생략하면 첫 페이지입니다. | (optional) defaults to undefined|
 | **limit** | [**number**] | 한 번에 받을 최대 건수(1~100). 기본 20건. | (optional) defaults to 20|
 | **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
@@ -1636,7 +1636,7 @@ const { status, data } = await apiInstance.markBidFailed(
 # **registerAward**
 > RegisterAward201Response registerAward(registerAwardRequestDto)
 
-낙찰 결과를 등록합니다. 스코프 `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`로 이어집니다.
 
 ### Example
 
@@ -1703,7 +1703,7 @@ const { status, data } = await apiInstance.registerAward(
 # **registerBid**
 > RegisterBid201Response registerBid(createBidRequestDto)
 
-공고를 등록합니다. 스코프 `bids:write` · `Idempotency-Key` 헤더 필수.  첨부는 두 방법 중 하나입니다. - `attachments` 원소에 `{ fileName, url }` 또는 `{ fileName, base64 }`를 그대로 넣습니다. - 여러 공고에서 재사용할 파일은 `POST /v2/files`로 먼저 올려 받은 `fileKey`를 넣습니다.
+공고를 등록합니다. 스코프 `bids:write` · `Idempotency-Key` 헤더 필수.  첨부는 두 방법 중 하나입니다. - `attachments` 원소에 `{ fileName, url }` 또는 `{ fileName, base64 }`를 그대로 넣습니다. - 여러 공고에서 재사용할 파일은 `POST /v2/files`로 먼저 올려 받은 `fileKey`를 넣습니다.  등록한 공고의 응찰 결과는 마감 뒤 `GET /v2/bid-results`로 조회하고, 낙찰자를 정하면 `POST /v2/bids/{bidRef}/award`로 보냅니다.
 
 ### Example
 
@@ -1767,7 +1767,7 @@ const { status, data } = await apiInstance.registerBid(
 # **registerSemoContract**
 > SemoContractRegisteredResponseDto registerSemoContract(registerSemoContractRequestDto)
 
-외부에서 맺어진 계약 1건을 씨마켓의 세금계산서 발행 대상으로 등록합니다. 스코프 `contracts:write`.  등록하면 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 공급자는 공급기업, 공급받는자는 발주기관입니다. 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다.  - **`supplyPrice` 는 부가세를 뺀 과세 공급가액입니다.** 결제창 API 가 부가세 포함가를 받는 것과 다릅니다. 과세·면세 공급가액이 모두 0 이면 400 입니다. - 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. - 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. - 멱등키는 `externalContractId` 입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
+외부에서 맺어진 계약 1건을 씨마켓의 세금계산서 발행 대상으로 등록합니다. 스코프 `contracts:write`.  등록하면 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 공급자는 공급기업, 공급받는자는 발주기관입니다. 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다.  - **`supplyPrice` 는 부가세를 뺀 과세 공급가액입니다.** 결제창 API가 부가세 포함가를 받는 것과 다릅니다. 과세·면세 공급가액이 모두 0 이면 400 입니다. - 두 회원 ID가 씨마켓에 실재해야 합니다. 회원 ID가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. - 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. - 멱등키는 `externalContractId` 입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 보내세요.
 
 ### Example
 
@@ -1815,7 +1815,7 @@ const { status, data } = await apiInstance.registerSemoContract(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | 외부 계약 등록 완료. 동결 표면이라 &#x60;{data}&#x60; 봉투를 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**200** | 외부 계약 등록 완료. 동결된 엔드포인트라 &#x60;{data}&#x60; 공통 응답 형식을 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |

package/docs/PreconditionsDto.md

@@ -5,11 +5,11 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**bidBond** | [**BidBondDto**](BidBondDto.md) | 입찰보증금 설정. | [optional] [default to undefined]
-**businessRegistered** | **boolean** | 사업자등록증 납부 관련업체 자격 제한. | [optional] [default to undefined]
-**distributor** | **boolean** | 총판/대리점 자격 제한. | [optional] [default to undefined]
-**manufacturer** | **boolean** | 제조사 자격 제한. | [optional] [default to undefined]
-**directProduction** | **boolean** | 직접생산확인증명 보유 업체로 제한. | [optional] [default to undefined]
+**bidBond** | [**BidBondDto**](BidBondDto.md) | 입찰보증금 설정. 생략하거나 `required=false` 면 보증금 요건이 붙지 않습니다. | [optional] [default to undefined]
+**businessRegistered** | **boolean** | 사업자등록 자격 제한. true 면 사업자등록 요건을 갖춘 공급사만 참여할 수 있고, 생략하면 제한하지 않습니다. | [optional] [default to undefined]
+**distributor** | **boolean** | 총판·대리점 자격 제한. true 면 해당 자격을 가진 공급사만 참여할 수 있고, 생략하면 제한하지 않습니다. | [optional] [default to undefined]
+**manufacturer** | **boolean** | 제조사 자격 제한. true 면 제조사만 참여할 수 있고, 생략하면 제한하지 않습니다. | [optional] [default to undefined]
+**directProduction** | **boolean** | 직접생산확인증명 자격 제한. true 면 증명을 보유한 공급사만 참여할 수 있고, 생략하면 제한하지 않습니다. | [optional] [default to undefined]
 **legalMandatory** | [**Array<LegalMandatoryPublic>**](LegalMandatoryPublic.md) | 법적의무구매 대상. SEVERE_DISABLED=중증장애인생산품, DISABLED_STANDARD=장애인표준사업장, DISABLED_ENTERPRISE=장애인기업, SOCIAL_COOP=사회적협동조합, WOMEN_ENTERPRISE=여성기업, STARTUP=창업기업, SOCIAL_ENTERPRISE=사회적기업, SME_ENTERPRISE=중소기업. | [optional] [default to undefined]
 **excellentProcurement** | [**Array<ExcellentProcurementPublic>**](ExcellentProcurementPublic.md) | 기술개발제품 인증. TECH_PRODUCT_ALL=전체, 그 외는 개별 인증(EXCELLENT_PROCUREMENT=우수조달물품지정, NEP=신제품인증, GS=GS인증, PERFORMANCE=성능인증, NET=신기술인증 등). | [optional] [default to undefined]
 **greenProduct** | [**Array<GreenProductPublic>**](GreenProductPublic.md) | 녹색제품 인증. GREEN_PRODUCT_ALL=전체, ECO_LABEL=환경표지, LOW_CARBON=저탄소제품, GR_CERT=우수재활용(GR)인증. | [optional] [default to undefined]

package/docs/ProtectedResourceMetadataDto.md

@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 **scopes_supported** | **Array<string>** | 이 자원이 이해하는 scope 전체. | [default to undefined]
 **bearer_methods_supported** | **Array<string>** | access token 전달 방식 (RFC 6750). `header`만 받는다 — 쿼리스트링·본문 전달은 접근 로그·리퍼러로 토큰이 새는 경로다. | [default to undefined]
 **dpop_signing_alg_values_supported** | **Array<string>** | DPoP proof 서명에 받아 주는 알고리즘 (RFC 9449 §5.1). | [default to undefined]
-**dpop_bound_access_tokens_required** | **boolean** | DPoP 바인딩 토큰을 **전역으로** 강제하는지. false — DPoP는 키 단위 설정이라 파트너마다 다르다. true로 광고하면 DPoP를 쓰지 않는 정상 키의 클라이언트가 스스로 실패한다. | [default to undefined]
+**dpop_bound_access_tokens_required** | **boolean** | DPoP 바인딩 토큰을 **전역으로** 강제하는지. false — DPoP는 키 단위 설정이라 파트너마다 다릅니다. true로 광고하면 DPoP를 쓰지 않는 정상 키의 클라이언트가 스스로 실패합니다. | [default to undefined]
 **resource_documentation** | **string** | 사람이 읽는 API 문서 위치. | [default to undefined]
 
 ## Example

package/docs/StatementProductDto.md

@@ -7,10 +7,10 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **productName** | **string** | 품목명. 미지정 시 null. | [default to undefined]
 **quantity** | **number** | 수량. | [default to undefined]
-**unitPrice** | **number** | 단가. | [default to undefined]
-**supplyAmount** | **number** | 공급가액. | [default to undefined]
-**vat** | **number** | 부가세. | [default to undefined]
-**total** | **number** | 합계금액 (공급가액 + 부가세). | [default to undefined]
+**unitPrice** | **number** | 단가(원, 부가세 별도). 수량을 곱한 값이 `supplyAmount` 입니다. | [default to undefined]
+**supplyAmount** | **number** | 공급가액(원, 부가세 별도). 단가 × 수량입니다. | [default to undefined]
+**vat** | **number** | 부가세(원). | [default to undefined]
+**total** | **number** | 합계금액(원). 공급가액 + 부가세입니다. | [default to undefined]
 **lineSequence** | **number** | 품목 라인 순번. 미설정 시 null. | [default to undefined]
 **itemCode** | **string** | 품목 코드. 미설정 시 null. | [default to undefined]
 **spec** | **string** | 규격. 미설정 시 null. | [default to undefined]

package/docs/SupplierResponseDto.md

@@ -6,7 +6,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **memberId** | **string** | 공급사 회원 id. 지명공고 등록의 `nominatedSuppliers[].memberId` 에 이 값을 씁니다. | [default to undefined]
-**companyName** | **string** | 업체명. | [default to undefined]
+**companyName** | **string** | 공급사명. | [default to undefined]
 **businessNumber** | **string** | 사업자등록번호(하이픈 없음). 미상이면 null. | [default to undefined]
 **representativeName** | **string** | 대표자명. 미상이면 null. | [default to undefined]
 **businessItem** | **string** | 업종(종목). 미상이면 null. | [default to undefined]

package/docs/UpdateBidRequestDto.md

@@ -11,7 +11,7 @@ Name | Type | Description | Notes
 **disclosePlannedAmount** | **boolean** | 예정금액(예산) 공개 여부. | [optional] [default to undefined]
 **attachments** | [**Array<BidAttachmentInputDto>**](BidAttachmentInputDto.md) | 공고 첨부파일 목록. 원소마다 `fileKey`(이미 올린 파일) · `url` · `base64` 중 **하나**를 담습니다. `url`·`base64`를 쓰면 별도 업로드 호출 없이 이 요청 하나로 끝납니다. 큰 파일이나 여러 공고에 재사용할 파일은 `POST /v2/files/upload-url`로 먼저 올리고 `fileKey`로 참조하세요. | [optional] [default to undefined]
 **items** | [**Array<BidItemDto>**](BidItemDto.md) | 품목 목록(1개 이상). | [optional] [default to undefined]
-**totalBudget** | **number** | 총 예산금액(원, **부가세 포함**). 생략하면 품목 합계(단가 × 수량)가 배정예산이 됩니다. 낙찰금액도 부가세 포함 금액이라 두 값은 같은 축입니다 — 공급가액(부가세 별도)을 보내면 절감액이 실제보다 크게 계산됩니다. (`/v1`은 이 필드를 부가세 **별도**로 받아 서버가 10%를 가산합니다. 두 표면의 축이 다르므로 v1에서 옮겨올 때 값을 그대로 쓰지 마세요.) | [optional] [default to undefined]
+**totalBudget** | **number** | 총 예산금액(원, **부가세 포함**). 생략하면 품목 합계(단가 × 수량)가 배정예산이 됩니다. 낙찰금액도 부가세 포함 금액이라 두 값은 같은 축입니다 — 공급가액(부가세 별도)을 보내면 절감액이 실제보다 크게 계산됩니다. (`/v1`은 이 필드를 부가세 **별도**로 받아 서버가 10%를 가산합니다. 두 버전의 축이 다르므로 v1에서 옮겨올 때 값을 그대로 쓰지 마세요.) | [optional] [default to undefined]
 **awardMethod** | **string** | 낙찰 방법(필수). LOWEST_PRICE=최저가, APPROPRIATE_PRICE=적정가, HIGHEST_PRICE=최고가, MAX_QUANTITY=최다수량, NEGOTIATION=협상(임의), LIMITED_LOWEST=제한적최저가, NEGOTIATION_AUTO=협상(자동계산), QUALIFICATION_REVIEW=적격심사. | [optional] [default to undefined]
 **quoteCondition** | **string** | 견적서 제출 조건. UNIT_AUTO=자동생성(단가), TOTAL_AUTO=자동생성(총액), FILE=직접첨부, NONE=미제출. | [optional] [default to undefined]
 **preliminaryPriceRegion** | **string** | 예비가격 범위 (awardMethod=LIMITED_LOWEST 필수). PLUS_MINUS_2=±2%, PLUS_MINUS_3=±3%, PLUS_MINUS_4=±4%. | [optional] [default to undefined]
@@ -25,7 +25,7 @@ Name | Type | Description | Notes
 **requiredLicenses** | **Array<string>** | 필수 면허 코드 목록. | [optional] [default to undefined]
 **requiredCertifications** | **Array<string>** | 요구 인증서명. 면허(`requiredLicenses`)와 다른 축이라 따로 보냅니다(예: 직접생산확인증명서). | [optional] [default to undefined]
 **requiredLicenseMode** | **string** | 면허 결합 방식. `AND`=모두 보유해야 참여, `OR`=하나만 보유해도 참여. 생략하면 조달플랫폼 기본값(OR)입니다. | [optional] [default to undefined]
-**nominatedSuppliers** | [**Array<NominatedSupplierDto>**](NominatedSupplierDto.md) | 지명업체 목록. `qualificationStyle=NOMINATED` 와 짝이며, 한쪽만 보내면 400 입니다 — 지명공고인데 목록이 비면 아무도 참여할 수 없는 공고가 되기 때문입니다. | [optional] [default to undefined]
+**nominatedSuppliers** | [**Array<NominatedSupplierDto>**](NominatedSupplierDto.md) | 지명 공급사 목록. `qualificationStyle=NOMINATED` 와 짝이며, 한쪽만 보내면 400 입니다 — 지명공고인데 목록이 비면 아무도 참여할 수 없는 공고가 되기 때문입니다. | [optional] [default to undefined]
 **preconditionDescription** | **string** | 자격조건 추가 기입 (최대 1000자). | [optional] [default to undefined]
 **preconditions** | [**PreconditionsDto**](PreconditionsDto.md) | 참가자격 조건 구조체 (입찰보증금·법적의무구매·기술개발제품·녹색제품 등). | [optional] [default to undefined]
 **deliveryDateType** | **string** | 납품기한 유형. FIXED_DATE=직접설정(deliveryDate 필요), DAYS_AFTER_CONTRACT=계약후지정(deliveryPeriodDays 필요), NEGOTIATED_AFTER_CONTRACT=계약후협의. | [optional] [default to undefined]
@@ -48,14 +48,14 @@ Name | Type | Description | Notes
 **isNegotiatedContract** | **boolean** | 수의계약 여부. true=수의계약, false=일반. | [optional] [default to undefined]
 **bidType** | **string** | 입찰방식. ELECTRONIC=전자입찰(기본), REVERSE_AUCTION=역경매. 공사/용역/매각은 전자입찰로 강제됩니다. | [optional] [default to undefined]
 **isAnnualContract** | **boolean** | 연간계약 여부. true=연간계약, false=일반. | [optional] [default to undefined]
-**isNominatedContract** | **boolean** | 지명계약 여부. true=지명계약(등록 시 초안 상태로 저장되어 별도 게시가 필요), false=일반. 지명업체 목록은 미지원(true/false 플래그만). | [optional] [default to undefined]
+**isNominatedContract** | **boolean** | 지명계약 여부. true=지명계약(등록 시 초안 상태로 저장되어 별도 게시가 필요), false=일반. 지명 공급사 목록은 미지원(true/false 플래그만). | [optional] [default to undefined]
 **buyerManagerId** | **string** | 발주기관 담당자 식별자. | [optional] [default to undefined]
 **purchaseNo** | **string** | 발주기관 지정 조달번호(외부 ERP의 구매번호). 동일 PO의 선행 입찰이 전부 취소/유찰이면 재입찰로 새 번호가 채번되고, 진행 중이면 중복으로 거부됩니다. | [optional] [default to undefined]
 **isResultPublished** | **boolean** | 결과 공개 여부. true=공개, false=비공개. | [optional] [default to undefined]
 **contractManager** | [**BidManagerDto**](BidManagerDto.md) | 계약 담당자. | [optional] [default to undefined]
 **techManager** | [**BidManagerDto**](BidManagerDto.md) | 기술 담당자. | [optional] [default to undefined]
-**bidStartAt** | **string** | 입찰 시작 일시(ISO-8601 UTC). | [optional] [default to undefined]
-**bidEndAt** | **string** | 입찰 마감 일시(ISO-8601 UTC). | [optional] [default to undefined]
+**bidStartAt** | **string** | 입찰 시작 일시(ISO 8601 UTC). | [optional] [default to undefined]
+**bidEndAt** | **string** | 입찰 마감 일시(ISO 8601 UTC). | [optional] [default to undefined]
 **editReason** | **string** | 변경이력 본문 (구매자가 작성한 수정 사유). | [optional] [default to undefined]
 **hideEditHistory** | **boolean** | true 면 변경이력을 공개에서 숨기고 노출 카운터 증가도 생략. 기본 false(공개). | [optional] [default to undefined]
 

package/docs/WebhookBidEventData.md

@@ -9,7 +9,7 @@ Name | Type | Description | Notes
 **bidId** | **string** | 공고 식별자. | [default to undefined]
 **status** | [**BidPublicStatus**](BidPublicStatus.md) | 전이 후 공고 상태(공개값). | [default to undefined]
 **previousStatus** | [**BidPublicStatus**](BidPublicStatus.md) | 전이 전 공고 상태(공개값). 직전 상태를 특정할 수 없으면 null. | [optional] [default to undefined]
-**occurredAt** | **string** | 전이 시각(UTC ISO-8601). | [default to undefined]
+**occurredAt** | **string** | 전이 시각(ISO 8601 UTC). | [default to undefined]
 
 ## Example
 

package/docs/WebhookEventEnvelope.md

@@ -8,7 +8,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **id** | **string** | 이벤트 식별자. `webhook-id` 헤더와 같은 값입니다. | [default to undefined]
 **type** | **string** | 이벤트 타입. | [default to undefined]
-**createdAt** | **string** | 이벤트 발생 시각(UTC ISO-8601). | [default to undefined]
+**createdAt** | **string** | 이벤트 발생 시각(ISO 8601 UTC). | [default to undefined]
 **data** | **{ [key: string]: any; }** | 이벤트별 본문. 아래 이벤트 항목의 스키마를 보세요. | [default to undefined]
 
 ## Example

package/docs/WebhooksApi.md

@@ -79,7 +79,7 @@ No authorization required
 # **onBidAwarded**
 > onBidAwarded(onBidAwardedRequest)
 
-낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 다수업체 낙찰에서는 `isWinner`가 여럿일 수 있습니다.
+낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
 
 ### Example
 

package/docs/WellKnownApi.md

@@ -11,7 +11,7 @@ All URIs are relative to *https://partner-api.c-market.net*
 # **apiCatalog**
 > ApiCatalogDto apiCatalog()
 
-이 배포가 제공하는 API 표면과 각 표면의 기계용 스펙·사람용 문서·상태 링크를 RFC 9264 Linkset으로 공개합니다. 인증이 필요 없습니다.
+이 배포가 제공하는 API 목록과 각 API의 기계용 스펙·사람용 문서·상태 링크를 RFC 9264 Linkset으로 공개합니다. 인증이 필요 없습니다.
 
 ### Example
 
@@ -92,7 +92,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | RFC 8414 인가 서버 메타데이터. RFC가 최상위 필드를 규정하므로 &#x60;{data}&#x60; 봉투를 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
+|**200** | RFC 8414 인가 서버 메타데이터. RFC가 최상위 필드를 규정하므로 &#x60;{data}&#x60; 공통 응답 형식을 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 

package/index.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 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.2.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/models/acceptance-result-response-dto.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 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.2.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/models/acknowledge-product-receipt200-response.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 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.2.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/models/acknowledge-products-request-dto.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 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.2.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).