---
title: "Adds supplier information to an existing regular item. This command allows the association of suppliers with the item, including details such as purchase prices, delivery times, and order intervals."
method: POST
path: "/v2/itemdetails/suppliers/add"
tags: ["ItemdetailsCommand"]
---

# Adds supplier information to an existing regular item. This command allows the association of suppliers with the item, including details such as purchase prices, delivery times, and order intervals.

`POST /v2/itemdetails/suppliers/add`

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsAddItemSupplierCommandRequest — Adds supplier information to an existing regular item. This command allows the association of suppliers with the item, including details such as purchase prices, delivery times, and order intervals. - Request
  - `itemId` string, uuid
  - `itemSupplier` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateItemSupplier — Model Class: CreateItemSupplier
    - `supplierId` string, uuid
    - `supplierItemName` string — Name of the item at the supplier (max 255 characters).
    - `supplierItemNumber` string — Item number at the supplier (max 255 characters).
    - `stockLevel` number — Stock level of the item at the supplier.
    - `netPurchasePrice` number — Net purchase price of the item at the supplier.
    - `minimumPurchaseQuantity` integer — Minimum purchase quantity of the item at the supplier.
    - `deliveryTimeInDays` integer — Delivery time for this item at the supplier (in days).
    - `isDropshippingActive` boolean — Indicates if this item uses dropshipping from the supplier.
    - `packageUnitDescription` string — Description of the packaging unit.
    - `packageUnitQuantity` number — Quantity per packaging unit.
    - `notes` string — Additional notes (max 512 characters).
    - `vatRate` number — VAT rate of the item at the supplier.
    - `useSupplierDeliveryTime` boolean — Whether to use the supplier's delivery time directly.
    - `includeSupplierStock` boolean — Whether to include the supplier's stock in own inventory.
    - `purchaseInterval` number — Purchase interval for this item at the supplier.
    - `scalePrices` JTLWawiItemPublicApiDataTransferObjectsV2ItemdetailsCreateSupplierPrice[] — Scale prices defined by the supplier for this item.
      - `fromQuantity` number — Quantity from which the price applies. This value is not editable. To change it, a new scale must be created.
      - `netPrice` number — Net price for this scale.
      - `usePercentageDiscount` boolean — Indicates whether the scale uses a percentage discount of the NetPurchasePrice.
      - `percentageDiscount` number — The percentage discount applied in this scale.

## Response `200`

Supplier was successfully added to the item.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)