@cmarket/partner-sdk 0.11.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/README.md +31 -18
  2. package/api/oauth-api.ts +2 -2
  3. package/api/partner-v1-api.ts +187 -684
  4. package/api/partner-v2-api.ts +1186 -0
  5. package/api.ts +2 -1
  6. package/base.ts +1 -1
  7. package/common.ts +1 -1
  8. package/configuration.ts +1 -1
  9. package/dist/api/oauth-api.d.ts +1 -1
  10. package/dist/api/oauth-api.js +2 -2
  11. package/dist/api/partner-v1-api.d.ts +113 -333
  12. package/dist/api/partner-v1-api.js +187 -655
  13. package/dist/api/partner-v2-api.d.ts +535 -0
  14. package/dist/api/partner-v2-api.js +1107 -0
  15. package/dist/api.d.ts +2 -1
  16. package/dist/api.js +2 -1
  17. package/dist/base.d.ts +1 -1
  18. package/dist/base.js +1 -1
  19. package/dist/common.d.ts +1 -1
  20. package/dist/common.js +1 -1
  21. package/dist/configuration.d.ts +1 -1
  22. package/dist/configuration.js +1 -1
  23. package/dist/esm/api/oauth-api.d.ts +1 -1
  24. package/dist/esm/api/oauth-api.js +2 -2
  25. package/dist/esm/api/partner-v1-api.d.ts +113 -333
  26. package/dist/esm/api/partner-v1-api.js +188 -656
  27. package/dist/esm/api/partner-v2-api.d.ts +535 -0
  28. package/dist/esm/api/partner-v2-api.js +1100 -0
  29. package/dist/esm/api.d.ts +2 -1
  30. package/dist/esm/api.js +2 -1
  31. package/dist/esm/base.d.ts +1 -1
  32. package/dist/esm/base.js +1 -1
  33. package/dist/esm/common.d.ts +1 -1
  34. package/dist/esm/common.js +1 -1
  35. package/dist/esm/configuration.d.ts +1 -1
  36. package/dist/esm/configuration.js +1 -1
  37. package/dist/esm/index.d.ts +1 -1
  38. package/dist/esm/index.js +1 -1
  39. package/dist/esm/models/acceptance-result-response-dto.d.ts +1 -1
  40. package/dist/esm/models/acceptance-result-response-dto.js +1 -1
  41. package/dist/esm/models/award-registered-response-dto.d.ts +1 -1
  42. package/dist/esm/models/award-registered-response-dto.js +1 -1
  43. package/dist/esm/models/bid-bond-dto.d.ts +1 -1
  44. package/dist/esm/models/bid-bond-dto.js +1 -1
  45. package/dist/esm/models/bid-contract-documents-batch-request-dto.d.ts +1 -1
  46. package/dist/esm/models/bid-contract-documents-batch-request-dto.js +1 -1
  47. package/dist/esm/models/bid-contract-documents-response-dto.d.ts +1 -1
  48. package/dist/esm/models/bid-contract-documents-response-dto.js +1 -1
  49. package/dist/esm/models/bid-created-response-dto.d.ts +1 -1
  50. package/dist/esm/models/bid-created-response-dto.js +1 -1
  51. package/dist/esm/models/bid-document-dto.d.ts +1 -1
  52. package/dist/esm/models/bid-document-dto.js +1 -1
  53. package/dist/esm/models/bid-failed-response-dto.d.ts +1 -1
  54. package/dist/esm/models/bid-failed-response-dto.js +1 -1
  55. package/dist/esm/models/bid-failure-reason.d.ts +1 -1
  56. package/dist/esm/models/bid-failure-reason.js +1 -1
  57. package/dist/esm/models/bid-item-dto.d.ts +1 -1
  58. package/dist/esm/models/bid-item-dto.js +1 -1
  59. package/dist/esm/models/bid-manager-dto.d.ts +1 -1
  60. package/dist/esm/models/bid-manager-dto.js +1 -1
  61. package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +1 -1
  62. package/dist/esm/models/bid-result-participant-attachment-dto.js +1 -1
  63. package/dist/esm/models/bid-result-participant-dto.d.ts +1 -1
  64. package/dist/esm/models/bid-result-participant-dto.js +1 -1
  65. package/dist/esm/models/bid-result-product-dto.d.ts +1 -1
  66. package/dist/esm/models/bid-result-product-dto.js +1 -1
  67. package/dist/esm/models/bid-result-winner-dto.d.ts +1 -1
  68. package/dist/esm/models/bid-result-winner-dto.js +1 -1
  69. package/dist/esm/models/bid-results-batch-request-dto.d.ts +1 -1
  70. package/dist/esm/models/bid-results-batch-request-dto.js +1 -1
  71. package/dist/esm/models/bid-results-response-dto.d.ts +1 -1
  72. package/dist/esm/models/bid-results-response-dto.js +1 -1
  73. package/dist/esm/models/bid-settlement-line-item-dto.d.ts +1 -1
  74. package/dist/esm/models/bid-settlement-line-item-dto.js +1 -1
  75. package/dist/esm/models/bid-settlement-participant-dto.d.ts +1 -1
  76. package/dist/esm/models/bid-settlement-participant-dto.js +1 -1
  77. package/dist/esm/models/bid-settlement-response-dto.d.ts +1 -1
  78. package/dist/esm/models/bid-settlement-response-dto.js +1 -1
  79. package/dist/esm/models/bid-statement-response-dto.d.ts +1 -1
  80. package/dist/esm/models/bid-statement-response-dto.js +1 -1
  81. package/dist/esm/models/complete-acceptance-request-dto.d.ts +1 -1
  82. package/dist/esm/models/complete-acceptance-request-dto.js +1 -1
  83. package/dist/esm/models/contract-document-item-dto.d.ts +1 -1
  84. package/dist/esm/models/contract-document-item-dto.js +1 -1
  85. package/dist/esm/models/create-bid-request-dto.d.ts +1 -1
  86. package/dist/esm/models/create-bid-request-dto.js +1 -1
  87. package/dist/esm/models/file-uploaded-response-dto.d.ts +1 -1
  88. package/dist/esm/models/file-uploaded-response-dto.js +1 -1
  89. package/dist/esm/models/health-response-dto.d.ts +1 -1
  90. package/dist/esm/models/health-response-dto.js +1 -1
  91. package/dist/esm/models/hierarchical-region-dto.d.ts +1 -1
  92. package/dist/esm/models/hierarchical-region-dto.js +1 -1
  93. package/dist/esm/models/mark-bid-failed-request-dto.d.ts +1 -1
  94. package/dist/esm/models/mark-bid-failed-request-dto.js +1 -1
  95. package/dist/esm/models/negotiation-score-dto.d.ts +1 -1
  96. package/dist/esm/models/negotiation-score-dto.js +1 -1
  97. package/dist/esm/models/negotiation-scored-response-dto.d.ts +1 -1
  98. package/dist/esm/models/negotiation-scored-response-dto.js +1 -1
  99. package/dist/esm/models/preconditions-dto.d.ts +1 -1
  100. package/dist/esm/models/preconditions-dto.js +1 -1
  101. package/dist/esm/models/problem-details-dto.d.ts +1 -1
  102. package/dist/esm/models/problem-details-dto.js +1 -1
  103. package/dist/esm/models/register-award-request-dto.d.ts +1 -1
  104. package/dist/esm/models/register-award-request-dto.js +1 -1
  105. package/dist/esm/models/request-split-invoice-request-dto.d.ts +1 -1
  106. package/dist/esm/models/request-split-invoice-request-dto.js +1 -1
  107. package/dist/esm/models/split-invoice-response-dto.d.ts +1 -1
  108. package/dist/esm/models/split-invoice-response-dto.js +1 -1
  109. package/dist/esm/models/statement-document-dto.d.ts +1 -1
  110. package/dist/esm/models/statement-document-dto.js +1 -1
  111. package/dist/esm/models/statement-product-dto.d.ts +1 -1
  112. package/dist/esm/models/statement-product-dto.js +1 -1
  113. package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  114. package/dist/esm/models/submit-negotiation-scores-request-dto.js +1 -1
  115. package/dist/esm/models/token-request-dto.d.ts +1 -1
  116. package/dist/esm/models/token-request-dto.js +1 -1
  117. package/dist/esm/models/token-response-dto.d.ts +1 -1
  118. package/dist/esm/models/token-response-dto.js +1 -1
  119. package/dist/esm/models/upload-file-request-dto.d.ts +1 -1
  120. package/dist/esm/models/upload-file-request-dto.js +1 -1
  121. package/dist/index.d.ts +1 -1
  122. package/dist/index.js +1 -1
  123. package/dist/models/acceptance-result-response-dto.d.ts +1 -1
  124. package/dist/models/acceptance-result-response-dto.js +1 -1
  125. package/dist/models/award-registered-response-dto.d.ts +1 -1
  126. package/dist/models/award-registered-response-dto.js +1 -1
  127. package/dist/models/bid-bond-dto.d.ts +1 -1
  128. package/dist/models/bid-bond-dto.js +1 -1
  129. package/dist/models/bid-contract-documents-batch-request-dto.d.ts +1 -1
  130. package/dist/models/bid-contract-documents-batch-request-dto.js +1 -1
  131. package/dist/models/bid-contract-documents-response-dto.d.ts +1 -1
  132. package/dist/models/bid-contract-documents-response-dto.js +1 -1
  133. package/dist/models/bid-created-response-dto.d.ts +1 -1
  134. package/dist/models/bid-created-response-dto.js +1 -1
  135. package/dist/models/bid-document-dto.d.ts +1 -1
  136. package/dist/models/bid-document-dto.js +1 -1
  137. package/dist/models/bid-failed-response-dto.d.ts +1 -1
  138. package/dist/models/bid-failed-response-dto.js +1 -1
  139. package/dist/models/bid-failure-reason.d.ts +1 -1
  140. package/dist/models/bid-failure-reason.js +1 -1
  141. package/dist/models/bid-item-dto.d.ts +1 -1
  142. package/dist/models/bid-item-dto.js +1 -1
  143. package/dist/models/bid-manager-dto.d.ts +1 -1
  144. package/dist/models/bid-manager-dto.js +1 -1
  145. package/dist/models/bid-result-participant-attachment-dto.d.ts +1 -1
  146. package/dist/models/bid-result-participant-attachment-dto.js +1 -1
  147. package/dist/models/bid-result-participant-dto.d.ts +1 -1
  148. package/dist/models/bid-result-participant-dto.js +1 -1
  149. package/dist/models/bid-result-product-dto.d.ts +1 -1
  150. package/dist/models/bid-result-product-dto.js +1 -1
  151. package/dist/models/bid-result-winner-dto.d.ts +1 -1
  152. package/dist/models/bid-result-winner-dto.js +1 -1
  153. package/dist/models/bid-results-batch-request-dto.d.ts +1 -1
  154. package/dist/models/bid-results-batch-request-dto.js +1 -1
  155. package/dist/models/bid-results-response-dto.d.ts +1 -1
  156. package/dist/models/bid-results-response-dto.js +1 -1
  157. package/dist/models/bid-settlement-line-item-dto.d.ts +1 -1
  158. package/dist/models/bid-settlement-line-item-dto.js +1 -1
  159. package/dist/models/bid-settlement-participant-dto.d.ts +1 -1
  160. package/dist/models/bid-settlement-participant-dto.js +1 -1
  161. package/dist/models/bid-settlement-response-dto.d.ts +1 -1
  162. package/dist/models/bid-settlement-response-dto.js +1 -1
  163. package/dist/models/bid-statement-response-dto.d.ts +1 -1
  164. package/dist/models/bid-statement-response-dto.js +1 -1
  165. package/dist/models/complete-acceptance-request-dto.d.ts +1 -1
  166. package/dist/models/complete-acceptance-request-dto.js +1 -1
  167. package/dist/models/contract-document-item-dto.d.ts +1 -1
  168. package/dist/models/contract-document-item-dto.js +1 -1
  169. package/dist/models/create-bid-request-dto.d.ts +1 -1
  170. package/dist/models/create-bid-request-dto.js +1 -1
  171. package/dist/models/file-uploaded-response-dto.d.ts +1 -1
  172. package/dist/models/file-uploaded-response-dto.js +1 -1
  173. package/dist/models/health-response-dto.d.ts +1 -1
  174. package/dist/models/health-response-dto.js +1 -1
  175. package/dist/models/hierarchical-region-dto.d.ts +1 -1
  176. package/dist/models/hierarchical-region-dto.js +1 -1
  177. package/dist/models/mark-bid-failed-request-dto.d.ts +1 -1
  178. package/dist/models/mark-bid-failed-request-dto.js +1 -1
  179. package/dist/models/negotiation-score-dto.d.ts +1 -1
  180. package/dist/models/negotiation-score-dto.js +1 -1
  181. package/dist/models/negotiation-scored-response-dto.d.ts +1 -1
  182. package/dist/models/negotiation-scored-response-dto.js +1 -1
  183. package/dist/models/preconditions-dto.d.ts +1 -1
  184. package/dist/models/preconditions-dto.js +1 -1
  185. package/dist/models/problem-details-dto.d.ts +1 -1
  186. package/dist/models/problem-details-dto.js +1 -1
  187. package/dist/models/register-award-request-dto.d.ts +1 -1
  188. package/dist/models/register-award-request-dto.js +1 -1
  189. package/dist/models/request-split-invoice-request-dto.d.ts +1 -1
  190. package/dist/models/request-split-invoice-request-dto.js +1 -1
  191. package/dist/models/split-invoice-response-dto.d.ts +1 -1
  192. package/dist/models/split-invoice-response-dto.js +1 -1
  193. package/dist/models/statement-document-dto.d.ts +1 -1
  194. package/dist/models/statement-document-dto.js +1 -1
  195. package/dist/models/statement-product-dto.d.ts +1 -1
  196. package/dist/models/statement-product-dto.js +1 -1
  197. package/dist/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  198. package/dist/models/submit-negotiation-scores-request-dto.js +1 -1
  199. package/dist/models/token-request-dto.d.ts +1 -1
  200. package/dist/models/token-request-dto.js +1 -1
  201. package/dist/models/token-response-dto.d.ts +1 -1
  202. package/dist/models/token-response-dto.js +1 -1
  203. package/dist/models/upload-file-request-dto.d.ts +1 -1
  204. package/dist/models/upload-file-request-dto.js +1 -1
  205. package/docs/OauthApi.md +1 -1
  206. package/docs/PartnerV1Api.md +61 -413
  207. package/docs/PartnerV2Api.md +789 -0
  208. package/index.ts +1 -1
  209. package/models/acceptance-result-response-dto.ts +1 -1
  210. package/models/award-registered-response-dto.ts +1 -1
  211. package/models/bid-bond-dto.ts +1 -1
  212. package/models/bid-contract-documents-batch-request-dto.ts +1 -1
  213. package/models/bid-contract-documents-response-dto.ts +1 -1
  214. package/models/bid-created-response-dto.ts +1 -1
  215. package/models/bid-document-dto.ts +1 -1
  216. package/models/bid-failed-response-dto.ts +1 -1
  217. package/models/bid-failure-reason.ts +1 -1
  218. package/models/bid-item-dto.ts +1 -1
  219. package/models/bid-manager-dto.ts +1 -1
  220. package/models/bid-result-participant-attachment-dto.ts +1 -1
  221. package/models/bid-result-participant-dto.ts +1 -1
  222. package/models/bid-result-product-dto.ts +1 -1
  223. package/models/bid-result-winner-dto.ts +1 -1
  224. package/models/bid-results-batch-request-dto.ts +1 -1
  225. package/models/bid-results-response-dto.ts +1 -1
  226. package/models/bid-settlement-line-item-dto.ts +1 -1
  227. package/models/bid-settlement-participant-dto.ts +1 -1
  228. package/models/bid-settlement-response-dto.ts +1 -1
  229. package/models/bid-statement-response-dto.ts +1 -1
  230. package/models/complete-acceptance-request-dto.ts +1 -1
  231. package/models/contract-document-item-dto.ts +1 -1
  232. package/models/create-bid-request-dto.ts +1 -1
  233. package/models/file-uploaded-response-dto.ts +1 -1
  234. package/models/health-response-dto.ts +1 -1
  235. package/models/hierarchical-region-dto.ts +1 -1
  236. package/models/mark-bid-failed-request-dto.ts +1 -1
  237. package/models/negotiation-score-dto.ts +1 -1
  238. package/models/negotiation-scored-response-dto.ts +1 -1
  239. package/models/preconditions-dto.ts +1 -1
  240. package/models/problem-details-dto.ts +1 -1
  241. package/models/register-award-request-dto.ts +1 -1
  242. package/models/request-split-invoice-request-dto.ts +1 -1
  243. package/models/split-invoice-response-dto.ts +1 -1
  244. package/models/statement-document-dto.ts +1 -1
  245. package/models/statement-product-dto.ts +1 -1
  246. package/models/submit-negotiation-scores-request-dto.ts +1 -1
  247. package/models/token-request-dto.ts +1 -1
  248. package/models/token-response-dto.ts +1 -1
  249. package/models/upload-file-request-dto.ts +1 -1
  250. package/package.json +1 -1
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 ERP 연동용 RESTful API.
3
+ * 외부 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) 포함.
4
4
  *
