@cmarket/partner-sdk 22.4.1 β†’ 22.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (591) hide show
  1. package/README.md +9 -4
  2. package/api/oauth-api.ts +2 -2
  3. package/api/partner-v1-api.ts +2 -2
  4. package/api/partner-v2-api.ts +174 -14
  5. package/api.ts +2 -2
  6. package/base.ts +2 -2
  7. package/common.ts +2 -2
  8. package/configuration.ts +2 -2
  9. package/dist/api/oauth-api.d.ts +2 -2
  10. package/dist/api/oauth-api.js +2 -2
  11. package/dist/api/partner-v1-api.d.ts +2 -2
  12. package/dist/api/partner-v1-api.js +2 -2
  13. package/dist/api/partner-v2-api.d.ts +85 -14
  14. package/dist/api/partner-v2-api.js +162 -14
  15. package/dist/api.d.ts +2 -2
  16. package/dist/api.js +2 -2
  17. package/dist/base.d.ts +2 -2
  18. package/dist/base.js +2 -2
  19. package/dist/common.d.ts +2 -2
  20. package/dist/common.js +2 -2
  21. package/dist/configuration.d.ts +2 -2
  22. package/dist/configuration.js +2 -2
  23. package/dist/esm/api/oauth-api.d.ts +2 -2
  24. package/dist/esm/api/oauth-api.js +2 -2
  25. package/dist/esm/api/partner-v1-api.d.ts +2 -2
  26. package/dist/esm/api/partner-v1-api.js +2 -2
  27. package/dist/esm/api/partner-v2-api.d.ts +85 -14
  28. package/dist/esm/api/partner-v2-api.js +162 -14
  29. package/dist/esm/api.d.ts +2 -2
  30. package/dist/esm/api.js +2 -2
  31. package/dist/esm/base.d.ts +2 -2
  32. package/dist/esm/base.js +2 -2
  33. package/dist/esm/common.d.ts +2 -2
  34. package/dist/esm/common.js +2 -2
  35. package/dist/esm/configuration.d.ts +2 -2
  36. package/dist/esm/configuration.js +2 -2
  37. package/dist/esm/index.d.ts +2 -2
  38. package/dist/esm/index.js +2 -2
  39. package/dist/esm/models/acceptance-result-response-dto.d.ts +2 -2
  40. package/dist/esm/models/acceptance-result-response-dto.js +2 -2
  41. package/dist/esm/models/acceptance-result-v1-response-dto.d.ts +2 -2
  42. package/dist/esm/models/acceptance-result-v1-response-dto.js +2 -2
  43. package/dist/esm/models/acknowledge-products-v1-request-dto.d.ts +2 -2
  44. package/dist/esm/models/acknowledge-products-v1-request-dto.js +2 -2
  45. package/dist/esm/models/award-method-public.d.ts +2 -2
  46. package/dist/esm/models/award-method-public.js +2 -2
  47. package/dist/esm/models/award-registered-response-dto.d.ts +2 -2
  48. package/dist/esm/models/award-registered-response-dto.js +2 -2
  49. package/dist/esm/models/award-registered-v2-response-dto.d.ts +2 -2
  50. package/dist/esm/models/award-registered-v2-response-dto.js +2 -2
  51. package/dist/esm/models/bid-attachment-v1-dto.d.ts +2 -2
  52. package/dist/esm/models/bid-attachment-v1-dto.js +2 -2
  53. package/dist/esm/models/bid-bond-dto.d.ts +2 -2
  54. package/dist/esm/models/bid-bond-dto.js +2 -2
  55. package/dist/esm/models/bid-bond-v1-dto.d.ts +2 -2
  56. package/dist/esm/models/bid-bond-v1-dto.js +2 -2
  57. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.d.ts +2 -2
  58. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.js +2 -2
  59. package/dist/esm/models/bid-contract-documents-v1-response-dto.d.ts +2 -2
  60. package/dist/esm/models/bid-contract-documents-v1-response-dto.js +2 -2
  61. package/dist/esm/models/bid-created-response-dto.d.ts +2 -2
  62. package/dist/esm/models/bid-created-response-dto.js +2 -2
  63. package/dist/esm/models/bid-detail-response-dto.d.ts +2 -2
  64. package/dist/esm/models/bid-detail-response-dto.js +2 -2
  65. package/dist/esm/models/bid-document-dto.d.ts +2 -2
  66. package/dist/esm/models/bid-document-dto.js +2 -2
  67. package/dist/esm/models/bid-document-v1-dto.d.ts +2 -2
  68. package/dist/esm/models/bid-document-v1-dto.js +2 -2
  69. package/dist/esm/models/bid-failed-response-dto.d.ts +2 -2
  70. package/dist/esm/models/bid-failed-response-dto.js +2 -2
  71. package/dist/esm/models/bid-failed-v2-response-dto.d.ts +2 -2
  72. package/dist/esm/models/bid-failed-v2-response-dto.js +2 -2
  73. package/dist/esm/models/bid-failure-reason.d.ts +2 -2
  74. package/dist/esm/models/bid-failure-reason.js +2 -2
  75. package/dist/esm/models/bid-item-dto.d.ts +2 -2
  76. package/dist/esm/models/bid-item-dto.js +2 -2
  77. package/dist/esm/models/bid-item-v1-dto.d.ts +2 -2
  78. package/dist/esm/models/bid-item-v1-dto.js +2 -2
  79. package/dist/esm/models/bid-lifecycle-dto.d.ts +2 -2
  80. package/dist/esm/models/bid-lifecycle-dto.js +2 -2
  81. package/dist/esm/models/bid-manager-dto.d.ts +2 -2
  82. package/dist/esm/models/bid-manager-dto.js +2 -2
  83. package/dist/esm/models/bid-manager-v1-dto.d.ts +2 -2
  84. package/dist/esm/models/bid-manager-v1-dto.js +2 -2
  85. package/dist/esm/models/bid-participant-summary-dto.d.ts +2 -2
  86. package/dist/esm/models/bid-participant-summary-dto.js +2 -2
  87. package/dist/esm/models/bid-public-status.d.ts +2 -2
  88. package/dist/esm/models/bid-public-status.js +2 -2
  89. package/dist/esm/models/bid-published-response-dto.d.ts +2 -2
  90. package/dist/esm/models/bid-published-response-dto.js +2 -2
  91. package/dist/esm/models/bid-registered-response-dto.d.ts +2 -2
  92. package/dist/esm/models/bid-registered-response-dto.js +2 -2
  93. package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +2 -2
  94. package/dist/esm/models/bid-result-participant-attachment-dto.js +2 -2
  95. package/dist/esm/models/bid-result-participant-dto.d.ts +2 -2
  96. package/dist/esm/models/bid-result-participant-dto.js +2 -2
  97. package/dist/esm/models/bid-result-v1-attachment-dto.d.ts +2 -2
  98. package/dist/esm/models/bid-result-v1-attachment-dto.js +2 -2
  99. package/dist/esm/models/bid-result-v1-bid-product-info-dto.d.ts +2 -2
  100. package/dist/esm/models/bid-result-v1-bid-product-info-dto.js +2 -2
  101. package/dist/esm/models/bid-result-v1-participant-dto.d.ts +2 -2
  102. package/dist/esm/models/bid-result-v1-participant-dto.js +2 -2
  103. package/dist/esm/models/bid-result-v1-product-dto.d.ts +2 -2
  104. package/dist/esm/models/bid-result-v1-product-dto.js +2 -2
  105. package/dist/esm/models/bid-results-batch-v1-request-dto.d.ts +2 -2
  106. package/dist/esm/models/bid-results-batch-v1-request-dto.js +2 -2
  107. package/dist/esm/models/bid-results-response-dto.d.ts +2 -2
  108. package/dist/esm/models/bid-results-response-dto.js +2 -2
  109. package/dist/esm/models/bid-results-v1-response-dto.d.ts +2 -2
  110. package/dist/esm/models/bid-results-v1-response-dto.js +2 -2
  111. package/dist/esm/models/bid-settlement-line-item-dto.d.ts +2 -2
  112. package/dist/esm/models/bid-settlement-line-item-dto.js +2 -2
  113. package/dist/esm/models/bid-settlement-participant-dto.d.ts +2 -2
  114. package/dist/esm/models/bid-settlement-participant-dto.js +2 -2
  115. package/dist/esm/models/bid-settlement-response-dto.d.ts +2 -2
  116. package/dist/esm/models/bid-settlement-response-dto.js +2 -2
  117. package/dist/esm/models/bid-statement-response-dto.d.ts +2 -2
  118. package/dist/esm/models/bid-statement-response-dto.js +2 -2
  119. package/dist/esm/models/bid-statement-v1-response-dto.d.ts +2 -2
  120. package/dist/esm/models/bid-statement-v1-response-dto.js +2 -2
  121. package/dist/esm/models/bid-status.d.ts +2 -2
  122. package/dist/esm/models/bid-status.js +2 -2
  123. package/dist/esm/models/bid-summary-dto.d.ts +2 -2
  124. package/dist/esm/models/bid-summary-dto.js +2 -2
  125. package/dist/esm/models/bid-updated-response-dto.d.ts +2 -2
  126. package/dist/esm/models/bid-updated-response-dto.js +2 -2
  127. package/dist/esm/models/card-payment-request-response-dto.d.ts +2 -2
  128. package/dist/esm/models/card-payment-request-response-dto.js +2 -2
  129. package/dist/esm/models/close-sandbox-bid-response-dto.d.ts +2 -2
  130. package/dist/esm/models/close-sandbox-bid-response-dto.js +2 -2
  131. package/dist/esm/models/complete-acceptance-request-dto.d.ts +2 -2
  132. package/dist/esm/models/complete-acceptance-request-dto.js +2 -2
  133. package/dist/esm/models/complete-acceptance-v1-request-dto.d.ts +2 -2
  134. package/dist/esm/models/complete-acceptance-v1-request-dto.js +2 -2
  135. package/dist/esm/models/contract-document-item-dto.d.ts +2 -2
  136. package/dist/esm/models/contract-document-item-dto.js +2 -2
  137. package/dist/esm/models/contract-documents-regenerated-response-dto.d.ts +2 -2
  138. package/dist/esm/models/contract-documents-regenerated-response-dto.js +2 -2
  139. package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  140. package/dist/esm/models/contract-restriction-confirm-input-dto.js +2 -2
  141. package/dist/esm/models/create-bid-request-dto.d.ts +2 -2
  142. package/dist/esm/models/create-bid-request-dto.js +2 -2
  143. package/dist/esm/models/create-bid-v1-request-dto.d.ts +2 -2
  144. package/dist/esm/models/create-bid-v1-request-dto.js +2 -2
  145. package/dist/esm/models/create-card-payment-request-dto.d.ts +2 -2
  146. package/dist/esm/models/create-card-payment-request-dto.js +2 -2
  147. package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +2 -2
  148. package/dist/esm/models/create-external-contract-documents-request-dto.js +2 -2
  149. package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +2 -2
  150. package/dist/esm/models/create-external-contract-documents-response-dto.js +2 -2
  151. package/dist/esm/models/embed-launch-request-dto.d.ts +2 -2
  152. package/dist/esm/models/embed-launch-request-dto.js +2 -2
  153. package/dist/esm/models/embed-launch-response-dto.d.ts +2 -2
  154. package/dist/esm/models/embed-launch-response-dto.js +2 -2
  155. package/dist/esm/models/external-contract-document-item-dto.d.ts +2 -2
  156. package/dist/esm/models/external-contract-document-item-dto.js +2 -2
  157. package/dist/esm/models/external-contract-documents-response-dto.d.ts +2 -2
  158. package/dist/esm/models/external-contract-documents-response-dto.js +2 -2
  159. package/dist/esm/models/external-contract-item-dto.d.ts +2 -2
  160. package/dist/esm/models/external-contract-item-dto.js +2 -2
  161. package/dist/esm/models/external-contract-snapshot-dto.d.ts +2 -2
  162. package/dist/esm/models/external-contract-snapshot-dto.js +2 -2
  163. package/dist/esm/models/external-document-inputs-dto.d.ts +2 -2
  164. package/dist/esm/models/external-document-inputs-dto.js +2 -2
  165. package/dist/esm/models/file-uploaded-response-dto.d.ts +2 -2
  166. package/dist/esm/models/file-uploaded-response-dto.js +2 -2
  167. package/dist/esm/models/file-uploaded-v1-response-dto.d.ts +2 -2
  168. package/dist/esm/models/file-uploaded-v1-response-dto.js +2 -2
  169. package/dist/esm/models/generated-external-contract-document-dto.d.ts +2 -2
  170. package/dist/esm/models/generated-external-contract-document-dto.js +2 -2
  171. package/dist/esm/models/health-response-dto.d.ts +2 -2
  172. package/dist/esm/models/health-response-dto.js +2 -2
  173. package/dist/esm/models/hierarchical-region-dto.d.ts +2 -2
  174. package/dist/esm/models/hierarchical-region-dto.js +2 -2
  175. package/dist/esm/models/hierarchical-region-v1-dto.d.ts +2 -2
  176. package/dist/esm/models/hierarchical-region-v1-dto.js +2 -2
  177. package/dist/esm/models/index.d.ts +3 -0
  178. package/dist/esm/models/index.js +3 -0
  179. package/dist/esm/models/invalid-param-dto.d.ts +2 -2
  180. package/dist/esm/models/invalid-param-dto.js +2 -2
  181. package/dist/esm/models/invoice-completed-response-dto.d.ts +2 -2
  182. package/dist/esm/models/invoice-completed-response-dto.js +2 -2
  183. package/dist/esm/models/issue-tax-invoice-request-dto.d.ts +2 -2
  184. package/dist/esm/models/issue-tax-invoice-request-dto.js +2 -2
  185. package/dist/esm/models/list-bids-response-dto.d.ts +2 -2
  186. package/dist/esm/models/list-bids-response-dto.js +2 -2
  187. package/dist/esm/models/mark-bid-failed-request-dto.d.ts +2 -2
  188. package/dist/esm/models/mark-bid-failed-request-dto.js +2 -2
  189. package/dist/esm/models/mark-bid-failed-v1-request-dto.d.ts +2 -2
  190. package/dist/esm/models/mark-bid-failed-v1-request-dto.js +2 -2
  191. package/dist/esm/models/negotiation-score-dto.d.ts +2 -2
  192. package/dist/esm/models/negotiation-score-dto.js +2 -2
  193. package/dist/esm/models/negotiation-score-v1-dto.d.ts +2 -2
  194. package/dist/esm/models/negotiation-score-v1-dto.js +2 -2
  195. package/dist/esm/models/negotiation-scored-response-dto.d.ts +2 -2
  196. package/dist/esm/models/negotiation-scored-response-dto.js +2 -2
  197. package/dist/esm/models/negotiation-scored-v2-response-dto.d.ts +2 -2
  198. package/dist/esm/models/negotiation-scored-v2-response-dto.js +2 -2
  199. package/dist/esm/models/oauth-error-response-dto.d.ts +2 -2
  200. package/dist/esm/models/oauth-error-response-dto.js +2 -2
  201. package/dist/esm/models/preconditions-dto.d.ts +2 -2
  202. package/dist/esm/models/preconditions-dto.js +2 -2
  203. package/dist/esm/models/preconditions-v1-dto.d.ts +2 -2
  204. package/dist/esm/models/preconditions-v1-dto.js +2 -2
  205. package/dist/esm/models/problem-details-dto.d.ts +2 -2
  206. package/dist/esm/models/problem-details-dto.js +2 -2
  207. package/dist/esm/models/product-receipt-v1-response-dto.d.ts +2 -2
  208. package/dist/esm/models/product-receipt-v1-response-dto.js +2 -2
  209. package/dist/esm/models/product-v1-response-dto.d.ts +2 -2
  210. package/dist/esm/models/product-v1-response-dto.js +2 -2
  211. package/dist/esm/models/register-award-request-dto.d.ts +2 -2
  212. package/dist/esm/models/register-award-request-dto.js +2 -2
  213. package/dist/esm/models/register-award-v1-request-dto.d.ts +2 -2
  214. package/dist/esm/models/register-award-v1-request-dto.js +2 -2
  215. package/dist/esm/models/register-semo-contract-request-dto.d.ts +62 -0
  216. package/dist/esm/models/register-semo-contract-request-dto.js +17 -0
  217. package/dist/esm/models/request-split-invoice-v1-request-dto.d.ts +2 -2
  218. package/dist/esm/models/request-split-invoice-v1-request-dto.js +2 -2
  219. package/dist/esm/models/retiree-roster-input-dto.d.ts +2 -2
  220. package/dist/esm/models/retiree-roster-input-dto.js +2 -2
  221. package/dist/esm/models/retiree-roster-row-dto.d.ts +2 -2
  222. package/dist/esm/models/retiree-roster-row-dto.js +2 -2
  223. package/dist/esm/models/semo-contract-registered-response-dto.d.ts +25 -0
  224. package/dist/esm/models/semo-contract-registered-response-dto.js +14 -0
  225. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +43 -0
  226. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +18 -0
  227. package/dist/esm/models/split-invoice-v1-response-dto.d.ts +2 -2
  228. package/dist/esm/models/split-invoice-v1-response-dto.js +2 -2
  229. package/dist/esm/models/statement-document-dto.d.ts +2 -2
  230. package/dist/esm/models/statement-document-dto.js +2 -2
  231. package/dist/esm/models/statement-product-dto.d.ts +2 -2
  232. package/dist/esm/models/statement-product-dto.js +2 -2
  233. package/dist/esm/models/statement-v1-document-dto.d.ts +2 -2
  234. package/dist/esm/models/statement-v1-document-dto.js +2 -2
  235. package/dist/esm/models/statement-v1-product-dto.d.ts +2 -2
  236. package/dist/esm/models/statement-v1-product-dto.js +2 -2
  237. package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +2 -2
  238. package/dist/esm/models/submit-negotiation-scores-request-dto.js +2 -2
  239. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +2 -2
  240. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +2 -2
  241. package/dist/esm/models/supplier-card-payable-response-dto.d.ts +2 -2
  242. package/dist/esm/models/supplier-card-payable-response-dto.js +2 -2
  243. package/dist/esm/models/supplier-tax-type.d.ts +2 -2
  244. package/dist/esm/models/supplier-tax-type.js +2 -2
  245. package/dist/esm/models/tax-invoice-issued-response-dto.d.ts +2 -2
  246. package/dist/esm/models/tax-invoice-issued-response-dto.js +2 -2
  247. package/dist/esm/models/token-request-dto.d.ts +2 -2
  248. package/dist/esm/models/token-request-dto.js +2 -2
  249. package/dist/esm/models/token-response-dto.d.ts +2 -2
  250. package/dist/esm/models/token-response-dto.js +2 -2
  251. package/dist/esm/models/update-bid-request-dto.d.ts +2 -2
  252. package/dist/esm/models/update-bid-request-dto.js +2 -2
  253. package/dist/esm/models/upload-file-request-dto.d.ts +2 -2
  254. package/dist/esm/models/upload-file-request-dto.js +2 -2
  255. package/dist/esm/models/upload-file-v1-request-dto.d.ts +2 -2
  256. package/dist/esm/models/upload-file-v1-request-dto.js +2 -2
  257. package/dist/index.d.ts +2 -2
  258. package/dist/index.js +2 -2
  259. package/dist/models/acceptance-result-response-dto.d.ts +2 -2
  260. package/dist/models/acceptance-result-response-dto.js +2 -2
  261. package/dist/models/acceptance-result-v1-response-dto.d.ts +2 -2
  262. package/dist/models/acceptance-result-v1-response-dto.js +2 -2
  263. package/dist/models/acknowledge-products-v1-request-dto.d.ts +2 -2
  264. package/dist/models/acknowledge-products-v1-request-dto.js +2 -2
  265. package/dist/models/award-method-public.d.ts +2 -2
  266. package/dist/models/award-method-public.js +2 -2
  267. package/dist/models/award-registered-response-dto.d.ts +2 -2
  268. package/dist/models/award-registered-response-dto.js +2 -2
  269. package/dist/models/award-registered-v2-response-dto.d.ts +2 -2
  270. package/dist/models/award-registered-v2-response-dto.js +2 -2
  271. package/dist/models/bid-attachment-v1-dto.d.ts +2 -2
  272. package/dist/models/bid-attachment-v1-dto.js +2 -2
  273. package/dist/models/bid-bond-dto.d.ts +2 -2
  274. package/dist/models/bid-bond-dto.js +2 -2
  275. package/dist/models/bid-bond-v1-dto.d.ts +2 -2
  276. package/dist/models/bid-bond-v1-dto.js +2 -2
  277. package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +2 -2
  278. package/dist/models/bid-contract-documents-batch-v1-request-dto.js +2 -2
  279. package/dist/models/bid-contract-documents-v1-response-dto.d.ts +2 -2
  280. package/dist/models/bid-contract-documents-v1-response-dto.js +2 -2
  281. package/dist/models/bid-created-response-dto.d.ts +2 -2
  282. package/dist/models/bid-created-response-dto.js +2 -2
  283. package/dist/models/bid-detail-response-dto.d.ts +2 -2
  284. package/dist/models/bid-detail-response-dto.js +2 -2
  285. package/dist/models/bid-document-dto.d.ts +2 -2
  286. package/dist/models/bid-document-dto.js +2 -2
  287. package/dist/models/bid-document-v1-dto.d.ts +2 -2
  288. package/dist/models/bid-document-v1-dto.js +2 -2
  289. package/dist/models/bid-failed-response-dto.d.ts +2 -2
  290. package/dist/models/bid-failed-response-dto.js +2 -2
  291. package/dist/models/bid-failed-v2-response-dto.d.ts +2 -2
  292. package/dist/models/bid-failed-v2-response-dto.js +2 -2
  293. package/dist/models/bid-failure-reason.d.ts +2 -2
  294. package/dist/models/bid-failure-reason.js +2 -2
  295. package/dist/models/bid-item-dto.d.ts +2 -2
  296. package/dist/models/bid-item-dto.js +2 -2
  297. package/dist/models/bid-item-v1-dto.d.ts +2 -2
  298. package/dist/models/bid-item-v1-dto.js +2 -2
  299. package/dist/models/bid-lifecycle-dto.d.ts +2 -2
  300. package/dist/models/bid-lifecycle-dto.js +2 -2
  301. package/dist/models/bid-manager-dto.d.ts +2 -2
  302. package/dist/models/bid-manager-dto.js +2 -2
  303. package/dist/models/bid-manager-v1-dto.d.ts +2 -2
  304. package/dist/models/bid-manager-v1-dto.js +2 -2
  305. package/dist/models/bid-participant-summary-dto.d.ts +2 -2
  306. package/dist/models/bid-participant-summary-dto.js +2 -2
  307. package/dist/models/bid-public-status.d.ts +2 -2
  308. package/dist/models/bid-public-status.js +2 -2
  309. package/dist/models/bid-published-response-dto.d.ts +2 -2
  310. package/dist/models/bid-published-response-dto.js +2 -2
  311. package/dist/models/bid-registered-response-dto.d.ts +2 -2
  312. package/dist/models/bid-registered-response-dto.js +2 -2
  313. package/dist/models/bid-result-participant-attachment-dto.d.ts +2 -2
  314. package/dist/models/bid-result-participant-attachment-dto.js +2 -2
  315. package/dist/models/bid-result-participant-dto.d.ts +2 -2
  316. package/dist/models/bid-result-participant-dto.js +2 -2
  317. package/dist/models/bid-result-v1-attachment-dto.d.ts +2 -2
  318. package/dist/models/bid-result-v1-attachment-dto.js +2 -2
  319. package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +2 -2
  320. package/dist/models/bid-result-v1-bid-product-info-dto.js +2 -2
  321. package/dist/models/bid-result-v1-participant-dto.d.ts +2 -2
  322. package/dist/models/bid-result-v1-participant-dto.js +2 -2
  323. package/dist/models/bid-result-v1-product-dto.d.ts +2 -2
  324. package/dist/models/bid-result-v1-product-dto.js +2 -2
  325. package/dist/models/bid-results-batch-v1-request-dto.d.ts +2 -2
  326. package/dist/models/bid-results-batch-v1-request-dto.js +2 -2
  327. package/dist/models/bid-results-response-dto.d.ts +2 -2
  328. package/dist/models/bid-results-response-dto.js +2 -2
  329. package/dist/models/bid-results-v1-response-dto.d.ts +2 -2
  330. package/dist/models/bid-results-v1-response-dto.js +2 -2
  331. package/dist/models/bid-settlement-line-item-dto.d.ts +2 -2
  332. package/dist/models/bid-settlement-line-item-dto.js +2 -2
  333. package/dist/models/bid-settlement-participant-dto.d.ts +2 -2
  334. package/dist/models/bid-settlement-participant-dto.js +2 -2
  335. package/dist/models/bid-settlement-response-dto.d.ts +2 -2
  336. package/dist/models/bid-settlement-response-dto.js +2 -2
  337. package/dist/models/bid-statement-response-dto.d.ts +2 -2
  338. package/dist/models/bid-statement-response-dto.js +2 -2
  339. package/dist/models/bid-statement-v1-response-dto.d.ts +2 -2
  340. package/dist/models/bid-statement-v1-response-dto.js +2 -2
  341. package/dist/models/bid-status.d.ts +2 -2
  342. package/dist/models/bid-status.js +2 -2
  343. package/dist/models/bid-summary-dto.d.ts +2 -2
  344. package/dist/models/bid-summary-dto.js +2 -2
  345. package/dist/models/bid-updated-response-dto.d.ts +2 -2
  346. package/dist/models/bid-updated-response-dto.js +2 -2
  347. package/dist/models/card-payment-request-response-dto.d.ts +2 -2
  348. package/dist/models/card-payment-request-response-dto.js +2 -2
  349. package/dist/models/close-sandbox-bid-response-dto.d.ts +2 -2
  350. package/dist/models/close-sandbox-bid-response-dto.js +2 -2
  351. package/dist/models/complete-acceptance-request-dto.d.ts +2 -2
  352. package/dist/models/complete-acceptance-request-dto.js +2 -2
  353. package/dist/models/complete-acceptance-v1-request-dto.d.ts +2 -2
  354. package/dist/models/complete-acceptance-v1-request-dto.js +2 -2
  355. package/dist/models/contract-document-item-dto.d.ts +2 -2
  356. package/dist/models/contract-document-item-dto.js +2 -2
  357. package/dist/models/contract-documents-regenerated-response-dto.d.ts +2 -2
  358. package/dist/models/contract-documents-regenerated-response-dto.js +2 -2
  359. package/dist/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  360. package/dist/models/contract-restriction-confirm-input-dto.js +2 -2
  361. package/dist/models/create-bid-request-dto.d.ts +2 -2
  362. package/dist/models/create-bid-request-dto.js +2 -2
  363. package/dist/models/create-bid-v1-request-dto.d.ts +2 -2
  364. package/dist/models/create-bid-v1-request-dto.js +2 -2
  365. package/dist/models/create-card-payment-request-dto.d.ts +2 -2
  366. package/dist/models/create-card-payment-request-dto.js +2 -2
  367. package/dist/models/create-external-contract-documents-request-dto.d.ts +2 -2
  368. package/dist/models/create-external-contract-documents-request-dto.js +2 -2
  369. package/dist/models/create-external-contract-documents-response-dto.d.ts +2 -2
  370. package/dist/models/create-external-contract-documents-response-dto.js +2 -2
  371. package/dist/models/embed-launch-request-dto.d.ts +2 -2
  372. package/dist/models/embed-launch-request-dto.js +2 -2
  373. package/dist/models/embed-launch-response-dto.d.ts +2 -2
  374. package/dist/models/embed-launch-response-dto.js +2 -2
  375. package/dist/models/external-contract-document-item-dto.d.ts +2 -2
  376. package/dist/models/external-contract-document-item-dto.js +2 -2
  377. package/dist/models/external-contract-documents-response-dto.d.ts +2 -2
  378. package/dist/models/external-contract-documents-response-dto.js +2 -2
  379. package/dist/models/external-contract-item-dto.d.ts +2 -2
  380. package/dist/models/external-contract-item-dto.js +2 -2
  381. package/dist/models/external-contract-snapshot-dto.d.ts +2 -2
  382. package/dist/models/external-contract-snapshot-dto.js +2 -2
  383. package/dist/models/external-document-inputs-dto.d.ts +2 -2
  384. package/dist/models/external-document-inputs-dto.js +2 -2
  385. package/dist/models/file-uploaded-response-dto.d.ts +2 -2
  386. package/dist/models/file-uploaded-response-dto.js +2 -2
  387. package/dist/models/file-uploaded-v1-response-dto.d.ts +2 -2
  388. package/dist/models/file-uploaded-v1-response-dto.js +2 -2
  389. package/dist/models/generated-external-contract-document-dto.d.ts +2 -2
  390. package/dist/models/generated-external-contract-document-dto.js +2 -2
  391. package/dist/models/health-response-dto.d.ts +2 -2
  392. package/dist/models/health-response-dto.js +2 -2
  393. package/dist/models/hierarchical-region-dto.d.ts +2 -2
  394. package/dist/models/hierarchical-region-dto.js +2 -2
  395. package/dist/models/hierarchical-region-v1-dto.d.ts +2 -2
  396. package/dist/models/hierarchical-region-v1-dto.js +2 -2
  397. package/dist/models/index.d.ts +3 -0
  398. package/dist/models/index.js +3 -0
  399. package/dist/models/invalid-param-dto.d.ts +2 -2
  400. package/dist/models/invalid-param-dto.js +2 -2
  401. package/dist/models/invoice-completed-response-dto.d.ts +2 -2
  402. package/dist/models/invoice-completed-response-dto.js +2 -2
  403. package/dist/models/issue-tax-invoice-request-dto.d.ts +2 -2
  404. package/dist/models/issue-tax-invoice-request-dto.js +2 -2
  405. package/dist/models/list-bids-response-dto.d.ts +2 -2
  406. package/dist/models/list-bids-response-dto.js +2 -2
  407. package/dist/models/mark-bid-failed-request-dto.d.ts +2 -2
  408. package/dist/models/mark-bid-failed-request-dto.js +2 -2
  409. package/dist/models/mark-bid-failed-v1-request-dto.d.ts +2 -2
  410. package/dist/models/mark-bid-failed-v1-request-dto.js +2 -2
  411. package/dist/models/negotiation-score-dto.d.ts +2 -2
  412. package/dist/models/negotiation-score-dto.js +2 -2
  413. package/dist/models/negotiation-score-v1-dto.d.ts +2 -2
  414. package/dist/models/negotiation-score-v1-dto.js +2 -2
  415. package/dist/models/negotiation-scored-response-dto.d.ts +2 -2
  416. package/dist/models/negotiation-scored-response-dto.js +2 -2
  417. package/dist/models/negotiation-scored-v2-response-dto.d.ts +2 -2
  418. package/dist/models/negotiation-scored-v2-response-dto.js +2 -2
  419. package/dist/models/oauth-error-response-dto.d.ts +2 -2
  420. package/dist/models/oauth-error-response-dto.js +2 -2
  421. package/dist/models/preconditions-dto.d.ts +2 -2
  422. package/dist/models/preconditions-dto.js +2 -2
  423. package/dist/models/preconditions-v1-dto.d.ts +2 -2
  424. package/dist/models/preconditions-v1-dto.js +2 -2
  425. package/dist/models/problem-details-dto.d.ts +2 -2
  426. package/dist/models/problem-details-dto.js +2 -2
  427. package/dist/models/product-receipt-v1-response-dto.d.ts +2 -2
  428. package/dist/models/product-receipt-v1-response-dto.js +2 -2
  429. package/dist/models/product-v1-response-dto.d.ts +2 -2
  430. package/dist/models/product-v1-response-dto.js +2 -2
  431. package/dist/models/register-award-request-dto.d.ts +2 -2
  432. package/dist/models/register-award-request-dto.js +2 -2
  433. package/dist/models/register-award-v1-request-dto.d.ts +2 -2
  434. package/dist/models/register-award-v1-request-dto.js +2 -2
  435. package/dist/models/register-semo-contract-request-dto.d.ts +62 -0
  436. package/dist/models/register-semo-contract-request-dto.js +20 -0
  437. package/dist/models/request-split-invoice-v1-request-dto.d.ts +2 -2
  438. package/dist/models/request-split-invoice-v1-request-dto.js +2 -2
  439. package/dist/models/retiree-roster-input-dto.d.ts +2 -2
  440. package/dist/models/retiree-roster-input-dto.js +2 -2
  441. package/dist/models/retiree-roster-row-dto.d.ts +2 -2
  442. package/dist/models/retiree-roster-row-dto.js +2 -2
  443. package/dist/models/semo-contract-registered-response-dto.d.ts +25 -0
  444. package/dist/models/semo-contract-registered-response-dto.js +15 -0
  445. package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +43 -0
  446. package/dist/models/semo-contract-taxinvoice-status-response-dto.js +21 -0
  447. package/dist/models/split-invoice-v1-response-dto.d.ts +2 -2
  448. package/dist/models/split-invoice-v1-response-dto.js +2 -2
  449. package/dist/models/statement-document-dto.d.ts +2 -2
  450. package/dist/models/statement-document-dto.js +2 -2
  451. package/dist/models/statement-product-dto.d.ts +2 -2
  452. package/dist/models/statement-product-dto.js +2 -2
  453. package/dist/models/statement-v1-document-dto.d.ts +2 -2
  454. package/dist/models/statement-v1-document-dto.js +2 -2
  455. package/dist/models/statement-v1-product-dto.d.ts +2 -2
  456. package/dist/models/statement-v1-product-dto.js +2 -2
  457. package/dist/models/submit-negotiation-scores-request-dto.d.ts +2 -2
  458. package/dist/models/submit-negotiation-scores-request-dto.js +2 -2
  459. package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +2 -2
  460. package/dist/models/submit-negotiation-scores-v1-request-dto.js +2 -2
  461. package/dist/models/supplier-card-payable-response-dto.d.ts +2 -2
  462. package/dist/models/supplier-card-payable-response-dto.js +2 -2
  463. package/dist/models/supplier-tax-type.d.ts +2 -2
  464. package/dist/models/supplier-tax-type.js +2 -2
  465. package/dist/models/tax-invoice-issued-response-dto.d.ts +2 -2
  466. package/dist/models/tax-invoice-issued-response-dto.js +2 -2
  467. package/dist/models/token-request-dto.d.ts +2 -2
  468. package/dist/models/token-request-dto.js +2 -2
  469. package/dist/models/token-response-dto.d.ts +2 -2
  470. package/dist/models/token-response-dto.js +2 -2
  471. package/dist/models/update-bid-request-dto.d.ts +2 -2
  472. package/dist/models/update-bid-request-dto.js +2 -2
  473. package/dist/models/upload-file-request-dto.d.ts +2 -2
  474. package/dist/models/upload-file-request-dto.js +2 -2
  475. package/dist/models/upload-file-v1-request-dto.d.ts +2 -2
  476. package/dist/models/upload-file-v1-request-dto.js +2 -2
  477. package/docs/PartnerV2Api.md +119 -3
  478. package/docs/RegisterSemoContractRequestDto.md +40 -0
  479. package/docs/SemoContractRegisteredResponseDto.md +24 -0
  480. package/docs/SemoContractTaxinvoiceStatusResponseDto.md +30 -0
  481. package/index.ts +2 -2
  482. package/models/acceptance-result-response-dto.ts +2 -2
  483. package/models/acceptance-result-v1-response-dto.ts +2 -2
  484. package/models/acknowledge-products-v1-request-dto.ts +2 -2
  485. package/models/award-method-public.ts +2 -2
  486. package/models/award-registered-response-dto.ts +2 -2
  487. package/models/award-registered-v2-response-dto.ts +2 -2
  488. package/models/bid-attachment-v1-dto.ts +2 -2
  489. package/models/bid-bond-dto.ts +2 -2
  490. package/models/bid-bond-v1-dto.ts +2 -2
  491. package/models/bid-contract-documents-batch-v1-request-dto.ts +2 -2
  492. package/models/bid-contract-documents-v1-response-dto.ts +2 -2
  493. package/models/bid-created-response-dto.ts +2 -2
  494. package/models/bid-detail-response-dto.ts +2 -2
  495. package/models/bid-document-dto.ts +2 -2
  496. package/models/bid-document-v1-dto.ts +2 -2
  497. package/models/bid-failed-response-dto.ts +2 -2
  498. package/models/bid-failed-v2-response-dto.ts +2 -2
  499. package/models/bid-failure-reason.ts +2 -2
  500. package/models/bid-item-dto.ts +2 -2
  501. package/models/bid-item-v1-dto.ts +2 -2
  502. package/models/bid-lifecycle-dto.ts +2 -2
  503. package/models/bid-manager-dto.ts +2 -2
  504. package/models/bid-manager-v1-dto.ts +2 -2
  505. package/models/bid-participant-summary-dto.ts +2 -2
  506. package/models/bid-public-status.ts +2 -2
  507. package/models/bid-published-response-dto.ts +2 -2
  508. package/models/bid-registered-response-dto.ts +2 -2
  509. package/models/bid-result-participant-attachment-dto.ts +2 -2
  510. package/models/bid-result-participant-dto.ts +2 -2
  511. package/models/bid-result-v1-attachment-dto.ts +2 -2
  512. package/models/bid-result-v1-bid-product-info-dto.ts +2 -2
  513. package/models/bid-result-v1-participant-dto.ts +2 -2
  514. package/models/bid-result-v1-product-dto.ts +2 -2
  515. package/models/bid-results-batch-v1-request-dto.ts +2 -2
  516. package/models/bid-results-response-dto.ts +2 -2
  517. package/models/bid-results-v1-response-dto.ts +2 -2
  518. package/models/bid-settlement-line-item-dto.ts +2 -2
  519. package/models/bid-settlement-participant-dto.ts +2 -2
  520. package/models/bid-settlement-response-dto.ts +2 -2
  521. package/models/bid-statement-response-dto.ts +2 -2
  522. package/models/bid-statement-v1-response-dto.ts +2 -2
  523. package/models/bid-status.ts +2 -2
  524. package/models/bid-summary-dto.ts +2 -2
  525. package/models/bid-updated-response-dto.ts +2 -2
  526. package/models/card-payment-request-response-dto.ts +2 -2
  527. package/models/close-sandbox-bid-response-dto.ts +2 -2
  528. package/models/complete-acceptance-request-dto.ts +2 -2
  529. package/models/complete-acceptance-v1-request-dto.ts +2 -2
  530. package/models/contract-document-item-dto.ts +2 -2
  531. package/models/contract-documents-regenerated-response-dto.ts +2 -2
  532. package/models/contract-restriction-confirm-input-dto.ts +2 -2
  533. package/models/create-bid-request-dto.ts +2 -2
  534. package/models/create-bid-v1-request-dto.ts +2 -2
  535. package/models/create-card-payment-request-dto.ts +2 -2
  536. package/models/create-external-contract-documents-request-dto.ts +2 -2
  537. package/models/create-external-contract-documents-response-dto.ts +2 -2
  538. package/models/embed-launch-request-dto.ts +2 -2
  539. package/models/embed-launch-response-dto.ts +2 -2
  540. package/models/external-contract-document-item-dto.ts +2 -2
  541. package/models/external-contract-documents-response-dto.ts +2 -2
  542. package/models/external-contract-item-dto.ts +2 -2
  543. package/models/external-contract-snapshot-dto.ts +2 -2
  544. package/models/external-document-inputs-dto.ts +2 -2
  545. package/models/file-uploaded-response-dto.ts +2 -2
  546. package/models/file-uploaded-v1-response-dto.ts +2 -2
  547. package/models/generated-external-contract-document-dto.ts +2 -2
  548. package/models/health-response-dto.ts +2 -2
  549. package/models/hierarchical-region-dto.ts +2 -2
  550. package/models/hierarchical-region-v1-dto.ts +2 -2
  551. package/models/index.ts +3 -0
  552. package/models/invalid-param-dto.ts +2 -2
  553. package/models/invoice-completed-response-dto.ts +2 -2
  554. package/models/issue-tax-invoice-request-dto.ts +2 -2
  555. package/models/list-bids-response-dto.ts +2 -2
  556. package/models/mark-bid-failed-request-dto.ts +2 -2
  557. package/models/mark-bid-failed-v1-request-dto.ts +2 -2
  558. package/models/negotiation-score-dto.ts +2 -2
  559. package/models/negotiation-score-v1-dto.ts +2 -2
  560. package/models/negotiation-scored-response-dto.ts +2 -2
  561. package/models/negotiation-scored-v2-response-dto.ts +2 -2
  562. package/models/oauth-error-response-dto.ts +2 -2
  563. package/models/preconditions-dto.ts +2 -2
  564. package/models/preconditions-v1-dto.ts +2 -2
  565. package/models/problem-details-dto.ts +2 -2
  566. package/models/product-receipt-v1-response-dto.ts +2 -2
  567. package/models/product-v1-response-dto.ts +2 -2
  568. package/models/register-award-request-dto.ts +2 -2
  569. package/models/register-award-v1-request-dto.ts +2 -2
  570. package/models/register-semo-contract-request-dto.ts +71 -0
  571. package/models/request-split-invoice-v1-request-dto.ts +2 -2
  572. package/models/retiree-roster-input-dto.ts +2 -2
  573. package/models/retiree-roster-row-dto.ts +2 -2
  574. package/models/semo-contract-registered-response-dto.ts +31 -0
  575. package/models/semo-contract-taxinvoice-status-response-dto.ts +52 -0
  576. package/models/split-invoice-v1-response-dto.ts +2 -2
  577. package/models/statement-document-dto.ts +2 -2
  578. package/models/statement-product-dto.ts +2 -2
  579. package/models/statement-v1-document-dto.ts +2 -2
  580. package/models/statement-v1-product-dto.ts +2 -2
  581. package/models/submit-negotiation-scores-request-dto.ts +2 -2
  582. package/models/submit-negotiation-scores-v1-request-dto.ts +2 -2
  583. package/models/supplier-card-payable-response-dto.ts +2 -2
  584. package/models/supplier-tax-type.ts +2 -2
  585. package/models/tax-invoice-issued-response-dto.ts +2 -2
  586. package/models/token-request-dto.ts +2 -2
  587. package/models/token-response-dto.ts +2 -2
  588. package/models/update-bid-request-dto.ts +2 -2
  589. package/models/upload-file-request-dto.ts +2 -2
  590. package/models/upload-file-v1-request-dto.ts +2 -2
  591. package/package.json +1 -1
