Create Item Supplier

curl --request POST \
  --url https://api.jtl-cloud.com/erp/items/{itemId}/suppliers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "SupplierId": 123,
  "Sku": "ART2394871",
  "ItemName": "Interdimensional Goggles",
  "IsStandard": false,
  "PurchasePriceNet": 97.23,
  "TaxRate": 19,
  "MinimumPurchaseQuantity": 1,
  "PermissibleOrderQuantity": 2,
  "DeliveryTime": 2,
  "UseSupplierDeliveryTime": false,
  "Stocklevel": 34,
  "IsDropshipping": false,
  "MergeStockLevel": false,
  "Comment": "A custom comment",
  "PackagingUnit": "box",
  "AmountPackagingUnit": 1,
  "ScalePrices": [
    {
      "FromQuantity": 0,
      "PurchasePriceNet": 94.21,
      "ReduceStandardPriceByPercent": 5
    }
  ]
}
'

import requests

url = "https://api.jtl-cloud.com/erp/items/{itemId}/suppliers"

payload = {
    "SupplierId": 123,
    "Sku": "ART2394871",
    "ItemName": "Interdimensional Goggles",
    "IsStandard": False,
    "PurchasePriceNet": 97.23,
    "TaxRate": 19,
    "MinimumPurchaseQuantity": 1,
    "PermissibleOrderQuantity": 2,
    "DeliveryTime": 2,
    "UseSupplierDeliveryTime": False,
    "Stocklevel": 34,
    "IsDropshipping": False,
    "MergeStockLevel": False,
    "Comment": "A custom comment",
    "PackagingUnit": "box",
    "AmountPackagingUnit": 1,
    "ScalePrices": [
        {
            "FromQuantity": 0,
            "PurchasePriceNet": 94.21,
            "ReduceStandardPriceByPercent": 5
        }
    ]
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    SupplierId: 123,
    Sku: 'ART2394871',
    ItemName: 'Interdimensional Goggles',
    IsStandard: false,
    PurchasePriceNet: 97.23,
    TaxRate: 19,
    MinimumPurchaseQuantity: 1,
    PermissibleOrderQuantity: 2,
    DeliveryTime: 2,
    UseSupplierDeliveryTime: false,
    Stocklevel: 34,
    IsDropshipping: false,
    MergeStockLevel: false,
    Comment: 'A custom comment',
    PackagingUnit: 'box',
    AmountPackagingUnit: 1,
    ScalePrices: [{FromQuantity: 0, PurchasePriceNet: 94.21, ReduceStandardPriceByPercent: 5}]
  })
};

