--- title: "Modifies an existing regular item with all specified properties. This command enables complete reconfiguration of an item including identifiers, descriptions, prices, measurements, and miscellaneous information." method: PATCH path: "/v2/itemdetails/change" tags: ["ItemdetailsCommand"] --- # Modifies an existing regular item with all specified properties. This command enables complete reconfiguration of an item including identifiers, descriptions, prices, measurements, and miscellaneous information. `PATCH /v2/itemdetails/change` ## Headers - `x-tenant-id` string, uuid, required - `x-runas` string - `x-companyid` string ## Request body - JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsChangeItemCommandRequest — Modifies an existing regular item with all specified properties. This command enables complete reconfiguration of an item including identifiers, descriptions, prices, measurements, and miscellaneous information. - Request - `itemId` string, uuid - `productGroupId` string, uuid - `shippingClassId` string, uuid - `manufacturerId` string, uuid - `categories` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCategories — Defines the category assignments of an item for creation. This structure manages all categories to which an item can be assigned and enables hierarchical classification for better organization and navigation. - `categories` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCategory[] — Contains all categories to which the item is assigned. An item can be assigned to multiple categories simultaneously to enable flexible categorization and better discoverability. - `categoryId` string, uuid - `identifiers` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemIdentifiers — Defines various identifiers of an item for creation. This structure includes all relevant markings and numbers used for unique identification of an item. - `sku` string — Unique item number (Stock Keeping Unit) - the user-assigned main identification of the item. - `amazonFnsku` string — Amazon FNSKU (Fulfillment Network Stock Keeping Unit) - used by Amazon for inventory management. - `gtin` string — GTIN (Global Trade Item Number, formerly EAN) - internationally standardized product identification for global trade. - `manufacturerNumber` string — Manufacturer's item number - the official product number assigned by the manufacturer. - `isbn` string — ISBN (International Standard Book Number) - mainly used for books and other publications. - `tariccode` string — Taric code - customs tariff number for international trade and customs processing. - `upc` string — UPC (Universal Product Code) - barcode standard mainly used in North America. - `unNumber` string — UN number - used for marking dangerous goods in transport. - `hazardNumber` string — Hazard number - identifies the type of danger for hazardous goods in transport. - `ownIdentifier` string — Own identifier - user-defined internal identification for company-specific purposes. - `defaultAsin` string — Default ASIN (Amazon Standard Identification Number) - primary Amazon product identification. - `jfsku` string — JTL-Fulfillment-SKU (JFSKU) - unique identifier in the JTL Fulfillment Network (FFN) for item identification. - `descriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemDescriptions — Defines the collection of all descriptions of an item for creation. This structure manages default, platform, and sales channel-specific item descriptions for different languages and distribution channels. - `defaultDescriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateDefaultDescription[] — Default descriptions of the item. This is used when no more specific platform or sales channel descriptions are available and serves as a fallback description. - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). - `descriptionData` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateDescriptionData — Defines the actual description data of an item. This structure contains all textual information of an item including SEO-relevant metadata for online shops. - `itemName` string — The name of the item as displayed in the user interface or shop. - `shortDescription` string — Short description of the item for overview displays and search results. - `description` string — Detailed description of the item with comprehensive product information and properties. - `metaDescription` string — Meta description for search engine optimization (SEO) that is displayed in search results. - `metaKeywords` string — Meta keywords for search engine optimization to improve discoverability of the item. - `titleTag` string — HTML title tag for the item that is displayed in the browser tab and search results. - `urlPath` string — URL path for the item to create SEO-friendly and speaking URLs. - `salesChannelDescriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateSalesChannelDescription[] — List of sales channel-specific descriptions for sales platforms like JTL-Shop. Enables individual customization of item descriptions for specific sales channels. - `salesChannelId` string — Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers. - `languageIso` string — ISO2 language code that determines the language for this sales channel-specific description. - `descriptionData` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateDescriptionData — Defines the actual description data of an item. This structure contains all textual information of an item including SEO-relevant metadata for online shops. - `itemName` string — The name of the item as displayed in the user interface or shop. - `shortDescription` string — Short description of the item for overview displays and search results. - `description` string — Detailed description of the item with comprehensive product information and properties. - `metaDescription` string — Meta description for search engine optimization (SEO) that is displayed in search results. - `metaKeywords` string — Meta keywords for search engine optimization to improve discoverability of the item. - `titleTag` string — HTML title tag for the item that is displayed in the browser tab and search results. - `urlPath` string — URL path for the item to create SEO-friendly and speaking URLs. - `platformDescriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdatePlatformDescription[] — List of platform-specific descriptions for non-sales platforms like print. Allows different descriptions for various output platforms. - `platformId` string, uuid - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). - `descriptionData` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateDescriptionData — Defines the actual description data of an item. This structure contains all textual information of an item including SEO-relevant metadata for online shops. - `itemName` string — The name of the item as displayed in the user interface or shop. - `shortDescription` string — Short description of the item for overview displays and search results. - `description` string — Detailed description of the item with comprehensive product information and properties. - `metaDescription` string — Meta description for search engine optimization (SEO) that is displayed in search results. - `metaKeywords` string — Meta keywords for search engine optimization to improve discoverability of the item. - `titleTag` string — HTML title tag for the item that is displayed in the browser tab and search results. - `urlPath` string — URL path for the item to create SEO-friendly and speaking URLs. - `prices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemPrices — Defines the complete price structure of an item for creation. This structure includes all price information for different sales channels, customer groups and individual customer prices as well as basic price information. - `ignoreDiscounts` boolean — Indicates whether discounts should be ignored for this item. When set to true, no automatic discounts will be applied to the item prices. - `salesPriceNet` number — Net sales price of the item without taxes and discounts - the basic selling price of the item. - `suggestedRetailPrice` number — Manufacturer's suggested retail price (MSRP) - the selling price recommended by the manufacturer. - `purchasePriceNet` number — Net purchase price without taxes - the price at which the item was purchased. - `ebayPrice` number — eBay-specific selling price - special price for eBay sales. - `amazonPrice` number — Amazon-specific selling price - special price for Amazon sales. - `salesChannelPrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemSaleschannelPrices[] — List of sales channel-specific prices - enables different pricing for various sales channels or shops. - `saleschannelId` string, uuid - `customerGroupPrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCustomerGroupPrices[] — List of prices for different customer groups within this sales channel - enables differentiated pricing by customer groups. - `customerGroupId` string, uuid - `prices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemPrice[] — List of prices for this customer group - can contain different tier prices or volume discounts. - `fromQuantity` integer — Minimum quantity from which this price applies - enables tier prices based on order quantity (e.g., from 10 pieces). - `netPrice` number — Net price for this price tier without taxes - the actual selling price for the specified quantity tier. - `reduceStandardPriceByPercent` number — Percentage discount on the standard price - indicates by what percentage the standard price is reduced for this price tier. Used as an alternative to NetPrice. - `isActive` boolean — Indicates whether this sales channel is active for the item - determines whether the item can be sold in this sales channel. - `customerPrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCustomerPrices[] — List of customer-specific prices - allows individual price agreements for specific customers. - `customerId` string, uuid — Represents a unique key for identifying a customer in the JTL system. - `prices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemPrice[] — List of individual prices for this customer - can contain different tier prices or special conditions. - `fromQuantity` integer — Minimum quantity from which this price applies - enables tier prices based on order quantity (e.g., from 10 pieces). - `netPrice` number — Net price for this price tier without taxes - the actual selling price for the specified quantity tier. - `reduceStandardPriceByPercent` number — Percentage discount on the standard price - indicates by what percentage the standard price is reduced for this price tier. Used as an alternative to NetPrice. - `defaultPrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCustomerGroupPrices[] — List of default prices for different customer groups - these prices serve as fallback when no more specific prices are defined. - `customerGroupId` string, uuid - `prices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemPrice[] — List of prices for this customer group - can contain different tier prices or volume discounts. - `fromQuantity` integer — Minimum quantity from which this price applies - enables tier prices based on order quantity (e.g., from 10 pieces). - `netPrice` number — Net price for this price tier without taxes - the actual selling price for the specified quantity tier. - `reduceStandardPriceByPercent` number — Percentage discount on the standard price - indicates by what percentage the standard price is reduced for this price tier. Used as an alternative to NetPrice. - `measurements` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemMeasurements — Defines the physical dimensions and weight specifications of an item for creation. This structure includes all relevant measurements for storage, shipping and product presentation and is used for shipping cost calculations and storage space optimizations. - `height` number — Height of the item in the configured unit of measurement (usually centimeters or millimeters). - `length` number — Length of the item in the configured unit of measurement (usually centimeters or millimeters). - `shippingWeight` number — Shipping weight of the item for shipping cost calculation in the configured weight unit (usually kilograms or grams). May differ from the actual item weight. - `weight` number — Actual weight of the item without packaging in the configured weight unit (usually kilograms or grams). - `width` number — Width of the item in the configured unit of measurement (usually centimeters or millimeters). - `images` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemImages — Model Class: UpdateItemImages - `defaultImages` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemImage[] — List of default images assigned to the item. - `blobIdentifier` string, uuid — Unique ID to identify an image. - `sortNumber` integer — Sortnumber of the image. - `isMainImage` boolean — Declares the main image of the item. Typically it is the image with sortnumber 1. - `platformImages` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdatePlatformImages[] — List of images assigned to different platforms. - `platformId` string, uuid - `images` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemImage[] — List of images assigned to the platform. - `blobIdentifier` string, uuid — Unique ID to identify an image. - `sortNumber` integer — Sortnumber of the image. - `isMainImage` boolean — Declares the main image of the item. Typically it is the image with sortnumber 1. - `saleschannelImages` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateSaleschannelImages[] — List of images assigned to different saleschannels. - `saleschannelId` string — Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers. - `images` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemImage[] — List of images assigned to the platform. - `blobIdentifier` string, uuid — Unique ID to identify an image. - `sortNumber` integer — Sortnumber of the image. - `isMainImage` boolean — Declares the main image of the item. Typically it is the image with sortnumber 1. - `ebayImages` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateEbayImages[] — List of images assigned to different eBay accounts. - `ebayAccountId` string, uuid — Represents a unique key for identifying an eBay user within the system. - `images` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemImage[] — List of images assigned to the platform. - `blobIdentifier` string, uuid — Unique ID to identify an image. - `sortNumber` integer — Sortnumber of the image. - `isMainImage` boolean — Declares the main image of the item. Typically it is the image with sortnumber 1. - `customFields` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCustomFields — Defines custom fields for an item to store additional, user-defined information. Custom fields allow flexible extension of item data beyond standard properties and can be used for special business requirements, integrations, or custom workflows. - `fieldValues` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCustomFieldValue[] — List of custom field values assigned to the item. Each entry represents a custom field with its corresponding value. - `fieldId` string, uuid - `value` string — The actual value stored in this custom field. The format and content depend on the custom field type definition (text, number, date, etc.). - `valueCultureName` string — The culture name (e.g., "en-US", "de-DE") associated with the custom field value. This is important for localized fields where the value may vary based on the user's language or region. When returning those values from the server side this Format is always InvariantCulture. When sending values to the server side the culture name is optional and if not provided, it will be treated as InvariantCulture. Otherwise this value initializes a CultureInfo Object. - `suppliers` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemSuppliers — Model Class: UpdateItemSuppliers - `defaultSupplier` string, uuid - `defaultDropshippingSupplier` string, uuid - `suppliers` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemSupplier[] — Assigned suppliers for the item - `supplierId` string, uuid - `supplierItemName` string — Name of the item at the supplier (max 255 characters). - `supplierItemNumber` string — Item number at the supplier (max 255 characters). - `stockLevel` number — Stock level of the item at the supplier. - `netPurchasePrice` number — Net purchase price of the item at the supplier. - `minimumPurchaseQuantity` integer — Minimum purchase quantity of the item at the supplier. - `deliveryTimeInDays` integer — Delivery time for this item at the supplier (in days). - `isDropshippingActive` boolean — Indicates if this item uses dropshipping from the supplier. - `packageUnitDescription` string — Description of the packaging unit. - `packageUnitQuantity` number — Quantity per packaging unit. - `notes` string — Additional notes (max 512 characters). - `vatRate` number — VAT rate of the item at the supplier. - `useSupplierDeliveryTime` boolean — Whether to use the supplier's delivery time directly. - `includeSupplierStock` boolean — Whether to include the supplier's stock in own inventory. - `purchaseInterval` number — Purchase interval for this item at the supplier. - `scalePrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateSupplierPrice[] — Scale prices defined by the supplier for this item. - `fromQuantity` number — Quantity from which the price applies. This value is not editable. To change it, a new scale must be created. - `netPrice` number — Net price for this scale. - `usePercentageDiscount` boolean — Indicates whether the scale uses a percentage discount of the NetPurchasePrice. - `percentageDiscount` number — The percentage discount applied in this scale. - `variations` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemVariations — Model Class: UpdateItemVariations - `variations` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateVariation[] — Contains all Variations - `variationId` string, uuid - `position` integer — Position of this Variation in the List - `descriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateDescription[] — Descriptions of this Variation in multiple Languages - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). - `name` string — Name of the Variation in the specific language - `values` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateVariationValue[] — Values for this Variation - `variationValueId` string, uuid - `itemNumber` string — Itemnumber for this variationvalue - `gTIN` string — GTIN for this variationvalue - `weightOffset` number — Offset for the weight of this variationvalue - `descriptions` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateDescription[] — Descriptions of this VariationValue in multiple Languages - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). - `name` string — Name of the Variation in the specific language - `surcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateVariationValueSurcharges — Model Class: UpdateVariationValueSurcharges - `defaultSurchargeNet` number — Default Surcharge if there is none specified for a specific saleschannel + customergroup - `customerGroupSurcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateCustomerGroupSurcharge[] — Default Surcharges for specific customergroups in general, independent of saleschannel - `customerGroupId` string, uuid - `surcharge` number — Surcharge for that customergroup - `isActive` boolean — Defines if the surcharges will be synchronized to online saleschannels. Does not apply for the default customer group surcharges, which are always synchronized when not overriden. - `salesChannelSurcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateSalesChannelSurcharge[] — Surcharge for specific saleschannels + customergroups - `salesChannelId` string — Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers. - `surcharges` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateCustomerGroupSurcharge[] — Contains the surcharges for that saleschannel and customergroup - … - `position` integer — Position of this VariationValue in the List - `image` string, uuid - `variationType` 0 | 1 | 2 | 3 | 4 | 5 | 6 — 0 = Unknown, 1 = Selectbox, 2 = Radiobutton, 3 = Swatches, 4 = Textbox, 5 = FreeText, 6 = MandatoryFreeText - `deliveryStatusId` string, uuid - `includeInPriceList` boolean — Indicates whether the item can be included in exported price lists. Tab 'Sonstiges'. - `ignoreOrderSuggestions` boolean — Indicates whether order suggestions should be ignored for this item. If true, the item will not appear in automatic order suggestions. Tab 'Sonstiges'. - `ignoreDiscounts` boolean — Indicates whether the item is not eligible for discounts (Rabatte ignorieren / Nicht Rabattfähig). Tab 'Sonstiges'. - `countryOfOrigin` string — Country of origin (Herkunftsland) - ISO code or country name. Max length 64. Tab 'Sonstiges'. - `notes` string — Additional notes (Anmerkung) for the item - unlimited length. Tab 'Sonstiges'. - `features` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemFeatures — Defines the feature assignments of an item. This structure manages all features (characteristics/attributes) that describe specific properties or attributes of an item, such as color, size, material, or other custom characteristics used for product differentiation and filtering. - `features` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemFeature[] — Contains all features assigned to the item. Each feature represents a specific characteristic or attribute that describes the item in more detail, enabling better product differentiation and advanced filtering capabilities. - `featureId` string, uuid - `attributes` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemAttributes — Model Class: UpdateItemAttributes - `values` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateAttributeValues[] — Contains all attribute values assigned to the item - `attributeId` string, uuid - `defaultValues` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateAttributeValue[] — Defines the default values for the attribute and item in different languages. - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). - `value` string — Value of this attribute as string. Please consider the Attribute Type for correct formatting. - `salesChannelValues` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateAttributeSalesChannelValues[] — Contains all values for saleschannels for this attribute and item - `salesChannelId` string — Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers. - `values` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateAttributeValue[] — Contains the values for a saleschannel - `languageIso` string — ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). - `value` string — Value of this attribute as string. Please consider the Attribute Type for correct formatting. - `unitPricing` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemUnitPricing — Defines the item unit pricing settings for creation and modification. This structure includes all relevant information about the sales unit, packaging unit, inner quantity and base price details for an item. - `salesUnitId` string, uuid - `packagingUnitId` string, uuid - `innerQuantity` number — The amount of content for one piece of the sales unit, relative to the inner quantity unit. - `innerQuantityUnitId` string, uuid - `isBasePriceDeclared` boolean — Indicates whether the base price should be automatically calculated and displayed. - `basePriceReferenceUnitId` string, uuid - `basePriceReferenceAmount` number — The reference amount used when calculating the base price (e.g. 1 for per liter, 100 for per 100 grams). - `specialPrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemSpecialPrices — Defines the special prices (promotional prices) structure of an item. This structure includes time-based and stock-based special pricing for different sales channels and customer groups, as well as Amazon-specific special prices. - `isActive` boolean — Indicates whether special prices are active for this item. When set to true, the special price rules defined below will be applied according to their conditions. - `startDate` string, date-time — Date from which the special price becomes active. The special price will only be valid from this date onwards. - `endDate` string, date-time — Date until which the special price remains active. The special price will expire after this date. Only evaluated if IsEndDateActive is true. - `isEndDateActive` boolean — Indicates whether the end date should be considered. If false, the special price has no expiration date. - `minimumStockQuantity` integer — Minimum stock quantity that must be available for the special price to remain active. Only evaluated if IsStockRestrictionActive is true. - `isStockRestrictionActive` boolean — Indicates whether the stock restriction should be applied. When true, the special price is only active if the stock level is greater than or equal to MinimumStockQuantity. Can only be activated for items that use stock management. - `salesChannelSpecialPrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemSalesChannelSpecialPrices[] — List of sales channel-specific special prices - enables different promotional pricing for various sales channels or shops with customer group differentiation. - `salesChannelId` string — Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers. - `specialPrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemCustomerGroupSpecialPrice[] — List of special prices for different customer groups within this sales channel - enables differentiated promotional pricing by customer groups. - `customerGroupId` string, uuid - `netPrice` number — Net special price for this customer group without taxes. Setting this to null will deactivate the special price for this customer group. - `isActive` boolean — Indicates whether this special price is active for this customer group. Automatically set to false when NetPrice is set to null. - `storageConstraints` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateItemStorageConstraints — Defines the storage and inventory management constraints of an item. This structure includes settings for negative stock handling, inventory management, serial numbers, batch tracking, and best-before date management. - `allowNegativeStock` boolean — Allows selling a higher quantity of the item than is actually in stock. This global setting must be activated first before platform-specific or sales channel-specific negative stock settings can be enabled. - `itemPlatformNegativeStocks` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateNegativeStockPlatform[] — List of platform-specific negative stock settings. Activates the ability to sell a higher quantity of the item for specific platforms (e.g., eBay, Amazon). AllowNegativeStock must be activated as well for these settings to take effect. - `platformId` string, uuid - `isNegativeStockAllowed` boolean — Determines if negative stock is allowed for this platform. When true, orders can be accepted even when the item is out of stock on this specific marketplace. - `itemSalesChannelNegativeStocks` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsUpdateNegativeStockSalesChannel[] — List of sales channel-specific negative stock settings. Activates the ability to sell a higher quantity of the item for specific sales channels or shops. AllowNegativeStock must be activated as well for these settings to take effect. - `salesChannelId` string — Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers. - `isNegativeStockAllowed` boolean — Determines if negative stock is allowed for this sales channel. When true, orders can be accepted even when the item is out of stock in this specific channel. - `buffer` integer — Item buffer quantity - defines a safety stock buffer that is reserved and not available for sale. This helps prevent overselling and ensures availability for important orders. - `globalMinimumStockLevel` number — Global minimum stock level across all warehouses. When the total stock falls below this value, the item is flagged for reordering. Used for automatic order suggestions and low-stock warnings. - `hasBatch` boolean — Indicates whether the item uses batch management. When enabled, the item requires batch numbers to be assigned for each stock movement to enable tracking and traceability. - `isInventoryManagementActive` boolean — Determines if the item is working with inventory management. When active, stock levels are tracked and managed; when inactive, the item is treated as always available regardless of stock levels. - `isBestBeforeManaged` boolean — Determines if the item is working with best-before date (MHD - Mindesthaltbarkeitsdatum) management. When enabled, stock items must have an assigned best-before date for tracking perishable goods. - `isStockDivisible` boolean — Determines if the item can be sold in split quantities (fractional units). When enabled, stock can be managed in decimal quantities (e.g., 2.5 pieces) instead of only whole numbers. - `serialNumberType` 0 | 1 | 2 — 0 = NoSerialNumbers, 1 = SerialNumbersActive, 2 = SerialNumbersTracking ## Response `200` Item was successfully modified. --- [API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)