> ## Documentation Index > Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. > 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. ## OpenAPI ````yaml /openapi/2.1.json patch /v2/items/{itemId} openapi: 3.0.0 info: title: JTL-WAWI API (Cloud) description: "JTL-Wawi-Version: 2.2.0-alpha.9492+Sha.4c8d5d1\r\n# Introduction\r\n\r\nWelcome to the JTL-WAWI technical API documentation. This guide is here to help developers understand how our REST API works and how it can be integrated into your existing systems. We'll delve into the details of authentication and data manipulation processes, providing clear examples along the way. Whether you're a developer or an IT professional, this documentation aims to give you a practical understanding, laying the groundwork for effectively using the JTL-WAWI API to enhance your processes.\r\n\r\n# Authentication\r\n\r\nYou register your application with the API by sending a POST request with the required information and corresponding keys. You can find the exact request details at https://developer.jtl-software.com/products/erp/swagger/appregistration. This information has to include the following:\r\n\r\n* AppId\r\n* DisplayName\r\n* Description\r\n* Version\r\n* ProviderName\r\n* ProviderWebsite\r\n* MandatoryApiScopes\r\n\r\nThis data is crucial for identifying and registering your application with the API. The API uses it to generate a temporary authentication ID that allows your application to access the necessary resources. After successful validation of this information, you will receive the API key required for future authentication and API requests.\r\n\r\nBefore you can begin the registration process, you must open JTL-Wawi (new interface) and start the registration process under 'Admin->App registration'. Only at this point are you authorised to send the first API call. This step in JTL-Wawi ensures that your application is properly registered and has permission to use the API.\r\n\r\nThe API will send you an authentication ID in the form of a token. Once you have received this token and successfully completed the registration in JTL-Wawi, you will send another request to the API by including this authentication ID in the URL path.\r\n\r\nAfter successful validation of this second request by the API and confirmation of the correct information, you will be provided with the actual API key. It is important to note that this API key will not be displayed again!\r\n\r\nThis API key will be used in the future to authenticate requests to the API. It is of utmost importance that you securely store the API key upon receipt, as it cannot be retrieved from any other location in the system." contact: name: JTL-Software-GmbH url: https://developer.jtl-software.com/ email: partner@jtl-software.com version: '2.1' x-application-version: 2.2.0.0 servers: - url: https://api.jtl-cloud.com/erp description: Production Environment Cloud API Gateway security: [] tags: - name: WMS description: >-

Query all pick lists for a specific wms warehouse that are not completed. - name: Wawi App description: >-

Get a specific customer - name: Warehouses description: >-

Queries all storage locations for a given warehouse. - name: Units description: Development - name: Transaction Status description: >-

Queries all transaction statuses for a sales order. - name: Tax description: >-

Returns the tax rate for the given item. - name: Inventory description: >-

Queries stocks for a specific item, warehouse or storage location. - name: Sales Order description: Planned - name: Sales Invoice Correction description: Planned - name: Return description: >-

Create a new return with associated items and packages. - name: Item description: >-

Queries all responsible persons. - name: Refund description: Planned - name: Property description: >-

Queries all properties of items. - name: Printer description: >-

Retrieves all installed printers. - name: Master Data description: >-

Queries all on hold reasons for sales orders. - name: Manufacturer description: Development - name: Label description: Development - name: Sales Invoice description: Planned - name: Info description: >-

Returns the status of the API. - name: Features description: >-

Returns the available feature sets with release state and API version. - name: Extensibility description: Planned - name: Shipment description: Development - name: Delivery Note description: Planned - name: Custom Field description: Development - name: Customer description: >-

Deletes a specific customer. - name: Authentication description: >-

DEPRECATED seit Wawi 2.2.0: No-Op. Seit Wawi 2.1.0 registriert sich die Wawi selbst per JWT. - name: Attribute description: Development - name: Sales Quotation description: >-

