marketplace
POST /v1/marketplace/vendor/sales/{sale_id}/deliver
Mark the work delivered — starts the buyer's acceptance window.
Баталгаажуулалт
API түлхүүрийг bearer token хэлбэрээр илгөэнэ үү. Энэхүү төгсгөлийн цэг нь тодорхойлолтдоо тодорхой зөвшөөрлийг заагаагүй тул түлхүүрээрээ шаардагдах хамгийн бага эрхийг өгч, таамаглахаас илүүтэйгээр хариуг шалгана уу.
Энэ төгсгөл цэг нь ямар ч байгууллагын ID шаардахгүй. Таны түлхүүр аль хэдийн харьяалагдах байгууллагыг тодорхойлж байгаа бөгөөд хариу нь тухайн байгууллагын хүрээнд хязгаарлагдана.
Туршиж үзэх
Өнцөг хаалтанд байгаа бүх зүйлийг өөрийн утгаар солиж, түлхүүр санамж байрлуулагчийг хяналтын самбарынхаа түлхүүрээр сольж оруулна уу.
curl -X POST https://api.zinndigital.com/v1/marketplace/vendor/sales/{sale_id}/deliver \
-H "Authorization: Bearer zdk_live_…"Та нэвтэрсэн байна уу? Таны хяналтын самбар дахь API консол нь таны бодит байгууллагын ID болон өөрийн түлхүүрийг автоматаар бөглөж, шууд ажиллаж буй API рүү хүсэлт илгээх тул та бодит хариуг харах боломжтой болно. Энэ төгсгөлийн цэгийг 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