> ## 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.

# Query Scx Offers

> Delivers a paged list of SCX offers. The optional "SalesChannelId" restricts the list to a single sales channel: if it is omitted or empty, the offers of all sales channels are returned; a valid id of an unknown sales channel returns an empty list; an invalid id is rejected as invalid input (error code SALES_CHANNEL_ID_INVALID). Supports projection, sorting and filtering.

Paged query. Query parameters: pageNumber (default 1), pageSize (default 100). Sorting via sortBy (comma-separated fields, applied as OrderBy then ThenBy) and sortDescending (default false). Date filtering per date field via {Field}After (greater than) and {Field}Before (less than).



## OpenAPI

````yaml /openapi/erp/2.2.json get /v2/scx/offers
openapi: 3.0.0
info:
  title: JTL-WAWI API (Cloud)
  description: "JTL-Wawi-Version: 2.3.0-alpha.261021191851+Sha.6120591\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.2'
  x-application-version: 2.3.0.0
servers:
  - url: https://api.jtl-cloud.com/erp
    description: Production Environment Cloud API Gateway
security: []
tags:
  - name: WMS
    description: >-
      <p data-section-id='tag/WMS' class='stable_summary'></p>Query all pick
      lists for a specific wms warehouse that are not completed.
  - name: Wawi App
    description: >-
      <p data-section-id='tag/Wawi App' class='stable_summary'></p>Get a
      specific customer
  - name: Warehouses
    description: >-
      <p data-section-id='tag/Warehouses' class='stable_summary'></p>Queries all
      storage locations for a given warehouse.
  - name: Units
    description: Development
  - name: Transaction Status
    description: >-
      <p data-section-id='tag/Transaction Status'
      class='stable_summary'></p>Queries all transaction statuses for a sales
      order.
  - name: Tax
    description: >-
      <p data-section-id='tag/Tax' class='stable_summary'></p>Returns the tax
      rate for the given item.
  - name: Inventory
    description: >-
      <p data-section-id='tag/Inventory' class='stable_summary'></p>Queries
      stocks for a specific item, warehouse or storage location.
  - name: Sales Order
    description: >-
      <p data-section-id='tag/Sales Order' class='stable_summary'></p>Queries
      all cancellation reasons for sales orders.
  - name: Sales Invoice Correction
    description: >-
      <p data-section-id='tag/Sales Invoice Correction'
      class='stable_summary'></p>Queries all cancellation reasons for sales
      invoice corrections.
  - name: Return
    description: >-
      <p data-section-id='tag/Return' class='stable_summary'></p>Create a new
      return with associated items and packages.
  - name: Item
    description: >-
      <p data-section-id='tag/Item' class='stable_summary'></p>Queries all
      responsible persons.
  - name: Refund
    description: >-
      <p data-section-id='tag/Refund' class='stable_summary'></p>Queries all
      cancellation reasons for refunds.
  - name: Property
    description: >-
      <p data-section-id='tag/Property' class='stable_summary'></p>Queries all
      properties of items.
  - name: Printer
    description: >-
      <p data-section-id='tag/Printer' class='stable_summary'></p>Retrieves all
      installed printers.
  - name: Master Data
    description: >-
      <p data-section-id='tag/Master Data' class='stable_summary'></p>Queries
      all on hold reasons for sales orders.
  - name: Manufacturer
    description: Development
  - name: Label
    description: Development
  - name: Sales Invoice
    description: >-
      <p data-section-id='tag/Sales Invoice' class='stable_summary'></p>Gets a
      specific invoice.
  - name: Info
    description: >-
      <p data-section-id='tag/Info' class='stable_summary'></p>Returns the
      status of the API.
  - name: Features
    description: >-
      <p data-section-id='tag/Features' class='stable_summary'></p>Returns the
      available feature sets with release state and API version.
  - name: Extensibility
    description: >-
      <p data-section-id='tag/Extensibility' class='stable_summary'></p>Returns
      the installed extensions.
  - name: Shipment
    description: Development
  - name: Delivery Note
    description: >-
      <p data-section-id='tag/Delivery Note' class='stable_summary'></p>Queries
      all delivery notes.
  - name: Custom Field
    description: Development
  - name: Customer
    description: >-
      <p data-section-id='tag/Customer' class='stable_summary'></p>Deletes a
      specific customer.
  - name: Authentication
    description: >-
      <p data-section-id='tag/Authentication'
      class='deprecated_summary'></p>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: >-
      <p data-section-id='tag/Sales Quotation'
      class='stable_summary'></p>Execute the printing of a sales quotation
  - name: Production
  - name: Resources
  - name: Company
  - name: Sales Orders
  - name: Marketplace Order
  - name: Marketplace Offer
  - name: Marketplace Invoicing
  - name: Sales Channel
  - name: Payment
  - name: Warehouse Assistant
  - name: Worker
