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

# Update Item Supplier

> Update the information for a specific supplier for a given item



## OpenAPI

````yaml /openapi/1.2.json patch /v1/items/{itemId}/suppliers/{supplierId}
openapi: 3.0.0
info:
  title: JTL-WAWI API (Cloud)
  description: "JTL-Wawi-Version: 2.0.0+Sha.881251b\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: '1.2'
  x-application-version: 2.0.0.0
servers:
  - url: https://api.jtl-cloud.com/erp
    description: Production Environment Cloud API Gateway
security: []
tags:
  - name: worker
    description: >-
      <p data-section-id='tag/worker' class='beta_summary'></p>Returns the
      Available Syncs of the Worker
  - 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: warehouse
    description: >-
      <p data-section-id='tag/warehouse' class='stable_summary'></p>Query all
      warehouses
  - name: transactionStatus
    description: >-
      <p data-section-id='tag/transactionStatus'
      class='stable_summary'></p>Query all transaction status for sales order
  - name: tax
    description: >-
      <p data-section-id='tag/tax' class='stable_summary'></p>Returns the
      Taxrate for the given Item
  - name: item
    description: >-
      <p data-section-id='tag/item' class='stable_summary'></p>Query all tax
      classes
  - name: supplier
    description: >-
      <p data-section-id='tag/supplier' class='stable_summary'></p>Query all
      suppliers
  - name: stock
    description: >-
      <p data-section-id='tag/stock' class='stable_summary'></p>Query stocks for
      a specific item, warehouse or storage location
  - name: shippingmethod
    description: >-
      <p data-section-id='tag/shippingmethod' class='stable_summary'></p>Query
      all shipping methods
  - name: salesorder
    description: >-
      <p data-section-id='tag/salesorder' class='stable_summary'></p>Query all
      sales orders
  - name: cancellationreason
    description: Planned
  - name: salesinvoicecorrection
    description: Development
  - name: saleschannel
    description: >-
      <p data-section-id='tag/saleschannel' class='stable_summary'></p>Get all
      sales channels
  - name: return
    description: >-
      <p data-section-id='tag/return' class='beta_summary'></p>Create a new
      return with associated items and packages.
  - name: returnstate
    description: Planned
  - name: returnreason
    description: Planned
  - name: property
    description: >-
      <p data-section-id='tag/property' class='stable_summary'></p>Query all
      properties for items
  - name: printer
    description: >-
      <p data-section-id='tag/printer' class='beta_summary'></p>Returns all
      Installed Printers
  - name: paymentmethod
    description: >-
      <p data-section-id='tag/paymentmethod' class='stable_summary'></p>Query
      all payment methods
  - name: onholdreason
    description: >-
      <p data-section-id='tag/onholdreason' class='stable_summary'></p>Query all
      on hold reasons for sales orders
  - name: offer
    description: >-
      <p data-section-id='tag/offer' class='beta_summary'></p>Execute the
      printing of a Offer
  - name: Configuration
    description: Planned
  - name: invoice
    description: Planned
  - 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: Planned
  - name: shipping
    description: Development
  - name: deliverynote
    description: Planned
  - name: customer
    description: >-
      <p data-section-id='tag/customer' class='stable_summary'></p>Query all
      customers
  - name: customerGroup
    description: >-
      <p data-section-id='tag/customerGroup' class='stable_summary'></p>Query
      all customer groups
  - name: customerCategory
    description: >-
      <p data-section-id='tag/customerCategory' class='stable_summary'></p>Query
      all customer categories
  - name: creditnote
    description: >-
      <p data-section-id='tag/creditnote' class='beta_summary'></p>Execute the
      printing of a CreditNote
  - name: company
    description: >-
      <p data-section-id='tag/company' class='stable_summary'></p>Query all
      companies
  - name: colorcodes
    description: >-
      <p data-section-id='tag/colorcodes' class='stable_summary'></p>Query all
      color codes for sales orders
  - name: category
    description: >-
      <p data-section-id='tag/category' class='stable_summary'></p>Query all
      categories
  - name: appRegistration
    description: >-
      <p data-section-id='tag/appRegistration' class='stable_summary'></p>Send a
      registration request for an (external) application
  - name: login
    description: >-
      <p data-section-id='tag/login' class='beta_summary'></p>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: >-
      <p data-section-id='tag/logout' class='beta_summary'></p>Sends a request
      to log out the user
  - name: accountingData
    description: Planned
