@cmarket/partner-sdk 35.1.0 → 36.1.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.
- package/README.md +58 -96
- package/api/oauth-api.ts +2 -2
- package/api/{partner-v2-api.ts → partner-api-api.ts} +426 -239
- package/api/products-api.ts +209 -0
- package/api/well-known-api.ts +2 -2
- package/api.ts +4 -4
- package/base.ts +2 -2
- package/common.ts +2 -2
- package/configuration.ts +2 -2
- package/dist/api/oauth-api.d.ts +2 -2
- package/dist/api/oauth-api.js +2 -2
- package/dist/api/{partner-v2-api.d.ts → partner-api-api.d.ts} +245 -165
- package/dist/api/{partner-v2-api.js → partner-api-api.js} +413 -240
- package/dist/api/products-api.d.ts +101 -0
- package/dist/api/products-api.js +204 -0
- package/dist/api/well-known-api.d.ts +2 -2
- package/dist/api/well-known-api.js +2 -2
- package/dist/api.d.ts +4 -4
- package/dist/api.js +4 -4
- package/dist/base.d.ts +2 -2
- package/dist/base.js +2 -2
- package/dist/common.d.ts +2 -2
- package/dist/common.js +2 -2
- package/dist/configuration.d.ts +2 -2
- package/dist/configuration.js +2 -2
- package/dist/esm/api/oauth-api.d.ts +2 -2
- package/dist/esm/api/oauth-api.js +2 -2
- package/dist/esm/api/{partner-v2-api.d.ts → partner-api-api.d.ts} +245 -165
- package/dist/esm/api/{partner-v2-api.js → partner-api-api.js} +408 -235
- package/dist/esm/api/products-api.d.ts +101 -0
- package/dist/esm/api/products-api.js +197 -0
- package/dist/esm/api/well-known-api.d.ts +2 -2
- package/dist/esm/api/well-known-api.js +2 -2
- package/dist/esm/api.d.ts +4 -4
- package/dist/esm/api.js +4 -4
- package/dist/esm/base.d.ts +2 -2
- package/dist/esm/base.js +2 -2
- package/dist/esm/common.d.ts +2 -2
- package/dist/esm/common.js +2 -2
- package/dist/esm/configuration.d.ts +2 -2
- package/dist/esm/configuration.js +2 -2
- package/dist/esm/index.d.ts +2 -2
- package/dist/esm/index.js +2 -2
- package/dist/esm/models/acceptance-result-response-dto.d.ts +3 -3
- package/dist/esm/models/acceptance-result-response-dto.js +2 -2
- package/dist/esm/models/acknowledge-product-receipt200-response.d.ts +21 -0
- package/dist/esm/models/acknowledge-product-receipt200-response.js +14 -0
- package/dist/esm/models/acknowledge-products-request-dto.d.ts +17 -0
- package/dist/esm/models/acknowledge-products-request-dto.js +14 -0
- package/dist/esm/models/api-catalog-dto.d.ts +2 -2
- package/dist/esm/models/api-catalog-dto.js +2 -2
- package/dist/esm/models/api-catalog-entry-dto.d.ts +2 -2
- package/dist/esm/models/api-catalog-entry-dto.js +2 -2
- package/dist/esm/models/api-catalog-link-dto.d.ts +2 -2
- package/dist/esm/models/api-catalog-link-dto.js +2 -2
- package/dist/esm/models/authorization-server-metadata-dto.d.ts +2 -2
- package/dist/esm/models/authorization-server-metadata-dto.js +2 -2
- package/dist/esm/models/award-method-public.d.ts +3 -3
- package/dist/esm/models/award-method-public.js +3 -3
- package/dist/esm/models/award-registered-v2-response-dto.d.ts +5 -5
- package/dist/esm/models/award-registered-v2-response-dto.js +2 -2
- package/dist/esm/models/award-reverted-v2-response-dto.d.ts +4 -4
- package/dist/esm/models/award-reverted-v2-response-dto.js +2 -2
- package/dist/esm/models/bid-acceptance-dto.d.ts +2 -2
- package/dist/esm/models/bid-acceptance-dto.js +2 -2
- package/dist/esm/models/bid-bond-dto.d.ts +2 -2
- package/dist/esm/models/bid-bond-dto.js +2 -2
- package/dist/esm/models/bid-cancelled-response-dto.d.ts +4 -4
- package/dist/esm/models/bid-cancelled-response-dto.js +2 -2
- package/dist/esm/models/bid-contact-dto.d.ts +2 -2
- package/dist/esm/models/bid-contact-dto.js +2 -2
- package/dist/esm/models/bid-contacts-dto.d.ts +2 -2
- package/dist/esm/models/bid-contacts-dto.js +2 -2
- package/dist/esm/models/bid-contract-document-dto.d.ts +2 -2
- package/dist/esm/models/bid-contract-document-dto.js +2 -2
- package/dist/esm/models/bid-delivery-terms-dto.d.ts +6 -4
- package/dist/esm/models/bid-delivery-terms-dto.js +2 -2
- package/dist/esm/models/bid-detail-response-dto.d.ts +5 -5
- package/dist/esm/models/bid-detail-response-dto.js +2 -2
- package/dist/esm/models/bid-document-dto.d.ts +2 -2
- package/dist/esm/models/bid-document-dto.js +2 -2
- package/dist/esm/models/bid-failed-v2-response-dto.d.ts +4 -4
- package/dist/esm/models/bid-failed-v2-response-dto.js +2 -2
- package/dist/esm/models/bid-item-dto.d.ts +2 -2
- package/dist/esm/models/bid-item-dto.js +2 -2
- package/dist/esm/models/bid-lifecycle-dto.d.ts +3 -3
- package/dist/esm/models/bid-lifecycle-dto.js +2 -2
- package/dist/esm/models/bid-manager-dto.d.ts +2 -2
- package/dist/esm/models/bid-manager-dto.js +2 -2
- package/dist/esm/models/bid-payment-terms-dto.d.ts +4 -3
- package/dist/esm/models/bid-payment-terms-dto.js +2 -2
- package/dist/esm/models/bid-product-dto.d.ts +2 -2
- package/dist/esm/models/bid-product-dto.js +2 -2
- package/dist/esm/models/bid-public-status.d.ts +2 -2
- package/dist/esm/models/bid-public-status.js +2 -2
- package/dist/esm/models/bid-registered-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-registered-response-dto.js +2 -2
- package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-participant-attachment-dto.js +2 -2
- package/dist/esm/models/bid-result-participant-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-participant-dto.js +2 -2
- package/dist/esm/models/bid-results-response-dto.d.ts +3 -3
- package/dist/esm/models/bid-results-response-dto.js +2 -2
- package/dist/esm/models/bid-settlement-line-item-dto.d.ts +2 -2
- package/dist/esm/models/bid-settlement-line-item-dto.js +2 -2
- package/dist/esm/models/bid-settlement-participant-dto.d.ts +2 -2
- package/dist/esm/models/bid-settlement-participant-dto.js +2 -2
- package/dist/esm/models/bid-settlement-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-settlement-response-dto.js +2 -2
- package/dist/esm/models/bid-statement-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-statement-response-dto.js +2 -2
- package/dist/esm/models/bid-summary-dto.d.ts +9 -8
- package/dist/esm/models/bid-summary-dto.js +2 -2
- package/dist/esm/models/bid-type-public.d.ts +19 -0
- package/dist/esm/models/bid-type-public.js +20 -0
- package/dist/esm/models/bid-updated-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-updated-response-dto.js +2 -2
- package/dist/esm/models/cancel-bid-request-dto.d.ts +2 -2
- package/dist/esm/models/cancel-bid-request-dto.js +2 -2
- package/dist/esm/models/cancel-bid200-response.d.ts +2 -2
- package/dist/esm/models/cancel-bid200-response.js +2 -2
- package/dist/esm/models/card-payment-request-response-dto.d.ts +2 -2
- package/dist/esm/models/card-payment-request-response-dto.js +2 -2
- package/dist/esm/models/complete-acceptance-request-dto.d.ts +4 -8
- package/dist/esm/models/complete-acceptance-request-dto.js +2 -2
- package/dist/esm/models/complete-acceptance200-response.d.ts +2 -2
- package/dist/esm/models/complete-acceptance200-response.js +2 -2
- package/dist/esm/models/complete-invoice200-response.d.ts +2 -2
- package/dist/esm/models/complete-invoice200-response.js +2 -2
- package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +2 -2
- package/dist/esm/models/contract-restriction-confirm-input-dto.js +2 -2
- package/dist/esm/models/create-bid-request-dto.d.ts +5 -5
- package/dist/esm/models/create-bid-request-dto.js +2 -2
- package/dist/esm/models/create-card-payment-dto.d.ts +41 -0
- package/dist/esm/models/create-card-payment-dto.js +14 -0
- package/dist/esm/models/create-card-payment-request-dto.d.ts +4 -4
- package/dist/esm/models/create-card-payment-request-dto.js +2 -2
- package/dist/esm/models/create-card-payment200-response.d.ts +21 -0
- package/dist/esm/models/create-card-payment200-response.js +14 -0
- package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +2 -2
- package/dist/esm/models/create-external-contract-documents-request-dto.js +2 -2
- package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +2 -2
- package/dist/esm/models/create-external-contract-documents-response-dto.js +2 -2
- package/dist/esm/models/delivery-date-type-public.d.ts +20 -0
- package/dist/esm/models/delivery-date-type-public.js +21 -0
- package/dist/esm/models/delivery-method-public.d.ts +20 -0
- package/dist/esm/models/delivery-method-public.js +21 -0
- package/dist/esm/models/excellent-procurement-public.d.ts +31 -0
- package/dist/esm/models/excellent-procurement-public.js +32 -0
- package/dist/esm/models/external-contract-document-item-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-document-item-dto.js +2 -2
- package/dist/esm/models/external-contract-documents-response-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-documents-response-dto.js +2 -2
- package/dist/esm/models/external-contract-item-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-item-dto.js +2 -2
- package/dist/esm/models/external-contract-snapshot-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-snapshot-dto.js +2 -2
- package/dist/esm/models/external-document-inputs-dto.d.ts +2 -2
- package/dist/esm/models/external-document-inputs-dto.js +2 -2
- package/dist/esm/models/file-meta-response-dto.d.ts +2 -2
- package/dist/esm/models/file-meta-response-dto.js +2 -2
- package/dist/esm/models/file-uploaded-response-dto.d.ts +3 -3
- package/dist/esm/models/file-uploaded-response-dto.js +2 -2
- package/dist/esm/models/generated-external-contract-document-dto.d.ts +2 -2
- package/dist/esm/models/generated-external-contract-document-dto.js +2 -2
- package/dist/esm/models/get-bid-settlement200-response.d.ts +2 -2
- package/dist/esm/models/get-bid-settlement200-response.js +2 -2
- package/dist/esm/models/get-bid-statement200-response.d.ts +2 -2
- package/dist/esm/models/get-bid-statement200-response.js +2 -2
- package/dist/esm/models/get-bid200-response.d.ts +2 -2
- package/dist/esm/models/get-bid200-response.js +2 -2
- package/dist/esm/models/get-file-meta200-response.d.ts +2 -2
- package/dist/esm/models/get-file-meta200-response.js +2 -2
- package/dist/esm/models/get-supplier-card-payable-v2200-response.d.ts +21 -0
- package/dist/esm/models/get-supplier-card-payable-v2200-response.js +14 -0
- package/dist/esm/models/green-product-public.d.ts +21 -0
- package/dist/esm/models/green-product-public.js +22 -0
- package/dist/esm/models/health-controller-check200-response.d.ts +2 -2
- package/dist/esm/models/health-controller-check200-response.js +2 -2
- package/dist/esm/models/health-response-dto.d.ts +2 -2
- package/dist/esm/models/health-response-dto.js +2 -2
- package/dist/esm/models/hierarchical-region-dto.d.ts +2 -2
- package/dist/esm/models/hierarchical-region-dto.js +2 -2
- package/dist/esm/models/index.d.ts +22 -39
- package/dist/esm/models/index.js +22 -39
- package/dist/esm/models/introspect-request-dto.d.ts +2 -2
- package/dist/esm/models/introspect-request-dto.js +2 -2
- package/dist/esm/models/introspection-response-dto.d.ts +2 -2
- package/dist/esm/models/introspection-response-dto.js +2 -2
- package/dist/esm/models/invalid-param-dto.d.ts +3 -3
- package/dist/esm/models/invalid-param-dto.js +2 -2
- package/dist/esm/models/invoice-completed-response-dto.d.ts +2 -2
- package/dist/esm/models/invoice-completed-response-dto.js +2 -2
- package/dist/esm/models/invoice-split-response-dto.d.ts +17 -0
- package/dist/esm/models/invoice-split-response-dto.js +14 -0
- package/dist/esm/models/legal-mandatory-public.d.ts +25 -0
- package/dist/esm/models/legal-mandatory-public.js +26 -0
- package/dist/esm/models/list-bid-results200-response.d.ts +2 -2
- package/dist/esm/models/list-bid-results200-response.js +2 -2
- package/dist/esm/models/list-bids-response-dto.d.ts +2 -2
- package/dist/esm/models/list-bids-response-dto.js +2 -2
- package/dist/esm/models/list-bids200-response.d.ts +2 -2
- package/dist/esm/models/list-bids200-response.js +2 -2
- package/dist/esm/models/list-products200-response.d.ts +21 -0
- package/dist/esm/models/list-products200-response.js +14 -0
- package/dist/esm/models/mark-bid-failed-request-dto.d.ts +3 -3
- package/dist/esm/models/mark-bid-failed-request-dto.js +2 -2
- package/dist/esm/models/mark-bid-failed201-response.d.ts +2 -2
- package/dist/esm/models/mark-bid-failed201-response.js +2 -2
- package/dist/esm/models/negotiation-score-dto.d.ts +25 -0
- package/dist/esm/models/negotiation-score-dto.js +14 -0
- package/dist/esm/models/negotiation-scored-v2-response-dto.d.ts +29 -0
- package/dist/esm/models/negotiation-scored-v2-response-dto.js +16 -0
- package/dist/esm/models/oauth-error-response-dto.d.ts +2 -2
- package/dist/esm/models/oauth-error-response-dto.js +2 -2
- package/dist/esm/models/payment-method-public.d.ts +19 -0
- package/dist/esm/models/payment-method-public.js +20 -0
- package/dist/esm/models/preconditions-dto.d.ts +11 -50
- package/dist/esm/models/preconditions-dto.js +3 -33
- package/dist/esm/models/problem-details-dto.d.ts +3 -3
- package/dist/esm/models/problem-details-dto.js +2 -2
- package/dist/esm/models/product-receipt-response-dto.d.ts +17 -0
- package/dist/esm/models/product-receipt-response-dto.js +14 -0
- package/dist/esm/models/product-response-dto.d.ts +77 -0
- package/dist/esm/models/product-response-dto.js +14 -0
- package/dist/esm/models/protected-resource-metadata-dto.d.ts +2 -2
- package/dist/esm/models/protected-resource-metadata-dto.js +2 -2
- package/dist/esm/models/register-award-request-dto.d.ts +4 -4
- package/dist/esm/models/register-award-request-dto.js +2 -2
- package/dist/esm/models/register-award201-response.d.ts +2 -2
- package/dist/esm/models/register-award201-response.js +2 -2
- package/dist/esm/models/register-bid201-response.d.ts +2 -2
- package/dist/esm/models/register-bid201-response.js +2 -2
- package/dist/esm/models/register-semo-contract-request-dto.d.ts +2 -2
- package/dist/esm/models/register-semo-contract-request-dto.js +2 -2
- package/dist/esm/models/request-invoice-split-request-dto.d.ts +25 -0
- package/dist/esm/models/request-invoice-split-request-dto.js +14 -0
- package/dist/esm/models/request-invoice-split200-response.d.ts +21 -0
- package/dist/esm/models/request-invoice-split200-response.js +14 -0
- package/dist/esm/models/retiree-roster-input-dto.d.ts +2 -2
- package/dist/esm/models/retiree-roster-input-dto.js +2 -2
- package/dist/esm/models/retiree-roster-row-dto.d.ts +2 -2
- package/dist/esm/models/retiree-roster-row-dto.js +2 -2
- package/dist/esm/models/revert-award-request-dto.d.ts +2 -2
- package/dist/esm/models/revert-award-request-dto.js +2 -2
- package/dist/esm/models/revert-award200-response.d.ts +2 -2
- package/dist/esm/models/revert-award200-response.js +2 -2
- package/dist/esm/models/revoke-request-dto.d.ts +2 -2
- package/dist/esm/models/revoke-request-dto.js +2 -2
- package/dist/esm/models/semo-contract-registered-response-dto.d.ts +2 -2
- package/dist/esm/models/semo-contract-registered-response-dto.js +2 -2
- package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
- package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
- package/dist/esm/models/statement-document-dto.d.ts +2 -2
- package/dist/esm/models/statement-document-dto.js +2 -2
- package/dist/esm/models/statement-product-dto.d.ts +3 -3
- package/dist/esm/models/statement-product-dto.js +2 -2
- package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +22 -0
- package/dist/esm/models/submit-negotiation-scores-request-dto.js +14 -0
- package/dist/esm/models/submit-negotiation-scores201-response.d.ts +21 -0
- package/dist/esm/models/submit-negotiation-scores201-response.js +14 -0
- package/dist/esm/models/supplier-card-payable-response-dto.d.ts +2 -2
- package/dist/esm/models/supplier-card-payable-response-dto.js +2 -2
- package/dist/esm/models/supplier-tax-type.d.ts +2 -2
- package/dist/esm/models/supplier-tax-type.js +2 -2
- package/dist/esm/models/token-request-dto.d.ts +2 -2
- package/dist/esm/models/token-request-dto.js +2 -2
- package/dist/esm/models/token-response-dto.d.ts +2 -2
- package/dist/esm/models/token-response-dto.js +2 -2
- package/dist/esm/models/update-bid-request-dto.d.ts +7 -7
- package/dist/esm/models/update-bid-request-dto.js +2 -2
- package/dist/esm/models/update-bid200-response.d.ts +2 -2
- package/dist/esm/models/update-bid200-response.js +2 -2
- package/dist/esm/models/upload-file-request-dto.d.ts +3 -3
- package/dist/esm/models/upload-file-request-dto.js +2 -2
- package/dist/esm/models/upload-file201-response.d.ts +2 -2
- package/dist/esm/models/upload-file201-response.js +2 -2
- package/dist/esm/partner-client.d.ts +2 -2
- package/dist/esm/partner-client.js +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -2
- package/dist/models/acceptance-result-response-dto.d.ts +3 -3
- package/dist/models/acceptance-result-response-dto.js +2 -2
- package/dist/models/acknowledge-product-receipt200-response.d.ts +21 -0
- package/dist/models/acknowledge-product-receipt200-response.js +15 -0
- package/dist/models/acknowledge-products-request-dto.d.ts +17 -0
- package/dist/models/acknowledge-products-request-dto.js +15 -0
- package/dist/models/api-catalog-dto.d.ts +2 -2
- package/dist/models/api-catalog-dto.js +2 -2
- package/dist/models/api-catalog-entry-dto.d.ts +2 -2
- package/dist/models/api-catalog-entry-dto.js +2 -2
- package/dist/models/api-catalog-link-dto.d.ts +2 -2
- package/dist/models/api-catalog-link-dto.js +2 -2
- package/dist/models/authorization-server-metadata-dto.d.ts +2 -2
- package/dist/models/authorization-server-metadata-dto.js +2 -2
- package/dist/models/award-method-public.d.ts +3 -3
- package/dist/models/award-method-public.js +3 -3
- package/dist/models/award-registered-v2-response-dto.d.ts +5 -5
- package/dist/models/award-registered-v2-response-dto.js +2 -2
- package/dist/models/award-reverted-v2-response-dto.d.ts +4 -4
- package/dist/models/award-reverted-v2-response-dto.js +2 -2
- package/dist/models/bid-acceptance-dto.d.ts +2 -2
- package/dist/models/bid-acceptance-dto.js +2 -2
- package/dist/models/bid-bond-dto.d.ts +2 -2
- package/dist/models/bid-bond-dto.js +2 -2
- package/dist/models/bid-cancelled-response-dto.d.ts +4 -4
- package/dist/models/bid-cancelled-response-dto.js +2 -2
- package/dist/models/bid-contact-dto.d.ts +2 -2
- package/dist/models/bid-contact-dto.js +2 -2
- package/dist/models/bid-contacts-dto.d.ts +2 -2
- package/dist/models/bid-contacts-dto.js +2 -2
- package/dist/models/bid-contract-document-dto.d.ts +2 -2
- package/dist/models/bid-contract-document-dto.js +2 -2
- package/dist/models/bid-delivery-terms-dto.d.ts +6 -4
- package/dist/models/bid-delivery-terms-dto.js +2 -2
- package/dist/models/bid-detail-response-dto.d.ts +5 -5
- package/dist/models/bid-detail-response-dto.js +2 -2
- package/dist/models/bid-document-dto.d.ts +2 -2
- package/dist/models/bid-document-dto.js +2 -2
- package/dist/models/bid-failed-v2-response-dto.d.ts +4 -4
- package/dist/models/bid-failed-v2-response-dto.js +2 -2
- package/dist/models/bid-item-dto.d.ts +2 -2
- package/dist/models/bid-item-dto.js +2 -2
- package/dist/models/bid-lifecycle-dto.d.ts +3 -3
- package/dist/models/bid-lifecycle-dto.js +2 -2
- package/dist/models/bid-manager-dto.d.ts +2 -2
- package/dist/models/bid-manager-dto.js +2 -2
- package/dist/models/bid-payment-terms-dto.d.ts +4 -3
- package/dist/models/bid-payment-terms-dto.js +2 -2
- package/dist/models/bid-product-dto.d.ts +2 -2
- package/dist/models/bid-product-dto.js +2 -2
- package/dist/models/bid-public-status.d.ts +2 -2
- package/dist/models/bid-public-status.js +2 -2
- package/dist/models/bid-registered-response-dto.d.ts +2 -2
- package/dist/models/bid-registered-response-dto.js +2 -2
- package/dist/models/bid-result-participant-attachment-dto.d.ts +2 -2
- package/dist/models/bid-result-participant-attachment-dto.js +2 -2
- package/dist/models/bid-result-participant-dto.d.ts +2 -2
- package/dist/models/bid-result-participant-dto.js +2 -2
- package/dist/models/bid-results-response-dto.d.ts +3 -3
- package/dist/models/bid-results-response-dto.js +2 -2
- package/dist/models/bid-settlement-line-item-dto.d.ts +2 -2
- package/dist/models/bid-settlement-line-item-dto.js +2 -2
- package/dist/models/bid-settlement-participant-dto.d.ts +2 -2
- package/dist/models/bid-settlement-participant-dto.js +2 -2
- package/dist/models/bid-settlement-response-dto.d.ts +2 -2
- package/dist/models/bid-settlement-response-dto.js +2 -2
- package/dist/models/bid-statement-response-dto.d.ts +2 -2
- package/dist/models/bid-statement-response-dto.js +2 -2
- package/dist/models/bid-summary-dto.d.ts +9 -8
- package/dist/models/bid-summary-dto.js +2 -2
- package/dist/models/bid-type-public.d.ts +19 -0
- package/dist/models/bid-type-public.js +23 -0
- package/dist/models/bid-updated-response-dto.d.ts +2 -2
- package/dist/models/bid-updated-response-dto.js +2 -2
- package/dist/models/cancel-bid-request-dto.d.ts +2 -2
- package/dist/models/cancel-bid-request-dto.js +2 -2
- package/dist/models/cancel-bid200-response.d.ts +2 -2
- package/dist/models/cancel-bid200-response.js +2 -2
- package/dist/models/card-payment-request-response-dto.d.ts +2 -2
- package/dist/models/card-payment-request-response-dto.js +2 -2
- package/dist/models/complete-acceptance-request-dto.d.ts +4 -8
- package/dist/models/complete-acceptance-request-dto.js +2 -2
- package/dist/models/complete-acceptance200-response.d.ts +2 -2
- package/dist/models/complete-acceptance200-response.js +2 -2
- package/dist/models/complete-invoice200-response.d.ts +2 -2
- package/dist/models/complete-invoice200-response.js +2 -2
- package/dist/models/contract-restriction-confirm-input-dto.d.ts +2 -2
- package/dist/models/contract-restriction-confirm-input-dto.js +2 -2
- package/dist/models/create-bid-request-dto.d.ts +5 -5
- package/dist/models/create-bid-request-dto.js +2 -2
- package/dist/models/create-card-payment-dto.d.ts +41 -0
- package/dist/models/create-card-payment-dto.js +15 -0
- package/dist/models/create-card-payment-request-dto.d.ts +4 -4
- package/dist/models/create-card-payment-request-dto.js +2 -2
- package/dist/models/create-card-payment200-response.d.ts +21 -0
- package/dist/models/create-card-payment200-response.js +15 -0
- package/dist/models/create-external-contract-documents-request-dto.d.ts +2 -2
- package/dist/models/create-external-contract-documents-request-dto.js +2 -2
- package/dist/models/create-external-contract-documents-response-dto.d.ts +2 -2
- package/dist/models/create-external-contract-documents-response-dto.js +2 -2
- package/dist/models/delivery-date-type-public.d.ts +20 -0
- package/dist/models/delivery-date-type-public.js +24 -0
- package/dist/models/delivery-method-public.d.ts +20 -0
- package/dist/models/delivery-method-public.js +24 -0
- package/dist/models/excellent-procurement-public.d.ts +31 -0
- package/dist/models/excellent-procurement-public.js +35 -0
- package/dist/models/external-contract-document-item-dto.d.ts +2 -2
- package/dist/models/external-contract-document-item-dto.js +2 -2
- package/dist/models/external-contract-documents-response-dto.d.ts +2 -2
- package/dist/models/external-contract-documents-response-dto.js +2 -2
- package/dist/models/external-contract-item-dto.d.ts +2 -2
- package/dist/models/external-contract-item-dto.js +2 -2
- package/dist/models/external-contract-snapshot-dto.d.ts +2 -2
- package/dist/models/external-contract-snapshot-dto.js +2 -2
- package/dist/models/external-document-inputs-dto.d.ts +2 -2
- package/dist/models/external-document-inputs-dto.js +2 -2
- package/dist/models/file-meta-response-dto.d.ts +2 -2
- package/dist/models/file-meta-response-dto.js +2 -2
- package/dist/models/file-uploaded-response-dto.d.ts +3 -3
- package/dist/models/file-uploaded-response-dto.js +2 -2
- package/dist/models/generated-external-contract-document-dto.d.ts +2 -2
- package/dist/models/generated-external-contract-document-dto.js +2 -2
- package/dist/models/get-bid-settlement200-response.d.ts +2 -2
- package/dist/models/get-bid-settlement200-response.js +2 -2
- package/dist/models/get-bid-statement200-response.d.ts +2 -2
- package/dist/models/get-bid-statement200-response.js +2 -2
- package/dist/models/get-bid200-response.d.ts +2 -2
- package/dist/models/get-bid200-response.js +2 -2
- package/dist/models/get-file-meta200-response.d.ts +2 -2
- package/dist/models/get-file-meta200-response.js +2 -2
- package/dist/models/get-supplier-card-payable-v2200-response.d.ts +21 -0
- package/dist/models/get-supplier-card-payable-v2200-response.js +15 -0
- package/dist/models/green-product-public.d.ts +21 -0
- package/dist/models/green-product-public.js +25 -0
- package/dist/models/health-controller-check200-response.d.ts +2 -2
- package/dist/models/health-controller-check200-response.js +2 -2
- package/dist/models/health-response-dto.d.ts +2 -2
- package/dist/models/health-response-dto.js +2 -2
- package/dist/models/hierarchical-region-dto.d.ts +2 -2
- package/dist/models/hierarchical-region-dto.js +2 -2
- package/dist/models/index.d.ts +22 -39
- package/dist/models/index.js +22 -39
- package/dist/models/introspect-request-dto.d.ts +2 -2
- package/dist/models/introspect-request-dto.js +2 -2
- package/dist/models/introspection-response-dto.d.ts +2 -2
- package/dist/models/introspection-response-dto.js +2 -2
- package/dist/models/invalid-param-dto.d.ts +3 -3
- package/dist/models/invalid-param-dto.js +2 -2
- package/dist/models/invoice-completed-response-dto.d.ts +2 -2
- package/dist/models/invoice-completed-response-dto.js +2 -2
- package/dist/models/invoice-split-response-dto.d.ts +17 -0
- package/dist/models/invoice-split-response-dto.js +15 -0
- package/dist/models/legal-mandatory-public.d.ts +25 -0
- package/dist/models/legal-mandatory-public.js +29 -0
- package/dist/models/list-bid-results200-response.d.ts +2 -2
- package/dist/models/list-bid-results200-response.js +2 -2
- package/dist/models/list-bids-response-dto.d.ts +2 -2
- package/dist/models/list-bids-response-dto.js +2 -2
- package/dist/models/list-bids200-response.d.ts +2 -2
- package/dist/models/list-bids200-response.js +2 -2
- package/dist/models/list-products200-response.d.ts +21 -0
- package/dist/models/list-products200-response.js +15 -0
- package/dist/models/mark-bid-failed-request-dto.d.ts +3 -3
- package/dist/models/mark-bid-failed-request-dto.js +2 -2
- package/dist/models/mark-bid-failed201-response.d.ts +2 -2
- package/dist/models/mark-bid-failed201-response.js +2 -2
- package/dist/models/negotiation-score-dto.d.ts +25 -0
- package/dist/models/negotiation-score-dto.js +15 -0
- package/dist/models/negotiation-scored-v2-response-dto.d.ts +29 -0
- package/dist/models/negotiation-scored-v2-response-dto.js +19 -0
- package/dist/models/oauth-error-response-dto.d.ts +2 -2
- package/dist/models/oauth-error-response-dto.js +2 -2
- package/dist/models/payment-method-public.d.ts +19 -0
- package/dist/models/payment-method-public.js +23 -0
- package/dist/models/preconditions-dto.d.ts +11 -50
- package/dist/models/preconditions-dto.js +2 -34
- package/dist/models/problem-details-dto.d.ts +3 -3
- package/dist/models/problem-details-dto.js +2 -2
- package/dist/models/product-receipt-response-dto.d.ts +17 -0
- package/dist/models/product-receipt-response-dto.js +15 -0
- package/dist/models/product-response-dto.d.ts +77 -0
- package/dist/models/product-response-dto.js +15 -0
- package/dist/models/protected-resource-metadata-dto.d.ts +2 -2
- package/dist/models/protected-resource-metadata-dto.js +2 -2
- package/dist/models/register-award-request-dto.d.ts +4 -4
- package/dist/models/register-award-request-dto.js +2 -2
- package/dist/models/register-award201-response.d.ts +2 -2
- package/dist/models/register-award201-response.js +2 -2
- package/dist/models/register-bid201-response.d.ts +2 -2
- package/dist/models/register-bid201-response.js +2 -2
- package/dist/models/register-semo-contract-request-dto.d.ts +2 -2
- package/dist/models/register-semo-contract-request-dto.js +2 -2
- package/dist/models/request-invoice-split-request-dto.d.ts +25 -0
- package/dist/models/request-invoice-split-request-dto.js +15 -0
- package/dist/models/request-invoice-split200-response.d.ts +21 -0
- package/dist/models/request-invoice-split200-response.js +15 -0
- package/dist/models/retiree-roster-input-dto.d.ts +2 -2
- package/dist/models/retiree-roster-input-dto.js +2 -2
- package/dist/models/retiree-roster-row-dto.d.ts +2 -2
- package/dist/models/retiree-roster-row-dto.js +2 -2
- package/dist/models/revert-award-request-dto.d.ts +2 -2
- package/dist/models/revert-award-request-dto.js +2 -2
- package/dist/models/revert-award200-response.d.ts +2 -2
- package/dist/models/revert-award200-response.js +2 -2
- package/dist/models/revoke-request-dto.d.ts +2 -2
- package/dist/models/revoke-request-dto.js +2 -2
- package/dist/models/semo-contract-registered-response-dto.d.ts +2 -2
- package/dist/models/semo-contract-registered-response-dto.js +2 -2
- package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
- package/dist/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
- package/dist/models/statement-document-dto.d.ts +2 -2
- package/dist/models/statement-document-dto.js +2 -2
- package/dist/models/statement-product-dto.d.ts +3 -3
- package/dist/models/statement-product-dto.js +2 -2
- package/dist/models/submit-negotiation-scores-request-dto.d.ts +22 -0
- package/dist/models/submit-negotiation-scores-request-dto.js +15 -0
- package/dist/models/submit-negotiation-scores201-response.d.ts +21 -0
- package/dist/models/submit-negotiation-scores201-response.js +15 -0
- package/dist/models/supplier-card-payable-response-dto.d.ts +2 -2
- package/dist/models/supplier-card-payable-response-dto.js +2 -2
- package/dist/models/supplier-tax-type.d.ts +2 -2
- package/dist/models/supplier-tax-type.js +2 -2
- package/dist/models/token-request-dto.d.ts +2 -2
- package/dist/models/token-request-dto.js +2 -2
- package/dist/models/token-response-dto.d.ts +2 -2
- package/dist/models/token-response-dto.js +2 -2
- package/dist/models/update-bid-request-dto.d.ts +7 -7
- package/dist/models/update-bid-request-dto.js +2 -2
- package/dist/models/update-bid200-response.d.ts +2 -2
- package/dist/models/update-bid200-response.js +2 -2
- package/dist/models/upload-file-request-dto.d.ts +3 -3
- package/dist/models/upload-file-request-dto.js +2 -2
- package/dist/models/upload-file201-response.d.ts +2 -2
- package/dist/models/upload-file201-response.js +2 -2
- package/dist/partner-client.d.ts +2 -2
- package/dist/partner-client.js +1 -1
- package/docs/AcceptanceResultResponseDto.md +1 -1
- package/docs/AcknowledgeProductReceipt200Response.md +22 -0
- package/docs/AcknowledgeProductsRequestDto.md +20 -0
- package/docs/AwardMethodPublic.md +1 -1
- package/docs/AwardRegisteredV2ResponseDto.md +3 -3
- package/docs/AwardRevertedV2ResponseDto.md +2 -2
- package/docs/BidCancelledResponseDto.md +2 -2
- package/docs/BidDeliveryTermsDto.md +2 -2
- package/docs/BidDetailResponseDto.md +3 -3
- package/docs/BidFailedV2ResponseDto.md +2 -2
- package/docs/BidLifecycleDto.md +1 -1
- package/docs/BidPaymentTermsDto.md +1 -1
- package/docs/BidResultsResponseDto.md +1 -1
- package/docs/BidSummaryDto.md +6 -6
- package/docs/BidTypePublic.md +11 -0
- package/docs/CompleteAcceptanceRequestDto.md +2 -4
- package/docs/CreateBidRequestDto.md +6 -6
- package/docs/CreateCardPayment200Response.md +22 -0
- package/docs/CreateCardPaymentDto.md +32 -0
- package/docs/CreateCardPaymentRequestDto.md +2 -2
- package/docs/DeliveryDateTypePublic.md +13 -0
- package/docs/DeliveryMethodPublic.md +13 -0
- package/docs/ExcellentProcurementPublic.md +35 -0
- package/docs/FileUploadedResponseDto.md +1 -1
- package/docs/GetSupplierCardPayableV2200Response.md +22 -0
- package/docs/GreenProductPublic.md +15 -0
- package/docs/InvalidParamDto.md +1 -1
- package/docs/{AcceptanceResultV1ResponseDto.md → InvoiceSplitResponseDto.md} +4 -4
- package/docs/LegalMandatoryPublic.md +23 -0
- package/docs/ListProducts200Response.md +22 -0
- package/docs/MarkBidFailedRequestDto.md +1 -1
- package/docs/NegotiationScoreDto.md +24 -0
- package/docs/NegotiationScoredV2ResponseDto.md +24 -0
- package/docs/{PartnerV2Api.md → PartnerApiApi.md} +353 -207
- package/docs/PaymentMethodPublic.md +11 -0
- package/docs/PreconditionsDto.md +3 -7
- package/docs/ProblemDetailsDto.md +1 -1
- package/docs/ProductReceiptResponseDto.md +20 -0
- package/docs/ProductResponseDto.md +50 -0
- package/docs/ProductsApi.md +124 -0
- package/docs/RegisterAwardRequestDto.md +2 -2
- package/docs/RequestInvoiceSplit200Response.md +22 -0
- package/docs/RequestInvoiceSplitRequestDto.md +24 -0
- package/docs/StatementProductDto.md +2 -2
- package/docs/SubmitNegotiationScores201Response.md +22 -0
- package/docs/SubmitNegotiationScoresRequestDto.md +22 -0
- package/docs/UpdateBidRequestDto.md +10 -10
- package/docs/UploadFileRequestDto.md +1 -1
- package/index.ts +2 -2
- package/models/acceptance-result-response-dto.ts +3 -3
- package/models/acknowledge-product-receipt200-response.ts +27 -0
- package/models/acknowledge-products-request-dto.ts +23 -0
- package/models/api-catalog-dto.ts +2 -2
- package/models/api-catalog-entry-dto.ts +2 -2
- package/models/api-catalog-link-dto.ts +2 -2
- package/models/authorization-server-metadata-dto.ts +2 -2
- package/models/award-method-public.ts +3 -3
- package/models/award-registered-v2-response-dto.ts +5 -5
- package/models/award-reverted-v2-response-dto.ts +4 -4
- package/models/bid-acceptance-dto.ts +2 -2
- package/models/bid-bond-dto.ts +2 -2
- package/models/bid-cancelled-response-dto.ts +4 -4
- package/models/bid-contact-dto.ts +2 -2
- package/models/bid-contacts-dto.ts +2 -2
- package/models/bid-contract-document-dto.ts +2 -2
- package/models/bid-delivery-terms-dto.ts +12 -4
- package/models/bid-detail-response-dto.ts +5 -5
- package/models/bid-document-dto.ts +2 -2
- package/models/bid-failed-v2-response-dto.ts +4 -4
- package/models/bid-item-dto.ts +2 -2
- package/models/bid-lifecycle-dto.ts +3 -3
- package/models/bid-manager-dto.ts +2 -2
- package/models/bid-payment-terms-dto.ts +8 -3
- package/models/bid-product-dto.ts +2 -2
- package/models/bid-public-status.ts +2 -2
- package/models/bid-registered-response-dto.ts +2 -2
- package/models/bid-result-participant-attachment-dto.ts +2 -2
- package/models/bid-result-participant-dto.ts +2 -2
- package/models/bid-results-response-dto.ts +3 -3
- package/models/bid-settlement-line-item-dto.ts +2 -2
- package/models/bid-settlement-participant-dto.ts +2 -2
- package/models/bid-settlement-response-dto.ts +2 -2
- package/models/bid-statement-response-dto.ts +2 -2
- package/models/bid-summary-dto.ts +11 -8
- package/models/bid-type-public.ts +29 -0
- package/models/bid-updated-response-dto.ts +2 -2
- package/models/cancel-bid-request-dto.ts +2 -2
- package/models/cancel-bid200-response.ts +2 -2
- package/models/card-payment-request-response-dto.ts +2 -2
- package/models/complete-acceptance-request-dto.ts +4 -8
- package/models/complete-acceptance200-response.ts +2 -2
- package/models/complete-invoice200-response.ts +2 -2
- package/models/contract-restriction-confirm-input-dto.ts +2 -2
- package/models/create-bid-request-dto.ts +5 -5
- package/models/create-card-payment-dto.ts +47 -0
- package/models/create-card-payment-request-dto.ts +4 -4
- package/models/create-card-payment200-response.ts +27 -0
- package/models/create-external-contract-documents-request-dto.ts +2 -2
- package/models/create-external-contract-documents-response-dto.ts +2 -2
- package/models/delivery-date-type-public.ts +30 -0
- package/models/delivery-method-public.ts +30 -0
- package/models/excellent-procurement-public.ts +41 -0
- package/models/external-contract-document-item-dto.ts +2 -2
- package/models/external-contract-documents-response-dto.ts +2 -2
- package/models/external-contract-item-dto.ts +2 -2
- package/models/external-contract-snapshot-dto.ts +2 -2
- package/models/external-document-inputs-dto.ts +2 -2
- package/models/file-meta-response-dto.ts +2 -2
- package/models/file-uploaded-response-dto.ts +3 -3
- package/models/generated-external-contract-document-dto.ts +2 -2
- package/models/get-bid-settlement200-response.ts +2 -2
- package/models/get-bid-statement200-response.ts +2 -2
- package/models/get-bid200-response.ts +2 -2
- package/models/get-file-meta200-response.ts +2 -2
- package/models/get-supplier-card-payable-v2200-response.ts +27 -0
- package/models/green-product-public.ts +31 -0
- package/models/health-controller-check200-response.ts +2 -2
- package/models/health-response-dto.ts +2 -2
- package/models/hierarchical-region-dto.ts +2 -2
- package/models/index.ts +22 -39
- package/models/introspect-request-dto.ts +2 -2
- package/models/introspection-response-dto.ts +2 -2
- package/models/invalid-param-dto.ts +3 -3
- package/models/invoice-completed-response-dto.ts +2 -2
- package/models/invoice-split-response-dto.ts +23 -0
- package/models/legal-mandatory-public.ts +35 -0
- package/models/list-bid-results200-response.ts +2 -2
- package/models/list-bids-response-dto.ts +2 -2
- package/models/list-bids200-response.ts +2 -2
- package/models/list-products200-response.ts +27 -0
- package/models/mark-bid-failed-request-dto.ts +3 -3
- package/models/mark-bid-failed201-response.ts +2 -2
- package/models/negotiation-score-dto.ts +31 -0
- package/models/negotiation-scored-v2-response-dto.ts +38 -0
- package/models/oauth-error-response-dto.ts +2 -2
- package/models/payment-method-public.ts +29 -0
- package/models/preconditions-dto.ts +17 -55
- package/models/problem-details-dto.ts +3 -3
- package/models/product-receipt-response-dto.ts +23 -0
- package/models/product-response-dto.ts +83 -0
- package/models/protected-resource-metadata-dto.ts +2 -2
- package/models/register-award-request-dto.ts +4 -4
- package/models/register-award201-response.ts +2 -2
- package/models/register-bid201-response.ts +2 -2
- package/models/register-semo-contract-request-dto.ts +2 -2
- package/models/request-invoice-split-request-dto.ts +31 -0
- package/models/request-invoice-split200-response.ts +27 -0
- package/models/retiree-roster-input-dto.ts +2 -2
- package/models/retiree-roster-row-dto.ts +2 -2
- package/models/revert-award-request-dto.ts +2 -2
- package/models/revert-award200-response.ts +2 -2
- package/models/revoke-request-dto.ts +2 -2
- package/models/semo-contract-registered-response-dto.ts +2 -2
- package/models/semo-contract-taxinvoice-status-response-dto.ts +2 -2
- package/models/statement-document-dto.ts +2 -2
- package/models/statement-product-dto.ts +3 -3
- package/models/submit-negotiation-scores-request-dto.ts +30 -0
- package/models/submit-negotiation-scores201-response.ts +27 -0
- package/models/supplier-card-payable-response-dto.ts +2 -2
- package/models/supplier-tax-type.ts +2 -2
- package/models/token-request-dto.ts +2 -2
- package/models/token-response-dto.ts +2 -2
- package/models/update-bid-request-dto.ts +7 -7
- package/models/update-bid200-response.ts +2 -2
- package/models/upload-file-request-dto.ts +3 -3
- package/models/upload-file201-response.ts +2 -2
- package/package.json +1 -1
- package/partner-client.ts +3 -3
- package/api/partner-v1-api.ts +0 -998
- package/dist/api/partner-v1-api.d.ts +0 -440
- package/dist/api/partner-v1-api.js +0 -913
- package/dist/esm/api/partner-v1-api.d.ts +0 -440
- package/dist/esm/api/partner-v1-api.js +0 -906
- package/dist/esm/models/acceptance-result-v1-response-dto.d.ts +0 -17
- package/dist/esm/models/acceptance-result-v1-response-dto.js +0 -14
- package/dist/esm/models/acknowledge-products-v1-request-dto.d.ts +0 -17
- package/dist/esm/models/acknowledge-products-v1-request-dto.js +0 -14
- package/dist/esm/models/award-registered-response-dto.d.ts +0 -17
- package/dist/esm/models/award-registered-response-dto.js +0 -14
- package/dist/esm/models/bid-attachment-v1-dto.d.ts +0 -21
- package/dist/esm/models/bid-attachment-v1-dto.js +0 -14
- package/dist/esm/models/bid-bond-v1-dto.d.ts +0 -27
- package/dist/esm/models/bid-bond-v1-dto.js +0 -18
- package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.d.ts +0 -17
- package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.js +0 -14
- package/dist/esm/models/bid-contract-documents-v1-response-dto.d.ts +0 -30
- package/dist/esm/models/bid-contract-documents-v1-response-dto.js +0 -14
- package/dist/esm/models/bid-created-response-dto.d.ts +0 -21
- package/dist/esm/models/bid-created-response-dto.js +0 -14
- package/dist/esm/models/bid-document-v1-dto.d.ts +0 -25
- package/dist/esm/models/bid-document-v1-dto.js +0 -14
- package/dist/esm/models/bid-failed-response-dto.d.ts +0 -17
- package/dist/esm/models/bid-failed-response-dto.js +0 -14
- package/dist/esm/models/bid-failure-reason.d.ts +0 -25
- package/dist/esm/models/bid-failure-reason.js +0 -26
- package/dist/esm/models/bid-item-v1-dto.d.ts +0 -41
- package/dist/esm/models/bid-item-v1-dto.js +0 -14
- package/dist/esm/models/bid-manager-v1-dto.d.ts +0 -33
- package/dist/esm/models/bid-manager-v1-dto.js +0 -14
- package/dist/esm/models/bid-result-v1-attachment-dto.d.ts +0 -33
- package/dist/esm/models/bid-result-v1-attachment-dto.js +0 -14
- package/dist/esm/models/bid-result-v1-bid-product-info-dto.d.ts +0 -45
- package/dist/esm/models/bid-result-v1-bid-product-info-dto.js +0 -14
- package/dist/esm/models/bid-result-v1-participant-dto.d.ts +0 -183
- package/dist/esm/models/bid-result-v1-participant-dto.js +0 -14
- package/dist/esm/models/bid-result-v1-product-dto.d.ts +0 -53
- package/dist/esm/models/bid-result-v1-product-dto.js +0 -14
- package/dist/esm/models/bid-results-batch-v1-request-dto.d.ts +0 -25
- package/dist/esm/models/bid-results-batch-v1-request-dto.js +0 -14
- package/dist/esm/models/bid-results-v1-response-dto.d.ts +0 -164
- package/dist/esm/models/bid-results-v1-response-dto.js +0 -14
- package/dist/esm/models/bid-statement-v1-response-dto.d.ts +0 -31
- package/dist/esm/models/bid-statement-v1-response-dto.js +0 -14
- package/dist/esm/models/bid-status.d.ts +0 -23
- package/dist/esm/models/bid-status.js +0 -24
- package/dist/esm/models/complete-acceptance-v1-request-dto.d.ts +0 -65
- package/dist/esm/models/complete-acceptance-v1-request-dto.js +0 -14
- package/dist/esm/models/contract-document-item-dto.d.ts +0 -45
- package/dist/esm/models/contract-document-item-dto.js +0 -14
- package/dist/esm/models/create-bid-v1-request-dto.d.ts +0 -331
- package/dist/esm/models/create-bid-v1-request-dto.js +0 -113
- package/dist/esm/models/file-uploaded-v1-response-dto.d.ts +0 -17
- package/dist/esm/models/file-uploaded-v1-response-dto.js +0 -14
- package/dist/esm/models/hierarchical-region-v1-dto.d.ts +0 -21
- package/dist/esm/models/hierarchical-region-v1-dto.js +0 -14
- package/dist/esm/models/mark-bid-failed-v1-request-dto.d.ts +0 -26
- package/dist/esm/models/mark-bid-failed-v1-request-dto.js +0 -14
- package/dist/esm/models/negotiation-score-v1-dto.d.ts +0 -25
- package/dist/esm/models/negotiation-score-v1-dto.js +0 -14
- package/dist/esm/models/negotiation-scored-response-dto.d.ts +0 -17
- package/dist/esm/models/negotiation-scored-response-dto.js +0 -14
- package/dist/esm/models/preconditions-v1-dto.d.ts +0 -88
- package/dist/esm/models/preconditions-v1-dto.js +0 -44
- package/dist/esm/models/product-receipt-v1-response-dto.d.ts +0 -17
- package/dist/esm/models/product-receipt-v1-response-dto.js +0 -14
- package/dist/esm/models/product-v1-response-dto.d.ts +0 -105
- package/dist/esm/models/product-v1-response-dto.js +0 -14
- package/dist/esm/models/register-award-v1-request-dto.d.ts +0 -33
- package/dist/esm/models/register-award-v1-request-dto.js +0 -14
- package/dist/esm/models/request-split-invoice-v1-request-dto.d.ts +0 -29
- package/dist/esm/models/request-split-invoice-v1-request-dto.js +0 -14
- package/dist/esm/models/split-invoice-v1-response-dto.d.ts +0 -17
- package/dist/esm/models/split-invoice-v1-response-dto.js +0 -14
- package/dist/esm/models/statement-v1-document-dto.d.ts +0 -33
- package/dist/esm/models/statement-v1-document-dto.js +0 -14
- package/dist/esm/models/statement-v1-product-dto.d.ts +0 -49
- package/dist/esm/models/statement-v1-product-dto.js +0 -14
- package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +0 -22
- package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +0 -14
- package/dist/esm/models/upload-file-v1-request-dto.d.ts +0 -25
- package/dist/esm/models/upload-file-v1-request-dto.js +0 -14
- package/dist/models/acceptance-result-v1-response-dto.d.ts +0 -17
- package/dist/models/acceptance-result-v1-response-dto.js +0 -15
- package/dist/models/acknowledge-products-v1-request-dto.d.ts +0 -17
- package/dist/models/acknowledge-products-v1-request-dto.js +0 -15
- package/dist/models/award-registered-response-dto.d.ts +0 -17
- package/dist/models/award-registered-response-dto.js +0 -15
- package/dist/models/bid-attachment-v1-dto.d.ts +0 -21
- package/dist/models/bid-attachment-v1-dto.js +0 -15
- package/dist/models/bid-bond-v1-dto.d.ts +0 -27
- package/dist/models/bid-bond-v1-dto.js +0 -21
- package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +0 -17
- package/dist/models/bid-contract-documents-batch-v1-request-dto.js +0 -15
- package/dist/models/bid-contract-documents-v1-response-dto.d.ts +0 -30
- package/dist/models/bid-contract-documents-v1-response-dto.js +0 -15
- package/dist/models/bid-created-response-dto.d.ts +0 -21
- package/dist/models/bid-created-response-dto.js +0 -15
- package/dist/models/bid-document-v1-dto.d.ts +0 -25
- package/dist/models/bid-document-v1-dto.js +0 -15
- package/dist/models/bid-failed-response-dto.d.ts +0 -17
- package/dist/models/bid-failed-response-dto.js +0 -15
- package/dist/models/bid-failure-reason.d.ts +0 -25
- package/dist/models/bid-failure-reason.js +0 -29
- package/dist/models/bid-item-v1-dto.d.ts +0 -41
- package/dist/models/bid-item-v1-dto.js +0 -15
- package/dist/models/bid-manager-v1-dto.d.ts +0 -33
- package/dist/models/bid-manager-v1-dto.js +0 -15
- package/dist/models/bid-result-v1-attachment-dto.d.ts +0 -33
- package/dist/models/bid-result-v1-attachment-dto.js +0 -15
- package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +0 -45
- package/dist/models/bid-result-v1-bid-product-info-dto.js +0 -15
- package/dist/models/bid-result-v1-participant-dto.d.ts +0 -183
- package/dist/models/bid-result-v1-participant-dto.js +0 -15
- package/dist/models/bid-result-v1-product-dto.d.ts +0 -53
- package/dist/models/bid-result-v1-product-dto.js +0 -15
- package/dist/models/bid-results-batch-v1-request-dto.d.ts +0 -25
- package/dist/models/bid-results-batch-v1-request-dto.js +0 -15
- package/dist/models/bid-results-v1-response-dto.d.ts +0 -164
- package/dist/models/bid-results-v1-response-dto.js +0 -15
- package/dist/models/bid-statement-v1-response-dto.d.ts +0 -31
- package/dist/models/bid-statement-v1-response-dto.js +0 -15
- package/dist/models/bid-status.d.ts +0 -23
- package/dist/models/bid-status.js +0 -27
- package/dist/models/complete-acceptance-v1-request-dto.d.ts +0 -65
- package/dist/models/complete-acceptance-v1-request-dto.js +0 -15
- package/dist/models/contract-document-item-dto.d.ts +0 -45
- package/dist/models/contract-document-item-dto.js +0 -15
- package/dist/models/create-bid-v1-request-dto.d.ts +0 -331
- package/dist/models/create-bid-v1-request-dto.js +0 -116
- package/dist/models/file-uploaded-v1-response-dto.d.ts +0 -17
- package/dist/models/file-uploaded-v1-response-dto.js +0 -15
- package/dist/models/hierarchical-region-v1-dto.d.ts +0 -21
- package/dist/models/hierarchical-region-v1-dto.js +0 -15
- package/dist/models/mark-bid-failed-v1-request-dto.d.ts +0 -26
- package/dist/models/mark-bid-failed-v1-request-dto.js +0 -15
- package/dist/models/negotiation-score-v1-dto.d.ts +0 -25
- package/dist/models/negotiation-score-v1-dto.js +0 -15
- package/dist/models/negotiation-scored-response-dto.d.ts +0 -17
- package/dist/models/negotiation-scored-response-dto.js +0 -15
- package/dist/models/preconditions-v1-dto.d.ts +0 -88
- package/dist/models/preconditions-v1-dto.js +0 -47
- package/dist/models/product-receipt-v1-response-dto.d.ts +0 -17
- package/dist/models/product-receipt-v1-response-dto.js +0 -15
- package/dist/models/product-v1-response-dto.d.ts +0 -105
- package/dist/models/product-v1-response-dto.js +0 -15
- package/dist/models/register-award-v1-request-dto.d.ts +0 -33
- package/dist/models/register-award-v1-request-dto.js +0 -15
- package/dist/models/request-split-invoice-v1-request-dto.d.ts +0 -29
- package/dist/models/request-split-invoice-v1-request-dto.js +0 -15
- package/dist/models/split-invoice-v1-response-dto.d.ts +0 -17
- package/dist/models/split-invoice-v1-response-dto.js +0 -15
- package/dist/models/statement-v1-document-dto.d.ts +0 -33
- package/dist/models/statement-v1-document-dto.js +0 -15
- package/dist/models/statement-v1-product-dto.d.ts +0 -49
- package/dist/models/statement-v1-product-dto.js +0 -15
- package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +0 -22
- package/dist/models/submit-negotiation-scores-v1-request-dto.js +0 -15
- package/dist/models/upload-file-v1-request-dto.d.ts +0 -25
- package/dist/models/upload-file-v1-request-dto.js +0 -15
- package/docs/AcknowledgeProductsV1RequestDto.md +0 -20
- package/docs/AwardRegisteredResponseDto.md +0 -20
- package/docs/BidAttachmentV1Dto.md +0 -22
- package/docs/BidBondV1Dto.md +0 -22
- package/docs/BidContractDocumentsBatchV1RequestDto.md +0 -20
- package/docs/BidContractDocumentsV1ResponseDto.md +0 -26
- package/docs/BidCreatedResponseDto.md +0 -22
- package/docs/BidDocumentV1Dto.md +0 -24
- package/docs/BidFailedResponseDto.md +0 -20
- package/docs/BidFailureReason.md +0 -23
- package/docs/BidItemV1Dto.md +0 -32
- package/docs/BidManagerV1Dto.md +0 -28
- package/docs/BidResultV1AttachmentDto.md +0 -28
- package/docs/BidResultV1BidProductInfoDto.md +0 -34
- package/docs/BidResultV1ParticipantDto.md +0 -102
- package/docs/BidResultV1ProductDto.md +0 -38
- package/docs/BidResultsBatchV1RequestDto.md +0 -24
- package/docs/BidResultsV1ResponseDto.md +0 -92
- package/docs/BidStatementV1ResponseDto.md +0 -26
- package/docs/BidStatus.md +0 -19
- package/docs/CompleteAcceptanceV1RequestDto.md +0 -44
- package/docs/ContractDocumentItemDto.md +0 -34
- package/docs/CreateBidV1RequestDto.md +0 -114
- package/docs/FileUploadedV1ResponseDto.md +0 -20
- package/docs/HierarchicalRegionV1Dto.md +0 -22
- package/docs/MarkBidFailedV1RequestDto.md +0 -24
- package/docs/NegotiationScoreV1Dto.md +0 -24
- package/docs/NegotiationScoredResponseDto.md +0 -20
- package/docs/PartnerV1Api.md +0 -707
- package/docs/PreconditionsV1Dto.md +0 -38
- package/docs/ProductReceiptV1ResponseDto.md +0 -20
- package/docs/ProductV1ResponseDto.md +0 -64
- package/docs/RegisterAwardV1RequestDto.md +0 -28
- package/docs/RequestSplitInvoiceV1RequestDto.md +0 -26
- package/docs/SplitInvoiceV1ResponseDto.md +0 -20
- package/docs/StatementV1DocumentDto.md +0 -28
- package/docs/StatementV1ProductDto.md +0 -36
- package/docs/SubmitNegotiationScoresV1RequestDto.md +0 -22
- package/docs/UploadFileV1RequestDto.md +0 -24
- package/models/acceptance-result-v1-response-dto.ts +0 -23
- package/models/acknowledge-products-v1-request-dto.ts +0 -23
- package/models/award-registered-response-dto.ts +0 -23
- package/models/bid-attachment-v1-dto.ts +0 -27
- package/models/bid-bond-v1-dto.ts +0 -36
- package/models/bid-contract-documents-batch-v1-request-dto.ts +0 -23
- package/models/bid-contract-documents-v1-response-dto.ts +0 -38
- package/models/bid-created-response-dto.ts +0 -27
- package/models/bid-document-v1-dto.ts +0 -31
- package/models/bid-failed-response-dto.ts +0 -23
- package/models/bid-failure-reason.ts +0 -35
- package/models/bid-item-v1-dto.ts +0 -47
- package/models/bid-manager-v1-dto.ts +0 -39
- package/models/bid-result-v1-attachment-dto.ts +0 -39
- package/models/bid-result-v1-bid-product-info-dto.ts +0 -51
- package/models/bid-result-v1-participant-dto.ts +0 -193
- package/models/bid-result-v1-product-dto.ts +0 -59
- package/models/bid-results-batch-v1-request-dto.ts +0 -31
- package/models/bid-results-v1-response-dto.ts +0 -178
- package/models/bid-statement-v1-response-dto.ts +0 -41
- package/models/bid-status.ts +0 -33
- package/models/complete-acceptance-v1-request-dto.ts +0 -71
- package/models/contract-document-item-dto.ts +0 -51
- package/models/create-bid-v1-request-dto.ts +0 -371
- package/models/file-uploaded-v1-response-dto.ts +0 -23
- package/models/hierarchical-region-v1-dto.ts +0 -27
- package/models/mark-bid-failed-v1-request-dto.ts +0 -36
- package/models/negotiation-score-v1-dto.ts +0 -31
- package/models/negotiation-scored-response-dto.ts +0 -23
- package/models/preconditions-v1-dto.ts +0 -101
- package/models/product-receipt-v1-response-dto.ts +0 -23
- package/models/product-v1-response-dto.ts +0 -111
- package/models/register-award-v1-request-dto.ts +0 -39
- package/models/request-split-invoice-v1-request-dto.ts +0 -35
- package/models/split-invoice-v1-response-dto.ts +0 -23
- package/models/statement-v1-document-dto.ts +0 -39
- package/models/statement-v1-product-dto.ts +0 -55
- package/models/submit-negotiation-scores-v1-request-dto.ts +0 -30
- package/models/upload-file-v1-request-dto.ts +0 -31
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
/* eslint-disable */
|
|
3
3
|
/**
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
|
-
* 외부 ERP 연동용 RESTful API. ##
|
|
5
|
+
* 외부 ERP 연동용 RESTful API. ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요. ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403 입니다. 대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요. ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다). 봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON 이 아닙니다. 에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다. ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json` 입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다. ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body 를 되돌리세요. ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다. `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실립니다. ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug 은 **HTTP status 로 폴백**해 분기하세요. ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document:
|
|
7
|
+
* The version of the OpenAPI document: 36.1.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).
|
|
@@ -27,15 +27,15 @@ import { DUMMY_BASE_URL, assertParamExists, setOAuthToObject, setSearchParams, s
|
|
|
27
27
|
// @ts-ignore
|
|
28
28
|
import { BASE_PATH, BaseAPI, operationServerMap } from '../base';
|
|
29
29
|
/**
|
|
30
|
-
*
|
|
30
|
+
* PartnerApiApi - axios parameter creator
|
|
31
31
|
*/
|
|
32
|
-
export const
|
|
32
|
+
export const PartnerApiApiAxiosParamCreator = function (configuration) {
|
|
33
33
|
return {
|
|
34
34
|
/**
|
|
35
35
|
* 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
|
|
36
36
|
* @summary 공고 취소
|
|
37
37
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
38
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
38
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
39
39
|
* @param {CancelBidRequestDto} cancelBidRequestDto
|
|
40
40
|
* @param {*} [options] Override http request option.
|
|
41
41
|
* @throws {RequiredError}
|
|
@@ -76,10 +76,10 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
76
76
|
};
|
|
77
77
|
}),
|
|
78
78
|
/**
|
|
79
|
-
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.
|
|
79
|
+
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 수 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
80
80
|
* @summary 검수완료 전송
|
|
81
81
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
82
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
82
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
83
83
|
* @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
|
|
84
84
|
* @param {*} [options] Override http request option.
|
|
85
85
|
* @throws {RequiredError}
|
|
@@ -121,9 +121,9 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
121
121
|
}),
|
|
122
122
|
/**
|
|
123
123
|
* 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
124
|
-
* @summary 정산 마감
|
|
124
|
+
* @summary 정산 마감
|
|
125
125
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
126
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
126
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
127
127
|
* @param {*} [options] Override http request option.
|
|
128
128
|
* @throws {RequiredError}
|
|
129
129
|
*/
|
|
@@ -159,20 +159,19 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
159
159
|
};
|
|
160
160
|
}),
|
|
161
161
|
/**
|
|
162
|
-
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동
|
|
163
|
-
* @summary 결제창 발행
|
|
164
|
-
* @param {string} idempotencyKey
|
|
165
|
-
* @param {
|
|
162
|
+
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
163
|
+
* @summary 결제창 발행
|
|
164
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
165
|
+
* @param {CreateCardPaymentDto} createCardPaymentDto
|
|
166
166
|
* @param {*} [options] Override http request option.
|
|
167
|
-
* @deprecated
|
|
168
167
|
* @throws {RequiredError}
|
|
169
168
|
*/
|
|
170
|
-
|
|
169
|
+
createCardPayment: (idempotencyKey_1, createCardPaymentDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, createCardPaymentDto_1, ...args_1], void 0, function* (idempotencyKey, createCardPaymentDto, options = {}) {
|
|
171
170
|
// verify required parameter 'idempotencyKey' is not null or undefined
|
|
172
|
-
assertParamExists('
|
|
173
|
-
// verify required parameter '
|
|
174
|
-
assertParamExists('
|
|
175
|
-
const localVarPath = `/v2/card-
|
|
171
|
+
assertParamExists('createCardPayment', 'idempotencyKey', idempotencyKey);
|
|
172
|
+
// verify required parameter 'createCardPaymentDto' is not null or undefined
|
|
173
|
+
assertParamExists('createCardPayment', 'createCardPaymentDto', createCardPaymentDto);
|
|
174
|
+
const localVarPath = `/v2/card-payments`;
|
|
176
175
|
// use dummy base URL string because the URL constructor only accepts absolute URLs.
|
|
177
176
|
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
|
|
178
177
|
let baseOptions;
|
|
@@ -193,7 +192,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
193
192
|
setSearchParams(localVarUrlObj, localVarQueryParameter);
|
|
194
193
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
195
194
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
196
|
-
localVarRequestOptions.data = serializeDataIfNeeded(
|
|
195
|
+
localVarRequestOptions.data = serializeDataIfNeeded(createCardPaymentDto, localVarRequestOptions, configuration);
|
|
197
196
|
return {
|
|
198
197
|
url: toPathString(localVarUrlObj),
|
|
199
198
|
options: localVarRequestOptions,
|
|
@@ -202,7 +201,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
202
201
|
/**
|
|
203
202
|
* 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
|
|
204
203
|
* @summary 계약서류 생성
|
|
205
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
204
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
206
205
|
* @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
|
|
207
206
|
* @param {*} [options] Override http request option.
|
|
208
207
|
* @throws {RequiredError}
|
|
@@ -240,8 +239,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
240
239
|
};
|
|
241
240
|
}),
|
|
242
241
|
/**
|
|
243
|
-
* 무인증 — `fileKey` 자체가 capability 다(
|
|
244
|
-
* @summary 파일 다운로드
|
|
242
|
+
* 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 곧 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
|
|
243
|
+
* @summary 파일 다운로드
|
|
245
244
|
* @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
|
|
246
245
|
* @param {*} [options] Override http request option.
|
|
247
246
|
* @throws {RequiredError}
|
|
@@ -269,7 +268,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
269
268
|
};
|
|
270
269
|
}),
|
|
271
270
|
/**
|
|
272
|
-
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요.
|
|
271
|
+
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
273
272
|
* @summary 공고 상세 조회
|
|
274
273
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
275
274
|
* @param {*} [options] Override http request option.
|
|
@@ -302,7 +301,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
302
301
|
};
|
|
303
302
|
}),
|
|
304
303
|
/**
|
|
305
|
-
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.
|
|
304
|
+
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
|
|
306
305
|
* @summary 정산 정보 조회
|
|
307
306
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
308
307
|
* @param {*} [options] Override http request option.
|
|
@@ -373,7 +372,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
373
372
|
}),
|
|
374
373
|
/**
|
|
375
374
|
* 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
|
|
376
|
-
* @summary 파일 조회
|
|
375
|
+
* @summary 파일 정보 조회
|
|
377
376
|
* @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
|
|
378
377
|
* @param {*} [options] Override http request option.
|
|
379
378
|
* @throws {RequiredError}
|
|
@@ -438,17 +437,16 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
438
437
|
};
|
|
439
438
|
}),
|
|
440
439
|
/**
|
|
441
|
-
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면
|
|
442
|
-
* @summary 공급사 카드결제 가능 여부
|
|
440
|
+
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 를 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
|
|
441
|
+
* @summary 공급사 카드결제 가능 여부
|
|
443
442
|
* @param {string} memberId 계약업체 회원 ID
|
|
444
443
|
* @param {*} [options] Override http request option.
|
|
445
|
-
* @deprecated
|
|
446
444
|
* @throws {RequiredError}
|
|
447
445
|
*/
|
|
448
|
-
|
|
446
|
+
getSupplierCardPayableV2: (memberId_1, ...args_1) => __awaiter(this, [memberId_1, ...args_1], void 0, function* (memberId, options = {}) {
|
|
449
447
|
// verify required parameter 'memberId' is not null or undefined
|
|
450
|
-
assertParamExists('
|
|
451
|
-
const localVarPath = `/v2/
|
|
448
|
+
assertParamExists('getSupplierCardPayableV2', 'memberId', memberId);
|
|
449
|
+
const localVarPath = `/v2/suppliers/{memberId}/card-payable`
|
|
452
450
|
.replace('{memberId}', encodeURIComponent(String(memberId)));
|
|
453
451
|
// use dummy base URL string because the URL constructor only accepts absolute URLs.
|
|
454
452
|
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
|
|
@@ -461,8 +459,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
461
459
|
const localVarQueryParameter = {};
|
|
462
460
|
// authentication partner-oauth2 required
|
|
463
461
|
// oauth required
|
|
464
|
-
yield setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["payments:
|
|
465
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
462
|
+
yield setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["payments:read"], configuration);
|
|
463
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
466
464
|
setSearchParams(localVarUrlObj, localVarQueryParameter);
|
|
467
465
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
468
466
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -498,15 +496,15 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
498
496
|
};
|
|
499
497
|
}),
|
|
500
498
|
/**
|
|
501
|
-
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.**
|
|
502
|
-
* @summary 공고 결과
|
|
503
|
-
* @param {string}
|
|
499
|
+
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 를 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
|
|
500
|
+
* @summary 공고 결과 조회
|
|
501
|
+
* @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidRefs` 를 반복해 전달합니다. 최대 100건입니다.
|
|
504
502
|
* @param {*} [options] Override http request option.
|
|
505
503
|
* @throws {RequiredError}
|
|
506
504
|
*/
|
|
507
|
-
listBidResults: (
|
|
508
|
-
// verify required parameter '
|
|
509
|
-
assertParamExists('listBidResults', '
|
|
505
|
+
listBidResults: (bidRefs_1, ...args_1) => __awaiter(this, [bidRefs_1, ...args_1], void 0, function* (bidRefs, options = {}) {
|
|
506
|
+
// verify required parameter 'bidRefs' is not null or undefined
|
|
507
|
+
assertParamExists('listBidResults', 'bidRefs', bidRefs);
|
|
510
508
|
const localVarPath = `/v2/bid-results`;
|
|
511
509
|
// use dummy base URL string because the URL constructor only accepts absolute URLs.
|
|
512
510
|
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
|
|
@@ -520,8 +518,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
520
518
|
// authentication partner-oauth2 required
|
|
521
519
|
// oauth required
|
|
522
520
|
yield setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:read"], configuration);
|
|
523
|
-
if (
|
|
524
|
-
localVarQueryParameter['
|
|
521
|
+
if (bidRefs !== undefined) {
|
|
522
|
+
localVarQueryParameter['bidRefs'] = bidRefs;
|
|
525
523
|
}
|
|
526
524
|
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
527
525
|
setSearchParams(localVarUrlObj, localVarQueryParameter);
|
|
@@ -537,13 +535,13 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
537
535
|
* @summary 공고 목록 조회
|
|
538
536
|
* @param {number} [limit] 페이지 크기(1~100, 기본 100).
|
|
539
537
|
* @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다.
|
|
540
|
-
* @param {Array<string>} [
|
|
541
|
-
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만
|
|
538
|
+
* @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
|
|
539
|
+
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
|
|
542
540
|
* @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
|
|
543
541
|
* @param {*} [options] Override http request option.
|
|
544
542
|
* @throws {RequiredError}
|
|
545
543
|
*/
|
|
546
|
-
listBids: (limit_1, cursor_1,
|
|
544
|
+
listBids: (limit_1, cursor_1, bidRefs_1, status_1, include_1, ...args_1) => __awaiter(this, [limit_1, cursor_1, bidRefs_1, status_1, include_1, ...args_1], void 0, function* (limit, cursor, bidRefs, status, include, options = {}) {
|
|
547
545
|
const localVarPath = `/v2/bids`;
|
|
548
546
|
// use dummy base URL string because the URL constructor only accepts absolute URLs.
|
|
549
547
|
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
|
|
@@ -563,8 +561,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
563
561
|
if (cursor !== undefined) {
|
|
564
562
|
localVarQueryParameter['cursor'] = cursor;
|
|
565
563
|
}
|
|
566
|
-
if (
|
|
567
|
-
localVarQueryParameter['
|
|
564
|
+
if (bidRefs) {
|
|
565
|
+
localVarQueryParameter['bidRefs'] = bidRefs;
|
|
568
566
|
}
|
|
569
567
|
if (status) {
|
|
570
568
|
localVarQueryParameter['status'] = status;
|
|
@@ -626,7 +624,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
626
624
|
* 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
627
625
|
* @summary 유찰 처리
|
|
628
626
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
629
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
627
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
630
628
|
* @param {MarkBidFailedRequestDto} markBidFailedRequestDto
|
|
631
629
|
* @param {*} [options] Override http request option.
|
|
632
630
|
* @throws {RequiredError}
|
|
@@ -670,7 +668,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
670
668
|
* 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
671
669
|
* @summary 낙찰 결과 전송
|
|
672
670
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
673
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
671
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
674
672
|
* @param {RegisterAwardRequestDto} registerAwardRequestDto
|
|
675
673
|
* @param {*} [options] Override http request option.
|
|
676
674
|
* @throws {RequiredError}
|
|
@@ -713,7 +711,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
713
711
|
/**
|
|
714
712
|
* 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
|
|
715
713
|
* @summary 공고 등록
|
|
716
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
714
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
717
715
|
* @param {CreateBidRequestDto} createBidRequestDto
|
|
718
716
|
* @param {*} [options] Override http request option.
|
|
719
717
|
* @throws {RequiredError}
|
|
@@ -753,7 +751,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
753
751
|
/**
|
|
754
752
|
* 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
755
753
|
* @summary 계약 발행대상 등록
|
|
756
|
-
* @param {string} idempotencyKey
|
|
754
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
757
755
|
* @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
|
|
758
756
|
* @param {*} [options] Override http request option.
|
|
759
757
|
* @throws {RequiredError}
|
|
@@ -790,11 +788,55 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
790
788
|
options: localVarRequestOptions,
|
|
791
789
|
};
|
|
792
790
|
}),
|
|
791
|
+
/**
|
|
792
|
+
* 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
|
|
793
|
+
* @summary 계산서 분할 발급 청구
|
|
794
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
795
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
796
|
+
* @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
|
|
797
|
+
* @param {*} [options] Override http request option.
|
|
798
|
+
* @throws {RequiredError}
|
|
799
|
+
*/
|
|
800
|
+
requestInvoiceSplit: (bidRef_1, idempotencyKey_1, requestInvoiceSplitRequestDto_1, ...args_1) => __awaiter(this, [bidRef_1, idempotencyKey_1, requestInvoiceSplitRequestDto_1, ...args_1], void 0, function* (bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options = {}) {
|
|
801
|
+
// verify required parameter 'bidRef' is not null or undefined
|
|
802
|
+
assertParamExists('requestInvoiceSplit', 'bidRef', bidRef);
|
|
803
|
+
// verify required parameter 'idempotencyKey' is not null or undefined
|
|
804
|
+
assertParamExists('requestInvoiceSplit', 'idempotencyKey', idempotencyKey);
|
|
805
|
+
// verify required parameter 'requestInvoiceSplitRequestDto' is not null or undefined
|
|
806
|
+
assertParamExists('requestInvoiceSplit', 'requestInvoiceSplitRequestDto', requestInvoiceSplitRequestDto);
|
|
807
|
+
const localVarPath = `/v2/bids/{bidRef}/invoice-splits`
|
|
808
|
+
.replace('{bidRef}', encodeURIComponent(String(bidRef)));
|
|
809
|
+
// use dummy base URL string because the URL constructor only accepts absolute URLs.
|
|
810
|
+
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
|
|
811
|
+
let baseOptions;
|
|
812
|
+
if (configuration) {
|
|
813
|
+
baseOptions = configuration.baseOptions;
|
|
814
|
+
}
|
|
815
|
+
const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
|
|
816
|
+
const localVarHeaderParameter = {};
|
|
817
|
+
const localVarQueryParameter = {};
|
|
818
|
+
// authentication partner-oauth2 required
|
|
819
|
+
// oauth required
|
|
820
|
+
yield setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["invoices:write"], configuration);
|
|
821
|
+
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
822
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
823
|
+
if (idempotencyKey != null) {
|
|
824
|
+
localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
|
|
825
|
+
}
|
|
826
|
+
setSearchParams(localVarUrlObj, localVarQueryParameter);
|
|
827
|
+
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
828
|
+
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
829
|
+
localVarRequestOptions.data = serializeDataIfNeeded(requestInvoiceSplitRequestDto, localVarRequestOptions, configuration);
|
|
830
|
+
return {
|
|
831
|
+
url: toPathString(localVarUrlObj),
|
|
832
|
+
options: localVarRequestOptions,
|
|
833
|
+
};
|
|
834
|
+
}),
|
|
793
835
|
/**
|
|
794
836
|
* 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
795
837
|
* @summary 낙찰 되돌리기
|
|
796
838
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
797
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
839
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
798
840
|
* @param {RevertAwardRequestDto} revertAwardRequestDto
|
|
799
841
|
* @param {*} [options] Override http request option.
|
|
800
842
|
* @throws {RequiredError}
|
|
@@ -835,12 +877,56 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
835
877
|
};
|
|
836
878
|
}),
|
|
837
879
|
/**
|
|
838
|
-
*
|
|
880
|
+
* 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
881
|
+
* @summary 협상 점수평가
|
|
882
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
883
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
884
|
+
* @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
|
|
885
|
+
* @param {*} [options] Override http request option.
|
|
886
|
+
* @throws {RequiredError}
|
|
887
|
+
*/
|
|
888
|
+
submitNegotiationScores: (bidRef_1, idempotencyKey_1, submitNegotiationScoresRequestDto_1, ...args_1) => __awaiter(this, [bidRef_1, idempotencyKey_1, submitNegotiationScoresRequestDto_1, ...args_1], void 0, function* (bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options = {}) {
|
|
889
|
+
// verify required parameter 'bidRef' is not null or undefined
|
|
890
|
+
assertParamExists('submitNegotiationScores', 'bidRef', bidRef);
|
|
891
|
+
// verify required parameter 'idempotencyKey' is not null or undefined
|
|
892
|
+
assertParamExists('submitNegotiationScores', 'idempotencyKey', idempotencyKey);
|
|
893
|
+
// verify required parameter 'submitNegotiationScoresRequestDto' is not null or undefined
|
|
894
|
+
assertParamExists('submitNegotiationScores', 'submitNegotiationScoresRequestDto', submitNegotiationScoresRequestDto);
|
|
895
|
+
const localVarPath = `/v2/bids/{bidRef}/negotiation-scores`
|
|
896
|
+
.replace('{bidRef}', encodeURIComponent(String(bidRef)));
|
|
897
|
+
// use dummy base URL string because the URL constructor only accepts absolute URLs.
|
|
898
|
+
const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
|
|
899
|
+
let baseOptions;
|
|
900
|
+
if (configuration) {
|
|
901
|
+
baseOptions = configuration.baseOptions;
|
|
902
|
+
}
|
|
903
|
+
const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
|
|
904
|
+
const localVarHeaderParameter = {};
|
|
905
|
+
const localVarQueryParameter = {};
|
|
906
|
+
// authentication partner-oauth2 required
|
|
907
|
+
// oauth required
|
|
908
|
+
yield setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["awards:write"], configuration);
|
|
909
|
+
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
910
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
911
|
+
if (idempotencyKey != null) {
|
|
912
|
+
localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
|
|
913
|
+
}
|
|
914
|
+
setSearchParams(localVarUrlObj, localVarQueryParameter);
|
|
915
|
+
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
916
|
+
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
917
|
+
localVarRequestOptions.data = serializeDataIfNeeded(submitNegotiationScoresRequestDto, localVarRequestOptions, configuration);
|
|
918
|
+
return {
|
|
919
|
+
url: toPathString(localVarUrlObj),
|
|
920
|
+
options: localVarRequestOptions,
|
|
921
|
+
};
|
|
922
|
+
}),
|
|
923
|
+
/**
|
|
924
|
+
* 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
|
|
839
925
|
* @summary 공고 수정
|
|
840
926
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
841
927
|
* @param {string} ifMatch
|
|
842
928
|
* @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidRef}` 응답의 `ETag` 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
|
|
843
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
929
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
844
930
|
* @param {UpdateBidRequestDto} updateBidRequestDto
|
|
845
931
|
* @param {*} [options] Override http request option.
|
|
846
932
|
* @throws {RequiredError}
|
|
@@ -891,13 +977,16 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
891
977
|
};
|
|
892
978
|
}),
|
|
893
979
|
/**
|
|
894
|
-
* 스코프 `files:write` + `Idempotency-Key`
|
|
895
|
-
* @summary 공고 첨부파일 업로드
|
|
980
|
+
* 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
|
|
981
|
+
* @summary 공고 첨부파일 업로드
|
|
982
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
896
983
|
* @param {UploadFileRequestDto} uploadFileRequestDto
|
|
897
984
|
* @param {*} [options] Override http request option.
|
|
898
985
|
* @throws {RequiredError}
|
|
899
986
|
*/
|
|
900
|
-
uploadFile: (uploadFileRequestDto_1, ...args_1) => __awaiter(this, [uploadFileRequestDto_1, ...args_1], void 0, function* (uploadFileRequestDto, options = {}) {
|
|
987
|
+
uploadFile: (idempotencyKey_1, uploadFileRequestDto_1, ...args_1) => __awaiter(this, [idempotencyKey_1, uploadFileRequestDto_1, ...args_1], void 0, function* (idempotencyKey, uploadFileRequestDto, options = {}) {
|
|
988
|
+
// verify required parameter 'idempotencyKey' is not null or undefined
|
|
989
|
+
assertParamExists('uploadFile', 'idempotencyKey', idempotencyKey);
|
|
901
990
|
// verify required parameter 'uploadFileRequestDto' is not null or undefined
|
|
902
991
|
assertParamExists('uploadFile', 'uploadFileRequestDto', uploadFileRequestDto);
|
|
903
992
|
const localVarPath = `/v2/files`;
|
|
@@ -915,6 +1004,9 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
915
1004
|
yield setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["files:write"], configuration);
|
|
916
1005
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
917
1006
|
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
1007
|
+
if (idempotencyKey != null) {
|
|
1008
|
+
localVarHeaderParameter['Idempotency-Key'] = String(idempotencyKey);
|
|
1009
|
+
}
|
|
918
1010
|
setSearchParams(localVarUrlObj, localVarQueryParameter);
|
|
919
1011
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
920
1012
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -927,16 +1019,16 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration) {
|
|
|
927
1019
|
};
|
|
928
1020
|
};
|
|
929
1021
|
/**
|
|
930
|
-
*
|
|
1022
|
+
* PartnerApiApi - functional programming interface
|
|
931
1023
|
*/
|
|
932
|
-
export const
|
|
933
|
-
const localVarAxiosParamCreator =
|
|
1024
|
+
export const PartnerApiApiFp = function (configuration) {
|
|
1025
|
+
const localVarAxiosParamCreator = PartnerApiApiAxiosParamCreator(configuration);
|
|
934
1026
|
return {
|
|
935
1027
|
/**
|
|
936
1028
|
* 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
|
|
937
1029
|
* @summary 공고 취소
|
|
938
1030
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
939
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1031
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
940
1032
|
* @param {CancelBidRequestDto} cancelBidRequestDto
|
|
941
1033
|
* @param {*} [options] Override http request option.
|
|
942
1034
|
* @throws {RequiredError}
|
|
@@ -946,15 +1038,15 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
946
1038
|
var _a, _b, _c;
|
|
947
1039
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options);
|
|
948
1040
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
949
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1041
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.cancelBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
950
1042
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
951
1043
|
});
|
|
952
1044
|
},
|
|
953
1045
|
/**
|
|
954
|
-
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.
|
|
1046
|
+
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 수 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
955
1047
|
* @summary 검수완료 전송
|
|
956
1048
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
957
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1049
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
958
1050
|
* @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
|
|
959
1051
|
* @param {*} [options] Override http request option.
|
|
960
1052
|
* @throws {RequiredError}
|
|
@@ -964,15 +1056,15 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
964
1056
|
var _a, _b, _c;
|
|
965
1057
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options);
|
|
966
1058
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
967
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1059
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.completeAcceptance']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
968
1060
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
969
1061
|
});
|
|
970
1062
|
},
|
|
971
1063
|
/**
|
|
972
1064
|
* 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
973
|
-
* @summary 정산 마감
|
|
1065
|
+
* @summary 정산 마감
|
|
974
1066
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
975
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1067
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
976
1068
|
* @param {*} [options] Override http request option.
|
|
977
1069
|
* @throws {RequiredError}
|
|
978
1070
|
*/
|
|
@@ -981,32 +1073,31 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
981
1073
|
var _a, _b, _c;
|
|
982
1074
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.completeInvoice(bidRef, idempotencyKey, options);
|
|
983
1075
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
984
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1076
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.completeInvoice']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
985
1077
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
986
1078
|
});
|
|
987
1079
|
},
|
|
988
1080
|
/**
|
|
989
|
-
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동
|
|
990
|
-
* @summary 결제창 발행
|
|
991
|
-
* @param {string} idempotencyKey
|
|
992
|
-
* @param {
|
|
1081
|
+
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
1082
|
+
* @summary 결제창 발행
|
|
1083
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1084
|
+
* @param {CreateCardPaymentDto} createCardPaymentDto
|
|
993
1085
|
* @param {*} [options] Override http request option.
|
|
994
|
-
* @deprecated
|
|
995
1086
|
* @throws {RequiredError}
|
|
996
1087
|
*/
|
|
997
|
-
|
|
1088
|
+
createCardPayment(idempotencyKey, createCardPaymentDto, options) {
|
|
998
1089
|
return __awaiter(this, void 0, void 0, function* () {
|
|
999
1090
|
var _a, _b, _c;
|
|
1000
|
-
const localVarAxiosArgs = yield localVarAxiosParamCreator.
|
|
1091
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.createCardPayment(idempotencyKey, createCardPaymentDto, options);
|
|
1001
1092
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1002
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1093
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.createCardPayment']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1003
1094
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1004
1095
|
});
|
|
1005
1096
|
},
|
|
1006
1097
|
/**
|
|
1007
1098
|
* 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
|
|
1008
1099
|
* @summary 계약서류 생성
|
|
1009
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1100
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1010
1101
|
* @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
|
|
1011
1102
|
* @param {*} [options] Override http request option.
|
|
1012
1103
|
* @throws {RequiredError}
|
|
@@ -1016,13 +1107,13 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1016
1107
|
var _a, _b, _c;
|
|
1017
1108
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options);
|
|
1018
1109
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1019
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1110
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.createExternalContractDocuments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1020
1111
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1021
1112
|
});
|
|
1022
1113
|
},
|
|
1023
1114
|
/**
|
|
1024
|
-
* 무인증 — `fileKey` 자체가 capability 다(
|
|
1025
|
-
* @summary 파일 다운로드
|
|
1115
|
+
* 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 곧 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
|
|
1116
|
+
* @summary 파일 다운로드
|
|
1026
1117
|
* @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
|
|
1027
1118
|
* @param {*} [options] Override http request option.
|
|
1028
1119
|
* @throws {RequiredError}
|
|
@@ -1032,12 +1123,12 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1032
1123
|
var _a, _b, _c;
|
|
1033
1124
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.downloadFile(fileKey, options);
|
|
1034
1125
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1035
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1126
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.downloadFile']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1036
1127
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1037
1128
|
});
|
|
1038
1129
|
},
|
|
1039
1130
|
/**
|
|
1040
|
-
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요.
|
|
1131
|
+
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
1041
1132
|
* @summary 공고 상세 조회
|
|
1042
1133
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1043
1134
|
* @param {*} [options] Override http request option.
|
|
@@ -1048,12 +1139,12 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1048
1139
|
var _a, _b, _c;
|
|
1049
1140
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.getBid(bidRef, options);
|
|
1050
1141
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1051
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1142
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.getBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1052
1143
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1053
1144
|
});
|
|
1054
1145
|
},
|
|
1055
1146
|
/**
|
|
1056
|
-
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.
|
|
1147
|
+
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
|
|
1057
1148
|
* @summary 정산 정보 조회
|
|
1058
1149
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1059
1150
|
* @param {*} [options] Override http request option.
|
|
@@ -1064,7 +1155,7 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1064
1155
|
var _a, _b, _c;
|
|
1065
1156
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.getBidSettlement(bidRef, options);
|
|
1066
1157
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1067
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1158
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.getBidSettlement']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1068
1159
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1069
1160
|
});
|
|
1070
1161
|
},
|
|
@@ -1081,13 +1172,13 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1081
1172
|
var _a, _b, _c;
|
|
1082
1173
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.getBidStatement(bidRef, paperCode, options);
|
|
1083
1174
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1084
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1175
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.getBidStatement']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1085
1176
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1086
1177
|
});
|
|
1087
1178
|
},
|
|
1088
1179
|
/**
|
|
1089
1180
|
* 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
|
|
1090
|
-
* @summary 파일 조회
|
|
1181
|
+
* @summary 파일 정보 조회
|
|
1091
1182
|
* @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
|
|
1092
1183
|
* @param {*} [options] Override http request option.
|
|
1093
1184
|
* @throws {RequiredError}
|
|
@@ -1097,7 +1188,7 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1097
1188
|
var _a, _b, _c;
|
|
1098
1189
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.getFileMeta(fileKey, options);
|
|
1099
1190
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1100
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1191
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.getFileMeta']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1101
1192
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1102
1193
|
});
|
|
1103
1194
|
},
|
|
@@ -1113,24 +1204,23 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1113
1204
|
var _a, _b, _c;
|
|
1114
1205
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.getSemoContractTaxinvoiceStatus(externalContractId, options);
|
|
1115
1206
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1116
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1207
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.getSemoContractTaxinvoiceStatus']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1117
1208
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1118
1209
|
});
|
|
1119
1210
|
},
|
|
1120
1211
|
/**
|
|
1121
|
-
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면
|
|
1122
|
-
* @summary 공급사 카드결제 가능 여부
|
|
1212
|
+
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 를 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
|
|
1213
|
+
* @summary 공급사 카드결제 가능 여부
|
|
1123
1214
|
* @param {string} memberId 계약업체 회원 ID
|
|
1124
1215
|
* @param {*} [options] Override http request option.
|
|
1125
|
-
* @deprecated
|
|
1126
1216
|
* @throws {RequiredError}
|
|
1127
1217
|
*/
|
|
1128
|
-
|
|
1218
|
+
getSupplierCardPayableV2(memberId, options) {
|
|
1129
1219
|
return __awaiter(this, void 0, void 0, function* () {
|
|
1130
1220
|
var _a, _b, _c;
|
|
1131
|
-
const localVarAxiosArgs = yield localVarAxiosParamCreator.
|
|
1221
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.getSupplierCardPayableV2(memberId, options);
|
|
1132
1222
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1133
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1223
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.getSupplierCardPayableV2']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1134
1224
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1135
1225
|
});
|
|
1136
1226
|
},
|
|
@@ -1145,23 +1235,23 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1145
1235
|
var _a, _b, _c;
|
|
1146
1236
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.healthControllerCheck(options);
|
|
1147
1237
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1148
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1238
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.healthControllerCheck']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1149
1239
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1150
1240
|
});
|
|
1151
1241
|
},
|
|
1152
1242
|
/**
|
|
1153
|
-
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.**
|
|
1154
|
-
* @summary 공고 결과
|
|
1155
|
-
* @param {string}
|
|
1243
|
+
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 를 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
|
|
1244
|
+
* @summary 공고 결과 조회
|
|
1245
|
+
* @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidRefs` 를 반복해 전달합니다. 최대 100건입니다.
|
|
1156
1246
|
* @param {*} [options] Override http request option.
|
|
1157
1247
|
* @throws {RequiredError}
|
|
1158
1248
|
*/
|
|
1159
|
-
listBidResults(
|
|
1249
|
+
listBidResults(bidRefs, options) {
|
|
1160
1250
|
return __awaiter(this, void 0, void 0, function* () {
|
|
1161
1251
|
var _a, _b, _c;
|
|
1162
|
-
const localVarAxiosArgs = yield localVarAxiosParamCreator.listBidResults(
|
|
1252
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.listBidResults(bidRefs, options);
|
|
1163
1253
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1164
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1254
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.listBidResults']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1165
1255
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1166
1256
|
});
|
|
1167
1257
|
},
|
|
@@ -1170,18 +1260,18 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1170
1260
|
* @summary 공고 목록 조회
|
|
1171
1261
|
* @param {number} [limit] 페이지 크기(1~100, 기본 100).
|
|
1172
1262
|
* @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다.
|
|
1173
|
-
* @param {Array<string>} [
|
|
1174
|
-
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만
|
|
1263
|
+
* @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
|
|
1264
|
+
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
|
|
1175
1265
|
* @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
|
|
1176
1266
|
* @param {*} [options] Override http request option.
|
|
1177
1267
|
* @throws {RequiredError}
|
|
1178
1268
|
*/
|
|
1179
|
-
listBids(limit, cursor,
|
|
1269
|
+
listBids(limit, cursor, bidRefs, status, include, options) {
|
|
1180
1270
|
return __awaiter(this, void 0, void 0, function* () {
|
|
1181
1271
|
var _a, _b, _c;
|
|
1182
|
-
const localVarAxiosArgs = yield localVarAxiosParamCreator.listBids(limit, cursor,
|
|
1272
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.listBids(limit, cursor, bidRefs, status, include, options);
|
|
1183
1273
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1184
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1274
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.listBids']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1185
1275
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1186
1276
|
});
|
|
1187
1277
|
},
|
|
@@ -1198,7 +1288,7 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1198
1288
|
var _a, _b, _c;
|
|
1199
1289
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.listExternalContractDocuments(buyerId, bidType, options);
|
|
1200
1290
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1201
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1291
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.listExternalContractDocuments']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1202
1292
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1203
1293
|
});
|
|
1204
1294
|
},
|
|
@@ -1206,7 +1296,7 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1206
1296
|
* 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
1207
1297
|
* @summary 유찰 처리
|
|
1208
1298
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1209
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1299
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1210
1300
|
* @param {MarkBidFailedRequestDto} markBidFailedRequestDto
|
|
1211
1301
|
* @param {*} [options] Override http request option.
|
|
1212
1302
|
* @throws {RequiredError}
|
|
@@ -1216,7 +1306,7 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1216
1306
|
var _a, _b, _c;
|
|
1217
1307
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options);
|
|
1218
1308
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1219
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1309
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.markBidFailed']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1220
1310
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1221
1311
|
});
|
|
1222
1312
|
},
|
|
@@ -1224,7 +1314,7 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1224
1314
|
* 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
1225
1315
|
* @summary 낙찰 결과 전송
|
|
1226
1316
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1227
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1317
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1228
1318
|
* @param {RegisterAwardRequestDto} registerAwardRequestDto
|
|
1229
1319
|
* @param {*} [options] Override http request option.
|
|
1230
1320
|
* @throws {RequiredError}
|
|
@@ -1234,14 +1324,14 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1234
1324
|
var _a, _b, _c;
|
|
1235
1325
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.registerAward(bidRef, idempotencyKey, registerAwardRequestDto, options);
|
|
1236
1326
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1237
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1327
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.registerAward']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1238
1328
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1239
1329
|
});
|
|
1240
1330
|
},
|
|
1241
1331
|
/**
|
|
1242
1332
|
* 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
|
|
1243
1333
|
* @summary 공고 등록
|
|
1244
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1334
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1245
1335
|
* @param {CreateBidRequestDto} createBidRequestDto
|
|
1246
1336
|
* @param {*} [options] Override http request option.
|
|
1247
1337
|
* @throws {RequiredError}
|
|
@@ -1251,14 +1341,14 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1251
1341
|
var _a, _b, _c;
|
|
1252
1342
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.registerBid(idempotencyKey, createBidRequestDto, options);
|
|
1253
1343
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1254
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1344
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.registerBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1255
1345
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1256
1346
|
});
|
|
1257
1347
|
},
|
|
1258
1348
|
/**
|
|
1259
1349
|
* 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
1260
1350
|
* @summary 계약 발행대상 등록
|
|
1261
|
-
* @param {string} idempotencyKey
|
|
1351
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1262
1352
|
* @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
|
|
1263
1353
|
* @param {*} [options] Override http request option.
|
|
1264
1354
|
* @throws {RequiredError}
|
|
@@ -1268,7 +1358,25 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1268
1358
|
var _a, _b, _c;
|
|
1269
1359
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options);
|
|
1270
1360
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1271
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1361
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.registerSemoContract']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1362
|
+
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1363
|
+
});
|
|
1364
|
+
},
|
|
1365
|
+
/**
|
|
1366
|
+
* 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
|
|
1367
|
+
* @summary 계산서 분할 발급 청구
|
|
1368
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1369
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1370
|
+
* @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
|
|
1371
|
+
* @param {*} [options] Override http request option.
|
|
1372
|
+
* @throws {RequiredError}
|
|
1373
|
+
*/
|
|
1374
|
+
requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options) {
|
|
1375
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
1376
|
+
var _a, _b, _c;
|
|
1377
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options);
|
|
1378
|
+
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1379
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.requestInvoiceSplit']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1272
1380
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1273
1381
|
});
|
|
1274
1382
|
},
|
|
@@ -1276,7 +1384,7 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1276
1384
|
* 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
1277
1385
|
* @summary 낙찰 되돌리기
|
|
1278
1386
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1279
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1387
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1280
1388
|
* @param {RevertAwardRequestDto} revertAwardRequestDto
|
|
1281
1389
|
* @param {*} [options] Override http request option.
|
|
1282
1390
|
* @throws {RequiredError}
|
|
@@ -1286,17 +1394,35 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1286
1394
|
var _a, _b, _c;
|
|
1287
1395
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options);
|
|
1288
1396
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1289
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1397
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.revertAward']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1290
1398
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1291
1399
|
});
|
|
1292
1400
|
},
|
|
1293
1401
|
/**
|
|
1294
|
-
*
|
|
1402
|
+
* 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
1403
|
+
* @summary 협상 점수평가
|
|
1404
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1405
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1406
|
+
* @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
|
|
1407
|
+
* @param {*} [options] Override http request option.
|
|
1408
|
+
* @throws {RequiredError}
|
|
1409
|
+
*/
|
|
1410
|
+
submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options) {
|
|
1411
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
1412
|
+
var _a, _b, _c;
|
|
1413
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options);
|
|
1414
|
+
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1415
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.submitNegotiationScores']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1416
|
+
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1417
|
+
});
|
|
1418
|
+
},
|
|
1419
|
+
/**
|
|
1420
|
+
* 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
|
|
1295
1421
|
* @summary 공고 수정
|
|
1296
1422
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1297
1423
|
* @param {string} ifMatch
|
|
1298
1424
|
* @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidRef}` 응답의 `ETag` 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
|
|
1299
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1425
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1300
1426
|
* @param {UpdateBidRequestDto} updateBidRequestDto
|
|
1301
1427
|
* @param {*} [options] Override http request option.
|
|
1302
1428
|
* @throws {RequiredError}
|
|
@@ -1306,39 +1432,40 @@ export const PartnerV2ApiFp = function (configuration) {
|
|
|
1306
1432
|
var _a, _b, _c;
|
|
1307
1433
|
const localVarAxiosArgs = yield localVarAxiosParamCreator.updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options);
|
|
1308
1434
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1309
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1435
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.updateBid']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1310
1436
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1311
1437
|
});
|
|
1312
1438
|
},
|
|
1313
1439
|
/**
|
|
1314
|
-
* 스코프 `files:write` + `Idempotency-Key`
|
|
1315
|
-
* @summary 공고 첨부파일 업로드
|
|
1440
|
+
* 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
|
|
1441
|
+
* @summary 공고 첨부파일 업로드
|
|
1442
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1316
1443
|
* @param {UploadFileRequestDto} uploadFileRequestDto
|
|
1317
1444
|
* @param {*} [options] Override http request option.
|
|
1318
1445
|
* @throws {RequiredError}
|
|
1319
1446
|
*/
|
|
1320
|
-
uploadFile(uploadFileRequestDto, options) {
|
|
1447
|
+
uploadFile(idempotencyKey, uploadFileRequestDto, options) {
|
|
1321
1448
|
return __awaiter(this, void 0, void 0, function* () {
|
|
1322
1449
|
var _a, _b, _c;
|
|
1323
|
-
const localVarAxiosArgs = yield localVarAxiosParamCreator.uploadFile(uploadFileRequestDto, options);
|
|
1450
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.uploadFile(idempotencyKey, uploadFileRequestDto, options);
|
|
1324
1451
|
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
1325
|
-
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['
|
|
1452
|
+
const localVarOperationServerBasePath = (_c = (_b = operationServerMap['PartnerApiApi.uploadFile']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
1326
1453
|
return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
1327
1454
|
});
|
|
1328
1455
|
},
|
|
1329
1456
|
};
|
|
1330
1457
|
};
|
|
1331
1458
|
/**
|
|
1332
|
-
*
|
|
1459
|
+
* PartnerApiApi - factory interface
|
|
1333
1460
|
*/
|
|
1334
|
-
export const
|
|
1335
|
-
const localVarFp =
|
|
1461
|
+
export const PartnerApiApiFactory = function (configuration, basePath, axios) {
|
|
1462
|
+
const localVarFp = PartnerApiApiFp(configuration);
|
|
1336
1463
|
return {
|
|
1337
1464
|
/**
|
|
1338
1465
|
* 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
|
|
1339
1466
|
* @summary 공고 취소
|
|
1340
1467
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1341
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1468
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1342
1469
|
* @param {CancelBidRequestDto} cancelBidRequestDto
|
|
1343
1470
|
* @param {*} [options] Override http request option.
|
|
1344
1471
|
* @throws {RequiredError}
|
|
@@ -1347,10 +1474,10 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1347
1474
|
return localVarFp.cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options).then((request) => request(axios, basePath));
|
|
1348
1475
|
},
|
|
1349
1476
|
/**
|
|
1350
|
-
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.
|
|
1477
|
+
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 수 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
1351
1478
|
* @summary 검수완료 전송
|
|
1352
1479
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1353
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1480
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1354
1481
|
* @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
|
|
1355
1482
|
* @param {*} [options] Override http request option.
|
|
1356
1483
|
* @throws {RequiredError}
|
|
@@ -1360,9 +1487,9 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1360
1487
|
},
|
|
1361
1488
|
/**
|
|
1362
1489
|
* 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
1363
|
-
* @summary 정산 마감
|
|
1490
|
+
* @summary 정산 마감
|
|
1364
1491
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1365
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1492
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1366
1493
|
* @param {*} [options] Override http request option.
|
|
1367
1494
|
* @throws {RequiredError}
|
|
1368
1495
|
*/
|
|
@@ -1370,21 +1497,20 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1370
1497
|
return localVarFp.completeInvoice(bidRef, idempotencyKey, options).then((request) => request(axios, basePath));
|
|
1371
1498
|
},
|
|
1372
1499
|
/**
|
|
1373
|
-
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동
|
|
1374
|
-
* @summary 결제창 발행
|
|
1375
|
-
* @param {string} idempotencyKey
|
|
1376
|
-
* @param {
|
|
1500
|
+
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
1501
|
+
* @summary 결제창 발행
|
|
1502
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1503
|
+
* @param {CreateCardPaymentDto} createCardPaymentDto
|
|
1377
1504
|
* @param {*} [options] Override http request option.
|
|
1378
|
-
* @deprecated
|
|
1379
1505
|
* @throws {RequiredError}
|
|
1380
1506
|
*/
|
|
1381
|
-
|
|
1382
|
-
return localVarFp.
|
|
1507
|
+
createCardPayment(idempotencyKey, createCardPaymentDto, options) {
|
|
1508
|
+
return localVarFp.createCardPayment(idempotencyKey, createCardPaymentDto, options).then((request) => request(axios, basePath));
|
|
1383
1509
|
},
|
|
1384
1510
|
/**
|
|
1385
1511
|
* 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
|
|
1386
1512
|
* @summary 계약서류 생성
|
|
1387
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1513
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1388
1514
|
* @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
|
|
1389
1515
|
* @param {*} [options] Override http request option.
|
|
1390
1516
|
* @throws {RequiredError}
|
|
@@ -1393,8 +1519,8 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1393
1519
|
return localVarFp.createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options).then((request) => request(axios, basePath));
|
|
1394
1520
|
},
|
|
1395
1521
|
/**
|
|
1396
|
-
* 무인증 — `fileKey` 자체가 capability 다(
|
|
1397
|
-
* @summary 파일 다운로드
|
|
1522
|
+
* 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 곧 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
|
|
1523
|
+
* @summary 파일 다운로드
|
|
1398
1524
|
* @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
|
|
1399
1525
|
* @param {*} [options] Override http request option.
|
|
1400
1526
|
* @throws {RequiredError}
|
|
@@ -1403,7 +1529,7 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1403
1529
|
return localVarFp.downloadFile(fileKey, options).then((request) => request(axios, basePath));
|
|
1404
1530
|
},
|
|
1405
1531
|
/**
|
|
1406
|
-
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요.
|
|
1532
|
+
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
1407
1533
|
* @summary 공고 상세 조회
|
|
1408
1534
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1409
1535
|
* @param {*} [options] Override http request option.
|
|
@@ -1413,7 +1539,7 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1413
1539
|
return localVarFp.getBid(bidRef, options).then((request) => request(axios, basePath));
|
|
1414
1540
|
},
|
|
1415
1541
|
/**
|
|
1416
|
-
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.
|
|
1542
|
+
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
|
|
1417
1543
|
* @summary 정산 정보 조회
|
|
1418
1544
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1419
1545
|
* @param {*} [options] Override http request option.
|
|
@@ -1435,7 +1561,7 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1435
1561
|
},
|
|
1436
1562
|
/**
|
|
1437
1563
|
* 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
|
|
1438
|
-
* @summary 파일 조회
|
|
1564
|
+
* @summary 파일 정보 조회
|
|
1439
1565
|
* @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
|
|
1440
1566
|
* @param {*} [options] Override http request option.
|
|
1441
1567
|
* @throws {RequiredError}
|
|
@@ -1454,15 +1580,14 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1454
1580
|
return localVarFp.getSemoContractTaxinvoiceStatus(externalContractId, options).then((request) => request(axios, basePath));
|
|
1455
1581
|
},
|
|
1456
1582
|
/**
|
|
1457
|
-
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면
|
|
1458
|
-
* @summary 공급사 카드결제 가능 여부
|
|
1583
|
+
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 를 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
|
|
1584
|
+
* @summary 공급사 카드결제 가능 여부
|
|
1459
1585
|
* @param {string} memberId 계약업체 회원 ID
|
|
1460
1586
|
* @param {*} [options] Override http request option.
|
|
1461
|
-
* @deprecated
|
|
1462
1587
|
* @throws {RequiredError}
|
|
1463
1588
|
*/
|
|
1464
|
-
|
|
1465
|
-
return localVarFp.
|
|
1589
|
+
getSupplierCardPayableV2(memberId, options) {
|
|
1590
|
+
return localVarFp.getSupplierCardPayableV2(memberId, options).then((request) => request(axios, basePath));
|
|
1466
1591
|
},
|
|
1467
1592
|
/**
|
|
1468
1593
|
* ERP 연동 직전 회선·인증 endpoint 동작 확인용.
|
|
@@ -1474,28 +1599,28 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1474
1599
|
return localVarFp.healthControllerCheck(options).then((request) => request(axios, basePath));
|
|
1475
1600
|
},
|
|
1476
1601
|
/**
|
|
1477
|
-
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.**
|
|
1478
|
-
* @summary 공고 결과
|
|
1479
|
-
* @param {string}
|
|
1602
|
+
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 를 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
|
|
1603
|
+
* @summary 공고 결과 조회
|
|
1604
|
+
* @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidRefs` 를 반복해 전달합니다. 최대 100건입니다.
|
|
1480
1605
|
* @param {*} [options] Override http request option.
|
|
1481
1606
|
* @throws {RequiredError}
|
|
1482
1607
|
*/
|
|
1483
|
-
listBidResults(
|
|
1484
|
-
return localVarFp.listBidResults(
|
|
1608
|
+
listBidResults(bidRefs, options) {
|
|
1609
|
+
return localVarFp.listBidResults(bidRefs, options).then((request) => request(axios, basePath));
|
|
1485
1610
|
},
|
|
1486
1611
|
/**
|
|
1487
1612
|
* 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다). **페이지네이션(cursor):** `limit`(1~100, 기본 100) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다. **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
|
|
1488
1613
|
* @summary 공고 목록 조회
|
|
1489
1614
|
* @param {number} [limit] 페이지 크기(1~100, 기본 100).
|
|
1490
1615
|
* @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다.
|
|
1491
|
-
* @param {Array<string>} [
|
|
1492
|
-
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만
|
|
1616
|
+
* @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
|
|
1617
|
+
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
|
|
1493
1618
|
* @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
|
|
1494
1619
|
* @param {*} [options] Override http request option.
|
|
1495
1620
|
* @throws {RequiredError}
|
|
1496
1621
|
*/
|
|
1497
|
-
listBids(limit, cursor,
|
|
1498
|
-
return localVarFp.listBids(limit, cursor,
|
|
1622
|
+
listBids(limit, cursor, bidRefs, status, include, options) {
|
|
1623
|
+
return localVarFp.listBids(limit, cursor, bidRefs, status, include, options).then((request) => request(axios, basePath));
|
|
1499
1624
|
},
|
|
1500
1625
|
/**
|
|
1501
1626
|
* 발주기관 회원과 거래유형으로 **그 거래에 필요한 계약서류 목록**을 조회합니다. **용도:** 공고(입찰)를 거치지 않는 거래 — 예: 채팅 기반 견적 — 에서 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때. **판정 기준:** 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. **응답 해석:** - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 **미리 체크된 상태로** 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market 이 데이터를 채워 PDF 로 만들어 주는 서류입니다. 생성 API 의 `paperCodes` 에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요. **조회 가능한 회원 범위:** 이 API 키에 설정된 대행 범위(소속 그룹 전원 또는 지정 회원 목록) 안의 회원만 조회할 수 있습니다. 범위 밖이면 403 입니다. 대행 범위는 키 설정이며 스코프와는 별개 축입니다. **필수 스코프:** `contracts:read` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
|
|
@@ -1512,7 +1637,7 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1512
1637
|
* 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
1513
1638
|
* @summary 유찰 처리
|
|
1514
1639
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1515
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1640
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1516
1641
|
* @param {MarkBidFailedRequestDto} markBidFailedRequestDto
|
|
1517
1642
|
* @param {*} [options] Override http request option.
|
|
1518
1643
|
* @throws {RequiredError}
|
|
@@ -1524,7 +1649,7 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1524
1649
|
* 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
1525
1650
|
* @summary 낙찰 결과 전송
|
|
1526
1651
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1527
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1652
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1528
1653
|
* @param {RegisterAwardRequestDto} registerAwardRequestDto
|
|
1529
1654
|
* @param {*} [options] Override http request option.
|
|
1530
1655
|
* @throws {RequiredError}
|
|
@@ -1535,7 +1660,7 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1535
1660
|
/**
|
|
1536
1661
|
* 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
|
|
1537
1662
|
* @summary 공고 등록
|
|
1538
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1663
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1539
1664
|
* @param {CreateBidRequestDto} createBidRequestDto
|
|
1540
1665
|
* @param {*} [options] Override http request option.
|
|
1541
1666
|
* @throws {RequiredError}
|
|
@@ -1546,7 +1671,7 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1546
1671
|
/**
|
|
1547
1672
|
* 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
1548
1673
|
* @summary 계약 발행대상 등록
|
|
1549
|
-
* @param {string} idempotencyKey
|
|
1674
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1550
1675
|
* @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
|
|
1551
1676
|
* @param {*} [options] Override http request option.
|
|
1552
1677
|
* @throws {RequiredError}
|
|
@@ -1554,11 +1679,23 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1554
1679
|
registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options) {
|
|
1555
1680
|
return localVarFp.registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options).then((request) => request(axios, basePath));
|
|
1556
1681
|
},
|
|
1682
|
+
/**
|
|
1683
|
+
* 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
|
|
1684
|
+
* @summary 계산서 분할 발급 청구
|
|
1685
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1686
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1687
|
+
* @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
|
|
1688
|
+
* @param {*} [options] Override http request option.
|
|
1689
|
+
* @throws {RequiredError}
|
|
1690
|
+
*/
|
|
1691
|
+
requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options) {
|
|
1692
|
+
return localVarFp.requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options).then((request) => request(axios, basePath));
|
|
1693
|
+
},
|
|
1557
1694
|
/**
|
|
1558
1695
|
* 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
1559
1696
|
* @summary 낙찰 되돌리기
|
|
1560
1697
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1561
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1698
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1562
1699
|
* @param {RevertAwardRequestDto} revertAwardRequestDto
|
|
1563
1700
|
* @param {*} [options] Override http request option.
|
|
1564
1701
|
* @throws {RequiredError}
|
|
@@ -1567,12 +1704,24 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1567
1704
|
return localVarFp.revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options).then((request) => request(axios, basePath));
|
|
1568
1705
|
},
|
|
1569
1706
|
/**
|
|
1570
|
-
*
|
|
1707
|
+
* 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
1708
|
+
* @summary 협상 점수평가
|
|
1709
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1710
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1711
|
+
* @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
|
|
1712
|
+
* @param {*} [options] Override http request option.
|
|
1713
|
+
* @throws {RequiredError}
|
|
1714
|
+
*/
|
|
1715
|
+
submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options) {
|
|
1716
|
+
return localVarFp.submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(axios, basePath));
|
|
1717
|
+
},
|
|
1718
|
+
/**
|
|
1719
|
+
* 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
|
|
1571
1720
|
* @summary 공고 수정
|
|
1572
1721
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1573
1722
|
* @param {string} ifMatch
|
|
1574
1723
|
* @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidRef}` 응답의 `ETag` 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
|
|
1575
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1724
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1576
1725
|
* @param {UpdateBidRequestDto} updateBidRequestDto
|
|
1577
1726
|
* @param {*} [options] Override http request option.
|
|
1578
1727
|
* @throws {RequiredError}
|
|
@@ -1581,108 +1730,108 @@ export const PartnerV2ApiFactory = function (configuration, basePath, axios) {
|
|
|
1581
1730
|
return localVarFp.updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options).then((request) => request(axios, basePath));
|
|
1582
1731
|
},
|
|
1583
1732
|
/**
|
|
1584
|
-
* 스코프 `files:write` + `Idempotency-Key`
|
|
1585
|
-
* @summary 공고 첨부파일 업로드
|
|
1733
|
+
* 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
|
|
1734
|
+
* @summary 공고 첨부파일 업로드
|
|
1735
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1586
1736
|
* @param {UploadFileRequestDto} uploadFileRequestDto
|
|
1587
1737
|
* @param {*} [options] Override http request option.
|
|
1588
1738
|
* @throws {RequiredError}
|
|
1589
1739
|
*/
|
|
1590
|
-
uploadFile(uploadFileRequestDto, options) {
|
|
1591
|
-
return localVarFp.uploadFile(uploadFileRequestDto, options).then((request) => request(axios, basePath));
|
|
1740
|
+
uploadFile(idempotencyKey, uploadFileRequestDto, options) {
|
|
1741
|
+
return localVarFp.uploadFile(idempotencyKey, uploadFileRequestDto, options).then((request) => request(axios, basePath));
|
|
1592
1742
|
},
|
|
1593
1743
|
};
|
|
1594
1744
|
};
|
|
1595
1745
|
/**
|
|
1596
|
-
*
|
|
1746
|
+
* PartnerApiApi - object-oriented interface
|
|
1597
1747
|
*/
|
|
1598
|
-
export class
|
|
1748
|
+
export class PartnerApiApi extends BaseAPI {
|
|
1599
1749
|
/**
|
|
1600
1750
|
* 진행중인 공고를 취소합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **되돌릴 수 없습니다.** 취소 사유는 필수이며 공고 이력에 남습니다. **전제조건:** 진행중(ONGOING) 상태여야 합니다. **거부:** 진행중이 아니거나 이미 취소된 공고 → 409. 타 발주처 공고 → 403. **마감과의 차이:** 취소는 공고를 무효로 되돌리는 것이고, 유찰(`POST /v2/bids/{bidRef}/fail`)은 응찰을 받았으나 낙찰자를 정하지 못한 종료입니다.
|
|
1601
1751
|
* @summary 공고 취소
|
|
1602
1752
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1603
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1753
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1604
1754
|
* @param {CancelBidRequestDto} cancelBidRequestDto
|
|
1605
1755
|
* @param {*} [options] Override http request option.
|
|
1606
1756
|
* @throws {RequiredError}
|
|
1607
1757
|
*/
|
|
1608
1758
|
cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options) {
|
|
1609
|
-
return
|
|
1759
|
+
return PartnerApiApiFp(this.configuration).cancelBid(bidRef, idempotencyKey, cancelBidRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1610
1760
|
}
|
|
1611
1761
|
/**
|
|
1612
|
-
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다.
|
|
1762
|
+
* 낙찰 공고의 검수(납품 검수)가 완료되었음을 기록합니다. **호출 시점:** 낙찰자(공급사)가 납품을 완료하고 구매자가 검수를 확인한 시점입니다. 공고 상태가 낙찰(AWARDED) 상태여야 합니다. **부수효과:** - 검수완료 상태가 기록됩니다. - 현금 결제 공고는 세금계산서 발행요청이 등록되고, 낙찰자(공급사)에게 발행요청 알림·문자가 발송됩니다. 카드 결제 공고는 발행요청 축이 없어 알림도 없습니다. - 거래명세서 발행이 예약됩니다. - 응답 코드는 200이며, 처리 결과가 본문에 담겨 반환됩니다. **부분계약(협의 감액):** 낙찰 후 협의로 계약금액이 줄었으면 `supplyAmount`+`vat` 를 함께 보내세요. 그 금액으로 계산서 발행이 요청됩니다. 생략하면 낙찰금액에서 파생합니다. 현금 결제 공고·낙찰자 1인·감액(증액 불가)일 때만 허용되며, 어긋나면 409 입니다. **문서에 찍히는 값:** 거래명세서·검수보고서의 구매사 사업자정보·담당자·작성일자는 등록된 발주처 정보에서 채워집니다. 요청으로 덮어쓸 수 없습니다. **낙찰자:** 공고의 낙찰 상태에서 결정되며 요청으로 지정하지 않습니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
1613
1763
|
* @summary 검수완료 전송
|
|
1614
1764
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1615
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1765
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1616
1766
|
* @param {CompleteAcceptanceRequestDto} completeAcceptanceRequestDto
|
|
1617
1767
|
* @param {*} [options] Override http request option.
|
|
1618
1768
|
* @throws {RequiredError}
|
|
1619
1769
|
*/
|
|
1620
1770
|
completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options) {
|
|
1621
|
-
return
|
|
1771
|
+
return PartnerApiApiFp(this.configuration).completeAcceptance(bidRef, idempotencyKey, completeAcceptanceRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1622
1772
|
}
|
|
1623
1773
|
/**
|
|
1624
1774
|
* 공급사로부터 계산서를 수령한 뒤, 계약을 완료처리 상태로 강제 전환합니다. **호출 시점:** 낙찰·계약 완료 후 공급사 계산서를 오프라인으로 수령했을 때. **부수효과:** - 결제완료·계산서 발급 상태가 기록되고 발급일자가 현재 시각으로 설정됩니다. **소유권:** 공고는 요청 파트너 키가 소유한 발주처 명의여야 합니다(타 발주처 공고 → 403). **이미 완료:** 이미 완료처리된 공고 재호출 → 409. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
1625
|
-
* @summary 정산 마감
|
|
1775
|
+
* @summary 정산 마감
|
|
1626
1776
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1627
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1777
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1628
1778
|
* @param {*} [options] Override http request option.
|
|
1629
1779
|
* @throws {RequiredError}
|
|
1630
1780
|
*/
|
|
1631
1781
|
completeInvoice(bidRef, idempotencyKey, options) {
|
|
1632
|
-
return
|
|
1782
|
+
return PartnerApiApiFp(this.configuration).completeInvoice(bidRef, idempotencyKey, options).then((request) => request(this.axios, this.basePath));
|
|
1633
1783
|
}
|
|
1634
1784
|
/**
|
|
1635
|
-
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동
|
|
1636
|
-
* @summary 결제창 발행
|
|
1637
|
-
* @param {string} idempotencyKey
|
|
1638
|
-
* @param {
|
|
1785
|
+
* 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다. **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다. **발행 직후 상태:** 자동 승인되어 바로 결제할 수 있습니다. **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다. **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다. **멱등성:** `externalRef`(파트너 측 거래 식별자)가 도메인 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
1786
|
+
* @summary 결제창 발행
|
|
1787
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1788
|
+
* @param {CreateCardPaymentDto} createCardPaymentDto
|
|
1639
1789
|
* @param {*} [options] Override http request option.
|
|
1640
|
-
* @deprecated
|
|
1641
1790
|
* @throws {RequiredError}
|
|
1642
1791
|
*/
|
|
1643
|
-
|
|
1644
|
-
return
|
|
1792
|
+
createCardPayment(idempotencyKey, createCardPaymentDto, options) {
|
|
1793
|
+
return PartnerApiApiFp(this.configuration).createCardPayment(idempotencyKey, createCardPaymentDto, options).then((request) => request(this.axios, this.basePath));
|
|
1645
1794
|
}
|
|
1646
1795
|
/**
|
|
1647
1796
|
* 공고 없이 성사된 거래의 계약서류를 생성합니다. **호출 시점:** 계약이 체결된 직후. **요청한 `paperCodes` 와 같은 순서로 같은 개수가 돌아옵니다.** 각 항목의 `fileUrl` 을 그대로 쓰면 되고, `paperCode` 로 어느 요청에 대한 결과인지 대응시킬 수 있습니다. **`name` 의 출처는 서류에 따라 다릅니다.** 시스템이 렌더한 서류는 계약서류명이고, 공급사 사전등록 3종(11·12·13)은 **공급사가 등록한 원본 파일명**입니다 — 채팅 첨부 라벨로 그대로 쓰세요. **필요한 입력:** 발주기관·공급사는 회원 ID 만 주면 됩니다. 상호·사업자번호·대표자·주소·직인은 c-market 이 회원 정보에서 직접 채웁니다. **전부 성공 또는 전부 실패입니다.** 지원하지 않는 서류가 하나라도 섞이면(400) 아무것도 만들지 않습니다. 렌더가 필요한 서류를 요청하면서 `contract` 를 빠뜨려도 마찬가지입니다(422). **135(수의계약체결제한여부확인서)를 요청하면 추가 입력이 필요합니다.** `contract.subject`(발주내용)·`contract.category`(계약구분)·`contract.buyerDepartment`(발주부서)가 필수이고, `documentInputs.contractRestrictionConfirm.answers`에 서식 ①~⑧에 대한 **계약상대자**의 답변 8개를 순서대로 담아야 합니다(c-market 이 대신 만들어낼 수 없는 값입니다). ⑨(발주자 확인사항)는 `documentInputs.contractRestrictionConfirm.buyerConfirmation`으로 선택 전달하며, 생략하면 서식에 빈칸으로 인쇄됩니다. 문항 ①~⑧의 원문은 `answers` 필드 설명을 참고하세요. **164(퇴직자영입현황확인서)를 요청하면 퇴직자 명단이 필요합니다.** `contract.subject`(서식의 \"수의계약 대상건명\")가 필수이고, `documentInputs.retireeRoster.rows` 에 명단을 넣습니다(성명·직급 필수, 직급·입사일·근무기간·비고 선택, 최대 50행). **퇴직자가 없으면 `rows` 를 빈 배열로 보내세요** — 서식에 \"해당사항 없음\"으로 인쇄됩니다. 블록 자체를 생략하면 422 입니다(\"퇴직자 없음\"과 \"확인하지 않음\"을 구분할 수 없기 때문입니다). **승낙사항(4·184·185·186·189·197·208)을 요청하면 `contract.subject`(계약건명)가 필수입니다.** 서식 상단 \"건명\" 칸에 인쇄되는 값이라 비면 어느 계약의 승낙인지 알 수 없습니다. 그 외 추가 입력은 없습니다 — 갑(발주기관) 서명란은 `buyerId` 로, 을(공급사) 서명란은 `supplierId` 로 c-market 이 채웁니다. 발주기관이 기관 전용 승낙사항 서식을 쓰면 요청한 코드 그대로 응답하되 PDF 는 그 기관 서식으로 발급됩니다. **응답의 `fileUrl` 은 만료되지 않습니다.** 채팅 메시지 등에 그대로 저장해 두어도 됩니다. **생성 가능한 회원 범위:** 조회와 같습니다 — 이 API 키에 설정된 대행 범위 안의 회원만 가능합니다. **필수 스코프:** `contracts:write` **멱등성:** `Idempotency-Key` 헤더 필수. --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
|
|
1648
1797
|
* @summary 계약서류 생성
|
|
1649
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1798
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1650
1799
|
* @param {CreateExternalContractDocumentsRequestDto} createExternalContractDocumentsRequestDto
|
|
1651
1800
|
* @param {*} [options] Override http request option.
|
|
1652
1801
|
* @throws {RequiredError}
|
|
1653
1802
|
*/
|
|
1654
1803
|
createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options) {
|
|
1655
|
-
return
|
|
1804
|
+
return PartnerApiApiFp(this.configuration).createExternalContractDocuments(idempotencyKey, createExternalContractDocumentsRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1656
1805
|
}
|
|
1657
1806
|
/**
|
|
1658
|
-
* 무인증 — `fileKey` 자체가 capability 다(
|
|
1659
|
-
* @summary 파일 다운로드
|
|
1807
|
+
* 무인증 — `fileKey` 자체가 capability 다(키를 아는 쪽이 곧 접근 권한을 가진다). 파트너 응답의 `fileUrl`/`fullUrl` 이 이 URL 을 가리킨다. 요청 시점에 서명하므로 URL 을 저장해 두어도 만료되지 않는다. 응답은 실제 저장소 URL 로의 302 리다이렉트이며 리다이렉트 타깃은 1시간 뒤 만료되므로 302 자체를 캐시하지 말 것(`Cache-Control: no-store`). --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 이미 있습니다 — `GET /v2/files/{fileKey}` 가 파일 메타와 `downloadUrl` 을 v2 응답 규약으로 돌려줍니다. 이 안정 URL 은 파트너 응답의 `fileUrl`/`fullUrl` 이 가리키는 주소라 계속 유지되며 중단 일정은 없습니다.
|
|
1808
|
+
* @summary 파일 다운로드
|
|
1660
1809
|
* @param {string} fileKey 파일 키 — 영문 대소문자·숫자 32자. 업로드(`POST /v1|/v2/files`) 응답에서 받은 값. 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다.
|
|
1661
1810
|
* @param {*} [options] Override http request option.
|
|
1662
1811
|
* @throws {RequiredError}
|
|
1663
1812
|
*/
|
|
1664
1813
|
downloadFile(fileKey, options) {
|
|
1665
|
-
return
|
|
1814
|
+
return PartnerApiApiFp(this.configuration).downloadFile(fileKey, options).then((request) => request(this.axios, this.basePath));
|
|
1666
1815
|
}
|
|
1667
1816
|
/**
|
|
1668
|
-
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요.
|
|
1817
|
+
* 공고의 모든 정보를 한 번에 조회합니다 — 기본 정보·납품/대금 조건·담당자·품목, 응찰 참여자(투찰가·순위·낙찰 여부), 계약서류, 검수 진행 상태, 라이프사이클 하위 상태. 스코프 `bids:read`. ERP 는 이 엔드포인트를 폴링해 async 처리(정산 마감 등)의 성사를 관측합니다. **낙찰 여부:** 이 응답의 `status` 가 아니라 `participants[].isWinner` 로 관측합니다. AWARDED 라는 공고 상태는 존재하지 않으며(낙찰 직후 공고는 CONTRACT_IN_PROGRESS 로 전이) `status === \'AWARDED\'` 를 기다리면 영원히 도달하지 않습니다. **여러 건을 한 번에:** 공고마다 이 조회를 반복하지 말고 `GET /v2/bid-results` 배치 조회를 쓰세요. **계약서류는 이 응답에 실립니다.** `contractDocuments[]` 가 서류별 `paperCode`·`paperName`· `fileKey`·`downloadUrl`·`uploadedAt`·`winnerSequence` 를 담습니다 — 계약서류만 따로 받는 엔드포인트는 두지 않습니다. `generationState` 는 **관측 전용**이며 `DEAD_LETTER` 가 보이면 자동 재시도가 소진된 상태라 API 로 되살릴 수 없습니다(운영에 문의하세요). **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
1669
1818
|
* @summary 공고 상세 조회
|
|
1670
1819
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1671
1820
|
* @param {*} [options] Override http request option.
|
|
1672
1821
|
* @throws {RequiredError}
|
|
1673
1822
|
*/
|
|
1674
1823
|
getBid(bidRef, options) {
|
|
1675
|
-
return
|
|
1824
|
+
return PartnerApiApiFp(this.configuration).getBid(bidRef, options).then((request) => request(this.axios, this.basePath));
|
|
1676
1825
|
}
|
|
1677
1826
|
/**
|
|
1678
|
-
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.
|
|
1827
|
+
* 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다. 다른 조회에서 일부 참가자 정보가 가려지는 경우와 무관하게, 이 정산 정보는 읽기 전용으로 항상 그대로 제공됩니다. **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
|
|
1679
1828
|
* @summary 정산 정보 조회
|
|
1680
1829
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1681
1830
|
* @param {*} [options] Override http request option.
|
|
1682
1831
|
* @throws {RequiredError}
|
|
1683
1832
|
*/
|
|
1684
1833
|
getBidSettlement(bidRef, options) {
|
|
1685
|
-
return
|
|
1834
|
+
return PartnerApiApiFp(this.configuration).getBidSettlement(bidRef, options).then((request) => request(this.axios, this.basePath));
|
|
1686
1835
|
}
|
|
1687
1836
|
/**
|
|
1688
1837
|
* 낙찰 계약의 거래명세서(문서 헤더와 품목 라인)를 조회합니다. **필수 스코프:** `invoices:read` — 종전에는 `contracts:read` 를 요구했습니다. 금액이 실리는 정산 계열 문서라 계약서류 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
|
|
@@ -1693,17 +1842,17 @@ export class PartnerV2Api extends BaseAPI {
|
|
|
1693
1842
|
* @throws {RequiredError}
|
|
1694
1843
|
*/
|
|
1695
1844
|
getBidStatement(bidRef, paperCode, options) {
|
|
1696
|
-
return
|
|
1845
|
+
return PartnerApiApiFp(this.configuration).getBidStatement(bidRef, paperCode, options).then((request) => request(this.axios, this.basePath));
|
|
1697
1846
|
}
|
|
1698
1847
|
/**
|
|
1699
1848
|
* 파일명·크기·업로드 시각과 내려받기 주소를 함께 조회합니다. **내려받기:** 응답의 `downloadUrl` 로 파일을 받으세요. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두고 재사용하지 마시고 필요할 때 이 조회를 다시 호출하세요. **구 경로:** 버전 없는 `GET /files/{fileKey}` 는 만료 없는 안정 주소이고 파트너 응답의 `fileUrl`/`fullUrl` 이 그 값을 가리킵니다. 인증도 스코프도 없는 옛 표면이라 신규 연동은 이 엔드포인트를 쓰세요. 구 경로는 당분간 유지됩니다. **MIME 타입은 싣지 않습니다.** 저장소가 그 값을 신뢰할 수 있게 보관하지 않아서, 지어내면 그것으로 분기한 쪽이 조용히 틀립니다. 확장자는 `fileName` 에 그대로 들어 있습니다. **형식이 틀린 키는 404 가 아니라 400 입니다.** fileKey 는 **영문 대소문자·숫자 32자**이고, 그 형태가 아닌 값은 애초에 키가 될 수 없으므로 그렇게 답합니다. 형식은 맞지만 없는 키는 404 입니다. 키를 16진수(hex)로 가정해 클라이언트에서 걸러내지 마세요 — 업로드된 파일의 키에는 hex 가 아닌 문자가 들어갑니다. **필수 스코프:** `files:read`
|
|
1700
|
-
* @summary 파일 조회
|
|
1849
|
+
* @summary 파일 정보 조회
|
|
1701
1850
|
* @param {string} fileKey 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자).
|
|
1702
1851
|
* @param {*} [options] Override http request option.
|
|
1703
1852
|
* @throws {RequiredError}
|
|
1704
1853
|
*/
|
|
1705
1854
|
getFileMeta(fileKey, options) {
|
|
1706
|
-
return
|
|
1855
|
+
return PartnerApiApiFp(this.configuration).getFileMeta(fileKey, options).then((request) => request(this.axios, this.basePath));
|
|
1707
1856
|
}
|
|
1708
1857
|
/**
|
|
1709
1858
|
* 등록한 계약의 계산서 발행 상태를 확인합니다. **언제 쓰나:** 씨마켓이 보내는 발행완료 통지를 놓쳤을 때의 **복구 경로**입니다. 평상시에는 통지를 받아 처리하고, 상태가 어긋난 것 같을 때 이 API 로 되읽으세요. **필수 스코프:** `contracts:read`
|
|
@@ -1713,18 +1862,17 @@ export class PartnerV2Api extends BaseAPI {
|
|
|
1713
1862
|
* @throws {RequiredError}
|
|
1714
1863
|
*/
|
|
1715
1864
|
getSemoContractTaxinvoiceStatus(externalContractId, options) {
|
|
1716
|
-
return
|
|
1865
|
+
return PartnerApiApiFp(this.configuration).getSemoContractTaxinvoiceStatus(externalContractId, options).then((request) => request(this.axios, this.basePath));
|
|
1717
1866
|
}
|
|
1718
1867
|
/**
|
|
1719
|
-
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면
|
|
1720
|
-
* @summary 공급사 카드결제 가능 여부
|
|
1868
|
+
* 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹). **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어지기는 하지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다. **응답은 가부와 사유뿐입니다.** 업체의 상호·사업자번호 같은 식별정보는 싣지 않습니다. **필수 스코프:** `payments:read` — 구 경로(`/v2/card-payment-requests/suppliers/{id}/card-payable`)는 조회인데도 `payments:write` 를 요구했습니다. 그쪽은 동결 표면이라 그대로 둡니다.
|
|
1869
|
+
* @summary 공급사 카드결제 가능 여부
|
|
1721
1870
|
* @param {string} memberId 계약업체 회원 ID
|
|
1722
1871
|
* @param {*} [options] Override http request option.
|
|
1723
|
-
* @deprecated
|
|
1724
1872
|
* @throws {RequiredError}
|
|
1725
1873
|
*/
|
|
1726
|
-
|
|
1727
|
-
return
|
|
1874
|
+
getSupplierCardPayableV2(memberId, options) {
|
|
1875
|
+
return PartnerApiApiFp(this.configuration).getSupplierCardPayableV2(memberId, options).then((request) => request(this.axios, this.basePath));
|
|
1728
1876
|
}
|
|
1729
1877
|
/**
|
|
1730
1878
|
* ERP 연동 직전 회선·인증 endpoint 동작 확인용.
|
|
@@ -1733,31 +1881,31 @@ export class PartnerV2Api extends BaseAPI {
|
|
|
1733
1881
|
* @throws {RequiredError}
|
|
1734
1882
|
*/
|
|
1735
1883
|
healthControllerCheck(options) {
|
|
1736
|
-
return
|
|
1884
|
+
return PartnerApiApiFp(this.configuration).healthControllerCheck(options).then((request) => request(this.axios, this.basePath));
|
|
1737
1885
|
}
|
|
1738
1886
|
/**
|
|
1739
|
-
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.**
|
|
1740
|
-
* @summary 공고 결과
|
|
1741
|
-
* @param {string}
|
|
1887
|
+
* 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`. **이 엔드포인트를 폴링에 쓰세요.** 공고를 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에 실린 `ETag` 를 다음 요청의 `If-None-Match` 로 되보내면, 결과가 그대로일 때 `304` 를 본문 없이 받습니다. **식별자 전달:** `?bidRefs=A,B,C`(쉼표) 또는 `?bidRefs=A&bidRefs=B`(반복) 둘 다 됩니다. **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다. 요청한 건수와 받은 건수가 다를 수 있으므로, 보낸 값이 공고번호였다면 `bidId` 로, 구매번호였다면 `purchaseNo` 로 대조하세요. **공고 하나만 볼 때도** `bidRefs` 에 하나만 넣으면 됩니다. 응찰 결과 외에 납품 조건·품목·계약서류까지 필요하면 `GET /v2/bids/{bidRef}` 상세 조회를 쓰세요.
|
|
1888
|
+
* @summary 공고 결과 조회
|
|
1889
|
+
* @param {string} bidRefs 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidRefs` 를 반복해 전달합니다. 최대 100건입니다.
|
|
1742
1890
|
* @param {*} [options] Override http request option.
|
|
1743
1891
|
* @throws {RequiredError}
|
|
1744
1892
|
*/
|
|
1745
|
-
listBidResults(
|
|
1746
|
-
return
|
|
1893
|
+
listBidResults(bidRefs, options) {
|
|
1894
|
+
return PartnerApiApiFp(this.configuration).listBidResults(bidRefs, options).then((request) => request(this.axios, this.basePath));
|
|
1747
1895
|
}
|
|
1748
1896
|
/**
|
|
1749
1897
|
* 발주처(API 키 바인딩)의 공고를 게시일 최신순으로 조회합니다. 스코프 `bids:read`. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(쿼리에 buyerId 를 넣지 않습니다). **페이지네이션(cursor):** `limit`(1~100, 기본 100) + `cursor`(불투명 토큰). 응답의 `nextCursor` 를 다음 요청 `cursor` 로 전달하면 다음 페이지를 받습니다. `nextCursor=null` 이면 마지막 페이지입니다. **상태·낙찰방법:** 공개값(의미 문자열)으로 반환됩니다. 낙찰 여부는 상태가 아니라 낙찰 결과 조회의 `participants[].isWinner` 로 관측합니다(AWARDED 상태는 없습니다).
|
|
1750
1898
|
* @summary 공고 목록 조회
|
|
1751
1899
|
* @param {number} [limit] 페이지 크기(1~100, 기본 100).
|
|
1752
1900
|
* @param {string} [cursor] 다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달한다. 미지정 시 첫 페이지. `nextCursor=null` 이면 마지막 페이지다.
|
|
1753
|
-
* @param {Array<string>} [
|
|
1754
|
-
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만
|
|
1901
|
+
* @param {Array<string>} [bidRefs] 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다.
|
|
1902
|
+
* @param {Array<BidPublicStatus>} [status] 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다.
|
|
1755
1903
|
* @param {Array<ListBidsIncludeEnum>} [include] 행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다).
|
|
1756
1904
|
* @param {*} [options] Override http request option.
|
|
1757
1905
|
* @throws {RequiredError}
|
|
1758
1906
|
*/
|
|
1759
|
-
listBids(limit, cursor,
|
|
1760
|
-
return
|
|
1907
|
+
listBids(limit, cursor, bidRefs, status, include, options) {
|
|
1908
|
+
return PartnerApiApiFp(this.configuration).listBids(limit, cursor, bidRefs, status, include, options).then((request) => request(this.axios, this.basePath));
|
|
1761
1909
|
}
|
|
1762
1910
|
/**
|
|
1763
1911
|
* 발주기관 회원과 거래유형으로 **그 거래에 필요한 계약서류 목록**을 조회합니다. **용도:** 공고(입찰)를 거치지 않는 거래 — 예: 채팅 기반 견적 — 에서 계약 전에 \"어떤 서류가 필요한가\"를 보여줄 때. **판정 기준:** 발주기관이 속한 그룹에 배정된 계약서류 중 그 거래유형에 적용되는 것 전부입니다. 운영자가 어드민에서 배정을 바꾸면 별도 배포 없이 즉시 반영됩니다. **응답 해석:** - `isDefault=true` — 운영자가 기본값(★)으로 켜 둔 서류입니다. 선택 화면에서 **미리 체크된 상태로** 보여주세요. 목록이 이 값으로 걸러져 있지는 않습니다. - `autoGenerated=true` — c-market 이 데이터를 채워 PDF 로 만들어 주는 서류입니다. 생성 API 의 `paperCodes` 에 넣을 수 있습니다. - `autoGenerated=false` — 이 API 로는 만들 수 없는 서류입니다(거래명세서처럼 세금계산서 발행 같은 별도 시점이 필요한 서류). 목록에서 감추지 말고 사용자가 직접 첨부하도록 안내하세요. **조회 가능한 회원 범위:** 이 API 키에 설정된 대행 범위(소속 그룹 전원 또는 지정 회원 목록) 안의 회원만 조회할 수 있습니다. 범위 밖이면 403 입니다. 대행 범위는 키 설정이며 스코프와는 별개 축입니다. **필수 스코프:** `contracts:read` --- **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다. **대체 계획:** 공고 기반 거래의 계약서류는 `GET /v2/bids/{bidRef}/contract-documents` 가 v2 응답 규약으로 제공합니다. 공고 없는 거래(이 엔드포인트)의 신 표면은 아직 없습니다 — 만들 때 이 설명에 새 경로와 이관 기간을 함께 적습니다.
|
|
@@ -1768,89 +1916,114 @@ export class PartnerV2Api extends BaseAPI {
|
|
|
1768
1916
|
* @throws {RequiredError}
|
|
1769
1917
|
*/
|
|
1770
1918
|
listExternalContractDocuments(buyerId, bidType, options) {
|
|
1771
|
-
return
|
|
1919
|
+
return PartnerApiApiFp(this.configuration).listExternalContractDocuments(buyerId, bidType, options).then((request) => request(this.axios, this.basePath));
|
|
1772
1920
|
}
|
|
1773
1921
|
/**
|
|
1774
1922
|
* 공고를 유찰 상태로 전환합니다. **호출 시점:** 입찰 마감 후 유찰 사유가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 공고 상태가 유찰(FAILED)로 전환됩니다. - 유찰사유 코드와 상세가 기록됩니다. **유찰사유 값 목록(failureReasonCode — 공개값):** | 값 | 의미 | |------|------| | `ABOVE_TARGET_PRICE` | 예정가격 초과 | | `DEPT_MISMATCH` | 자격 미달 | | `NEEDS_EXPERTISE` | 전문성 필요 | | `OTHER` | 기타 (`failureReasonDetail` 필수) | | `NO_PARTICIPANT` | 참가자 없음 | | `SINGLE_PARTICIPANT` | 단독 참가 | | `LESS_THAN_TWO` | 2인 미만 | | `BELOW_MINIMUM` | 최저가 미달 | **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수.
|
|
1775
1923
|
* @summary 유찰 처리
|
|
1776
1924
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1777
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1925
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1778
1926
|
* @param {MarkBidFailedRequestDto} markBidFailedRequestDto
|
|
1779
1927
|
* @param {*} [options] Override http request option.
|
|
1780
1928
|
* @throws {RequiredError}
|
|
1781
1929
|
*/
|
|
1782
1930
|
markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options) {
|
|
1783
|
-
return
|
|
1931
|
+
return PartnerApiApiFp(this.configuration).markBidFailed(bidRef, idempotencyKey, markBidFailedRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1784
1932
|
}
|
|
1785
1933
|
/**
|
|
1786
1934
|
* 낙찰 결과를 등록합니다. 이 요청의 응답은 처리 상태 `AWARDED` 를 반환합니다. **호출 시점:** 입찰 마감 후 낙찰자가 확정되었을 때. 공고가 입찰완료(마감) 상태에서 호출합니다. **부수효과:** - 낙찰자(공급사)의 응찰 건이 낙찰 처리됩니다. - 이후 **공고의 조회 상태(status)는 계약진행(CONTRACT_IN_PROGRESS)** 으로 진행합니다. `AWARDED` 라는 공고 status 는 존재하지 않으므로, 낙찰 여부는 `GET /v2/bids/{bidRef}/results` 의 `participants[].isWinner` 또는 `GET /v2/bids/{bidRef}` 의 status(=계약진행)로 관측하세요(`status === \'AWARDED\'` 폴링 금지). - 협상 방식(NEGOTIATION/NEGOTIATION_AUTO) 공고는 이 엔드포인트 전에 `POST /v2/bids/{bidRef}/negotiation-scores`(협상 점수평가)로 평가를 완료해야 합니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
1787
1935
|
* @summary 낙찰 결과 전송
|
|
1788
1936
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1789
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1937
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1790
1938
|
* @param {RegisterAwardRequestDto} registerAwardRequestDto
|
|
1791
1939
|
* @param {*} [options] Override http request option.
|
|
1792
1940
|
* @throws {RequiredError}
|
|
1793
1941
|
*/
|
|
1794
1942
|
registerAward(bidRef, idempotencyKey, registerAwardRequestDto, options) {
|
|
1795
|
-
return
|
|
1943
|
+
return PartnerApiApiFp(this.configuration).registerAward(bidRef, idempotencyKey, registerAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1796
1944
|
}
|
|
1797
1945
|
/**
|
|
1798
1946
|
* 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. **첨부는 2단계입니다.** 파일을 이 요청 본문에 직접 싣지 마세요 — 먼저 `POST /v2/files`(base64 또는 url)로 올려 `fileKey` 를 받고, 그 32자 키를 이 요청의 `attachments` 배열에 넣습니다.
|
|
1799
1947
|
* @summary 공고 등록
|
|
1800
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1948
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1801
1949
|
* @param {CreateBidRequestDto} createBidRequestDto
|
|
1802
1950
|
* @param {*} [options] Override http request option.
|
|
1803
1951
|
* @throws {RequiredError}
|
|
1804
1952
|
*/
|
|
1805
1953
|
registerBid(idempotencyKey, createBidRequestDto, options) {
|
|
1806
|
-
return
|
|
1954
|
+
return PartnerApiApiFp(this.configuration).registerBid(idempotencyKey, createBidRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1807
1955
|
}
|
|
1808
1956
|
/**
|
|
1809
1957
|
* 외부에서 맺어진 계약 1건을 씨마켓의 **세금계산서 발행 대상**으로 등록합니다. **등록 후 동선:** 발주기관이 씨마켓 [나의 계약 관리] 에서 계산서 발급을 요청하고, 공급기업이 같은 화면에서 발행합니다. 계산서의 **공급자는 공급기업, 공급받는자는 발주기관**입니다. **대금 흐름:** 씨마켓은 이 거래의 대금을 받지 않습니다 — 발행 경로만 제공합니다. **금액:** `supplyPrice` 는 **부가세를 뺀 과세 공급가액**입니다(결제창 API 가 부가세 포함가를 받는 것과 다릅니다). 과세·면세 공급가액이 모두 0 이면 400 입니다. **사전 조건:** 두 회원 ID 가 씨마켓에 실재해야 합니다. 회원 ID 가 곧 소유권이라, 없는 회원으로 등록하면 아무도 열 수 없는 계산서 대상이 됩니다. **필수 스코프:** `contracts:write`. 바인딩된 발주처 외의 발주기관을 대신하려면 대행 범위에 그 회원이 있어야 합니다. **멱등성:** `externalContractId` 가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 대상을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.
|
|
1810
1958
|
* @summary 계약 발행대상 등록
|
|
1811
|
-
* @param {string} idempotencyKey
|
|
1959
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1812
1960
|
* @param {RegisterSemoContractRequestDto} registerSemoContractRequestDto
|
|
1813
1961
|
* @param {*} [options] Override http request option.
|
|
1814
1962
|
* @throws {RequiredError}
|
|
1815
1963
|
*/
|
|
1816
1964
|
registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options) {
|
|
1817
|
-
return
|
|
1965
|
+
return PartnerApiApiFp(this.configuration).registerSemoContract(idempotencyKey, registerSemoContractRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1966
|
+
}
|
|
1967
|
+
/**
|
|
1968
|
+
* 한 공고의 계산서를 여러 장으로 나눠 발급해 달라고 청구합니다. 스코프 `invoices:write`. **청구만 접수합니다.** 이 호출이 계산서를 발행하지는 않습니다 — 접수된 청구는 정산 파이프라인이 처리하며, 진행 여부는 `GET /v2/bids/{bidRef}` 의 `taxInvoiceRequested` 로 관측합니다. **나눠 담을 금액을 보냅니다.** `supplyAmount`(공급가액)와 `vat`(부가세)는 이번 장에 실을 금액입니다. 남은 금액을 다시 나누려면 같은 공고에 청구를 한 번 더 보냅니다 — 그때는 **새 `Idempotency-Key`** 를 쓰세요. 같은 키로 다시 보내면 앞선 청구의 응답이 그대로 재생됩니다. **발급 희망일**(`issueDate`)은 선택이며 미래 일자는 400 입니다. 미지정 시 서버 기본값을 씁니다.
|
|
1969
|
+
* @summary 계산서 분할 발급 청구
|
|
1970
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1971
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1972
|
+
* @param {RequestInvoiceSplitRequestDto} requestInvoiceSplitRequestDto
|
|
1973
|
+
* @param {*} [options] Override http request option.
|
|
1974
|
+
* @throws {RequiredError}
|
|
1975
|
+
*/
|
|
1976
|
+
requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options) {
|
|
1977
|
+
return PartnerApiApiFp(this.configuration).requestInvoiceSplit(bidRef, idempotencyKey, requestInvoiceSplitRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1818
1978
|
}
|
|
1819
1979
|
/**
|
|
1820
1980
|
* 확정된 낙찰을 되돌려 공고를 낙찰대기(PENDING_AWARD) 상태로 보냅니다. 스코프 `awards:write` + `Idempotency-Key` 헤더 필수. **호출 시점:** 낙찰자가 계약을 포기했거나 낙찰 처리 자체가 잘못됐을 때. 되돌린 뒤 같은 공고에 다시 낙찰을 등록할 수 있습니다. **되돌릴 수 없는 경우 → 409:** - 수수료 결제가 이미 완료된 공고 - 세금계산서가 이미 발행된 공고 - 수입권공매 계열 낙찰방법(다수 낙찰자 구조라 되돌리기 단위가 다릅니다) **사유는 필수입니다** — 감사 대상 행위이며 공고 이력에 남습니다. **소유권:** 요청 파트너 키가 소유한 발주처 공고여야 합니다(타 발주처 공고 → 403).
|
|
1821
1981
|
* @summary 낙찰 되돌리기
|
|
1822
1982
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1823
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
1983
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1824
1984
|
* @param {RevertAwardRequestDto} revertAwardRequestDto
|
|
1825
1985
|
* @param {*} [options] Override http request option.
|
|
1826
1986
|
* @throws {RequiredError}
|
|
1827
1987
|
*/
|
|
1828
1988
|
revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options) {
|
|
1829
|
-
return
|
|
1989
|
+
return PartnerApiApiFp(this.configuration).revertAward(bidRef, idempotencyKey, revertAwardRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1990
|
+
}
|
|
1991
|
+
/**
|
|
1992
|
+
* 협상방식(NEGOTIATION/NEGOTIATION_AUTO) 공고의 응찰자별 점수를 입력합니다. **호출 시점:** 입찰 마감 후 낙찰(`POST /v2/bids/{bidRef}/award`) 전. 협상방식 공고는 이 평가를 완료해야 낙찰에 진입할 수 있습니다. **부수효과:** - 응찰자별 기술점수(및 선택적 가격점수 override)가 기록됩니다. - `complete=true` 면 평가완료 게이트까지 적용돼 낙찰 진입이 가능해집니다. **발주처:** API 키에 바인딩된 발주처로 자동 스코프됩니다(요청 body 에 buyerId 를 넣지 않습니다). **필수 스코프:** `awards:write` **멱등성:** `Idempotency-Key` 헤더 필수. 동일 키 + 동일 body 재전송 시 24시간 내 캐시 응답 반환.
|
|
1993
|
+
* @summary 협상 점수평가
|
|
1994
|
+
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1995
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1996
|
+
* @param {SubmitNegotiationScoresRequestDto} submitNegotiationScoresRequestDto
|
|
1997
|
+
* @param {*} [options] Override http request option.
|
|
1998
|
+
* @throws {RequiredError}
|
|
1999
|
+
*/
|
|
2000
|
+
submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options) {
|
|
2001
|
+
return PartnerApiApiFp(this.configuration).submitNegotiationScores(bidRef, idempotencyKey, submitNegotiationScoresRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1830
2002
|
}
|
|
1831
2003
|
/**
|
|
1832
|
-
* 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `
|
|
2004
|
+
* 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수. 진행중/초안 상태의 공고만 수정할 수 있습니다. **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEditHistory=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다. **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다. 한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
|
|
1833
2005
|
* @summary 공고 수정
|
|
1834
2006
|
* @param {string} bidRef 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다.
|
|
1835
2007
|
* @param {string} ifMatch
|
|
1836
2008
|
* @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 `GET /v2/bids/{bidRef}` 응답의 `ETag` 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
|
|
1837
|
-
* @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]).
|
|
2009
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1838
2010
|
* @param {UpdateBidRequestDto} updateBidRequestDto
|
|
1839
2011
|
* @param {*} [options] Override http request option.
|
|
1840
2012
|
* @throws {RequiredError}
|
|
1841
2013
|
*/
|
|
1842
2014
|
updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options) {
|
|
1843
|
-
return
|
|
2015
|
+
return PartnerApiApiFp(this.configuration).updateBid(bidRef, ifMatch, ifMatch2, idempotencyKey, updateBidRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1844
2016
|
}
|
|
1845
2017
|
/**
|
|
1846
|
-
* 스코프 `files:write` + `Idempotency-Key`
|
|
1847
|
-
* @summary 공고 첨부파일 업로드
|
|
2018
|
+
* 파일 본문을 base64 또는 url 중 정확히 하나로 제출하면 `fileKey` 를 돌려줍니다. 이 값을 공고 등록·수정의 첨부 필드에 그대로 실으세요. 스코프 `files:write` + `Idempotency-Key` 헤더가 필요합니다.
|
|
2019
|
+
* @summary 공고 첨부파일 업로드
|
|
2020
|
+
* @param {string} idempotencyKey 멱등성 키(1~255자, `[A-Za-z0-9_-]`). 같은 키 + 같은 body 로 재전송하면 24시간 동안 캐시된 응답을 그대로 받습니다. UUID v4 를 권장합니다.
|
|
1848
2021
|
* @param {UploadFileRequestDto} uploadFileRequestDto
|
|
1849
2022
|
* @param {*} [options] Override http request option.
|
|
1850
2023
|
* @throws {RequiredError}
|
|
1851
2024
|
*/
|
|
1852
|
-
uploadFile(uploadFileRequestDto, options) {
|
|
1853
|
-
return
|
|
2025
|
+
uploadFile(idempotencyKey, uploadFileRequestDto, options) {
|
|
2026
|
+
return PartnerApiApiFp(this.configuration).uploadFile(idempotencyKey, uploadFileRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
1854
2027
|
}
|
|
1855
2028
|
}
|
|
1856
2029
|
export const ListBidsIncludeEnum = {
|