@cmarket/partner-sdk 35.1.0 → 36.1.1

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 (924) hide show
  1. package/README.md +58 -96
  2. package/api/oauth-api.ts +2 -2
  3. package/api/{partner-v2-api.ts → partner-api-api.ts} +437 -259
  4. package/api/products-api.ts +209 -0
  5. package/api/well-known-api.ts +2 -2
  6. package/api.ts +4 -4
  7. package/base.ts +2 -2
  8. package/common.ts +2 -2
  9. package/configuration.ts +2 -2
  10. package/dist/api/oauth-api.d.ts +2 -2
  11. package/dist/api/oauth-api.js +2 -2
  12. package/dist/api/{partner-v2-api.d.ts → partner-api-api.d.ts} +253 -177
  13. package/dist/api/{partner-v2-api.js → partner-api-api.js} +424 -260
  14. package/dist/api/products-api.d.ts +101 -0
  15. package/dist/api/products-api.js +204 -0
  16. package/dist/api/well-known-api.d.ts +2 -2
  17. package/dist/api/well-known-api.js +2 -2
  18. package/dist/api.d.ts +4 -4
  19. package/dist/api.js +4 -4
  20. package/dist/base.d.ts +2 -2
  21. package/dist/base.js +2 -2
  22. package/dist/common.d.ts +2 -2
  23. package/dist/common.js +2 -2
  24. package/dist/configuration.d.ts +2 -2
  25. package/dist/configuration.js +2 -2
  26. package/dist/esm/api/oauth-api.d.ts +2 -2
  27. package/dist/esm/api/oauth-api.js +2 -2
  28. package/dist/esm/api/{partner-v2-api.d.ts → partner-api-api.d.ts} +253 -177
  29. package/dist/esm/api/{partner-v2-api.js → partner-api-api.js} +419 -255
  30. package/dist/esm/api/products-api.d.ts +101 -0
  31. package/dist/esm/api/products-api.js +197 -0
  32. package/dist/esm/api/well-known-api.d.ts +2 -2
  33. package/dist/esm/api/well-known-api.js +2 -2
  34. package/dist/esm/api.d.ts +4 -4
  35. package/dist/esm/api.js +4 -4
  36. package/dist/esm/base.d.ts +2 -2
  37. package/dist/esm/base.js +2 -2
  38. package/dist/esm/common.d.ts +2 -2
  39. package/dist/esm/common.js +2 -2
  40. package/dist/esm/configuration.d.ts +2 -2
  41. package/dist/esm/configuration.js +2 -2
  42. package/dist/esm/index.d.ts +2 -2
  43. package/dist/esm/index.js +2 -2
  44. package/dist/esm/models/acceptance-result-response-dto.d.ts +3 -3
  45. package/dist/esm/models/acceptance-result-response-dto.js +2 -2
  46. package/dist/esm/models/acknowledge-product-receipt200-response.d.ts +21 -0
  47. package/dist/esm/models/acknowledge-product-receipt200-response.js +14 -0
  48. package/dist/esm/models/acknowledge-products-request-dto.d.ts +17 -0
  49. package/dist/esm/models/acknowledge-products-request-dto.js +14 -0
  50. package/dist/esm/models/api-catalog-dto.d.ts +2 -2
  51. package/dist/esm/models/api-catalog-dto.js +2 -2
  52. package/dist/esm/models/api-catalog-entry-dto.d.ts +2 -2
  53. package/dist/esm/models/api-catalog-entry-dto.js +2 -2
  54. package/dist/esm/models/api-catalog-link-dto.d.ts +2 -2
  55. package/dist/esm/models/api-catalog-link-dto.js +2 -2
  56. package/dist/esm/models/authorization-server-metadata-dto.d.ts +2 -2
  57. package/dist/esm/models/authorization-server-metadata-dto.js +2 -2
  58. package/dist/esm/models/award-method-public.d.ts +3 -3
  59. package/dist/esm/models/award-method-public.js +3 -3
  60. package/dist/esm/models/award-registered-v2-response-dto.d.ts +5 -5
  61. package/dist/esm/models/award-registered-v2-response-dto.js +2 -2
  62. package/dist/esm/models/award-reverted-v2-response-dto.d.ts +4 -4
  63. package/dist/esm/models/award-reverted-v2-response-dto.js +2 -2
  64. package/dist/esm/models/bid-acceptance-dto.d.ts +2 -2
  65. package/dist/esm/models/bid-acceptance-dto.js +2 -2
  66. package/dist/esm/models/bid-bond-dto.d.ts +2 -2
  67. package/dist/esm/models/bid-bond-dto.js +2 -2
  68. package/dist/esm/models/bid-cancelled-response-dto.d.ts +4 -4
  69. package/dist/esm/models/bid-cancelled-response-dto.js +2 -2
  70. package/dist/esm/models/bid-contact-dto.d.ts +2 -2
  71. package/dist/esm/models/bid-contact-dto.js +2 -2
  72. package/dist/esm/models/bid-contacts-dto.d.ts +2 -2
  73. package/dist/esm/models/bid-contacts-dto.js +2 -2
  74. package/dist/esm/models/bid-contract-document-dto.d.ts +2 -2
  75. package/dist/esm/models/bid-contract-document-dto.js +2 -2
  76. package/dist/esm/models/bid-delivery-terms-dto.d.ts +6 -4
  77. package/dist/esm/models/bid-delivery-terms-dto.js +2 -2
  78. package/dist/esm/models/bid-detail-response-dto.d.ts +5 -5
  79. package/dist/esm/models/bid-detail-response-dto.js +2 -2
  80. package/dist/esm/models/bid-document-dto.d.ts +2 -2
  81. package/dist/esm/models/bid-document-dto.js +2 -2
  82. package/dist/esm/models/bid-failed-v2-response-dto.d.ts +4 -4
  83. package/dist/esm/models/bid-failed-v2-response-dto.js +2 -2
  84. package/dist/esm/models/bid-item-dto.d.ts +2 -2
  85. package/dist/esm/models/bid-item-dto.js +2 -2
  86. package/dist/esm/models/bid-lifecycle-dto.d.ts +3 -3
  87. package/dist/esm/models/bid-lifecycle-dto.js +2 -2
  88. package/dist/esm/models/bid-manager-dto.d.ts +2 -2
  89. package/dist/esm/models/bid-manager-dto.js +2 -2
  90. package/dist/esm/models/bid-payment-terms-dto.d.ts +4 -3
  91. package/dist/esm/models/bid-payment-terms-dto.js +2 -2
  92. package/dist/esm/models/bid-product-dto.d.ts +2 -2
  93. package/dist/esm/models/bid-product-dto.js +2 -2
  94. package/dist/esm/models/bid-public-status.d.ts +2 -2
  95. package/dist/esm/models/bid-public-status.js +2 -2
  96. package/dist/esm/models/bid-registered-response-dto.d.ts +2 -2
  97. package/dist/esm/models/bid-registered-response-dto.js +2 -2
  98. package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +2 -2
  99. package/dist/esm/models/bid-result-participant-attachment-dto.js +2 -2
  100. package/dist/esm/models/bid-result-participant-dto.d.ts +2 -2
  101. package/dist/esm/models/bid-result-participant-dto.js +2 -2
  102. package/dist/esm/models/bid-results-response-dto.d.ts +3 -3
  103. package/dist/esm/models/bid-results-response-dto.js +2 -2
  104. package/dist/esm/models/bid-settlement-line-item-dto.d.ts +2 -2
  105. package/dist/esm/models/bid-settlement-line-item-dto.js +2 -2
  106. package/dist/esm/models/bid-settlement-participant-dto.d.ts +2 -2
  107. package/dist/esm/models/bid-settlement-participant-dto.js +2 -2
  108. package/dist/esm/models/bid-settlement-response-dto.d.ts +2 -2
  109. package/dist/esm/models/bid-settlement-response-dto.js +2 -2
  110. package/dist/esm/models/bid-statement-response-dto.d.ts +2 -2
  111. package/dist/esm/models/bid-statement-response-dto.js +2 -2
  112. package/dist/esm/models/bid-summary-dto.d.ts +9 -8
  113. package/dist/esm/models/bid-summary-dto.js +2 -2
  114. package/dist/esm/models/bid-type-public.d.ts +19 -0
  115. package/dist/esm/models/bid-type-public.js +20 -0
  116. package/dist/esm/models/bid-updated-response-dto.d.ts +2 -2
  117. package/dist/esm/models/bid-updated-response-dto.js +2 -2
  118. package/dist/esm/models/cancel-bid-request-dto.d.ts +2 -2
  119. package/dist/esm/models/cancel-bid-request-dto.js +2 -2
  120. package/dist/esm/models/cancel-bid200-response.d.ts +2 -2
  121. package/dist/esm/models/cancel-bid200-response.js +2 -2
  122. package/dist/esm/models/card-payment-request-response-dto.d.ts +2 -2
  123. package/dist/esm/models/card-payment-request-response-dto.js +2 -2
  124. package/dist/esm/models/complete-acceptance-request-dto.d.ts +4 -8
  125. package/dist/esm/models/complete-acceptance-request-dto.js +2 -2
  126. package/dist/esm/models/complete-acceptance200-response.d.ts +2 -2
  127. package/dist/esm/models/complete-acceptance200-response.js +2 -2
  128. package/dist/esm/models/complete-invoice200-response.d.ts +2 -2
  129. package/dist/esm/models/complete-invoice200-response.js +2 -2
  130. package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  131. package/dist/esm/models/contract-restriction-confirm-input-dto.js +2 -2
  132. package/dist/esm/models/create-bid-request-dto.d.ts +5 -5
  133. package/dist/esm/models/create-bid-request-dto.js +2 -2
  134. package/dist/esm/models/create-card-payment-dto.d.ts +41 -0
  135. package/dist/esm/models/create-card-payment-dto.js +14 -0
  136. package/dist/esm/models/create-card-payment-request-dto.d.ts +4 -4
  137. package/dist/esm/models/create-card-payment-request-dto.js +2 -2
  138. package/dist/esm/models/create-card-payment200-response.d.ts +21 -0
  139. package/dist/esm/models/create-card-payment200-response.js +14 -0
  140. package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +2 -2
  141. package/dist/esm/models/create-external-contract-documents-request-dto.js +2 -2
  142. package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +2 -2
  143. package/dist/esm/models/create-external-contract-documents-response-dto.js +2 -2
  144. package/dist/esm/models/delivery-date-type-public.d.ts +20 -0
  145. package/dist/esm/models/delivery-date-type-public.js +21 -0
  146. package/dist/esm/models/delivery-method-public.d.ts +20 -0
  147. package/dist/esm/models/delivery-method-public.js +21 -0
  148. package/dist/esm/models/excellent-procurement-public.d.ts +31 -0
  149. package/dist/esm/models/excellent-procurement-public.js +32 -0
  150. package/dist/esm/models/external-contract-document-item-dto.d.ts +2 -2
  151. package/dist/esm/models/external-contract-document-item-dto.js +2 -2
  152. package/dist/esm/models/external-contract-documents-response-dto.d.ts +2 -2
  153. package/dist/esm/models/external-contract-documents-response-dto.js +2 -2
  154. package/dist/esm/models/external-contract-item-dto.d.ts +2 -2
  155. package/dist/esm/models/external-contract-item-dto.js +2 -2
  156. package/dist/esm/models/external-contract-snapshot-dto.d.ts +2 -2
  157. package/dist/esm/models/external-contract-snapshot-dto.js +2 -2
  158. package/dist/esm/models/external-document-inputs-dto.d.ts +2 -2
  159. package/dist/esm/models/external-document-inputs-dto.js +2 -2
  160. package/dist/esm/models/file-meta-response-dto.d.ts +2 -2
  161. package/dist/esm/models/file-meta-response-dto.js +2 -2
  162. package/dist/esm/models/file-uploaded-response-dto.d.ts +3 -3
  163. package/dist/esm/models/file-uploaded-response-dto.js +2 -2
  164. package/dist/esm/models/generated-external-contract-document-dto.d.ts +2 -2
  165. package/dist/esm/models/generated-external-contract-document-dto.js +2 -2
  166. package/dist/esm/models/get-bid-settlement200-response.d.ts +2 -2
  167. package/dist/esm/models/get-bid-settlement200-response.js +2 -2
  168. package/dist/esm/models/get-bid-statement200-response.d.ts +2 -2
  169. package/dist/esm/models/get-bid-statement200-response.js +2 -2
  170. package/dist/esm/models/get-bid200-response.d.ts +2 -2
  171. package/dist/esm/models/get-bid200-response.js +2 -2
  172. package/dist/esm/models/get-file-meta200-response.d.ts +2 -2
  173. package/dist/esm/models/get-file-meta200-response.js +2 -2
  174. package/dist/esm/models/get-supplier-card-payable-v2200-response.d.ts +21 -0
  175. package/dist/esm/models/get-supplier-card-payable-v2200-response.js +14 -0
  176. package/dist/esm/models/green-product-public.d.ts +21 -0
  177. package/dist/esm/models/green-product-public.js +22 -0
  178. package/dist/esm/models/health-controller-check200-response.d.ts +2 -2
  179. package/dist/esm/models/health-controller-check200-response.js +2 -2
  180. package/dist/esm/models/health-response-dto.d.ts +2 -2
  181. package/dist/esm/models/health-response-dto.js +2 -2
  182. package/dist/esm/models/hierarchical-region-dto.d.ts +2 -2
  183. package/dist/esm/models/hierarchical-region-dto.js +2 -2
  184. package/dist/esm/models/index.d.ts +22 -39
  185. package/dist/esm/models/index.js +22 -39
  186. package/dist/esm/models/introspect-request-dto.d.ts +2 -2
  187. package/dist/esm/models/introspect-request-dto.js +2 -2
  188. package/dist/esm/models/introspection-response-dto.d.ts +2 -2
  189. package/dist/esm/models/introspection-response-dto.js +2 -2
  190. package/dist/esm/models/invalid-param-dto.d.ts +3 -3
  191. package/dist/esm/models/invalid-param-dto.js +2 -2
  192. package/dist/esm/models/invoice-completed-response-dto.d.ts +2 -2
  193. package/dist/esm/models/invoice-completed-response-dto.js +2 -2
  194. package/dist/esm/models/invoice-split-response-dto.d.ts +17 -0
  195. package/dist/esm/models/invoice-split-response-dto.js +14 -0
  196. package/dist/esm/models/legal-mandatory-public.d.ts +25 -0
  197. package/dist/esm/models/legal-mandatory-public.js +26 -0
  198. package/dist/esm/models/list-bid-results200-response.d.ts +2 -2
  199. package/dist/esm/models/list-bid-results200-response.js +2 -2
  200. package/dist/esm/models/list-bids-response-dto.d.ts +2 -2
  201. package/dist/esm/models/list-bids-response-dto.js +2 -2
  202. package/dist/esm/models/list-bids200-response.d.ts +2 -2
  203. package/dist/esm/models/list-bids200-response.js +2 -2
  204. package/dist/esm/models/list-products200-response.d.ts +21 -0
  205. package/dist/esm/models/list-products200-response.js +14 -0
  206. package/dist/esm/models/mark-bid-failed-request-dto.d.ts +3 -3
  207. package/dist/esm/models/mark-bid-failed-request-dto.js +2 -2
  208. package/dist/esm/models/mark-bid-failed201-response.d.ts +2 -2
  209. package/dist/esm/models/mark-bid-failed201-response.js +2 -2
  210. package/dist/esm/models/negotiation-score-dto.d.ts +25 -0
  211. package/dist/esm/models/negotiation-score-dto.js +14 -0
  212. package/dist/esm/models/negotiation-scored-v2-response-dto.d.ts +29 -0
  213. package/dist/esm/models/negotiation-scored-v2-response-dto.js +16 -0
  214. package/dist/esm/models/oauth-error-response-dto.d.ts +2 -2
  215. package/dist/esm/models/oauth-error-response-dto.js +2 -2
  216. package/dist/esm/models/payment-method-public.d.ts +19 -0
  217. package/dist/esm/models/payment-method-public.js +20 -0
  218. package/dist/esm/models/preconditions-dto.d.ts +11 -50
  219. package/dist/esm/models/preconditions-dto.js +3 -33
  220. package/dist/esm/models/problem-details-dto.d.ts +3 -3
  221. package/dist/esm/models/problem-details-dto.js +2 -2
  222. package/dist/esm/models/product-receipt-response-dto.d.ts +17 -0
  223. package/dist/esm/models/product-receipt-response-dto.js +14 -0
  224. package/dist/esm/models/product-response-dto.d.ts +77 -0
  225. package/dist/esm/models/product-response-dto.js +14 -0
  226. package/dist/esm/models/protected-resource-metadata-dto.d.ts +2 -2
  227. package/dist/esm/models/protected-resource-metadata-dto.js +2 -2
  228. package/dist/esm/models/register-award-request-dto.d.ts +4 -4
  229. package/dist/esm/models/register-award-request-dto.js +2 -2
  230. package/dist/esm/models/register-award201-response.d.ts +2 -2
  231. package/dist/esm/models/register-award201-response.js +2 -2
  232. package/dist/esm/models/register-bid201-response.d.ts +2 -2
  233. package/dist/esm/models/register-bid201-response.js +2 -2
  234. package/dist/esm/models/register-semo-contract-request-dto.d.ts +2 -2
  235. package/dist/esm/models/register-semo-contract-request-dto.js +2 -2
  236. package/dist/esm/models/request-invoice-split-request-dto.d.ts +25 -0
  237. package/dist/esm/models/request-invoice-split-request-dto.js +14 -0
  238. package/dist/esm/models/request-invoice-split200-response.d.ts +21 -0
  239. package/dist/esm/models/request-invoice-split200-response.js +14 -0
  240. package/dist/esm/models/retiree-roster-input-dto.d.ts +2 -2
  241. package/dist/esm/models/retiree-roster-input-dto.js +2 -2
  242. package/dist/esm/models/retiree-roster-row-dto.d.ts +2 -2
  243. package/dist/esm/models/retiree-roster-row-dto.js +2 -2
  244. package/dist/esm/models/revert-award-request-dto.d.ts +2 -2
  245. package/dist/esm/models/revert-award-request-dto.js +2 -2
  246. package/dist/esm/models/revert-award200-response.d.ts +2 -2
  247. package/dist/esm/models/revert-award200-response.js +2 -2
  248. package/dist/esm/models/revoke-request-dto.d.ts +2 -2
  249. package/dist/esm/models/revoke-request-dto.js +2 -2
  250. package/dist/esm/models/semo-contract-registered-response-dto.d.ts +2 -2
  251. package/dist/esm/models/semo-contract-registered-response-dto.js +2 -2
  252. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
  253. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
  254. package/dist/esm/models/statement-document-dto.d.ts +2 -2
  255. package/dist/esm/models/statement-document-dto.js +2 -2
  256. package/dist/esm/models/statement-product-dto.d.ts +3 -3
  257. package/dist/esm/models/statement-product-dto.js +2 -2
  258. package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +22 -0
  259. package/dist/esm/models/submit-negotiation-scores-request-dto.js +14 -0
  260. package/dist/esm/models/submit-negotiation-scores201-response.d.ts +21 -0
  261. package/dist/esm/models/submit-negotiation-scores201-response.js +14 -0
  262. package/dist/esm/models/supplier-card-payable-response-dto.d.ts +2 -2
  263. package/dist/esm/models/supplier-card-payable-response-dto.js +2 -2
  264. package/dist/esm/models/supplier-tax-type.d.ts +2 -2
  265. package/dist/esm/models/supplier-tax-type.js +2 -2
  266. package/dist/esm/models/token-request-dto.d.ts +2 -2
  267. package/dist/esm/models/token-request-dto.js +2 -2
  268. package/dist/esm/models/token-response-dto.d.ts +2 -2
  269. package/dist/esm/models/token-response-dto.js +2 -2
  270. package/dist/esm/models/update-bid-request-dto.d.ts +7 -7
  271. package/dist/esm/models/update-bid-request-dto.js +2 -2
  272. package/dist/esm/models/update-bid200-response.d.ts +2 -2
  273. package/dist/esm/models/update-bid200-response.js +2 -2
  274. package/dist/esm/models/upload-file-request-dto.d.ts +3 -3
  275. package/dist/esm/models/upload-file-request-dto.js +2 -2
  276. package/dist/esm/models/upload-file201-response.d.ts +2 -2
  277. package/dist/esm/models/upload-file201-response.js +2 -2
  278. package/dist/esm/partner-client.d.ts +2 -2
  279. package/dist/esm/partner-client.js +2 -2
  280. package/dist/index.d.ts +2 -2
  281. package/dist/index.js +2 -2
  282. package/dist/models/acceptance-result-response-dto.d.ts +3 -3
  283. package/dist/models/acceptance-result-response-dto.js +2 -2
  284. package/dist/models/acknowledge-product-receipt200-response.d.ts +21 -0
  285. package/dist/models/acknowledge-product-receipt200-response.js +15 -0
  286. package/dist/models/acknowledge-products-request-dto.d.ts +17 -0
  287. package/dist/models/acknowledge-products-request-dto.js +15 -0
  288. package/dist/models/api-catalog-dto.d.ts +2 -2
  289. package/dist/models/api-catalog-dto.js +2 -2
  290. package/dist/models/api-catalog-entry-dto.d.ts +2 -2
  291. package/dist/models/api-catalog-entry-dto.js +2 -2
  292. package/dist/models/api-catalog-link-dto.d.ts +2 -2
  293. package/dist/models/api-catalog-link-dto.js +2 -2
  294. package/dist/models/authorization-server-metadata-dto.d.ts +2 -2
  295. package/dist/models/authorization-server-metadata-dto.js +2 -2
  296. package/dist/models/award-method-public.d.ts +3 -3
  297. package/dist/models/award-method-public.js +3 -3
  298. package/dist/models/award-registered-v2-response-dto.d.ts +5 -5
  299. package/dist/models/award-registered-v2-response-dto.js +2 -2
  300. package/dist/models/award-reverted-v2-response-dto.d.ts +4 -4
  301. package/dist/models/award-reverted-v2-response-dto.js +2 -2
  302. package/dist/models/bid-acceptance-dto.d.ts +2 -2
  303. package/dist/models/bid-acceptance-dto.js +2 -2
  304. package/dist/models/bid-bond-dto.d.ts +2 -2
  305. package/dist/models/bid-bond-dto.js +2 -2
  306. package/dist/models/bid-cancelled-response-dto.d.ts +4 -4
  307. package/dist/models/bid-cancelled-response-dto.js +2 -2
  308. package/dist/models/bid-contact-dto.d.ts +2 -2
  309. package/dist/models/bid-contact-dto.js +2 -2
  310. package/dist/models/bid-contacts-dto.d.ts +2 -2
  311. package/dist/models/bid-contacts-dto.js +2 -2
  312. package/dist/models/bid-contract-document-dto.d.ts +2 -2
  313. package/dist/models/bid-contract-document-dto.js +2 -2
  314. package/dist/models/bid-delivery-terms-dto.d.ts +6 -4
  315. package/dist/models/bid-delivery-terms-dto.js +2 -2
  316. package/dist/models/bid-detail-response-dto.d.ts +5 -5
  317. package/dist/models/bid-detail-response-dto.js +2 -2
  318. package/dist/models/bid-document-dto.d.ts +2 -2
  319. package/dist/models/bid-document-dto.js +2 -2
  320. package/dist/models/bid-failed-v2-response-dto.d.ts +4 -4
  321. package/dist/models/bid-failed-v2-response-dto.js +2 -2
  322. package/dist/models/bid-item-dto.d.ts +2 -2
  323. package/dist/models/bid-item-dto.js +2 -2
  324. package/dist/models/bid-lifecycle-dto.d.ts +3 -3
  325. package/dist/models/bid-lifecycle-dto.js +2 -2
  326. package/dist/models/bid-manager-dto.d.ts +2 -2
  327. package/dist/models/bid-manager-dto.js +2 -2
  328. package/dist/models/bid-payment-terms-dto.d.ts +4 -3
  329. package/dist/models/bid-payment-terms-dto.js +2 -2
  330. package/dist/models/bid-product-dto.d.ts +2 -2
  331. package/dist/models/bid-product-dto.js +2 -2
  332. package/dist/models/bid-public-status.d.ts +2 -2
  333. package/dist/models/bid-public-status.js +2 -2
  334. package/dist/models/bid-registered-response-dto.d.ts +2 -2
  335. package/dist/models/bid-registered-response-dto.js +2 -2
  336. package/dist/models/bid-result-participant-attachment-dto.d.ts +2 -2
  337. package/dist/models/bid-result-participant-attachment-dto.js +2 -2
  338. package/dist/models/bid-result-participant-dto.d.ts +2 -2
  339. package/dist/models/bid-result-participant-dto.js +2 -2
  340. package/dist/models/bid-results-response-dto.d.ts +3 -3
  341. package/dist/models/bid-results-response-dto.js +2 -2
  342. package/dist/models/bid-settlement-line-item-dto.d.ts +2 -2
  343. package/dist/models/bid-settlement-line-item-dto.js +2 -2
  344. package/dist/models/bid-settlement-participant-dto.d.ts +2 -2
  345. package/dist/models/bid-settlement-participant-dto.js +2 -2
  346. package/dist/models/bid-settlement-response-dto.d.ts +2 -2
  347. package/dist/models/bid-settlement-response-dto.js +2 -2
  348. package/dist/models/bid-statement-response-dto.d.ts +2 -2
  349. package/dist/models/bid-statement-response-dto.js +2 -2
  350. package/dist/models/bid-summary-dto.d.ts +9 -8
  351. package/dist/models/bid-summary-dto.js +2 -2
  352. package/dist/models/bid-type-public.d.ts +19 -0
  353. package/dist/models/bid-type-public.js +23 -0
  354. package/dist/models/bid-updated-response-dto.d.ts +2 -2
  355. package/dist/models/bid-updated-response-dto.js +2 -2
  356. package/dist/models/cancel-bid-request-dto.d.ts +2 -2
  357. package/dist/models/cancel-bid-request-dto.js +2 -2
  358. package/dist/models/cancel-bid200-response.d.ts +2 -2
  359. package/dist/models/cancel-bid200-response.js +2 -2
  360. package/dist/models/card-payment-request-response-dto.d.ts +2 -2
  361. package/dist/models/card-payment-request-response-dto.js +2 -2
  362. package/dist/models/complete-acceptance-request-dto.d.ts +4 -8
  363. package/dist/models/complete-acceptance-request-dto.js +2 -2
  364. package/dist/models/complete-acceptance200-response.d.ts +2 -2
  365. package/dist/models/complete-acceptance200-response.js +2 -2
  366. package/dist/models/complete-invoice200-response.d.ts +2 -2
  367. package/dist/models/complete-invoice200-response.js +2 -2
  368. package/dist/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  369. package/dist/models/contract-restriction-confirm-input-dto.js +2 -2
  370. package/dist/models/create-bid-request-dto.d.ts +5 -5
  371. package/dist/models/create-bid-request-dto.js +2 -2
  372. package/dist/models/create-card-payment-dto.d.ts +41 -0
  373. package/dist/models/create-card-payment-dto.js +15 -0
  374. package/dist/models/create-card-payment-request-dto.d.ts +4 -4
  375. package/dist/models/create-card-payment-request-dto.js +2 -2
  376. package/dist/models/create-card-payment200-response.d.ts +21 -0
  377. package/dist/models/create-card-payment200-response.js +15 -0
  378. package/dist/models/create-external-contract-documents-request-dto.d.ts +2 -2
  379. package/dist/models/create-external-contract-documents-request-dto.js +2 -2
  380. package/dist/models/create-external-contract-documents-response-dto.d.ts +2 -2
  381. package/dist/models/create-external-contract-documents-response-dto.js +2 -2
  382. package/dist/models/delivery-date-type-public.d.ts +20 -0
  383. package/dist/models/delivery-date-type-public.js +24 -0
  384. package/dist/models/delivery-method-public.d.ts +20 -0
  385. package/dist/models/delivery-method-public.js +24 -0
  386. package/dist/models/excellent-procurement-public.d.ts +31 -0
  387. package/dist/models/excellent-procurement-public.js +35 -0
  388. package/dist/models/external-contract-document-item-dto.d.ts +2 -2
  389. package/dist/models/external-contract-document-item-dto.js +2 -2
  390. package/dist/models/external-contract-documents-response-dto.d.ts +2 -2
  391. package/dist/models/external-contract-documents-response-dto.js +2 -2
  392. package/dist/models/external-contract-item-dto.d.ts +2 -2
  393. package/dist/models/external-contract-item-dto.js +2 -2
  394. package/dist/models/external-contract-snapshot-dto.d.ts +2 -2
  395. package/dist/models/external-contract-snapshot-dto.js +2 -2
  396. package/dist/models/external-document-inputs-dto.d.ts +2 -2
  397. package/dist/models/external-document-inputs-dto.js +2 -2
  398. package/dist/models/file-meta-response-dto.d.ts +2 -2
  399. package/dist/models/file-meta-response-dto.js +2 -2
  400. package/dist/models/file-uploaded-response-dto.d.ts +3 -3
  401. package/dist/models/file-uploaded-response-dto.js +2 -2
  402. package/dist/models/generated-external-contract-document-dto.d.ts +2 -2
  403. package/dist/models/generated-external-contract-document-dto.js +2 -2
  404. package/dist/models/get-bid-settlement200-response.d.ts +2 -2
  405. package/dist/models/get-bid-settlement200-response.js +2 -2
  406. package/dist/models/get-bid-statement200-response.d.ts +2 -2
  407. package/dist/models/get-bid-statement200-response.js +2 -2
  408. package/dist/models/get-bid200-response.d.ts +2 -2
  409. package/dist/models/get-bid200-response.js +2 -2
  410. package/dist/models/get-file-meta200-response.d.ts +2 -2
  411. package/dist/models/get-file-meta200-response.js +2 -2
  412. package/dist/models/get-supplier-card-payable-v2200-response.d.ts +21 -0
  413. package/dist/models/get-supplier-card-payable-v2200-response.js +15 -0
  414. package/dist/models/green-product-public.d.ts +21 -0
  415. package/dist/models/green-product-public.js +25 -0
  416. package/dist/models/health-controller-check200-response.d.ts +2 -2
  417. package/dist/models/health-controller-check200-response.js +2 -2
  418. package/dist/models/health-response-dto.d.ts +2 -2
  419. package/dist/models/health-response-dto.js +2 -2
  420. package/dist/models/hierarchical-region-dto.d.ts +2 -2
  421. package/dist/models/hierarchical-region-dto.js +2 -2
  422. package/dist/models/index.d.ts +22 -39
  423. package/dist/models/index.js +22 -39
  424. package/dist/models/introspect-request-dto.d.ts +2 -2
  425. package/dist/models/introspect-request-dto.js +2 -2
  426. package/dist/models/introspection-response-dto.d.ts +2 -2
  427. package/dist/models/introspection-response-dto.js +2 -2
  428. package/dist/models/invalid-param-dto.d.ts +3 -3
  429. package/dist/models/invalid-param-dto.js +2 -2
  430. package/dist/models/invoice-completed-response-dto.d.ts +2 -2
  431. package/dist/models/invoice-completed-response-dto.js +2 -2
  432. package/dist/models/invoice-split-response-dto.d.ts +17 -0
  433. package/dist/models/invoice-split-response-dto.js +15 -0
  434. package/dist/models/legal-mandatory-public.d.ts +25 -0
  435. package/dist/models/legal-mandatory-public.js +29 -0
  436. package/dist/models/list-bid-results200-response.d.ts +2 -2
  437. package/dist/models/list-bid-results200-response.js +2 -2
  438. package/dist/models/list-bids-response-dto.d.ts +2 -2
  439. package/dist/models/list-bids-response-dto.js +2 -2
  440. package/dist/models/list-bids200-response.d.ts +2 -2
  441. package/dist/models/list-bids200-response.js +2 -2
  442. package/dist/models/list-products200-response.d.ts +21 -0
  443. package/dist/models/list-products200-response.js +15 -0
  444. package/dist/models/mark-bid-failed-request-dto.d.ts +3 -3
  445. package/dist/models/mark-bid-failed-request-dto.js +2 -2
  446. package/dist/models/mark-bid-failed201-response.d.ts +2 -2
  447. package/dist/models/mark-bid-failed201-response.js +2 -2
  448. package/dist/models/negotiation-score-dto.d.ts +25 -0
  449. package/dist/models/negotiation-score-dto.js +15 -0
  450. package/dist/models/negotiation-scored-v2-response-dto.d.ts +29 -0
  451. package/dist/models/negotiation-scored-v2-response-dto.js +19 -0
  452. package/dist/models/oauth-error-response-dto.d.ts +2 -2
  453. package/dist/models/oauth-error-response-dto.js +2 -2
  454. package/dist/models/payment-method-public.d.ts +19 -0
  455. package/dist/models/payment-method-public.js +23 -0
  456. package/dist/models/preconditions-dto.d.ts +11 -50
  457. package/dist/models/preconditions-dto.js +2 -34
  458. package/dist/models/problem-details-dto.d.ts +3 -3
  459. package/dist/models/problem-details-dto.js +2 -2
  460. package/dist/models/product-receipt-response-dto.d.ts +17 -0
  461. package/dist/models/product-receipt-response-dto.js +15 -0
  462. package/dist/models/product-response-dto.d.ts +77 -0
  463. package/dist/models/product-response-dto.js +15 -0
  464. package/dist/models/protected-resource-metadata-dto.d.ts +2 -2
  465. package/dist/models/protected-resource-metadata-dto.js +2 -2
  466. package/dist/models/register-award-request-dto.d.ts +4 -4
  467. package/dist/models/register-award-request-dto.js +2 -2
  468. package/dist/models/register-award201-response.d.ts +2 -2
  469. package/dist/models/register-award201-response.js +2 -2
  470. package/dist/models/register-bid201-response.d.ts +2 -2
  471. package/dist/models/register-bid201-response.js +2 -2
  472. package/dist/models/register-semo-contract-request-dto.d.ts +2 -2
  473. package/dist/models/register-semo-contract-request-dto.js +2 -2
  474. package/dist/models/request-invoice-split-request-dto.d.ts +25 -0
  475. package/dist/models/request-invoice-split-request-dto.js +15 -0
  476. package/dist/models/request-invoice-split200-response.d.ts +21 -0
  477. package/dist/models/request-invoice-split200-response.js +15 -0
  478. package/dist/models/retiree-roster-input-dto.d.ts +2 -2
  479. package/dist/models/retiree-roster-input-dto.js +2 -2
  480. package/dist/models/retiree-roster-row-dto.d.ts +2 -2
  481. package/dist/models/retiree-roster-row-dto.js +2 -2
  482. package/dist/models/revert-award-request-dto.d.ts +2 -2
  483. package/dist/models/revert-award-request-dto.js +2 -2
  484. package/dist/models/revert-award200-response.d.ts +2 -2
  485. package/dist/models/revert-award200-response.js +2 -2
  486. package/dist/models/revoke-request-dto.d.ts +2 -2
  487. package/dist/models/revoke-request-dto.js +2 -2
  488. package/dist/models/semo-contract-registered-response-dto.d.ts +2 -2
  489. package/dist/models/semo-contract-registered-response-dto.js +2 -2
  490. package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
  491. package/dist/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
  492. package/dist/models/statement-document-dto.d.ts +2 -2
  493. package/dist/models/statement-document-dto.js +2 -2
  494. package/dist/models/statement-product-dto.d.ts +3 -3
  495. package/dist/models/statement-product-dto.js +2 -2
  496. package/dist/models/submit-negotiation-scores-request-dto.d.ts +22 -0
  497. package/dist/models/submit-negotiation-scores-request-dto.js +15 -0
  498. package/dist/models/submit-negotiation-scores201-response.d.ts +21 -0
  499. package/dist/models/submit-negotiation-scores201-response.js +15 -0
  500. package/dist/models/supplier-card-payable-response-dto.d.ts +2 -2
  501. package/dist/models/supplier-card-payable-response-dto.js +2 -2
  502. package/dist/models/supplier-tax-type.d.ts +2 -2
  503. package/dist/models/supplier-tax-type.js +2 -2
  504. package/dist/models/token-request-dto.d.ts +2 -2
  505. package/dist/models/token-request-dto.js +2 -2
  506. package/dist/models/token-response-dto.d.ts +2 -2
  507. package/dist/models/token-response-dto.js +2 -2
  508. package/dist/models/update-bid-request-dto.d.ts +7 -7
  509. package/dist/models/update-bid-request-dto.js +2 -2
  510. package/dist/models/update-bid200-response.d.ts +2 -2
  511. package/dist/models/update-bid200-response.js +2 -2
  512. package/dist/models/upload-file-request-dto.d.ts +3 -3
  513. package/dist/models/upload-file-request-dto.js +2 -2
  514. package/dist/models/upload-file201-response.d.ts +2 -2
  515. package/dist/models/upload-file201-response.js +2 -2
  516. package/dist/partner-client.d.ts +2 -2
  517. package/dist/partner-client.js +1 -1
  518. package/docs/AcceptanceResultResponseDto.md +1 -1
  519. package/docs/AcknowledgeProductReceipt200Response.md +22 -0
  520. package/docs/AcknowledgeProductsRequestDto.md +20 -0
  521. package/docs/AwardMethodPublic.md +1 -1
  522. package/docs/AwardRegisteredV2ResponseDto.md +3 -3
  523. package/docs/AwardRevertedV2ResponseDto.md +2 -2
  524. package/docs/BidCancelledResponseDto.md +2 -2
  525. package/docs/BidDeliveryTermsDto.md +2 -2
  526. package/docs/BidDetailResponseDto.md +3 -3
  527. package/docs/BidFailedV2ResponseDto.md +2 -2
  528. package/docs/BidLifecycleDto.md +1 -1
  529. package/docs/BidPaymentTermsDto.md +1 -1
  530. package/docs/BidResultsResponseDto.md +1 -1
  531. package/docs/BidSummaryDto.md +6 -6
  532. package/docs/BidTypePublic.md +11 -0
  533. package/docs/CompleteAcceptanceRequestDto.md +2 -4
  534. package/docs/CreateBidRequestDto.md +6 -6
  535. package/docs/CreateCardPayment200Response.md +22 -0
  536. package/docs/CreateCardPaymentDto.md +32 -0
  537. package/docs/CreateCardPaymentRequestDto.md +2 -2
  538. package/docs/DeliveryDateTypePublic.md +13 -0
  539. package/docs/DeliveryMethodPublic.md +13 -0
  540. package/docs/ExcellentProcurementPublic.md +35 -0
  541. package/docs/FileUploadedResponseDto.md +1 -1
  542. package/docs/GetSupplierCardPayableV2200Response.md +22 -0
  543. package/docs/GreenProductPublic.md +15 -0
  544. package/docs/InvalidParamDto.md +1 -1
  545. package/docs/{AcceptanceResultV1ResponseDto.md → InvoiceSplitResponseDto.md} +4 -4
  546. package/docs/LegalMandatoryPublic.md +23 -0
  547. package/docs/ListProducts200Response.md +22 -0
  548. package/docs/MarkBidFailedRequestDto.md +1 -1
  549. package/docs/NegotiationScoreDto.md +24 -0
  550. package/docs/NegotiationScoredV2ResponseDto.md +24 -0
  551. package/docs/{PartnerV2Api.md → PartnerApiApi.md} +355 -212
  552. package/docs/PaymentMethodPublic.md +11 -0
  553. package/docs/PreconditionsDto.md +3 -7
  554. package/docs/ProblemDetailsDto.md +1 -1
  555. package/docs/ProductReceiptResponseDto.md +20 -0
  556. package/docs/ProductResponseDto.md +50 -0
  557. package/docs/ProductsApi.md +124 -0
  558. package/docs/RegisterAwardRequestDto.md +2 -2
  559. package/docs/RequestInvoiceSplit200Response.md +22 -0
  560. package/docs/RequestInvoiceSplitRequestDto.md +24 -0
  561. package/docs/StatementProductDto.md +2 -2
  562. package/docs/SubmitNegotiationScores201Response.md +22 -0
  563. package/docs/SubmitNegotiationScoresRequestDto.md +22 -0
  564. package/docs/UpdateBidRequestDto.md +10 -10
  565. package/docs/UploadFileRequestDto.md +1 -1
  566. package/index.ts +2 -2
  567. package/models/acceptance-result-response-dto.ts +3 -3
  568. package/models/acknowledge-product-receipt200-response.ts +27 -0
  569. package/models/acknowledge-products-request-dto.ts +23 -0
  570. package/models/api-catalog-dto.ts +2 -2
  571. package/models/api-catalog-entry-dto.ts +2 -2
  572. package/models/api-catalog-link-dto.ts +2 -2
  573. package/models/authorization-server-metadata-dto.ts +2 -2
  574. package/models/award-method-public.ts +3 -3
  575. package/models/award-registered-v2-response-dto.ts +5 -5
  576. package/models/award-reverted-v2-response-dto.ts +4 -4
  577. package/models/bid-acceptance-dto.ts +2 -2
  578. package/models/bid-bond-dto.ts +2 -2
  579. package/models/bid-cancelled-response-dto.ts +4 -4
  580. package/models/bid-contact-dto.ts +2 -2
  581. package/models/bid-contacts-dto.ts +2 -2
  582. package/models/bid-contract-document-dto.ts +2 -2
  583. package/models/bid-delivery-terms-dto.ts +12 -4
  584. package/models/bid-detail-response-dto.ts +5 -5
  585. package/models/bid-document-dto.ts +2 -2
  586. package/models/bid-failed-v2-response-dto.ts +4 -4
  587. package/models/bid-item-dto.ts +2 -2
  588. package/models/bid-lifecycle-dto.ts +3 -3
  589. package/models/bid-manager-dto.ts +2 -2
  590. package/models/bid-payment-terms-dto.ts +8 -3
  591. package/models/bid-product-dto.ts +2 -2
  592. package/models/bid-public-status.ts +2 -2
  593. package/models/bid-registered-response-dto.ts +2 -2
  594. package/models/bid-result-participant-attachment-dto.ts +2 -2
  595. package/models/bid-result-participant-dto.ts +2 -2
  596. package/models/bid-results-response-dto.ts +3 -3
  597. package/models/bid-settlement-line-item-dto.ts +2 -2
  598. package/models/bid-settlement-participant-dto.ts +2 -2
  599. package/models/bid-settlement-response-dto.ts +2 -2
  600. package/models/bid-statement-response-dto.ts +2 -2
  601. package/models/bid-summary-dto.ts +11 -8
  602. package/models/bid-type-public.ts +29 -0
  603. package/models/bid-updated-response-dto.ts +2 -2
  604. package/models/cancel-bid-request-dto.ts +2 -2
  605. package/models/cancel-bid200-response.ts +2 -2
  606. package/models/card-payment-request-response-dto.ts +2 -2
  607. package/models/complete-acceptance-request-dto.ts +4 -8
  608. package/models/complete-acceptance200-response.ts +2 -2
  609. package/models/complete-invoice200-response.ts +2 -2
  610. package/models/contract-restriction-confirm-input-dto.ts +2 -2
  611. package/models/create-bid-request-dto.ts +5 -5
  612. package/models/create-card-payment-dto.ts +47 -0
  613. package/models/create-card-payment-request-dto.ts +4 -4
  614. package/models/create-card-payment200-response.ts +27 -0
  615. package/models/create-external-contract-documents-request-dto.ts +2 -2
  616. package/models/create-external-contract-documents-response-dto.ts +2 -2
  617. package/models/delivery-date-type-public.ts +30 -0
  618. package/models/delivery-method-public.ts +30 -0
  619. package/models/excellent-procurement-public.ts +41 -0
  620. package/models/external-contract-document-item-dto.ts +2 -2
  621. package/models/external-contract-documents-response-dto.ts +2 -2
  622. package/models/external-contract-item-dto.ts +2 -2
  623. package/models/external-contract-snapshot-dto.ts +2 -2
  624. package/models/external-document-inputs-dto.ts +2 -2
  625. package/models/file-meta-response-dto.ts +2 -2
  626. package/models/file-uploaded-response-dto.ts +3 -3
  627. package/models/generated-external-contract-document-dto.ts +2 -2
  628. package/models/get-bid-settlement200-response.ts +2 -2
  629. package/models/get-bid-statement200-response.ts +2 -2
  630. package/models/get-bid200-response.ts +2 -2
  631. package/models/get-file-meta200-response.ts +2 -2
  632. package/models/get-supplier-card-payable-v2200-response.ts +27 -0
  633. package/models/green-product-public.ts +31 -0
  634. package/models/health-controller-check200-response.ts +2 -2
  635. package/models/health-response-dto.ts +2 -2
  636. package/models/hierarchical-region-dto.ts +2 -2
  637. package/models/index.ts +22 -39
  638. package/models/introspect-request-dto.ts +2 -2
  639. package/models/introspection-response-dto.ts +2 -2
  640. package/models/invalid-param-dto.ts +3 -3
  641. package/models/invoice-completed-response-dto.ts +2 -2
  642. package/models/invoice-split-response-dto.ts +23 -0
  643. package/models/legal-mandatory-public.ts +35 -0
  644. package/models/list-bid-results200-response.ts +2 -2
  645. package/models/list-bids-response-dto.ts +2 -2
  646. package/models/list-bids200-response.ts +2 -2
  647. package/models/list-products200-response.ts +27 -0
  648. package/models/mark-bid-failed-request-dto.ts +3 -3
  649. package/models/mark-bid-failed201-response.ts +2 -2
  650. package/models/negotiation-score-dto.ts +31 -0
  651. package/models/negotiation-scored-v2-response-dto.ts +38 -0
  652. package/models/oauth-error-response-dto.ts +2 -2
  653. package/models/payment-method-public.ts +29 -0
  654. package/models/preconditions-dto.ts +17 -55
  655. package/models/problem-details-dto.ts +3 -3
  656. package/models/product-receipt-response-dto.ts +23 -0
  657. package/models/product-response-dto.ts +83 -0
  658. package/models/protected-resource-metadata-dto.ts +2 -2
  659. package/models/register-award-request-dto.ts +4 -4
  660. package/models/register-award201-response.ts +2 -2
  661. package/models/register-bid201-response.ts +2 -2
  662. package/models/register-semo-contract-request-dto.ts +2 -2
  663. package/models/request-invoice-split-request-dto.ts +31 -0
  664. package/models/request-invoice-split200-response.ts +27 -0
  665. package/models/retiree-roster-input-dto.ts +2 -2
  666. package/models/retiree-roster-row-dto.ts +2 -2
  667. package/models/revert-award-request-dto.ts +2 -2
  668. package/models/revert-award200-response.ts +2 -2
  669. package/models/revoke-request-dto.ts +2 -2
  670. package/models/semo-contract-registered-response-dto.ts +2 -2
  671. package/models/semo-contract-taxinvoice-status-response-dto.ts +2 -2
  672. package/models/statement-document-dto.ts +2 -2
  673. package/models/statement-product-dto.ts +3 -3
  674. package/models/submit-negotiation-scores-request-dto.ts +30 -0
  675. package/models/submit-negotiation-scores201-response.ts +27 -0
  676. package/models/supplier-card-payable-response-dto.ts +2 -2
  677. package/models/supplier-tax-type.ts +2 -2
  678. package/models/token-request-dto.ts +2 -2
  679. package/models/token-response-dto.ts +2 -2
  680. package/models/update-bid-request-dto.ts +7 -7
  681. package/models/update-bid200-response.ts +2 -2
  682. package/models/upload-file-request-dto.ts +3 -3
  683. package/models/upload-file201-response.ts +2 -2
  684. package/package.json +1 -1
  685. package/partner-client.ts +3 -3
  686. package/api/partner-v1-api.ts +0 -998
  687. package/dist/api/partner-v1-api.d.ts +0 -440
  688. package/dist/api/partner-v1-api.js +0 -913
  689. package/dist/esm/api/partner-v1-api.d.ts +0 -440
  690. package/dist/esm/api/partner-v1-api.js +0 -906
  691. package/dist/esm/models/acceptance-result-v1-response-dto.d.ts +0 -17
  692. package/dist/esm/models/acceptance-result-v1-response-dto.js +0 -14
  693. package/dist/esm/models/acknowledge-products-v1-request-dto.d.ts +0 -17
  694. package/dist/esm/models/acknowledge-products-v1-request-dto.js +0 -14
  695. package/dist/esm/models/award-registered-response-dto.d.ts +0 -17
  696. package/dist/esm/models/award-registered-response-dto.js +0 -14
  697. package/dist/esm/models/bid-attachment-v1-dto.d.ts +0 -21
  698. package/dist/esm/models/bid-attachment-v1-dto.js +0 -14
  699. package/dist/esm/models/bid-bond-v1-dto.d.ts +0 -27
  700. package/dist/esm/models/bid-bond-v1-dto.js +0 -18
  701. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.d.ts +0 -17
  702. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.js +0 -14
  703. package/dist/esm/models/bid-contract-documents-v1-response-dto.d.ts +0 -30
  704. package/dist/esm/models/bid-contract-documents-v1-response-dto.js +0 -14
  705. package/dist/esm/models/bid-created-response-dto.d.ts +0 -21
  706. package/dist/esm/models/bid-created-response-dto.js +0 -14
  707. package/dist/esm/models/bid-document-v1-dto.d.ts +0 -25
  708. package/dist/esm/models/bid-document-v1-dto.js +0 -14
  709. package/dist/esm/models/bid-failed-response-dto.d.ts +0 -17
  710. package/dist/esm/models/bid-failed-response-dto.js +0 -14
  711. package/dist/esm/models/bid-failure-reason.d.ts +0 -25
  712. package/dist/esm/models/bid-failure-reason.js +0 -26
  713. package/dist/esm/models/bid-item-v1-dto.d.ts +0 -41
  714. package/dist/esm/models/bid-item-v1-dto.js +0 -14
  715. package/dist/esm/models/bid-manager-v1-dto.d.ts +0 -33
  716. package/dist/esm/models/bid-manager-v1-dto.js +0 -14
  717. package/dist/esm/models/bid-result-v1-attachment-dto.d.ts +0 -33
  718. package/dist/esm/models/bid-result-v1-attachment-dto.js +0 -14
  719. package/dist/esm/models/bid-result-v1-bid-product-info-dto.d.ts +0 -45
  720. package/dist/esm/models/bid-result-v1-bid-product-info-dto.js +0 -14
  721. package/dist/esm/models/bid-result-v1-participant-dto.d.ts +0 -183
  722. package/dist/esm/models/bid-result-v1-participant-dto.js +0 -14
  723. package/dist/esm/models/bid-result-v1-product-dto.d.ts +0 -53
  724. package/dist/esm/models/bid-result-v1-product-dto.js +0 -14
  725. package/dist/esm/models/bid-results-batch-v1-request-dto.d.ts +0 -25
  726. package/dist/esm/models/bid-results-batch-v1-request-dto.js +0 -14
  727. package/dist/esm/models/bid-results-v1-response-dto.d.ts +0 -164
  728. package/dist/esm/models/bid-results-v1-response-dto.js +0 -14
  729. package/dist/esm/models/bid-statement-v1-response-dto.d.ts +0 -31
  730. package/dist/esm/models/bid-statement-v1-response-dto.js +0 -14
  731. package/dist/esm/models/bid-status.d.ts +0 -23
  732. package/dist/esm/models/bid-status.js +0 -24
  733. package/dist/esm/models/complete-acceptance-v1-request-dto.d.ts +0 -65
  734. package/dist/esm/models/complete-acceptance-v1-request-dto.js +0 -14
  735. package/dist/esm/models/contract-document-item-dto.d.ts +0 -45
  736. package/dist/esm/models/contract-document-item-dto.js +0 -14
  737. package/dist/esm/models/create-bid-v1-request-dto.d.ts +0 -331
  738. package/dist/esm/models/create-bid-v1-request-dto.js +0 -113
  739. package/dist/esm/models/file-uploaded-v1-response-dto.d.ts +0 -17
  740. package/dist/esm/models/file-uploaded-v1-response-dto.js +0 -14
  741. package/dist/esm/models/hierarchical-region-v1-dto.d.ts +0 -21
  742. package/dist/esm/models/hierarchical-region-v1-dto.js +0 -14
  743. package/dist/esm/models/mark-bid-failed-v1-request-dto.d.ts +0 -26
  744. package/dist/esm/models/mark-bid-failed-v1-request-dto.js +0 -14
  745. package/dist/esm/models/negotiation-score-v1-dto.d.ts +0 -25
  746. package/dist/esm/models/negotiation-score-v1-dto.js +0 -14
  747. package/dist/esm/models/negotiation-scored-response-dto.d.ts +0 -17
  748. package/dist/esm/models/negotiation-scored-response-dto.js +0 -14
  749. package/dist/esm/models/preconditions-v1-dto.d.ts +0 -88
  750. package/dist/esm/models/preconditions-v1-dto.js +0 -44
  751. package/dist/esm/models/product-receipt-v1-response-dto.d.ts +0 -17
  752. package/dist/esm/models/product-receipt-v1-response-dto.js +0 -14
  753. package/dist/esm/models/product-v1-response-dto.d.ts +0 -105
  754. package/dist/esm/models/product-v1-response-dto.js +0 -14
  755. package/dist/esm/models/register-award-v1-request-dto.d.ts +0 -33
  756. package/dist/esm/models/register-award-v1-request-dto.js +0 -14
  757. package/dist/esm/models/request-split-invoice-v1-request-dto.d.ts +0 -29
  758. package/dist/esm/models/request-split-invoice-v1-request-dto.js +0 -14
  759. package/dist/esm/models/split-invoice-v1-response-dto.d.ts +0 -17
  760. package/dist/esm/models/split-invoice-v1-response-dto.js +0 -14
  761. package/dist/esm/models/statement-v1-document-dto.d.ts +0 -33
  762. package/dist/esm/models/statement-v1-document-dto.js +0 -14
  763. package/dist/esm/models/statement-v1-product-dto.d.ts +0 -49
  764. package/dist/esm/models/statement-v1-product-dto.js +0 -14
  765. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +0 -22
  766. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +0 -14
  767. package/dist/esm/models/upload-file-v1-request-dto.d.ts +0 -25
  768. package/dist/esm/models/upload-file-v1-request-dto.js +0 -14
  769. package/dist/models/acceptance-result-v1-response-dto.d.ts +0 -17
  770. package/dist/models/acceptance-result-v1-response-dto.js +0 -15
  771. package/dist/models/acknowledge-products-v1-request-dto.d.ts +0 -17
  772. package/dist/models/acknowledge-products-v1-request-dto.js +0 -15
  773. package/dist/models/award-registered-response-dto.d.ts +0 -17
  774. package/dist/models/award-registered-response-dto.js +0 -15
  775. package/dist/models/bid-attachment-v1-dto.d.ts +0 -21
  776. package/dist/models/bid-attachment-v1-dto.js +0 -15
  777. package/dist/models/bid-bond-v1-dto.d.ts +0 -27
  778. package/dist/models/bid-bond-v1-dto.js +0 -21
  779. package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +0 -17
  780. package/dist/models/bid-contract-documents-batch-v1-request-dto.js +0 -15
  781. package/dist/models/bid-contract-documents-v1-response-dto.d.ts +0 -30
  782. package/dist/models/bid-contract-documents-v1-response-dto.js +0 -15
  783. package/dist/models/bid-created-response-dto.d.ts +0 -21
  784. package/dist/models/bid-created-response-dto.js +0 -15
  785. package/dist/models/bid-document-v1-dto.d.ts +0 -25
  786. package/dist/models/bid-document-v1-dto.js +0 -15
  787. package/dist/models/bid-failed-response-dto.d.ts +0 -17
  788. package/dist/models/bid-failed-response-dto.js +0 -15
  789. package/dist/models/bid-failure-reason.d.ts +0 -25
  790. package/dist/models/bid-failure-reason.js +0 -29
  791. package/dist/models/bid-item-v1-dto.d.ts +0 -41
  792. package/dist/models/bid-item-v1-dto.js +0 -15
  793. package/dist/models/bid-manager-v1-dto.d.ts +0 -33
  794. package/dist/models/bid-manager-v1-dto.js +0 -15
  795. package/dist/models/bid-result-v1-attachment-dto.d.ts +0 -33
  796. package/dist/models/bid-result-v1-attachment-dto.js +0 -15
  797. package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +0 -45
  798. package/dist/models/bid-result-v1-bid-product-info-dto.js +0 -15
  799. package/dist/models/bid-result-v1-participant-dto.d.ts +0 -183
  800. package/dist/models/bid-result-v1-participant-dto.js +0 -15
  801. package/dist/models/bid-result-v1-product-dto.d.ts +0 -53
  802. package/dist/models/bid-result-v1-product-dto.js +0 -15
  803. package/dist/models/bid-results-batch-v1-request-dto.d.ts +0 -25
  804. package/dist/models/bid-results-batch-v1-request-dto.js +0 -15
  805. package/dist/models/bid-results-v1-response-dto.d.ts +0 -164
  806. package/dist/models/bid-results-v1-response-dto.js +0 -15
  807. package/dist/models/bid-statement-v1-response-dto.d.ts +0 -31
  808. package/dist/models/bid-statement-v1-response-dto.js +0 -15
  809. package/dist/models/bid-status.d.ts +0 -23
  810. package/dist/models/bid-status.js +0 -27
  811. package/dist/models/complete-acceptance-v1-request-dto.d.ts +0 -65
  812. package/dist/models/complete-acceptance-v1-request-dto.js +0 -15
  813. package/dist/models/contract-document-item-dto.d.ts +0 -45
  814. package/dist/models/contract-document-item-dto.js +0 -15
  815. package/dist/models/create-bid-v1-request-dto.d.ts +0 -331
  816. package/dist/models/create-bid-v1-request-dto.js +0 -116
  817. package/dist/models/file-uploaded-v1-response-dto.d.ts +0 -17
  818. package/dist/models/file-uploaded-v1-response-dto.js +0 -15
  819. package/dist/models/hierarchical-region-v1-dto.d.ts +0 -21
  820. package/dist/models/hierarchical-region-v1-dto.js +0 -15
  821. package/dist/models/mark-bid-failed-v1-request-dto.d.ts +0 -26
  822. package/dist/models/mark-bid-failed-v1-request-dto.js +0 -15
  823. package/dist/models/negotiation-score-v1-dto.d.ts +0 -25
  824. package/dist/models/negotiation-score-v1-dto.js +0 -15
  825. package/dist/models/negotiation-scored-response-dto.d.ts +0 -17
  826. package/dist/models/negotiation-scored-response-dto.js +0 -15
  827. package/dist/models/preconditions-v1-dto.d.ts +0 -88
  828. package/dist/models/preconditions-v1-dto.js +0 -47
  829. package/dist/models/product-receipt-v1-response-dto.d.ts +0 -17
  830. package/dist/models/product-receipt-v1-response-dto.js +0 -15
  831. package/dist/models/product-v1-response-dto.d.ts +0 -105
  832. package/dist/models/product-v1-response-dto.js +0 -15
  833. package/dist/models/register-award-v1-request-dto.d.ts +0 -33
  834. package/dist/models/register-award-v1-request-dto.js +0 -15
  835. package/dist/models/request-split-invoice-v1-request-dto.d.ts +0 -29
  836. package/dist/models/request-split-invoice-v1-request-dto.js +0 -15
  837. package/dist/models/split-invoice-v1-response-dto.d.ts +0 -17
  838. package/dist/models/split-invoice-v1-response-dto.js +0 -15
  839. package/dist/models/statement-v1-document-dto.d.ts +0 -33
  840. package/dist/models/statement-v1-document-dto.js +0 -15
  841. package/dist/models/statement-v1-product-dto.d.ts +0 -49
  842. package/dist/models/statement-v1-product-dto.js +0 -15
  843. package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +0 -22
  844. package/dist/models/submit-negotiation-scores-v1-request-dto.js +0 -15
  845. package/dist/models/upload-file-v1-request-dto.d.ts +0 -25
  846. package/dist/models/upload-file-v1-request-dto.js +0 -15
  847. package/docs/AcknowledgeProductsV1RequestDto.md +0 -20
  848. package/docs/AwardRegisteredResponseDto.md +0 -20
  849. package/docs/BidAttachmentV1Dto.md +0 -22
  850. package/docs/BidBondV1Dto.md +0 -22
  851. package/docs/BidContractDocumentsBatchV1RequestDto.md +0 -20
  852. package/docs/BidContractDocumentsV1ResponseDto.md +0 -26
  853. package/docs/BidCreatedResponseDto.md +0 -22
  854. package/docs/BidDocumentV1Dto.md +0 -24
  855. package/docs/BidFailedResponseDto.md +0 -20
  856. package/docs/BidFailureReason.md +0 -23
  857. package/docs/BidItemV1Dto.md +0 -32
  858. package/docs/BidManagerV1Dto.md +0 -28
  859. package/docs/BidResultV1AttachmentDto.md +0 -28
  860. package/docs/BidResultV1BidProductInfoDto.md +0 -34
  861. package/docs/BidResultV1ParticipantDto.md +0 -102
  862. package/docs/BidResultV1ProductDto.md +0 -38
  863. package/docs/BidResultsBatchV1RequestDto.md +0 -24
  864. package/docs/BidResultsV1ResponseDto.md +0 -92
  865. package/docs/BidStatementV1ResponseDto.md +0 -26
  866. package/docs/BidStatus.md +0 -19
  867. package/docs/CompleteAcceptanceV1RequestDto.md +0 -44
  868. package/docs/ContractDocumentItemDto.md +0 -34
  869. package/docs/CreateBidV1RequestDto.md +0 -114
  870. package/docs/FileUploadedV1ResponseDto.md +0 -20
  871. package/docs/HierarchicalRegionV1Dto.md +0 -22
  872. package/docs/MarkBidFailedV1RequestDto.md +0 -24
  873. package/docs/NegotiationScoreV1Dto.md +0 -24
  874. package/docs/NegotiationScoredResponseDto.md +0 -20
  875. package/docs/PartnerV1Api.md +0 -707
  876. package/docs/PreconditionsV1Dto.md +0 -38
  877. package/docs/ProductReceiptV1ResponseDto.md +0 -20
  878. package/docs/ProductV1ResponseDto.md +0 -64
  879. package/docs/RegisterAwardV1RequestDto.md +0 -28
  880. package/docs/RequestSplitInvoiceV1RequestDto.md +0 -26
  881. package/docs/SplitInvoiceV1ResponseDto.md +0 -20
  882. package/docs/StatementV1DocumentDto.md +0 -28
  883. package/docs/StatementV1ProductDto.md +0 -36
  884. package/docs/SubmitNegotiationScoresV1RequestDto.md +0 -22
  885. package/docs/UploadFileV1RequestDto.md +0 -24
  886. package/models/acceptance-result-v1-response-dto.ts +0 -23
  887. package/models/acknowledge-products-v1-request-dto.ts +0 -23
  888. package/models/award-registered-response-dto.ts +0 -23
  889. package/models/bid-attachment-v1-dto.ts +0 -27
  890. package/models/bid-bond-v1-dto.ts +0 -36
  891. package/models/bid-contract-documents-batch-v1-request-dto.ts +0 -23
  892. package/models/bid-contract-documents-v1-response-dto.ts +0 -38
  893. package/models/bid-created-response-dto.ts +0 -27
  894. package/models/bid-document-v1-dto.ts +0 -31
  895. package/models/bid-failed-response-dto.ts +0 -23
  896. package/models/bid-failure-reason.ts +0 -35
  897. package/models/bid-item-v1-dto.ts +0 -47
  898. package/models/bid-manager-v1-dto.ts +0 -39
  899. package/models/bid-result-v1-attachment-dto.ts +0 -39
  900. package/models/bid-result-v1-bid-product-info-dto.ts +0 -51
  901. package/models/bid-result-v1-participant-dto.ts +0 -193
  902. package/models/bid-result-v1-product-dto.ts +0 -59
  903. package/models/bid-results-batch-v1-request-dto.ts +0 -31
  904. package/models/bid-results-v1-response-dto.ts +0 -178
  905. package/models/bid-statement-v1-response-dto.ts +0 -41
  906. package/models/bid-status.ts +0 -33
  907. package/models/complete-acceptance-v1-request-dto.ts +0 -71
  908. package/models/contract-document-item-dto.ts +0 -51
  909. package/models/create-bid-v1-request-dto.ts +0 -371
  910. package/models/file-uploaded-v1-response-dto.ts +0 -23
  911. package/models/hierarchical-region-v1-dto.ts +0 -27
  912. package/models/mark-bid-failed-v1-request-dto.ts +0 -36
  913. package/models/negotiation-score-v1-dto.ts +0 -31
  914. package/models/negotiation-scored-response-dto.ts +0 -23
  915. package/models/preconditions-v1-dto.ts +0 -101
  916. package/models/product-receipt-v1-response-dto.ts +0 -23
  917. package/models/product-v1-response-dto.ts +0 -111
  918. package/models/register-award-v1-request-dto.ts +0 -39
  919. package/models/request-split-invoice-v1-request-dto.ts +0 -35
  920. package/models/split-invoice-v1-response-dto.ts +0 -23
  921. package/models/statement-v1-document-dto.ts +0 -39
  922. package/models/statement-v1-product-dto.ts +0 -55
  923. package/models/submit-negotiation-scores-v1-request-dto.ts +0 -30
  924. package/models/upload-file-v1-request-dto.ts +0 -31
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 ERP 연동용 RESTful API. ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송. ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다). 봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다. 에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다. ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것. ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것. ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다. `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 개가 실립니다 `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 나가지 않습니다. 종료일이 지난 뒤의 호출은 `404` 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` \"그런 것이 있었는지 모르겠다\", `410` \"있었고 의도적으로 없앴다\" 입니다. `410` 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
+ * 외부 ERP 연동용 RESTful API. ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요. ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403 입니다. 대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요. ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다). 봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON 이 아닙니다. 에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다. ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json` 입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다. ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body 를 되돌리세요. ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다. `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실립니다. ## 전방호환 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 추가**: 상태·낙찰방법 등에 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug**HTTP status 폴백**해 분기하세요. ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
7
7
  *
8
- * The version of the OpenAPI document: 35.1.0
8
+ * The version of the OpenAPI document: 36.1.1
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -22,7 +22,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
22
22
  });
23
23
  };
24
24
  Object.defineProperty(exports, "__esModule", { value: true });
25
- exports.ListExternalContractDocumentsBidTypeEnum = exports.ListBidsIncludeEnum = exports.PartnerV2Api = exports.PartnerV2ApiFactory = exports.PartnerV2ApiFp = exports.PartnerV2ApiAxiosParamCreator = void 0;
25
+ exports.ListExternalContractDocumentsBidTypeEnum = exports.ListBidsIncludeEnum = exports.PartnerApiApi = exports.PartnerApiApiFactory = exports.PartnerApiApiFp = exports.PartnerApiApiAxiosParamCreator = void 0;
26
26
  const axios_1 = require("axios");
27
27
  // Some imports not used depending on template conditions
28
28
  // @ts-ignore
@@ -30,15 +30,15 @@ const common_1 = require("../common");
30
30
  // @ts-ignore
31
31
  const base_1 = require("../base");
32
32
  /**
33
- * PartnerV2Api - axios parameter creator
33
+ * PartnerApiApi - axios parameter creator
34
34
  */
35
- const PartnerV2ApiAxiosParamCreator = function (configuration) {
35
+ const PartnerApiApiAxiosParamCreator = function (configuration) {
36
36
  return {
37
37
  /**
38
38
  * 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
39
39
  * @summary 공고 취소
40
40
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
41
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
41
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
42
42
  * @param {CancelBidRequestDto} cancelBidRequestDto
43
43
  * @param {*} [options] Override http request option.
44
44
  * @throws {RequiredError}
@@ -79,10 +79,10 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
79
79
  };
80
80
  }),
81
81
  /**
82
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답은 204가 아닌 200입니다 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **V5-compat 안내:** 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자 override(11종)는 modern v2 표면에서 제거됐습니다. 필요 V5 충실 카운터파트 `POST /v1/bids/{bidRef}/acceptance`(`CompleteAcceptanceV1RequestDto`)를 사용하세요. **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
82
+ * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
83
83
  * @summary 검수완료 전송
84
84
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
85
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
85
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
86
86
  * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
87
87
  * @param {*} [options] Override http request option.
88
88
  * @throws {RequiredError}
@@ -124,9 +124,9 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
124
124
  }),
125
125
  /**
126
126
  * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
127
- * @summary 정산 마감(송장 강제완료)
127
+ * @summary 정산 마감
128
128
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
129
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간). UUID v4 권장.
129
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
130
130
  * @param {*} [options] Override http request option.
131
131
  * @throws {RequiredError}
132
132
  */
@@ -162,20 +162,19 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
162
162
  };
163
163
  }),
164
164
  /**
165
- * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
166
- * @summary 결제창 발행 (구 경로)
167
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
168
- * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
165
+ * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
166
+ * @summary 결제창 발행
167
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
168
+ * @param {CreateCardPaymentDto} createCardPaymentDto
169
169
  * @param {*} [options] Override http request option.
170
- * @deprecated
171
170
  * @throws {RequiredError}
172
171
  */
173
- createCardPaymentRequest: (idempotencyKey_1, createCardPaymentRequestDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, createCardPaymentRequestDto_1, ...args_1], void 0, function* (idempotencyKey, createCardPaymentRequestDto, options = {}) {
172
+ createCardPayment: (idempotencyKey_1, createCardPaymentDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, createCardPaymentDto_1, ...args_1], void 0, function* (idempotencyKey, createCardPaymentDto, options = {}) {
174
173
  // verify required parameter 'idempotencyKey' is not null or undefined
175
- (0, common_1.assertParamExists)('createCardPaymentRequest', 'idempotencyKey', idempotencyKey);
176
- // verify required parameter 'createCardPaymentRequestDto' is not null or undefined
177
- (0, common_1.assertParamExists)('createCardPaymentRequest', 'createCardPaymentRequestDto', createCardPaymentRequestDto);
178
- const localVarPath = `/v2/card-payment-requests`;
174
+ (0, common_1.assertParamExists)('createCardPayment', 'idempotencyKey', idempotencyKey);
175
+ // verify required parameter 'createCardPaymentDto' is not null or undefined
176
+ (0, common_1.assertParamExists)('createCardPayment', 'createCardPaymentDto', createCardPaymentDto);
177
+ const localVarPath = `/v2/card-payments`;
179
178
  // use dummy base URL string because the URL constructor only accepts absolute URLs.
180
179
  const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
181
180
  let baseOptions;
@@ -196,7 +195,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
196
195
  (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
197
196
  let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
198
197
  localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
199
- localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(createCardPaymentRequestDto, localVarRequestOptions, configuration);
198
+ localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(createCardPaymentDto, localVarRequestOptions, configuration);
200
199
  return {
201
200
  url: (0, common_1.toPathString)(localVarUrlObj),
202
201
  options: localVarRequestOptions,
@@ -205,7 +204,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
205
204
  /**
206
205
  * 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
207
206
  * @summary 계약서류 생성
208
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
207
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
209
208
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
210
209
  * @param {*} [options] Override http request option.
211
210
  * @throws {RequiredError}
@@ -243,8 +242,8 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
243
242
  };
244
243
  }),
245
244
  /**
246
- * 무인증 — `fileKey` 자체가 capability 다(V5 `/download/{fileKey}` 같은 보안 모델). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
247
- * @summary 파일 다운로드 — 안정 URL(302)
245
+ * 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
246
+ * @summary 파일 다운로드
248
247
  * @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
249
248
  * @param {*} [options] Override http request option.
250
249
  * @throws {RequiredError}
@@ -272,7 +271,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
272
271
  };
273
272
  }),
274
273
  /**
275
- * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류:** `contractDocuments[].generationState` 는 **관측 전용**입니다. `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태이며 API 로 되살릴 수 없습니다운영에 문의하세요. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
274
+ * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
276
275
  * @summary 공고 상세 조회
