Push vendor offer sale price

Push a sale-price change for one of your own offers (Model 2 only).

Cost

PATCH/api/v1/scent/offers/{id}/sale-price

The Model-2 sibling of PATCH /offers/{id}/cost — gated by the SAME Cost capability (no new capability flag; pricing is one capability regardless of which model you’re on). ALWAYS routes through the existing approval pipeline: on an Approved offer this sets a pending sale price; the live sale price stays untouched until an internal reviewer applies or discards it. On an offer never yet approved, the sale price is set directly. Every OTHER field is left exactly as it was. If your CURRENT agreement is CostPlusMargin (Model 1), this returns 422 BUSINESS_OFFER_PRICE_FIELD_NOT_FOR_AGREEMENT — use PATCH /offers/{id}/cost instead. Idempotent: re-pushing the identical sale price overwrites the same pending value, never creates a duplicate pending artifact.

Path parameters

idstring (uuid)Required

Body parameters

salePricenumber (decimal)Required

Your own final sale price (SAR), inclusive of Linra’s + the reselling partner’s full commission share.

salePriceIsVatInclusivebooleanRequired

REQUIRED — there is no default. See CreateVendorOfferRequest.salePriceIsVatInclusive.

Response

idstring (uuid)

statusstring (enum)

Draft (saved, not submitted) → PendingMatch (no variantId, awaiting reviewer match) or PendingReview (a proposed match, awaiting approval) → Approved (live) → Withdrawn/Suspended; Rejected is reachable from Draft/PendingMatch/PendingReview. You never set Approved yourself. PendingRepricing: your agreement’s pricing model was switched by Linra while this offer was Approved or PendingReview — the offer’s linked supply is paused (not sellable) until you resubmit ONLY the new model’s price field (cost under Model 1, sale price under Model 2; stock updates are still accepted and never change this status) and it is re-reviewed, at which point it returns to PendingReview and then Approved as usual.

pricingModelobject

CostPlusMargin (“Model 1”): you declare cost, Linra adds a markup. PercentageOfSale (“Model 2”): you declare the final sale price; Linra + the reselling partner deduct a percentage of it.

vendorExternalIdstring

Opaque id reserved for API integrations; doubles as an idempotency key.

product.variantIdstring (uuid)

A vendor-proposed match to an existing, active Variant. Null for an unmatched free-form entry.

product.vendorSkustring

product.barcodestring

The product’s EAN/UPC barcode. Null only on an offer created before the barcode became required, until its next edit.

product.rawBrandNamestring

product.rawProductNamestring

product.rawConcentrationstring

product.rawSizeMlinteger

product.rawDescriptionstring

cost.amountnumber (decimal)

The live, stored NET cost Linra pays you (SAR).

cost.isVatInclusiveboolean

Always false — pair amount with this value (false) on a write to safely resubmit it unchanged. This is the one entry mode that can never re-interpret an already-net figure as a fresh gross one. See enteredVatInclusive for how you actually entered it.

cost.enteredVatInclusiveboolean

Display-only — your actual original entry-mode preference. NEVER accepted on a write; use isVatInclusive (always false) for that.

cost.inputVatnumber (decimal)

Your own input VAT on the current cost, back-derived when enteredVatInclusive is true.

cost.pendingobject

A cost change staged by you (or an internal edit) on an Approved offer, awaiting reviewer approval — the live cost above is untouched until applied.

price.amountnumber (decimal)

The live, stored NET sale price (SAR).

price.isVatInclusiveboolean

Always false — pair amount with this value (false) on a write to safely resubmit it unchanged. See enteredVatInclusive for how you actually entered it.

price.enteredVatInclusiveboolean

Display-only — your actual original entry-mode preference. NEVER accepted on a write.

price.vatnumber (decimal)

The VAT on the current sale price, back-derived when enteredVatInclusive is true.

price.pendingobject

A sale-price change staged by you on an Approved offer, awaiting reviewer approval — the live sale price above is untouched until applied.

stock.declaredQuantityinteger

Your declared quantity on hand, when you report a number rather than a bare yes/no.

stock.declaredInStockboolean

review.reviewedAtstring (date-time)

review.reasonstring

Other responses

400Request validation failed.

401No bearer token (UNAUTHORIZED_MISSING_TOKEN), an invalid token (UNAUTHORIZED_INVALID_TOKEN) or an expired one (UNAUTHORIZED_TOKEN_EXPIRED — mint a new token). UPSTREAM_AUTH_FAILED is different: a dependent service refused the Gateway itself. That is a server-side fault — retry later and do NOT re-mint your token. See the Rate limits & errors guide.

403Your token doesn’t carry the capability this endpoint requires.

404Unknown offer id, or one belonging to another vendor.

415The request body is not sent as application/json (UNSUPPORTED_MEDIA_TYPE).

422The calling vendor’s current agreement is CostPlusMargin (Model 1) — a sale price is not a valid field for it.

429Too many requests. Retry after the Retry-After header (seconds).

502A dependent service returned an invalid response (BAD_GATEWAY). Retry with backoff.

503The service is temporarily unavailable (SERVICE_UNAVAILABLE). Retry with backoff.

504A dependent service did not respond in time (GATEWAY_TIMEOUT). Retry with backoff.

curl --request PATCH \
  --url https://api-omni-vendors.linra.net/api/v1/scent/offers/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b/sale-price \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "salePrice": 0,
    "salePriceIsVatInclusive": true
  }'

const res = await fetch('https://api-omni-vendors.linra.net/api/v1/scent/offers/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b/sale-price', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    salePrice: 0,
    salePriceIsVatInclusive: true
  }),
});
const { payload } = await res.json();

var response = await httpClient.PatchAsJsonAsync(
    "https://api-omni-vendors.linra.net/api/v1/scent/offers/5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b/sale-price",
    new
    {
        salePrice = 0,
        salePriceIsVatInclusive = true
    });

var envelope = await response.Content.ReadFromJsonAsync<ApiResponse<VendorOfferResponse>>();

Response

{
  "state": "SUCCESS",
  "payload": {
    "id": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
    "status": "Draft",
    "pricingModel": {},
    "vendorExternalId": "string",
    "product": {
      "variantId": "5b1e3a1c-9d2e-4f3a-8b1c-9f0a2e3d4c5b",
      "vendorSku": "string",
      "barcode": "string",
      "rawBrandName": "string",
      "rawProductName": "string",
      "rawConcentration": "string",
      "rawSizeMl": 0,
      "rawDescription": "string"
    },
    "cost": {
      "amount": 0,
      "isVatInclusive": true,
      "enteredVatInclusive": true,
      "inputVat": 0,
      "pending": {
        "amount": 0,
        "inputVat": 0
      }
    },
    "price": {
      "amount": 0,
      "isVatInclusive": true,
      "enteredVatInclusive": true,
      "vat": 0,
      "pending": {
        "amount": 0,
        "vat": 0
      }
    },
    "stock": {
      "declaredQuantity": 0,
      "declaredInStock": true
    },
    "review": {
      "reviewedAt": "2026-08-22T09:14:03Z",
      "reason": "string"
    }
  },
  "details": null
}