@cmarket/partner-sdk 0.10.0 → 1.0.0

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

@@ -0,0 +1,535 @@
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. 각 요청 body 에 `ID`(cate_set.api_id) / `Secret`(cate_set.api_secret, MD5-hex) 포함.
+ *
+ * The version of the OpenAPI document: 1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { Configuration } from '../configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import { type RequestArgs, BaseAPI } from '../base';
+import type { AcceptanceResultResponseDto } from '../models';
+import type { AwardRegisteredResponseDto } from '../models';
+import type { BidContractDocumentsBatchRequestDto } from '../models';
+import type { BidContractDocumentsResponseDto } from '../models';
+import type { BidCreatedResponseDto } from '../models';
+import type { BidFailedResponseDto } from '../models';
+import type { BidResultsBatchRequestDto } from '../models';
+import type { BidResultsResponseDto } from '../models';
+import type { BidSettlementResponseDto } from '../models';
+import type { BidStatementResponseDto } from '../models';
+import type { CompleteAcceptanceRequestDto } from '../models';
+import type { CreateBidRequestDto } from '../models';
+import type { FileUploadedResponseDto } from '../models';
+import type { HealthResponseDto } from '../models';
+import type { MarkBidFailedRequestDto } from '../models';
+import type { NegotiationScoredResponseDto } from '../models';
+import type { RegisterAwardRequestDto } from '../models';
+import type { RequestSplitInvoiceRequestDto } from '../models';
+import type { SplitInvoiceResponseDto } from '../models';
+import type { SubmitNegotiationScoresRequestDto } from '../models';
+import type { UploadFileRequestDto } from '../models';
+/**
+ * PartnerV2Api - axios parameter creator
+ */
+export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 검수완료 전송
+     * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    completeAcceptance: (bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * V5 /contractDocumentRec 후속. scope contracts:read.
+     * @summary 계약서류 수신 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocuments: (bidId: string, buyerId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 한 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
+     * @summary 계약서류 수신 배치 조회
+     * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocumentsBatch: (bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * V5 /entendrec 후속. scope bids:read.
+     * @summary 입찰 결과 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResults: (bidId: string, buyerId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * V5 entendRec(bid_puchase_no_list) 후속 — 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos 는 각 PO 의 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
+     * @summary 입찰결과 배치 조회
+     * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResultsBatch: (bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * @summary 입찰결과 정산정보 조회
+     * @param {string} bidId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidSettlement: (bidId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * V5 /getGrm 후속. scope contracts:read.
+     * @summary 거래명세서 조회
+     * @param {string} bidId
+     * @param {number} paperCode
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidStatement: (bidId: string, paperCode: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
+     * @summary Partner API 헬스체크
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    healthControllerCheck: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 유찰 처리
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markBidFailed: (idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 낙찰 결과 전송
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RegisterAwardRequestDto} registerAwardRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerAward: (idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+     * @summary 입찰 정보 전송(등록)
+     * @param {CreateBidRequestDto} createBidRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerBid: (createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 계산서 분할 발급 청구
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    requestSplitInvoice: (idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 협상(H/K) 점수평가
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores: (idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
+     * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+     * @param {UploadFileRequestDto} uploadFileRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    uploadFile: (uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * PartnerV2Api - functional programming interface
+ */
+export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
+    /**
+     * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 검수완료 전송
+     * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AcceptanceResultResponseDto>>;
+    /**
+     * V5 /contractDocumentRec 후속. scope contracts:read.
+     * @summary 계약서류 수신 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocuments(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidContractDocumentsResponseDto>>;
+    /**
+     * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 한 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
+     * @summary 계약서류 수신 배치 조회
+     * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<BidContractDocumentsResponseDto>>>;
+    /**
+     * V5 /entendrec 후속. scope bids:read.
+     * @summary 입찰 결과 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidResultsResponseDto>>;
+    /**
+     * V5 entendRec(bid_puchase_no_list) 후속 — 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos 는 각 PO 의 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
+     * @summary 입찰결과 배치 조회
+     * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<BidResultsResponseDto>>>;
+    /**
+     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * @summary 입찰결과 정산정보 조회
+     * @param {string} bidId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidSettlementResponseDto>>;
+    /**
+     * V5 /getGrm 후속. scope contracts:read.
+     * @summary 거래명세서 조회
+     * @param {string} bidId
+     * @param {number} paperCode
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidStatementResponseDto>>;
+    /**
+     * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
+     * @summary Partner API 헬스체크
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    healthControllerCheck(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<HealthResponseDto>>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 유찰 처리
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedResponseDto>>;
+    /**
+     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 낙찰 결과 전송
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RegisterAwardRequestDto} registerAwardRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredResponseDto>>;
+    /**
+     * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+     * @summary 입찰 정보 전송(등록)
+     * @param {CreateBidRequestDto} createBidRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidCreatedResponseDto>>;
+    /**
+     * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 계산서 분할 발급 청구
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SplitInvoiceResponseDto>>;
+    /**
+     * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 협상(H/K) 점수평가
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NegotiationScoredResponseDto>>;
+    /**
+     * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
+     * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+     * @param {UploadFileRequestDto} uploadFileRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    uploadFile(uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<FileUploadedResponseDto>>;
+};
+/**
+ * PartnerV2Api - factory interface
+ */
+export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 검수완료 전송
+     * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AcceptanceResultResponseDto>;
+    /**
+     * V5 /contractDocumentRec 후속. scope contracts:read.
+     * @summary 계약서류 수신 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocuments(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidContractDocumentsResponseDto>;
+    /**
+     * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 한 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
+     * @summary 계약서류 수신 배치 조회
+     * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<Array<BidContractDocumentsResponseDto>>;
+    /**
+     * V5 /entendrec 후속. scope bids:read.
+     * @summary 입찰 결과 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidResultsResponseDto>;
+    /**
+     * V5 entendRec(bid_puchase_no_list) 후속 — 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos 는 각 PO 의 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
+     * @summary 입찰결과 배치 조회
+     * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<Array<BidResultsResponseDto>>;
+    /**
+     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * @summary 입찰결과 정산정보 조회
+     * @param {string} bidId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidSettlementResponseDto>;
+    /**
+     * V5 /getGrm 후속. scope contracts:read.
+     * @summary 거래명세서 조회
+     * @param {string} bidId
+     * @param {number} paperCode
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): AxiosPromise<BidStatementResponseDto>;
+    /**
+     * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
+     * @summary Partner API 헬스체크
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    healthControllerCheck(options?: RawAxiosRequestConfig): AxiosPromise<HealthResponseDto>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 유찰 처리
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedResponseDto>;
+    /**
+     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 낙찰 결과 전송
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RegisterAwardRequestDto} registerAwardRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredResponseDto>;
+    /**
+     * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+     * @summary 입찰 정보 전송(등록)
+     * @param {CreateBidRequestDto} createBidRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidCreatedResponseDto>;
+    /**
+     * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 계산서 분할 발급 청구
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SplitInvoiceResponseDto>;
+    /**
+     * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 협상(H/K) 점수평가
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<NegotiationScoredResponseDto>;
+    /**
+     * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
+     * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+     * @param {UploadFileRequestDto} uploadFileRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    uploadFile(uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<FileUploadedResponseDto>;
+};
+/**
+ * PartnerV2Api - object-oriented interface
+ */
+export declare class PartnerV2Api extends BaseAPI {
+    /**
+     * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.  **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속.  **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다.  **부수효과:** - 검수완료 상태가 기록됩니다. - 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자를 함께 override할 수 있습니다(선택 필드). 비어있지 않은 값만 backend 가 `b2b_buy`에 stamp합니다(V5 taxbill UPDATE 조건부 set 패리티). - 응답은 204가 아닌 200입니다 — 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문.  **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다.  **필수 스코프:** `contracts:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 검수완료 전송
+     * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AcceptanceResultResponseDto, any, {}>>;
+    /**
+     * V5 /contractDocumentRec 후속. scope contracts:read.
+     * @summary 계약서류 수신 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocuments(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidContractDocumentsResponseDto, any, {}>>;
+    /**
+     * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 한 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
+     * @summary 계약서류 수신 배치 조회
+     * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidContractDocumentsResponseDto[], any, {}>>;
+    /**
+     * V5 /entendrec 후속. scope bids:read.
+     * @summary 입찰 결과 조회
+     * @param {string} bidId
+     * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidResultsResponseDto, any, {}>>;
+    /**
+     * V5 entendRec(bid_puchase_no_list) 후속 — 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos 는 각 PO 의 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
+     * @summary 입찰결과 배치 조회
+     * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidResultsResponseDto[], any, {}>>;
+    /**
+     * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
+     * @summary 입찰결과 정산정보 조회
+     * @param {string} bidId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidSettlementResponseDto, any, {}>>;
+    /**
+     * V5 /getGrm 후속. scope contracts:read.
+     * @summary 거래명세서 조회
+     * @param {string} bidId
+     * @param {number} paperCode
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidStatementResponseDto, any, {}>>;
+    /**
+     * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
+     * @summary Partner API 헬스체크
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    healthControllerCheck(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<HealthResponseDto, any, {}>>;
+    /**
+     * 공고를 유찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=U, 유찰) — BidApi.xml `yoochal` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드(V5 `b2b_buy.sayou`)와 상세(V5 `b2b_buy.sa_desc`)가 기록됩니다.  **유찰사유 코드 목록(BidFailureReason):** | 코드 | 의미 | |------|------| | `1` | 예정가격 초과 | | `2` | 자격 미달 | | `3` | 전문성 필요 | | `4` | 기타 (`failureReasonDetail` 필수) | | `5` | 참가자 없음 | | `6` | 단독 참가 | | `7` | 2인 미만 | | `8` | 최저가 미달 |  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 유찰 처리
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidFailedResponseDto, any, {}>>;
+    /**
+     * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다.  **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속.  **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감)인 상태에서 호출해야 합니다.  **부수효과:** - 공고 상태가 낙찰(AWARDED)로 전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다.  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
+     * @summary 낙찰 결과 전송
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RegisterAwardRequestDto} registerAwardRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AwardRegisteredResponseDto, any, {}>>;
+    /**
+     * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
+     * @summary 입찰 정보 전송(등록)
+     * @param {CreateBidRequestDto} createBidRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidCreatedResponseDto, any, {}>>;
+    /**
+     * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다.  **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속.  **호출 시점:** 검수완료 후 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다.  **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용.  **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액.  **필수 스코프:** `invoices:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 계산서 분할 발급 청구
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SplitInvoiceResponseDto, any, {}>>;
+    /**
+     * 협상에의한계약(낙찰방법 H/K) 응찰자별 기술/가격 점수를 일괄 입력합니다.  **V5 대응:** `scsbidSend`(type=nego, 점수입력) — BidApi.xml `nego-eval` 액션의 V6 후속.  **호출 시점:** 협상 방식 공고 마감 후 점수 평가를 진행할 때. `complete=true` 를 함께 보내면 평가완료 게이트(V5 `nego_complete_yn=Y`)까지 적용되어 낙찰 진입이 가능합니다.  **부수효과:** - 각 응찰자의 기술점수(`techPoint`) 및 가격점수(`bidPoint`, 선택)가 저장됩니다. - `complete=true`인 경우 평가완료 상태로 전환되어 이후 `/v1/awards`로 낙찰 처리가 가능합니다. - 가격점수(`bidPoint`)를 생략하면 backend 가 배점 기준에 따라 자동 계산합니다.  **응찰자 식별:** `sequence`(= V5 `buy_seq`, `entendrec` 응답의 `sequence` 필드).  **필수 스코프:** `awards:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+     * @summary 협상(H/K) 점수평가
+     * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
+     * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<NegotiationScoredResponseDto, any, {}>>;
+    /**
+     * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
+     * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+     * @param {UploadFileRequestDto} uploadFileRequestDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    uploadFile(uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<FileUploadedResponseDto, any, {}>>;
+}