Scent
The Scent product line — offers, cost, stock, orders, returns, and this product's own state catalogue.
Scent is Linra Omni’s perfume and fragrance product line — the first product on the platform (see
Platform overview for how a future second product line would show up
here alongside it). Everything below is specific to Scent; the endpoints and concepts on this page
live under the /api/v1/scent/** URL segment.
Endpoint groups
Section titled “Endpoint groups”See API Reference → Scent for every operation, one page per endpoint. The groups:
| Resource | What it covers | Capability required |
|---|---|---|
| Offers | Submit and edit product offers. | Offers |
| Cost | Push cost (Model 1) or sale-price (Model 2) changes for your own offers. | Cost |
| Agreement | Read your own commercial model (CostPlusMargin or PercentageOfSale) and percentage. | none — capability-free |
| Stock | Push declared availability/quantity. | Stock |
| Orders | Poll your assigned fulfilment groups, push fulfilment status. | Orders |
| Returns | Confirm receipt, inspect, upload evidence, propose an outcome. | Orders |
| Webhooks | Scent’s own event subscriptions — see the note on the shared mechanism in URL conventions. | varies per event type |
Deeper guides for several of these already exist and aren’t repeated here: Offers, pricing and stock, Orders & fulfilment status, Returns, Shipping documents & your dues. If you want the fulfilment and returns story told as one continuous flow — with a diagram — start with Scent fulfilment for vendors instead.
Scent’s own state catalogue
Section titled “Scent’s own state catalogue”Every status/state value you’ll encounter on a Scent-vendor response, in one place.
Offers
Section titled “Offers”| Field | Values | Meaning |
|---|---|---|
status |
Draft, PendingMatch, PendingReview, Approved, Rejected, Withdrawn, Suspended |
An offer’s review lifecycle. Only Linra staff moves it to Approved/Rejected — you never self-publish. |
Orders / fulfilment
Section titled “Orders / fulfilment”| Field | Values | Meaning |
|---|---|---|
status (fulfilment group) |
Pending, Packed, Shipped, Delivered, Cancelled, Returned, PendingSourcing |
The physical fulfilment lifecycle you push updates against. |
carrier |
Aramex, SaudiPost, Smsa, Other |
One of three fixed carriers, or Other (requires a free-text carrier name). |
Returns
Section titled “Returns”| Field | Values | Meaning |
|---|---|---|
status |
Pending, Approved, Declined, WaybillIssued, InTransit, Received, UnderInspection, InspectionAccepted, InspectionRejected, RefundReleased, Withdrawn |
The FULL internal RMA lifecycle — you see every state, not a collapsed subset, since you participate directly in physical handling. |
Proposed inspection outcome |
AcceptedDefect, AcceptedSound, Rejected |
Your PROPOSED assessment — Linra’s own decision is always authoritative, never overridden by your proposal. |
Evidence kind |
Photo, Document |
Type of file you upload as inspection evidence. |
Webhooks
Section titled “Webhooks”| Field | Values | Meaning |
|---|---|---|
eventType |
vendor.scent.order.assigned, vendor.scent.offer.review-decision |
Scent’s current vendor-facing event vocabulary. See Webhooks & HMAC verification for the delivery mechanism. |
Capabilities (auth model, documented here for completeness)
Section titled “Capabilities (auth model, documented here for completeness)”VendorCapability — Offers, Stock, Cost, Orders, Account — is technically defined
alongside Scent’s own code today (it’s the only product with a vendor plane so far), but it
describes the AUTH/CAPABILITY MODEL itself, not a Scent-only concept: see
Authentication & capabilities for the full explanation, including how a
credential’s capabilities are requested and capped.