Skip to content
Linra Omni Vendor Docs

Changelog

Orders/Fulfilment/Returns effort, Phase 07 — model-A return receiving + inspection

Section titled “Orders/Fulfilment/Returns effort, Phase 07 — model-A return receiving + inspection”

New: /api/v1/scent/returns/{id}/{received,inspection/start,evidence,inspection/propose}, gated by the Orders capability (no new capability). Lets a model-A supplier confirm receipt of its own returned item, start its own inspection, upload damage-photo/document evidence, and propose an outcome — never authoritative; Linra’s own assessment always decides whether a refund fires. See the Returns guide.

Vendor Platform Workstream W-01/W-02 — dedicated domain + product-scoped routes

Section titled “Vendor Platform Workstream W-01/W-02 — dedicated domain + product-scoped routes”

Before this site’s first public deploy, the vendor API moved off the partner Gateway onto its own dedicated Gateway process and domain (api-omni-vendors.linra.net / -stg), and every commercial (offers/stock/orders) route moved under a /scent product segment, dropping the now-redundant /vendor segment — the whole Gateway already IS the vendor plane, so repeating that in every path added nothing. Global, product-neutral routes (auth, profile, credentials, webhooks) stay directly under /api/v1.

v1 — initial publication (Commerce Core Workstream V)

Section titled “v1 — initial publication (Commerce Core Workstream V)”

The full vendor API surface documented on this site, delivered incrementally:

  • Authentication — POST /api/v1/auth/token, capability-scoped, audience vendor-api.
  • Offers — submit and edit product offers (/api/v1/scent/offers), gated by the Offers capability.
  • Stock — instant declared-availability/quantity pushes (/api/v1/scent/stock/{offerId}), gated by the Stock capability.
  • Cost — approval-pipelined cost pushes (/api/v1/scent/offers/{id}/cost), gated by the Cost capability, independently of Offers.
  • Orders — poll assigned fulfilment groups with delta sync, and push fulfilment status (/api/v1/scent/orders/**), gated by the Orders capability.
  • Webhooks — subscription management and HMAC-signed push delivery for vendor.order.assigned and vendor.offer.review-decision (/api/v1/webhooks/**), riding the Orders capability.

No breaking changes have been made to the wire shape of any endpoint documented here since first publication — only the route prefix, corrected above.