package/base.ts CHANGED
@@ -2,9 +2,9 @@
2
2
  /* eslint-disable */
3
3
  /**
4
4
  * CMARKET V6 Partner API
5
- * μ™ΈλΆ€ 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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
5
+ * μ™ΈλΆ€ 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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
6
6
  *
7
- * The version of the OpenAPI document: 22.4.1
7
+ * The version of the OpenAPI document: 22.6.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/common.ts CHANGED
@@ -2,9 +2,9 @@
2
2
  /* eslint-disable */
3
3
  /**
4
4
  * CMARKET V6 Partner API
5
- * μ™ΈλΆ€ 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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
5
+ * μ™ΈλΆ€ 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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
6
6
  *
7
- * The version of the OpenAPI document: 22.4.1
7
+ * The version of the OpenAPI document: 22.6.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/configuration.ts CHANGED
@@ -1,9 +1,9 @@
1
1
  /* tslint:disable */
2
2
  /**
3
3
  * CMARKET V6 Partner API
4
- * μ™ΈλΆ€ 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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
+ * μ™ΈλΆ€ 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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
5
5
  *
6
- * The version of the OpenAPI document: 22.4.1
6
+ * The version of the OpenAPI document: 22.6.0
7
7
  * Contact: semo.io.kr@gmail.com
8
8
  *
9
9
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * μ™ΈλΆ€ 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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
3
+ * μ™ΈλΆ€ 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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.4.1
5
+ * The version of the OpenAPI document: 22.6.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
7
7
  *
8
- * The version of the OpenAPI document: 22.4.1
8
+ * The version of the OpenAPI document: 22.6.0
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).
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * μ™ΈλΆ€ 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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
3
+ * μ™ΈλΆ€ 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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.4.1
5
+ * The version of the OpenAPI document: 22.6.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
7
7
  *
8
- * The version of the OpenAPI document: 22.4.1
8
+ * The version of the OpenAPI document: 22.6.0
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).
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * μ™ΈλΆ€ 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) ν—€λ”λ‘œ 전솑. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
3
+ * μ™ΈλΆ€ 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 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.4.1
5
+ * The version of the OpenAPI document: 22.6.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -41,6 +41,9 @@ import type { ListBidsResponseDto } from '../models';
41
41
  import type { MarkBidFailedRequestDto } from '../models';
42
42
  import type { NegotiationScoredV2ResponseDto } from '../models';
43
43
  import type { RegisterAwardRequestDto } from '../models';
44
+ import type { RegisterSemoContractRequestDto } from '../models';
45
+ import type { SemoContractRegisteredResponseDto } from '../models';
46
+ import type { SemoContractTaxinvoiceStatusResponseDto } from '../models';
44
47
  import type { SubmitNegotiationScoresRequestDto } from '../models';
45
48
  import type { SupplierCardPayableResponseDto } from '../models';
46
49
  import type { TaxInvoiceIssuedResponseDto } from '../models';
@@ -78,7 +81,7 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
78
81
  */