paths:
  /v2/scx/offers:
    get:
      tags:
        - SCX
      summary: Query Scx Offers
      description: >-
        Delivers a paged list of SCX offers. The optional "SalesChannelId"
        restricts the list to a single sales channel: if it is omitted or empty,
        the offers of all sales channels are returned; a valid id of an unknown
        sales channel returns an empty list; an invalid id is rejected as
        invalid input (error code SALES_CHANNEL_ID_INVALID). Supports
        projection, sorting and filtering.


        Paged query. Query parameters: pageNumber (default 1), pageSize (default
        100). Sorting via sortBy (comma-separated fields, applied as OrderBy
        then ThenBy) and sortDescending (default false). Date filtering per date
        field via {Field}After (greater than) and {Field}Before (less than).
      operationId: Offers_QueryScxOffers
      parameters:
        - name: salesChannelId
          in: query
          description: >-
            Id of the sales channel to restrict the list to, as returned in
            "SalesChannelId" of an offer. Opaque, tenant-local composite
            identifier (not a UUID). If omitted or empty, the offers of all
            sales channels are returned. A valid id of an unknown sales channel
            returns an empty list; an invalid id is rejected as invalid input
            (error code SALES_CHANNEL_ID_INVALID).
          schema:
            type: string
        - name: pageNumber
          in: query
          description: Number of the page of items to fetch. Defaults to 1 when omitted.
          schema:
            type: integer
            format: int32
        - name: pageSize
          in: query
          description: >-
            Size of the page specified by PageNumber. Defaults to 100 when
            omitted.
          schema:
            type: integer
            format: int32
        - name: sortBy
          in: query
          description: >-
            Property to sort by. Multiple comma-separated fields are applied in
            order (OrderBy, then ThenBy).
          schema:
            type: string
        - name: sortDescending
          in: query
          description: Sort in descending order. Defaults to ascending when omitted.
          schema:
            type: boolean
        - name: activeFromAfter
          in: query
          description: >-
            Only include items whose ActiveFrom is after (greater than) this
            value.
          schema:
            type: string
            format: date-time
        - name: activeFromBefore
          in: query
          description: >-
            Only include items whose ActiveFrom is before (less than) this
            value.
          schema:
            type: string
            format: date-time
        - name: expiresAtAfter
          in: query
          description: >-
            Only include items whose ExpiresAt is after (greater than) this
            value.
          schema:
            type: string
            format: date-time
        - name: expiresAtBefore
          in: query
          description: Only include items whose ExpiresAt is before (less than) this value.
          schema:
            type: string
            format: date-time
        - name: lastUploadedAtAfter
          in: query
          description: >-
            Only include items whose LastUploadedAt is after (greater than) this
            value.
          schema:
            type: string
            format: date-time
        - name: lastUploadedAtBefore
          in: query
          description: >-
            Only include items whose LastUploadedAt is before (less than) this
            value.
          schema:
            type: string
            format: date-time
        - name: statusReceivedAtAfter
          in: query
          description: >-
            Only include items whose StatusReceivedAt is after (greater than)
            this value.
          schema:
            type: string
            format: date-time
        - name: statusReceivedAtBefore
          in: query
          description: >-
            Only include items whose StatusReceivedAt is before (less than) this
            value.
          schema:
            type: string
            format: date-time
        - name: quantityUpdatedAtAfter
          in: query
          description: >-
            Only include items whose QuantityUpdatedAt is after (greater than)
            this value.
          schema:
            type: string
            format: date-time
        - name: quantityUpdatedAtBefore
          in: query
          description: >-
            Only include items whose QuantityUpdatedAt is before (less than)
            this value.
          schema:
            type: string
            format: date-time
        - name: priceUpdatedAtAfter
          in: query
          description: >-
            Only include items whose PriceUpdatedAt is after (greater than) this
            value.
          schema:
            type: string
            format: date-time
        - name: priceUpdatedAtBefore
          in: query
          description: >-
            Only include items whose PriceUpdatedAt is before (less than) this
            value.
          schema:
            type: string
            format: date-time
        - name: awaitingDeliveryAvailableAtAfter
          in: query
          description: >-
            Only include items whose AwaitingDeliveryAvailableAt is after
            (greater than) this value.
          schema:
            type: string
            format: date-time
        - name: awaitingDeliveryAvailableAtBefore
          in: query
          description: >-
            Only include items whose AwaitingDeliveryAvailableAt is before (less
            than) this value.
          schema:
            type: string
            format: date-time
        - name: x-tenant-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
          description: The tenant ID for the target ERP instance.
      responses:
        '200':
          description: Paged result.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/JTL.Framework.Api.Abstraction.Models.PagedListOfJTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOffer
        '400':
          description: >-
            The request is invalid, for example because the sales channel id is
            not valid (error code SALES_CHANNEL_ID_INVALID).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastEndpoints.ProblemDetails'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastEndpoints.ProblemDetails'
        '403':
          description: Forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastEndpoints.ProblemDetails'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FastEndpoints.ProblemDetails'
      security:
        - oauth2-authorization-code:
            - scxoffers.read
        - oauth2-client-credentials:
            - scxoffers.read
