marketplace
POST /v1/marketplace/vendor/sales/{sale_id}/deliver
Mark the work delivered — starts the buyer's acceptance window.
ავტორიზაცია
API გასაღები გაგზავნეთ როგორც bearer token. ეს ენდპოინტი სპეციფიკაციაში არ მიუთითებს კონკრეტულ ნებართვას, ამიტომ მიანიჭეთ თქვენს გასაღებს მინიმალური საჭირო უფლებები და ვარაუდის ნაცვლად შეამოწმეთ პასუხი.
ეს ბოლო წერტილი არ იღებს ორგანიზაციის იდენტიფიკატორს. თქვენი გასაღები უკვე აიდენტიფიცირებს იმ ორგანიზაციას, რომელსაც ის ეკუთვნის, და პასუხი შემოფარგლულია მისით.
სცადეთ
შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/marketplace/vendor/sales/{sale_id}/deliver \
-H "Authorization: Bearer zdk_live_…"შესული ხართ? თქვენი სამართავ პანელში არსებული API კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი API კონსოლში
დეტალები
Delivery is the **seller's claim**, never the end of the sale, and it moves no money: it starts the buyer's acceptance window and nothing else. Redelivery after a revision **restarts** the clock, measured from the redelivery rather than from the original — the buyer's window is a window on the delivery in front of them. Without that, a seller redelivering on day four of a five-day window would hand the buyer one day to check a whole revision. Scoped to the SELLER's org. A buyer marking their own purchase delivered would be starting the clock that releases the seller's money before anything was sent.
პარამეტრები
| სახელი | ტიპი | სავალდებულო | რა არის ეს |
|---|---|---|---|
sale_id (path) | string | დიახ | — |
პასუხი
| სახელი | ტიპი | სავალდებულო | რა არის ეს |
|---|---|---|---|
id | Uuid | დიახ | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
state | MarketplaceSaleState | დიახ | Where one purchased package is in its life (docs/82 §3). The terminal state is `accepted`, not `delivered`: delivery is the vendor's claim, acceptance is the buyer's act, and it… |
listing_id | Uuid | დიახ | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
listing_title | string | დიახ | — |
package_name | string | დიახ | — |
delivery_days | integer | არა | — |
revisions_included | integer | არა | — |
revision_count | integer | არა | — |
billing_mode | MarketplaceBillingMode | არა | How an offer is charged (docs/82 §2a). A property of the OFFER, chosen by the seller from what the listing type permits — a $200 one-off audit and $150/month of link building si… |
billing_interval | object | არა | — |
period_index | integer | არა | — |
gross_minor | integer | დიახ | What the buyer paid for this line, excluding tax. |
commission_bps | integer | არა | — |
commission_minor | integer | არა | — |
vendor_net_minor | integer | არა | gross - commission, always. Never a second independent rounding: a half-penny landing in neither figure is too small to find and too persistent to ignore. |
currency | CurrencyCode | დიახ | ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8). |
auto_accepts | boolean | არა | — |
accept_by | object | არა | — |
delivered_at | object | არა | — |
accepted_at | object | არა | — |
accepted_automatically | boolean | არა | — |
last_revision_reason | string | არა | What the buyer asked to be changed. The seller MUST be able to read this — it is the instruction, and a rejection without one produces a second rejection. |
last_revision_at | object | არა | — |
created_at | string | არა | — |
შეცდომები, რომლებიც ამ ენდპოინტს შეუძლია დააბრუნოს
401 · 404 · 422