marketplace

POST `/v1/marketplace/orders/{sale_id}/requirements`

The buyer's brief — and the thing that starts the delivery clock.

Ìfàṣẹ́pọ̀

Fi bọ́kì kọ́kọ́ (bearer token) ránṣẹ́ gẹ́gẹ́ bí àmì ìdánimọ̀ API. Ibùdó yìí kò sọ àṣẹ pàtó kan nínú àlàyé rẹ̀, nítorí náà fún kọ́kọ́ rẹ̀ ní ohun tó kéré jù lọ tí ó nílò kí o sì ṣàyẹ̀wò ìdáhùn náà dípò kí o kàn rò ó.

Ojú abánisọ̀rọ̀ yìí kò gba id ajọ kankan. Kọ́kọ́rọ́ rẹ ti mọ ajọ ti o jẹ ti e, a o si fèsì nipa rẹ̀.

Gbiyanju rẹ

Rọ́pọ̀ èyíkéyìí nínú àwọn àmì ìtọ́ka < > pẹ̀lú iye tirẹ̀, àti àmì ìdánimọ̀ bọ́tìnnì náà pẹ̀lú bọ́tìnnì kan láti inú dásibọ̀ọ̀dù rẹ.

curl -X POST https://api.zinndigital.com/v1/marketplace/orders/{sale_id}/requirements \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "requirements": <object> }'

Ṣé o ti wọlé? Iwọ̀n api ní nú ìgbékalẹ̀ rẹ kún id àjọ gidi rẹ ati bọtini tirẹ, o si nṣiṣẹ ibeere na lòdì si api gidi ki o le rii esi gidi na. Ṣí ojú abáná yìí sílẹ̀ nínú kọnsólù API

Àwọn kúlẹ̀kúlẹ̀

docs/147 §2. A paid order used to arrive carrying a package name and nothing else: the seller could not start, the clock was running, and there was no channel to ask. **Submitting is what starts the delivery clock.** Until this call the seller's deadline does not exist, so the days a buyer spends writing their brief are never billed against the seller's deadline and a seller is never late for work they could not begin. The questions come from the order's own frozen `requirements_schema` — a snapshot taken at purchase, so a seller who rewrites their questions tomorrow cannot change what this buyer was asked. Buyer only. A seller gets a 404, the same way acceptance is the buyer's act alone.

Àwọn ìpìlẹ̀

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`sale_id (path)`	`string`	Bẹẹni	—

Akoonu ibeere naa

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`requirements`	`object`	Bẹẹni	Answer per question key, validated against the frozen schema.

Idahun

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`sale_id`	`string`	Bẹẹni	—
`state`	`string`	Bẹẹni	—
`archetype`	`MarketplaceOrderArchetype`	Bẹẹni	How this order behaves. Adding a CATEGORY is configuration; adding an ARCHETYPE is a build. Every order-side decision — whether a delivery clock exists, whether auto-accept appl…
`listing_title`	`string`	Bẹẹkọ	—
`package_name`	`string`	Bẹẹkọ	—
`turn`	`MarketplaceOrderTurn`	Bẹẹni	Whose move it is. `staff` is a real answer, not a fallback: a disputed order is genuinely waiting on us, and telling a buyer "waiting for the seller" while a moderator holds it…
`waiting_on`	`MarketplaceOrderWaitingOn`	Bẹẹni	What the order is waiting FOR — the half that makes `turn` actionable.
`is_yours`	`boolean`	Bẹẹkọ	Whether the caller is the party being waited on.
`is_buyer`	`boolean`	Bẹẹni	—
`deadline`	`string`	Bẹẹkọ	The clock that is actually running, or null when none is.
`paused`	`boolean`	Bẹẹkọ	A clock EXISTS but is stopped — the revision pause. Distinct from a null deadline, which also covers an order that never had a clock at all.
`overdue`	`boolean`	Bẹẹkọ	Never true while `delivery_due_at` is null: null means the clock has not started, which is exactly the state of an order whose buyer has not written their brief yet.
`handover_confirmed`	`integer`	Bẹẹkọ	—
`handover_required`	`integer`	Bẹẹkọ	—
`outstanding`	`string[]`	Bẹẹkọ	Question keys the buyer still owes.
`revisions_used`	`integer`	Bẹẹkọ	—
`revisions_included`	`integer`	Bẹẹkọ	—
`delivery_due_at`	`string`	Bẹẹkọ	—
`currency`	`string`	Bẹẹkọ	—
`gross_minor`	`integer`	Bẹẹkọ	Integer minor units. Money is never a float.
`commission_minor`	`integer`	Bẹẹkọ	The platform's commission, as its own figure. Present for the SELLER and null for the buyer — to a buyer the price is the price. The platform is merchant of record on every mark…
`vendor_net_minor`	`integer`	Bẹẹkọ	What we owe the seller — a trade payable, not money held on trust.
`requirements_schema`	`object[]`	Bẹẹkọ	The questions AS ASKED, frozen at purchase. A seller who rewrites their questions tomorrow cannot change what this buyer was asked.
`requirements`	`object`	Bẹẹkọ	The buyer's answers, in the same `{key: {v: …}}` envelope.
`requirements_submitted_at`	`string`	Bẹẹkọ	—
`handover_items`	`MarketplaceHandoverItem[]`	Bẹẹkọ	—
`last_revision_reason`	`string`	Bẹẹkọ	—

Awọn aṣiṣe ti ibudo ipari yii le da pada

401 · 404 · 422

POST /v1/marketplace/orders/{sale_id}/requirements