Skip to content
Linra Omni Vendor Docs

Update an existing API-submitted offer

PATCH
/api/v1/vendor/offers/{id}
curl --request PATCH \
  --url https://api-omni.linra.net/api/v1/vendor/offers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "vendorSku": "example", "vendorExternalId": "example", "cost": 1, "costIsVatInclusive": false, "declaredStockQuantity": 1, "declaredInStock": true, "rawBrandName": "example", "rawProductName": "example", "rawConcentration": "example", "rawSizeMl": 1, "rawDescription": "example" }'

Declared stock applies instantly regardless of status; a cost change on an Approved offer becomes a pending change awaiting reviewer approval; an identity-fact change on an Approved offer resets it to PendingReview. Never changes the matched variantId — re-matching is a reviewer-only action. Reaches ONLY an offer THIS vendor submitted through THIS door (source: Api) — one belonging to another vendor, or one a catalog admin entered manually on this vendor’s behalf, is reported as 404. Requires the Offers capability — prefer PATCH /offers/{id}/cost for a cost-only push from a credential holding only the Cost capability.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json

Deliberately carries NO variantId — matching/re-matching to a catalog variant is a reviewer-only action.

object
vendorSku
string
nullable
vendorExternalId
string
nullable
cost
required
number format: decimal
costIsVatInclusive
boolean
declaredStockQuantity
integer
nullable
declaredInStock
boolean
rawBrandName
string
nullable
rawProductName
string
nullable
rawConcentration
string
nullable
rawSizeMl
integer
nullable
rawDescription
string
nullable

Responses

Section titled “Responses”

200

Section titled “200”

The updated offer.

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
id
string format: uuid
vendorId
string format: uuid
variantId
string format: uuid
nullable
status
string
Allowed values: Draft PendingMatch PendingReview Approved Rejected Withdrawn Suspended
source
string
Allowed values: Manual Import Api
vendorSku
string
nullable
vendorExternalId
string
nullable
cost

Always the NET (ex-VAT) figure.

number format: decimal
pendingCost

A cost change awaiting reviewer approval, if one is in flight. Null otherwise.

number format: decimal
nullable
costIsVatInclusive

Always false. Pair Cost 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 costEnteredVatInclusive for how you actually entered it.

boolean
costEnteredVatInclusive

Display-only — the vendor’s actual original entry-mode preference (how Cost was declared: exclusive/net or inclusive/gross). NEVER accepted on a write; use costIsVatInclusive (always false) for that.

boolean
inputVatAmount

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

number format: decimal
pendingInputVatAmount
number format: decimal
nullable
declaredStockQuantity
integer
nullable
declaredInStock
boolean
rawBrandName
string
nullable
rawProductName
string
nullable
rawConcentration
string
nullable
rawSizeMl
integer
nullable
rawDescription
string
nullable
syncPaused
boolean
autoPublishEligible
boolean
reviewedByUserId
string format: uuid
nullable
reviewedAt
string format: date-time
nullable
reviewReason
string
nullable
importBatchId
string format: uuid
nullable
supplyOptionId
string format: uuid
nullable
version

Optimistic-concurrency token (informational on this API — no vendor endpoint requires you to send it back).

integer
createdDate
string format: date-time
nullable
lastModifiedDate
string format: date-time
nullable
Example
{
  "state": "SUCCESS",
  "payload": {
    "status": "Draft",
    "source": "Manual"
  }
}

400

Section titled “400”

Request validation failed.

Media typeapplication/json
object
state
required
string
payload
details
object
Example
{
  "state": "NOT_FOUND_VENDOR_OFFER"
}

403

Section titled “403”

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

Media typeapplication/json
object
state
required
string
payload
details
object
Examples
ExamplemissingCapability
{
  "state": "FORBIDDEN_CAPABILITY_NOT_GRANTED",
  "payload": null,
  "details": {
    "requiredCapability": "Orders"
  }
}

404

Section titled “404”

Unknown offer id, or one belonging to another vendor.

Media typeapplication/json
object
state
required
string
payload
details
object
Examples
ExamplenotFound
{
  "state": "NOT_FOUND_VENDOR_OFFER",
  "payload": null,
  "details": {}
}

429

Section titled “429”

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

Media typeapplication/json
object
state
required
string
payload
details
object
Example
{
  "state": "NOT_FOUND_VENDOR_OFFER"
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying.