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.
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/items/{itemId}/suppliers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"itemSupplier": {
"supplierId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierItemName": "<string>",
"supplierItemNumber": "<string>",
"stockLevel": 123,
"netPurchasePrice": 123,
"minimumPurchaseQuantity": 123,
"deliveryTimeInDays": 123,
"isDropshippingActive": true,
"packageUnitDescription": "<string>",
"packageUnitQuantity": 123,
"notes": "<string>",
"vatRate": 123,
"useSupplierDeliveryTime": true,
"includeSupplierStock": true,
"purchaseInterval": 123,
"scalePrices": [
{
"fromQuantity": 123,
"usePercentageDiscount": true,
"netPrice": 123,
"percentageDiscount": 123
}
]
}
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/items/{itemId}/suppliers"
payload = { "itemSupplier": {
"supplierId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierItemName": "<string>",
"supplierItemNumber": "<string>",
"stockLevel": 123,
"netPurchasePrice": 123,
"minimumPurchaseQuantity": 123,
"deliveryTimeInDays": 123,
"isDropshippingActive": True,
"packageUnitDescription": "<string>",
"packageUnitQuantity": 123,
"notes": "<string>",
"vatRate": 123,
"useSupplierDeliveryTime": True,
"includeSupplierStock": True,
"purchaseInterval": 123,
"scalePrices": [
{
"fromQuantity": 123,
"usePercentageDiscount": True,
"netPrice": 123,
"percentageDiscount": 123
}
]
} }
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({
itemSupplier: {
supplierId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
supplierItemName: '<string>',
supplierItemNumber: '<string>',
stockLevel: 123,
netPurchasePrice: 123,
minimumPurchaseQuantity: 123,
deliveryTimeInDays: 123,
isDropshippingActive: true,
packageUnitDescription: '<string>',
packageUnitQuantity: 123,
notes: '<string>',
vatRate: 123,
useSupplierDeliveryTime: true,
includeSupplierStock: true,
purchaseInterval: 123,
scalePrices: [
{
fromQuantity: 123,
usePercentageDiscount: true,
netPrice: 123,
percentageDiscount: 123
}
]
}
})
};
fetch('https://api.jtl-cloud.com/erp/v2/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/v2/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([
'itemSupplier' => [
'supplierId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'supplierItemName' => '<string>',
'supplierItemNumber' => '<string>',
'stockLevel' => 123,
'netPurchasePrice' => 123,
'minimumPurchaseQuantity' => 123,
'deliveryTimeInDays' => 123,
'isDropshippingActive' => true,
'packageUnitDescription' => '<string>',
'packageUnitQuantity' => 123,
'notes' => '<string>',
'vatRate' => 123,
'useSupplierDeliveryTime' => true,
'includeSupplierStock' => true,
'purchaseInterval' => 123,
'scalePrices' => [
[
'fromQuantity' => 123,
'usePercentageDiscount' => true,
'netPrice' => 123,
'percentageDiscount' => 123
]
]
]
]),
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/v2/items/{itemId}/suppliers"
payload := strings.NewReader("{\n \"itemSupplier\": {\n \"supplierId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierItemName\": \"<string>\",\n \"supplierItemNumber\": \"<string>\",\n \"stockLevel\": 123,\n \"netPurchasePrice\": 123,\n \"minimumPurchaseQuantity\": 123,\n \"deliveryTimeInDays\": 123,\n \"isDropshippingActive\": true,\n \"packageUnitDescription\": \"<string>\",\n \"packageUnitQuantity\": 123,\n \"notes\": \"<string>\",\n \"vatRate\": 123,\n \"useSupplierDeliveryTime\": true,\n \"includeSupplierStock\": true,\n \"purchaseInterval\": 123,\n \"scalePrices\": [\n {\n \"fromQuantity\": 123,\n \"usePercentageDiscount\": true,\n \"netPrice\": 123,\n \"percentageDiscount\": 123\n }\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/v2/items/{itemId}/suppliers")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"itemSupplier\": {\n \"supplierId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierItemName\": \"<string>\",\n \"supplierItemNumber\": \"<string>\",\n \"stockLevel\": 123,\n \"netPurchasePrice\": 123,\n \"minimumPurchaseQuantity\": 123,\n \"deliveryTimeInDays\": 123,\n \"isDropshippingActive\": true,\n \"packageUnitDescription\": \"<string>\",\n \"packageUnitQuantity\": 123,\n \"notes\": \"<string>\",\n \"vatRate\": 123,\n \"useSupplierDeliveryTime\": true,\n \"includeSupplierStock\": true,\n \"purchaseInterval\": 123,\n \"scalePrices\": [\n {\n \"fromQuantity\": 123,\n \"usePercentageDiscount\": true,\n \"netPrice\": 123,\n \"percentageDiscount\": 123\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/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 \"itemSupplier\": {\n \"supplierId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierItemName\": \"<string>\",\n \"supplierItemNumber\": \"<string>\",\n \"stockLevel\": 123,\n \"netPurchasePrice\": 123,\n \"minimumPurchaseQuantity\": 123,\n \"deliveryTimeInDays\": 123,\n \"isDropshippingActive\": true,\n \"packageUnitDescription\": \"<string>\",\n \"packageUnitQuantity\": 123,\n \"notes\": \"<string>\",\n \"vatRate\": 123,\n \"useSupplierDeliveryTime\": true,\n \"includeSupplierStock\": true,\n \"purchaseInterval\": 123,\n \"scalePrices\": [\n {\n \"fromQuantity\": 123,\n \"usePercentageDiscount\": true,\n \"netPrice\": 123,\n \"percentageDiscount\": 123\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}Item
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.
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
/
items
/
{itemId}
/
suppliers
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.
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/items/{itemId}/suppliers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"itemSupplier": {
"supplierId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierItemName": "<string>",
"supplierItemNumber": "<string>",
"stockLevel": 123,
"netPurchasePrice": 123,
"minimumPurchaseQuantity": 123,
"deliveryTimeInDays": 123,
"isDropshippingActive": true,
"packageUnitDescription": "<string>",
"packageUnitQuantity": 123,
"notes": "<string>",
"vatRate": 123,
"useSupplierDeliveryTime": true,
"includeSupplierStock": true,
"purchaseInterval": 123,
"scalePrices": [
{
"fromQuantity": 123,
"usePercentageDiscount": true,
"netPrice": 123,
"percentageDiscount": 123
}
]
}
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/items/{itemId}/suppliers"
payload = { "itemSupplier": {
"supplierId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"supplierItemName": "<string>",
"supplierItemNumber": "<string>",
"stockLevel": 123,
"netPurchasePrice": 123,
"minimumPurchaseQuantity": 123,
"deliveryTimeInDays": 123,
"isDropshippingActive": True,
"packageUnitDescription": "<string>",
"packageUnitQuantity": 123,
"notes": "<string>",
"vatRate": 123,
"useSupplierDeliveryTime": True,
"includeSupplierStock": True,
"purchaseInterval": 123,
"scalePrices": [
{
"fromQuantity": 123,
"usePercentageDiscount": True,
"netPrice": 123,
"percentageDiscount": 123
}
]
} }
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({
itemSupplier: {
supplierId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
supplierItemName: '<string>',
supplierItemNumber: '<string>',
stockLevel: 123,
netPurchasePrice: 123,
minimumPurchaseQuantity: 123,
deliveryTimeInDays: 123,
isDropshippingActive: true,
packageUnitDescription: '<string>',
packageUnitQuantity: 123,
notes: '<string>',
vatRate: 123,
useSupplierDeliveryTime: true,
includeSupplierStock: true,
purchaseInterval: 123,
scalePrices: [
{
fromQuantity: 123,
usePercentageDiscount: true,
netPrice: 123,
percentageDiscount: 123
}
]
}
})
};
fetch('https://api.jtl-cloud.com/erp/v2/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/v2/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([
'itemSupplier' => [
'supplierId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'supplierItemName' => '<string>',
'supplierItemNumber' => '<string>',
'stockLevel' => 123,
'netPurchasePrice' => 123,
'minimumPurchaseQuantity' => 123,
'deliveryTimeInDays' => 123,
'isDropshippingActive' => true,
'packageUnitDescription' => '<string>',
'packageUnitQuantity' => 123,
'notes' => '<string>',
'vatRate' => 123,
'useSupplierDeliveryTime' => true,
'includeSupplierStock' => true,
'purchaseInterval' => 123,
'scalePrices' => [
[
'fromQuantity' => 123,
'usePercentageDiscount' => true,
'netPrice' => 123,
'percentageDiscount' => 123
]
]
]
]),
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/v2/items/{itemId}/suppliers"
payload := strings.NewReader("{\n \"itemSupplier\": {\n \"supplierId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierItemName\": \"<string>\",\n \"supplierItemNumber\": \"<string>\",\n \"stockLevel\": 123,\n \"netPurchasePrice\": 123,\n \"minimumPurchaseQuantity\": 123,\n \"deliveryTimeInDays\": 123,\n \"isDropshippingActive\": true,\n \"packageUnitDescription\": \"<string>\",\n \"packageUnitQuantity\": 123,\n \"notes\": \"<string>\",\n \"vatRate\": 123,\n \"useSupplierDeliveryTime\": true,\n \"includeSupplierStock\": true,\n \"purchaseInterval\": 123,\n \"scalePrices\": [\n {\n \"fromQuantity\": 123,\n \"usePercentageDiscount\": true,\n \"netPrice\": 123,\n \"percentageDiscount\": 123\n }\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/v2/items/{itemId}/suppliers")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"itemSupplier\": {\n \"supplierId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierItemName\": \"<string>\",\n \"supplierItemNumber\": \"<string>\",\n \"stockLevel\": 123,\n \"netPurchasePrice\": 123,\n \"minimumPurchaseQuantity\": 123,\n \"deliveryTimeInDays\": 123,\n \"isDropshippingActive\": true,\n \"packageUnitDescription\": \"<string>\",\n \"packageUnitQuantity\": 123,\n \"notes\": \"<string>\",\n \"vatRate\": 123,\n \"useSupplierDeliveryTime\": true,\n \"includeSupplierStock\": true,\n \"purchaseInterval\": 123,\n \"scalePrices\": [\n {\n \"fromQuantity\": 123,\n \"usePercentageDiscount\": true,\n \"netPrice\": 123,\n \"percentageDiscount\": 123\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/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 \"itemSupplier\": {\n \"supplierId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"supplierItemName\": \"<string>\",\n \"supplierItemNumber\": \"<string>\",\n \"stockLevel\": 123,\n \"netPurchasePrice\": 123,\n \"minimumPurchaseQuantity\": 123,\n \"deliveryTimeInDays\": 123,\n \"isDropshippingActive\": true,\n \"packageUnitDescription\": \"<string>\",\n \"packageUnitQuantity\": 123,\n \"notes\": \"<string>\",\n \"vatRate\": 123,\n \"useSupplierDeliveryTime\": true,\n \"includeSupplierStock\": true,\n \"purchaseInterval\": 123,\n \"scalePrices\": [\n {\n \"fromQuantity\": 123,\n \"usePercentageDiscount\": true,\n \"netPrice\": 123,\n \"percentageDiscount\": 123\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}Authorizations
oauth2-authorization-codeoauth2-client-credentials
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
The Company-Id (int or uuid) of the company on whose behalf the request is executed.
Optional, client-generated key for deduplicating repeated write requests. A repeated request with the same key returns the originally recorded result instead of executing the effect again.
Required string length:
1 - 255The tenant ID for the target ERP instance.
Path Parameters
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Body
application/json
Request parameters
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
Supplier information to be added to the item.
Show child attributes
Show child attributes
Response
Supplier was successfully added to the item.
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. - Response
Unique ID of the modified item.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Was this page helpful?
⌘I