nylandersmattor.se

addToCart

Add a rug variant to the cart by the variantId from searchRugs/getRugDetails. Which dimensions to supply depends on the variant's `type` (read it from the search/detail result): type 'normal' -> supply NEITHER widthCm nor lengthCm (fixed size); type 'meter' -> supply lengthCm ONLY (width is fixed by the variant's roll width; any widthCm is ignored); type 'kvadratmeter' -> supply BOTH widthCm and lengthCm, EXCEPT a round variant (sizeLabel 'rund') -> supply widthCm ONLY (length equals width). For made-to-order types, keep dimensions within the variant's `constraints` from getRugDetails. The server ALWAYS re-validates: a variant that searchRugs reported inStock:true may still be rejected, so success is never guaranteed before the call. On success returns { success:true, added, cart } (cart = the full updated cart, same shape as getCart). On failure returns { success:false, error } where error is one of: 'unknown_variant' (no such variant), 'out_of_stock' (variant flagged unavailable), 'insufficient_stock' (fewer in stock than requested quantity — try a smaller quantity or another variant), 'quantity_out_of_range' (quantity must be an integer 1–99), 'invalid_dimensions' (missing/out-of-bounds widthCm/lengthCm for the type), or 'internal_error'. Clients can react to the typed error (e.g. on insufficient_stock, pick a different variant).

Input schema

{
  "type": "object",
  "properties": {
    "variantId": {
      "type": "string",
      "description": "The variantId from a search or detail result."
    },
    "quantity": {
      "type": "number",
      "description": "Number of units to add (integer 1–99). Defaults to 1."
    },
    "widthCm": {
      "type": "number",
      "description": "Desired width in cm. Supply only for type 'kvadratmeter' (both dims) or a round kvadratmeter variant (this alone). Ignored for 'meter'; omit for 'normal'."
    },
    "lengthCm": {
      "type": "number",
      "description": "Desired length in cm. Supply for type 'meter' (this alone) and non-round 'kvadratmeter'. Omit for 'normal' and round variants."
    }
  },
  "required": [
    "variantId"
  ],
  "additionalProperties": false
}