---
title: "Updates an existing shop item."
method: PUT
path: "/v4/listings/shop-items"
tags: ["Listings"]
---

# Updates an existing shop item.

`PUT /v4/listings/shop-items`

## Request body

- ShopItemUpdateData — Holds Shop item update information
  - `itemId` integer — The id of the item to update.
  - `itemData` ShopItemData — Shop item data, represents a request to add an shop item to the Tradera system.
    - `activateDate` string, date-time, nullable — Date when Shop item will be active on Tradera. N.B. M:Tradera.Api.Services.Core.Contracts.IRestrictedServiceSoap.GetSellerItems(Tradera.Api.Services.Core.Contracts.Restricted.GetSellerItemsSoapRequest) does not return items for which this date is in the future.
    - `acceptedBuyerId` integer, nullable — The types of Buyers allowed to buy the Item. Possible values: 1 = Sweden, 3 = International, 4 = EU. See the method !:PublicService.GetAcceptedBidderTypes for the authoritative list.
    - `categoryId` integer, nullable — The category Id. See the method !:PublicService.GetCategories for all available categories.
    - `deactivateDate` string, date-time, nullable — Date when Shop item will be deactivated on Tradera.
    - `itemAttributes` integer[], nullable — Item attributes like: New, Used
    - `description` string, nullable — A long (7000 chars) description of the item.
    - `paymentCondition` string, nullable — Describes Payment condition for this Item (500 chars)
    - `price` integer, nullable — Shop item price.
    - `quantity` integer, nullable — Modify the available quantity for this Item. This is a delta and will be added to the current quantity. Use a negative value to decrease the quantity.
    - `absoluteQuantity` integer, nullable — Set the quantity to an absolute value, regardless of the current quantity. It is not allowed to provide both AbsoluteQuantity and Quantity in the same request.
    - `shippingCondition` string, nullable — Describes Shipping condition for this Item (500 chars)
    - `title` string, nullable — The title (short description) of the item (80 chars).
    - `vat` integer, nullable — VAT for the item. The VAT value can be retrieved from API method !:PublicService.GetItemFieldValues.
    - `shippingOptions` ItemShipping[], nullable — A list of shipping options offered to the buyer of the Item. At most 3 shipping options are allowed if Pickup is included. Otherwise, at most 2 shipping options are allowed. See Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.
      - `shippingOptionId` integer, nullable
      - `cost` integer
      - `shippingWeight` number, double, nullable
      - `shippingWeightSpecified` boolean
      - `shippingProductId` integer, nullable
      - `shippingProductIdSpecified` boolean
      - `shippingProviderId` integer, nullable
      - `sellerSurcharge` integer, nullable — Optional seller-defined surcharge added on top of the shipping product's base cost. Not yet used to compute the buyer-facing shipping price — Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost is still the authoritative, required field today and must be sent. In a future API revision, Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost will be removed and the buyer-facing price will be derived from the shipping product (identified by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.ShippingProductId) adjusted by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerSurcharge and Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerDiscount.
      - `sellerSurchargeSpecified` boolean
      - `sellerDiscount` integer, nullable — Optional seller-defined discount subtracted from the shipping product's base cost. Not yet used to compute the buyer-facing shipping price — Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost is still the authoritative, required field today and must be sent. In a future API revision, Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.Cost will be removed and the buyer-facing price will be derived from the shipping product (identified by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.ShippingProductId) adjusted by Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerSurcharge and Tradera.Api.Services.Core.Contracts.Entities.ItemShipping.SellerDiscount.
      - `sellerDiscountSpecified` boolean
    - `paymentOptionIds` integer[], nullable — An array of ids of Payment types (more than one can be specified). See the method !:PublicService.GetItemFieldValues for a list.
    - `ownReferences` string[], nullable — The sellers own references for this Item (60 chars).
    - `itemImages` ItemImageData[], nullable — Shop item images, an array of Tradera.Api.Services.Core.Contracts.Entities.ItemImageData objects (max 40 images). Max accepted size: 4MB
      - `hasMega` boolean — If the Image should have a Mega image created when processed.
      - `format` 0 | 1 | 2 — Specifies different image formats.
      - `data` string, byte, nullable — Image data (byte-array / base64 encoded).
      - `name` string, nullable — Name of the image (optional).
    - `externalId` integer, nullable — The id of the item in external system if there is any (optional).
    - `attributeValues` ItemAttributeValues
      - `terms` TermValues[], nullable
        - `id` integer
        - `values` string[], nullable
      - `numbers` NumberValues[], nullable
        - `id` integer
        - `values` number[], nullable
    - `descriptionLanguageCodeIso2` string, nullable — The description language code of the item.

## Response `200`

OK

- QueuedRequestResponse
  - `requestId` integer
  - `itemId` integer

---

[API](https://skmtc.dev/tradera/apis/tradera-api.md) · [All operations](https://skmtc.dev/tradera/apis/tradera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tradera/tradera-api/revisions/b5f3e81e36e1/schema)