> ## 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. # Creates a new regular item with all specified properties. This command enables complete configuration of an item including identifiers, descriptions, prices, and measurements. ## OpenAPI ````yaml /openapi/2.1.json post /v2/itemdetails/create openapi: 3.0.0 info: title: JTL-WAWI API (Cloud) description: "JTL-Wawi-Version: 2.2.0-alpha.7351+Sha.7529201\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: WawiApp description: Development - name: warehouse description: >-

Query all warehouses - name: transactionStatus description: >-

Query all transaction status for sales order - name: tax description: >-

Returns the Taxrate for the given Item - name: item description: >-

Query all tax classes - name: supplier description: >-

Query all suppliers - name: stock description: >-

Query stocks for a specific item, warehouse or storage location - name: shippingmethod description: >-

Query all shipping methods - name: shipment description: >-

Download a PDF Shipping Label from database by ID - name: salesorder description: >-

Query all sales orders - name: cancellationreason description: Planned - name: salesinvoicecorrection description: Development - name: return description: >-

Create a new return with associated items and packages. - name: returnstate description: Planned - name: returnreason description: Planned - name: property description: >-

Query all properties for items - name: printer description: >-

Returns all Installed Printers - name: paymentmethod description: >-

Query all payment methods - name: onholdreason description: >-

Query all on hold reasons for sales orders - name: offer description: >-

Execute the printing of a Offer - name: Configuration description: Planned - name: manufacturer description: Development - name: label description: Development - name: 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: shipping description: Development - name: deliverynote description: Planned - name: customfields description: Development - name: customfield description: Development - name: customer description: >-

Query all customers - name: customerGroup description: >-

Query all customer groups - name: customerCategory description: >-

Query all customer categories - name: creditnote description: >-

Execute the printing of a CreditNote - name: company description: >-

Query all companies - name: colorcodes description: >-

Query all color codes for sales orders - name: category description: Development - name: appRegistration description: >-

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

Sends a request to log in the user / dynamically assign the WAWI user. Only use this request if your API uses SSL. - name: logout description: >-