5
5
  * The version of the OpenAPI document: 1.0
6
6
  *
@@ -20,548 +20,328 @@ import type { BidCreatedResponseDto } from '../models';
20
20
  import type { BidFailedResponseDto } from '../models';
21
21
  import type { BidResultsBatchRequestDto } from '../models';
22
22
  import type { BidResultsResponseDto } from '../models';
23
- import type { BidSettlementResponseDto } from '../models';
24
23
  import type { BidStatementResponseDto } from '../models';
25
24
  import type { CompleteAcceptanceRequestDto } from '../models';
26
25
  import type { CreateBidRequestDto } from '../models';
27
- import type { FileUploadedResponseDto } from '../models';
28
- import type { HealthResponseDto } from '../models';
29
26
  import type { MarkBidFailedRequestDto } from '../models';
30
27
  import type { NegotiationScoredResponseDto } from '../models';
31
28
  import type { RegisterAwardRequestDto } from '../models';
32
29
  import type { RequestSplitInvoiceRequestDto } from '../models';
33
30
  import type { SplitInvoiceResponseDto } from '../models';
34
31
  import type { SubmitNegotiationScoresRequestDto } from '../models';
35
- import type { UploadFileRequestDto } from '../models';
36
32
  /**
37
33
  * PartnerV1Api - axios parameter creator
38
34
  */