277
276
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
278
277
  * @param {*} [options] Override http request option.
@@ -305,7 +304,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
305
304
  };
306
305
  }),
307
306
  /**
308
- * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
307
+ * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
309
308
  * @summary 정산 정보 조회
310
309
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
311
310
  * @param {*} [options] Override http request option.
@@ -376,7 +375,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
376
375
  }),
377
376
  /**
378
377
  * 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
379
- * @summary 파일 조회(메타 + 내려받기 주소)
378
+ * @summary 파일 정보 조회
380
379
  * @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
381
380
  * @param {*} [options] Override http request option.
382
381
  * @throws {RequiredError}
@@ -441,17 +440,16 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
441
440
  };
442
441
  }),
443
442
  /**
444
- * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **필수 스코프:** `payments:write` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 신규 연동에 권합니다. 경로도 계속 동작하며 중단 일정은 없습니다.
445
- * @summary 공급사 카드결제 가능 여부 (구 경로)
443
+ * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
444
+ * @summary 공급사 카드결제 가능 여부
446
445
  * @param {string} memberId 계약업체 회원 ID
447
446
  * @param {*} [options] Override http request option.
448
- * @deprecated
449
447
  * @throws {RequiredError}
450
448
  */
451
- getSupplierCardPayable: (memberId_1, ...args_1) => __awaiter(this, [memberId_1, ...args_1], void 0, function* (memberId, options = {}) {
449
+ getSupplierCardPayableV2: (memberId_1, ...args_1) => __awaiter(this, [memberId_1, ...args_1], void 0, function* (memberId, options = {}) {
452
450
  // verify required parameter 'memberId' is not null or undefined
453
- (0, common_1.assertParamExists)('getSupplierCardPayable', 'memberId', memberId);
454
- const localVarPath = `/v2/card-payment-requests/suppliers/{memberId}/card-payable`
451
+ (0, common_1.assertParamExists)('getSupplierCardPayableV2', 'memberId', memberId);
452
+ const localVarPath = `/v2/suppliers/{memberId}/card-payable`
455
453
  .replace('{memberId}', encodeURIComponent(String(memberId)));
456
454
  // use dummy base URL string because the URL constructor only accepts absolute URLs.
457
455
  const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
@@ -464,8 +462,8 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
464
462
  const localVarQueryParameter = {};
465
463
  // authentication partner-oauth2 required
466
464
  // oauth required
467
- yield (0, common_1.setOAuthToObject)(localVarHeaderParameter, "partner-oauth2", ["payments:write"], configuration);
468
- localVarHeaderParameter['Accept'] = 'application/json';
465
+ yield (0, common_1.setOAuthToObject)(localVarHeaderParameter, "partner-oauth2", ["payments:read"], configuration);
466
+ localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
469
467
  (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
470
468
  let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
471
469
  localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -501,15 +499,15 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
501
499
  };
502
500
  }),
503
501
  /**
504
- * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다. **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요. **단건 조회:** 공고 하나만 볼 때도 `bidIds` 에 하나만 넣거나 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요. 종전의 `GET /v2/bids/{bidRef}/result` 상세 응답의 부분집합이라 폐지됐습니다.
505
- * @summary 공고 결과 배치 조회
506
- * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
502
+ * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
503
+ * @summary 공고 결과 조회
504
+ * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60; 를 반복해 전달합니다. 최대 100건입니다.
507
505
  * @param {*} [options] Override http request option.
508
506
  * @throws {RequiredError}
509
507
  */
510
- listBidResults: (bidIds_1, ...args_1) => __awaiter(this, [bidIds_1, ...args_1], void 0, function* (bidIds, options = {}) {
511
- // verify required parameter 'bidIds' is not null or undefined
512
- (0, common_1.assertParamExists)('listBidResults', 'bidIds', bidIds);
508
+ listBidResults: (bidRefs_1, ...args_1) => __awaiter(this, [bidRefs_1, ...args_1], void 0, function* (bidRefs, options = {}) {
509
+ // verify required parameter 'bidRefs' is not null or undefined
510
+ (0, common_1.assertParamExists)('listBidResults', 'bidRefs', bidRefs);
513
511
  const localVarPath = `/v2/bid-results`;
514
512
  // use dummy base URL string because the URL constructor only accepts absolute URLs.
515
513
  const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
@@ -523,8 +521,8 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
523
521
  // authentication partner-oauth2 required
524
522
  // oauth required
525
523
  yield (0, common_1.setOAuthToObject)(localVarHeaderParameter, "partner-oauth2", ["bids:read"], configuration);
526
- if (bidIds !== undefined) {
527
- localVarQueryParameter['bidIds'] = bidIds;
524
+ if (bidRefs !== undefined) {
525
+ localVarQueryParameter['bidRefs'] = bidRefs;
528
526
  }
529
527
  localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
530
528
  (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
@@ -540,13 +538,13 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
540
538
  * @summary 공고 목록 조회
541
539
  * @param {number} [limit] 페이지 크기(1~100, 기본 100).
542
540
  * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
543
- * @param {Array<string>} [bidIds] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
544
- * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다.
541
+ * @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
542
+ * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
545
543
  * @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
546
544
  * @param {*} [options] Override http request option.
547
545
  * @throws {RequiredError}
548
546
  */
549
- listBids: (limit_1, cursor_1, bidIds_1, status_1, include_1, ...args_1) => __awaiter(this, [limit_1, cursor_1, bidIds_1, status_1, include_1, ...args_1], void 0, function* (limit, cursor, bidIds, status, include, options = {}) {
547
+ listBids: (limit_1, cursor_1, bidRefs_1, status_1, include_1, ...args_1) => __awaiter(this, [limit_1, cursor_1, bidRefs_1, status_1, include_1, ...args_1], void 0, function* (limit, cursor, bidRefs, status, include, options = {}) {
550
548
  const localVarPath = `/v2/bids`;
551
549
  // use dummy base URL string because the URL constructor only accepts absolute URLs.
552
550
  const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
@@ -566,8 +564,8 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
566
564
  if (cursor !== undefined) {
567
565
  localVarQueryParameter['cursor'] = cursor;
568
566
  }
569
- if (bidIds) {
570
- localVarQueryParameter['bidIds'] = bidIds;
567
+ if (bidRefs) {
568
+ localVarQueryParameter['bidRefs'] = bidRefs;
571
569
  }
572
570
  if (status) {
573
571
  localVarQueryParameter['status'] = status;
@@ -629,7 +627,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
629
627
  * 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
630
628
  * @summary 유찰 처리
631
629
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
632
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
630
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
633
631
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
634
632
  * @param {*} [options] Override http request option.
635
633
  * @throws {RequiredError}
@@ -673,7 +671,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
673
671
  * 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
674
672
  * @summary 낙찰 결과 전송
675
673
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
676
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
674
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
677
675
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
678
676
  * @param {*} [options] Override http request option.
679
677
  * @throws {RequiredError}
@@ -716,7 +714,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
716
714
  /**
717
715
  * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
718
716
  * @summary 공고 등록
719
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 캐시 응답 반환.
717
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
720
718
  * @param {CreateBidRequestDto} createBidRequestDto
721
719
  * @param {*} [options] Override http request option.
722
720
  * @throws {RequiredError}
@@ -756,7 +754,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
756
754
  /**
757
755
  * 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
758
756
  * @summary 계약 발행대상 등록
759
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
757
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
760
758
  * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
761
759
  * @param {*} [options] Override http request option.
762
760
  * @throws {RequiredError}
@@ -793,11 +791,55 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
793
791
  options: localVarRequestOptions,
794
792
  };
795
793
  }),
794
+ /**
795
+ * 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
796
+ * @summary 계산서 분할 발급 청구
797
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
798
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
799
+ * @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
800
+ * @param {*} [options] Override http request option.
801
+ * @throws {RequiredError}
802
+ */
803
+ requestInvoiceSplit: (bidRef_1, idempotencyKey_1, requestInvoiceSplitRequestDto_1, ...args_1) => __awaiter(this, [bidRef_1, idempotencyKey_1, requestInvoiceSplitRequestDto_1, ...args_1], void 0, function* (bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options = {}) {
804
+ // verify required parameter 'bidRef' is not null or undefined
805
+ (0, common_1.assertParamExists)('requestInvoiceSplit', 'bidRef', bidRef);
806
+ // verify required parameter 'idempotencyKey' is not null or undefined
807
+ (0, common_1.assertParamExists)('requestInvoiceSplit', 'idempotencyKey', idempotencyKey);
808
+ // verify required parameter 'requestInvoiceSplitRequestDto' is not null or undefined
809
+ (0, common_1.assertParamExists)('requestInvoiceSplit', 'requestInvoiceSplitRequestDto', requestInvoiceSplitRequestDto);
810
+ const localVarPath = `/v2/bids/{bidRef}/invoice-splits`
811
+ .replace('{bidRef}', encodeURIComponent(String(bidRef)));
812
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
813
+ const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
814
+ let baseOptions;
815
+ if (configuration) {
816
+ baseOptions = configuration.baseOptions;
817
+ }
818
+ const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
819
+ const localVarHeaderParameter = {};
820
+ const localVarQueryParameter = {};
821
+ // authentication partner-oauth2 required
822
+ // oauth required
823
+ yield (0, common_1.setOAuthToObject)(localVarHeaderParameter, "partner-oauth2", ["invoices:write"], configuration);
824
+ localVarHeaderParameter['Content-Type'] = 'application/json';
825
+ localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
826
+ if (idempotencyKey != null) {
827
+ localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
828
+ }
829
+ (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
830
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
831
+ localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
832
+ localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(requestInvoiceSplitRequestDto, localVarRequestOptions, configuration);
833
+ return {
834
+ url: (0, common_1.toPathString)(localVarUrlObj),
835
+ options: localVarRequestOptions,
836
+ };
837
+ }),
796
838
  /**
797
839
  * 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
798
840
  * @summary 낙찰 되돌리기
799
841
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
800
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
842
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
801
843
  * @param {RevertAwardRequestDto} revertAwardRequestDto
802
844
  * @param {*} [options] Override http request option.
803
845
  * @throws {RequiredError}
@@ -838,23 +880,64 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
838
880
  };
839
881
  }),
840
882
  /**
841
- * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
883
+ * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body buyerId 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 + 동일 body 재전송 24시간 캐시 응답 반환.
884
+ * @summary 협상 점수평가
885
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
886
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
887
+ * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
888
+ * @param {*} [options] Override http request option.
889
+ * @throws {RequiredError}
890
+ */
891
+ submitNegotiationScores: (bidRef_1, idempotencyKey_1, submitNegotiationScoresRequestDto_1, ...args_1) => __awaiter(this, [bidRef_1, idempotencyKey_1, submitNegotiationScoresRequestDto_1, ...args_1], void 0, function* (bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options = {}) {
892
+ // verify required parameter 'bidRef' is not null or undefined
893
+ (0, common_1.assertParamExists)('submitNegotiationScores', 'bidRef', bidRef);
894
+ // verify required parameter 'idempotencyKey' is not null or undefined
895
+ (0, common_1.assertParamExists)('submitNegotiationScores', 'idempotencyKey', idempotencyKey);
896
+ // verify required parameter 'submitNegotiationScoresRequestDto' is not null or undefined
897
+ (0, common_1.assertParamExists)('submitNegotiationScores', 'submitNegotiationScoresRequestDto', submitNegotiationScoresRequestDto);
898
+ const localVarPath = `/v2/bids/{bidRef}/negotiation-scores`
899
+ .replace('{bidRef}', encodeURIComponent(String(bidRef)));
900
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
901
+ const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
902
+ let baseOptions;
903
+ if (configuration) {
904
+ baseOptions = configuration.baseOptions;
905
+ }
906
+ const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
907
+ const localVarHeaderParameter = {};
908
+ const localVarQueryParameter = {};
909
+ // authentication partner-oauth2 required
910
+ // oauth required
911
+ yield (0, common_1.setOAuthToObject)(localVarHeaderParameter, "partner-oauth2", ["awards:write"], configuration);
912
+ localVarHeaderParameter['Content-Type'] = 'application/json';
913
+ localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
914
+ if (idempotencyKey != null) {
915
+ localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
916
+ }
917
+ (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
918
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
919
+ localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
920
+ localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(submitNegotiationScoresRequestDto, localVarRequestOptions, configuration);
921
+ return {
922
+ url: (0, common_1.toPathString)(localVarUrlObj),
923
+ options: localVarRequestOptions,
924
+ };
925
+ }),
926
+ /**
927
+ * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
842
928
  * @summary 공고 수정
843
929
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
844
- * @param {string} ifMatch
845
- * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 사이 공고가 바뀌었으면 412 거절되며 아무것도 수정되지 않습니다.
846
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
930
+ * @param {string} ifMatch 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
931
+ * @param {string} idempotencyKey 멱등성 (1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
847
932
  * @param {UpdateBidRequestDto} updateBidRequestDto
848
933
  * @param {*} [options] Override http request option.
849
934
  * @throws {RequiredError}
850
935
  */
851
- updateBid: (bidRef_1, ifMatch_1, ifMatch2_1, idempotencyKey_1, updateBidRequestDto_1, ...args_1) => __awaiter(this, [bidRef_1, ifMatch_1, ifMatch2_1, idempotencyKey_1, updateBidRequestDto_1, ...args_1], void 0, function* (bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options = {}) {
936
+ updateBid: (bidRef_1, ifMatch_1, idempotencyKey_1, updateBidRequestDto_1, ...args_1) => __awaiter(this, [bidRef_1, ifMatch_1, idempotencyKey_1, updateBidRequestDto_1, ...args_1], void 0, function* (bidRef, ifMatch, idempotencyKey, updateBidRequestDto, options = {}) {
852
937
  // verify required parameter 'bidRef' is not null or undefined
853
938
  (0, common_1.assertParamExists)('updateBid', 'bidRef', bidRef);
854
939
  // verify required parameter 'ifMatch' is not null or undefined
855
940
  (0, common_1.assertParamExists)('updateBid', 'ifMatch', ifMatch);
856
- // verify required parameter 'ifMatch2' is not null or undefined
857
- (0, common_1.assertParamExists)('updateBid', 'ifMatch2', ifMatch2);
858
941
  // verify required parameter 'idempotencyKey' is not null or undefined
859
942
  (0, common_1.assertParamExists)('updateBid', 'idempotencyKey', idempotencyKey);
860
943
  // verify required parameter 'updateBidRequestDto' is not null or undefined
@@ -876,10 +959,7 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
876
959
  localVarHeaderParameter['Content-Type'] = 'application/json';
877
960
  localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
878
961
  if (ifMatch != null) {
879
- localVarHeaderParameter['if-match'] = String(ifMatch);
880
- }
881
- if (ifMatch2 != null) {
882
- localVarHeaderParameter['If-Match'] = String(ifMatch2);
962
+ localVarHeaderParameter['If-Match'] = String(ifMatch);
883
963
  }
884
964
  if (idempotencyKey != null) {
885
965
  localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
@@ -894,13 +974,16 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
894
974
  };
895
975
  }),
896
976
  /**
897
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
898
- * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
977
+ * 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
978
+ * @summary 공고 첨부파일 업로드
979
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
899
980
  * @param {UploadFileRequestDto} uploadFileRequestDto
900
981
  * @param {*} [options] Override http request option.
901
982
  * @throws {RequiredError}
902
983
  */
903
- uploadFile: (uploadFileRequestDto_1, ...args_1) => __awaiter(this, [uploadFileRequestDto_1, ...args_1], void 0, function* (uploadFileRequestDto, options = {}) {
984
+ uploadFile: (idempotencyKey_1, uploadFileRequestDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, uploadFileRequestDto_1, ...args_1], void 0, function* (idempotencyKey, uploadFileRequestDto, options = {}) {
985
+ // verify required parameter 'idempotencyKey' is not null or undefined
986
+ (0, common_1.assertParamExists)('uploadFile', 'idempotencyKey', idempotencyKey);
904
987
  // verify required parameter 'uploadFileRequestDto' is not null or undefined
905
988
  (0, common_1.assertParamExists)('uploadFile', 'uploadFileRequestDto', uploadFileRequestDto);
906
989
  const localVarPath = `/v2/files`;
@@ -918,6 +1001,9 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
918
1001
  yield (0, common_1.setOAuthToObject)(localVarHeaderParameter, "partner-oauth2", ["files:write"], configuration);
919
1002
  localVarHeaderParameter['Content-Type'] = 'application/json';
920
1003
  localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
1004
+ if (idempotencyKey != null) {
1005
+ localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
1006
+ }
921
1007
  (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
922
1008
  let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
923
1009
  localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
@@ -929,18 +1015,18 @@ const PartnerV2ApiAxiosParamCreator = function (configuration) {
929
1015
  }),
930
1016
  };
931
1017
  };
932
- exports.PartnerV2ApiAxiosParamCreator = PartnerV2ApiAxiosParamCreator;
1018
+ exports.PartnerApiApiAxiosParamCreator = PartnerApiApiAxiosParamCreator;
933
1019
  /**
934
- * PartnerV2Api - functional programming interface
1020
+ * PartnerApiApi - functional programming interface
935
1021
  */
936
- const PartnerV2ApiFp = function (configuration) {
937
- const localVarAxiosParamCreator = (0, exports.PartnerV2ApiAxiosParamCreator)(configuration);
1022
+ const PartnerApiApiFp = function (configuration) {
1023
+ const localVarAxiosParamCreator = (0, exports.PartnerApiApiAxiosParamCreator)(configuration);
938
1024
  return {
939
1025
  /**
940
1026
  * 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
941
1027
  * @summary 공고 취소
942
1028
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
943
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
1029
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
944
1030
  * @param {CancelBidRequestDto} cancelBidRequestDto
945
1031
  * @param {*} [options] Override http request option.
946
1032
  * @throws {RequiredError}
@@ -950,15 +1036,15 @@ const PartnerV2ApiFp = function (configuration) {
950
1036
  var _a, _b, _c;
951
1037
  const localVarAxiosArgs = yield localVarAxiosParamCreator.cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options);
952
1038
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
953
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.cancelBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1039
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.cancelBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
954
1040
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
955
1041
  });
956
1042
  },
957
1043
  /**
958
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답은 204가 아닌 200입니다 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **V5-compat 안내:** 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자 override(11종)는 modern v2 표면에서 제거됐습니다. 필요 V5 충실 카운터파트 `POST /v1/bids/{bidRef}/acceptance`(`CompleteAcceptanceV1RequestDto`)를 사용하세요. **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1044
+ * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
959
1045
  * @summary 검수완료 전송
960
1046
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
961
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1047
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
962
1048
  * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
963
1049
  * @param {*} [options] Override http request option.
964
1050
  * @throws {RequiredError}
@@ -968,15 +1054,15 @@ const PartnerV2ApiFp = function (configuration) {
968
1054
  var _a, _b, _c;
969
1055
  const localVarAxiosArgs = yield localVarAxiosParamCreator.completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options);
970
1056
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
971
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.completeAcceptance']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1057
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.completeAcceptance']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
972
1058
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
973
1059
  });
974
1060
  },
975
1061
  /**
976
1062
  * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
977
- * @summary 정산 마감(송장 강제완료)
1063
+ * @summary 정산 마감
978
1064
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
979
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간). UUID v4 권장.
1065
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
980
1066
  * @param {*} [options] Override http request option.
981
1067
  * @throws {RequiredError}
982
1068
  */
@@ -985,32 +1071,31 @@ const PartnerV2ApiFp = function (configuration) {
985
1071
  var _a, _b, _c;
986
1072
  const localVarAxiosArgs = yield localVarAxiosParamCreator.completeInvoice(bidRef, idempotencyKey, options);
987
1073
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
988
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.completeInvoice']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1074
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.completeInvoice']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
989
1075
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
990
1076
  });
991
1077
  },
992
1078
  /**
993
- * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
994
- * @summary 결제창 발행 (구 경로)
995
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
996
- * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
1079
+ * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
1080
+ * @summary 결제창 발행
1081
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1082
+ * @param {CreateCardPaymentDto} createCardPaymentDto
997
1083
  * @param {*} [options] Override http request option.
998
- * @deprecated
999
1084
  * @throws {RequiredError}
1000
1085
  */
1001
- createCardPaymentRequest(idempotencyKey, createCardPaymentRequestDto, options) {
1086
+ createCardPayment(idempotencyKey, createCardPaymentDto, options) {
1002
1087
  return __awaiter(this, void 0, void 0, function* () {
1003
1088
  var _a, _b, _c;
1004
- const localVarAxiosArgs = yield localVarAxiosParamCreator.createCardPaymentRequest(idempotencyKey, createCardPaymentRequestDto, options);
1089
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.createCardPayment(idempotencyKey, createCardPaymentDto, options);
1005
1090
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1006
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.createCardPaymentRequest']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1091
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.createCardPayment']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1007
1092
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1008
1093
  });
1009
1094
  },
1010
1095
  /**
1011
1096
  * 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
1012
1097
  * @summary 계약서류 생성
1013
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1098
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1014
1099
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
1015
1100
  * @param {*} [options] Override http request option.
1016
1101
  * @throws {RequiredError}
@@ -1020,13 +1105,13 @@ const PartnerV2ApiFp = function (configuration) {
1020
1105
  var _a, _b, _c;
1021
1106
  const localVarAxiosArgs = yield localVarAxiosParamCreator.createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options);
1022
1107
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1023
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.createExternalContractDocuments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1108
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.createExternalContractDocuments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1024
1109
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1025
1110
  });
1026
1111
  },
1027
1112
  /**
1028
- * 무인증 — `fileKey` 자체가 capability 다(V5 `/download/{fileKey}` 같은 보안 모델). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
1029
- * @summary 파일 다운로드 — 안정 URL(302)
1113
+ * 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
1114
+ * @summary 파일 다운로드
1030
1115
  * @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
1031
1116
  * @param {*} [options] Override http request option.
1032
1117
  * @throws {RequiredError}
@@ -1036,12 +1121,12 @@ const PartnerV2ApiFp = function (configuration) {
1036
1121
  var _a, _b, _c;
1037
1122
  const localVarAxiosArgs = yield localVarAxiosParamCreator.downloadFile(fileKey, options);
1038
1123
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1039
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.downloadFile']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1124
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.downloadFile']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1040
1125
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1041
1126
  });
1042
1127
  },
1043
1128
  /**
1044
- * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류:** `contractDocuments[].generationState` 는 **관측 전용**입니다. `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태이며 API 로 되살릴 수 없습니다운영에 문의하세요. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1129
+ * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1045
1130
  * @summary 공고 상세 조회
1046
1131
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1047
1132
  * @param {*} [options] Override http request option.
@@ -1052,12 +1137,12 @@ const PartnerV2ApiFp = function (configuration) {
1052
1137
  var _a, _b, _c;
1053
1138
  const localVarAxiosArgs = yield localVarAxiosParamCreator.getBid(bidRef, options);
1054
1139
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1055
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.getBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1140
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.getBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1056
1141
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1057
1142
  });
1058
1143
  },
1059
1144
  /**
1060
- * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
1145
+ * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
1061
1146
  * @summary 정산 정보 조회
1062
1147
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1063
1148
  * @param {*} [options] Override http request option.
@@ -1068,7 +1153,7 @@ const PartnerV2ApiFp = function (configuration) {
1068
1153
  var _a, _b, _c;
1069
1154
  const localVarAxiosArgs = yield localVarAxiosParamCreator.getBidSettlement(bidRef, options);
1070
1155
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1071
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.getBidSettlement']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1156
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.getBidSettlement']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1072
1157
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1073
1158
  });
1074
1159
  },
@@ -1085,13 +1170,13 @@ const PartnerV2ApiFp = function (configuration) {
1085
1170
  var _a, _b, _c;
1086
1171
  const localVarAxiosArgs = yield localVarAxiosParamCreator.getBidStatement(bidRef, paperCode, options);
1087
1172
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1088
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.getBidStatement']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1173
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.getBidStatement']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1089
1174
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1090
1175
  });
1091
1176
  },
1092
1177
  /**
1093
1178
  * 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
1094
- * @summary 파일 조회(메타 + 내려받기 주소)
1179
+ * @summary 파일 정보 조회
1095
1180
  * @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
1096
1181
  * @param {*} [options] Override http request option.
1097
1182
  * @throws {RequiredError}
@@ -1101,7 +1186,7 @@ const PartnerV2ApiFp = function (configuration) {
1101
1186
  var _a, _b, _c;
1102
1187
  const localVarAxiosArgs = yield localVarAxiosParamCreator.getFileMeta(fileKey, options);
1103
1188
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1104
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.getFileMeta']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1189
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.getFileMeta']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1105
1190
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1106
1191
  });
1107
1192
  },
@@ -1117,24 +1202,23 @@ const PartnerV2ApiFp = function (configuration) {
1117
1202
  var _a, _b, _c;
1118
1203
  const localVarAxiosArgs = yield localVarAxiosParamCreator.getSemoContractTaxinvoiceStatus(externalContractId, options);
1119
1204
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1120
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.getSemoContractTaxinvoiceStatus']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1205
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.getSemoContractTaxinvoiceStatus']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1121
1206
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1122
1207
  });
1123
1208
  },
1124
1209
  /**
1125
- * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **필수 스코프:** `payments:write` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 신규 연동에 권합니다. 경로도 계속 동작하며 중단 일정은 없습니다.
1126
- * @summary 공급사 카드결제 가능 여부 (구 경로)
1210
+ * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
1211
+ * @summary 공급사 카드결제 가능 여부
1127
1212
  * @param {string} memberId 계약업체 회원 ID
1128
1213
  * @param {*} [options] Override http request option.
1129
- * @deprecated
1130
1214
  * @throws {RequiredError}
1131
1215
  */
1132
- getSupplierCardPayable(memberId, options) {
1216
+ getSupplierCardPayableV2(memberId, options) {
1133
1217
  return __awaiter(this, void 0, void 0, function* () {
1134
1218
  var _a, _b, _c;
1135
- const localVarAxiosArgs = yield localVarAxiosParamCreator.getSupplierCardPayable(memberId, options);
1219
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.getSupplierCardPayableV2(memberId, options);
1136
1220
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1137
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.getSupplierCardPayable']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1221
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.getSupplierCardPayableV2']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1138
1222
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1139
1223
  });
1140
1224
  },
@@ -1149,23 +1233,23 @@ const PartnerV2ApiFp = function (configuration) {
1149
1233
  var _a, _b, _c;
1150
1234
  const localVarAxiosArgs = yield localVarAxiosParamCreator.healthControllerCheck(options);
1151
1235
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1152
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.healthControllerCheck']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1236
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.healthControllerCheck']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1153
1237
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1154
1238
  });
1155
1239
  },
1156
1240
  /**
1157
- * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다. **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요. **단건 조회:** 공고 하나만 볼 때도 `bidIds` 에 하나만 넣거나 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요. 종전의 `GET /v2/bids/{bidRef}/result` 상세 응답의 부분집합이라 폐지됐습니다.
1158
- * @summary 공고 결과 배치 조회
1159
- * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
1241
+ * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
1242
+ * @summary 공고 결과 조회
1243
+ * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60; 를 반복해 전달합니다. 최대 100건입니다.
1160
1244
  * @param {*} [options] Override http request option.
1161
1245
  * @throws {RequiredError}
1162
1246
  */
1163
- listBidResults(bidIds, options) {
1247
+ listBidResults(bidRefs, options) {
1164
1248
  return __awaiter(this, void 0, void 0, function* () {
1165
1249
  var _a, _b, _c;
1166
- const localVarAxiosArgs = yield localVarAxiosParamCreator.listBidResults(bidIds, options);
1250
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.listBidResults(bidRefs, options);
1167
1251
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1168
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.listBidResults']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1252
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.listBidResults']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1169
1253
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1170
1254
  });
1171
1255
  },
@@ -1174,18 +1258,18 @@ const PartnerV2ApiFp = function (configuration) {
1174
1258
  * @summary 공고 목록 조회
1175
1259
  * @param {number} [limit] 페이지 크기(1~100, 기본 100).
1176
1260
  * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
1177
- * @param {Array<string>} [bidIds] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
1178
- * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다.
1261
+ * @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
1262
+ * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
1179
1263
  * @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
1180
1264
  * @param {*} [options] Override http request option.
1181
1265
  * @throws {RequiredError}
1182
1266
  */
1183
- listBids(limit, cursor, bidIds, status, include, options) {
1267
+ listBids(limit, cursor, bidRefs, status, include, options) {
1184
1268
  return __awaiter(this, void 0, void 0, function* () {
1185
1269
  var _a, _b, _c;
1186
- const localVarAxiosArgs = yield localVarAxiosParamCreator.listBids(limit, cursor, bidIds, status, include, options);
1270
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.listBids(limit, cursor, bidRefs, status, include, options);
1187
1271
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1188
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.listBids']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1272
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.listBids']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1189
1273
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1190
1274
  });
1191
1275
  },
@@ -1202,7 +1286,7 @@ const PartnerV2ApiFp = function (configuration) {
1202
1286
  var _a, _b, _c;
1203
1287
  const localVarAxiosArgs = yield localVarAxiosParamCreator.listExternalContractDocuments(buyerId, bidType, options);
1204
1288
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1205
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.listExternalContractDocuments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1289
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.listExternalContractDocuments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1206
1290
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1207
1291
  });
1208
1292
  },
@@ -1210,7 +1294,7 @@ const PartnerV2ApiFp = function (configuration) {
1210
1294
  * 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1211
1295
  * @summary 유찰 처리
1212
1296
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1213
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1297
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1214
1298
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
1215
1299
  * @param {*} [options] Override http request option.
1216
1300
  * @throws {RequiredError}
@@ -1220,7 +1304,7 @@ const PartnerV2ApiFp = function (configuration) {
1220
1304
  var _a, _b, _c;
1221
1305
  const localVarAxiosArgs = yield localVarAxiosParamCreator.markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options);
1222
1306
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1223
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.markBidFailed']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1307
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.markBidFailed']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1224
1308
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1225
1309
  });
1226
1310
  },
@@ -1228,7 +1312,7 @@ const PartnerV2ApiFp = function (configuration) {
1228
1312
  * 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
1229
1313
  * @summary 낙찰 결과 전송
1230
1314
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1231
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1315
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1232
1316
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
1233
1317
  * @param {*} [options] Override http request option.
1234
1318
  * @throws {RequiredError}
@@ -1238,14 +1322,14 @@ const PartnerV2ApiFp = function (configuration) {
1238
1322
  var _a, _b, _c;
1239
1323
  const localVarAxiosArgs = yield localVarAxiosParamCreator.registerAward(bidRef, idempotencyKey, registerAwardRequestDto, options);
1240
1324
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1241
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.registerAward']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1325
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.registerAward']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1242
1326
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1243
1327
  });
1244
1328
  },
1245
1329
  /**
1246
1330
  * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
1247
1331
  * @summary 공고 등록
1248
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 캐시 응답 반환.
1332
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1249
1333
  * @param {CreateBidRequestDto} createBidRequestDto
1250
1334
  * @param {*} [options] Override http request option.
1251
1335
  * @throws {RequiredError}
@@ -1255,14 +1339,14 @@ const PartnerV2ApiFp = function (configuration) {
1255
1339
  var _a, _b, _c;
1256
1340
  const localVarAxiosArgs = yield localVarAxiosParamCreator.registerBid(idempotencyKey, createBidRequestDto, options);
1257
1341
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1258
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.registerBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1342
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.registerBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1259
1343
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1260
1344
  });
1261
1345
  },
1262
1346
  /**
1263
1347
  * 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
1264
1348
  * @summary 계약 발행대상 등록
1265
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
1349
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1266
1350
  * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
1267
1351
  * @param {*} [options] Override http request option.
1268
1352
  * @throws {RequiredError}
@@ -1272,7 +1356,25 @@ const PartnerV2ApiFp = function (configuration) {
1272
1356
  var _a, _b, _c;
1273
1357
  const localVarAxiosArgs = yield localVarAxiosParamCreator.registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options);
1274
1358
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1275
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.registerSemoContract']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1359
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.registerSemoContract']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1360
+ return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1361
+ });
1362
+ },
1363
+ /**
1364
+ * 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
1365
+ * @summary 계산서 분할 발급 청구
1366
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1367
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1368
+ * @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
1369
+ * @param {*} [options] Override http request option.
1370
+ * @throws {RequiredError}
1371
+ */
1372
+ requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options) {
1373
+ return __awaiter(this, void 0, void 0, function* () {
1374
+ var _a, _b, _c;
1375
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options);
1376
+ const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1377
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.requestInvoiceSplit']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1276
1378
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1277
1379
  });
1278
1380
  },
@@ -1280,7 +1382,7 @@ const PartnerV2ApiFp = function (configuration) {
1280
1382
  * 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1281
1383
  * @summary 낙찰 되돌리기
1282
1384
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1283
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
1385
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1284
1386
  * @param {RevertAwardRequestDto} revertAwardRequestDto
1285
1387
  * @param {*} [options] Override http request option.
1286
1388
  * @throws {RequiredError}
@@ -1290,60 +1392,78 @@ const PartnerV2ApiFp = function (configuration) {
1290
1392
  var _a, _b, _c;
1291
1393
  const localVarAxiosArgs = yield localVarAxiosParamCreator.revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options);
1292
1394
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1293
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.revertAward']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1395
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.revertAward']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1294
1396
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1295
1397
  });
1296
1398
  },
1297
1399
  /**
1298
- * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
1400
+ * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body buyerId 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 + 동일 body 재전송 24시간 캐시 응답 반환.
1401
+ * @summary 협상 점수평가
1402
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1403
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1404
+ * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
1405
+ * @param {*} [options] Override http request option.
1406
+ * @throws {RequiredError}
1407
+ */
1408
+ submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options) {
1409
+ return __awaiter(this, void 0, void 0, function* () {
1410
+ var _a, _b, _c;
1411
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options);
1412
+ const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1413
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.submitNegotiationScores']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1414
+ return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1415
+ });
1416
+ },
1417
+ /**
1418
+ * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
1299
1419
  * @summary 공고 수정
1300
1420
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1301
- * @param {string} ifMatch
1302
- * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 사이 공고가 바뀌었으면 412 거절되며 아무것도 수정되지 않습니다.
1303
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
1421
+ * @param {string} ifMatch 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
1422
+ * @param {string} idempotencyKey 멱등성 (1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1304
1423
  * @param {UpdateBidRequestDto} updateBidRequestDto
1305
1424
  * @param {*} [options] Override http request option.
1306
1425
  * @throws {RequiredError}
1307
1426
  */
1308
- updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options) {
1427
+ updateBid(bidRef, ifMatch, idempotencyKey, updateBidRequestDto, options) {
1309
1428
  return __awaiter(this, void 0, void 0, function* () {
1310
1429
  var _a, _b, _c;
1311
- const localVarAxiosArgs = yield localVarAxiosParamCreator.updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options);
1430
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.updateBid(bidRef, ifMatch, idempotencyKey, updateBidRequestDto, options);
1312
1431
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1313
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.updateBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1432
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.updateBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1314
1433
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1315
1434
  });
1316
1435
  },
1317
1436
  /**
1318
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
1319
- * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
1437
+ * 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
1438
+ * @summary 공고 첨부파일 업로드
1439
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1320
1440
  * @param {UploadFileRequestDto} uploadFileRequestDto
1321
1441
  * @param {*} [options] Override http request option.
1322
1442
  * @throws {RequiredError}
1323
1443
  */
1324
- uploadFile(uploadFileRequestDto, options) {
1444
+ uploadFile(idempotencyKey, uploadFileRequestDto, options) {
1325
1445
  return __awaiter(this, void 0, void 0, function* () {
1326
1446
  var _a, _b, _c;
1327
- const localVarAxiosArgs = yield localVarAxiosParamCreator.uploadFile(uploadFileRequestDto, options);
1447
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.uploadFile(idempotencyKey, uploadFileRequestDto, options);
1328
1448
  const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
1329
- const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerV2Api.uploadFile']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1449
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['PartnerApiApi.uploadFile']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
1330
1450
  return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
1331
1451
  });
1332
1452
  },
1333
1453
  };
1334
1454
  };
1335
- exports.PartnerV2ApiFp = PartnerV2ApiFp;
1455
+ exports.PartnerApiApiFp = PartnerApiApiFp;
1336
1456
  /**
1337
- * PartnerV2Api - factory interface
1457
+ * PartnerApiApi - factory interface
1338
1458
  */
1339
- const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1340
- const localVarFp = (0, exports.PartnerV2ApiFp)(configuration);
1459
+ const PartnerApiApiFactory = function (configuration, basePath, axios) {
1460
+ const localVarFp = (0, exports.PartnerApiApiFp)(configuration);
1341
1461
  return {
1342
1462
  /**
1343
1463
  * 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
1344
1464
  * @summary 공고 취소
1345
1465
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1346
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
1466
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1347
1467
  * @param {CancelBidRequestDto} cancelBidRequestDto
1348
1468
  * @param {*} [options] Override http request option.
1349
1469
  * @throws {RequiredError}
@@ -1352,10 +1472,10 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1352
1472
  return localVarFp.cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options).then((request) => request(axios, basePath));
1353
1473
  },
1354
1474
  /**
1355
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답은 204가 아닌 200입니다 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **V5-compat 안내:** 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자 override(11종)는 modern v2 표면에서 제거됐습니다. 필요 V5 충실 카운터파트 `POST /v1/bids/{bidRef}/acceptance`(`CompleteAcceptanceV1RequestDto`)를 사용하세요. **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1475
+ * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1356
1476
  * @summary 검수완료 전송
1357
1477
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1358
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1478
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1359
1479
  * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
1360
1480
  * @param {*} [options] Override http request option.
1361
1481
  * @throws {RequiredError}
@@ -1365,9 +1485,9 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1365
1485
  },
1366
1486
  /**
1367
1487
  * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1368
- * @summary 정산 마감(송장 강제완료)
1488
+ * @summary 정산 마감
1369
1489
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1370
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간). UUID v4 권장.
1490
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1371
1491
  * @param {*} [options] Override http request option.
1372
1492
  * @throws {RequiredError}
1373
1493
  */
@@ -1375,21 +1495,20 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1375
1495
  return localVarFp.completeInvoice(bidRef, idempotencyKey, options).then((request) => request(axios, basePath));
1376
1496
  },
1377
1497
  /**
1378
- * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
1379
- * @summary 결제창 발행 (구 경로)
1380
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
1381
- * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
1498
+ * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
1499
+ * @summary 결제창 발행
1500
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1501
+ * @param {CreateCardPaymentDto} createCardPaymentDto
1382
1502
  * @param {*} [options] Override http request option.
1383
- * @deprecated
1384
1503
  * @throws {RequiredError}
1385
1504
  */
1386
- createCardPaymentRequest(idempotencyKey, createCardPaymentRequestDto, options) {
1387
- return localVarFp.createCardPaymentRequest(idempotencyKey, createCardPaymentRequestDto, options).then((request) => request(axios, basePath));
1505
+ createCardPayment(idempotencyKey, createCardPaymentDto, options) {
1506
+ return localVarFp.createCardPayment(idempotencyKey, createCardPaymentDto, options).then((request) => request(axios, basePath));
1388
1507
  },
1389
1508
  /**
1390
1509
  * 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
1391
1510
  * @summary 계약서류 생성
1392
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1511
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1393
1512
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
1394
1513
  * @param {*} [options] Override http request option.
1395
1514
  * @throws {RequiredError}
@@ -1398,8 +1517,8 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1398
1517
  return localVarFp.createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options).then((request) => request(axios, basePath));
1399
1518
  },
1400
1519
  /**
1401
- * 무인증 — `fileKey` 자체가 capability 다(V5 `/download/{fileKey}` 같은 보안 모델). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
1402
- * @summary 파일 다운로드 — 안정 URL(302)
1520
+ * 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
1521
+ * @summary 파일 다운로드
1403
1522
  * @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
1404
1523
  * @param {*} [options] Override http request option.
1405
1524
  * @throws {RequiredError}
@@ -1408,7 +1527,7 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1408
1527
  return localVarFp.downloadFile(fileKey, options).then((request) => request(axios, basePath));
1409
1528
  },
1410
1529
  /**
1411
- * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류:** `contractDocuments[].generationState` 는 **관측 전용**입니다. `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태이며 API 로 되살릴 수 없습니다운영에 문의하세요. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1530
+ * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1412
1531
  * @summary 공고 상세 조회
1413
1532
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1414
1533
  * @param {*} [options] Override http request option.
@@ -1418,7 +1537,7 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1418
1537
  return localVarFp.getBid(bidRef, options).then((request) => request(axios, basePath));
1419
1538
  },
1420
1539
  /**
1421
- * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
1540
+ * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
1422
1541
  * @summary 정산 정보 조회
1423
1542
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1424
1543
  * @param {*} [options] Override http request option.
@@ -1440,7 +1559,7 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1440
1559
  },
1441
1560
  /**
1442
1561
  * 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
1443
- * @summary 파일 조회(메타 + 내려받기 주소)
1562
+ * @summary 파일 정보 조회
1444
1563
  * @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
1445
1564
  * @param {*} [options] Override http request option.
1446
1565
  * @throws {RequiredError}
@@ -1459,15 +1578,14 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1459
1578
  return localVarFp.getSemoContractTaxinvoiceStatus(externalContractId, options).then((request) => request(axios, basePath));
1460
1579
  },
1461
1580
  /**
1462
- * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **필수 스코프:** `payments:write` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 신규 연동에 권합니다. 경로도 계속 동작하며 중단 일정은 없습니다.
1463
- * @summary 공급사 카드결제 가능 여부 (구 경로)
1581
+ * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
1582
+ * @summary 공급사 카드결제 가능 여부
1464
1583
  * @param {string} memberId 계약업체 회원 ID
1465
1584
  * @param {*} [options] Override http request option.
1466
- * @deprecated
1467
1585
  * @throws {RequiredError}
1468
1586
  */
1469
- getSupplierCardPayable(memberId, options) {
1470
- return localVarFp.getSupplierCardPayable(memberId, options).then((request) => request(axios, basePath));
1587
+ getSupplierCardPayableV2(memberId, options) {
1588
+ return localVarFp.getSupplierCardPayableV2(memberId, options).then((request) => request(axios, basePath));
1471
1589
  },
1472
1590
  /**
1473
1591
  * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
@@ -1479,28 +1597,28 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1479
1597
  return localVarFp.healthControllerCheck(options).then((request) => request(axios, basePath));
1480
1598
  },
1481
1599
  /**
1482
- * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다. **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요. **단건 조회:** 공고 하나만 볼 때도 `bidIds` 에 하나만 넣거나 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요. 종전의 `GET /v2/bids/{bidRef}/result` 상세 응답의 부분집합이라 폐지됐습니다.
1483
- * @summary 공고 결과 배치 조회
1484
- * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
1600
+ * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
1601
+ * @summary 공고 결과 조회
1602
+ * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60; 를 반복해 전달합니다. 최대 100건입니다.
1485
1603
  * @param {*} [options] Override http request option.
1486
1604
  * @throws {RequiredError}
1487
1605
  */
1488
- listBidResults(bidIds, options) {
1489
- return localVarFp.listBidResults(bidIds, options).then((request) => request(axios, basePath));
1606
+ listBidResults(bidRefs, options) {
1607
+ return localVarFp.listBidResults(bidRefs, options).then((request) => request(axios, basePath));
1490
1608
  },
1491
1609
  /**
1492
1610
  * 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다). **페이지네이션(cursor):** `limit`(1~100, 기본 100) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다. **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
1493
1611
  * @summary 공고 목록 조회
1494
1612
  * @param {number} [limit] 페이지 크기(1~100, 기본 100).
1495
1613
  * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
1496
- * @param {Array<string>} [bidIds] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
1497
- * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다.
1614
+ * @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
1615
+ * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
1498
1616
  * @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
1499
1617
  * @param {*} [options] Override http request option.
1500
1618
  * @throws {RequiredError}
1501
1619
  */
1502
- listBids(limit, cursor, bidIds, status, include, options) {
1503
- return localVarFp.listBids(limit, cursor, bidIds, status, include, options).then((request) => request(axios, basePath));
1620
+ listBids(limit, cursor, bidRefs, status, include, options) {
1621
+ return localVarFp.listBids(limit, cursor, bidRefs, status, include, options).then((request) => request(axios, basePath));
1504
1622
  },
1505
1623
  /**
1506
1624
  * 발주기관 회원과 거래유형으로 **그 거래에 필요한 계약서류 목록**을 조회합니다. **용도:** 공고(입찰)를 거치지 않는 거래 — 예: 채팅 기반 견적 — 에서 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때. **판정 기준:** 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. **응답 해석:** - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 **미리 체크된 상태로** 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market 이 데이터를 채워 PDF 로 만들어 주는 서류입니다. 생성 API 의 `paperCodes` 에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요. **조회 가능한 회원 범위:** 이 API 키에 설정된 대행 범위(소속 그룹 전원 또는 지정 회원 목록) 안의 회원만 조회할 수 있습니다. 범위 밖이면 403 입니다. 대행 범위는 키 설정이며 스코프와는 별개 축입니다. **필수 스코프:** `contracts:read` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
@@ -1517,7 +1635,7 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1517
1635
  * 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1518
1636
  * @summary 유찰 처리
1519
1637
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1520
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1638
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1521
1639
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
1522
1640
  * @param {*} [options] Override http request option.
1523
1641
  * @throws {RequiredError}
@@ -1529,7 +1647,7 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1529
1647
  * 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
1530
1648
  * @summary 낙찰 결과 전송
1531
1649
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1532
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1650
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1533
1651
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
1534
1652
  * @param {*} [options] Override http request option.
1535
1653
  * @throws {RequiredError}
@@ -1540,7 +1658,7 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1540
1658
  /**
1541
1659
  * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
1542
1660
  * @summary 공고 등록
1543
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 캐시 응답 반환.
1661
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1544
1662
  * @param {CreateBidRequestDto} createBidRequestDto
1545
1663
  * @param {*} [options] Override http request option.
1546
1664
  * @throws {RequiredError}
@@ -1551,7 +1669,7 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1551
1669
  /**
1552
1670
  * 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
1553
1671
  * @summary 계약 발행대상 등록
1554
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
1672
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1555
1673
  * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
1556
1674
  * @param {*} [options] Override http request option.
1557
1675
  * @throws {RequiredError}
@@ -1559,11 +1677,23 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1559
1677
  registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options) {
1560
1678
  return localVarFp.registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options).then((request) => request(axios, basePath));
1561
1679
  },
1680
+ /**
1681
+ * 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
1682
+ * @summary 계산서 분할 발급 청구
1683
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1684
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1685
+ * @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
1686
+ * @param {*} [options] Override http request option.
1687
+ * @throws {RequiredError}
1688
+ */
1689
+ requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options) {
1690
+ return localVarFp.requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options).then((request) => request(axios, basePath));
1691
+ },
1562
1692
  /**
1563
1693
  * 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1564
1694
  * @summary 낙찰 되돌리기
1565
1695
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1566
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
1696
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1567
1697
  * @param {RevertAwardRequestDto} revertAwardRequestDto
1568
1698
  * @param {*} [options] Override http request option.
1569
1699
  * @throws {RequiredError}
@@ -1572,123 +1702,134 @@ const PartnerV2ApiFactory = function (configuration, basePath, axios) {
1572
1702
  return localVarFp.revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options).then((request) => request(axios, basePath));
1573
1703
  },
1574
1704
  /**
1575
- * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
1705
+ * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body buyerId 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 + 동일 body 재전송 24시간 캐시 응답 반환.
1706
+ * @summary 협상 점수평가
1707
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1708
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1709
+ * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
1710
+ * @param {*} [options] Override http request option.
1711
+ * @throws {RequiredError}
1712
+ */
1713
+ submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options) {
1714
+ return localVarFp.submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(axios, basePath));
1715
+ },
1716
+ /**
1717
+ * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
1576
1718
  * @summary 공고 수정
1577
1719
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1578
- * @param {string} ifMatch
1579
- * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 사이 공고가 바뀌었으면 412 거절되며 아무것도 수정되지 않습니다.
1580
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
1720
+ * @param {string} ifMatch 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
1721
+ * @param {string} idempotencyKey 멱등성 (1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1581
1722
  * @param {UpdateBidRequestDto} updateBidRequestDto
1582
1723
  * @param {*} [options] Override http request option.
1583
1724
  * @throws {RequiredError}
1584
1725
  */
1585
- updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options) {
1586
- return localVarFp.updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options).then((request) => request(axios, basePath));
1726
+ updateBid(bidRef, ifMatch, idempotencyKey, updateBidRequestDto, options) {
1727
+ return localVarFp.updateBid(bidRef, ifMatch, idempotencyKey, updateBidRequestDto, options).then((request) => request(axios, basePath));
1587
1728
  },
1588
1729
  /**
1589
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
1590
- * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
1730
+ * 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
1731
+ * @summary 공고 첨부파일 업로드
1732
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1591
1733
  * @param {UploadFileRequestDto} uploadFileRequestDto
1592
1734
  * @param {*} [options] Override http request option.
1593
1735
  * @throws {RequiredError}
1594
1736
  */
1595
- uploadFile(uploadFileRequestDto, options) {
1596
- return localVarFp.uploadFile(uploadFileRequestDto, options).then((request) => request(axios, basePath));
1737
+ uploadFile(idempotencyKey, uploadFileRequestDto, options) {
1738
+ return localVarFp.uploadFile(idempotencyKey, uploadFileRequestDto, options).then((request) => request(axios, basePath));
1597
1739
  },
1598
1740
  };
1599
1741
  };
1600
- exports.PartnerV2ApiFactory = PartnerV2ApiFactory;
1742
+ exports.PartnerApiApiFactory = PartnerApiApiFactory;
1601
1743
  /**
1602
- * PartnerV2Api - object-oriented interface
1744
+ * PartnerApiApi - object-oriented interface
1603
1745
  */
1604
- class PartnerV2Api extends base_1.BaseAPI {
1746
+ class PartnerApiApi extends base_1.BaseAPI {
1605
1747
  /**
1606
1748
  * 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
1607
1749
  * @summary 공고 취소
1608
1750
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1609
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
1751
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1610
1752
  * @param {CancelBidRequestDto} cancelBidRequestDto
1611
1753
  * @param {*} [options] Override http request option.
1612
1754
  * @throws {RequiredError}
1613
1755
  */
1614
1756
  cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options) {
1615
- return (0, exports.PartnerV2ApiFp)(this.configuration).cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options).then((request) => request(this.axios, this.basePath));
1757
+ return (0, exports.PartnerApiApiFp)(this.configuration).cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options).then((request) => request(this.axios, this.basePath));
1616
1758
  }
1617
1759
  /**
1618
- * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **V5 대응:** `acceptanceCompleteSend` — BidApi.xml `acceptanceComplete` 액션의 V6 후속. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답은 204가 아닌 200입니다 멱등성 인터셉터가 구체 바디를 캐시하고 SDK 가 타입드 응답을 필요로 하기 때문. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **V5-compat 안내:** 거래명세서·검수보고서에 찍힐 구매사 사업자정보·담당자·작성일자 override(11종)는 modern v2 표면에서 제거됐습니다. 필요 V5 충실 카운터파트 `POST /v1/bids/{bidRef}/acceptance`(`CompleteAcceptanceV1RequestDto`)를 사용하세요. **낙찰자 식별:** `winnerMemberId`(공급사 memberId). 내부 joinSeq 해소는 backend 가 처리합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1760
+ * 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1619
1761
  * @summary 검수완료 전송
1620
1762
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1621
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1763
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1622
1764
  * @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
1623
1765
  * @param {*} [options] Override http request option.
1624
1766
  * @throws {RequiredError}
1625
1767
  */
1626
1768
  completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options) {
1627
- return (0, exports.PartnerV2ApiFp)(this.configuration).completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
1769
+ return (0, exports.PartnerApiApiFp)(this.configuration).completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
1628
1770
  }
1629
1771
  /**
1630
1772
  * 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1631
- * @summary 정산 마감(송장 강제완료)
1773
+ * @summary 정산 마감
1632
1774
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1633
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간). UUID v4 권장.
1775
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1634
1776
  * @param {*} [options] Override http request option.
1635
1777
  * @throws {RequiredError}
1636
1778
  */
1637
1779
  completeInvoice(bidRef, idempotencyKey, options) {
1638
- return (0, exports.PartnerV2ApiFp)(this.configuration).completeInvoice(bidRef, idempotencyKey, options).then((request) => request(this.axios, this.basePath));
1780
+ return (0, exports.PartnerApiApiFp)(this.configuration).completeInvoice(bidRef, idempotencyKey, options).then((request) => request(this.axios, this.basePath));
1639
1781
  }
1640
1782
  /**
1641
- * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
1642
- * @summary 결제창 발행 (구 경로)
1643
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
1644
- * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
1783
+ * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
1784
+ * @summary 결제창 발행
1785
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1786
+ * @param {CreateCardPaymentDto} createCardPaymentDto
1645
1787
  * @param {*} [options] Override http request option.
1646
- * @deprecated
1647
1788
  * @throws {RequiredError}
1648
1789
  */
1649
- createCardPaymentRequest(idempotencyKey, createCardPaymentRequestDto, options) {
1650
- return (0, exports.PartnerV2ApiFp)(this.configuration).createCardPaymentRequest(idempotencyKey, createCardPaymentRequestDto, options).then((request) => request(this.axios, this.basePath));
1790
+ createCardPayment(idempotencyKey, createCardPaymentDto, options) {
1791
+ return (0, exports.PartnerApiApiFp)(this.configuration).createCardPayment(idempotencyKey, createCardPaymentDto, options).then((request) => request(this.axios, this.basePath));
1651
1792
  }
1652
1793
  /**
1653
1794
  * 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
1654
1795
  * @summary 계약서류 생성
1655
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1796
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1656
1797
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
1657
1798
  * @param {*} [options] Override http request option.
1658
1799
  * @throws {RequiredError}
1659
1800
  */
1660
1801
  createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options) {
1661
- return (0, exports.PartnerV2ApiFp)(this.configuration).createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options).then((request) => request(this.axios, this.basePath));
1802
+ return (0, exports.PartnerApiApiFp)(this.configuration).createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options).then((request) => request(this.axios, this.basePath));
1662
1803
  }
1663
1804
  /**
1664
- * 무인증 — `fileKey` 자체가 capability 다(V5 `/download/{fileKey}` 같은 보안 모델). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
1665
- * @summary 파일 다운로드 — 안정 URL(302)
1805
+ * 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
1806
+ * @summary 파일 다운로드
1666
1807
  * @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(&#x60;POST /v1|/v2/files&#x60;) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
1667
1808
  * @param {*} [options] Override http request option.
1668
1809
  * @throws {RequiredError}
1669
1810
  */
1670
1811
  downloadFile(fileKey, options) {
1671
- return (0, exports.PartnerV2ApiFp)(this.configuration).downloadFile(fileKey, options).then((request) => request(this.axios, this.basePath));
1812
+ return (0, exports.PartnerApiApiFp)(this.configuration).downloadFile(fileKey, options).then((request) => request(this.axios, this.basePath));
1672
1813
  }
1673
1814
  /**
1674
- * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류:** `contractDocuments[].generationState` 는 **관측 전용**입니다. `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태이며 API 로 되살릴 수 없습니다운영에 문의하세요. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1815
+ * 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1675
1816
  * @summary 공고 상세 조회
1676
1817
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1677
1818
  * @param {*} [options] Override http request option.
1678
1819
  * @throws {RequiredError}
1679
1820
  */
1680
1821
  getBid(bidRef, options) {
1681
- return (0, exports.PartnerV2ApiFp)(this.configuration).getBid(bidRef, options).then((request) => request(this.axios, this.basePath));
1822
+ return (0, exports.PartnerApiApiFp)(this.configuration).getBid(bidRef, options).then((request) => request(this.axios, this.basePath));
1682
1823
  }
1683
1824
  /**
1684
- * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
1825
+ * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
1685
1826
  * @summary 정산 정보 조회
1686
1827
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1687
1828
  * @param {*} [options] Override http request option.
1688
1829
  * @throws {RequiredError}
1689
1830
  */
1690
1831
  getBidSettlement(bidRef, options) {
1691
- return (0, exports.PartnerV2ApiFp)(this.configuration).getBidSettlement(bidRef, options).then((request) => request(this.axios, this.basePath));
1832
+ return (0, exports.PartnerApiApiFp)(this.configuration).getBidSettlement(bidRef, options).then((request) => request(this.axios, this.basePath));
1692
1833
  }
1693
1834
  /**
1694
1835
  * 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. **필수 스코프:** `invoices:read` — 종전에는 `contracts:read` 를 요구했습니다. 금액이 실리는 정산 계열 문서라 계약서류 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
@@ -1699,17 +1840,17 @@ class PartnerV2Api extends base_1.BaseAPI {
1699
1840
  * @throws {RequiredError}
1700
1841
  */
1701
1842
  getBidStatement(bidRef, paperCode, options) {
1702
- return (0, exports.PartnerV2ApiFp)(this.configuration).getBidStatement(bidRef, paperCode, options).then((request) => request(this.axios, this.basePath));
1843
+ return (0, exports.PartnerApiApiFp)(this.configuration).getBidStatement(bidRef, paperCode, options).then((request) => request(this.axios, this.basePath));
1703
1844
  }
1704
1845
  /**
1705
1846
  * 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
1706
- * @summary 파일 조회(메타 + 내려받기 주소)
1847
+ * @summary 파일 정보 조회
1707
1848
  * @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
1708
1849
  * @param {*} [options] Override http request option.
1709
1850
  * @throws {RequiredError}
1710
1851
  */
1711
1852
  getFileMeta(fileKey, options) {
1712
- return (0, exports.PartnerV2ApiFp)(this.configuration).getFileMeta(fileKey, options).then((request) => request(this.axios, this.basePath));
1853
+ return (0, exports.PartnerApiApiFp)(this.configuration).getFileMeta(fileKey, options).then((request) => request(this.axios, this.basePath));
1713
1854
  }
1714
1855
  /**
1715
1856
  * 등록한 계약의 계산서 발행 상태를 확인합니다. **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API 로 되읽으세요. **필수 스코프:** `contracts:read`
@@ -1719,18 +1860,17 @@ class PartnerV2Api extends base_1.BaseAPI {
1719
1860
  * @throws {RequiredError}
1720
1861
  */
1721
1862
  getSemoContractTaxinvoiceStatus(externalContractId, options) {
1722
- return (0, exports.PartnerV2ApiFp)(this.configuration).getSemoContractTaxinvoiceStatus(externalContractId, options).then((request) => request(this.axios, this.basePath));
1863
+ return (0, exports.PartnerApiApiFp)(this.configuration).getSemoContractTaxinvoiceStatus(externalContractId, options).then((request) => request(this.axios, this.basePath));
1723
1864
  }
1724
1865
  /**
1725
- * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **필수 스코프:** `payments:write` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 신규 연동에 권합니다. 경로도 계속 동작하며 중단 일정은 없습니다.
1726
- * @summary 공급사 카드결제 가능 여부 (구 경로)
1866
+ * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
1867
+ * @summary 공급사 카드결제 가능 여부
1727
1868
  * @param {string} memberId 계약업체 회원 ID
1728
1869
  * @param {*} [options] Override http request option.
1729
- * @deprecated
1730
1870
  * @throws {RequiredError}
1731
1871
  */
1732
- getSupplierCardPayable(memberId, options) {
1733
- return (0, exports.PartnerV2ApiFp)(this.configuration).getSupplierCardPayable(memberId, options).then((request) => request(this.axios, this.basePath));
1872
+ getSupplierCardPayableV2(memberId, options) {
1873
+ return (0, exports.PartnerApiApiFp)(this.configuration).getSupplierCardPayableV2(memberId, options).then((request) => request(this.axios, this.basePath));
1734
1874
  }
1735
1875
  /**
1736
1876
  * ERP 연동 직전 회선·인증 endpoint 동작 확인용.
@@ -1739,31 +1879,31 @@ class PartnerV2Api extends base_1.BaseAPI {
1739
1879
  * @throws {RequiredError}
1740
1880
  */
1741
1881
  healthControllerCheck(options) {
1742
- return (0, exports.PartnerV2ApiFp)(this.configuration).healthControllerCheck(options).then((request) => request(this.axios, this.basePath));
1882
+ return (0, exports.PartnerApiApiFp)(this.configuration).healthControllerCheck(options).then((request) => request(this.axios, this.basePath));
1743
1883
  }
1744
1884
  /**
1745
- * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다. **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요. **단건 조회:** 공고 하나만 볼 때도 `bidIds` 에 하나만 넣거나 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요. 종전의 `GET /v2/bids/{bidRef}/result` 상세 응답의 부분집합이라 폐지됐습니다.
1746
- * @summary 공고 결과 배치 조회
1747
- * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
1885
+ * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
1886
+ * @summary 공고 결과 조회
1887
+ * @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60; 를 반복해 전달합니다. 최대 100건입니다.
1748
1888
  * @param {*} [options] Override http request option.
1749
1889
  * @throws {RequiredError}
1750
1890
  */
1751
- listBidResults(bidIds, options) {
1752
- return (0, exports.PartnerV2ApiFp)(this.configuration).listBidResults(bidIds, options).then((request) => request(this.axios, this.basePath));
1891
+ listBidResults(bidRefs, options) {
1892
+ return (0, exports.PartnerApiApiFp)(this.configuration).listBidResults(bidRefs, options).then((request) => request(this.axios, this.basePath));
1753
1893
  }
1754
1894
  /**
1755
1895
  * 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다). **페이지네이션(cursor):** `limit`(1~100, 기본 100) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다. **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
1756
1896
  * @summary 공고 목록 조회
1757
1897
  * @param {number} [limit] 페이지 크기(1~100, 기본 100).
1758
1898
  * @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달한다. 미지정 시 첫 페이지. &#x60;nextCursor&#x3D;null&#x60; 이면 마지막 페이지다.
1759
- * @param {Array<string>} [bidIds] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
1760
- * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회한다.
1899
+ * @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
1900
+ * @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
1761
1901
  * @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
1762
1902
  * @param {*} [options] Override http request option.
1763
1903
  * @throws {RequiredError}
1764
1904
  */
1765
- listBids(limit, cursor, bidIds, status, include, options) {
1766
- return (0, exports.PartnerV2ApiFp)(this.configuration).listBids(limit, cursor, bidIds, status, include, options).then((request) => request(this.axios, this.basePath));
1905
+ listBids(limit, cursor, bidRefs, status, include, options) {
1906
+ return (0, exports.PartnerApiApiFp)(this.configuration).listBids(limit, cursor, bidRefs, status, include, options).then((request) => request(this.axios, this.basePath));
1767
1907
  }
1768
1908
  /**
1769
1909
  * 발주기관 회원과 거래유형으로 **그 거래에 필요한 계약서류 목록**을 조회합니다. **용도:** 공고(입찰)를 거치지 않는 거래 — 예: 채팅 기반 견적 — 에서 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때. **판정 기준:** 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. **응답 해석:** - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 **미리 체크된 상태로** 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market 이 데이터를 채워 PDF 로 만들어 주는 서류입니다. 생성 API 의 `paperCodes` 에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요. **조회 가능한 회원 범위:** 이 API 키에 설정된 대행 범위(소속 그룹 전원 또는 지정 회원 목록) 안의 회원만 조회할 수 있습니다. 범위 밖이면 403 입니다. 대행 범위는 키 설정이며 스코프와는 별개 축입니다. **필수 스코프:** `contracts:read` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
@@ -1774,92 +1914,116 @@ class PartnerV2Api extends base_1.BaseAPI {
1774
1914
  * @throws {RequiredError}
1775
1915
  */
1776
1916
  listExternalContractDocuments(buyerId, bidType, options) {
1777
- return (0, exports.PartnerV2ApiFp)(this.configuration).listExternalContractDocuments(buyerId, bidType, options).then((request) => request(this.axios, this.basePath));
1917
+ return (0, exports.PartnerApiApiFp)(this.configuration).listExternalContractDocuments(buyerId, bidType, options).then((request) => request(this.axios, this.basePath));
1778
1918
  }
1779
1919
  /**
1780
1920
  * 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
1781
1921
  * @summary 유찰 처리
1782
1922
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1783
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1923
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1784
1924
  * @param {MarkBidFailedRequestDto} markBidFailedRequestDto
1785
1925
  * @param {*} [options] Override http request option.
1786
1926
  * @throws {RequiredError}
1787
1927
  */
1788
1928
  markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options) {
1789
- return (0, exports.PartnerV2ApiFp)(this.configuration).markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
1929
+ return (0, exports.PartnerApiApiFp)(this.configuration).markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
1790
1930
  }
1791
1931
  /**
1792
1932
  * 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
1793
1933
  * @summary 낙찰 결과 전송
1794
1934
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1795
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 + 동일 body 재전송 캐시 응답 반환(24시간). UUID v4 권장.
1935
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1796
1936
  * @param {RegisterAwardRequestDto} registerAwardRequestDto
1797
1937
  * @param {*} [options] Override http request option.
1798
1938
  * @throws {RequiredError}
1799
1939
  */
1800
1940
  registerAward(bidRef, idempotencyKey, registerAwardRequestDto, options) {
1801
- return (0, exports.PartnerV2ApiFp)(this.configuration).registerAward(bidRef, idempotencyKey, registerAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
1941
+ return (0, exports.PartnerApiApiFp)(this.configuration).registerAward(bidRef, idempotencyKey, registerAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
1802
1942
  }
1803
1943
  /**
1804
1944
  * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
1805
1945
  * @summary 공고 등록
1806
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 캐시 응답 반환.
1946
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1807
1947
  * @param {CreateBidRequestDto} createBidRequestDto
1808
1948
  * @param {*} [options] Override http request option.
1809
1949
  * @throws {RequiredError}
1810
1950
  */
1811
1951
  registerBid(idempotencyKey, createBidRequestDto, options) {
1812
- return (0, exports.PartnerV2ApiFp)(this.configuration).registerBid(idempotencyKey, createBidRequestDto, options).then((request) => request(this.axios, this.basePath));
1952
+ return (0, exports.PartnerApiApiFp)(this.configuration).registerBid(idempotencyKey, createBidRequestDto, options).then((request) => request(this.axios, this.basePath));
1813
1953
  }
1814
1954
  /**
1815
1955
  * 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
1816
1956
  * @summary 계약 발행대상 등록
1817
- * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
1957
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1818
1958
  * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
1819
1959
  * @param {*} [options] Override http request option.
1820
1960
  * @throws {RequiredError}
1821
1961
  */
1822
1962
  registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options) {
1823
- return (0, exports.PartnerV2ApiFp)(this.configuration).registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options).then((request) => request(this.axios, this.basePath));
1963
+ return (0, exports.PartnerApiApiFp)(this.configuration).registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options).then((request) => request(this.axios, this.basePath));
1964
+ }
1965
+ /**
1966
+ * 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
1967
+ * @summary 계산서 분할 발급 청구
1968
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1969
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1970
+ * @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
1971
+ * @param {*} [options] Override http request option.
1972
+ * @throws {RequiredError}
1973
+ */
1974
+ requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options) {
1975
+ return (0, exports.PartnerApiApiFp)(this.configuration).requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options).then((request) => request(this.axios, this.basePath));
1824
1976
  }
1825
1977
  /**
1826
1978
  * 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
1827
1979
  * @summary 낙찰 되돌리기
1828
1980
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1829
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일재전송 캐시 응답 반환(24시간).
1981
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1830
1982
  * @param {RevertAwardRequestDto} revertAwardRequestDto
1831
1983
  * @param {*} [options] Override http request option.
1832
1984
  * @throws {RequiredError}
1833
1985
  */
1834
1986
  revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options) {
1835
- return (0, exports.PartnerV2ApiFp)(this.configuration).revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
1987
+ return (0, exports.PartnerApiApiFp)(this.configuration).revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
1988
+ }
1989
+ /**
1990
+ * 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
1991
+ * @summary 협상 점수평가
1992
+ * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1993
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1994
+ * @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
1995
+ * @param {*} [options] Override http request option.
1996
+ * @throws {RequiredError}
1997
+ */
1998
+ submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options) {
1999
+ return (0, exports.PartnerApiApiFp)(this.configuration).submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(this.axios, this.basePath));
1836
2000
  }
1837
2001
  /**
1838
- * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
2002
+ * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
1839
2003
  * @summary 공고 수정
1840
2004
  * @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
1841
- * @param {string} ifMatch
1842
- * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 사이 공고가 바뀌었으면 412 거절되며 아무것도 수정되지 않습니다.
1843
- * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
2005
+ * @param {string} ifMatch 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidRef}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
2006
+ * @param {string} idempotencyKey 멱등성 (1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 + 같은 body 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1844
2007
  * @param {UpdateBidRequestDto} updateBidRequestDto
1845
2008
  * @param {*} [options] Override http request option.
1846
2009
  * @throws {RequiredError}
1847
2010
  */
1848
- updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options) {
1849
- return (0, exports.PartnerV2ApiFp)(this.configuration).updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options).then((request) => request(this.axios, this.basePath));
2011
+ updateBid(bidRef, ifMatch, idempotencyKey, updateBidRequestDto, options) {
2012
+ return (0, exports.PartnerApiApiFp)(this.configuration).updateBid(bidRef, ifMatch, idempotencyKey, updateBidRequestDto, options).then((request) => request(this.axios, this.basePath));
1850
2013
  }