79
82
  completeInvoice: (bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
80
83
  /**
81
- * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ `payments:any-member` κ°€ μΆ”κ°€λ‘œ ν•„μš”ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
84
+ * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. μ–΄λŠ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•  수 μžˆλŠ”μ§€λŠ” μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ API ν‚€μ˜ λŒ€ν–‰ λ²”μœ„ 섀정이 μ •ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
82
85
  * @summary 결제창 λ°œν–‰
83
86
  * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
84
87
  * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
@@ -95,7 +98,7 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
95
98
  */
96
99
  createEmbedLaunch: (embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
97
100
  /**
98
- * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 은 λ§Œλ£Œλ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.** μ±„νŒ… λ©”μ‹œμ§€ 등에 κ·ΈλŒ€λ‘œ μ €μž₯ν•΄ 두어도 λ©λ‹ˆλ‹€. **생성 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** μ‘°νšŒμ™€ κ°™μŠ΅λ‹ˆλ‹€ β€” 기본은 λ°”μΈλ”©λœ 발주처뿐이고, ν”Œλž«νΌ ν‚€λŠ” `contracts:any-member` κ°€ ν•„μš”ν•©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜.
101
+ * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 헀더 ν•„μˆ˜.
99
102
  * @summary κ³„μ•½μ„œλ₯˜ 생성
100
103
  * @param {string} idempotencyKey λ©±λ“±μ„± ν‚€(1~255자, [A-Za-z0-9_-]). 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ μΊμ‹œ 응닡 λ°˜ν™˜(24μ‹œκ°„). UUID v4 ꢌμž₯.
101
104
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
@@ -144,6 +147,14 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
144
147
  * @throws {RequiredError}
145
148
  */
146
149
  getBidStatement: (bidId: string, paperCode?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
150
+ /**
151
+ * λ“±λ‘ν•œ κ³„μ•½μ˜ κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœλ₯Ό ν™•μΈν•©λ‹ˆλ‹€. **μ–Έμ œ μ“°λ‚˜:** μ”¨λ§ˆμΌ“μ΄ λ³΄λ‚΄λŠ” λ°œν–‰μ™„λ£Œ 톡지λ₯Ό 놓쳀을 λ•Œμ˜ **볡ꡬ 경둜**μž…λ‹ˆλ‹€. ν‰μƒμ‹œμ—λŠ” 톡지λ₯Ό λ°›μ•„ μ²˜λ¦¬ν•˜κ³ , μƒνƒœκ°€ μ–΄κΈ‹λ‚œ 것 같을 λ•Œ 이 API 둜 λ˜μ½μœΌμ„Έμš”. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
152
+ * @summary κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœ 쑰회
153
+ * @param {string} externalContractId 등둝할 λ•Œ 보낸 νŒŒνŠΈλ„ˆ μΈ‘ 계약 μ‹λ³„μž.
154
+ * @param {*} [options] Override http request option.
155
+ * @throws {RequiredError}
156
+ */
157
+ getSemoContractTaxinvoiceStatus: (externalContractId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
147
158
  /**
148
159
  * 계약업체가 μΉ΄λ“œκ²°μ œλ‘œ λŒ€κΈˆμ„ 받을 수 μžˆλŠ” μƒνƒœμΈμ§€ ν™•μΈν•©λ‹ˆλ‹€(μ”¨λ§ˆμΌ“ νšŒμ› + μΉ΄λ“œκ²°μ œ κ°€λ§Ή). **κ²°μ œμˆ˜λ‹¨μ„ μ‚¬μš©μžμ—κ²Œ 보여주기 전에** ν˜ΈμΆœν•˜μ„Έμš”. λΆˆκ°€ν•œ μ—…μ²΄λ‘œ κ²°μ œμ°½μ„ λ§Œλ“€λ©΄ λ§Œλ“€μ–΄λŠ” μ§€μ§€λ§Œ κ²°μ œκ°€ λ§‰ν˜€, μ‚¬μš©μžκ°€ 막닀λ₯Έ 길에 κ°‡νž™λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`
149
160
  * @summary 곡급사 μΉ΄λ“œκ²°μ œ κ°€λŠ₯ μ—¬λΆ€
@@ -179,7 +190,7 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
179
190
  */
180
191
  listBids: (limit?: number, cursor?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
181
192
  /**
182
- * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 기본은 이 API 킀에 λ°”μΈλ”©λœ λ°œμ£Όμ²˜λΏμž…λ‹ˆλ‹€. μ—¬λŸ¬ λ°œμ£Όμ‚¬λ₯Ό λŒ€μ‹ ν•΄ ν˜ΈμΆœν•˜λŠ” ν”Œλž«νΌ(예: μ±„νŒ… 견적 SaaS)은 `contracts:any-member` μŠ€μ½”ν”„λ₯Ό λ°›μ•„μ•Ό μž„μ˜ νšŒμ›μœΌλ‘œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
193
+ * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 이 API 킀에 μ„€μ •λœ λŒ€ν–‰ λ²”μœ„(μ†Œμ† κ·Έλ£Ή 전원 λ˜λŠ” μ§€μ • νšŒμ› λͺ©λ‘) μ•ˆμ˜ νšŒμ›λ§Œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€ 섀정이며 μŠ€μ½”ν”„μ™€λŠ” λ³„κ°œ μΆ•μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
183
194
  * @summary κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘ 쑰회
184
195
  * @param {string} buyerId λ°œμ£ΌκΈ°κ΄€ νšŒμ› ID(c-market memberId).
185
196
  * @param {ListExternalContractDocumentsBidTypeEnum} bidType κ±°λž˜μœ ν˜•.
@@ -233,6 +244,15 @@ export declare const PartnerV2ApiAxiosParamCreator: (configuration?: Configurati
233
244
  * @throws {RequiredError}
234
245
  */
235
246
  registerBid: (createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
247
+ /**
248
+ * μ™ΈλΆ€μ—μ„œ λ§Ίμ–΄μ§„ 계약 1건을 μ”¨λ§ˆμΌ“μ˜ **μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ λŒ€μƒ**으둜 λ“±λ‘ν•©λ‹ˆλ‹€. **등둝 ν›„ 동선:** λ°œμ£ΌκΈ°κ΄€μ΄ μ”¨λ§ˆμΌ“ [λ‚˜μ˜ 계약 관리] μ—μ„œ κ³„μ‚°μ„œ λ°œκΈ‰μ„ μš”μ²­ν•˜κ³ , 곡급기업이 같은 ν™”λ©΄μ—μ„œ λ°œν–‰ν•©λ‹ˆλ‹€. κ³„μ‚°μ„œμ˜ **κ³΅κΈ‰μžλŠ” 곡급기업, κ³΅κΈ‰λ°›λŠ”μžλŠ” λ°œμ£ΌκΈ°κ΄€**μž…λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μ”¨λ§ˆμΌ“μ€ 이 거래의 λŒ€κΈˆμ„ λ°›μ§€ μ•ŠμŠ΅λ‹ˆλ‹€ β€” λ°œν–‰ 경둜만 μ œκ³΅ν•©λ‹ˆλ‹€. **κΈˆμ•‘:** `supplyPrice` λŠ” **λΆ€κ°€μ„Έλ₯Ό λΊ€ κ³Όμ„Έ 곡급가앑**μž…λ‹ˆλ‹€(결제창 API κ°€ λΆ€κ°€μ„Έ 포함가λ₯Ό λ°›λŠ” 것과 λ‹€λ¦…λ‹ˆλ‹€). κ³Όμ„ΈΒ·λ©΄μ„Έ 곡급가앑이 λͺ¨λ‘ 0 이면 400 μž…λ‹ˆλ‹€. **사전 쑰건:** 두 νšŒμ› ID κ°€ μ”¨λ§ˆμΌ“μ— μ‹€μž¬ν•΄μ•Ό ν•©λ‹ˆλ‹€. νšŒμ› ID κ°€ κ³§ μ†Œμœ κΆŒμ΄λΌ, μ—†λŠ” νšŒμ›μœΌλ‘œ λ“±λ‘ν•˜λ©΄ 아무도 μ—΄ 수 μ—†λŠ” κ³„μ‚°μ„œ λŒ€μƒμ΄ λ©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ λŒ€ν–‰ λ²”μœ„μ— κ·Έ νšŒμ›μ΄ μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalContractId` κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ λŒ€μƒμ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
249
+ * @summary 계약 λ°œν–‰λŒ€μƒ 등둝
250
+ * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
251
+ * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
252
+ * @param {*} [options] Override http request option.
253
+ * @throws {RequiredError}
254
+ */
255
+ registerSemoContract: (idempotencyKey: string, registerSemoContractRequestDto: RegisterSemoContractRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
236
256
  /**
237
257
  * ν˜‘μƒλ°©μ‹(NEGOTIATION/NEGOTIATION_AUTO) 곡고의 μ‘μ°°μžλ³„ 점수λ₯Ό μž…λ ₯ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** μž…μ°° 마감 ν›„ λ‚™μ°°(`POST /v2/bids/{bidId}/award`) μ „. ν˜‘μƒλ°©μ‹ κ³΅κ³ λŠ” 이 평가λ₯Ό μ™„λ£Œν•΄μ•Ό 낙찰에 μ§„μž…ν•  수 μžˆμŠ΅λ‹ˆλ‹€. **λΆ€μˆ˜νš¨κ³Ό:** - μ‘μ°°μžλ³„ 기술점수(및 선택적 κ°€κ²©μ μˆ˜ override)κ°€ κΈ°λ‘λ©λ‹ˆλ‹€. - `complete=true` λ©΄ ν‰κ°€μ™„λ£Œ κ²Œμ΄νŠΈκΉŒμ§€ 적용돼 λ‚™μ°° μ§„μž…μ΄ κ°€λŠ₯ν•΄μ§‘λ‹ˆλ‹€. **발주처:** API 킀에 λ°”μΈλ”©λœ 발주처둜 μžλ™ μŠ€μ½”ν”„λ©λ‹ˆλ‹€(μš”μ²­ body 에 buyerId λ₯Ό λ„£μ§€ μ•ŠμŠ΅λ‹ˆλ‹€). **ν•„μˆ˜ μŠ€μ½”ν”„:** `awards:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜. 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ 24μ‹œκ°„ λ‚΄ μΊμ‹œ 응닡 λ°˜ν™˜.
238
258
  * @summary ν˜‘μƒ μ μˆ˜ν‰κ°€
@@ -294,7 +314,7 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
294
314
  */
295
315
  completeInvoice(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InvoiceCompletedResponseDto>>;
296
316
  /**
297
- * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ `payments:any-member` κ°€ μΆ”κ°€λ‘œ ν•„μš”ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
317
+ * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. μ–΄λŠ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•  수 μžˆλŠ”μ§€λŠ” μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ API ν‚€μ˜ λŒ€ν–‰ λ²”μœ„ 섀정이 μ •ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
298
318
  * @summary 결제창 λ°œν–‰
299
319
  * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
300
320
  * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
@@ -311,7 +331,7 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
311
331
  */
312
332
  createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<EmbedLaunchResponseDto>>;
313
333
  /**
314
- * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 은 λ§Œλ£Œλ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.** μ±„νŒ… λ©”μ‹œμ§€ 등에 κ·ΈλŒ€λ‘œ μ €μž₯ν•΄ 두어도 λ©λ‹ˆλ‹€. **생성 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** μ‘°νšŒμ™€ κ°™μŠ΅λ‹ˆλ‹€ β€” 기본은 λ°”μΈλ”©λœ 발주처뿐이고, ν”Œλž«νΌ ν‚€λŠ” `contracts:any-member` κ°€ ν•„μš”ν•©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜.
334
+ * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 헀더 ν•„μˆ˜.
315
335
  * @summary κ³„μ•½μ„œλ₯˜ 생성
316
336
  * @param {string} idempotencyKey λ©±λ“±μ„± ν‚€(1~255자, [A-Za-z0-9_-]). 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ μΊμ‹œ 응닡 λ°˜ν™˜(24μ‹œκ°„). UUID v4 ꢌμž₯.
317
337
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
@@ -360,6 +380,14 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
360
380
  * @throws {RequiredError}
361
381
  */
362
382
  getBidStatement(bidId: string, paperCode?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidStatementResponseDto>>;
383
+ /**
384
+ * λ“±λ‘ν•œ κ³„μ•½μ˜ κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœλ₯Ό ν™•μΈν•©λ‹ˆλ‹€. **μ–Έμ œ μ“°λ‚˜:** μ”¨λ§ˆμΌ“μ΄ λ³΄λ‚΄λŠ” λ°œν–‰μ™„λ£Œ 톡지λ₯Ό 놓쳀을 λ•Œμ˜ **볡ꡬ 경둜**μž…λ‹ˆλ‹€. ν‰μƒμ‹œμ—λŠ” 톡지λ₯Ό λ°›μ•„ μ²˜λ¦¬ν•˜κ³ , μƒνƒœκ°€ μ–΄κΈ‹λ‚œ 것 같을 λ•Œ 이 API 둜 λ˜μ½μœΌμ„Έμš”. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
385
+ * @summary κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœ 쑰회
386
+ * @param {string} externalContractId 등둝할 λ•Œ 보낸 νŒŒνŠΈλ„ˆ μΈ‘ 계약 μ‹λ³„μž.
387
+ * @param {*} [options] Override http request option.
388
+ * @throws {RequiredError}
389
+ */
390
+ getSemoContractTaxinvoiceStatus(externalContractId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SemoContractTaxinvoiceStatusResponseDto>>;
363
391
  /**
364
392
  * 계약업체가 μΉ΄λ“œκ²°μ œλ‘œ λŒ€κΈˆμ„ 받을 수 μžˆλŠ” μƒνƒœμΈμ§€ ν™•μΈν•©λ‹ˆλ‹€(μ”¨λ§ˆμΌ“ νšŒμ› + μΉ΄λ“œκ²°μ œ κ°€λ§Ή). **κ²°μ œμˆ˜λ‹¨μ„ μ‚¬μš©μžμ—κ²Œ 보여주기 전에** ν˜ΈμΆœν•˜μ„Έμš”. λΆˆκ°€ν•œ μ—…μ²΄λ‘œ κ²°μ œμ°½μ„ λ§Œλ“€λ©΄ λ§Œλ“€μ–΄λŠ” μ§€μ§€λ§Œ κ²°μ œκ°€ λ§‰ν˜€, μ‚¬μš©μžκ°€ 막닀λ₯Έ 길에 κ°‡νž™λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`
365
393
  * @summary 곡급사 μΉ΄λ“œκ²°μ œ κ°€λŠ₯ μ—¬λΆ€
@@ -395,7 +423,7 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
395
423
  */
396
424
  listBids(limit?: number, cursor?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListBidsResponseDto>>;
397
425
  /**
398
- * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 기본은 이 API 킀에 λ°”μΈλ”©λœ λ°œμ£Όμ²˜λΏμž…λ‹ˆλ‹€. μ—¬λŸ¬ λ°œμ£Όμ‚¬λ₯Ό λŒ€μ‹ ν•΄ ν˜ΈμΆœν•˜λŠ” ν”Œλž«νΌ(예: μ±„νŒ… 견적 SaaS)은 `contracts:any-member` μŠ€μ½”ν”„λ₯Ό λ°›μ•„μ•Ό μž„μ˜ νšŒμ›μœΌλ‘œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
426
+ * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 이 API 킀에 μ„€μ •λœ λŒ€ν–‰ λ²”μœ„(μ†Œμ† κ·Έλ£Ή 전원 λ˜λŠ” μ§€μ • νšŒμ› λͺ©λ‘) μ•ˆμ˜ νšŒμ›λ§Œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€ 섀정이며 μŠ€μ½”ν”„μ™€λŠ” λ³„κ°œ μΆ•μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
399
427
  * @summary κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘ 쑰회
400
428
  * @param {string} buyerId λ°œμ£ΌκΈ°κ΄€ νšŒμ› ID(c-market memberId).
401
429
  * @param {ListExternalContractDocumentsBidTypeEnum} bidType κ±°λž˜μœ ν˜•.
@@ -449,6 +477,15 @@ export declare const PartnerV2ApiFp: (configuration?: Configuration) => {
449
477
  * @throws {RequiredError}
450
478
  */
451
479
  registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BidRegisteredResponseDto>>;
480
+ /**
481
+ * μ™ΈλΆ€μ—μ„œ λ§Ίμ–΄μ§„ 계약 1건을 μ”¨λ§ˆμΌ“μ˜ **μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ λŒ€μƒ**으둜 λ“±λ‘ν•©λ‹ˆλ‹€. **등둝 ν›„ 동선:** λ°œμ£ΌκΈ°κ΄€μ΄ μ”¨λ§ˆμΌ“ [λ‚˜μ˜ 계약 관리] μ—μ„œ κ³„μ‚°μ„œ λ°œκΈ‰μ„ μš”μ²­ν•˜κ³ , 곡급기업이 같은 ν™”λ©΄μ—μ„œ λ°œν–‰ν•©λ‹ˆλ‹€. κ³„μ‚°μ„œμ˜ **κ³΅κΈ‰μžλŠ” 곡급기업, κ³΅κΈ‰λ°›λŠ”μžλŠ” λ°œμ£ΌκΈ°κ΄€**μž…λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μ”¨λ§ˆμΌ“μ€ 이 거래의 λŒ€κΈˆμ„ λ°›μ§€ μ•ŠμŠ΅λ‹ˆλ‹€ β€” λ°œν–‰ 경둜만 μ œκ³΅ν•©λ‹ˆλ‹€. **κΈˆμ•‘:** `supplyPrice` λŠ” **λΆ€κ°€μ„Έλ₯Ό λΊ€ κ³Όμ„Έ 곡급가앑**μž…λ‹ˆλ‹€(결제창 API κ°€ λΆ€κ°€μ„Έ 포함가λ₯Ό λ°›λŠ” 것과 λ‹€λ¦…λ‹ˆλ‹€). κ³Όμ„ΈΒ·λ©΄μ„Έ 곡급가앑이 λͺ¨λ‘ 0 이면 400 μž…λ‹ˆλ‹€. **사전 쑰건:** 두 νšŒμ› ID κ°€ μ”¨λ§ˆμΌ“μ— μ‹€μž¬ν•΄μ•Ό ν•©λ‹ˆλ‹€. νšŒμ› ID κ°€ κ³§ μ†Œμœ κΆŒμ΄λΌ, μ—†λŠ” νšŒμ›μœΌλ‘œ λ“±λ‘ν•˜λ©΄ 아무도 μ—΄ 수 μ—†λŠ” κ³„μ‚°μ„œ λŒ€μƒμ΄ λ©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ λŒ€ν–‰ λ²”μœ„μ— κ·Έ νšŒμ›μ΄ μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalContractId` κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ λŒ€μƒμ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
482
+ * @summary 계약 λ°œν–‰λŒ€μƒ 등둝
483
+ * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
484
+ * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
485
+ * @param {*} [options] Override http request option.
486
+ * @throws {RequiredError}
487
+ */
488
+ registerSemoContract(idempotencyKey: string, registerSemoContractRequestDto: RegisterSemoContractRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SemoContractRegisteredResponseDto>>;
452
489
  /**
453
490
  * ν˜‘μƒλ°©μ‹(NEGOTIATION/NEGOTIATION_AUTO) 곡고의 μ‘μ°°μžλ³„ 점수λ₯Ό μž…λ ₯ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** μž…μ°° 마감 ν›„ λ‚™μ°°(`POST /v2/bids/{bidId}/award`) μ „. ν˜‘μƒλ°©μ‹ κ³΅κ³ λŠ” 이 평가λ₯Ό μ™„λ£Œν•΄μ•Ό 낙찰에 μ§„μž…ν•  수 μžˆμŠ΅λ‹ˆλ‹€. **λΆ€μˆ˜νš¨κ³Ό:** - μ‘μ°°μžλ³„ 기술점수(및 선택적 κ°€κ²©μ μˆ˜ override)κ°€ κΈ°λ‘λ©λ‹ˆλ‹€. - `complete=true` λ©΄ ν‰κ°€μ™„λ£Œ κ²Œμ΄νŠΈκΉŒμ§€ 적용돼 λ‚™μ°° μ§„μž…μ΄ κ°€λŠ₯ν•΄μ§‘λ‹ˆλ‹€. **발주처:** API 킀에 λ°”μΈλ”©λœ 발주처둜 μžλ™ μŠ€μ½”ν”„λ©λ‹ˆλ‹€(μš”μ²­ body 에 buyerId λ₯Ό λ„£μ§€ μ•ŠμŠ΅λ‹ˆλ‹€). **ν•„μˆ˜ μŠ€μ½”ν”„:** `awards:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜. 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ 24μ‹œκ°„ λ‚΄ μΊμ‹œ 응닡 λ°˜ν™˜.
454
491
  * @summary ν˜‘μƒ μ μˆ˜ν‰κ°€
@@ -510,7 +547,7 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
510
547
  */
511
548
  completeInvoice(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): AxiosPromise<InvoiceCompletedResponseDto>;
512
549
  /**
513
- * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ `payments:any-member` κ°€ μΆ”κ°€λ‘œ ν•„μš”ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
550
+ * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. μ–΄λŠ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•  수 μžˆλŠ”μ§€λŠ” μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ API ν‚€μ˜ λŒ€ν–‰ λ²”μœ„ 섀정이 μ •ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
514
551
  * @summary 결제창 λ°œν–‰
515
552
  * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
516
553
  * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
@@ -527,7 +564,7 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
527
564
  */
528
565
  createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<EmbedLaunchResponseDto>;
529
566
  /**
530
- * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 은 λ§Œλ£Œλ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.** μ±„νŒ… λ©”μ‹œμ§€ 등에 κ·ΈλŒ€λ‘œ μ €μž₯ν•΄ 두어도 λ©λ‹ˆλ‹€. **생성 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** μ‘°νšŒμ™€ κ°™μŠ΅λ‹ˆλ‹€ β€” 기본은 λ°”μΈλ”©λœ 발주처뿐이고, ν”Œλž«νΌ ν‚€λŠ” `contracts:any-member` κ°€ ν•„μš”ν•©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜.
567
+ * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 헀더 ν•„μˆ˜.
531
568
  * @summary κ³„μ•½μ„œλ₯˜ 생성
532
569
  * @param {string} idempotencyKey λ©±λ“±μ„± ν‚€(1~255자, [A-Za-z0-9_-]). 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ μΊμ‹œ 응닡 λ°˜ν™˜(24μ‹œκ°„). UUID v4 ꢌμž₯.
533
570
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
@@ -576,6 +613,14 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
576
613
  * @throws {RequiredError}
577
614
  */
578
615
  getBidStatement(bidId: string, paperCode?: number, options?: RawAxiosRequestConfig): AxiosPromise<BidStatementResponseDto>;
616
+ /**
617
+ * λ“±λ‘ν•œ κ³„μ•½μ˜ κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœλ₯Ό ν™•μΈν•©λ‹ˆλ‹€. **μ–Έμ œ μ“°λ‚˜:** μ”¨λ§ˆμΌ“μ΄ λ³΄λ‚΄λŠ” λ°œν–‰μ™„λ£Œ 톡지λ₯Ό 놓쳀을 λ•Œμ˜ **볡ꡬ 경둜**μž…λ‹ˆλ‹€. ν‰μƒμ‹œμ—λŠ” 톡지λ₯Ό λ°›μ•„ μ²˜λ¦¬ν•˜κ³ , μƒνƒœκ°€ μ–΄κΈ‹λ‚œ 것 같을 λ•Œ 이 API 둜 λ˜μ½μœΌμ„Έμš”. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
618
+ * @summary κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœ 쑰회
619
+ * @param {string} externalContractId 등둝할 λ•Œ 보낸 νŒŒνŠΈλ„ˆ μΈ‘ 계약 μ‹λ³„μž.
620
+ * @param {*} [options] Override http request option.
621
+ * @throws {RequiredError}
622
+ */
623
+ getSemoContractTaxinvoiceStatus(externalContractId: string, options?: RawAxiosRequestConfig): AxiosPromise<SemoContractTaxinvoiceStatusResponseDto>;
579
624
  /**
580
625
  * 계약업체가 μΉ΄λ“œκ²°μ œλ‘œ λŒ€κΈˆμ„ 받을 수 μžˆλŠ” μƒνƒœμΈμ§€ ν™•μΈν•©λ‹ˆλ‹€(μ”¨λ§ˆμΌ“ νšŒμ› + μΉ΄λ“œκ²°μ œ κ°€λ§Ή). **κ²°μ œμˆ˜λ‹¨μ„ μ‚¬μš©μžμ—κ²Œ 보여주기 전에** ν˜ΈμΆœν•˜μ„Έμš”. λΆˆκ°€ν•œ μ—…μ²΄λ‘œ κ²°μ œμ°½μ„ λ§Œλ“€λ©΄ λ§Œλ“€μ–΄λŠ” μ§€μ§€λ§Œ κ²°μ œκ°€ λ§‰ν˜€, μ‚¬μš©μžκ°€ 막닀λ₯Έ 길에 κ°‡νž™λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`
581
626
  * @summary 곡급사 μΉ΄λ“œκ²°μ œ κ°€λŠ₯ μ—¬λΆ€
@@ -611,7 +656,7 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
611
656
  */
612
657
  listBids(limit?: number, cursor?: string, options?: RawAxiosRequestConfig): AxiosPromise<ListBidsResponseDto>;
613
658
  /**
614
- * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 기본은 이 API 킀에 λ°”μΈλ”©λœ λ°œμ£Όμ²˜λΏμž…λ‹ˆλ‹€. μ—¬λŸ¬ λ°œμ£Όμ‚¬λ₯Ό λŒ€μ‹ ν•΄ ν˜ΈμΆœν•˜λŠ” ν”Œλž«νΌ(예: μ±„νŒ… 견적 SaaS)은 `contracts:any-member` μŠ€μ½”ν”„λ₯Ό λ°›μ•„μ•Ό μž„μ˜ νšŒμ›μœΌλ‘œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
659
+ * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 이 API 킀에 μ„€μ •λœ λŒ€ν–‰ λ²”μœ„(μ†Œμ† κ·Έλ£Ή 전원 λ˜λŠ” μ§€μ • νšŒμ› λͺ©λ‘) μ•ˆμ˜ νšŒμ›λ§Œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€ 섀정이며 μŠ€μ½”ν”„μ™€λŠ” λ³„κ°œ μΆ•μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
615
660
  * @summary κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘ 쑰회
616
661
  * @param {string} buyerId λ°œμ£ΌκΈ°κ΄€ νšŒμ› ID(c-market memberId).
617
662
  * @param {ListExternalContractDocumentsBidTypeEnum} bidType κ±°λž˜μœ ν˜•.
@@ -665,6 +710,15 @@ export declare const PartnerV2ApiFactory: (configuration?: Configuration, basePa
665
710
  * @throws {RequiredError}
666
711
  */
667
712
  registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<BidRegisteredResponseDto>;
713
+ /**
714
+ * μ™ΈλΆ€μ—μ„œ λ§Ίμ–΄μ§„ 계약 1건을 μ”¨λ§ˆμΌ“μ˜ **μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ λŒ€μƒ**으둜 λ“±λ‘ν•©λ‹ˆλ‹€. **등둝 ν›„ 동선:** λ°œμ£ΌκΈ°κ΄€μ΄ μ”¨λ§ˆμΌ“ [λ‚˜μ˜ 계약 관리] μ—μ„œ κ³„μ‚°μ„œ λ°œκΈ‰μ„ μš”μ²­ν•˜κ³ , 곡급기업이 같은 ν™”λ©΄μ—μ„œ λ°œν–‰ν•©λ‹ˆλ‹€. κ³„μ‚°μ„œμ˜ **κ³΅κΈ‰μžλŠ” 곡급기업, κ³΅κΈ‰λ°›λŠ”μžλŠ” λ°œμ£ΌκΈ°κ΄€**μž…λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μ”¨λ§ˆμΌ“μ€ 이 거래의 λŒ€κΈˆμ„ λ°›μ§€ μ•ŠμŠ΅λ‹ˆλ‹€ β€” λ°œν–‰ 경둜만 μ œκ³΅ν•©λ‹ˆλ‹€. **κΈˆμ•‘:** `supplyPrice` λŠ” **λΆ€κ°€μ„Έλ₯Ό λΊ€ κ³Όμ„Έ 곡급가앑**μž…λ‹ˆλ‹€(결제창 API κ°€ λΆ€κ°€μ„Έ 포함가λ₯Ό λ°›λŠ” 것과 λ‹€λ¦…λ‹ˆλ‹€). κ³Όμ„ΈΒ·λ©΄μ„Έ 곡급가앑이 λͺ¨λ‘ 0 이면 400 μž…λ‹ˆλ‹€. **사전 쑰건:** 두 νšŒμ› ID κ°€ μ”¨λ§ˆμΌ“μ— μ‹€μž¬ν•΄μ•Ό ν•©λ‹ˆλ‹€. νšŒμ› ID κ°€ κ³§ μ†Œμœ κΆŒμ΄λΌ, μ—†λŠ” νšŒμ›μœΌλ‘œ λ“±λ‘ν•˜λ©΄ 아무도 μ—΄ 수 μ—†λŠ” κ³„μ‚°μ„œ λŒ€μƒμ΄ λ©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ λŒ€ν–‰ λ²”μœ„μ— κ·Έ νšŒμ›μ΄ μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalContractId` κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ λŒ€μƒμ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
715
+ * @summary 계약 λ°œν–‰λŒ€μƒ 등둝
716
+ * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
717
+ * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
718
+ * @param {*} [options] Override http request option.
719
+ * @throws {RequiredError}
720
+ */
721
+ registerSemoContract(idempotencyKey: string, registerSemoContractRequestDto: RegisterSemoContractRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<SemoContractRegisteredResponseDto>;
668
722
  /**
669
723
  * ν˜‘μƒλ°©μ‹(NEGOTIATION/NEGOTIATION_AUTO) 곡고의 μ‘μ°°μžλ³„ 점수λ₯Ό μž…λ ₯ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** μž…μ°° 마감 ν›„ λ‚™μ°°(`POST /v2/bids/{bidId}/award`) μ „. ν˜‘μƒλ°©μ‹ κ³΅κ³ λŠ” 이 평가λ₯Ό μ™„λ£Œν•΄μ•Ό 낙찰에 μ§„μž…ν•  수 μžˆμŠ΅λ‹ˆλ‹€. **λΆ€μˆ˜νš¨κ³Ό:** - μ‘μ°°μžλ³„ 기술점수(및 선택적 κ°€κ²©μ μˆ˜ override)κ°€ κΈ°λ‘λ©λ‹ˆλ‹€. - `complete=true` λ©΄ ν‰κ°€μ™„λ£Œ κ²Œμ΄νŠΈκΉŒμ§€ 적용돼 λ‚™μ°° μ§„μž…μ΄ κ°€λŠ₯ν•΄μ§‘λ‹ˆλ‹€. **발주처:** API 킀에 λ°”μΈλ”©λœ 발주처둜 μžλ™ μŠ€μ½”ν”„λ©λ‹ˆλ‹€(μš”μ²­ body 에 buyerId λ₯Ό λ„£μ§€ μ•ŠμŠ΅λ‹ˆλ‹€). **ν•„μˆ˜ μŠ€μ½”ν”„:** `awards:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜. 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ 24μ‹œκ°„ λ‚΄ μΊμ‹œ 응닡 λ°˜ν™˜.
670
724
  * @summary ν˜‘μƒ μ μˆ˜ν‰κ°€
@@ -726,7 +780,7 @@ export declare class PartnerV2Api extends BaseAPI {
726
780
  */
727
781
  completeInvoice(bidId: string, idempotencyKey: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<InvoiceCompletedResponseDto, any, {}>>;
728
782
  /**
729
- * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ `payments:any-member` κ°€ μΆ”κ°€λ‘œ ν•„μš”ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
783
+ * λ°œμ£ΌκΈ°κ΄€μ΄ νŠΉμ • μ—…μ²΄μ—κ²Œ μΉ΄λ“œλ‘œ μ§€λΆˆν•˜λŠ” 거래(결제창) 1건을 λ§Œλ“­λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μΉ΄λ“œ 승인이 **κ·Έ μ—…μ²΄μ˜ 가맹점**으둜 λ‚˜κ°€λ―€λ‘œ λŒ€κΈˆμ€ μ”¨λ§ˆμΌ“μ„ κ±°μΉ˜μ§€ μ•Šκ³  μ—…μ²΄λ‘œ μ§ν–‰ν•©λ‹ˆλ‹€. **λ°œν–‰ 직후 μƒνƒœ:** μžλ™ 승인(APPROVED)λ˜μ–΄ λ°”λ‘œ 결제 κ°€λŠ₯ν•©λ‹ˆλ‹€. **μ‚¬μš©μž 동선:** μ‘λ‹΅μ˜ `payUrl` 둜 λ°œμ£ΌκΈ°κ΄€μ„ 보내면 κ·Έ 결제창 ν•œ 건만 κ±ΈλŸ¬μ§„ 화면이 μ—΄λ¦½λ‹ˆλ‹€. κ±°κΈ°μ„œ μΉ΄λ“œλ₯Ό 골라 κ²°μ œν•©λ‹ˆλ‹€. **사전 쑰건:** 계약업체가 μ”¨λ§ˆμΌ“ νšŒμ›μ΄κ³  μΉ΄λ“œκ²°μ œμ— κ°€μž…(κ°€λ§Ή)돼 μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€ β€” `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 둜 미리 ν™•μΈν•˜μ„Έμš”. λ―Έκ°€μž… μ—…μ²΄λ‘œ λ°œν–‰ν•˜λ©΄ 400 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`. μ–΄λŠ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•  수 μžˆλŠ”μ§€λŠ” μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ API ν‚€μ˜ λŒ€ν–‰ λ²”μœ„ 섀정이 μ •ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalRef`(νŒŒνŠΈλ„ˆ μΈ‘ 거래 μ‹λ³„μž)κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ κ²°μ œμ°½μ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
730
784
  * @summary 결제창 λ°œν–‰
731
785
  * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
732
786
  * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto
@@ -743,7 +797,7 @@ export declare class PartnerV2Api extends BaseAPI {
743
797
  */
744
798
  createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<EmbedLaunchResponseDto, any, {}>>;
745
799
  /**
746
- * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 은 λ§Œλ£Œλ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.** μ±„νŒ… λ©”μ‹œμ§€ 등에 κ·ΈλŒ€λ‘œ μ €μž₯ν•΄ 두어도 λ©λ‹ˆλ‹€. **생성 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** μ‘°νšŒμ™€ κ°™μŠ΅λ‹ˆλ‹€ β€” 기본은 λ°”μΈλ”©λœ 발주처뿐이고, ν”Œλž«νΌ ν‚€λŠ” `contracts:any-member` κ°€ ν•„μš”ν•©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜.
800
+ * 곡고 없이 μ„±μ‚¬λœ 거래의 κ³„μ•½μ„œλ₯˜λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** 계약이 체결된 직후. **μš”μ²­ν•œ `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` 헀더 ν•„μˆ˜.
747
801
  * @summary κ³„μ•½μ„œλ₯˜ 생성
748
802
  * @param {string} idempotencyKey λ©±λ“±μ„± ν‚€(1~255자, [A-Za-z0-9_-]). 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ μΊμ‹œ 응닡 λ°˜ν™˜(24μ‹œκ°„). UUID v4 ꢌμž₯.
749
803
  * @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
@@ -792,6 +846,14 @@ export declare class PartnerV2Api extends BaseAPI {
792
846
  * @throws {RequiredError}
793
847
  */
794
848
  getBidStatement(bidId: string, paperCode?: number, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidStatementResponseDto, any, {}>>;
849
+ /**
850
+ * λ“±λ‘ν•œ κ³„μ•½μ˜ κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœλ₯Ό ν™•μΈν•©λ‹ˆλ‹€. **μ–Έμ œ μ“°λ‚˜:** μ”¨λ§ˆμΌ“μ΄ λ³΄λ‚΄λŠ” λ°œν–‰μ™„λ£Œ 톡지λ₯Ό 놓쳀을 λ•Œμ˜ **볡ꡬ 경둜**μž…λ‹ˆλ‹€. ν‰μƒμ‹œμ—λŠ” 톡지λ₯Ό λ°›μ•„ μ²˜λ¦¬ν•˜κ³ , μƒνƒœκ°€ μ–΄κΈ‹λ‚œ 것 같을 λ•Œ 이 API 둜 λ˜μ½μœΌμ„Έμš”. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
851
+ * @summary κ³„μ‚°μ„œ λ°œν–‰ μƒνƒœ 쑰회
852
+ * @param {string} externalContractId 등둝할 λ•Œ 보낸 νŒŒνŠΈλ„ˆ μΈ‘ 계약 μ‹λ³„μž.
853
+ * @param {*} [options] Override http request option.
854
+ * @throws {RequiredError}
855
+ */
856
+ getSemoContractTaxinvoiceStatus(externalContractId: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SemoContractTaxinvoiceStatusResponseDto, any, {}>>;
795
857
  /**
796
858
  * 계약업체가 μΉ΄λ“œκ²°μ œλ‘œ λŒ€κΈˆμ„ 받을 수 μžˆλŠ” μƒνƒœμΈμ§€ ν™•μΈν•©λ‹ˆλ‹€(μ”¨λ§ˆμΌ“ νšŒμ› + μΉ΄λ“œκ²°μ œ κ°€λ§Ή). **κ²°μ œμˆ˜λ‹¨μ„ μ‚¬μš©μžμ—κ²Œ 보여주기 전에** ν˜ΈμΆœν•˜μ„Έμš”. λΆˆκ°€ν•œ μ—…μ²΄λ‘œ κ²°μ œμ°½μ„ λ§Œλ“€λ©΄ λ§Œλ“€μ–΄λŠ” μ§€μ§€λ§Œ κ²°μ œκ°€ λ§‰ν˜€, μ‚¬μš©μžκ°€ 막닀λ₯Έ 길에 κ°‡νž™λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `payments:write`
797
859
  * @summary 곡급사 μΉ΄λ“œκ²°μ œ κ°€λŠ₯ μ—¬λΆ€
@@ -827,7 +889,7 @@ export declare class PartnerV2Api extends BaseAPI {
827
889
  */
828
890
  listBids(limit?: number, cursor?: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ListBidsResponseDto, any, {}>>;
829
891
  /**
830
- * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 기본은 이 API 킀에 λ°”μΈλ”©λœ λ°œμ£Όμ²˜λΏμž…λ‹ˆλ‹€. μ—¬λŸ¬ λ°œμ£Όμ‚¬λ₯Ό λŒ€μ‹ ν•΄ ν˜ΈμΆœν•˜λŠ” ν”Œλž«νΌ(예: μ±„νŒ… 견적 SaaS)은 `contracts:any-member` μŠ€μ½”ν”„λ₯Ό λ°›μ•„μ•Ό μž„μ˜ νšŒμ›μœΌλ‘œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
892
+ * λ°œμ£ΌκΈ°κ΄€ νšŒμ›κ³Ό κ±°λž˜μœ ν˜•μœΌλ‘œ **κ·Έ κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘**을 μ‘°νšŒν•©λ‹ˆλ‹€. **μš©λ„:** 곡고(μž…μ°°)λ₯Ό κ±°μΉ˜μ§€ μ•ŠλŠ” 거래 β€” 예: μ±„νŒ… 기반 견적 β€” μ—μ„œ 계약 전에 \"μ–΄λ–€ μ„œλ₯˜κ°€ ν•„μš”ν•œκ°€\"λ₯Ό 보여쀄 λ•Œ. **νŒμ • κΈ°μ€€:** λ°œμ£ΌκΈ°κ΄€μ΄ μ†ν•œ 그룹에 λ°°μ •λœ κ³„μ•½μ„œλ₯˜ 쀑 κ·Έ κ±°λž˜μœ ν˜•μ— μ μš©λ˜λŠ” 것 μ „λΆ€μž…λ‹ˆλ‹€. μš΄μ˜μžκ°€ μ–΄λ“œλ―Όμ—μ„œ 배정을 λ°”κΎΈλ©΄ 별도 배포 없이 μ¦‰μ‹œ λ°˜μ˜λ©λ‹ˆλ‹€. **응닡 해석:** - `isDefault=true` β€” μš΄μ˜μžκ°€ κΈ°λ³Έκ°’(β˜…)으둜 켜 λ‘” μ„œλ₯˜μž…λ‹ˆλ‹€. 선택 ν™”λ©΄μ—μ„œ **미리 체크된 μƒνƒœλ‘œ** λ³΄μ—¬μ£Όμ„Έμš”. λͺ©λ‘μ΄ 이 κ°’μœΌλ‘œ 걸러져 μžˆμ§€λŠ” μ•ŠμŠ΅λ‹ˆλ‹€. - `autoGenerated=true` β€” c-market 이 데이터λ₯Ό μ±„μ›Œ PDF 둜 λ§Œλ“€μ–΄ μ£ΌλŠ” μ„œλ₯˜μž…λ‹ˆλ‹€. 생성 API 의 `paperCodes` 에 넣을 수 μžˆμŠ΅λ‹ˆλ‹€. - `autoGenerated=false` β€” 이 API λ‘œλŠ” λ§Œλ“€ 수 μ—†λŠ” μ„œλ₯˜μž…λ‹ˆλ‹€(거래λͺ…μ„Έμ„œμ²˜λŸΌ μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 같은 별도 μ‹œμ μ΄ ν•„μš”ν•œ μ„œλ₯˜). λͺ©λ‘μ—μ„œ 감좔지 말고 μ‚¬μš©μžκ°€ 직접 μ²¨λΆ€ν•˜λ„λ‘ μ•ˆλ‚΄ν•˜μ„Έμš”. **쑰회 κ°€λŠ₯ν•œ νšŒμ› λ²”μœ„:** 이 API 킀에 μ„€μ •λœ λŒ€ν–‰ λ²”μœ„(μ†Œμ† κ·Έλ£Ή 전원 λ˜λŠ” μ§€μ • νšŒμ› λͺ©λ‘) μ•ˆμ˜ νšŒμ›λ§Œ μ‘°νšŒν•  수 μžˆμŠ΅λ‹ˆλ‹€. λ²”μœ„ 밖이면 403 μž…λ‹ˆλ‹€. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€ 섀정이며 μŠ€μ½”ν”„μ™€λŠ” λ³„κ°œ μΆ•μž…λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:read`
831
893
  * @summary κ±°λž˜μ— ν•„μš”ν•œ κ³„μ•½μ„œλ₯˜ λͺ©λ‘ 쑰회
832
894
  * @param {string} buyerId λ°œμ£ΌκΈ°κ΄€ νšŒμ› ID(c-market memberId).
833
895
  * @param {ListExternalContractDocumentsBidTypeEnum} bidType κ±°λž˜μœ ν˜•.
@@ -881,6 +943,15 @@ export declare class PartnerV2Api extends BaseAPI {
881
943
  * @throws {RequiredError}
882
944
  */
883
945
  registerBid(createBidRequestDto: CreateBidRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<BidRegisteredResponseDto, any, {}>>;
946
+ /**
947
+ * μ™ΈλΆ€μ—μ„œ λ§Ίμ–΄μ§„ 계약 1건을 μ”¨λ§ˆμΌ“μ˜ **μ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ λŒ€μƒ**으둜 λ“±λ‘ν•©λ‹ˆλ‹€. **등둝 ν›„ 동선:** λ°œμ£ΌκΈ°κ΄€μ΄ μ”¨λ§ˆμΌ“ [λ‚˜μ˜ 계약 관리] μ—μ„œ κ³„μ‚°μ„œ λ°œκΈ‰μ„ μš”μ²­ν•˜κ³ , 곡급기업이 같은 ν™”λ©΄μ—μ„œ λ°œν–‰ν•©λ‹ˆλ‹€. κ³„μ‚°μ„œμ˜ **κ³΅κΈ‰μžλŠ” 곡급기업, κ³΅κΈ‰λ°›λŠ”μžλŠ” λ°œμ£ΌκΈ°κ΄€**μž…λ‹ˆλ‹€. **λŒ€κΈˆ 흐름:** μ”¨λ§ˆμΌ“μ€ 이 거래의 λŒ€κΈˆμ„ λ°›μ§€ μ•ŠμŠ΅λ‹ˆλ‹€ β€” λ°œν–‰ 경둜만 μ œκ³΅ν•©λ‹ˆλ‹€. **κΈˆμ•‘:** `supplyPrice` λŠ” **λΆ€κ°€μ„Έλ₯Ό λΊ€ κ³Όμ„Έ 곡급가앑**μž…λ‹ˆλ‹€(결제창 API κ°€ λΆ€κ°€μ„Έ 포함가λ₯Ό λ°›λŠ” 것과 λ‹€λ¦…λ‹ˆλ‹€). κ³Όμ„ΈΒ·λ©΄μ„Έ 곡급가앑이 λͺ¨λ‘ 0 이면 400 μž…λ‹ˆλ‹€. **사전 쑰건:** 두 νšŒμ› ID κ°€ μ”¨λ§ˆμΌ“μ— μ‹€μž¬ν•΄μ•Ό ν•©λ‹ˆλ‹€. νšŒμ› ID κ°€ κ³§ μ†Œμœ κΆŒμ΄λΌ, μ—†λŠ” νšŒμ›μœΌλ‘œ λ“±λ‘ν•˜λ©΄ 아무도 μ—΄ 수 μ—†λŠ” κ³„μ‚°μ„œ λŒ€μƒμ΄ λ©λ‹ˆλ‹€. **ν•„μˆ˜ μŠ€μ½”ν”„:** `contracts:write`. λ°”μΈλ”©λœ 발주처 μ™Έμ˜ λ°œμ£ΌκΈ°κ΄€μ„ λŒ€μ‹ ν•˜λ €λ©΄ λŒ€ν–‰ λ²”μœ„μ— κ·Έ νšŒμ›μ΄ μžˆμ–΄μ•Ό ν•©λ‹ˆλ‹€. **λ©±λ“±μ„±:** `externalContractId` κ°€ λ©±λ“±ν‚€μž…λ‹ˆλ‹€. 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ λŒ€μƒμ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`). `Idempotency-Key` 헀더도 ν•¨κ»˜ μ‚¬μš©ν•˜μ„Έμš”.
948
+ * @summary 계약 λ°œν–‰λŒ€μƒ 등둝
949
+ * @param {string} idempotencyKey μž¬μ‹œλ„ μ•ˆμ „μ„ μœ„ν•œ λ©±λ“± ν‚€.
950
+ * @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
951
+ * @param {*} [options] Override http request option.
952
+ * @throws {RequiredError}
953
+ */
954
+ registerSemoContract(idempotencyKey: string, registerSemoContractRequestDto: RegisterSemoContractRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<SemoContractRegisteredResponseDto, any, {}>>;
884
955
  /**
885
956
  * ν˜‘μƒλ°©μ‹(NEGOTIATION/NEGOTIATION_AUTO) 곡고의 μ‘μ°°μžλ³„ 점수λ₯Ό μž…λ ₯ν•©λ‹ˆλ‹€. **호좜 μ‹œμ :** μž…μ°° 마감 ν›„ λ‚™μ°°(`POST /v2/bids/{bidId}/award`) μ „. ν˜‘μƒλ°©μ‹ κ³΅κ³ λŠ” 이 평가λ₯Ό μ™„λ£Œν•΄μ•Ό 낙찰에 μ§„μž…ν•  수 μžˆμŠ΅λ‹ˆλ‹€. **λΆ€μˆ˜νš¨κ³Ό:** - μ‘μ°°μžλ³„ 기술점수(및 선택적 κ°€κ²©μ μˆ˜ override)κ°€ κΈ°λ‘λ©λ‹ˆλ‹€. - `complete=true` λ©΄ ν‰κ°€μ™„λ£Œ κ²Œμ΄νŠΈκΉŒμ§€ 적용돼 λ‚™μ°° μ§„μž…μ΄ κ°€λŠ₯ν•΄μ§‘λ‹ˆλ‹€. **발주처:** API 킀에 λ°”μΈλ”©λœ 발주처둜 μžλ™ μŠ€μ½”ν”„λ©λ‹ˆλ‹€(μš”μ²­ body 에 buyerId λ₯Ό λ„£μ§€ μ•ŠμŠ΅λ‹ˆλ‹€). **ν•„μˆ˜ μŠ€μ½”ν”„:** `awards:write` **λ©±λ“±μ„±:** `Idempotency-Key` 헀더 ν•„μˆ˜. 동일 ν‚€ + 동일 body μž¬μ „μ†‘ μ‹œ 24μ‹œκ°„ λ‚΄ μΊμ‹œ 응닡 λ°˜ν™˜.
886
957
  * @summary ν˜‘μƒ μ μˆ˜ν‰κ°€