Update Product Stock

PATCH

/v1/reception/products/:product_id/stock

PATCH

/v1/reception/products/:product_id/stock

curl -X PATCH https://api.elevenlabs.io/v1/reception/products/product_id/stock \
     -H "Content-Type: application/json" \
     -d '{
  "location_id": "string",
  "on_hand": 1,
  "expected_on_hand": 1
}'

{
  "name": "string",
  "_id": "string",
  "pricing_mode": "fixed",
  "intake_questions": [
    {
      "label": "string",
      "id": "string",
      "kind": "text",
      "options": [
        "string"
      ],
      "required": false,
      "is_active": true
    }
  ],
  "groups": [
    {
      "label": "string",
      "rank": 0
    }
  ],
  "ungrouped_rank": 1,
  "description": "string",
  "price": 1.1,
  "is_active": true,
  "orderable": true,
  "allowed_fulfillment_types": [
    "pickup"
  ],
  "location_ids": [
    "string"
  ],
  "stock": {},
  "created_at_unix": 1,
  "updated_at_unix": 1
}

Set the on-hand quantity of a counted product at one location. Rejected with a 409 if it changed since expected_on_hand was read.

Pfadparameter

product_idstringErforderlich

Anfrage

This endpoint expects an object.

location_idstringErforderlich

Location whose count is set.

on_handintegerErforderlich>=0

The new on-hand quantity.

expected_on_handintegerErforderlich>=0

On-hand value the caller last saw. The write is rejected with a 409 if it no longer matches, so a sale made while the caller was editing is never overwritten.

Antwort

Erfolgreiche Antwort

namestring

Name of the product.

_idstring

pricing_modeenumOptionalStandardwert ist fixed

‘fixed’ (default): the item has a known price the agent can quote, and customers can book or order it directly. ‘quote’: the price depends on the job (renovation, catering, custom work), so no price or slot is offered; the agent collects the intake_questions and files a quote request instead. Takes effect only while quotes are enabled for the business. Group services cannot use ‘quote’.

Erlaubte Werte:

intake_questionslist of objectsOptional

Questions the agent asks before booking or ordering this item. Required for a useful pricing_mode='quote' item — without them a quote request arrives with nothing to price — but also valid on fixed-price items that need extra detail (current hair color before a dye job, allergies before a treatment).

groupslist of objectsOptional

Group memberships for this item. Each entry carries the group label and the item’s 0-based rank within that group.

ungrouped_rankinteger or nullOptional>=0

Display position among items with no group; null sorts last. Change it with the reorder endpoint.

descriptionstringOptional

Description of the product.

pricedouble or nullOptional>=0

Price of the product; null for no listed price.

is_activebooleanOptionalStandardwert ist true

False hides the product without deleting it.

orderablebooleanOptionalStandardwert ist true

False keeps the product listed (callers can ask about it) but not orderable.

allowed_fulfillment_typeslist of enumsOptional

Fulfillment options customers may choose when ordering this product.

Erlaubte Werte:

location_idslist of stringsOptional

Locations where this product is sold; empty list means all locations.

stockmap from strings to integers or nullOptional

On-hand quantity by location. None means unlimited. A missing location key means zero.

created_at_unixintegerOptional

Unix timestamp (seconds since epoch)

updated_at_unixintegerOptional

Unix timestamp (seconds since epoch)

Fehler

422

Unprocessable Entity Error

Pfadparameter

Header

Anfrage

Antwort

Fehler