39
35
  export declare const PartnerV1ApiAxiosParamCreator: (configuration?: Configuration) => {
40
36
  /**
41
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **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` 헤더 필수.
42
- * @summary 검수완료 전송
43
- * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
44
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
45
- * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
46
- * @param {*} [options] Override http request option.
47
- * @throws {RequiredError}
48
- */
49
- completeAcceptance: (bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
50
- /**
51
- * V5 /contractDocumentRec 후속. scope contracts:read.
52
- * @summary 계약서류 수신 조회
37
+ * V5 `/acceptanceCompleteSend` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
38
+ * @summary 검수완료 전송 — V5 충실
53
39
  * @param {string} bidId
54
- * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
40
+ * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
55
41
  * @param {*} [options] Override http request option.
56
42
  * @throws {RequiredError}
57
43
  */
58
- getBidContractDocuments: (bidId: string, buyerId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
44
+ v1CompleteAcceptance: (bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
59
45
  /**
60
- * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
61
- * @summary 계약서류 수신 배치 조회
46
+ * V5 `/contractDocumentRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
47
+ * @summary 계약서류 수신 배치 조회 — V5 충실
62
48
  * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
63
49
  * @param {*} [options] Override http request option.
64
50
  * @throws {RequiredError}
65
51
  */
66
- getBidContractDocumentsBatch: (bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
67
- /**
68
- * V5 /entendrec 후속. scope bids:read.
69
- * @summary 입찰 결과 조회
70
- * @param {string} bidId
71
- * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
72
- * @param {*} [options] Override http request option.
73
- * @throws {RequiredError}
74
- */
75
- getBidResults: (bidId: string, buyerId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
52
+ v1GetBidContractDocumentsBatch: (bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
76
53
  /**
77
- * V5 entendRec(bid_puchase_no_list) 후속 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos PO 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
78
- * @summary 입찰결과 배치 조회
54
+ * V5 `/entendRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerIdgroup_code 자동 결정. resolveBidId 엔드포인트를 사용한다.
55
+ * @summary 입찰결과 배치 조회 — V5 충실
79
56
  * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
80
57
  * @param {*} [options] Override http request option.
81
58
  * @throws {RequiredError}
82
59
  */
83
- getBidResultsBatch: (bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
84
- /**
85
- * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
86
- * @summary 입찰결과 정산정보 조회
87
- * @param {string} bidId
88
- * @param {*} [options] Override http request option.
89
- * @throws {RequiredError}
90
- */
91
- getBidSettlement: (bidId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
60
+ v1GetBidResultsBatch: (bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
92
61
  /**
93
- * V5 /getGrm 후속. scope contracts:read.
94
- * @summary 거래명세서 조회
62
+ * V5 `/getGrm` 후속. 인증 = body `ID`/`Secret`(cate_set). group_code 스코프로 가시성 적용.
63
+ * @summary 거래명세서 조회 — V5 충실
95
64
  * @param {string} bidId
96
65
  * @param {number} paperCode
97
66
  * @param {*} [options] Override http request option.
98
67
  * @throws {RequiredError}
99
68
  */
100
- getBidStatement: (bidId: string, paperCode: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
69
+ v1GetBidStatement: (bidId: string, paperCode: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
101
70
  /**
102
- * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
103
- * @summary Partner API 헬스체크
104
- * @param {*} [options] Override http request option.
105
- * @throws {RequiredError}
106
- */
107
- healthControllerCheck: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
108
- /**
109
- * 공고를 유찰 상태로 전환합니다. **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` 헤더 필수.
110
- * @summary 유찰 처리
111
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
71
+ * V5 `scsbidSend`(type=U) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
72
+ * @summary 유찰 처리 — V5 충실
112
73
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
113
74
  * @param {*} [options] Override http request option.
114
75
  * @throws {RequiredError}
115
76
  */
116
- markBidFailed: (idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
117
- /**
118
- * V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
119
- * @summary V5→V6 마이그레이션 패리티 결과 기록
120
- * @param {object} body
121
- * @param {*} [options] Override http request option.
122
- * @throws {RequiredError}
123
- */
124
- recordParityResult: (body: object, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
77
+ v1MarkBidFailed: (markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
125
78
  /**
126
- * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다. **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감) 상태에서 호출해야 합니다. **부수효과:** - 공고 상태가 낙찰(AWARDED)전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다. **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
127
- * @summary 낙찰 결과 전송
128
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
79
+ * V5 `scsbidSend`(type=W) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code자동 결정.
80
+ * @summary 낙찰 결과 전송 — V5 충실
129
81
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
130
82
  * @param {*} [options] Override http request option.
131
83
  * @throws {RequiredError}
132
84
  */
133
- registerAward: (idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
85
+ v1RegisterAward: (registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
134
86
  /**
135
- * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
136
- * @summary 입찰 정보 전송(등록)
87
+ * V5 `scsbidSend`(type=B) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
88
+ * @summary 입찰 정보 전송(등록) — V5 충실
137
89
  * @param {CreateBidRequestDto} createBidRequestDto
138
90
  * @param {*} [options] Override http request option.
139
91
  * @throws {RequiredError}
140
92
  */
141
- registerBid: (createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
93
+ v1RegisterBid: (createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
142
94
  /**
143
- * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다. **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속. **호출 시점:** 검수완료 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다. **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용. **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액. **필수 스코프:** `invoices:write` **멱등성:** `Idempotency-Key` 헤더 필수.
144
- * @summary 계산서 분할 발급 청구
145
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
95
+ * V5 `splitInvoiceRequest` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
96
+ * @summary 계산서 분할 발급 청구 — V5 충실
146
97
  * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
147
98
  * @param {*} [options] Override http request option.
148
99
  * @throws {RequiredError}
149
100
  */
150
- requestSplitInvoice: (idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
101
+ v1RequestSplitInvoice: (requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
151
102
  /**
152
- * 협상에의한계약(낙찰방법 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` 헤더 필수.
153
- * @summary 협상(H/K) 점수평가
154
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
103
+ * V5 `scsbidSend`(type=nego) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
104
+ * @summary 협상(H/K) 점수평가 — V5 충실
155
105
  * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
156
106
  * @param {*} [options] Override http request option.
157
107
  * @throws {RequiredError}
158
108
  */
159
- submitNegotiationScores: (idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
160
- /**
161
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
162
- * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
163
- * @param {UploadFileRequestDto} uploadFileRequestDto
164
- * @param {*} [options] Override http request option.
165
- * @throws {RequiredError}
166
- */
167
- uploadFile: (uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
109
+ v1SubmitNegotiationScores: (submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
168
110
  };
169
111
  /**
170
112
  * PartnerV1Api - functional programming interface
171
113
  */
172
114
  export declare const PartnerV1ApiFp: (configuration?: Configuration) => {
173
115
  /**
174
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **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` 헤더 필수.
175
- * @summary 검수완료 전송
176
- * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
177
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
178
- * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
179
- * @param {*} [options] Override http request option.
180
- * @throws {RequiredError}
181
- */
182
- completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AcceptanceResultResponseDto>>;
183
- /**
184
- * V5 /contractDocumentRec 후속. scope contracts:read.
185
- * @summary 계약서류 수신 조회
116
+ * V5 `/acceptanceCompleteSend` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
117
+ * @summary 검수완료 전송 — V5 충실
186
118
  * @param {string} bidId
187
- * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
119
+ * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
188
120
  * @param {*} [options] Override http request option.
189
121
  * @throws {RequiredError}
190
122
  */
191
- getBidContractDocuments(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidContractDocumentsResponseDto>>;
123
+ v1CompleteAcceptance(bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AcceptanceResultResponseDto>>;
192
124
  /**
193
- * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
194
- * @summary 계약서류 수신 배치 조회
125
+ * V5 `/contractDocumentRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
126
+ * @summary 계약서류 수신 배치 조회 — V5 충실
195
127
  * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
196
128
  * @param {*} [options] Override http request option.
197
129
  * @throws {RequiredError}
198
130
  */
199
- getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<BidContractDocumentsResponseDto>>>;
200
- /**
201
- * V5 /entendrec 후속. scope bids:read.
202
- * @summary 입찰 결과 조회
203
- * @param {string} bidId
204
- * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
205
- * @param {*} [options] Override http request option.
206
- * @throws {RequiredError}
207
- */
208
- getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidResultsResponseDto>>;
131
+ v1GetBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<BidContractDocumentsResponseDto>>>;
209
132
  /**
210
- * V5 entendRec(bid_puchase_no_list) 후속 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos PO 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
211
- * @summary 입찰결과 배치 조회
133
+ * V5 `/entendRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerIdgroup_code 자동 결정. resolveBidId 엔드포인트를 사용한다.
134
+ * @summary 입찰결과 배치 조회 — V5 충실
212
135
  * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
213
136
  * @param {*} [options] Override http request option.
214
137
  * @throws {RequiredError}
215
138
  */
216
- getBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<BidResultsResponseDto>>>;
217
- /**
218
- * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
219
- * @summary 입찰결과 정산정보 조회
220
- * @param {string} bidId
221
- * @param {*} [options] Override http request option.
222
- * @throws {RequiredError}
223
- */
224
- getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidSettlementResponseDto>>;
139
+ v1GetBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<BidResultsResponseDto>>>;
225
140
  /**
226
- * V5 /getGrm 후속. scope contracts:read.
227
- * @summary 거래명세서 조회
141
+ * V5 `/getGrm` 후속. 인증 = body `ID`/`Secret`(cate_set). group_code 스코프로 가시성 적용.
142
+ * @summary 거래명세서 조회 — V5 충실
228
143
  * @param {string} bidId
229
144
  * @param {number} paperCode
230
145
  * @param {*} [options] Override http request option.
231
146
  * @throws {RequiredError}
232
147
  */
233
- getBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidStatementResponseDto>>;
148
+ v1GetBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidStatementResponseDto>>;
234
149
  /**
235
- * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
236
- * @summary Partner API 헬스체크
237
- * @param {*} [options] Override http request option.
238
- * @throws {RequiredError}
239
- */
240
- healthControllerCheck(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<HealthResponseDto>>;
241
- /**
242
- * 공고를 유찰 상태로 전환합니다. **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` 헤더 필수.
243
- * @summary 유찰 처리
244
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
150
+ * V5 `scsbidSend`(type=U) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
151
+ * @summary 유찰 처리 — V5 충실
245
152
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
246
153
  * @param {*} [options] Override http request option.
247
154
  * @throws {RequiredError}
248
155
  */
249
- markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedResponseDto>>;
250
- /**
251
- * V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
252
- * @summary V5→V6 마이그레이션 패리티 결과 기록
253
- * @param {object} body
254
- * @param {*} [options] Override http request option.
255
- * @throws {RequiredError}
256
- */
257
- recordParityResult(body: object, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
156
+ v1MarkBidFailed(markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidFailedResponseDto>>;
258
157
  /**
259
- * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다. **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감) 상태에서 호출해야 합니다. **부수효과:** - 공고 상태가 낙찰(AWARDED)전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다. **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
260
- * @summary 낙찰 결과 전송
261
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
158
+ * V5 `scsbidSend`(type=W) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code자동 결정.
159
+ * @summary 낙찰 결과 전송 — V5 충실
262
160
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
263
161
  * @param {*} [options] Override http request option.
264
162
  * @throws {RequiredError}
265
163
  */
266
- registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredResponseDto>>;
164
+ v1RegisterAward(registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AwardRegisteredResponseDto>>;
267
165
  /**
268
- * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
269
- * @summary 입찰 정보 전송(등록)
166
+ * V5 `scsbidSend`(type=B) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
167
+ * @summary 입찰 정보 전송(등록) — V5 충실
270
168
  * @param {CreateBidRequestDto} createBidRequestDto
271
169
  * @param {*} [options] Override http request option.
272
170
  * @throws {RequiredError}
273
171
  */
274
- registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidCreatedResponseDto>>;
172
+ v1RegisterBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidCreatedResponseDto>>;
275
173
  /**
276
- * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다. **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속. **호출 시점:** 검수완료 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다. **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용. **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액. **필수 스코프:** `invoices:write` **멱등성:** `Idempotency-Key` 헤더 필수.
277
- * @summary 계산서 분할 발급 청구
278
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
174
+ * V5 `splitInvoiceRequest` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
175
+ * @summary 계산서 분할 발급 청구 — V5 충실
279
176
  * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
280
177
  * @param {*} [options] Override http request option.
281
178
  * @throws {RequiredError}
282
179
  */
283
- requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SplitInvoiceResponseDto>>;
180
+ v1RequestSplitInvoice(requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SplitInvoiceResponseDto>>;
284
181
  /**
285
- * 협상에의한계약(낙찰방법 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` 헤더 필수.
286
- * @summary 협상(H/K) 점수평가
287
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
182
+ * V5 `scsbidSend`(type=nego) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
183
+ * @summary 협상(H/K) 점수평가 — V5 충실
288
184
  * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
289
185
  * @param {*} [options] Override http request option.
290
186
  * @throws {RequiredError}
291
187
  */
292
- submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NegotiationScoredResponseDto>>;
293
- /**
294
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
295
- * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
296
- * @param {UploadFileRequestDto} uploadFileRequestDto
297
- * @param {*} [options] Override http request option.
298
- * @throws {RequiredError}
299
- */
300
- uploadFile(uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<FileUploadedResponseDto>>;
188
+ v1SubmitNegotiationScores(submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NegotiationScoredResponseDto>>;
301
189
  };
302
190
  /**
303
191
  * PartnerV1Api - factory interface
304
192
  */
305
193
  export declare const PartnerV1ApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
306
194
  /**
307
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **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` 헤더 필수.
308
- * @summary 검수완료 전송
309
- * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
310
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
311
- * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
312
- * @param {*} [options] Override http request option.
313
- * @throws {RequiredError}
314
- */
315
- completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AcceptanceResultResponseDto>;
316
- /**
317
- * V5 /contractDocumentRec 후속. scope contracts:read.
318
- * @summary 계약서류 수신 조회
195
+ * V5 `/acceptanceCompleteSend` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
196
+ * @summary 검수완료 전송 — V5 충실
319
197
  * @param {string} bidId
320
- * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
198
+ * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
321
199
  * @param {*} [options] Override http request option.
322
200
  * @throws {RequiredError}
323
201
  */
324
- getBidContractDocuments(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidContractDocumentsResponseDto>;
202
+ v1CompleteAcceptance(bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AcceptanceResultResponseDto>;
325
203
  /**
326
- * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
327
- * @summary 계약서류 수신 배치 조회
204
+ * V5 `/contractDocumentRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
205
+ * @summary 계약서류 수신 배치 조회 — V5 충실
328
206
  * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
329
207
  * @param {*} [options] Override http request option.
330
208
  * @throws {RequiredError}
331
209
  */
332
- getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<Array<BidContractDocumentsResponseDto>>;
333
- /**
334
- * V5 /entendrec 후속. scope bids:read.
335
- * @summary 입찰 결과 조회
336
- * @param {string} bidId
337
- * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
338
- * @param {*} [options] Override http request option.
339
- * @throws {RequiredError}
340
- */
341
- getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidResultsResponseDto>;
210
+ v1GetBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<Array<BidContractDocumentsResponseDto>>;
342
211
  /**
343
- * V5 entendRec(bid_puchase_no_list) 후속 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos PO 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
344
- * @summary 입찰결과 배치 조회
212
+ * V5 `/entendRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerIdgroup_code 자동 결정. resolveBidId 엔드포인트를 사용한다.
213
+ * @summary 입찰결과 배치 조회 — V5 충실
345
214
  * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
346
215
  * @param {*} [options] Override http request option.
347
216
  * @throws {RequiredError}
348
217
  */
349
- getBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<Array<BidResultsResponseDto>>;
350
- /**
351
- * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
352
- * @summary 입찰결과 정산정보 조회
353
- * @param {string} bidId
354
- * @param {*} [options] Override http request option.
355
- * @throws {RequiredError}
356
- */
357
- getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): AxiosPromise<BidSettlementResponseDto>;
218
+ v1GetBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<Array<BidResultsResponseDto>>;
358
219
  /**
359
- * V5 /getGrm 후속. scope contracts:read.
360
- * @summary 거래명세서 조회
220
+ * V5 `/getGrm` 후속. 인증 = body `ID`/`Secret`(cate_set). group_code 스코프로 가시성 적용.
221
+ * @summary 거래명세서 조회 — V5 충실
361
222
  * @param {string} bidId
362
223
  * @param {number} paperCode
363
224
  * @param {*} [options] Override http request option.
364
225
  * @throws {RequiredError}
365
226
  */
366
- getBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): AxiosPromise<BidStatementResponseDto>;
227
+ v1GetBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): AxiosPromise<BidStatementResponseDto>;
367
228
  /**
368
- * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
369
- * @summary Partner API 헬스체크
370
- * @param {*} [options] Override http request option.
371
- * @throws {RequiredError}
372
- */
373
- healthControllerCheck(options?: RawAxiosRequestConfig): AxiosPromise<HealthResponseDto>;
374
- /**
375
- * 공고를 유찰 상태로 전환합니다. **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` 헤더 필수.
376
- * @summary 유찰 처리
377
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
229
+ * V5 `scsbidSend`(type=U) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
230
+ * @summary 유찰 처리 — V5 충실
378
231
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
379
232
  * @param {*} [options] Override http request option.
380
233
  * @throws {RequiredError}
381
234
  */
382
- markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedResponseDto>;
383
- /**
384
- * V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
385
- * @summary V5→V6 마이그레이션 패리티 결과 기록
386
- * @param {object} body
387
- * @param {*} [options] Override http request option.
388
- * @throws {RequiredError}
389
- */
390
- recordParityResult(body: object, options?: RawAxiosRequestConfig): AxiosPromise<void>;
235
+ v1MarkBidFailed(markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidFailedResponseDto>;
391
236
  /**
392
- * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다. **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감) 상태에서 호출해야 합니다. **부수효과:** - 공고 상태가 낙찰(AWARDED)전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다. **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
393
- * @summary 낙찰 결과 전송
394
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
237
+ * V5 `scsbidSend`(type=W) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code자동 결정.
238
+ * @summary 낙찰 결과 전송 — V5 충실
395
239
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
396
240
  * @param {*} [options] Override http request option.
397
241
  * @throws {RequiredError}
398
242
  */
399
- registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredResponseDto>;
243
+ v1RegisterAward(registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<AwardRegisteredResponseDto>;
400
244
  /**
401
- * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
402
- * @summary 입찰 정보 전송(등록)
245
+ * V5 `scsbidSend`(type=B) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
246
+ * @summary 입찰 정보 전송(등록) — V5 충실
403
247
  * @param {CreateBidRequestDto} createBidRequestDto
404
248
  * @param {*} [options] Override http request option.
405
249
  * @throws {RequiredError}
406
250
  */
407
- registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidCreatedResponseDto>;
251
+ v1RegisterBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidCreatedResponseDto>;
408
252
  /**
409
- * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다. **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속. **호출 시점:** 검수완료 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다. **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용. **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액. **필수 스코프:** `invoices:write` **멱등성:** `Idempotency-Key` 헤더 필수.
410
- * @summary 계산서 분할 발급 청구
411
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
253
+ * V5 `splitInvoiceRequest` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
254
+ * @summary 계산서 분할 발급 청구 — V5 충실
412
255
  * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
413
256
  * @param {*} [options] Override http request option.
414
257
  * @throws {RequiredError}
415
258
  */
416
- requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SplitInvoiceResponseDto>;
259
+ v1RequestSplitInvoice(requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SplitInvoiceResponseDto>;
417
260
  /**
418
- * 협상에의한계약(낙찰방법 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` 헤더 필수.
419
- * @summary 협상(H/K) 점수평가
420
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
261
+ * V5 `scsbidSend`(type=nego) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
262
+ * @summary 협상(H/K) 점수평가 — V5 충실
421
263
  * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
422
264
  * @param {*} [options] Override http request option.
423
265
  * @throws {RequiredError}
424
266
  */
425
- submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<NegotiationScoredResponseDto>;
426
- /**
427
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
428
- * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
429
- * @param {UploadFileRequestDto} uploadFileRequestDto
430
- * @param {*} [options] Override http request option.
431
- * @throws {RequiredError}
432
- */
433
- uploadFile(uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<FileUploadedResponseDto>;
267
+ v1SubmitNegotiationScores(submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<NegotiationScoredResponseDto>;
434
268
  };
435
269
  /**
436
270
  * PartnerV1Api - object-oriented interface
437
271
  */
438
272
  export declare class PartnerV1Api extends BaseAPI {
439
273
  /**
440
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **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` 헤더 필수.
441
- * @summary 검수완료 전송
442
- * @param {string} bidId 공고 ID(&#x3D; backend bidId &#x3D; 등록 응답의 bidNo).
443
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
444
- * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
445
- * @param {*} [options] Override http request option.
446
- * @throws {RequiredError}
447
- */
448
- completeAcceptance(bidId: string, idempotencyKey: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AcceptanceResultResponseDto, any, {}>>;
449
- /**
450
- * V5 /contractDocumentRec 후속. scope contracts:read.
451
- * @summary 계약서류 수신 조회
274
+ * V5 `/acceptanceCompleteSend` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
275
+ * @summary 검수완료 전송 — V5 충실
452
276
  * @param {string} bidId
453
- * @param {string} buyerId 공고 명의 회원 ID(b2b_member.member_id).
277
+ * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
454
278
  * @param {*} [options] Override http request option.
455
279
  * @throws {RequiredError}
456
280
  */
457
- getBidContractDocuments(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidContractDocumentsResponseDto, any, {}>>;
281
+ v1CompleteAcceptance(bidId: string, completeAcceptanceRequestDto: CompleteAcceptanceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AcceptanceResultResponseDto, any, {}>>;
458
282
  /**
459
- * V5 /contractDocumentRec(bid_puchase_no_list) 후속. 공고번호 리스트를 번에 조회. 단건(GET :bidId/contract-documents)은 그대로 유지. scope contracts:read.
460
- * @summary 계약서류 수신 배치 조회
283
+ * V5 `/contractDocumentRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
284
+ * @summary 계약서류 수신 배치 조회 — V5 충실
461
285
  * @param {BidContractDocumentsBatchRequestDto} bidContractDocumentsBatchRequestDto
462
286
  * @param {*} [options] Override http request option.
463
287
  * @throws {RequiredError}
464
288
  */
465
- getBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidContractDocumentsResponseDto[], any, {}>>;
466
- /**
467
- * V5 /entendrec 후속. scope bids:read.
468
- * @summary 입찰 결과 조회
469
- * @param {string} bidId
470
- * @param {string} buyerId 공고 명의 회원 ID (멀티테넌트 가시성 키).
471
- * @param {*} [options] Override http request option.
472
- * @throws {RequiredError}
473
- */
474
- getBidResults(bidId: string, buyerId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidResultsResponseDto, any, {}>>;
289
+ v1GetBidContractDocumentsBatch(bidContractDocumentsBatchRequestDto: BidContractDocumentsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidContractDocumentsResponseDto[], any, {}>>;
475
290
  /**
476
- * V5 entendRec(bid_puchase_no_list) 후속 여러 공고 결과를 1회 호출로(additive, 단건 유지). bidIds(공고 식별자) 또는 purchaseNos(구매번호) 중 하나 — purchaseNos PO 가장 최근 공고로 해소. 입력 순서를 보존한다. scope bids:read.
477
- * @summary 입찰결과 배치 조회
291
+ * V5 `/entendRec`(bid_puchase_no_list) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerIdgroup_code 자동 결정. resolveBidId 엔드포인트를 사용한다.
292
+ * @summary 입찰결과 배치 조회 — V5 충실
478
293
  * @param {BidResultsBatchRequestDto} bidResultsBatchRequestDto
479
294
  * @param {*} [options] Override http request option.
480
295
  * @throws {RequiredError}
481
296
  */
482
- getBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidResultsResponseDto[], any, {}>>;
483
- /**
484
- * V5 /entendrec 정산(사업자·계좌·공급가액/부가세·응찰 품목내역) 후속. scope bids:read. 가격/신원 가시성 매트릭스와 직교한 ERP 정산 데이터 — read-only.
485
- * @summary 입찰결과 정산정보 조회
486
- * @param {string} bidId
487
- * @param {*} [options] Override http request option.
488
- * @throws {RequiredError}
489
- */
490
- getBidSettlement(bidId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidSettlementResponseDto, any, {}>>;
297
+ v1GetBidResultsBatch(bidResultsBatchRequestDto: BidResultsBatchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidResultsResponseDto[], any, {}>>;
491
298
  /**
492
- * V5 /getGrm 후속. scope contracts:read.
493
- * @summary 거래명세서 조회
299
+ * V5 `/getGrm` 후속. 인증 = body `ID`/`Secret`(cate_set). group_code 스코프로 가시성 적용.
300
+ * @summary 거래명세서 조회 — V5 충실
494
301
  * @param {string} bidId
495
302
  * @param {number} paperCode
496
303
  * @param {*} [options] Override http request option.
497
304
  * @throws {RequiredError}
498
305
  */
499
- getBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidStatementResponseDto, any, {}>>;
306
+ v1GetBidStatement(bidId: string, paperCode: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidStatementResponseDto, any, {}>>;
500
307
  /**
501
- * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
502
- * @summary Partner API 헬스체크
503
- * @param {*} [options] Override http request option.
504
- * @throws {RequiredError}
505
- */
506
- healthControllerCheck(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<HealthResponseDto, any, {}>>;
507
- /**
508
- * 공고를 유찰 상태로 전환합니다. **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` 헤더 필수.
509
- * @summary 유찰 처리
510
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
308
+ * V5 `scsbidSend`(type=U) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
309
+ * @summary 유찰 처리 — V5 충실
511
310
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
512
311
  * @param {*} [options] Override http request option.
513
312
  * @throws {RequiredError}
514
313
  */
515
- markBidFailed(idempotencyKey: string, markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidFailedResponseDto, any, {}>>;
516
- /**
517
- * V5↔V6 응답 비교 불일치(verdict)를 적재한다. scope parity:write. V5 cutover 시 제거 예정(한시적 계약).
518
- * @summary V5→V6 마이그레이션 패리티 결과 기록
519
- * @param {object} body
520
- * @param {*} [options] Override http request option.
521
- * @throws {RequiredError}
522
- */
523
- recordParityResult(body: object, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
314
+ v1MarkBidFailed(markBidFailedRequestDto: MarkBidFailedRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidFailedResponseDto, any, {}>>;
524
315
  /**
525
- * 낙찰 결과를 등록하고 공고를 낙찰 상태로 전환합니다. **V5 대응:** `scsbidSend`(type=W, 낙찰) — BidApi.xml `selectWinner` 액션의 V6 후속. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고 상태가 입찰완료(마감) 상태에서 호출해야 합니다. **부수효과:** - 공고 상태가 낙찰(AWARDED)전환됩니다. - 낙찰자(공급사) 응찰행이 낙찰 처리됩니다. - 협상 방식(H/K)은 이 엔드포인트 전에 `/v1/awards/nego-eval`로 평가 완료가 필요합니다. **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
526
- * @summary 낙찰 결과 전송
527
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
316
+ * V5 `scsbidSend`(type=W) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code자동 결정.
317
+ * @summary 낙찰 결과 전송 — V5 충실
528
318
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
529
319
  * @param {*} [options] Override http request option.
530
320
  * @throws {RequiredError}
531
321
  */
532
- registerAward(idempotencyKey: string, registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AwardRegisteredResponseDto, any, {}>>;
322
+ v1RegisterAward(registerAwardRequestDto: RegisterAwardRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AwardRegisteredResponseDto, any, {}>>;
533
323
  /**
534
- * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
535
- * @summary 입찰 정보 전송(등록)
324
+ * V5 `scsbidSend`(type=B) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId 는 group_code 로 자동 결정.
325
+ * @summary 입찰 정보 전송(등록) — V5 충실
536
326
  * @param {CreateBidRequestDto} createBidRequestDto
537
327
  * @param {*} [options] Override http request option.
538
328
  * @throws {RequiredError}
539
329
  */
540
- registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidCreatedResponseDto, any, {}>>;
330
+ v1RegisterBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidCreatedResponseDto, any, {}>>;
541
331
  /**
542
- * 세금계산서 분할 발급 청구를 기록합니다. 발급 엔진이 아니라 \"분할 발급 청구 요청을 접수\"하는 엔드포인트입니다. **V5 대응:** `splitInvoiceRequest` — BidApi.xml `splitInvoice` 액션의 V6 후속. **호출 시점:** 검수완료 세금계산서를 분할 발급받고자 할 때. 공급가액과 부가세를 나누어 청구합니다. **부수효과:** - 분할 발급 청구가 기록됩니다(실제 세금계산서 발급은 별도 프로세스). - 작성일자(`issueDate`)는 미래 일자 불가(I5 — V5 `PgBidApiService:220-235` 패리티). 오늘 날짜는 허용. - `issueDate` 미지정 시 backend 기본값 적용. **금액 단위:** 원(KRW) 정수. `supplyAmount`(공급가액) + `vat`(부가세) 합산이 실제 청구 총액. **필수 스코프:** `invoices:write` **멱등성:** `Idempotency-Key` 헤더 필수.
543
- * @summary 계산서 분할 발급 청구
544
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
332
+ * V5 `splitInvoiceRequest` 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
333
+ * @summary 계산서 분할 발급 청구 — V5 충실
545
334
  * @param {RequestSplitInvoiceRequestDto} requestSplitInvoiceRequestDto
546
335
  * @param {*} [options] Override http request option.
547
336
  * @throws {RequiredError}
548
337
  */
549
- requestSplitInvoice(idempotencyKey: string, requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SplitInvoiceResponseDto, any, {}>>;
338
+ v1RequestSplitInvoice(requestSplitInvoiceRequestDto: RequestSplitInvoiceRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SplitInvoiceResponseDto, any, {}>>;
550
339
  /**
551
- * 협상에의한계약(낙찰방법 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` 헤더 필수.
552
- * @summary 협상(H/K) 점수평가
553
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환(24시간). UUID v4 권장.
340
+ * V5 `scsbidSend`(type=nego) 후속. 인증 = body `ID`/`Secret`(cate_set). buyerId group_code 자동 결정.
341
+ * @summary 협상(H/K) 점수평가 — V5 충실
554
342
  * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
555
343
  * @param {*} [options] Override http request option.
556
344
  * @throws {RequiredError}
557
345
  */
558
- submitNegotiationScores(idempotencyKey: string, submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<NegotiationScoredResponseDto, any, {}>>;
559
- /**
560
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
561
- * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
562
- * @param {UploadFileRequestDto} uploadFileRequestDto
563
- * @param {*} [options] Override http request option.
564
- * @throws {RequiredError}
565
- */
566
- uploadFile(uploadFileRequestDto: UploadFileRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<FileUploadedResponseDto, any, {}>>;
346
+ v1SubmitNegotiationScores(submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<NegotiationScoredResponseDto, any, {}>>;
567
347
  }