Sends a request to log out the user - name: attribute description: Development - name: accountingData description: Planned paths: /v2/itemdetails/create: post: tags: - ItemdetailsCommand summary: >- Creates a new regular item with all specified properties. This command enables complete configuration of an item including identifiers, descriptions, prices, and measurements. operationId: Itemdetails_CreateItem parameters: - name: x-tenant-id in: header required: true schema: type: string format: uuid description: The tenant ID for the target ERP instance. - name: x-runas in: header description: >- The User-Id (int or uuid) on whose behalf the request is executed. Requires scope 'Application.RunAs'. schema: type: string - 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 requestBody: x-name: request description: Request parameters content: application/json: schema: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCommandRequest required: true x-position: 1 responses: '200': description: Item was successfully created content: application/json: {} security: - oauth2-authorization-code: - items.write - oauth2-client-credentials: - items.write components: schemas: JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCommandRequest: type: object description: >- Creates a new regular item with all specified properties. This command enables complete configuration of an item including identifiers, descriptions, prices, and measurements. - Request additionalProperties: false required: - Categories - Identifiers - Descriptions 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.CreateItemCategories 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.CreateItemIdentifiers 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.CreateItemDescriptions 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.CreateItemPrices description: >- Price structures of the item for different sales channels, customer groups and individual customers. Includes sales prices, purchase prices and tier prices. suppliers: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemSuppliers description: >- Suppliers associated with the item including supplier-specific information such as purchase prices, delivery times and order intervals. measurements: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemMeasurements 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.CreateItemImages description: tbd customFields: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCustomFields description: >- Custom fields defined for the item to store additional information. Useful for special requirements or integrations. variations: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemVariations description: Variations of an item features: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemFeatures description: Features of an item attributes: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemAttributes description: Attributes of an item unitPricing: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemUnitPricing description: UnitPricing information of an item specialPrices: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemSpecialPrices description: SpecialPrices information of an item storageConstraints: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemStorageConstraints description: ItemStorageConstraints information of an item crosssellingGroups: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCrosssellingGroups description: CrosssellingGroups of an 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.CreateItemCategories: 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.CreateItemCategory JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemIdentifiers: 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.CreateItemDescriptions: 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.CreateDefaultDescription 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.CreateSalesChannelDescription 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.CreatePlatformDescription JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemPrices: 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.CreateItemSaleschannelPrices 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.CreateItemCustomerPrices 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.CreateItemCustomerGroupPrices JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemSuppliers: type: object description: 'Model Class: CreateItemSuppliers ' 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.CreateItemSupplier JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemMeasurements: 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.CreateItemImages: type: object description: 'Model Class: CreateItemImages ' 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.CreateItemImage platformImages: type: array description: List of images assigned to different platforms. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreatePlatformImages saleschannelImages: type: array description: List of images assigned to different saleschannels. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateSaleschannelImages ebayImages: type: array description: List of images assigned to different eBay accounts. items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateEbayImages JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCustomFields: 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.CreateItemCustomFieldValue JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemVariations: type: object description: 'Model Class: CreateItemVariations ' additionalProperties: false properties: variations: type: array description: Contains all Variations items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateVariation JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemFeatures: 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.CreateItemFeature JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemAttributes: type: object description: 'Model Class: CreateItemAttributes ' 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.CreateAttributeValues JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemUnitPricing: 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.CreateItemSpecialPrices: 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.CreateItemSalesChannelSpecialPrices JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemStorageConstraints: 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.CreateNegativeStockPlatform 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.CreateNegativeStockSalesChannel 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.CreateItemCrosssellingGroups: 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.CreateItemCrosssellingGroup JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCategory: 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.CreateDefaultDescription: 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.CreateDescriptionData 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.CreateSalesChannelDescription: 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.CreateDescriptionData description: >- Contains the sales channel-specific description data with all relevant texts and SEO information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreatePlatformDescription: 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.CreateDescriptionData description: >- Contains the platform-specific description data with all relevant texts and SEO information. JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemSaleschannelPrices: 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.CreateItemCustomerGroupPrices 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.CreateItemCustomerPrices: 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.CreateItemPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCustomerGroupPrices: 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.CreateItemPrice JTL.Data.Contracts.Keys.LieferantKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemSupplier: type: object description: 'Model Class: CreateItemSupplier ' 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.CreateSupplierPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemImage: type: object description: 'Model Class: CreateItemImage ' 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.CreatePlatformImages: type: object description: 'Model Class: CreatePlatformImages ' 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.CreateItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateSaleschannelImages: type: object description: 'Model Class: CreateSaleschannelImages ' 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.CreateItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateEbayImages: type: object description: 'Model Class: CreateEbayImages ' 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.CreateItemImage JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCustomFieldValue: 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.CreateVariation: type: object description: 'Model Class: CreateVariation ' additionalProperties: false required: - Descriptions - VariationType properties: variationId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VariationKey' description: Id of the Variation example: b45f6432-2462-4c6f-b00f-1d9d01000000 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.CreateDescription values: type: array description: Values for this Variation items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateVariationValue variationType: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.VariationType description: Type of the Variation JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemFeature: 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.CreateAttributeValues: type: object description: 'Model Class: CreateAttributeValues ' 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.CreateAttributeValue 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.CreateAttributeSalesChannelValues 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.CreateItemSalesChannelSpecialPrices: 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.CreateItemCustomerGroupSpecialPrice JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateNegativeStockPlatform: 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.CreateNegativeStockSalesChannel: 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.CreateItemCrosssellingGroup: 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.CreateCrossSellItem JTL.Data.Contracts.Keys.KategorieKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateDescriptionData: 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.CreateItemPrice: 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.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateSupplierPrice: type: object description: 'Model Class: CreateSupplierPrice ' 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.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.Data.Contracts.Keys.VariationKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateDescription: type: object description: 'Model Class: CreateDescription ' 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.CreateVariationValue: type: object description: 'Model Class: CreateVariationValue ' additionalProperties: false required: - Descriptions properties: variationValueId: $ref: '#/components/schemas/JTL.Data.Contracts.Keys.VariationWertKey' description: Id of the VariationValue example: b45f6432-2462-4c6f-b00f-1d9d01000000 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.CreateDescription surcharges: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateVariationValueSurcharges 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.CreateAttributeValue: type: object description: 'Model Class: CreateAttributeValue ' 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.CreateAttributeSalesChannelValues: type: object description: 'Model Class: CreateAttributeSalesChannelValues ' 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.CreateAttributeValue JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateItemCustomerGroupSpecialPrice: 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.CreateCrossSellItem: 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.Data.Contracts.Keys.VariationWertKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateVariationValueSurcharges: type: object description: 'Model Class: CreateVariationValueSurcharges ' 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.CreateCustomerGroupSurcharge salesChannelSurcharges: type: array description: Surcharge for specific saleschannels + customergroups items: $ref: >- #/components/schemas/JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateSalesChannelSurcharge JTL.Data.Contracts.Keys.BildKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Data.Contracts.Keys.ArtikelKey: type: string format: uuid example: b45f6432-2462-4c6f-b00f-1d9d01000000 additionalProperties: false JTL.Wawi.Item.PublicApi.DataTransferObjects.V2.Itemdetails.CreateCustomerGroupSurcharge: type: object description: 'Model Class: CreateCustomerGroupSurcharge ' 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.CreateSalesChannelSurcharge: type: object description: 'Model Class: CreateSalesChannelSurcharge ' 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.CreateCustomerGroupSurcharge 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: Artikel lesen items.write: Artikel schreiben saleschannels.read: Verkaufskanäle lesen accountings.read: TbD all.read: Erlaubt der Anwendung, alle Daten zu lesen. cusomters.read: TbD customers.read: TbD customers.write: TbD customfields.read: TbD customfields.write: TbD deliveries.read: TbD deliveries.write: TbD deliverynotes.print: TbD deliverynotes.read: TbD deliverynotes.write: TbD extensibility.integration: TbD inventories.read: TbD inventories.write: TbD invoices.print: TbD invoices.read: TbD invoices.write: TbD labels.read: TbD labels.write: TbD offers.print: TbD offers.read: TbD orders.read: TbD picklists.read: TbD picklists.write: TbD returns.read: TbD returns.write: TbD salesinvoicecorrections.print: TbD salesinvoicecorrections.read: TbD salesinvoicecorrections.write: TbD salesorders.print: TbD salesorders.read: TbD salesorders.write: TbD suppliers.read: TbD system.config.read: TbD system.config.write: TbD system.read: TbD taxes.read: TbD warehouse.read: TbD wawiapp.all: Ermöglicht den Zugriff auf Wawi-App bezogene Opperationen. currencies.read: Ermöglicht den Lesezugriff auf Währungen. jera.read: Ermöglicht den Lesezugriff auf JERA-interne Endpunkte. paymentmethods.read: Ermöglicht den Lesezugriff auf Zahlungsarten. payments.write: Ermöglicht den Schreibzugriff auf Zahlungen. salesinvoices.read: Ermöglicht den Lesezugriff auf Verkaufsrechnungen. salesinvoices.write: Ermöglicht den Schreibzugriff auf Verkaufsrechnungen. salesquotations.read: Ermöglicht den Lesezugriff auf Verkaufsangebote. salesquotations.write: Ermöglicht den Schreibzugriff auf Verkaufsangebote. system.worker.read: Worker-Synchronisationen lesen system.worker.write: Worker-Synchronisationen schreiben resources.read: Ressourcen lesen resources.write: Ressourcen schreiben pps.read: Produktionsdaten lesen pps.write: Produktionsdaten schreiben inventory.read: Lagerbestand lesen inventory.write: Lagerbestand schreiben taxes.write: Steuern schreiben application.runas: >- Ermöglicht der Anwendung, Anfragen im Namen eines anderen Benutzers auszuführen. oauth2-client-credentials: type: oauth2 flows: clientCredentials: tokenUrl: https://auth.jtl-cloud.com/oauth2/token scopes: items.read: Artikel lesen items.write: Artikel schreiben saleschannels.read: Verkaufskanäle lesen accountings.read: TbD all.read: Erlaubt der Anwendung, alle Daten zu lesen. cusomters.read: TbD customers.read: TbD customers.write: TbD customfields.read: TbD customfields.write: TbD deliveries.read: TbD deliveries.write: TbD deliverynotes.print: TbD deliverynotes.read: TbD deliverynotes.write: TbD extensibility.integration: TbD inventories.read: TbD inventories.write: TbD invoices.print: TbD invoices.read: TbD invoices.write: TbD labels.read: TbD labels.write: TbD offers.print: TbD offers.read: TbD orders.read: TbD picklists.read: TbD picklists.write: TbD returns.read: TbD returns.write: TbD salesinvoicecorrections.print: TbD salesinvoicecorrections.read: TbD salesinvoicecorrections.write: TbD salesorders.print: TbD salesorders.read: TbD salesorders.write: TbD suppliers.read: TbD system.config.read: TbD system.config.write: TbD system.read: TbD taxes.read: TbD warehouse.read: TbD wawiapp.all: Ermöglicht den Zugriff auf Wawi-App bezogene Opperationen. currencies.read: Ermöglicht den Lesezugriff auf Währungen. jera.read: Ermöglicht den Lesezugriff auf JERA-interne Endpunkte. paymentmethods.read: Ermöglicht den Lesezugriff auf Zahlungsarten. payments.write: Ermöglicht den Schreibzugriff auf Zahlungen. salesinvoices.read: Ermöglicht den Lesezugriff auf Verkaufsrechnungen. salesinvoices.write: Ermöglicht den Schreibzugriff auf Verkaufsrechnungen. salesquotations.read: Ermöglicht den Lesezugriff auf Verkaufsangebote. salesquotations.write: Ermöglicht den Schreibzugriff auf Verkaufsangebote. system.worker.read: Worker-Synchronisationen lesen system.worker.write: Worker-Synchronisationen schreiben resources.read: Ressourcen lesen resources.write: Ressourcen schreiben pps.read: Produktionsdaten lesen pps.write: Produktionsdaten schreiben inventory.read: Lagerbestand lesen inventory.write: Lagerbestand schreiben taxes.write: Steuern schreiben application.runas: >- Ermöglicht der Anwendung, Anfragen im Namen eines anderen Benutzers auszuführen. ````