paths:
  /v1/items/{itemId}/suppliers/{supplierId}:
    patch:
      tags:
        - item
      summary: Update Item Supplier
      description: Update the information for a specific supplier for a given item
      operationId: Item_UpdateItemSupplierAsync
      parameters:
        - name: x-tenant-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
          description: The tenant ID for the target ERP instance.
        - name: itemId
          in: path
          required: true
          description: The unique id of the item.
          schema:
            $ref: '#/components/schemas/JTL.Data.Contracts.Keys.ArtikelKey'
          x-position: 2
        - name: supplierId
          in: path
          required: true
          description: The unique id of the supplier.
          schema:
            $ref: '#/components/schemas/JTL.Data.Contracts.Keys.LieferantKey'
          x-position: 3
        - 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
      requestBody:
        x-name: itemSupplier
        description: The itemSupplier to update.
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/JTL.Wawi.Rest.Contracts.Models.V1.Item.UpdateItemSupplier
        required: true
        x-position: 1
      responses:
        '204':
          description: ''
          content:
            application/json: {}
        '400':
          description: The sent data is invalid.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/JTL.Wawi.Rest.Abstraction.Exceptions.ErrorResponse
        '401':
          description: ''
          content:
            application/json: {}
        '402':
          description: No licence available or the app has not been authorised by JTL.
          content:
            application/json: {}
        '404':
          description: No item and supplier with the given Ids exists.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/JTL.Wawi.Rest.Abstraction.Exceptions.ErrorResponse
      security:
        - oauth2-authorization-code: []
        - oauth2-client-credentials: []
components:
  schemas:
    JTL.Data.Contracts.Keys.ArtikelKey:
      type: integer
      format: int32
      additionalProperties: false
    JTL.Data.Contracts.Keys.LieferantKey:
      type: integer
      format: int32
      additionalProperties: false
    JTL.Wawi.Rest.Contracts.Models.V1.Item.UpdateItemSupplier:
      type: object
      description: 'Model Class: UpdateItemSupplier '
      additionalProperties: false
      properties:
        Sku:
          type: string
          description: Item SKU from the supplier.
        ItemName:
          type: string
          description: Item name from the supplier.
        IsStandard:
          type: boolean
          description: Defines the main supplier for the given item.
        PurchasePriceNet:
          type: number
          description: Net purchase price from the supplier.
          format: decimal
        TaxRate:
          type: number
          description: Percent of VAT tax rate.
          format: decimal
        MinimumPurchaseQuantity:
          type: number
          description: The minimum purchase quantity from the supplier.
          format: decimal
        PermissibleOrderQuantity:
          type: number
          description: >-
            The permissible order quantity for the item from the supplier. The
            increments in which the item can be sold.
          format: decimal
        DeliveryTime:
          type: integer
          description: Delivery time in days.
          format: int32
        UseSupplierDeliveryTime:
          type: boolean
          description: >-
            If set to true, Wawi will use the delivery time provided by the
            supplier and not by the item information. DeliveryTime will then be
            ignored.
        Stocklevel:
          type: number
          description: Stock level of the item at the supplier.
          format: decimal
        IsDropshipping:
          type: boolean
          description: Activates drop shipping for a given item and supplier.
        MergeStockLevel:
          type: boolean
          description: Forces Wawi to add the supplier's stock to your own stock.
        Comment:
          type: string
          description: Comment for the supplier.
        PackagingUnit:
          type: string
          description: Name of the packaging unit.
        AmountPackagingUnit:
          type: number
          description: Quantity in a packaging unit.
          format: decimal
        ScalePrices:
          type: array
          description: Scale prices from this supplier for the item.
          items:
            $ref: >-
              #/components/schemas/JTL.Wawi.Rest.Contracts.Models.V1.Item.UpdateSupplierItemScalePrice
    JTL.Wawi.Rest.Abstraction.Exceptions.ErrorResponse:
      type: object
      description: >-
        Represents an error response returned by the system in case of a failure
        or exception.
      additionalProperties: false
      properties:
        ErrorCode:
          type: string
          description: >-
            Gets or sets the error code that identifies the type of error
            encountered.
        ValidationErrors:
          type: object
          description: >-
            Gets or sets a dictionary containing validation errors associated
            with the request.
          deprecated: true
          x-deprecatedMessage: Use Errors
          additionalProperties:
            type: string
        Errors:
          type: object
          description: Gets or sets a collection of errors associated with the response.
          additionalProperties:
            type: array
            items:
              type: string
        ErrorMessage:
          type: string
          description: >-
            Gets or sets the error message that provides details about the error
            encountered.
        Stacktrace:
          type: string
          description: >-
            Gets or sets the stack trace associated with the error, providing
            detailed

            information about the sequence of method calls that led to the
            exception.
    JTL.Wawi.Rest.Contracts.Models.V1.Item.UpdateSupplierItemScalePrice:
      type: object
      description: 'Model Class: UpdateSupplierItemScalePrice '
      additionalProperties: false
      required:
        - FromQuantity
      properties:
        FromQuantity:
          type: integer
          description: >-
            The quantity where this scale price starts. This scale price ends at
            the next highest quantity. If there is no scale price with a higher
            quantity, then this price is set for all quantities from this point
            on.
          format: int32
        PurchasePriceNet:
          type: number
          description: >-
            Net purchase price of the supplier for the scale price starting from
            this given quantity to the next scale price with a higher quantity.
            If you use PurchasePriceNet, you can't use ReduceStandardSpBy% as
            well. Only one is allowed.
          format: decimal
        ReduceStandardPriceByPercent:
          type: number
          description: >-
            Reduces the default purchase price by a percentage. If you use
            PurchasePriceNet, you can't use ReduceStandardPriceByPercent as
            well. Only one is allowed.
          format: decimal
  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: {}
    oauth2-client-credentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://auth.jtl-cloud.com/oauth2/token
          scopes: {}

````