Execute the printing of a sales quotation - name: Production - name: Resources - name: Company - name: Sales Orders - name: Marketplace Seller - name: Seller - name: Marketplace Order - name: Marketplace Offer - name: Marketplace Invoicing - name: Sales Channel - name: Payment - name: Warehouse Assistant - name: Worker paths: /v2/items/{itemId}: patch: tags: - Item summary: >- 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. description: >- 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. operationId: Itemdetails_ChangeItem parameters: - name: itemId in: path required: true schema: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ArtikelKey' example: b45f6432-2462-4c6f-b00f-1d9d01000000 x-position: 2 - name: x-companyid in: header description: >- The Company-Id (int or uuid) of the company on whose behalf the request is executed. schema: type: string - name: x-tenant-id in: header required: true schema: type: string format: uuid description: The tenant ID for the target ERP instance. requestBody: x-name: request description: Request parameters content: application/json: schema: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ChangeItemCommandRequest required: true x-position: 1 responses: '200': description: Item was successfully modified. content: application/json: schema: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ChangeItemCommandResponse '400': description: '' content: application/json: {} '401': description: '' content: application/json: {} '403': description: '' content: application/json: {} '404': description: '' content: application/json: {} '500': description: '' content: application/json: {} security: - oauth2-authorization-code: - items.write - oauth2-client-credentials: - items.write components: schemas: JTL.Data.Contracts.Keys.ArtikelKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ChangeItemCommandRequest: type: object description: >- 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 additionalProperties: false properties: productGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.WarengruppeKey' description: >- The ID of the product group to which the item should be assigned. Product groups serve for categorical classification of items for reports and analyses. example: b45f6432-2462-4c6f-b00f-1d9d01000000 shippingClassId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VersandklasseKey' description: The ID of the shipping class to which the item should be assigned. example: b45f6432-2462-4c6f-b00f-1d9d01000000 manufacturerId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.HerstellerKey' description: The ID of the manufacturer to which the item should be assigned. example: b45f6432-2462-4c6f-b00f-1d9d01000000 categories: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCategories description: >- Category assignments of the item. Defines all categories to which the item should be assigned for better organization and navigation. identifiers: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemIdentifiers description: >- Identifiers of the item with all relevant markings and numbers for unique identification of the item in various systems. descriptions: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemDescriptions description: >- Descriptions of the item in different languages and for different platforms/sales channels. Includes names, short and long descriptions as well as SEO-relevant information. prices: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemPrices description: >- Price structures of the item for different sales channels, customer groups and individual customers. Includes sales prices, purchase prices and tier prices. measurements: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemMeasurements description: >- Physical dimensions and weight specifications of the item for storage, shipping and product presentation. Important for shipping cost calculations and storage space optimization. images: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemImages description: tbd customFields: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomFields description: >- Custom fields defined for the item to store additional information. Useful for special requirements or integrations. suppliers: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSuppliers description: >- Suppliers associated with the item including supplier-specific information such as purchase prices, delivery times and order intervals. variations: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemVariations description: Variations of an item deliveryStatusId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferstatusKey' description: >- Delivery status id determining the availability display of the item (e.g. 'immediately available', '2-3 days'). Tab 'Sonstiges'. example: b45f6432-2462-4c6f-b00f-1d9d01000000 includeInPriceList: type: boolean description: >- Indicates whether the item can be included in exported price lists. Tab 'Sonstiges'. ignoreOrderSuggestions: type: boolean description: >- Indicates whether order suggestions should be ignored for this item. If true, the item will not appear in automatic order suggestions. Tab 'Sonstiges'. ignoreDiscounts: type: boolean description: >- Indicates whether the item is not eligible for discounts (Rabatte ignorieren / Nicht Rabattfähig). Tab 'Sonstiges'. countryOfOrigin: type: string description: >- Country of origin (Herkunftsland) - ISO code or country name. Max length 64. Tab 'Sonstiges'. notes: type: string description: >- Additional notes (Anmerkung) for the item - unlimited length. Tab 'Sonstiges'. features: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemFeatures description: Features of an item attributes: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemAttributes description: Attributes of an item unitPricing: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemUnitPricing description: UnitPricing information of an item specialPrices: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSpecialPrices description: SpecialPrices information of an item storageConstraints: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemStorageConstraints description: ItemStorageConstraints information of an item crosssellingGroups: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCrosssellingGroups description: CrosssellingGroups of an item JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ChangeItemCommandResponse: type: object description: >- 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. - Response additionalProperties: false required: - Item properties: item: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemdetailsItem description: The changed item. JTL.Data.Contracts.Keys.WarengruppeKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.VersandklasseKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.HerstellerKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCategories: type: object description: >- 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. additionalProperties: false properties: categories: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCategory JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemIdentifiers: type: object description: >- Defines various identifiers of an item for creation. This structure includes all relevant markings and numbers used for unique identification of an item. additionalProperties: false properties: sku: type: string description: >- Unique item number (Stock Keeping Unit) - the user-assigned main identification of the item. amazonFnsku: type: string description: >- Amazon FNSKU (Fulfillment Network Stock Keeping Unit) - used by Amazon for inventory management. gtin: type: string description: >- GTIN (Global Trade Item Number, formerly EAN) - internationally standardized product identification for global trade. manufacturerNumber: type: string description: >- Manufacturer's item number - the official product number assigned by the manufacturer. isbn: type: string description: >- ISBN (International Standard Book Number) - mainly used for books and other publications. tariccode: type: string description: >- Taric code - customs tariff number for international trade and customs processing. upc: type: string description: >- UPC (Universal Product Code) - barcode standard mainly used in North America. unNumber: type: string description: UN number - used for marking dangerous goods in transport. hazardNumber: type: string description: >- Hazard number - identifies the type of danger for hazardous goods in transport. ownIdentifier: type: string description: >- Own identifier - user-defined internal identification for company-specific purposes. defaultAsin: type: string description: >- Default ASIN (Amazon Standard Identification Number) - primary Amazon product identification. jfsku: type: string description: >- JTL-Fulfillment-SKU (JFSKU) - unique identifier in the JTL Fulfillment Network (FFN) for item identification. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemDescriptions: type: object description: >- 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. additionalProperties: false properties: defaultDescriptions: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDefaultDescription salesChannelDescriptions: type: array description: >- List of sales channel-specific descriptions for sales platforms like JTL-Shop. Enables individual customization of item descriptions for specific sales channels. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSalesChannelDescription platformDescriptions: type: array description: >- List of platform-specific descriptions for non-sales platforms like print. Allows different descriptions for various output platforms. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdatePlatformDescription JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemPrices: type: object description: >- 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. additionalProperties: false properties: ignoreDiscounts: type: boolean description: >- Indicates whether discounts should be ignored for this item. When set to true, no automatic discounts will be applied to the item prices. salesPriceNet: type: number description: >- Net sales price of the item without taxes and discounts - the basic selling price of the item. format: decimal suggestedRetailPrice: type: number description: >- Manufacturer's suggested retail price (MSRP) - the selling price recommended by the manufacturer. format: decimal purchasePriceNet: type: number description: >- Net purchase price without taxes - the price at which the item was purchased. format: decimal ebayPrice: type: number description: eBay-specific selling price - special price for eBay sales. format: decimal amazonPrice: type: number description: Amazon-specific selling price - special price for Amazon sales. format: decimal salesChannelPrices: type: array description: >- List of sales channel-specific prices - enables different pricing for various sales channels or shops. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSaleschannelPrices customerPrices: type: array description: >- List of customer-specific prices - allows individual price agreements for specific customers. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomerPrices defaultPrices: type: array description: >- List of default prices for different customer groups - these prices serve as fallback when no more specific prices are defined. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomerGroupPrices JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemMeasurements: type: object description: >- 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. additionalProperties: false properties: height: type: number description: >- Height of the item in the configured unit of measurement (usually centimeters or millimeters). format: decimal length: type: number description: >- Length of the item in the configured unit of measurement (usually centimeters or millimeters). format: decimal shippingWeight: type: number description: >- 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. format: decimal weight: type: number description: >- Actual weight of the item without packaging in the configured weight unit (usually kilograms or grams). format: decimal width: type: number description: >- Width of the item in the configured unit of measurement (usually centimeters or millimeters). format: decimal JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemImages: type: object description: 'Model Class: UpdateItemImages ' additionalProperties: false properties: defaultImages: type: array description: List of default images assigned to the item. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemImage platformImages: type: array description: List of images assigned to different platforms. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdatePlatformImages saleschannelImages: type: array description: List of images assigned to different saleschannels. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSaleschannelImages ebayImages: type: array description: List of images assigned to different eBay accounts. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateEbayImages JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomFields: type: object description: >- 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. additionalProperties: false required: - FieldValues properties: fieldValues: type: array description: >- List of custom field values assigned to the item. Each entry represents a custom field with its corresponding value. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomFieldValue JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSuppliers: type: object description: 'Model Class: UpdateItemSuppliers ' additionalProperties: false properties: defaultSupplier: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferantKey' description: Sets the default supplier for the item. example: b45f6432-2462-4c6f-b00f-1d9d01000000 defaultDropshippingSupplier: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferantKey' description: Sets the default supplier for dropshipping for the item. example: b45f6432-2462-4c6f-b00f-1d9d01000000 suppliers: type: array description: Assigned suppliers for the item items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSupplier JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemVariations: type: object description: 'Model Class: UpdateItemVariations ' additionalProperties: false properties: variations: type: array description: Contains all Variations items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateVariation JTL.Data.Contracts.Keys.LieferstatusKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemFeatures: type: object description: >- 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. additionalProperties: false properties: features: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemFeature JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemAttributes: type: object description: 'Model Class: UpdateItemAttributes ' additionalProperties: false properties: values: type: array description: Contains all attribute values assigned to the item items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateAttributeValues JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemUnitPricing: type: object description: >- 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. additionalProperties: false properties: salesUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EinheitKey' description: Id of the sales unit in which the item is sold (e.g. piece or box). example: b45f6432-2462-4c6f-b00f-1d9d01000000 packagingUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EinheitKey' description: Id of the packaging unit of the item. example: b45f6432-2462-4c6f-b00f-1d9d01000000 innerQuantity: type: number description: >- The amount of content for one piece of the sales unit, relative to the inner quantity unit. format: decimal innerQuantityUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.MassEinheitKey' description: The measurement unit for the inner quantity (e.g. kg or liter). example: b45f6432-2462-4c6f-b00f-1d9d01000000 isBasePriceDeclared: type: boolean description: >- Indicates whether the base price should be automatically calculated and displayed. basePriceReferenceUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.MassEinheitKey' description: >- The measurement unit to which the base price refers (e.g. per liter or per 100 grams). example: b45f6432-2462-4c6f-b00f-1d9d01000000 basePriceReferenceAmount: type: number description: >- The reference amount used when calculating the base price (e.g. 1 for per liter, 100 for per 100 grams). format: decimal JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSpecialPrices: type: object description: >- 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. additionalProperties: false properties: isActive: type: boolean description: >- 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: type: string description: >- Date from which the special price becomes active. The special price will only be valid from this date onwards. format: date-time endDate: type: string description: >- Date until which the special price remains active. The special price will expire after this date. Only evaluated if IsEndDateActive is true. format: date-time isEndDateActive: type: boolean description: >- Indicates whether the end date should be considered. If false, the special price has no expiration date. minimumStockQuantity: type: integer description: >- Minimum stock quantity that must be available for the special price to remain active. Only evaluated if IsStockRestrictionActive is true. format: int32 isStockRestrictionActive: type: boolean description: >- 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: type: array description: >- List of sales channel-specific special prices - enables different promotional pricing for various sales channels or shops with customer group differentiation. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSalesChannelSpecialPrices JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemStorageConstraints: type: object description: >- 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. additionalProperties: false properties: allowNegativeStock: type: boolean description: >- 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: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateNegativeStockPlatform itemSalesChannelNegativeStocks: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateNegativeStockSalesChannel buffer: type: integer description: >- 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. format: int32 globalMinimumStockLevel: type: number description: >- 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. format: decimal hasBatch: type: boolean description: >- 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: type: boolean description: >- 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: type: boolean description: >- 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: type: boolean description: >- 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: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SerialNumberType type: integer description: >- Determines the type of serial number processing. Defines whether serial numbers are inactive, active, or tracked for this item. format: int32 JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCrosssellingGroups: type: object description: >- Manages cross-selling groups assigned to an item. Cross-selling groups define related products that should be promoted together. additionalProperties: false properties: groups: type: array description: Collection of cross-selling groups associated with the item. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCrosssellingGroup JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemdetailsItem: type: object description: Complete item details including all sub-elements additionalProperties: false required: - Id - Identifiers - SalesChannels properties: id: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ArtikelKey' description: Item id productGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.WarengruppeKey' description: >- The ID of the product group to which the item should be assigned. Product groups serve for categorical classification of items for reports and analyses. shippingClassId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VersandklasseKey' description: The ID of the shipping class to which the item should be assigned. manufacturerId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.HerstellerKey' description: The ID of the manufacturer to which the item should be assigned. identifiers: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemIdentifiers description: >- Various identifiers of the item for unique identification (SKU, GTIN, ISBN, etc.) categories: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCategories description: Categories to which the item is assigned descriptions: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemDescriptions description: List of item descriptions in different languages prices: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemPrices description: >- Price structures of the item for different sales channels, customer groups and individual customers. Includes sales prices, purchase prices and tier prices. images: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemImages description: Images associated with the item measurements: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemMeasurements description: >- Physical dimensions and weight specifications of the item for storage, shipping and product presentation. Important for shipping cost calculations and storage space optimization. customFields: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomFields description: >- Custom fields defined for the item to store additional information. Useful for special requirements or integrations. suppliers: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSuppliers description: >- Suppliers associated with the item including supplier-specific information such as purchase prices, delivery times and order intervals. includeInPriceList: type: boolean description: >- Indicates whether the item can be included in exported price lists. From Tab 'Sonstiges'. ignoreOrderSuggestions: type: boolean description: >- Indicates whether order suggestions should be ignored for this item. If true, the item will not appear in automatic order suggestions. From Tab 'Sonstiges'. ignoreDiscounts: type: boolean description: >- Indicates whether the item is not eligible for discounts (Rabatte ignorieren / Nicht Rabattfähig). From Tab 'Sonstiges'. countryOfOrigin: type: string description: >- Country of origin (Herkunftsland) - ISO code or country name. Max length 64. From Tab 'Sonstiges'. notes: type: string description: >- Additional notes (Anmerkung) for the item - unlimited length. From Tab 'Sonstiges'. modifiedTimestamp: type: string description: Last modification timestamp (date and time) of the item. format: date-time variations: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemVariations description: Variations of an item features: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemFeatures description: Features of an item attributes: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemAttributes description: Attributes of an item unitPricing: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemUnitPricing description: UnitPricing information of an item specialPrices: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSpecialPrices description: SpecialPrices information of an item storageConstraints: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemStorageConstraints description: ItemStorageConstraints information of an item salesChannels: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannels description: >- Per-channel activation status of the item across the active sales channels. crosssellingGroups: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCrosssellingGroups description: CrosssellingGroups of an item JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCategory: type: object description: >- Defines a single category assignment for an item. This structure represents the link between an item and a specific category in the hierarchical category system of the ERP system. additionalProperties: false required: - CategoryId properties: categoryId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KategorieKey' description: >- Unique key of the category that identifies the specific category to which the item should be assigned. This key establishes the connection to the category data. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDefaultDescription: type: object description: >- Defines a default description of an item in a specific language. This description is used as a fallback when no more specific platform or sales channel descriptions are available. additionalProperties: false required: - LanguageIso - DescriptionData properties: languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). descriptionData: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDescriptionData description: >- Contains the actual description data such as name, short and long description as well as SEO-relevant information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSalesChannelDescription: type: object description: >- Defines a sales channel-specific description of an item. This enables individual customization of item descriptions for specific sales channels or shops. additionalProperties: false required: - SalesChannelId - LanguageIso - DescriptionData properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: >- Unique key of the sales channel or shop for which this description is intended. languageIso: type: string description: >- ISO2 language code that determines the language for this sales channel-specific description. descriptionData: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDescriptionData description: >- Contains the sales channel-specific description data with all relevant texts and SEO information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdatePlatformDescription: type: object description: >- Defines a platform-specific description of an item. This enables different descriptions for various output platforms like print or other non-sales platforms. additionalProperties: false required: - PlatformId - LanguageIso - DescriptionData properties: platformId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.PlattformKey' description: >- Unique key of the platform for which this description is intended (e.g., print, labels). languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). descriptionData: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDescriptionData description: >- Contains the platform-specific description data with all relevant texts and SEO information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSaleschannelPrices: type: object description: >- Defines sales channel-specific prices for an item. This structure enables different pricing for various sales channels or shops with customer group-related price structures. additionalProperties: false required: - SaleschannelId - CustomerGroupPrices properties: saleschannelId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ShopKey' description: >- Key of the sales channel that identifies the specific sales channel or shop for which this price structure applies. customerGroupPrices: type: array description: >- List of prices for different customer groups within this sales channel - enables differentiated pricing by customer groups. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomerGroupPrices isActive: type: boolean description: >- Indicates whether this sales channel is active for the item - determines whether the item can be sold in this sales channel. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomerPrices: type: object description: >- Defines customer-specific prices for an item. This structure enables individual price agreements for specific customers that can deviate from standard or customer group prices. additionalProperties: false required: - CustomerId - Prices properties: customerId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundeKey' description: >- Key of the customer that identifies the specific customer for whom these individual prices apply. prices: type: array description: >- List of individual prices for this customer - can contain different tier prices or special conditions. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomerGroupPrices: type: object description: >- Defines customer group-specific prices for an item. This structure enables differentiated pricing by customer groups, allowing different price levels for different customer segments. additionalProperties: false required: - CustomerGroupId - Prices properties: customerGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundenGruppeKey' description: >- Key of the customer group that identifies the specific customer group (e.g., end customers, resellers, wholesalers). prices: type: array description: >- List of prices for this customer group - can contain different tier prices or volume discounts. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemImage: type: object description: 'Model Class: UpdateItemImage ' additionalProperties: false required: - BlobIdentifier - SortNumber - IsMainImage properties: blobIdentifier: type: string description: Unique ID to identify an image. format: uuid sortNumber: type: integer description: Sort order of the image. format: int32 isMainImage: type: boolean description: >- Declares the main image of the item. Typically the image with sort order 1. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdatePlatformImages: type: object description: 'Model Class: UpdatePlatformImages ' additionalProperties: false required: - PlatformId properties: platformId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.PlattformKey' description: Unique ID to identify a platform. images: type: array description: List of images assigned to the platform. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSaleschannelImages: type: object description: 'Model Class: UpdateSaleschannelImages ' additionalProperties: false required: - SaleschannelId properties: saleschannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: Unique ID to identify a saleschannel. images: type: array description: List of images assigned to the saleschannel. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateEbayImages: type: object description: 'Model Class: UpdateEbayImages ' additionalProperties: false required: - EbayAccountId properties: ebayAccountId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EbayUserKey' description: Unique ID to identify an ebay account. images: type: array description: List of images assigned to the eBay account. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomFieldValue: type: object description: >- Defines a single custom field value for an item. This structure connects a custom field definition with its actual value for a specific item. additionalProperties: false required: - FieldId - Value - ValueCultureName properties: fieldId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EigenesFeldKey' description: >- Unique identifier of the custom field definition. References the custom field that was previously created in the system. value: type: string description: >- The actual value stored in this custom field. The format and content depend on the custom field type definition (text, number, date, etc.). valueCultureName: type: string description: >- 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. JTL.Data.Contracts.Keys.LieferantKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSupplier: type: object description: 'Model Class: UpdateItemSupplier ' additionalProperties: false required: - SupplierId properties: supplierId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferantKey' description: Id of the supplier supplierItemName: type: string description: Name of the item at the supplier (max 255 characters). supplierItemNumber: type: string description: Item number at the supplier (max 255 characters). stockLevel: type: number description: Stock level of the item at the supplier. format: decimal netPurchasePrice: type: number description: Net purchase price of the item at the supplier. format: decimal minimumPurchaseQuantity: type: integer description: Minimum purchase quantity of the item at the supplier. format: int32 deliveryTimeInDays: type: integer description: Delivery time for this item at the supplier (in days). format: int32 isDropshippingActive: type: boolean description: Indicates if this item uses dropshipping from the supplier. packageUnitDescription: type: string description: Description of the packaging unit. packageUnitQuantity: type: number description: Quantity per packaging unit. format: decimal notes: type: string description: Additional notes (max 512 characters). vatRate: type: number description: VAT rate of the item at the supplier. format: decimal useSupplierDeliveryTime: type: boolean description: Whether to use the supplier's delivery time directly. includeSupplierStock: type: boolean description: Whether to include the supplier's stock in own inventory. purchaseInterval: type: number description: Purchase interval for this item at the supplier. format: decimal scalePrices: type: array description: Scale prices defined by the supplier for this item. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSupplierPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateVariation: type: object description: 'Model Class: UpdateVariation ' additionalProperties: false required: - VariationId properties: variationId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VariationKey' description: Id of the Variation position: type: integer description: Position of this Variation in the List format: int32 descriptions: type: array description: Descriptions of this Variation in multiple Languages items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDescription values: type: array description: Values for this Variation items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateVariationValue variationType: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationType type: integer description: Type of the Variation format: int32 JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemFeature: type: object description: >- Defines a single feature assignment for an item. This structure represents the link between an item and a specific feature value from the feature system, allowing detailed product characterization. additionalProperties: false required: - FeatureId properties: featureId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.MerkmalWertKey' description: >- Unique key of the feature value that identifies the specific feature characteristic to be assigned to the item. This key establishes the connection to a predefined feature value in the feature system. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateAttributeValues: type: object description: 'Model Class: UpdateAttributeValues ' additionalProperties: false required: - AttributeId properties: attributeId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.AttributKey' description: Identifies the attribute defaultValues: type: array description: >- Defines the default values for the attribute and item in different languages. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateAttributeValue salesChannelValues: type: array description: Contains all values for saleschannels for this attribute and item items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateAttributeSalesChannelValues JTL.Data.Contracts.Keys.EinheitKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.MassEinheitKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemSalesChannelSpecialPrices: type: object description: >- Defines sales channel-specific special prices for an item. This structure enables different promotional pricing for a specific sales channel or shop with customer group-related special price structures. additionalProperties: false required: - SalesChannelId - SpecialPrices properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: >- Key of the sales channel that identifies the specific sales channel or shop for which this special price structure applies. specialPrices: type: array description: >- List of special prices for different customer groups within this sales channel - enables differentiated promotional pricing by customer groups. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomerGroupSpecialPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateNegativeStockPlatform: type: object description: >- Defines negative stock settings for a specific platform. This structure enables individual configuration of negative stock handling per platform (e.g., eBay, Amazon), allowing overselling for specific marketplaces when the global AllowNegativeStock is enabled. additionalProperties: false required: - PlatformId - IsNegativeStockAllowed properties: platformId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.PlattformKey' description: >- Key of the platform that identifies the specific marketplace or platform (e.g., eBay, Amazon) for which this negative stock setting applies. isNegativeStockAllowed: type: boolean description: >- 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. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateNegativeStockSalesChannel: type: object description: >- Defines negative stock settings for a specific sales channel. This structure enables individual configuration of negative stock handling per sales channel, allowing overselling for specific online shops when the global AllowNegativeStock is enabled. additionalProperties: false required: - SalesChannelId - IsNegativeStockAllowed properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: >- Key of the sales channel that identifies the specific shop or sales channel for which this negative stock setting applies. isNegativeStockAllowed: type: boolean description: >- 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. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SerialNumberType: type: integer description: 0 = NoSerialNumbers, 1 = SerialNumbersActive, 2 = SerialNumbersTracking format: int32 x-enumNames: - NoSerialNumbers - SerialNumbersActive - SerialNumbersTracking enum: - 0 - 1 - 2 JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCrosssellingGroup: type: object description: Represents a single cross-selling group with its assigned items. additionalProperties: false required: - CrosssellingGroupId properties: crosssellingGroupId: $ref: >- #/components/schemas/JTL.Data.Contracts.Keys.Artikel.CrossSellingGruppeKey description: Unique identifier of the cross-selling group. items: type: array description: List of item keys that belong to this cross-selling group. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateCrossSellItem JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemIdentifiers: type: object description: >- Defines various identifiers of an item for creation. This structure includes all relevant markings and numbers used for unique identification of an item. additionalProperties: false required: - Sku properties: sku: type: string description: >- Unique item number (Stock Keeping Unit) - the user-assigned main identification of the item. amazonFnsku: type: string description: >- Amazon FNSKU (Fulfillment Network Stock Keeping Unit) - used by Amazon for inventory management. gtin: type: string description: >- GTIN (Global Trade Item Number, formerly EAN) - internationally standardized product identification for global trade. manufacturerNumber: type: string description: >- Manufacturer's item number - the official product number assigned by the manufacturer. isbn: type: string description: >- ISBN (International Standard Book Number) - mainly used for books and other publications. tariccode: type: string description: >- Taric code - customs tariff number for international trade and customs processing. upc: type: string description: >- UPC (Universal Product Code) - barcode standard mainly used in North America. unNumber: type: string description: UN number - used for marking dangerous goods in transport. hazardNumber: type: string description: >- Hazard number - identifies the type of danger for hazardous goods in transport. ownIdentifier: type: string description: >- Own identifier - user-defined internal identification for company-specific purposes. defaultAsin: type: string description: >- Default ASIN (Amazon Standard Identification Number) - primary Amazon product identification. jfsku: type: string description: >- JTL-Fulfillment-SKU (JFSKU) - unique identifier in the JTL Fulfillment Network (FFN) for item identification. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCategories: type: object description: >- 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. additionalProperties: false required: - Categories properties: categories: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCategory JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemDescriptions: type: object description: >- 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. additionalProperties: false required: - DefaultDescriptions properties: defaultDescriptions: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.DefaultDescription salesChannelDescriptions: type: array description: >- List of sales channel-specific descriptions for sales platforms like JTL-Shop. Enables individual customization of item descriptions for specific sales channels. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SalesChannelDescription platformDescriptions: type: array description: >- List of platform-specific descriptions for non-sales platforms like print. Allows different descriptions for various output platforms. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.PlatformDescription JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemPrices: type: object description: >- 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. additionalProperties: false properties: ignoreDiscounts: type: boolean description: >- Indicates whether discounts should be ignored for this item. When set to true, no automatic discounts will be applied to the item prices. salesPriceNet: type: number description: >- Net sales price of the item without taxes and discounts - the basic selling price of the item. format: decimal suggestedRetailPrice: type: number description: >- Manufacturer's suggested retail price (MSRP) - the selling price recommended by the manufacturer. format: decimal purchasePriceNet: type: number description: >- Net purchase price without taxes - the price at which the item was purchased. format: decimal ebayPrice: type: number description: eBay-specific selling price - special price for eBay sales. format: decimal amazonPrice: type: number description: Amazon-specific selling price - special price for Amazon sales. format: decimal salesChannelPrices: type: array description: >- List of sales channel-specific prices - enables different pricing for various sales channels or shops. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSaleschannelPrices customerPrices: type: array description: >- List of customer-specific prices - allows individual price agreements for specific customers. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomerPrices defaultPrices: type: array description: >- List of default prices for different customer groups - these prices serve as fallback when no more specific prices are defined. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomerGroupPrices JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemImages: type: object description: 'Model Class: ItemImages ' additionalProperties: false properties: defaultImages: type: array description: List of default images assigned to the item. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemImage platformImages: type: array description: List of images assigned to different platforms. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.PlatformImages saleschannelImages: type: array description: List of images assigned to different saleschannels. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SaleschannelImages ebayImages: type: array description: List of images assigned to different eBay accounts. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.EbayImages JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemMeasurements: type: object description: >- 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. additionalProperties: false properties: height: type: number description: >- Height of the item in the configured unit of measurement (usually centimeters or millimeters). format: decimal length: type: number description: >- Length of the item in the configured unit of measurement (usually centimeters or millimeters). format: decimal shippingWeight: type: number description: >- 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. format: decimal weight: type: number description: >- Actual weight of the item without packaging in the configured weight unit (usually kilograms or grams). format: decimal width: type: number description: >- Width of the item in the configured unit of measurement (usually centimeters or millimeters). format: decimal JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomFields: type: object description: >- 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. additionalProperties: false required: - FieldValues properties: fieldValues: type: array description: >- List of custom field values assigned to the item. Each entry represents a custom field with its corresponding value. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomFieldValue JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSuppliers: type: object description: 'Model Class: ItemSuppliers ' additionalProperties: false properties: defaultSupplier: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferantKey' description: Sets the default supplier for the item. defaultDropshippingSupplier: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferantKey' description: Sets the default supplier for dropshipping for the item. suppliers: type: array description: Assigned suppliers for the item items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSupplier JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemVariations: type: object description: 'Model Class: ItemVariations ' additionalProperties: false properties: variations: type: array description: Contains all Variations items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.Variation JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemFeatures: type: object description: >- 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. additionalProperties: false properties: features: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemFeature JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemAttributes: type: object description: 'Model Class: ItemAttributes ' additionalProperties: false properties: values: type: array description: Contains all attribute values assigned to the item items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.AttributeValues JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemUnitPricing: type: object description: >- 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. additionalProperties: false properties: salesUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EinheitKey' description: Id of the sales unit in which the item is sold (e.g. piece or box). packagingUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EinheitKey' description: Id of the packaging unit of the item. innerQuantity: type: number description: >- The amount of content for one piece of the sales unit, relative to the inner quantity unit. format: decimal innerQuantityUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.MassEinheitKey' description: The measurement unit for the inner quantity (e.g. kg or liter). isBasePriceDeclared: type: boolean description: >- Indicates whether the base price should be automatically calculated and displayed. basePriceReferenceUnitId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.MassEinheitKey' description: >- The measurement unit to which the base price refers (e.g. per liter or per 100 grams). basePriceReferenceAmount: type: number description: >- The reference amount used when calculating the base price (e.g. 1 for per liter, 100 for per 100 grams). format: decimal JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSpecialPrices: type: object description: >- 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. additionalProperties: false required: - IsActive - IsEndDateActive - IsStockRestrictionActive properties: isActive: type: boolean description: >- 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: type: string description: >- Date from which the special price becomes active. The special price will only be valid from this date onwards. format: date-time endDate: type: string description: >- Date until which the special price remains active. The special price will expire after this date. Only evaluated if IsEndDateActive is true. format: date-time isEndDateActive: type: boolean description: >- Indicates whether the end date should be considered. If false, the special price has no expiration date. minimumStockQuantity: type: integer description: >- Minimum stock quantity that must be available for the special price to remain active. Only evaluated if IsStockRestrictionActive is true. format: int32 isStockRestrictionActive: type: boolean description: >- 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: type: array description: >- List of sales channel-specific special prices - enables different promotional pricing for various sales channels or shops with customer group differentiation. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannelSpecialPrices JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemStorageConstraints: type: object description: >- 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. additionalProperties: false properties: allowNegativeStock: type: boolean description: >- 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: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.NegativeStockPlatform itemSalesChannelNegativeStocks: type: array description: >- 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. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.NegativeStockSalesChannel buffer: type: integer description: >- 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. format: int32 globalMinimumStockLevel: type: number description: >- 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. format: decimal hasBatch: type: boolean description: >- 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: type: boolean description: >- 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: type: boolean description: >- 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: type: boolean description: >- 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: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SerialNumberType description: >- Determines the type of serial number processing. Defines whether serial numbers are inactive, active, or tracked for this item. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannels: type: object description: >- Per-channel activation status of an item across the active sales channels in JTL-Wawi. additionalProperties: false required: - SalesChannels properties: salesChannels: type: array description: >- Active sales channels and whether the merchant has activated each of them for the item. Inactive shops and Business Intelligence channels are not listed. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannel JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCrosssellingGroups: type: object description: >- Manages cross-selling groups assigned to an item. Cross-selling groups define related products that should be promoted together. additionalProperties: false properties: groups: type: array description: Collection of cross-selling groups associated with the item. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCrosssellingGroup JTL.Data.Contracts.Keys.KategorieKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDescriptionData: type: object description: >- Defines the actual description data of an item. This structure contains all textual information of an item including SEO-relevant metadata for online shops. additionalProperties: false properties: itemName: type: string description: The name of the item as displayed in the user interface or shop. shortDescription: type: string description: >- Short description of the item for overview displays and search results. description: type: string description: >- Detailed description of the item with comprehensive product information and properties. metaDescription: type: string description: >- Meta description for search engine optimization (SEO) that is displayed in search results. metaKeywords: type: string description: >- Meta keywords for search engine optimization to improve discoverability of the item. titleTag: type: string description: >- HTML title tag for the item that is displayed in the browser tab and search results. urlPath: type: string description: URL path for the item to create SEO-friendly and speaking URLs. JTL.Wawi.Rest.Contracts.Models.SalesChannelId: type: string description: >- Represents a unique identifier for a sales channel, encapsulating various platform-specific keys such as shop, user, or channel identifiers. additionalProperties: false JTL.Data.Contracts.Keys.PlattformKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.ShopKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.KundeKey: type: string description: Represents a unique key for identifying a customer in the JTL system. format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemPrice: type: object description: >- Defines a single price with tiering options and discount possibilities. This structure forms the basis for complex price structures with volume discounts and percentage price reductions from the standard price. additionalProperties: false required: - FromQuantity properties: fromQuantity: type: integer description: >- Minimum quantity from which this price applies - enables tier prices based on order quantity (e.g., from 10 pieces). format: int32 netPrice: type: number description: >- Net price for this price tier without taxes - the actual selling price for the specified quantity tier. format: decimal reduceStandardPriceByPercent: type: number description: >- 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. format: decimal JTL.Data.Contracts.Keys.KundenGruppeKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.EbayUserKey: type: string description: |- Represents a unique key for identifying an eBay user within the system. format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.EigenesFeldKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSupplierPrice: type: object description: 'Model Class: UpdateSupplierPrice ' additionalProperties: false required: - FromQuantity - UsePercentageDiscount properties: fromQuantity: type: number description: >- Quantity from which the price applies. This value is not editable. To change it, a new scale must be created. format: decimal netPrice: type: number description: Net price for this scale. format: decimal usePercentageDiscount: type: boolean description: >- Indicates whether the scale uses a percentage discount of the NetPurchasePrice. percentageDiscount: type: number description: The percentage discount applied in this scale. format: decimal JTL.Data.Contracts.Keys.VariationKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDescription: type: object description: 'Model Class: UpdateDescription ' additionalProperties: false required: - LanguageIso - Name properties: languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). name: type: string description: Name of the Variation in the specific language JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateVariationValue: type: object description: 'Model Class: UpdateVariationValue ' additionalProperties: false required: - VariationValueId properties: variationValueId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VariationWertKey' description: Id of the VariationValue itemNumber: type: string description: Itemnumber for this variationvalue gTIN: type: string description: GTIN for this variationvalue weightOffset: type: number description: Offset for the weight of this variationvalue format: decimal descriptions: type: array description: Descriptions of this VariationValue in multiple Languages items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateDescription surcharges: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateVariationValueSurcharges description: Surcharges of this VariationValue position: type: integer description: Position of this VariationValue in the List format: int32 image: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.BildKey' description: >- Image for this variation value. This image will be used as the main image for the variation combination if this variation value is part of it and the variation combination doesn't have its own image. example: b45f6432-2462-4c6f-b00f-1d9d01000000 JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationType: type: integer description: >- 0 = Unknown, 1 = Selectbox, 2 = Radiobutton, 3 = Swatches, 4 = Textbox, 5 = FreeText, 6 = MandatoryFreeText format: int32 x-enumNames: - Unknown - Selectbox - Radiobutton - Swatches - Textbox - FreeText - MandatoryFreeText enum: - 0 - 1 - 2 - 3 - 4 - 5 - 6 JTL.Data.Contracts.Keys.MerkmalWertKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.AttributKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateAttributeValue: type: object description: 'Model Class: UpdateAttributeValue ' additionalProperties: false required: - LanguageIso - Value properties: languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). value: type: string description: >- Value of this attribute as string. Please consider the Attribute Type for correct formatting. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateAttributeSalesChannelValues: type: object description: 'Model Class: UpdateAttributeSalesChannelValues ' additionalProperties: false required: - SalesChannelId properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: Identifies the saleschannel for this attributevalue values: type: array description: Contains the values for a saleschannel items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateAttributeValue JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateItemCustomerGroupSpecialPrice: type: object description: >- Defines a customer group-specific special price for an item. This structure represents a single promotional price for a specific customer group in a sales channel. additionalProperties: false required: - CustomerGroupId properties: customerGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundenGruppeKey' description: >- Key of the customer group that identifies the specific customer group (e.g., end customers, resellers, wholesalers) for which this special price applies. netPrice: type: number description: >- Net special price for this customer group without taxes. Setting this to null will deactivate the special price for this customer group. format: decimal isActive: type: boolean description: >- Indicates whether this special price is active for this customer group. Automatically set to false when NetPrice is set to null. JTL.Data.Contracts.Keys.Artikel.CrossSellingGruppeKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateCrossSellItem: type: object description: Represents a single cross-selling item. additionalProperties: false required: - Id properties: id: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ArtikelKey' description: Id of the item sku: type: string description: Sku of the item JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCategory: type: object description: >- Defines a single category assignment for an item. This structure represents the link between an item and a specific category in the hierarchical category system of the ERP system. additionalProperties: false required: - CategoryId properties: categoryId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KategorieKey' description: >- Unique key of the category that identifies the specific category to which the item should be assigned. This key establishes the connection to the category data. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.DefaultDescription: type: object description: >- Defines a default description of an item in a specific language. This description is used as a fallback when no more specific platform or sales channel descriptions are available. additionalProperties: false required: - LanguageIso - DescriptionData properties: languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). descriptionData: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.DescriptionData description: >- Contains the actual description data such as name, short and long description as well as SEO-relevant information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SalesChannelDescription: type: object description: >- Defines a sales channel-specific description of an item. This enables individual customization of item descriptions for specific sales channels or shops. additionalProperties: false required: - SalesChannelId - LanguageIso - DescriptionData properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: >- Unique key of the sales channel or shop for which this description is intended. languageIso: type: string description: >- ISO2 language code that determines the language for this sales channel-specific description. descriptionData: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.DescriptionData description: >- Contains the sales channel-specific description data with all relevant texts and SEO information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.PlatformDescription: type: object description: >- Defines a platform-specific description of an item. This enables different descriptions for various output platforms like print or other non-sales platforms. additionalProperties: false required: - PlatformId - LanguageIso - DescriptionData properties: platformId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.PlattformKey' description: >- Unique key of the platform for which this description is intended (e.g., print, labels). languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). descriptionData: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.DescriptionData description: >- Contains the platform-specific description data with all relevant texts and SEO information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSaleschannelPrices: type: object description: >- Defines sales channel-specific prices for an item. This structure enables different pricing for various sales channels or shops with customer group-related price structures. additionalProperties: false required: - SaleschannelId - CustomerGroupPrices - IsActive properties: saleschannelId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ShopKey' description: >- Key of the sales channel that identifies the specific sales channel or shop for which this price structure applies. customerGroupPrices: type: array description: >- List of prices for different customer groups within this sales channel - enables differentiated pricing by customer groups. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomerGroupPrices isActive: type: boolean description: >- Indicates whether this sales channel is active for the item - determines whether the item can be sold in this sales channel. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomerPrices: type: object description: >- Defines customer-specific prices for an item. This structure enables individual price agreements for specific customers that can deviate from standard or customer group prices. additionalProperties: false required: - CustomerId - Prices properties: customerId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundeKey' description: >- Key of the customer that identifies the specific customer for whom these individual prices apply. prices: type: array description: >- List of individual prices for this customer - can contain different tier prices or special conditions. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomerGroupPrices: type: object description: >- Defines customer group-specific prices for an item. This structure enables differentiated pricing by customer groups, allowing different price levels for different customer segments. additionalProperties: false required: - CustomerGroupId - Prices properties: customerGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundenGruppeKey' description: >- Key of the customer group that identifies the specific customer group (e.g., end customers, resellers, wholesalers). prices: type: array description: >- List of prices for this customer group - can contain different tier prices or volume discounts. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemImage: type: object description: 'Model Class: ItemImage ' additionalProperties: false required: - SortNumber - IsMainImage properties: blobIdentifier: type: string description: Unique ID to identify an image. format: uuid url: type: string description: Download Url for the image. previewUrl: type: string description: Download URL for the preview-sized image. sortNumber: type: integer description: Sort order of the image. format: int32 isMainImage: type: boolean description: >- Declares the main image of the item. Typically the image with sort order 1. filename: type: string description: Original source filename of the image including its extension. platformId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.PlattformKey' description: >- Id of the platform the image is assigned to. For default images this is the JTL-Wawi platform. Use QueryPlatforms to resolve it to a name. modificationDate: type: string description: Last modification timestamp of the image. format: date-time width: type: integer description: Width of the image in pixels. format: int32 height: type: integer description: Height of the image in pixels. format: int32 fileSizeKilobytes: type: integer description: >- File size of the image in kilobytes (bytes divided by 1024, truncated to integer). format: int32 JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.PlatformImages: type: object description: 'Model Class: PlatformImages ' additionalProperties: false required: - PlatformId properties: platformId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.PlattformKey' description: Unique ID to identify a platform. images: type: array description: List of images assigned to the platform. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SaleschannelImages: type: object description: 'Model Class: SaleschannelImages ' additionalProperties: false required: - SaleschannelId properties: saleschannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: Unique ID to identify a saleschannel. images: type: array description: List of images assigned to the saleschannel. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.EbayImages: type: object description: 'Model Class: EbayImages ' additionalProperties: false required: - EbayAccountId properties: ebayAccountId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EbayUserKey' description: Unique ID to identify an ebay account. images: type: array description: List of images assigned to the eBay account. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomFieldValue: type: object description: >- Defines a single custom field value for an item. This structure connects a custom field definition with its actual value for a specific item. additionalProperties: false required: - FieldId - Value - ValueCultureName properties: fieldId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.EigenesFeldKey' description: >- Unique identifier of the custom field definition. References the custom field that was previously created in the system. value: type: string description: >- The actual value stored in this custom field. The format and content depend on the custom field type definition (text, number, date, etc.). valueCultureName: type: string description: >- 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. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSupplier: type: object description: 'Model Class: ItemSupplier ' additionalProperties: false required: - SupplierId properties: supplierId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferantKey' description: Id of the supplier supplierItemName: type: string description: Name of the item at the supplier (max 255 characters). supplierItemNumber: type: string description: Item number at the supplier (max 255 characters). stockLevel: type: number description: Stock level of the item at the supplier. format: decimal netPurchasePrice: type: number description: Net purchase price of the item at the supplier. format: decimal minimumPurchaseQuantity: type: integer description: Minimum purchase quantity of the item at the supplier. format: int32 deliveryTimeInDays: type: integer description: Delivery time for this item at the supplier (in days). format: int32 isDropshippingActive: type: boolean description: Indicates if this item uses dropshipping from the supplier. packageUnitDescription: type: string description: Description of the packaging unit. packageUnitQuantity: type: number description: Quantity per packaging unit. format: decimal notes: type: string description: Additional notes (max 512 characters). vatRate: type: number description: VAT rate of the item at the supplier. format: decimal useSupplierDeliveryTime: type: boolean description: Whether to use the supplier's delivery time directly. includeSupplierStock: type: boolean description: Whether to include the supplier's stock in own inventory. purchaseInterval: type: number description: Purchase interval for this item at the supplier. format: decimal scalePrices: type: array description: Scale prices defined by the supplier for this item. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SupplierPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.Variation: type: object description: 'Model Class: Variation ' additionalProperties: false required: - VariationId - VariationType properties: variationId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VariationKey' description: Id of the Variation position: type: integer description: Position of this Variation in the List format: int32 descriptions: type: array description: Descriptions of this Variation in multiple Languages items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.Description values: type: array description: Values for this Variation items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationValue variationType: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationType description: Type of the Variation JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemFeature: type: object description: >- Defines a single feature assignment for an item. This structure represents the link between an item and a specific feature value from the feature system, allowing detailed product characterization. additionalProperties: false required: - FeatureId properties: featureId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.MerkmalWertKey' description: >- Unique key of the feature value that identifies the specific feature characteristic to be assigned to the item. This key establishes the connection to a predefined feature value in the feature system. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.AttributeValues: type: object description: 'Model Class: AttributeValues ' additionalProperties: false required: - AttributeId properties: attributeId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.AttributKey' description: Identifies the attribute defaultValues: type: array description: >- Defines the default values for the attribute and item in different languages. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.AttributeValue salesChannelValues: type: array description: Contains all values for saleschannels for this attribute and item items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.AttributeSalesChannelValues JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannelSpecialPrices: type: object description: >- Defines sales channel-specific special prices for an item. This structure enables different promotional pricing for a specific sales channel or shop with customer group-related special price structures. additionalProperties: false required: - SalesChannelId - SpecialPrices properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: >- Key of the sales channel that identifies the specific sales channel or shop for which this special price structure applies. specialPrices: type: array description: >- List of special prices for different customer groups within this sales channel - enables differentiated promotional pricing by customer groups. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomerGroupSpecialPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.NegativeStockPlatform: type: object description: >- Defines negative stock settings for a specific platform. This structure enables individual configuration of negative stock handling per platform (e.g., eBay, Amazon), allowing overselling for specific marketplaces when the global AllowNegativeStock is enabled. additionalProperties: false required: - PlatformId - IsNegativeStockAllowed properties: platformId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.PlattformKey' description: >- Key of the platform that identifies the specific marketplace or platform (e.g., eBay, Amazon) for which this negative stock setting applies. isNegativeStockAllowed: type: boolean description: >- 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. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.NegativeStockSalesChannel: type: object description: >- Defines negative stock settings for a specific sales channel. This structure enables individual configuration of negative stock handling per sales channel, allowing overselling for specific online shops when the global AllowNegativeStock is enabled. additionalProperties: false required: - SalesChannelId - IsNegativeStockAllowed properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: >- Key of the sales channel that identifies the specific shop or sales channel for which this negative stock setting applies. isNegativeStockAllowed: type: boolean description: >- 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. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannel: type: object description: Activation status of a single sales channel for an item. additionalProperties: false required: - SalesChannelId - SalesChannelType - IsActive properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: Unique ID to identify the sales channel. salesChannelType: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannelType description: >- Type of the sales channel (for example Wawi, Connector, JtlPos, Scx). name: type: string description: Display name of the sales channel. isActive: type: boolean description: >- True if the merchant has activated this sales channel for the item in JTL-Wawi; false otherwise. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCrosssellingGroup: type: object description: Represents a single cross-selling group with its assigned items. additionalProperties: false required: - CrosssellingGroupId properties: crosssellingGroupId: $ref: >- #/components/schemas/JTL.Data.Contracts.Keys.Artikel.CrossSellingGruppeKey description: Unique identifier of the cross-selling group. items: type: array description: List of item keys that belong to this cross-selling group. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CrossSellItem JTL.Data.Contracts.Keys.VariationWertKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateVariationValueSurcharges: type: object description: 'Model Class: UpdateVariationValueSurcharges ' additionalProperties: false properties: defaultSurchargeNet: type: number description: >- Default Surcharge if there is none specified for a specific saleschannel + customergroup format: decimal customerGroupSurcharges: type: array description: >- Default Surcharges for specific customergroups in general, independent of saleschannel items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateCustomerGroupSurcharge salesChannelSurcharges: type: array description: Surcharge for specific saleschannels + customergroups items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSalesChannelSurcharge JTL.Data.Contracts.Keys.BildKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.DescriptionData: type: object description: >- Defines the actual description data of an item. This structure contains all textual information of an item including SEO-relevant metadata for online shops. additionalProperties: false properties: itemName: type: string description: The name of the item as displayed in the user interface or shop. shortDescription: type: string description: >- Short description of the item for overview displays and search results. description: type: string description: >- Detailed description of the item with comprehensive product information and properties. metaDescription: type: string description: >- Meta description for search engine optimization (SEO) that is displayed in search results. metaKeywords: type: string description: >- Meta keywords for search engine optimization to improve discoverability of the item. titleTag: type: string description: >- HTML title tag for the item that is displayed in the browser tab and search results. urlPath: type: string description: URL path for the item to create SEO-friendly and speaking URLs. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemPrice: type: object description: >- Defines a single price with tiering options and discount possibilities. This structure forms the basis for complex price structures with volume discounts and percentage price reductions from the standard price. additionalProperties: false required: - FromQuantity properties: fromQuantity: type: integer description: >- Minimum quantity from which this price applies - enables tier prices based on order quantity (e.g., from 10 pieces). format: int32 netPrice: type: number description: >- Net price for this price tier without taxes - the actual selling price for the specified quantity tier. format: decimal reduceStandardPriceByPercent: type: number description: >- 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. format: decimal JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SupplierPrice: type: object description: 'Model Class: SupplierPrice ' additionalProperties: false required: - FromQuantity - UsePercentageDiscount properties: fromQuantity: type: number description: >- Quantity from which the price applies. This value is not editable. To change it, a new scale must be created. format: decimal netPrice: type: number description: Net price for this scale. format: decimal usePercentageDiscount: type: boolean description: >- Indicates whether the scale uses a percentage discount of the NetPurchasePrice. percentageDiscount: type: number description: The percentage discount applied in this scale. format: decimal JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.Description: type: object description: 'Model Class: Description ' additionalProperties: false required: - LanguageIso - Name properties: languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). name: type: string description: Name of the Variation in the specific language JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationValue: type: object description: 'Model Class: VariationValue ' additionalProperties: false required: - VariationValueId properties: variationValueId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VariationWertKey' description: Id of the VariationValue itemNumber: type: string description: Itemnumber for this variationvalue gTIN: type: string description: GTIN for this variationvalue weightOffset: type: number description: Offset for the weight of this variationvalue format: decimal descriptions: type: array description: Descriptions of this VariationValue in multiple Languages items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.Description surcharges: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationValueSurcharges description: Surcharges of this VariationValue position: type: integer description: Position of this VariationValue in the List format: int32 image: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.BildKey' description: >- Image for this variation value. This image will be used as the main image for the variation combination if this variation value is part of it and the variation combination doesn't have its own image. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.AttributeValue: type: object description: 'Model Class: AttributeValue ' additionalProperties: false required: - LanguageIso - Value properties: languageIso: type: string description: >- ISO2 language code that determines the language for this item description (e.g., "DE" for German, "EN" for English). value: type: string description: >- Value of this attribute as string. Please consider the Attribute Type for correct formatting. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.AttributeSalesChannelValues: type: object description: 'Model Class: AttributeSalesChannelValues ' additionalProperties: false required: - SalesChannelId properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: Identifies the saleschannel for this attributevalue values: type: array description: Contains the values for a saleschannel items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.AttributeValue JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemCustomerGroupSpecialPrice: type: object description: >- Defines a customer group-specific special price for an item. This structure represents a single promotional price for a specific customer group in a sales channel. additionalProperties: false required: - CustomerGroupId - IsActive properties: customerGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundenGruppeKey' description: >- Key of the customer group that identifies the specific customer group (e.g., end customers, resellers, wholesalers) for which this special price applies. netPrice: type: number description: >- Net special price for this customer group without taxes. Setting this to null will deactivate the special price for this customer group. format: decimal isActive: type: boolean description: >- Indicates whether this special price is active for this customer group. Automatically set to false when NetPrice is set to null. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.ItemSalesChannelType: type: integer description: >- 0 = Wawi, 1 = Connector, 2 = B2BNetwork, 3 = Unicorn, 4 = JtlPos, 5 = BusinessIntelligence, 6 = Scx, 7 = VoucherCloud, 255 = Unknown format: int32 x-enumNames: - Wawi - Connector - B2BNetwork - Unicorn - JtlPos - BusinessIntelligence - Scx - VoucherCloud - Unknown enum: - 0 - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 255 JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CrossSellItem: type: object description: Represents a single cross-selling item. additionalProperties: false required: - Id properties: id: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ArtikelKey' description: Id of the item sku: type: string description: Sku of the item JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateCustomerGroupSurcharge: type: object description: 'Model Class: UpdateCustomerGroupSurcharge ' additionalProperties: false required: - CustomerGroupId properties: customerGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundenGruppeKey' description: Id of the customergroup surcharge: type: number description: Surcharge for that customergroup format: decimal isActive: type: boolean description: >- 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. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateSalesChannelSurcharge: type: object description: 'Model Class: UpdateSalesChannelSurcharge ' additionalProperties: false required: - SalesChannelId - Surcharges properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: Id of the saleschannel surcharges: type: array description: Contains the surcharges for that saleschannel and customergroup items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.UpdateCustomerGroupSurcharge JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationValueSurcharges: type: object description: 'Model Class: VariationValueSurcharges ' additionalProperties: false properties: defaultSurchargeNet: type: number description: >- Default Surcharge if there is none specified for a specific saleschannel + customergroup format: decimal customerGroupSurcharges: type: array description: >- Default Surcharges for specific customergroups in general, independent of saleschannel items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CustomerGroupSurcharge salesChannelSurcharges: type: array description: Surcharge for specific saleschannels + customergroups items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SalesChannelSurcharge JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CustomerGroupSurcharge: type: object description: 'Model Class: CustomerGroupSurcharge ' additionalProperties: false required: - CustomerGroupId properties: customerGroupId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundenGruppeKey' description: Id of the customergroup surcharge: type: number description: Surcharge for that customergroup format: decimal isActive: type: boolean description: >- 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. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.SalesChannelSurcharge: type: object description: 'Model Class: SalesChannelSurcharge ' additionalProperties: false required: - SalesChannelId - Surcharges properties: salesChannelId: $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId' description: Id of the saleschannel surcharges: type: array description: Contains the surcharges for that saleschannel and customergroup items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CustomerGroupSurcharge securitySchemes: oauth2-authorization-code: type: oauth2 flows: authorizationCode: authorizationUrl: https://auth.jtl-cloud.com/oauth2/auth tokenUrl: https://auth.jtl-cloud.com/oauth2/token scopes: items.read: Grants permission to read item data. items.write: Grants permission to create and modify item data. saleschannels.read: Verkaufskanäle lesen all.read: Allows the application to read all data. customers.read: Grants permission to read customer data. customers.write: Grants permission to create and modify customer data. customfields.read: Grants permission to read custom fields. customfields.write: Grants permission to create and modify custom fields. deliveries.read: Grants permission to read deliveries. deliveries.write: Grants permission to create and modify deliveries. deliverynotes.print: Grants permission to print and output delivery notes. deliverynotes.read: Grants permission to read delivery notes. deliverynotes.write: Grants permission to create and modify delivery notes. extensibility.integration: >- Grants permission to manage extensions and integrations of the JTL-Wawi. inventories.read: Grants permission to read stock levels. inventories.write: Grants permission to modify stock levels. invoices.read: Grants permission to read invoices. invoices.write: Grants permission to create and modify invoices. labels.read: Grants permission to read labels. labels.write: Grants permission to create and modify labels. masterdata.read: >- Read master data such as shipping methods, payment methods, color codes and tax classes. orders.read: Grants permission to read orders. picklists.read: Grants permission to read pick lists. picklists.write: Grants permission to create and modify pick lists. returns.read: Grants permission to read returns. returns.write: Grants permission to create and modify returns. salesinvoicecorrections.read: Grants permission to read invoice corrections. salesinvoicecorrections.write: Grants permission to create and modify invoice corrections. salesorders.print: Grants permission to print and output sales orders. salesorders.read: Grants permission to read sales orders. salesorders.write: Grants permission to create and modify sales orders. system.config.read: Grants permission to read the system configuration. system.config.write: Grants permission to modify the system configuration. taxes.read: Grants permission to read tax data. warehouse.read: Grants permission to read warehouse data. wawiapp.all: Grants access to Wawi app related operations. currencies.read: Grants read access to currencies. jera.read: Grants read access to JERA internal endpoints. paymentmethods.read: Grants read access to payment methods. payments.read: Ermöglicht den Lesezugriff auf Zahlungen. payments.write: Ermöglicht den Schreibzugriff auf Zahlungen. salesinvoicecorrections.print: Grants permission to print and output invoice corrections. salesinvoices.print: Grants permission to print and output sales invoices. salesinvoices.read: Grants read access to sales invoices. salesinvoices.write: Grants write access to sales invoices. salesquotations.print: Grants permission to print and output sales quotations. salesquotations.read: Grants read access to sales quotations. salesquotations.write: Grants write access to sales quotations. suppliers.read: Grants permission to read suppliers. system.worker.read: Worker-Synchronisationen lesen system.worker.write: Worker-Synchronisationen schreiben resources.read: Grants permission to read resource management data. resources.write: Grants permission to create and modify resource management data. pps.read: Grants permission to read production data. pps.write: Grants permission to create and modify production data. inventory.write: Bestand schreiben masterdata.write: Write master data inventory.read: Grants permission to read stock levels. taxes.write: Grants permission to create and modify tax data. application.runas: >- Allows the application to execute requests on behalf of another user. oauth2-client-credentials: type: oauth2 flows: clientCredentials: tokenUrl: https://auth.jtl-cloud.com/oauth2/token scopes: items.read: Grants permission to read item data. items.write: Grants permission to create and modify item data. saleschannels.read: Verkaufskanäle lesen all.read: Allows the application to read all data. customers.read: Grants permission to read customer data. customers.write: Grants permission to create and modify customer data. customfields.read: Grants permission to read custom fields. customfields.write: Grants permission to create and modify custom fields. deliveries.read: Grants permission to read deliveries. deliveries.write: Grants permission to create and modify deliveries. deliverynotes.print: Grants permission to print and output delivery notes. deliverynotes.read: Grants permission to read delivery notes. deliverynotes.write: Grants permission to create and modify delivery notes. extensibility.integration: >- Grants permission to manage extensions and integrations of the JTL-Wawi. inventories.read: Grants permission to read stock levels. inventories.write: Grants permission to modify stock levels. invoices.read: Grants permission to read invoices. invoices.write: Grants permission to create and modify invoices. labels.read: Grants permission to read labels. labels.write: Grants permission to create and modify labels. masterdata.read: >- Read master data such as shipping methods, payment methods, color codes and tax classes. orders.read: Grants permission to read orders. picklists.read: Grants permission to read pick lists. picklists.write: Grants permission to create and modify pick lists. returns.read: Grants permission to read returns. returns.write: Grants permission to create and modify returns. salesinvoicecorrections.read: Grants permission to read invoice corrections. salesinvoicecorrections.write: Grants permission to create and modify invoice corrections. salesorders.print: Grants permission to print and output sales orders. salesorders.read: Grants permission to read sales orders. salesorders.write: Grants permission to create and modify sales orders. system.config.read: Grants permission to read the system configuration. system.config.write: Grants permission to modify the system configuration. taxes.read: Grants permission to read tax data. warehouse.read: Grants permission to read warehouse data. wawiapp.all: Grants access to Wawi app related operations. currencies.read: Grants read access to currencies. jera.read: Grants read access to JERA internal endpoints. paymentmethods.read: Grants read access to payment methods. payments.read: Ermöglicht den Lesezugriff auf Zahlungen. payments.write: Ermöglicht den Schreibzugriff auf Zahlungen. salesinvoicecorrections.print: Grants permission to print and output invoice corrections. salesinvoices.print: Grants permission to print and output sales invoices. salesinvoices.read: Grants read access to sales invoices. salesinvoices.write: Grants write access to sales invoices. salesquotations.print: Grants permission to print and output sales quotations. salesquotations.read: Grants read access to sales quotations. salesquotations.write: Grants write access to sales quotations. suppliers.read: Grants permission to read suppliers. system.worker.read: Worker-Synchronisationen lesen system.worker.write: Worker-Synchronisationen schreiben resources.read: Grants permission to read resource management data. resources.write: Grants permission to create and modify resource management data. pps.read: Grants permission to read production data. pps.write: Grants permission to create and modify production data. inventory.write: Bestand schreiben masterdata.write: Write master data inventory.read: Grants permission to read stock levels. taxes.write: Grants permission to create and modify tax data. application.runas: >- Allows the application to execute requests on behalf of another user. ````