1851
2014
  /**
1852
- * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
1853
- * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
2015
+ * 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
2016
+ * @summary 공고 첨부파일 업로드
2017
+ * @param {string} idempotencyKey 멱등성 키(1~255자, &#x60;[A-Za-z0-9_-]&#x60;). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: &#x60;bid-create-{구매번호}&#x60;)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다.
1854
2018
  * @param {UploadFileRequestDto} uploadFileRequestDto
1855
2019
  * @param {*} [options] Override http request option.
1856
2020
  * @throws {RequiredError}
1857
2021
  */
1858
- uploadFile(uploadFileRequestDto, options) {
1859
- return (0, exports.PartnerV2ApiFp)(this.configuration).uploadFile(uploadFileRequestDto, options).then((request) => request(this.axios, this.basePath));
2022
+ uploadFile(idempotencyKey, uploadFileRequestDto, options) {
2023
+ return (0, exports.PartnerApiApiFp)(this.configuration).uploadFile(idempotencyKey, uploadFileRequestDto, options).then((request) => request(this.axios, this.basePath));
1860
2024
  }
1861
2025
  }
1862
- exports.PartnerV2Api = PartnerV2Api;
2026
+ exports.PartnerApiApi = PartnerApiApi;
1863
2027
  exports.ListBidsIncludeEnum = {
1864
2028
  Results: 'results',
1865
2029
  Products: 'products',