fetch('https://api.jtl-cloud.com/erp/items/{itemId}/suppliers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jtl-cloud.com/erp/items/{itemId}/suppliers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'SupplierId' => 123,
    'Sku' => 'ART2394871',
    'ItemName' => 'Interdimensional Goggles',
    'IsStandard' => false,
    'PurchasePriceNet' => 97.23,
    'TaxRate' => 19,
    'MinimumPurchaseQuantity' => 1,
    'PermissibleOrderQuantity' => 2,
    'DeliveryTime' => 2,
    'UseSupplierDeliveryTime' => false,
    'Stocklevel' => 34,
    'IsDropshipping' => false,
    'MergeStockLevel' => false,
    'Comment' => 'A custom comment',
    'PackagingUnit' => 'box',
    'AmountPackagingUnit' => 1,
    'ScalePrices' => [
        [
                'FromQuantity' => 0,
                'PurchasePriceNet' => 94.21,
                'ReduceStandardPriceByPercent' => 5
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/items/{itemId}/suppliers"

	payload := strings.NewReader("{\n  \"SupplierId\": 123,\n  \"Sku\": \"ART2394871\",\n  \"ItemName\": \"Interdimensional Goggles\",\n  \"IsStandard\": false,\n  \"PurchasePriceNet\": 97.23,\n  \"TaxRate\": 19,\n  \"MinimumPurchaseQuantity\": 1,\n  \"PermissibleOrderQuantity\": 2,\n  \"DeliveryTime\": 2,\n  \"UseSupplierDeliveryTime\": false,\n  \"Stocklevel\": 34,\n  \"IsDropshipping\": false,\n  \"MergeStockLevel\": false,\n  \"Comment\": \"A custom comment\",\n  \"PackagingUnit\": \"box\",\n  \"AmountPackagingUnit\": 1,\n  \"ScalePrices\": [\n    {\n      \"FromQuantity\": 0,\n      \"PurchasePriceNet\": 94.21,\n      \"ReduceStandardPriceByPercent\": 5\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.jtl-cloud.com/erp/items/{itemId}/suppliers")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"SupplierId\": 123,\n  \"Sku\": \"ART2394871\",\n  \"ItemName\": \"Interdimensional Goggles\",\n  \"IsStandard\": false,\n  \"PurchasePriceNet\": 97.23,\n  \"TaxRate\": 19,\n  \"MinimumPurchaseQuantity\": 1,\n  \"PermissibleOrderQuantity\": 2,\n  \"DeliveryTime\": 2,\n  \"UseSupplierDeliveryTime\": false,\n  \"Stocklevel\": 34,\n  \"IsDropshipping\": false,\n  \"MergeStockLevel\": false,\n  \"Comment\": \"A custom comment\",\n  \"PackagingUnit\": \"box\",\n  \"AmountPackagingUnit\": 1,\n  \"ScalePrices\": [\n    {\n      \"FromQuantity\": 0,\n      \"PurchasePriceNet\": 94.21,\n      \"ReduceStandardPriceByPercent\": 5\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/items/{itemId}/suppliers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"SupplierId\": 123,\n  \"Sku\": \"ART2394871\",\n  \"ItemName\": \"Interdimensional Goggles\",\n  \"IsStandard\": false,\n  \"PurchasePriceNet\": 97.23,\n  \"TaxRate\": 19,\n  \"MinimumPurchaseQuantity\": 1,\n  \"PermissibleOrderQuantity\": 2,\n  \"DeliveryTime\": 2,\n  \"UseSupplierDeliveryTime\": false,\n  \"Stocklevel\": 34,\n  \"IsDropshipping\": false,\n  \"MergeStockLevel\": false,\n  \"Comment\": \"A custom comment\",\n  \"PackagingUnit\": \"box\",\n  \"AmountPackagingUnit\": 1,\n  \"ScalePrices\": [\n    {\n      \"FromQuantity\": 0,\n      \"PurchasePriceNet\": 94.21,\n      \"ReduceStandardPriceByPercent\": 5\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "ItemId": 123,
  "SupplierId": 123,
  "Sku": "ART2394871",
  "ItemName": "Interdimensional Goggles",
  "IsStandard": false,
  "PurchasePriceNet": 97.23,
  "TaxRate": 19,
  "MinimumPurchaseQuantity": 1,
  "PermissibleOrderQuantity": 2,
  "DeliveryTime": 2,
  "UseSupplierDeliveryTime": false,
  "Stocklevel": 34,
  "IsDropshipping": false,
  "MergeStockLevel": false,
  "Comment": "A custom comment",
  "PackagingUnit": "box",
  "AmountPackagingUnit": 1,
  "PackagingUnitPurchasePriceNet": 94.21,
  "ScalePrices": [
    {
      "FromQuantity": 0,
      "PurchasePriceNet": 94.21,
      "ReduceStandardPriceByPercent": 5
    }
  ]
}

{
  "ErrorCode": "<string>",
  "ValidationErrors": {},
  "Errors": {},
  "ErrorMessage": "<string>",
  "Stacktrace": "<string>"
}

POST

items

{itemId}

suppliers

Create Item Supplier

curl --request POST \
  --url https://api.jtl-cloud.com/erp/items/{itemId}/suppliers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "SupplierId": 123,
  "Sku": "ART2394871",
  "ItemName": "Interdimensional Goggles",
  "IsStandard": false,
  "PurchasePriceNet": 97.23,
  "TaxRate": 19,
  "MinimumPurchaseQuantity": 1,
  "PermissibleOrderQuantity": 2,
  "DeliveryTime": 2,
  "UseSupplierDeliveryTime": false,
  "Stocklevel": 34,
  "IsDropshipping": false,
  "MergeStockLevel": false,
  "Comment": "A custom comment",
  "PackagingUnit": "box",
  "AmountPackagingUnit": 1,
  "ScalePrices": [
    {
      "FromQuantity": 0,
      "PurchasePriceNet": 94.21,
      "ReduceStandardPriceByPercent": 5
    }
  ]
}
'

import requests

url = "https://api.jtl-cloud.com/erp/items/{itemId}/suppliers"

payload = {
    "SupplierId": 123,
    "Sku": "ART2394871",
    "ItemName": "Interdimensional Goggles",
    "IsStandard": False,
    "PurchasePriceNet": 97.23,
    "TaxRate": 19,
    "MinimumPurchaseQuantity": 1,
    "PermissibleOrderQuantity": 2,
    "DeliveryTime": 2,
    "UseSupplierDeliveryTime": False,
    "Stocklevel": 34,
    "IsDropshipping": False,
    "MergeStockLevel": False,
    "Comment": "A custom comment",
    "PackagingUnit": "box",
    "AmountPackagingUnit": 1,
    "ScalePrices": [
        {
            "FromQuantity": 0,
            "PurchasePriceNet": 94.21,
            "ReduceStandardPriceByPercent": 5
        }
    ]
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    SupplierId: 123,
    Sku: 'ART2394871',
    ItemName: 'Interdimensional Goggles',
    IsStandard: false,
    PurchasePriceNet: 97.23,
    TaxRate: 19,
    MinimumPurchaseQuantity: 1,
    PermissibleOrderQuantity: 2,
    DeliveryTime: 2,
    UseSupplierDeliveryTime: false,
    Stocklevel: 34,
    IsDropshipping: false,
    MergeStockLevel: false,
    Comment: 'A custom comment',
    PackagingUnit: 'box',
    AmountPackagingUnit: 1,
    ScalePrices: [{FromQuantity: 0, PurchasePriceNet: 94.21, ReduceStandardPriceByPercent: 5}]
  })
};

