Create Item
curl --request POST \
--url https://api.jtl-cloud.com/erp/v1/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"Categories": [
{
"CategoryId": 123
}
],
"Name": "<string>",
"SKU": "<string>",
"ManufacturerId": 123,
"ResponsiblePersonId": 123,
"Description": "<string>",
"ShortDescription": "<string>",
"Identifiers": {
"Gtin": "<string>",
"ManufacturerNumber": "<string>",
"ISBN": "<string>",
"UPC": "<string>",
"AmazonFnsku": "<string>",
"Asins": [
"<string>"
],
"OwnIdentifier": "<string>"
},
"Components": [
{
"ItemId": 123,
"Quantity": 123,
"SortNumber": 123
}
],
"ItemPriceData": {
"SalesPriceNet": 123,
"SuggestedRetailPrice": 123,
"PurchasePriceNet": 123,
"EbayPrice": 123,
"AmazonPrice": 123
},
"ActiveSalesChannels": [
"<string>"
],
"SortNumber": 123,
"Annotation": "<string>",
"ReleasedOnDate": "2023-11-07T05:31:56Z",
"StorageOptions": {
"InventoryManagementActive": true,
"SplitQuantity": true,
"GlobalMinimumStockLevel": 123,
"Buffer": 123,
"SerialNumberItem": true,
"SerialNumberTracking": true,
"SubjectToShelfLifeExpirationDate": true,
"SubjectToBatchItem": true,
"ProcurementTime": 123,
"DetermineProcurementTimeAutomatically": true,
"AdditionalHandlingTime": 123
},
"CountryOfOrigin": "<string>",
"ConditionId": 123,
"ShippingClassId": 123,
"ProductGroupId": 123,
"TaxClassId": 123,
"Dimensions": {
"Length": 123,
"Width": 123,
"Height": 123
},
"Weights": {
"ItemWeigth": 123,
"ShippingWeight": 123
},
"AllowNegativeStock": true,
"Quantities": {
"MinimumOrderQuantity": 123,
"MinimumPurchaseQuantityForCustomerGroup": [
{
"CustomerGroupId": 123,
"PermissibleOrderQuantity": 123,
"MinimumPurchaseQuantity": 123,
"IsActive": true
}
],
"PermissibleOrderQuantity": 123
},
"DangerousGoods": {
"UnNumber": "<string>",
"HazardNo": "<string>"
},
"Taric": "<string>",
"SearchTerms": "<string>",
"PriceListActive": true,
"IgnoreDiscounts": true,
"AvailabilityId": 123
}
'import requests
url = "https://api.jtl-cloud.com/erp/v1/items"
payload = {
"Categories": [{ "CategoryId": 123 }],
"Name": "<string>",
"SKU": "<string>",
"ManufacturerId": 123,
"ResponsiblePersonId": 123,
"Description": "<string>",
"ShortDescription": "<string>",
"Identifiers": {
"Gtin": "<string>",
"ManufacturerNumber": "<string>",
"ISBN": "<string>",
"UPC": "<string>",
"AmazonFnsku": "<string>",
"Asins": ["<string>"],
"OwnIdentifier": "<string>"
},
"Components": [
{
"ItemId": 123,
"Quantity": 123,
"SortNumber": 123
}
],
"ItemPriceData": {
"SalesPriceNet": 123,
"SuggestedRetailPrice": 123,
"PurchasePriceNet": 123,
"EbayPrice": 123,
"AmazonPrice": 123
},
"ActiveSalesChannels": ["<string>"],
"SortNumber": 123,
"Annotation": "<string>",
"ReleasedOnDate": "2023-11-07T05:31:56Z",
"StorageOptions": {
"InventoryManagementActive": True,
"SplitQuantity": True,
"GlobalMinimumStockLevel": 123,
"Buffer": 123,
"SerialNumberItem": True,
"SerialNumberTracking": True,
"SubjectToShelfLifeExpirationDate": True,
"SubjectToBatchItem": True,
"ProcurementTime": 123,
"DetermineProcurementTimeAutomatically": True,
"AdditionalHandlingTime": 123
},
"CountryOfOrigin": "<string>",
"ConditionId": 123,
"ShippingClassId": 123,
"ProductGroupId": 123,
"TaxClassId": 123,
"Dimensions": {
"Length": 123,
"Width": 123,
"Height": 123
},
"Weights": {
"ItemWeigth": 123,
"ShippingWeight": 123
},
"AllowNegativeStock": True,
"Quantities": {
"MinimumOrderQuantity": 123,
"MinimumPurchaseQuantityForCustomerGroup": [
{
"CustomerGroupId": 123,
"PermissibleOrderQuantity": 123,
"MinimumPurchaseQuantity": 123,
"IsActive": True
}
],
"PermissibleOrderQuantity": 123
},
"DangerousGoods": {
"UnNumber": "<string>",
"HazardNo": "<string>"
},
"Taric": "<string>",
"SearchTerms": "<string>",
"PriceListActive": True,
"IgnoreDiscounts": True,
"AvailabilityId": 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({
Categories: [{CategoryId: 123}],
Name: '<string>',
SKU: '<string>',
ManufacturerId: 123,
ResponsiblePersonId: 123,
Description: '<string>',
ShortDescription: '<string>',
Identifiers: {
Gtin: '<string>',
ManufacturerNumber: '<string>',
ISBN: '<string>',
UPC: '<string>',
AmazonFnsku: '<string>',
Asins: ['<string>'],
OwnIdentifier: '<string>'
},
Components: [{ItemId: 123, Quantity: 123, SortNumber: 123}],
ItemPriceData: {
SalesPriceNet: 123,
SuggestedRetailPrice: 123,
PurchasePriceNet: 123,
EbayPrice: 123,
AmazonPrice: 123
},
ActiveSalesChannels: ['<string>'],
SortNumber: 123,
Annotation: '<string>',
ReleasedOnDate: '2023-11-07T05:31:56Z',
StorageOptions: {
InventoryManagementActive: true,
SplitQuantity: true,
GlobalMinimumStockLevel: 123,
Buffer: 123,
SerialNumberItem: true,
SerialNumberTracking: true,
SubjectToShelfLifeExpirationDate: true,
SubjectToBatchItem: true,
ProcurementTime: 123,
DetermineProcurementTimeAutomatically: true,
AdditionalHandlingTime: 123
},
CountryOfOrigin: '<string>',
ConditionId: 123,
ShippingClassId: 123,
ProductGroupId: 123,
TaxClassId: 123,
Dimensions: {Length: 123, Width: 123, Height: 123},
Weights: {ItemWeigth: 123, ShippingWeight: 123},
AllowNegativeStock: true,
Quantities: {
MinimumOrderQuantity: 123,
MinimumPurchaseQuantityForCustomerGroup: [
{
CustomerGroupId: 123,
PermissibleOrderQuantity: 123,
MinimumPurchaseQuantity: 123,
IsActive: true
}
],
PermissibleOrderQuantity: 123
},
DangerousGoods: {UnNumber: '<string>', HazardNo: '<string>'},
Taric: '<string>',
SearchTerms: '<string>',
PriceListActive: true,
IgnoreDiscounts: true,
AvailabilityId: 123
})
};
fetch('https://api.jtl-cloud.com/erp/v1/items', 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/v1/items",
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([
'Categories' => [
[
'CategoryId' => 123
]
],
'Name' => '<string>',
'SKU' => '<string>',
'ManufacturerId' => 123,
'ResponsiblePersonId' => 123,
'Description' => '<string>',
'ShortDescription' => '<string>',
'Identifiers' => [
'Gtin' => '<string>',
'ManufacturerNumber' => '<string>',
'ISBN' => '<string>',
'UPC' => '<string>',
'AmazonFnsku' => '<string>',
'Asins' => [
'<string>'
],
'OwnIdentifier' => '<string>'
],
'Components' => [
[
'ItemId' => 123,
'Quantity' => 123,
'SortNumber' => 123
]
],
'ItemPriceData' => [
'SalesPriceNet' => 123,
'SuggestedRetailPrice' => 123,
'PurchasePriceNet' => 123,
'EbayPrice' => 123,
'AmazonPrice' => 123
],
'ActiveSalesChannels' => [
'<string>'
],
'SortNumber' => 123,
'Annotation' => '<string>',
'ReleasedOnDate' => '2023-11-07T05:31:56Z',
'StorageOptions' => [
'InventoryManagementActive' => true,
'SplitQuantity' => true,
'GlobalMinimumStockLevel' => 123,
'Buffer' => 123,
'SerialNumberItem' => true,
'SerialNumberTracking' => true,
'SubjectToShelfLifeExpirationDate' => true,
'SubjectToBatchItem' => true,
'ProcurementTime' => 123,
'DetermineProcurementTimeAutomatically' => true,
'AdditionalHandlingTime' => 123
],
'CountryOfOrigin' => '<string>',
'ConditionId' => 123,
'ShippingClassId' => 123,
'ProductGroupId' => 123,
'TaxClassId' => 123,
'Dimensions' => [
'Length' => 123,
'Width' => 123,
'Height' => 123
],
'Weights' => [
'ItemWeigth' => 123,
'ShippingWeight' => 123
],
'AllowNegativeStock' => true,
'Quantities' => [
'MinimumOrderQuantity' => 123,
'MinimumPurchaseQuantityForCustomerGroup' => [
[
'CustomerGroupId' => 123,
'PermissibleOrderQuantity' => 123,
'MinimumPurchaseQuantity' => 123,
'IsActive' => true
]
],
'PermissibleOrderQuantity' => 123
],
'DangerousGoods' => [
'UnNumber' => '<string>',
'HazardNo' => '<string>'
],
'Taric' => '<string>',
'SearchTerms' => '<string>',
'PriceListActive' => true,
'IgnoreDiscounts' => true,
'AvailabilityId' => 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/v1/items"
payload := strings.NewReader("{\n \"Categories\": [\n {\n \"CategoryId\": 123\n }\n ],\n \"Name\": \"<string>\",\n \"SKU\": \"<string>\",\n \"ManufacturerId\": 123,\n \"ResponsiblePersonId\": 123,\n \"Description\": \"<string>\",\n \"ShortDescription\": \"<string>\",\n \"Identifiers\": {\n \"Gtin\": \"<string>\",\n \"ManufacturerNumber\": \"<string>\",\n \"ISBN\": \"<string>\",\n \"UPC\": \"<string>\",\n \"AmazonFnsku\": \"<string>\",\n \"Asins\": [\n \"<string>\"\n ],\n \"OwnIdentifier\": \"<string>\"\n },\n \"Components\": [\n {\n \"ItemId\": 123,\n \"Quantity\": 123,\n \"SortNumber\": 123\n }\n ],\n \"ItemPriceData\": {\n \"SalesPriceNet\": 123,\n \"SuggestedRetailPrice\": 123,\n \"PurchasePriceNet\": 123,\n \"EbayPrice\": 123,\n \"AmazonPrice\": 123\n },\n \"ActiveSalesChannels\": [\n \"<string>\"\n ],\n \"SortNumber\": 123,\n \"Annotation\": \"<string>\",\n \"ReleasedOnDate\": \"2023-11-07T05:31:56Z\",\n \"StorageOptions\": {\n \"InventoryManagementActive\": true,\n \"SplitQuantity\": true,\n \"GlobalMinimumStockLevel\": 123,\n \"Buffer\": 123,\n \"SerialNumberItem\": true,\n \"SerialNumberTracking\": true,\n \"SubjectToShelfLifeExpirationDate\": true,\n \"SubjectToBatchItem\": true,\n \"ProcurementTime\": 123,\n \"DetermineProcurementTimeAutomatically\": true,\n \"AdditionalHandlingTime\": 123\n },\n \"CountryOfOrigin\": \"<string>\",\n \"ConditionId\": 123,\n \"ShippingClassId\": 123,\n \"ProductGroupId\": 123,\n \"TaxClassId\": 123,\n \"Dimensions\": {\n \"Length\": 123,\n \"Width\": 123,\n \"Height\": 123\n },\n \"Weights\": {\n \"ItemWeigth\": 123,\n \"ShippingWeight\": 123\n },\n \"AllowNegativeStock\": true,\n \"Quantities\": {\n \"MinimumOrderQuantity\": 123,\n \"MinimumPurchaseQuantityForCustomerGroup\": [\n {\n \"CustomerGroupId\": 123,\n \"PermissibleOrderQuantity\": 123,\n \"MinimumPurchaseQuantity\": 123,\n \"IsActive\": true\n }\n ],\n \"PermissibleOrderQuantity\": 123\n },\n \"DangerousGoods\": {\n \"UnNumber\": \"<string>\",\n \"HazardNo\": \"<string>\"\n },\n \"Taric\": \"<string>\",\n \"SearchTerms\": \"<string>\",\n \"PriceListActive\": true,\n \"IgnoreDiscounts\": true,\n \"AvailabilityId\": 123\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/v1/items")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"Categories\": [\n {\n \"CategoryId\": 123\n }\n ],\n \"Name\": \"<string>\",\n \"SKU\": \"<string>\",\n \"ManufacturerId\": 123,\n \"ResponsiblePersonId\": 123,\n \"Description\": \"<string>\",\n \"ShortDescription\": \"<string>\",\n \"Identifiers\": {\n \"Gtin\": \"<string>\",\n \"ManufacturerNumber\": \"<string>\",\n \"ISBN\": \"<string>\",\n \"UPC\": \"<string>\",\n \"AmazonFnsku\": \"<string>\",\n \"Asins\": [\n \"<string>\"\n ],\n \"OwnIdentifier\": \"<string>\"\n },\n \"Components\": [\n {\n \"ItemId\": 123,\n \"Quantity\": 123,\n \"SortNumber\": 123\n }\n ],\n \"ItemPriceData\": {\n \"SalesPriceNet\": 123,\n \"SuggestedRetailPrice\": 123,\n \"PurchasePriceNet\": 123,\n \"EbayPrice\": 123,\n \"AmazonPrice\": 123\n },\n \"ActiveSalesChannels\": [\n \"<string>\"\n ],\n \"SortNumber\": 123,\n \"Annotation\": \"<string>\",\n \"ReleasedOnDate\": \"2023-11-07T05:31:56Z\",\n \"StorageOptions\": {\n \"InventoryManagementActive\": true,\n \"SplitQuantity\": true,\n \"GlobalMinimumStockLevel\": 123,\n \"Buffer\": 123,\n \"SerialNumberItem\": true,\n \"SerialNumberTracking\": true,\n \"SubjectToShelfLifeExpirationDate\": true,\n \"SubjectToBatchItem\": true,\n \"ProcurementTime\": 123,\n \"DetermineProcurementTimeAutomatically\": true,\n \"AdditionalHandlingTime\": 123\n },\n \"CountryOfOrigin\": \"<string>\",\n \"ConditionId\": 123,\n \"ShippingClassId\": 123,\n \"ProductGroupId\": 123,\n \"TaxClassId\": 123,\n \"Dimensions\": {\n \"Length\": 123,\n \"Width\": 123,\n \"Height\": 123\n },\n \"Weights\": {\n \"ItemWeigth\": 123,\n \"ShippingWeight\": 123\n },\n \"AllowNegativeStock\": true,\n \"Quantities\": {\n \"MinimumOrderQuantity\": 123,\n \"MinimumPurchaseQuantityForCustomerGroup\": [\n {\n \"CustomerGroupId\": 123,\n \"PermissibleOrderQuantity\": 123,\n \"MinimumPurchaseQuantity\": 123,\n \"IsActive\": true\n }\n ],\n \"PermissibleOrderQuantity\": 123\n },\n \"DangerousGoods\": {\n \"UnNumber\": \"<string>\",\n \"HazardNo\": \"<string>\"\n },\n \"Taric\": \"<string>\",\n \"SearchTerms\": \"<string>\",\n \"PriceListActive\": true,\n \"IgnoreDiscounts\": true,\n \"AvailabilityId\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v1/items")
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 \"Categories\": [\n {\n \"CategoryId\": 123\n }\n ],\n \"Name\": \"<string>\",\n \"SKU\": \"<string>\",\n \"ManufacturerId\": 123,\n \"ResponsiblePersonId\": 123,\n \"Description\": \"<string>\",\n \"ShortDescription\": \"<string>\",\n \"Identifiers\": {\n \"Gtin\": \"<string>\",\n \"ManufacturerNumber\": \"<string>\",\n \"ISBN\": \"<string>\",\n \"UPC\": \"<string>\",\n \"AmazonFnsku\": \"<string>\",\n \"Asins\": [\n \"<string>\"\n ],\n \"OwnIdentifier\": \"<string>\"\n },\n \"Components\": [\n {\n \"ItemId\": 123,\n \"Quantity\": 123,\n \"SortNumber\": 123\n }\n ],\n \"ItemPriceData\": {\n \"SalesPriceNet\": 123,\n \"SuggestedRetailPrice\": 123,\n \"PurchasePriceNet\": 123,\n \"EbayPrice\": 123,\n \"AmazonPrice\": 123\n },\n \"ActiveSalesChannels\": [\n \"<string>\"\n ],\n \"SortNumber\": 123,\n \"Annotation\": \"<string>\",\n \"ReleasedOnDate\": \"2023-11-07T05:31:56Z\",\n \"StorageOptions\": {\n \"InventoryManagementActive\": true,\n \"SplitQuantity\": true,\n \"GlobalMinimumStockLevel\": 123,\n \"Buffer\": 123,\n \"SerialNumberItem\": true,\n \"SerialNumberTracking\": true,\n \"SubjectToShelfLifeExpirationDate\": true,\n \"SubjectToBatchItem\": true,\n \"ProcurementTime\": 123,\n \"DetermineProcurementTimeAutomatically\": true,\n \"AdditionalHandlingTime\": 123\n },\n \"CountryOfOrigin\": \"<string>\",\n \"ConditionId\": 123,\n \"ShippingClassId\": 123,\n \"ProductGroupId\": 123,\n \"TaxClassId\": 123,\n \"Dimensions\": {\n \"Length\": 123,\n \"Width\": 123,\n \"Height\": 123\n },\n \"Weights\": {\n \"ItemWeigth\": 123,\n \"ShippingWeight\": 123\n },\n \"AllowNegativeStock\": true,\n \"Quantities\": {\n \"MinimumOrderQuantity\": 123,\n \"MinimumPurchaseQuantityForCustomerGroup\": [\n {\n \"CustomerGroupId\": 123,\n \"PermissibleOrderQuantity\": 123,\n \"MinimumPurchaseQuantity\": 123,\n \"IsActive\": true\n }\n ],\n \"PermissibleOrderQuantity\": 123\n },\n \"DangerousGoods\": {\n \"UnNumber\": \"<string>\",\n \"HazardNo\": \"<string>\"\n },\n \"Taric\": \"<string>\",\n \"SearchTerms\": \"<string>\",\n \"PriceListActive\": true,\n \"IgnoreDiscounts\": true,\n \"AvailabilityId\": 123\n}"
response = http.request(request)
puts response.read_body{
"Id": 123,
"SKU": "<string>",
"ManufacturerId": 123,
"ResponsiblePersonId": 123,
"IsActive": true,
"Categories": [
{
"CategoryId": 123,
"Name": "<string>"
}
],
"Name": "<string>",
"Description": "<string>",
"ShortDescription": "<string>",
"Identifiers": {
"Gtin": "<string>",
"ManufacturerNumber": "<string>",
"ISBN": "<string>",
"UPC": "<string>",
"AmazonFnsku": "<string>",
"Asins": [
"<string>"
],
"OwnIdentifier": "<string>"
},
"Components": [
{
"ItemId": 123,
"Quantity": 123,
"SortNumber": 123
}
],
"ChildItems": [
123
],
"ParentItemId": 123,
"ItemPriceData": {
"SalesPriceNet": 123,
"SuggestedRetailPrice": 123,
"PurchasePriceNet": 123,
"EbayPrice": 123,
"AmazonPrice": 123
},
"ActiveSalesChannels": [
"<string>"
],
"SortNumber": 123,
"Annotation": "<string>",
"Added": "2023-11-07T05:31:56Z",
"Changed": "2023-11-07T05:31:56Z",
"ReleasedOnDate": "2023-11-07T05:31:56Z",
"StorageOptions": {
"InventoryManagementActive": true,
"SplitQuantity": true,
"GlobalMinimumStockLevel": 123,
"Buffer": 123,
"SerialNumberItem": true,
"SerialNumberTracking": true,
"SubjectToShelfLifeExpirationDate": true,
"SubjectToBatchItem": true,
"ProcurementTime": 123,
"DetermineProcurementTimeAutomatically": true,
"AdditionalHandlingTime": 123
},
"CountryOfOrigin": "<string>",
"ConditionId": 123,
"ShippingClassId": 123,
"ProductGroupId": 123,
"TaxClassId": 123,
"Dimensions": {
"Length": 123,
"Width": 123,
"Height": 123
},
"Weights": {
"ItemWeigth": 123,
"ShippingWeight": 123
},
"AllowNegativeStock": true,
"Quantities": {
"MinimumOrderQuantity": 123,
"MinimumPurchaseQuantityForCustomerGroup": [
{
"CustomerGroupId": 123,
"PermissibleOrderQuantity": 123,
"MinimumPurchaseQuantity": 123,
"IsActive": true
}
],
"PermissibleOrderQuantity": 123
},
"DangerousGoods": {
"UnNumber": "<string>",
"HazardNo": "<string>"
},
"Taric": "<string>",
"SearchTerms": "<string>",
"PriceListActive": true,
"IgnoreDiscounts": true,
"AvailabilityId": 123
}{
"ErrorCode": "<string>",
"ValidationErrors": {},
"Errors": {},
"ErrorMessage": "<string>",
"Stacktrace": "<string>"
}Item
Create Item
deprecated
Create a new item
POST
/
v1
/
items
Create Item
curl --request POST \
--url https://api.jtl-cloud.com/erp/v1/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"Categories": [
{
"CategoryId": 123
}
],
"Name": "<string>",
"SKU": "<string>",
"ManufacturerId": 123,
"ResponsiblePersonId": 123,
"Description": "<string>",
"ShortDescription": "<string>",
"Identifiers": {
"Gtin": "<string>",
"ManufacturerNumber": "<string>",
"ISBN": "<string>",
"UPC": "<string>",
"AmazonFnsku": "<string>",
"Asins": [
"<string>"
],
"OwnIdentifier": "<string>"
},
"Components": [
{
"ItemId": 123,
"Quantity": 123,
"SortNumber": 123
}
],
"ItemPriceData": {
"SalesPriceNet": 123,
"SuggestedRetailPrice": 123,
"PurchasePriceNet": 123,
"EbayPrice": 123,
"AmazonPrice": 123
},
"ActiveSalesChannels": [
"<string>"
],
"SortNumber": 123,
"Annotation": "<string>",
"ReleasedOnDate": "2023-11-07T05:31:56Z",
"StorageOptions": {
"InventoryManagementActive": true,
"SplitQuantity": true,
"GlobalMinimumStockLevel": 123,
"Buffer": 123,
"SerialNumberItem": true,
"SerialNumberTracking": true,
"SubjectToShelfLifeExpirationDate": true,
"SubjectToBatchItem": true,
"ProcurementTime": 123,
"DetermineProcurementTimeAutomatically": true,
"AdditionalHandlingTime": 123
},
"CountryOfOrigin": "<string>",
"ConditionId": 123,
"ShippingClassId": 123,
"ProductGroupId": 123,
"TaxClassId": 123,
"Dimensions": {
"Length": 123,
"Width": 123,
"Height": 123
},
"Weights": {
"ItemWeigth": 123,
"ShippingWeight": 123
},
"AllowNegativeStock": true,
"Quantities": {
"MinimumOrderQuantity": 123,
"MinimumPurchaseQuantityForCustomerGroup": [
{
"CustomerGroupId": 123,
"PermissibleOrderQuantity": 123,
"MinimumPurchaseQuantity": 123,
"IsActive": true
}
],
"PermissibleOrderQuantity": 123
},
"DangerousGoods": {
"UnNumber": "<string>",
"HazardNo": "<string>"
},
"Taric": "<string>",
"SearchTerms": "<string>",
"PriceListActive": true,
"IgnoreDiscounts": true,
"AvailabilityId": 123
}
'import requests
url = "https://api.jtl-cloud.com/erp/v1/items"
payload = {
"Categories": [{ "CategoryId": 123 }],
"Name": "<string>",
"SKU": "<string>",
"ManufacturerId": 123,
"ResponsiblePersonId": 123,
"Description": "<string>",
"ShortDescription": "<string>",
"Identifiers": {
"Gtin": "<string>",
"ManufacturerNumber": "<string>",
"ISBN": "<string>",
"UPC": "<string>",
"AmazonFnsku": "<string>",
"Asins": ["<string>"],
"OwnIdentifier": "<string>"
},
"Components": [
{
"ItemId": 123,
"Quantity": 123,
"SortNumber": 123
}
],
"ItemPriceData": {
"SalesPriceNet": 123,
"SuggestedRetailPrice": 123,
"PurchasePriceNet": 123,
"EbayPrice": 123,
"AmazonPrice": 123
},
"ActiveSalesChannels": ["<string>"],
"SortNumber": 123,
"Annotation": "<string>",
"ReleasedOnDate": "2023-11-07T05:31:56Z",
"StorageOptions": {
"InventoryManagementActive": True,
"SplitQuantity": True,
"GlobalMinimumStockLevel": 123,
"Buffer": 123,
"SerialNumberItem": True,
"SerialNumberTracking": True,
"SubjectToShelfLifeExpirationDate": True,
"SubjectToBatchItem": True,
"ProcurementTime": 123,
"DetermineProcurementTimeAutomatically": True,
"AdditionalHandlingTime": 123
},
"CountryOfOrigin": "<string>",
"ConditionId": 123,
"ShippingClassId": 123,
"ProductGroupId": 123,
"TaxClassId": 123,
"Dimensions": {
"Length": 123,
"Width": 123,
"Height": 123
},
"Weights": {
"ItemWeigth": 123,
"ShippingWeight": 123
},
"AllowNegativeStock": True,
"Quantities": {
"MinimumOrderQuantity": 123,
"MinimumPurchaseQuantityForCustomerGroup": [
{
"CustomerGroupId": 123,
"PermissibleOrderQuantity": 123,
"MinimumPurchaseQuantity": 123,
"IsActive": True
}
],
"PermissibleOrderQuantity": 123
},
"DangerousGoods": {
"UnNumber": "<string>",
"HazardNo": "<string>"
},
"Taric": "<string>",
"SearchTerms": "<string>",
"PriceListActive": True,
"IgnoreDiscounts": True,
"AvailabilityId": 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({
Categories: [{CategoryId: 123}],
Name: '<string>',
SKU: '<string>',
ManufacturerId: 123,
ResponsiblePersonId: 123,
Description: '<string>',
ShortDescription: '<string>',
Identifiers: {
Gtin: '<string>',
ManufacturerNumber: '<string>',
ISBN: '<string>',
UPC: '<string>',
AmazonFnsku: '<string>',
Asins: ['<string>'],
OwnIdentifier: '<string>'
},
Components: [{ItemId: 123, Quantity: 123, SortNumber: 123}],
ItemPriceData: {
SalesPriceNet: 123,
SuggestedRetailPrice: 123,
PurchasePriceNet: 123,
EbayPrice: 123,
AmazonPrice: 123
},
ActiveSalesChannels: ['<string>'],
SortNumber: 123,
Annotation: '<string>',
ReleasedOnDate: '2023-11-07T05:31:56Z',
StorageOptions: {
InventoryManagementActive: true,
SplitQuantity: true,
GlobalMinimumStockLevel: 123,
Buffer: 123,
SerialNumberItem: true,
SerialNumberTracking: true,
SubjectToShelfLifeExpirationDate: true,
SubjectToBatchItem: true,
ProcurementTime: 123,
DetermineProcurementTimeAutomatically: true,
AdditionalHandlingTime: 123
},
CountryOfOrigin: '<string>',
ConditionId: 123,
ShippingClassId: 123,
ProductGroupId: 123,
TaxClassId: 123,
Dimensions: {Length: 123, Width: 123, Height: 123},
Weights: {ItemWeigth: 123, ShippingWeight: 123},
AllowNegativeStock: true,
Quantities: {
MinimumOrderQuantity: 123,
MinimumPurchaseQuantityForCustomerGroup: [
{
CustomerGroupId: 123,
PermissibleOrderQuantity: 123,
MinimumPurchaseQuantity: 123,
IsActive: true
}
],
PermissibleOrderQuantity: 123
},
DangerousGoods: {UnNumber: '<string>', HazardNo: '<string>'},
Taric: '<string>',
SearchTerms: '<string>',
PriceListActive: true,
IgnoreDiscounts: true,
AvailabilityId: 123
})
};
fetch('https://api.jtl-cloud.com/erp/v1/items', 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/v1/items",
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([
'Categories' => [
[
'CategoryId' => 123
]
],
'Name' => '<string>',
'SKU' => '<string>',
'ManufacturerId' => 123,
'ResponsiblePersonId' => 123,
'Description' => '<string>',
'ShortDescription' => '<string>',
'Identifiers' => [
'Gtin' => '<string>',
'ManufacturerNumber' => '<string>',
'ISBN' => '<string>',
'UPC' => '<string>',
'AmazonFnsku' => '<string>',
'Asins' => [
'<string>'
],
'OwnIdentifier' => '<string>'
],
'Components' => [
[
'ItemId' => 123,
'Quantity' => 123,
'SortNumber' => 123
]
],
'ItemPriceData' => [
'SalesPriceNet' => 123,
'SuggestedRetailPrice' => 123,
'PurchasePriceNet' => 123,
'EbayPrice' => 123,
'AmazonPrice' => 123
],
'ActiveSalesChannels' => [
'<string>'
],
'SortNumber' => 123,
'Annotation' => '<string>',
'ReleasedOnDate' => '2023-11-07T05:31:56Z',
'StorageOptions' => [
'InventoryManagementActive' => true,
'SplitQuantity' => true,
'GlobalMinimumStockLevel' => 123,
'Buffer' => 123,
'SerialNumberItem' => true,
'SerialNumberTracking' => true,
'SubjectToShelfLifeExpirationDate' => true,
'SubjectToBatchItem' => true,
'ProcurementTime' => 123,
'DetermineProcurementTimeAutomatically' => true,
'AdditionalHandlingTime' => 123
],
'CountryOfOrigin' => '<string>',
'ConditionId' => 123,
'ShippingClassId' => 123,
'ProductGroupId' => 123,
'TaxClassId' => 123,
'Dimensions' => [
'Length' => 123,
'Width' => 123,
'Height' => 123
],
'Weights' => [
'ItemWeigth' => 123,
'ShippingWeight' => 123
],
'AllowNegativeStock' => true,
'Quantities' => [
'MinimumOrderQuantity' => 123,
'MinimumPurchaseQuantityForCustomerGroup' => [
[
'CustomerGroupId' => 123,
'PermissibleOrderQuantity' => 123,
'MinimumPurchaseQuantity' => 123,
'IsActive' => true
]
],
'PermissibleOrderQuantity' => 123
],
'DangerousGoods' => [
'UnNumber' => '<string>',
'HazardNo' => '<string>'
],
'Taric' => '<string>',
'SearchTerms' => '<string>',
'PriceListActive' => true,
'IgnoreDiscounts' => true,
'AvailabilityId' => 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/v1/items"
payload := strings.NewReader("{\n \"Categories\": [\n {\n \"CategoryId\": 123\n }\n ],\n \"Name\": \"<string>\",\n \"SKU\": \"<string>\",\n \"ManufacturerId\": 123,\n \"ResponsiblePersonId\": 123,\n \"Description\": \"<string>\",\n \"ShortDescription\": \"<string>\",\n \"Identifiers\": {\n \"Gtin\": \"<string>\",\n \"ManufacturerNumber\": \"<string>\",\n \"ISBN\": \"<string>\",\n \"UPC\": \"<string>\",\n \"AmazonFnsku\": \"<string>\",\n \"Asins\": [\n \"<string>\"\n ],\n \"OwnIdentifier\": \"<string>\"\n },\n \"Components\": [\n {\n \"ItemId\": 123,\n \"Quantity\": 123,\n \"SortNumber\": 123\n }\n ],\n \"ItemPriceData\": {\n \"SalesPriceNet\": 123,\n \"SuggestedRetailPrice\": 123,\n \"PurchasePriceNet\": 123,\n \"EbayPrice\": 123,\n \"AmazonPrice\": 123\n },\n \"ActiveSalesChannels\": [\n \"<string>\"\n ],\n \"SortNumber\": 123,\n \"Annotation\": \"<string>\",\n \"ReleasedOnDate\": \"2023-11-07T05:31:56Z\",\n \"StorageOptions\": {\n \"InventoryManagementActive\": true,\n \"SplitQuantity\": true,\n \"GlobalMinimumStockLevel\": 123,\n \"Buffer\": 123,\n \"SerialNumberItem\": true,\n \"SerialNumberTracking\": true,\n \"SubjectToShelfLifeExpirationDate\": true,\n \"SubjectToBatchItem\": true,\n \"ProcurementTime\": 123,\n \"DetermineProcurementTimeAutomatically\": true,\n \"AdditionalHandlingTime\": 123\n },\n \"CountryOfOrigin\": \"<string>\",\n \"ConditionId\": 123,\n \"ShippingClassId\": 123,\n \"ProductGroupId\": 123,\n \"TaxClassId\": 123,\n \"Dimensions\": {\n \"Length\": 123,\n \"Width\": 123,\n \"Height\": 123\n },\n \"Weights\": {\n \"ItemWeigth\": 123,\n \"ShippingWeight\": 123\n },\n \"AllowNegativeStock\": true,\n \"Quantities\": {\n \"MinimumOrderQuantity\": 123,\n \"MinimumPurchaseQuantityForCustomerGroup\": [\n {\n \"CustomerGroupId\": 123,\n \"PermissibleOrderQuantity\": 123,\n \"MinimumPurchaseQuantity\": 123,\n \"IsActive\": true\n }\n ],\n \"PermissibleOrderQuantity\": 123\n },\n \"DangerousGoods\": {\n \"UnNumber\": \"<string>\",\n \"HazardNo\": \"<string>\"\n },\n \"Taric\": \"<string>\",\n \"SearchTerms\": \"<string>\",\n \"PriceListActive\": true,\n \"IgnoreDiscounts\": true,\n \"AvailabilityId\": 123\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/v1/items")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"Categories\": [\n {\n \"CategoryId\": 123\n }\n ],\n \"Name\": \"<string>\",\n \"SKU\": \"<string>\",\n \"ManufacturerId\": 123,\n \"ResponsiblePersonId\": 123,\n \"Description\": \"<string>\",\n \"ShortDescription\": \"<string>\",\n \"Identifiers\": {\n \"Gtin\": \"<string>\",\n \"ManufacturerNumber\": \"<string>\",\n \"ISBN\": \"<string>\",\n \"UPC\": \"<string>\",\n \"AmazonFnsku\": \"<string>\",\n \"Asins\": [\n \"<string>\"\n ],\n \"OwnIdentifier\": \"<string>\"\n },\n \"Components\": [\n {\n \"ItemId\": 123,\n \"Quantity\": 123,\n \"SortNumber\": 123\n }\n ],\n \"ItemPriceData\": {\n \"SalesPriceNet\": 123,\n \"SuggestedRetailPrice\": 123,\n \"PurchasePriceNet\": 123,\n \"EbayPrice\": 123,\n \"AmazonPrice\": 123\n },\n \"ActiveSalesChannels\": [\n \"<string>\"\n ],\n \"SortNumber\": 123,\n \"Annotation\": \"<string>\",\n \"ReleasedOnDate\": \"2023-11-07T05:31:56Z\",\n \"StorageOptions\": {\n \"InventoryManagementActive\": true,\n \"SplitQuantity\": true,\n \"GlobalMinimumStockLevel\": 123,\n \"Buffer\": 123,\n \"SerialNumberItem\": true,\n \"SerialNumberTracking\": true,\n \"SubjectToShelfLifeExpirationDate\": true,\n \"SubjectToBatchItem\": true,\n \"ProcurementTime\": 123,\n \"DetermineProcurementTimeAutomatically\": true,\n \"AdditionalHandlingTime\": 123\n },\n \"CountryOfOrigin\": \"<string>\",\n \"ConditionId\": 123,\n \"ShippingClassId\": 123,\n \"ProductGroupId\": 123,\n \"TaxClassId\": 123,\n \"Dimensions\": {\n \"Length\": 123,\n \"Width\": 123,\n \"Height\": 123\n },\n \"Weights\": {\n \"ItemWeigth\": 123,\n \"ShippingWeight\": 123\n },\n \"AllowNegativeStock\": true,\n \"Quantities\": {\n \"MinimumOrderQuantity\": 123,\n \"MinimumPurchaseQuantityForCustomerGroup\": [\n {\n \"CustomerGroupId\": 123,\n \"PermissibleOrderQuantity\": 123,\n \"MinimumPurchaseQuantity\": 123,\n \"IsActive\": true\n }\n ],\n \"PermissibleOrderQuantity\": 123\n },\n \"DangerousGoods\": {\n \"UnNumber\": \"<string>\",\n \"HazardNo\": \"<string>\"\n },\n \"Taric\": \"<string>\",\n \"SearchTerms\": \"<string>\",\n \"PriceListActive\": true,\n \"IgnoreDiscounts\": true,\n \"AvailabilityId\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v1/items")
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 \"Categories\": [\n {\n \"CategoryId\": 123\n }\n ],\n \"Name\": \"<string>\",\n \"SKU\": \"<string>\",\n \"ManufacturerId\": 123,\n \"ResponsiblePersonId\": 123,\n \"Description\": \"<string>\",\n \"ShortDescription\": \"<string>\",\n \"Identifiers\": {\n \"Gtin\": \"<string>\",\n \"ManufacturerNumber\": \"<string>\",\n \"ISBN\": \"<string>\",\n \"UPC\": \"<string>\",\n \"AmazonFnsku\": \"<string>\",\n \"Asins\": [\n \"<string>\"\n ],\n \"OwnIdentifier\": \"<string>\"\n },\n \"Components\": [\n {\n \"ItemId\": 123,\n \"Quantity\": 123,\n \"SortNumber\": 123\n }\n ],\n \"ItemPriceData\": {\n \"SalesPriceNet\": 123,\n \"SuggestedRetailPrice\": 123,\n \"PurchasePriceNet\": 123,\n \"EbayPrice\": 123,\n \"AmazonPrice\": 123\n },\n \"ActiveSalesChannels\": [\n \"<string>\"\n ],\n \"SortNumber\": 123,\n \"Annotation\": \"<string>\",\n \"ReleasedOnDate\": \"2023-11-07T05:31:56Z\",\n \"StorageOptions\": {\n \"InventoryManagementActive\": true,\n \"SplitQuantity\": true,\n \"GlobalMinimumStockLevel\": 123,\n \"Buffer\": 123,\n \"SerialNumberItem\": true,\n \"SerialNumberTracking\": true,\n \"SubjectToShelfLifeExpirationDate\": true,\n \"SubjectToBatchItem\": true,\n \"ProcurementTime\": 123,\n \"DetermineProcurementTimeAutomatically\": true,\n \"AdditionalHandlingTime\": 123\n },\n \"CountryOfOrigin\": \"<string>\",\n \"ConditionId\": 123,\n \"ShippingClassId\": 123,\n \"ProductGroupId\": 123,\n \"TaxClassId\": 123,\n \"Dimensions\": {\n \"Length\": 123,\n \"Width\": 123,\n \"Height\": 123\n },\n \"Weights\": {\n \"ItemWeigth\": 123,\n \"ShippingWeight\": 123\n },\n \"AllowNegativeStock\": true,\n \"Quantities\": {\n \"MinimumOrderQuantity\": 123,\n \"MinimumPurchaseQuantityForCustomerGroup\": [\n {\n \"CustomerGroupId\": 123,\n \"PermissibleOrderQuantity\": 123,\n \"MinimumPurchaseQuantity\": 123,\n \"IsActive\": true\n }\n ],\n \"PermissibleOrderQuantity\": 123\n },\n \"DangerousGoods\": {\n \"UnNumber\": \"<string>\",\n \"HazardNo\": \"<string>\"\n },\n \"Taric\": \"<string>\",\n \"SearchTerms\": \"<string>\",\n \"PriceListActive\": true,\n \"IgnoreDiscounts\": true,\n \"AvailabilityId\": 123\n}"
response = http.request(request)
puts response.read_body{
"Id": 123,
"SKU": "<string>",
"ManufacturerId": 123,
"ResponsiblePersonId": 123,
"IsActive": true,
"Categories": [
{
"CategoryId": 123,
"Name": "<string>"
}
],
"Name": "<string>",
"Description": "<string>",
"ShortDescription": "<string>",
"Identifiers": {
"Gtin": "<string>",
"ManufacturerNumber": "<string>",
"ISBN": "<string>",
"UPC": "<string>",
"AmazonFnsku": "<string>",
"Asins": [
"<string>"
],
"OwnIdentifier": "<string>"
},
"Components": [
{
"ItemId": 123,
"Quantity": 123,
"SortNumber": 123
}
],
"ChildItems": [
123
],
"ParentItemId": 123,
"ItemPriceData": {
"SalesPriceNet": 123,
"SuggestedRetailPrice": 123,
"PurchasePriceNet": 123,
"EbayPrice": 123,
"AmazonPrice": 123
},
"ActiveSalesChannels": [
"<string>"
],
"SortNumber": 123,
"Annotation": "<string>",
"Added": "2023-11-07T05:31:56Z",
"Changed": "2023-11-07T05:31:56Z",
"ReleasedOnDate": "2023-11-07T05:31:56Z",
"StorageOptions": {
"InventoryManagementActive": true,
"SplitQuantity": true,
"GlobalMinimumStockLevel": 123,
"Buffer": 123,
"SerialNumberItem": true,
"SerialNumberTracking": true,
"SubjectToShelfLifeExpirationDate": true,
"SubjectToBatchItem": true,
"ProcurementTime": 123,
"DetermineProcurementTimeAutomatically": true,
"AdditionalHandlingTime": 123
},
"CountryOfOrigin": "<string>",
"ConditionId": 123,
"ShippingClassId": 123,
"ProductGroupId": 123,
"TaxClassId": 123,
"Dimensions": {
"Length": 123,
"Width": 123,
"Height": 123
},
"Weights": {
"ItemWeigth": 123,
"ShippingWeight": 123
},
"AllowNegativeStock": true,
"Quantities": {
"MinimumOrderQuantity": 123,
"MinimumPurchaseQuantityForCustomerGroup": [
{
"CustomerGroupId": 123,
"PermissibleOrderQuantity": 123,
"MinimumPurchaseQuantity": 123,
"IsActive": true
}
],
"PermissibleOrderQuantity": 123
},
"DangerousGoods": {
"UnNumber": "<string>",
"HazardNo": "<string>"
},
"Taric": "<string>",
"SearchTerms": "<string>",
"PriceListActive": true,
"IgnoreDiscounts": true,
"AvailabilityId": 123
}{
"ErrorCode": "<string>",
"ValidationErrors": {},
"Errors": {},
"ErrorMessage": "<string>",
"Stacktrace": "<string>"
}Authorizations
oauth2-authorization-codeoauth2-client-credentials
Headers
Body
application/json
The item to create.
Model Class: CreateItem
Response
The created item.
Model Class: Item
Was this page helpful?