components:
  schemas:
    JTL.Framework.Api.Abstraction.Models.PagedListOfJTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOffer:
      type: object
      additionalProperties: false
      required:
        - totalItems
        - pageNumber
        - pageSize
        - items
      properties:
        totalItems:
          type: integer
          format: int32
        pageNumber:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/JTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOffer
        totalPages:
          type: integer
          format: int32
        hasPreviousPage:
          type: boolean
        hasNextPage:
          type: boolean
        nextPageNumber:
          type: integer
          format: int32
        previousPageNumber:
          type: integer
          format: int32
    FastEndpoints.ProblemDetails:
      type: object
      additionalProperties: false
      properties:
        type:
          type: string
          default: https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1
        title:
          type: string
          default: One or more validation errors occurred.
        status:
          type: integer
          format: int32
          default: 400
        instance:
          type: string
          default: /api/route
        traceId:
          type: string
          default: 0HMPNHL0JHL76:00000001
        detail:
          type: string
        errors:
          type: array
          items:
            $ref: '#/components/schemas/FastEndpoints.ProblemDetails_Error'
    JTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOffer:
      type: object
      description: An offer of a sales channel connected via SCX.
      additionalProperties: false
      required:
        - id
        - salesChannelId
        - origin
        - isItemAssigned
        - status
        - isListed
        - quantity
        - quantityUpdatedAt
      properties:
        id:
          $ref: '#/components/schemas/JTL.Wawi.Marketplace.Scx.Types.Keys.ScxOfferKey'
          description: Unique id of the offer.
        salesChannelId:
          $ref: '#/components/schemas/JTL.Wawi.Rest.Contracts.Models.SalesChannelId'
          description: >-
            Id of the sales channel (the seller account) the offer belongs to.
            Opaque, tenant-local composite identifier (not a UUID). Pass this
            value as "SalesChannelId" to restrict the list to this sales
            channel.
        salesChannelName:
          type: string
          description: >-
            Name of the sales channel (the seller account) the offer belongs to,
            or null if no name is set.
        channelId:
          $ref: >-
            #/components/schemas/JTL.Wawi.Marketplace.Scx.Types.Keys.ScxChannelKey
          description: >-
            Id of the catalog channel (for example the Amazon site) the sales
            channel of the offer is operated on, or null if it is not available.
            The catalog channel is shared by all sellers; use "SalesChannelId"
            to address a single sales channel.
        channel:
          type: string
          description: >-
            Unique name (code) of the catalog channel, or null if it is not
            available.
        channelDisplayName:
          type: string
          description: >-
            Display name of the catalog channel as shown to users, or null if it
            is not available.
        channelOfferId:
          type: string
          description: >-
            Id of the offer on the sales channel, or null if the channel has not
            assigned an id yet.
        origin:
          $ref: >-
            #/components/schemas/JTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOfferOrigin
          description: >-
            Origin of the offer: "Wawi" if it was created in JTL-Wawi,
            "External" if it was imported from the sales channel. An imported
            offer stays "External" after it has been assigned to an item.
        isItemAssigned:
          type: boolean
          description: >-
            Whether the offer is assigned to an item (true) or not (false). If
            true, "ItemId" is set.
        itemId:
          $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ArtikelKey'
          description: >-
            Id of the item the offer is assigned to, or null if the offer is not
            assigned to an item.
        itemSku:
          type: string
          description: >-
            SKU (stock keeping unit) of the item the offer is assigned to, or
            null if the offer is not assigned to an item.
        sku:
          type: string
          description: >-
            SKU (stock keeping unit) of the offer. For an offer imported from
            the sales channel this is the SKU reported by the channel, if there
            is one; otherwise it is the SKU of the assigned item. Null if
            neither is available.
        title:
          type: string
          description: >-
            Title of the offer. For an offer that is not assigned to an item
            this is the title imported from the sales channel; otherwise it is
            the name of the assigned item in the language of the sales channel.
            Null if none is available.
        status:
          $ref: >-
            #/components/schemas/JTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOfferStatus
          description: Combined lifecycle and action status of the offer.
        isListed:
          type: boolean
          description: Whether the offer is currently listed on the sales channel.
        listingUrl:
          type: string
          description: >-
            URL of the offer listing on the sales channel, or null if it is not
            available.
        activeFrom:
          type: string
          description: >-
            Point in time since which the offer is active, in UTC, or null if it
            is not known.
          format: date-time
        expiresAt:
          type: string
          description: >-
            Point in time at which the offer expires, in UTC, or null if no
            expiry date is known.
          format: date-time
        lastUploadedAt:
          type: string
          description: >-
            Point in time of the last upload of the offer to the sales channel,
            in UTC, or null if the offer has not been uploaded yet.
          format: date-time
        statusReceivedAt:
          type: string
          description: >-
            Point in time at which the status of the offer was last received
            from the sales channel, in UTC, or null if no status has been
            received yet.
          format: date-time
        quantity:
          type: number
          description: >-
            Current quantity of the offer: the more recently updated of the
            quantity stored with the offer and the stock maintained for the
            sales channel in JTL-Wawi.
          format: decimal
        quantityUpdatedAt:
          type: string
          description: >-
            Point in time at which the quantity stored with the offer was last
            updated, in UTC.
          format: date-time
        priceUpdatedAt:
          type: string
          description: >-
            Point in time at which the price of the offer was last updated, in
            UTC, or null if it is not known.
          format: date-time
        availableStock:
          type: number
          description: >-
            Stock of the assigned item that is available for sale, or null if
            the offer is not assigned to an item or no stock data exists for it.
          format: decimal
        quantityInSalesOrders:
          type: number
          description: >-
            Quantity of the assigned item that is reserved in sales orders, or
            null if the offer is not assigned to an item or no stock data exists
            for it.
          format: decimal
        quantityAwaitingDelivery:
          type: number
          description: >-
            Quantity of the assigned item that is expected from suppliers and
            awaiting delivery, or null if the offer is not assigned to an item
            or no stock data exists for it.
          format: decimal
        awaitingDeliveryAvailableAt:
          type: string
          description: >-
            Date on which the stock of the assigned item that is awaiting
            delivery ("QuantityAwaitingDelivery") becomes available, or null if
            the offer is not assigned to an item or no date is maintained. Only
            the date part is meaningful; the time part carries no meaning and
            must be ignored.
          format: date-time
        minimumStockLevel:
          type: number
          description: >-
            Minimum stock level configured for the assigned item on this sales
            channel, or null if none is configured. Always null for an offer
            that is not assigned to an item.
          format: decimal
        maximumStockLevel:
          type: number
          description: >-
            Maximum stock level configured for the assigned item on this sales
            channel, or null if none is configured. Always null for an offer
            that is not assigned to an item.
          format: decimal
        netPrice:
          type: number
          description: >-
            Net price of the offer in the default customer group: the price
            maintained for the sales channel if there is one, otherwise the
            standard net sales price ("SalesPriceNet") of the assigned item.
            Null if the offer is not assigned to an item.
          format: decimal
        discountPercent:
          type: number
          description: >-
            Discount in percent on the standard net sales price
            ("SalesPriceNet") of the assigned item that applies to this sales
            channel in the default customer group, or null if no price specific
            to the sales channel is maintained.
          format: decimal
        customerGroupId:
          $ref: '#/components/schemas/JTL.Data.Contracts.Keys.KundenGruppeKey'
          description: >-
            Customer group that "NetPrice" and "DiscountPercent" refer to (the
            default customer group).
        salesPriceNet:
          type: number
          description: >-
            Standard net sales price of the assigned item, or null if the offer
            is not assigned to an item.
          format: decimal
        lastUploadedPrice:
          type: number
          description: >-
            Last price uploaded to the channel. Null if no price has been
            uploaded yet.
          format: decimal
        taxClassId:
          $ref: '#/components/schemas/JTL.Data.Contracts.Keys.SteuerklasseKey'
          description: >-
            Id of the tax class of the assigned item, or null if the offer is
            not assigned to an item.
        companyId:
          $ref: '#/components/schemas/JTL.Data.Contracts.Keys.FirmaKey'
          description: >-
            Id of the company the sales channel is assigned to, or null if none
            is assigned.
        currency:
          type: string
          description: >-
            ISO 4217 currency code of the catalog channel in upper case letters,
            or null if it is not available.
        channelCategoryId:
          $ref: >-
            #/components/schemas/JTL.Wawi.Marketplace.Scx.Types.Keys.ScxCategoryKey
          description: >-
            Id of the channel category the offer is assigned to, or null if the
            offer has no category.
        channelCategoryExternalId:
          type: string
          description: >-
            Identifier of the channel category as used by the sales channel
            itself, or null if the offer has no category.
        channelCategoryName:
          type: string
          description: >-
            Display name of the channel category on the sales channel, or null
            if the offer has no category.
        gtin:
          type: string
          description: >-
            Global Trade Item Number (GTIN) of the offer. For an offer imported
            from the sales channel this is the GTIN reported by the channel, if
            there is one; otherwise it is the barcode of the assigned item. Null
            if neither is available.
        mpn:
          type: string
          description: >-
            Manufacturer Part Number (MPN) of the assigned item, or null if the
            offer is not assigned to an item or the item has none.
        isbn:
          type: string
          description: >-
            International Standard Book Number (ISBN) of the assigned item, or
            null if the offer is not assigned to an item or the item has none.
        asin:
          type: string
          description: >-
            Amazon Standard Identification Number (ASIN) of the assigned item,
            or null if the offer is not assigned to an item or the item has
            none. The value is taken from the item only, so it is always null
            for an offer that is not assigned to an item.
        manufacturer:
          type: string
          description: >-
            Name of the manufacturer of the assigned item, or null if the offer
            is not assigned to an item or the item has no manufacturer.
        weight:
          type: number
          description: >-
            Weight of the assigned item as maintained in JTL-Wawi, or null if
            the offer is not assigned to an item.
          format: decimal
        processingTime:
          type: integer
          description: >-
            Processing time of the assigned item in days, or null if the offer
            is not assigned to an item or the item has none set.
          format: int32
    FastEndpoints.ProblemDetails_Error:
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
          default: Error or field name
        reason:
          type: string
          default: Error reason
        code:
          type: string
        severity:
          type: string
    JTL.Wawi.Marketplace.Scx.Types.Keys.ScxOfferKey:
      type: string
      description: >-
        Represents a key for an SCX offer, used for identification and
        comparison.
      format: uuid
      example: b45f6432-2462-4c6f-b00f-1d9d01000000
      additionalProperties: false
    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.Wawi.Marketplace.Scx.Types.Keys.ScxChannelKey:
      type: string
      description: Represents a key for a SCX channel.
      format: uuid
      example: b45f6432-2462-4c6f-b00f-1d9d01000000
      additionalProperties: false
    JTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOfferOrigin:
      type: integer
      description: 0 = Wawi, 1 = External
      format: int32
      x-enumNames:
        - Wawi
        - External
      enum:
        - 0
        - 1
    JTL.Data.Contracts.Keys.ArtikelKey:
      type: string
      format: uuid
      example: b45f6432-2462-4c6f-b00f-1d9d01000000
      additionalProperties: false
    JTL.Wawi.Marketplace.Scx.PublicApi.DataTransferObjects.V2.Offers.ScxOfferStatus:
      type: integer
      description: >-
        0 = NothingToDo, 1 = WaitingForUpload, 2 = Uploaded, 3 = InReview, 4 =
        Listed, 5 = Ended, 6 = Error, 100 = PendingCreation, 101 =
        PendingUpdate, 102 = PendingDeletion, 103 = TransferBlocked
      format: int32
      x-enumNames:
        - NothingToDo
        - WaitingForUpload
        - Uploaded
        - InReview
        - Listed
        - Ended
        - Error
        - PendingCreation
        - PendingUpdate
        - PendingDeletion
        - TransferBlocked
      enum:
        - 0
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 100
        - 101
        - 102
        - 103
    JTL.Data.Contracts.Keys.KundenGruppeKey:
      type: string
      format: uuid
      example: b45f6432-2462-4c6f-b00f-1d9d01000000
      additionalProperties: false
    JTL.Data.Contracts.Keys.SteuerklasseKey:
      type: string
      format: uuid
      example: b45f6432-2462-4c6f-b00f-1d9d01000000
      additionalProperties: false
    JTL.Data.Contracts.Keys.FirmaKey:
      type: string
      description: Represents a key for identifying a firm within the application.
      format: uuid
      example: b45f6432-2462-4c6f-b00f-1d9d01000000
      additionalProperties: false
    JTL.Wawi.Marketplace.Scx.Types.Keys.ScxCategoryKey:
      type: string
      description: >-
        Represents a key for a SCX category, used for identity and
        serialization.
      format: uuid
      example: b45f6432-2462-4c6f-b00f-1d9d01000000
      additionalProperties: false
  securitySchemes:
    oauth2-authorization-code:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://id.jtl-cloud.com/oauth/v2/authorize
          tokenUrl: https://id.jtl-cloud.com/oauth/v2/token
          scopes:
            inventories.write: Grants permission to modify stock levels.
            inventory.read: Grants permission to read stock levels.
            inventory.write: Grants permission to modify stock levels.
            warehouse.read: Grants permission to read warehouse data.
            items.read: Grants permission to read item data.
            items.write: Grants permission to create and modify item data.
            procurements.read: Beschaffung lesen
            saleschannels.read: Grants permission to read sales channels.
            saleschannels.write: Grants permission to create and modify sales channels.
            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.
            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.
            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.
            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.
            channels.read: Grants permission to read marketplace channels.
            invoices.print: >-
              Grants permission to print marketplace external documents
              (invoices, credit notes).
            marketplaceoffers.read: Grants permission to read marketplace offers and offer failures.
            marketplaceoffers.write: Grants permission to create and modify marketplace offers.
            notifications.read: Grants permission to read marketplace notifications.
            orders.write: >-
              Grants permission to modify marketplace order data (exclude/reset
              cancellation, payment, return and shipping uploads).
            scxoffers.read: >-
              Grants permission to read SCX offer data, such as channel
              attributes.
            masterdata.write: Write master data
            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://id.jtl-cloud.com/oauth/v2/token
          scopes:
            inventories.write: Grants permission to modify stock levels.
            inventory.read: Grants permission to read stock levels.
            inventory.write: Grants permission to modify stock levels.
            warehouse.read: Grants permission to read warehouse data.
            items.read: Grants permission to read item data.
            items.write: Grants permission to create and modify item data.
            procurements.read: Beschaffung lesen
            saleschannels.read: Grants permission to read sales channels.
            saleschannels.write: Grants permission to create and modify sales channels.
            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.
            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.
            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.
            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.
            channels.read: Grants permission to read marketplace channels.
            invoices.print: >-
              Grants permission to print marketplace external documents
              (invoices, credit notes).
            marketplaceoffers.read: Grants permission to read marketplace offers and offer failures.
            marketplaceoffers.write: Grants permission to create and modify marketplace offers.
            notifications.read: Grants permission to read marketplace notifications.
            orders.write: >-
              Grants permission to modify marketplace order data (exclude/reset
              cancellation, payment, return and shipping uploads).
            scxoffers.read: >-
              Grants permission to read SCX offer data, such as channel
              attributes.
            masterdata.write: Write master data
            taxes.write: Grants permission to create and modify tax data.
            application.runas: >-
              Allows the application to execute requests on behalf of another
              user.

````