fetch('https://api.jtl-cloud.com/erp/items/{itemId}/suppliers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jtl-cloud.com/erp/items/{itemId}/suppliers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'SupplierId' => 123,
    'Sku' => 'ART2394871',
    'ItemName' => 'Interdimensional Goggles',
    'IsStandard' => false,
    'PurchasePriceNet' => 97.23,
    'TaxRate' => 19,
    'MinimumPurchaseQuantity' => 1,
    'PermissibleOrderQuantity' => 2,
    'DeliveryTime' => 2,
    'UseSupplierDeliveryTime' => false,
    'Stocklevel' => 34,
    'IsDropshipping' => false,
    'MergeStockLevel' => false,
    'Comment' => 'A custom comment',
    'PackagingUnit' => 'box',
    'AmountPackagingUnit' => 1,
    'ScalePrices' => [
        [
                'FromQuantity' => 0,
                'PurchasePriceNet' => 94.21,
                'ReduceStandardPriceByPercent' => 5
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/items/{itemId}/suppliers"

	payload := strings.NewReader("{\n  \"SupplierId\": 123,\n  \"Sku\": \"ART2394871\",\n  \"ItemName\": \"Interdimensional Goggles\",\n  \"IsStandard\": false,\n  \"PurchasePriceNet\": 97.23,\n  \"TaxRate\": 19,\n  \"MinimumPurchaseQuantity\": 1,\n  \"PermissibleOrderQuantity\": 2,\n  \"DeliveryTime\": 2,\n  \"UseSupplierDeliveryTime\": false,\n  \"Stocklevel\": 34,\n  \"IsDropshipping\": false,\n  \"MergeStockLevel\": false,\n  \"Comment\": \"A custom comment\",\n  \"PackagingUnit\": \"box\",\n  \"AmountPackagingUnit\": 1,\n  \"ScalePrices\": [\n    {\n      \"FromQuantity\": 0,\n      \"PurchasePriceNet\": 94.21,\n      \"ReduceStandardPriceByPercent\": 5\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.jtl-cloud.com/erp/items/{itemId}/suppliers")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"SupplierId\": 123,\n  \"Sku\": \"ART2394871\",\n  \"ItemName\": \"Interdimensional Goggles\",\n  \"IsStandard\": false,\n  \"PurchasePriceNet\": 97.23,\n  \"TaxRate\": 19,\n  \"MinimumPurchaseQuantity\": 1,\n  \"PermissibleOrderQuantity\": 2,\n  \"DeliveryTime\": 2,\n  \"UseSupplierDeliveryTime\": false,\n  \"Stocklevel\": 34,\n  \"IsDropshipping\": false,\n  \"MergeStockLevel\": false,\n  \"Comment\": \"A custom comment\",\n  \"PackagingUnit\": \"box\",\n  \"AmountPackagingUnit\": 1,\n  \"ScalePrices\": [\n    {\n      \"FromQuantity\": 0,\n      \"PurchasePriceNet\": 94.21,\n      \"ReduceStandardPriceByPercent\": 5\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/items/{itemId}/suppliers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"SupplierId\": 123,\n  \"Sku\": \"ART2394871\",\n  \"ItemName\": \"Interdimensional Goggles\",\n  \"IsStandard\": false,\n  \"PurchasePriceNet\": 97.23,\n  \"TaxRate\": 19,\n  \"MinimumPurchaseQuantity\": 1,\n  \"PermissibleOrderQuantity\": 2,\n  \"DeliveryTime\": 2,\n  \"UseSupplierDeliveryTime\": false,\n  \"Stocklevel\": 34,\n  \"IsDropshipping\": false,\n  \"MergeStockLevel\": false,\n  \"Comment\": \"A custom comment\",\n  \"PackagingUnit\": \"box\",\n  \"AmountPackagingUnit\": 1,\n  \"ScalePrices\": [\n    {\n      \"FromQuantity\": 0,\n      \"PurchasePriceNet\": 94.21,\n      \"ReduceStandardPriceByPercent\": 5\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "ItemId": 123,
  "SupplierId": 123,
  "Sku": "ART2394871",
  "ItemName": "Interdimensional Goggles",
  "IsStandard": false,
  "PurchasePriceNet": 97.23,
  "TaxRate": 19,
  "MinimumPurchaseQuantity": 1,
  "PermissibleOrderQuantity": 2,
  "DeliveryTime": 2,
  "UseSupplierDeliveryTime": false,
  "Stocklevel": 34,
  "IsDropshipping": false,
  "MergeStockLevel": false,
  "Comment": "A custom comment",
  "PackagingUnit": "box",
  "AmountPackagingUnit": 1,
  "PackagingUnitPurchasePriceNet": 94.21,
  "ScalePrices": [
    {
      "FromQuantity": 0,
      "PurchasePriceNet": 94.21,
      "ReduceStandardPriceByPercent": 5
    }
  ]
}

{
  "ErrorCode": "<string>",
  "ValidationErrors": {},
  "Errors": {},
  "ErrorMessage": "<string>",
  "Stacktrace": "<string>"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-runas

string

The User-Id (int or uuid) on whose behalf the request is executed. Requires scope 'Application.RunAs'.

x-tenant-id

string<uuid>

required

The tenant ID for the target ERP instance.

Path Parameters

itemId

integer<int32>

required

Body

application/json

The itemSupplier to create.

Model Class: CreateItemSupplier

SupplierId

integer<int32>

required

Sku

string

Example:

"ART2394871"

ItemName

string

Example:

"Interdimensional Goggles"

IsStandard

boolean

Example:

false

PurchasePriceNet

number<decimal>

Example:

97.23

TaxRate

number<decimal>

Example:

19

MinimumPurchaseQuantity

number<decimal>

Example:

1

PermissibleOrderQuantity

number<decimal>

Example:

2

DeliveryTime

integer<int32>

Example:

2

UseSupplierDeliveryTime

boolean

Example:

false

Stocklevel

number<decimal>

Example:

34

IsDropshipping

boolean

Example:

false

MergeStockLevel

boolean

Example:

false

Comment

string

Example:

"A custom comment"

PackagingUnit

string

Example:

"box"

AmountPackagingUnit

number<decimal>

Example:

1

ScalePrices

object[]

Show child attributes

Response

The created itemSupplier.

Model Class: ItemSupplier

ItemId

integer<int32>

required

SupplierId

integer<int32>

required

Sku

string

required

Item SKU from the supplier.

Example:

"ART2394871"

ItemName

string

required

Item name from the supplier.

Example:

"Interdimensional Goggles"

IsStandard

boolean

required

Defines the main supplier for the given item.

Example:

false

PurchasePriceNet

number<decimal>

required

Net purchase price from the supplier.

Example:

97.23

TaxRate

number<decimal>

required

Percent of VAT tax rate.

Example:

19

MinimumPurchaseQuantity

number<decimal>

required

The minimum purchase quantity from the supplier.

Example:

1

PermissibleOrderQuantity

number<decimal>

required

The permissible order quantity for the item from the supplier. The increments in which the item can be sold.

Example:

2

DeliveryTime

integer<int32>

required

Delivery time in days.

Example:

2

UseSupplierDeliveryTime

boolean

required

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.

Example:

false

Stocklevel

number<decimal>

required

Stock level of the item at the supplier.

Example:

34

IsDropshipping

boolean

required

Activates drop shipping for a given item and supplier.

Example:

false

MergeStockLevel

boolean

required

Forces Wawi to add the supplier's stock to your own stock.

Example:

false

Comment

string

required

Comment for the supplier.

Example:

"A custom comment"

PackagingUnit

string

required

Name of the packaging unit.

Example:

"box"

AmountPackagingUnit

number<decimal>

required

Quantity in a packaging unit.

Example:

1

PackagingUnitPurchasePriceNet

number<decimal>

required

Net purchase price from the supplier for a packaging unit.

Example:

94.21

ScalePrices

object[]

required

Scale prices from this supplier for the item.

Show child attributes

Query Item Suppliers Delete Item Supplier

⌘I

Overview

REST API

Create Item Supplier

Authorizations

Headers

Path Parameters

Body

Response