Create Item
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"categories": {
"categories": [
{
"categoryId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
},
"identifiers": {
"sku": "<string>",
"amazonFnsku": "<string>",
"gtin": "<string>",
"manufacturerNumber": "<string>",
"isbn": "<string>",
"tariccode": "<string>",
"upc": "<string>",
"unNumber": "<string>",
"hazardNumber": "<string>",
"ownIdentifier": "<string>",
"defaultAsin": "<string>",
"jfsku": "<string>"
},
"descriptions": {
"defaultDescriptions": [
{
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"salesChannelDescriptions": [
{
"salesChannelId": "<string>",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"platformDescriptions": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
]
},
"productGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"shippingClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"manufacturerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": {
"ignoreDiscounts": true,
"salesPriceNet": 123,
"suggestedRetailPrice": 123,
"purchasePriceNet": 123,
"ebayPrice": 123,
"amazonPrice": 123,
"salesChannelPrices": [
{
"saleschannelId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerGroupPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"isActive": true
}
],
"customerPrices": [
{
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"defaultPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
]
},
"suppliers": {
"defaultSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultDropshippingSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"suppliers": [
{
"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
}
]
}
]
},
"measurements": {
"height": 123,
"length": 123,
"shippingWeight": 123,
"weight": 123,
"width": 123
},
"variations": {
"variations": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"position": 123,
"values": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"itemNumber": "<string>",
"gTIN": "<string>",
"weightOffset": 123,
"surcharges": {
"defaultSurchargeNet": 123,
"customerGroupSurcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": true
}
],
"salesChannelSurcharges": [
{
"salesChannelId": "<string>",
"surcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": true
}
]
}
]
},
"position": 123,
"image": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
]
},
"features": {
"features": [
{
"featureId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
},
"attributes": {
"values": [
{
"attributeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultValues": [
{
"languageIso": "<string>",
"value": "<string>"
}
],
"salesChannelValues": [
{
"salesChannelId": "<string>",
"values": [
{
"languageIso": "<string>",
"value": "<string>"
}
]
}
]
}
]
},
"unitPricing": {
"salesUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"packagingUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"innerQuantity": 123,
"innerQuantityUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isBasePriceDeclared": true,
"basePriceReferenceUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"basePriceReferenceAmount": 123
},
"specialPrices": {
"isActive": true,
"startDate": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"isEndDateActive": true,
"minimumStockQuantity": 123,
"isStockRestrictionActive": true,
"salesChannelSpecialPrices": [
{
"salesChannelId": "<string>",
"specialPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"netPrice": 123,
"isActive": true
}
]
}
]
},
"crosssellingGroups": {
"groups": [
{
"crosssellingGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"items": [
{
"id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"sku": "<string>"
}
]
}
]
},
"images": {
"defaultImages": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
],
"platformImages": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
]
}
],
"saleschannelImages": [
{
"saleschannelId": "<string>",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
]
}
],
"ebayImages": [
{
"ebayAccountId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
]
}
]
},
"storageConstraints": {
"allowNegativeStock": true,
"itemPlatformNegativeStocks": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isNegativeStockAllowed": true
}
],
"itemSalesChannelNegativeStocks": [
{
"salesChannelId": "<string>",
"isNegativeStockAllowed": true
}
],
"buffer": 123,
"globalMinimumStockLevel": 123,
"hasBatch": true,
"isInventoryManagementActive": true,
"isBestBeforeManaged": true,
"isStockDivisible": true
},
"salesChannels": [
{
"salesChannelId": "<string>",
"includeItemImages": true
}
]
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/items"
payload = {
"categories": { "categories": [{ "categoryId": "b45f6432-2462-4c6f-b00f-1d9d01000000" }] },
"identifiers": {
"sku": "<string>",
"amazonFnsku": "<string>",
"gtin": "<string>",
"manufacturerNumber": "<string>",
"isbn": "<string>",
"tariccode": "<string>",
"upc": "<string>",
"unNumber": "<string>",
"hazardNumber": "<string>",
"ownIdentifier": "<string>",
"defaultAsin": "<string>",
"jfsku": "<string>"
},
"descriptions": {
"defaultDescriptions": [
{
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"salesChannelDescriptions": [
{
"salesChannelId": "<string>",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"platformDescriptions": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
]
},
"productGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"shippingClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"manufacturerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": {
"ignoreDiscounts": True,
"salesPriceNet": 123,
"suggestedRetailPrice": 123,
"purchasePriceNet": 123,
"ebayPrice": 123,
"amazonPrice": 123,
"salesChannelPrices": [
{
"saleschannelId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerGroupPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"isActive": True
}
],
"customerPrices": [
{
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"defaultPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
]
},
"suppliers": {
"defaultSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultDropshippingSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"suppliers": [
{
"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
}
]
}
]
},
"measurements": {
"height": 123,
"length": 123,
"shippingWeight": 123,
"weight": 123,
"width": 123
},
"variations": { "variations": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"position": 123,
"values": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"itemNumber": "<string>",
"gTIN": "<string>",
"weightOffset": 123,
"surcharges": {
"defaultSurchargeNet": 123,
"customerGroupSurcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": True
}
],
"salesChannelSurcharges": [
{
"salesChannelId": "<string>",
"surcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": True
}
]
}
]
},
"position": 123,
"image": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
] },
"features": { "features": [{ "featureId": "b45f6432-2462-4c6f-b00f-1d9d01000000" }] },
"attributes": { "values": [
{
"attributeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultValues": [
{
"languageIso": "<string>",
"value": "<string>"
}
],
"salesChannelValues": [
{
"salesChannelId": "<string>",
"values": [
{
"languageIso": "<string>",
"value": "<string>"
}
]
}
]
}
] },
"unitPricing": {
"salesUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"packagingUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"innerQuantity": 123,
"innerQuantityUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isBasePriceDeclared": True,
"basePriceReferenceUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"basePriceReferenceAmount": 123
},
"specialPrices": {
"isActive": True,
"startDate": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"isEndDateActive": True,
"minimumStockQuantity": 123,
"isStockRestrictionActive": True,
"salesChannelSpecialPrices": [
{
"salesChannelId": "<string>",
"specialPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"netPrice": 123,
"isActive": True
}
]
}
]
},
"crosssellingGroups": { "groups": [
{
"crosssellingGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"items": [
{
"id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"sku": "<string>"
}
]
}
] },
"images": {
"defaultImages": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
],
"platformImages": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
]
}
],
"saleschannelImages": [
{
"saleschannelId": "<string>",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
]
}
],
"ebayImages": [
{
"ebayAccountId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
]
}
]
},
"storageConstraints": {
"allowNegativeStock": True,
"itemPlatformNegativeStocks": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isNegativeStockAllowed": True
}
],
"itemSalesChannelNegativeStocks": [
{
"salesChannelId": "<string>",
"isNegativeStockAllowed": True
}
],
"buffer": 123,
"globalMinimumStockLevel": 123,
"hasBatch": True,
"isInventoryManagementActive": True,
"isBestBeforeManaged": True,
"isStockDivisible": True
},
"salesChannels": [
{
"salesChannelId": "<string>",
"includeItemImages": True
}
]
}
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: {categories: [{categoryId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'}]},
identifiers: {
sku: '<string>',
amazonFnsku: '<string>',
gtin: '<string>',
manufacturerNumber: '<string>',
isbn: '<string>',
tariccode: '<string>',
upc: '<string>',
unNumber: '<string>',
hazardNumber: '<string>',
ownIdentifier: '<string>',
defaultAsin: '<string>',
jfsku: '<string>'
},
descriptions: {
defaultDescriptions: [
{
languageIso: '<string>',
descriptionData: {
itemName: '<string>',
shortDescription: '<string>',
description: '<string>',
metaDescription: '<string>',
metaKeywords: '<string>',
titleTag: '<string>',
urlPath: '<string>'
}
}
],
salesChannelDescriptions: [
{
salesChannelId: '<string>',
languageIso: '<string>',
descriptionData: {
itemName: '<string>',
shortDescription: '<string>',
description: '<string>',
metaDescription: '<string>',
metaKeywords: '<string>',
titleTag: '<string>',
urlPath: '<string>'
}
}
],
platformDescriptions: [
{
platformId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
languageIso: '<string>',
descriptionData: {
itemName: '<string>',
shortDescription: '<string>',
description: '<string>',
metaDescription: '<string>',
metaKeywords: '<string>',
titleTag: '<string>',
urlPath: '<string>'
}
}
]
},
productGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
shippingClassId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
manufacturerId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: {
ignoreDiscounts: true,
salesPriceNet: 123,
suggestedRetailPrice: 123,
purchasePriceNet: 123,
ebayPrice: 123,
amazonPrice: 123,
salesChannelPrices: [
{
saleschannelId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
customerGroupPrices: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: [{fromQuantity: 123, netPrice: 123, reduceStandardPriceByPercent: 123}]
}
],
isActive: true
}
],
customerPrices: [
{
customerId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: [{fromQuantity: 123, netPrice: 123, reduceStandardPriceByPercent: 123}]
}
],
defaultPrices: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: [{fromQuantity: 123, netPrice: 123, reduceStandardPriceByPercent: 123}]
}
]
},
suppliers: {
defaultSupplier: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
defaultDropshippingSupplier: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
suppliers: [
{
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
}
]
}
]
},
measurements: {height: 123, length: 123, shippingWeight: 123, weight: 123, width: 123},
variations: {
variations: [
{
descriptions: [{languageIso: '<string>', name: '<string>'}],
variationId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
position: 123,
values: [
{
descriptions: [{languageIso: '<string>', name: '<string>'}],
variationValueId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
itemNumber: '<string>',
gTIN: '<string>',
weightOffset: 123,
surcharges: {
defaultSurchargeNet: 123,
customerGroupSurcharges: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
surcharge: 123,
isActive: true
}
],
salesChannelSurcharges: [
{
salesChannelId: '<string>',
surcharges: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
surcharge: 123,
isActive: true
}
]
}
]
},
position: 123,
image: 'b45f6432-2462-4c6f-b00f-1d9d01000000'
}
]
}
]
},
features: {features: [{featureId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'}]},
attributes: {
values: [
{
attributeId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
defaultValues: [{languageIso: '<string>', value: '<string>'}],
salesChannelValues: [
{
salesChannelId: '<string>',
values: [{languageIso: '<string>', value: '<string>'}]
}
]
}
]
},
unitPricing: {
salesUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
packagingUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
innerQuantity: 123,
innerQuantityUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
isBasePriceDeclared: true,
basePriceReferenceUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
basePriceReferenceAmount: 123
},
specialPrices: {
isActive: true,
startDate: '2023-11-07T05:31:56Z',
endDate: '2023-11-07T05:31:56Z',
isEndDateActive: true,
minimumStockQuantity: 123,
isStockRestrictionActive: true,
salesChannelSpecialPrices: [
{
salesChannelId: '<string>',
specialPrices: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
netPrice: 123,
isActive: true
}
]
}
]
},
crosssellingGroups: {
groups: [
{
crosssellingGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
items: [{id: 'b45f6432-2462-4c6f-b00f-1d9d01000000', sku: '<string>'}]
}
]
},
images: {
defaultImages: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
],
platformImages: [
{
platformId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
images: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
]
}
],
saleschannelImages: [
{
saleschannelId: '<string>',
images: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
]
}
],
ebayImages: [
{
ebayAccountId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
images: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
]
}
]
},
storageConstraints: {
allowNegativeStock: true,
itemPlatformNegativeStocks: [
{
platformId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
isNegativeStockAllowed: true
}
],
itemSalesChannelNegativeStocks: [{salesChannelId: '<string>', isNegativeStockAllowed: true}],
buffer: 123,
globalMinimumStockLevel: 123,
hasBatch: true,
isInventoryManagementActive: true,
isBestBeforeManaged: true,
isStockDivisible: true
},
salesChannels: [{salesChannelId: '<string>', includeItemImages: true}]
})
};
fetch('https://api.jtl-cloud.com/erp/v2/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/v2/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' => [
'categories' => [
[
'categoryId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
],
'identifiers' => [
'sku' => '<string>',
'amazonFnsku' => '<string>',
'gtin' => '<string>',
'manufacturerNumber' => '<string>',
'isbn' => '<string>',
'tariccode' => '<string>',
'upc' => '<string>',
'unNumber' => '<string>',
'hazardNumber' => '<string>',
'ownIdentifier' => '<string>',
'defaultAsin' => '<string>',
'jfsku' => '<string>'
],
'descriptions' => [
'defaultDescriptions' => [
[
'languageIso' => '<string>',
'descriptionData' => [
'itemName' => '<string>',
'shortDescription' => '<string>',
'description' => '<string>',
'metaDescription' => '<string>',
'metaKeywords' => '<string>',
'titleTag' => '<string>',
'urlPath' => '<string>'
]
]
],
'salesChannelDescriptions' => [
[
'salesChannelId' => '<string>',
'languageIso' => '<string>',
'descriptionData' => [
'itemName' => '<string>',
'shortDescription' => '<string>',
'description' => '<string>',
'metaDescription' => '<string>',
'metaKeywords' => '<string>',
'titleTag' => '<string>',
'urlPath' => '<string>'
]
]
],
'platformDescriptions' => [
[
'platformId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'languageIso' => '<string>',
'descriptionData' => [
'itemName' => '<string>',
'shortDescription' => '<string>',
'description' => '<string>',
'metaDescription' => '<string>',
'metaKeywords' => '<string>',
'titleTag' => '<string>',
'urlPath' => '<string>'
]
]
]
],
'productGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'shippingClassId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'manufacturerId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
'ignoreDiscounts' => true,
'salesPriceNet' => 123,
'suggestedRetailPrice' => 123,
'purchasePriceNet' => 123,
'ebayPrice' => 123,
'amazonPrice' => 123,
'salesChannelPrices' => [
[
'saleschannelId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'customerGroupPrices' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
[
'fromQuantity' => 123,
'netPrice' => 123,
'reduceStandardPriceByPercent' => 123
]
]
]
],
'isActive' => true
]
],
'customerPrices' => [
[
'customerId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
[
'fromQuantity' => 123,
'netPrice' => 123,
'reduceStandardPriceByPercent' => 123
]
]
]
],
'defaultPrices' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
[
'fromQuantity' => 123,
'netPrice' => 123,
'reduceStandardPriceByPercent' => 123
]
]
]
]
],
'suppliers' => [
'defaultSupplier' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'defaultDropshippingSupplier' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'suppliers' => [
[
'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
]
]
]
]
],
'measurements' => [
'height' => 123,
'length' => 123,
'shippingWeight' => 123,
'weight' => 123,
'width' => 123
],
'variations' => [
'variations' => [
[
'descriptions' => [
[
'languageIso' => '<string>',
'name' => '<string>'
]
],
'variationId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'position' => 123,
'values' => [
[
'descriptions' => [
[
'languageIso' => '<string>',
'name' => '<string>'
]
],
'variationValueId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'itemNumber' => '<string>',
'gTIN' => '<string>',
'weightOffset' => 123,
'surcharges' => [
'defaultSurchargeNet' => 123,
'customerGroupSurcharges' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'surcharge' => 123,
'isActive' => true
]
],
'salesChannelSurcharges' => [
[
'salesChannelId' => '<string>',
'surcharges' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'surcharge' => 123,
'isActive' => true
]
]
]
]
],
'position' => 123,
'image' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
]
]
],
'features' => [
'features' => [
[
'featureId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
],
'attributes' => [
'values' => [
[
'attributeId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'defaultValues' => [
[
'languageIso' => '<string>',
'value' => '<string>'
]
],
'salesChannelValues' => [
[
'salesChannelId' => '<string>',
'values' => [
[
'languageIso' => '<string>',
'value' => '<string>'
]
]
]
]
]
]
],
'unitPricing' => [
'salesUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'packagingUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'innerQuantity' => 123,
'innerQuantityUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'isBasePriceDeclared' => true,
'basePriceReferenceUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'basePriceReferenceAmount' => 123
],
'specialPrices' => [
'isActive' => true,
'startDate' => '2023-11-07T05:31:56Z',
'endDate' => '2023-11-07T05:31:56Z',
'isEndDateActive' => true,
'minimumStockQuantity' => 123,
'isStockRestrictionActive' => true,
'salesChannelSpecialPrices' => [
[
'salesChannelId' => '<string>',
'specialPrices' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'netPrice' => 123,
'isActive' => true
]
]
]
]
],
'crosssellingGroups' => [
'groups' => [
[
'crosssellingGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'items' => [
[
'id' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'sku' => '<string>'
]
]
]
]
],
'images' => [
'defaultImages' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
],
'platformImages' => [
[
'platformId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'images' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
]
]
],
'saleschannelImages' => [
[
'saleschannelId' => '<string>',
'images' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
]
]
],
'ebayImages' => [
[
'ebayAccountId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'images' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
]
]
]
],
'storageConstraints' => [
'allowNegativeStock' => true,
'itemPlatformNegativeStocks' => [
[
'platformId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'isNegativeStockAllowed' => true
]
],
'itemSalesChannelNegativeStocks' => [
[
'salesChannelId' => '<string>',
'isNegativeStockAllowed' => true
]
],
'buffer' => 123,
'globalMinimumStockLevel' => 123,
'hasBatch' => true,
'isInventoryManagementActive' => true,
'isBestBeforeManaged' => true,
'isStockDivisible' => true
],
'salesChannels' => [
[
'salesChannelId' => '<string>',
'includeItemImages' => true
]
]
]),
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"
payload := strings.NewReader("{\n \"categories\": {\n \"categories\": [\n {\n \"categoryId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"identifiers\": {\n \"sku\": \"<string>\",\n \"amazonFnsku\": \"<string>\",\n \"gtin\": \"<string>\",\n \"manufacturerNumber\": \"<string>\",\n \"isbn\": \"<string>\",\n \"tariccode\": \"<string>\",\n \"upc\": \"<string>\",\n \"unNumber\": \"<string>\",\n \"hazardNumber\": \"<string>\",\n \"ownIdentifier\": \"<string>\",\n \"defaultAsin\": \"<string>\",\n \"jfsku\": \"<string>\"\n },\n \"descriptions\": {\n \"defaultDescriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"salesChannelDescriptions\": [\n {\n \"salesChannelId\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"platformDescriptions\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ]\n },\n \"productGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"shippingClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"manufacturerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": {\n \"ignoreDiscounts\": true,\n \"salesPriceNet\": 123,\n \"suggestedRetailPrice\": 123,\n \"purchasePriceNet\": 123,\n \"ebayPrice\": 123,\n \"amazonPrice\": 123,\n \"salesChannelPrices\": [\n {\n \"saleschannelId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerGroupPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"isActive\": true\n }\n ],\n \"customerPrices\": [\n {\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"defaultPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ]\n },\n \"suppliers\": {\n \"defaultSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultDropshippingSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"suppliers\": [\n {\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 ]\n },\n \"measurements\": {\n \"height\": 123,\n \"length\": 123,\n \"shippingWeight\": 123,\n \"weight\": 123,\n \"width\": 123\n },\n \"variations\": {\n \"variations\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"position\": 123,\n \"values\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"itemNumber\": \"<string>\",\n \"gTIN\": \"<string>\",\n \"weightOffset\": 123,\n \"surcharges\": {\n \"defaultSurchargeNet\": 123,\n \"customerGroupSurcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ],\n \"salesChannelSurcharges\": [\n {\n \"salesChannelId\": \"<string>\",\n \"surcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"position\": 123,\n \"image\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ]\n },\n \"features\": {\n \"features\": [\n {\n \"featureId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"attributes\": {\n \"values\": [\n {\n \"attributeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultValues\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"salesChannelValues\": [\n {\n \"salesChannelId\": \"<string>\",\n \"values\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"unitPricing\": {\n \"salesUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"packagingUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"innerQuantity\": 123,\n \"innerQuantityUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isBasePriceDeclared\": true,\n \"basePriceReferenceUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"basePriceReferenceAmount\": 123\n },\n \"specialPrices\": {\n \"isActive\": true,\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"isEndDateActive\": true,\n \"minimumStockQuantity\": 123,\n \"isStockRestrictionActive\": true,\n \"salesChannelSpecialPrices\": [\n {\n \"salesChannelId\": \"<string>\",\n \"specialPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"netPrice\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"crosssellingGroups\": {\n \"groups\": [\n {\n \"crosssellingGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"items\": [\n {\n \"id\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"sku\": \"<string>\"\n }\n ]\n }\n ]\n },\n \"images\": {\n \"defaultImages\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ],\n \"platformImages\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"saleschannelImages\": [\n {\n \"saleschannelId\": \"<string>\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"ebayImages\": [\n {\n \"ebayAccountId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ]\n },\n \"storageConstraints\": {\n \"allowNegativeStock\": true,\n \"itemPlatformNegativeStocks\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"itemSalesChannelNegativeStocks\": [\n {\n \"salesChannelId\": \"<string>\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"buffer\": 123,\n \"globalMinimumStockLevel\": 123,\n \"hasBatch\": true,\n \"isInventoryManagementActive\": true,\n \"isBestBeforeManaged\": true,\n \"isStockDivisible\": true\n },\n \"salesChannels\": [\n {\n \"salesChannelId\": \"<string>\",\n \"includeItemImages\": true\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")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"categories\": {\n \"categories\": [\n {\n \"categoryId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"identifiers\": {\n \"sku\": \"<string>\",\n \"amazonFnsku\": \"<string>\",\n \"gtin\": \"<string>\",\n \"manufacturerNumber\": \"<string>\",\n \"isbn\": \"<string>\",\n \"tariccode\": \"<string>\",\n \"upc\": \"<string>\",\n \"unNumber\": \"<string>\",\n \"hazardNumber\": \"<string>\",\n \"ownIdentifier\": \"<string>\",\n \"defaultAsin\": \"<string>\",\n \"jfsku\": \"<string>\"\n },\n \"descriptions\": {\n \"defaultDescriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"salesChannelDescriptions\": [\n {\n \"salesChannelId\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"platformDescriptions\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ]\n },\n \"productGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"shippingClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"manufacturerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": {\n \"ignoreDiscounts\": true,\n \"salesPriceNet\": 123,\n \"suggestedRetailPrice\": 123,\n \"purchasePriceNet\": 123,\n \"ebayPrice\": 123,\n \"amazonPrice\": 123,\n \"salesChannelPrices\": [\n {\n \"saleschannelId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerGroupPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"isActive\": true\n }\n ],\n \"customerPrices\": [\n {\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"defaultPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ]\n },\n \"suppliers\": {\n \"defaultSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultDropshippingSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"suppliers\": [\n {\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 ]\n },\n \"measurements\": {\n \"height\": 123,\n \"length\": 123,\n \"shippingWeight\": 123,\n \"weight\": 123,\n \"width\": 123\n },\n \"variations\": {\n \"variations\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"position\": 123,\n \"values\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"itemNumber\": \"<string>\",\n \"gTIN\": \"<string>\",\n \"weightOffset\": 123,\n \"surcharges\": {\n \"defaultSurchargeNet\": 123,\n \"customerGroupSurcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ],\n \"salesChannelSurcharges\": [\n {\n \"salesChannelId\": \"<string>\",\n \"surcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"position\": 123,\n \"image\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ]\n },\n \"features\": {\n \"features\": [\n {\n \"featureId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"attributes\": {\n \"values\": [\n {\n \"attributeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultValues\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"salesChannelValues\": [\n {\n \"salesChannelId\": \"<string>\",\n \"values\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"unitPricing\": {\n \"salesUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"packagingUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"innerQuantity\": 123,\n \"innerQuantityUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isBasePriceDeclared\": true,\n \"basePriceReferenceUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"basePriceReferenceAmount\": 123\n },\n \"specialPrices\": {\n \"isActive\": true,\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"isEndDateActive\": true,\n \"minimumStockQuantity\": 123,\n \"isStockRestrictionActive\": true,\n \"salesChannelSpecialPrices\": [\n {\n \"salesChannelId\": \"<string>\",\n \"specialPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"netPrice\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"crosssellingGroups\": {\n \"groups\": [\n {\n \"crosssellingGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"items\": [\n {\n \"id\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"sku\": \"<string>\"\n }\n ]\n }\n ]\n },\n \"images\": {\n \"defaultImages\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ],\n \"platformImages\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"saleschannelImages\": [\n {\n \"saleschannelId\": \"<string>\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"ebayImages\": [\n {\n \"ebayAccountId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ]\n },\n \"storageConstraints\": {\n \"allowNegativeStock\": true,\n \"itemPlatformNegativeStocks\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"itemSalesChannelNegativeStocks\": [\n {\n \"salesChannelId\": \"<string>\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"buffer\": 123,\n \"globalMinimumStockLevel\": 123,\n \"hasBatch\": true,\n \"isInventoryManagementActive\": true,\n \"isBestBeforeManaged\": true,\n \"isStockDivisible\": true\n },\n \"salesChannels\": [\n {\n \"salesChannelId\": \"<string>\",\n \"includeItemImages\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/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 \"categories\": [\n {\n \"categoryId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"identifiers\": {\n \"sku\": \"<string>\",\n \"amazonFnsku\": \"<string>\",\n \"gtin\": \"<string>\",\n \"manufacturerNumber\": \"<string>\",\n \"isbn\": \"<string>\",\n \"tariccode\": \"<string>\",\n \"upc\": \"<string>\",\n \"unNumber\": \"<string>\",\n \"hazardNumber\": \"<string>\",\n \"ownIdentifier\": \"<string>\",\n \"defaultAsin\": \"<string>\",\n \"jfsku\": \"<string>\"\n },\n \"descriptions\": {\n \"defaultDescriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"salesChannelDescriptions\": [\n {\n \"salesChannelId\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"platformDescriptions\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ]\n },\n \"productGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"shippingClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"manufacturerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": {\n \"ignoreDiscounts\": true,\n \"salesPriceNet\": 123,\n \"suggestedRetailPrice\": 123,\n \"purchasePriceNet\": 123,\n \"ebayPrice\": 123,\n \"amazonPrice\": 123,\n \"salesChannelPrices\": [\n {\n \"saleschannelId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerGroupPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"isActive\": true\n }\n ],\n \"customerPrices\": [\n {\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"defaultPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ]\n },\n \"suppliers\": {\n \"defaultSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultDropshippingSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"suppliers\": [\n {\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 ]\n },\n \"measurements\": {\n \"height\": 123,\n \"length\": 123,\n \"shippingWeight\": 123,\n \"weight\": 123,\n \"width\": 123\n },\n \"variations\": {\n \"variations\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"position\": 123,\n \"values\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"itemNumber\": \"<string>\",\n \"gTIN\": \"<string>\",\n \"weightOffset\": 123,\n \"surcharges\": {\n \"defaultSurchargeNet\": 123,\n \"customerGroupSurcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ],\n \"salesChannelSurcharges\": [\n {\n \"salesChannelId\": \"<string>\",\n \"surcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"position\": 123,\n \"image\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ]\n },\n \"features\": {\n \"features\": [\n {\n \"featureId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"attributes\": {\n \"values\": [\n {\n \"attributeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultValues\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"salesChannelValues\": [\n {\n \"salesChannelId\": \"<string>\",\n \"values\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"unitPricing\": {\n \"salesUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"packagingUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"innerQuantity\": 123,\n \"innerQuantityUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isBasePriceDeclared\": true,\n \"basePriceReferenceUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"basePriceReferenceAmount\": 123\n },\n \"specialPrices\": {\n \"isActive\": true,\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"isEndDateActive\": true,\n \"minimumStockQuantity\": 123,\n \"isStockRestrictionActive\": true,\n \"salesChannelSpecialPrices\": [\n {\n \"salesChannelId\": \"<string>\",\n \"specialPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"netPrice\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"crosssellingGroups\": {\n \"groups\": [\n {\n \"crosssellingGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"items\": [\n {\n \"id\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"sku\": \"<string>\"\n }\n ]\n }\n ]\n },\n \"images\": {\n \"defaultImages\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ],\n \"platformImages\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"saleschannelImages\": [\n {\n \"saleschannelId\": \"<string>\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"ebayImages\": [\n {\n \"ebayAccountId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ]\n },\n \"storageConstraints\": {\n \"allowNegativeStock\": true,\n \"itemPlatformNegativeStocks\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"itemSalesChannelNegativeStocks\": [\n {\n \"salesChannelId\": \"<string>\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"buffer\": 123,\n \"globalMinimumStockLevel\": 123,\n \"hasBatch\": true,\n \"isInventoryManagementActive\": true,\n \"isBestBeforeManaged\": true,\n \"isStockDivisible\": true\n },\n \"salesChannels\": [\n {\n \"salesChannelId\": \"<string>\",\n \"includeItemImages\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}{
"errorCode": "<string>",
"validationErrors": {},
"errors": {},
"errorMessage": "<string>",
"stacktrace": "<string>"
}{
"errorCode": "<string>",
"validationErrors": {},
"errors": {},
"errorMessage": "<string>",
"stacktrace": "<string>"
}Item
Create Item
Creates a new regular item with all specified properties. This command enables complete configuration of an item including identifiers, descriptions, prices, and measurements.
POST
/
v2
/
items
Create Item
curl --request POST \
--url https://api.jtl-cloud.com/erp/v2/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"categories": {
"categories": [
{
"categoryId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
},
"identifiers": {
"sku": "<string>",
"amazonFnsku": "<string>",
"gtin": "<string>",
"manufacturerNumber": "<string>",
"isbn": "<string>",
"tariccode": "<string>",
"upc": "<string>",
"unNumber": "<string>",
"hazardNumber": "<string>",
"ownIdentifier": "<string>",
"defaultAsin": "<string>",
"jfsku": "<string>"
},
"descriptions": {
"defaultDescriptions": [
{
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"salesChannelDescriptions": [
{
"salesChannelId": "<string>",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"platformDescriptions": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
]
},
"productGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"shippingClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"manufacturerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": {
"ignoreDiscounts": true,
"salesPriceNet": 123,
"suggestedRetailPrice": 123,
"purchasePriceNet": 123,
"ebayPrice": 123,
"amazonPrice": 123,
"salesChannelPrices": [
{
"saleschannelId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerGroupPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"isActive": true
}
],
"customerPrices": [
{
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"defaultPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
]
},
"suppliers": {
"defaultSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultDropshippingSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"suppliers": [
{
"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
}
]
}
]
},
"measurements": {
"height": 123,
"length": 123,
"shippingWeight": 123,
"weight": 123,
"width": 123
},
"variations": {
"variations": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"position": 123,
"values": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"itemNumber": "<string>",
"gTIN": "<string>",
"weightOffset": 123,
"surcharges": {
"defaultSurchargeNet": 123,
"customerGroupSurcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": true
}
],
"salesChannelSurcharges": [
{
"salesChannelId": "<string>",
"surcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": true
}
]
}
]
},
"position": 123,
"image": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
]
},
"features": {
"features": [
{
"featureId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
},
"attributes": {
"values": [
{
"attributeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultValues": [
{
"languageIso": "<string>",
"value": "<string>"
}
],
"salesChannelValues": [
{
"salesChannelId": "<string>",
"values": [
{
"languageIso": "<string>",
"value": "<string>"
}
]
}
]
}
]
},
"unitPricing": {
"salesUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"packagingUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"innerQuantity": 123,
"innerQuantityUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isBasePriceDeclared": true,
"basePriceReferenceUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"basePriceReferenceAmount": 123
},
"specialPrices": {
"isActive": true,
"startDate": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"isEndDateActive": true,
"minimumStockQuantity": 123,
"isStockRestrictionActive": true,
"salesChannelSpecialPrices": [
{
"salesChannelId": "<string>",
"specialPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"netPrice": 123,
"isActive": true
}
]
}
]
},
"crosssellingGroups": {
"groups": [
{
"crosssellingGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"items": [
{
"id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"sku": "<string>"
}
]
}
]
},
"images": {
"defaultImages": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
],
"platformImages": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
]
}
],
"saleschannelImages": [
{
"saleschannelId": "<string>",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
]
}
],
"ebayImages": [
{
"ebayAccountId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": true
}
]
}
]
},
"storageConstraints": {
"allowNegativeStock": true,
"itemPlatformNegativeStocks": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isNegativeStockAllowed": true
}
],
"itemSalesChannelNegativeStocks": [
{
"salesChannelId": "<string>",
"isNegativeStockAllowed": true
}
],
"buffer": 123,
"globalMinimumStockLevel": 123,
"hasBatch": true,
"isInventoryManagementActive": true,
"isBestBeforeManaged": true,
"isStockDivisible": true
},
"salesChannels": [
{
"salesChannelId": "<string>",
"includeItemImages": true
}
]
}
'import requests
url = "https://api.jtl-cloud.com/erp/v2/items"
payload = {
"categories": { "categories": [{ "categoryId": "b45f6432-2462-4c6f-b00f-1d9d01000000" }] },
"identifiers": {
"sku": "<string>",
"amazonFnsku": "<string>",
"gtin": "<string>",
"manufacturerNumber": "<string>",
"isbn": "<string>",
"tariccode": "<string>",
"upc": "<string>",
"unNumber": "<string>",
"hazardNumber": "<string>",
"ownIdentifier": "<string>",
"defaultAsin": "<string>",
"jfsku": "<string>"
},
"descriptions": {
"defaultDescriptions": [
{
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"salesChannelDescriptions": [
{
"salesChannelId": "<string>",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
],
"platformDescriptions": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"languageIso": "<string>",
"descriptionData": {
"itemName": "<string>",
"shortDescription": "<string>",
"description": "<string>",
"metaDescription": "<string>",
"metaKeywords": "<string>",
"titleTag": "<string>",
"urlPath": "<string>"
}
}
]
},
"productGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"shippingClassId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"manufacturerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": {
"ignoreDiscounts": True,
"salesPriceNet": 123,
"suggestedRetailPrice": 123,
"purchasePriceNet": 123,
"ebayPrice": 123,
"amazonPrice": 123,
"salesChannelPrices": [
{
"saleschannelId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"customerGroupPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"isActive": True
}
],
"customerPrices": [
{
"customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
],
"defaultPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"prices": [
{
"fromQuantity": 123,
"netPrice": 123,
"reduceStandardPriceByPercent": 123
}
]
}
]
},
"suppliers": {
"defaultSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultDropshippingSupplier": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"suppliers": [
{
"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
}
]
}
]
},
"measurements": {
"height": 123,
"length": 123,
"shippingWeight": 123,
"weight": 123,
"width": 123
},
"variations": { "variations": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"position": 123,
"values": [
{
"descriptions": [
{
"languageIso": "<string>",
"name": "<string>"
}
],
"variationValueId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"itemNumber": "<string>",
"gTIN": "<string>",
"weightOffset": 123,
"surcharges": {
"defaultSurchargeNet": 123,
"customerGroupSurcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": True
}
],
"salesChannelSurcharges": [
{
"salesChannelId": "<string>",
"surcharges": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"surcharge": 123,
"isActive": True
}
]
}
]
},
"position": 123,
"image": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}
]
}
] },
"features": { "features": [{ "featureId": "b45f6432-2462-4c6f-b00f-1d9d01000000" }] },
"attributes": { "values": [
{
"attributeId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"defaultValues": [
{
"languageIso": "<string>",
"value": "<string>"
}
],
"salesChannelValues": [
{
"salesChannelId": "<string>",
"values": [
{
"languageIso": "<string>",
"value": "<string>"
}
]
}
]
}
] },
"unitPricing": {
"salesUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"packagingUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"innerQuantity": 123,
"innerQuantityUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isBasePriceDeclared": True,
"basePriceReferenceUnitId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"basePriceReferenceAmount": 123
},
"specialPrices": {
"isActive": True,
"startDate": "2023-11-07T05:31:56Z",
"endDate": "2023-11-07T05:31:56Z",
"isEndDateActive": True,
"minimumStockQuantity": 123,
"isStockRestrictionActive": True,
"salesChannelSpecialPrices": [
{
"salesChannelId": "<string>",
"specialPrices": [
{
"customerGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"netPrice": 123,
"isActive": True
}
]
}
]
},
"crosssellingGroups": { "groups": [
{
"crosssellingGroupId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"items": [
{
"id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"sku": "<string>"
}
]
}
] },
"images": {
"defaultImages": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
],
"platformImages": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
]
}
],
"saleschannelImages": [
{
"saleschannelId": "<string>",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
]
}
],
"ebayImages": [
{
"ebayAccountId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"images": [
{
"blobIdentifier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sortNumber": 123,
"isMainImage": True
}
]
}
]
},
"storageConstraints": {
"allowNegativeStock": True,
"itemPlatformNegativeStocks": [
{
"platformId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
"isNegativeStockAllowed": True
}
],
"itemSalesChannelNegativeStocks": [
{
"salesChannelId": "<string>",
"isNegativeStockAllowed": True
}
],
"buffer": 123,
"globalMinimumStockLevel": 123,
"hasBatch": True,
"isInventoryManagementActive": True,
"isBestBeforeManaged": True,
"isStockDivisible": True
},
"salesChannels": [
{
"salesChannelId": "<string>",
"includeItemImages": True
}
]
}
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: {categories: [{categoryId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'}]},
identifiers: {
sku: '<string>',
amazonFnsku: '<string>',
gtin: '<string>',
manufacturerNumber: '<string>',
isbn: '<string>',
tariccode: '<string>',
upc: '<string>',
unNumber: '<string>',
hazardNumber: '<string>',
ownIdentifier: '<string>',
defaultAsin: '<string>',
jfsku: '<string>'
},
descriptions: {
defaultDescriptions: [
{
languageIso: '<string>',
descriptionData: {
itemName: '<string>',
shortDescription: '<string>',
description: '<string>',
metaDescription: '<string>',
metaKeywords: '<string>',
titleTag: '<string>',
urlPath: '<string>'
}
}
],
salesChannelDescriptions: [
{
salesChannelId: '<string>',
languageIso: '<string>',
descriptionData: {
itemName: '<string>',
shortDescription: '<string>',
description: '<string>',
metaDescription: '<string>',
metaKeywords: '<string>',
titleTag: '<string>',
urlPath: '<string>'
}
}
],
platformDescriptions: [
{
platformId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
languageIso: '<string>',
descriptionData: {
itemName: '<string>',
shortDescription: '<string>',
description: '<string>',
metaDescription: '<string>',
metaKeywords: '<string>',
titleTag: '<string>',
urlPath: '<string>'
}
}
]
},
productGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
shippingClassId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
manufacturerId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: {
ignoreDiscounts: true,
salesPriceNet: 123,
suggestedRetailPrice: 123,
purchasePriceNet: 123,
ebayPrice: 123,
amazonPrice: 123,
salesChannelPrices: [
{
saleschannelId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
customerGroupPrices: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: [{fromQuantity: 123, netPrice: 123, reduceStandardPriceByPercent: 123}]
}
],
isActive: true
}
],
customerPrices: [
{
customerId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: [{fromQuantity: 123, netPrice: 123, reduceStandardPriceByPercent: 123}]
}
],
defaultPrices: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
prices: [{fromQuantity: 123, netPrice: 123, reduceStandardPriceByPercent: 123}]
}
]
},
suppliers: {
defaultSupplier: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
defaultDropshippingSupplier: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
suppliers: [
{
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
}
]
}
]
},
measurements: {height: 123, length: 123, shippingWeight: 123, weight: 123, width: 123},
variations: {
variations: [
{
descriptions: [{languageIso: '<string>', name: '<string>'}],
variationId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
position: 123,
values: [
{
descriptions: [{languageIso: '<string>', name: '<string>'}],
variationValueId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
itemNumber: '<string>',
gTIN: '<string>',
weightOffset: 123,
surcharges: {
defaultSurchargeNet: 123,
customerGroupSurcharges: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
surcharge: 123,
isActive: true
}
],
salesChannelSurcharges: [
{
salesChannelId: '<string>',
surcharges: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
surcharge: 123,
isActive: true
}
]
}
]
},
position: 123,
image: 'b45f6432-2462-4c6f-b00f-1d9d01000000'
}
]
}
]
},
features: {features: [{featureId: 'b45f6432-2462-4c6f-b00f-1d9d01000000'}]},
attributes: {
values: [
{
attributeId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
defaultValues: [{languageIso: '<string>', value: '<string>'}],
salesChannelValues: [
{
salesChannelId: '<string>',
values: [{languageIso: '<string>', value: '<string>'}]
}
]
}
]
},
unitPricing: {
salesUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
packagingUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
innerQuantity: 123,
innerQuantityUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
isBasePriceDeclared: true,
basePriceReferenceUnitId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
basePriceReferenceAmount: 123
},
specialPrices: {
isActive: true,
startDate: '2023-11-07T05:31:56Z',
endDate: '2023-11-07T05:31:56Z',
isEndDateActive: true,
minimumStockQuantity: 123,
isStockRestrictionActive: true,
salesChannelSpecialPrices: [
{
salesChannelId: '<string>',
specialPrices: [
{
customerGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
netPrice: 123,
isActive: true
}
]
}
]
},
crosssellingGroups: {
groups: [
{
crosssellingGroupId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
items: [{id: 'b45f6432-2462-4c6f-b00f-1d9d01000000', sku: '<string>'}]
}
]
},
images: {
defaultImages: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
],
platformImages: [
{
platformId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
images: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
]
}
],
saleschannelImages: [
{
saleschannelId: '<string>',
images: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
]
}
],
ebayImages: [
{
ebayAccountId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
images: [
{
blobIdentifier: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sortNumber: 123,
isMainImage: true
}
]
}
]
},
storageConstraints: {
allowNegativeStock: true,
itemPlatformNegativeStocks: [
{
platformId: 'b45f6432-2462-4c6f-b00f-1d9d01000000',
isNegativeStockAllowed: true
}
],
itemSalesChannelNegativeStocks: [{salesChannelId: '<string>', isNegativeStockAllowed: true}],
buffer: 123,
globalMinimumStockLevel: 123,
hasBatch: true,
isInventoryManagementActive: true,
isBestBeforeManaged: true,
isStockDivisible: true
},
salesChannels: [{salesChannelId: '<string>', includeItemImages: true}]
})
};
fetch('https://api.jtl-cloud.com/erp/v2/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/v2/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' => [
'categories' => [
[
'categoryId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
],
'identifiers' => [
'sku' => '<string>',
'amazonFnsku' => '<string>',
'gtin' => '<string>',
'manufacturerNumber' => '<string>',
'isbn' => '<string>',
'tariccode' => '<string>',
'upc' => '<string>',
'unNumber' => '<string>',
'hazardNumber' => '<string>',
'ownIdentifier' => '<string>',
'defaultAsin' => '<string>',
'jfsku' => '<string>'
],
'descriptions' => [
'defaultDescriptions' => [
[
'languageIso' => '<string>',
'descriptionData' => [
'itemName' => '<string>',
'shortDescription' => '<string>',
'description' => '<string>',
'metaDescription' => '<string>',
'metaKeywords' => '<string>',
'titleTag' => '<string>',
'urlPath' => '<string>'
]
]
],
'salesChannelDescriptions' => [
[
'salesChannelId' => '<string>',
'languageIso' => '<string>',
'descriptionData' => [
'itemName' => '<string>',
'shortDescription' => '<string>',
'description' => '<string>',
'metaDescription' => '<string>',
'metaKeywords' => '<string>',
'titleTag' => '<string>',
'urlPath' => '<string>'
]
]
],
'platformDescriptions' => [
[
'platformId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'languageIso' => '<string>',
'descriptionData' => [
'itemName' => '<string>',
'shortDescription' => '<string>',
'description' => '<string>',
'metaDescription' => '<string>',
'metaKeywords' => '<string>',
'titleTag' => '<string>',
'urlPath' => '<string>'
]
]
]
],
'productGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'shippingClassId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'manufacturerId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
'ignoreDiscounts' => true,
'salesPriceNet' => 123,
'suggestedRetailPrice' => 123,
'purchasePriceNet' => 123,
'ebayPrice' => 123,
'amazonPrice' => 123,
'salesChannelPrices' => [
[
'saleschannelId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'customerGroupPrices' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
[
'fromQuantity' => 123,
'netPrice' => 123,
'reduceStandardPriceByPercent' => 123
]
]
]
],
'isActive' => true
]
],
'customerPrices' => [
[
'customerId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
[
'fromQuantity' => 123,
'netPrice' => 123,
'reduceStandardPriceByPercent' => 123
]
]
]
],
'defaultPrices' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'prices' => [
[
'fromQuantity' => 123,
'netPrice' => 123,
'reduceStandardPriceByPercent' => 123
]
]
]
]
],
'suppliers' => [
'defaultSupplier' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'defaultDropshippingSupplier' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'suppliers' => [
[
'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
]
]
]
]
],
'measurements' => [
'height' => 123,
'length' => 123,
'shippingWeight' => 123,
'weight' => 123,
'width' => 123
],
'variations' => [
'variations' => [
[
'descriptions' => [
[
'languageIso' => '<string>',
'name' => '<string>'
]
],
'variationId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'position' => 123,
'values' => [
[
'descriptions' => [
[
'languageIso' => '<string>',
'name' => '<string>'
]
],
'variationValueId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'itemNumber' => '<string>',
'gTIN' => '<string>',
'weightOffset' => 123,
'surcharges' => [
'defaultSurchargeNet' => 123,
'customerGroupSurcharges' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'surcharge' => 123,
'isActive' => true
]
],
'salesChannelSurcharges' => [
[
'salesChannelId' => '<string>',
'surcharges' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'surcharge' => 123,
'isActive' => true
]
]
]
]
],
'position' => 123,
'image' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
]
]
],
'features' => [
'features' => [
[
'featureId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000'
]
]
],
'attributes' => [
'values' => [
[
'attributeId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'defaultValues' => [
[
'languageIso' => '<string>',
'value' => '<string>'
]
],
'salesChannelValues' => [
[
'salesChannelId' => '<string>',
'values' => [
[
'languageIso' => '<string>',
'value' => '<string>'
]
]
]
]
]
]
],
'unitPricing' => [
'salesUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'packagingUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'innerQuantity' => 123,
'innerQuantityUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'isBasePriceDeclared' => true,
'basePriceReferenceUnitId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'basePriceReferenceAmount' => 123
],
'specialPrices' => [
'isActive' => true,
'startDate' => '2023-11-07T05:31:56Z',
'endDate' => '2023-11-07T05:31:56Z',
'isEndDateActive' => true,
'minimumStockQuantity' => 123,
'isStockRestrictionActive' => true,
'salesChannelSpecialPrices' => [
[
'salesChannelId' => '<string>',
'specialPrices' => [
[
'customerGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'netPrice' => 123,
'isActive' => true
]
]
]
]
],
'crosssellingGroups' => [
'groups' => [
[
'crosssellingGroupId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'items' => [
[
'id' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'sku' => '<string>'
]
]
]
]
],
'images' => [
'defaultImages' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
],
'platformImages' => [
[
'platformId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'images' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
]
]
],
'saleschannelImages' => [
[
'saleschannelId' => '<string>',
'images' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
]
]
],
'ebayImages' => [
[
'ebayAccountId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'images' => [
[
'blobIdentifier' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sortNumber' => 123,
'isMainImage' => true
]
]
]
]
],
'storageConstraints' => [
'allowNegativeStock' => true,
'itemPlatformNegativeStocks' => [
[
'platformId' => 'b45f6432-2462-4c6f-b00f-1d9d01000000',
'isNegativeStockAllowed' => true
]
],
'itemSalesChannelNegativeStocks' => [
[
'salesChannelId' => '<string>',
'isNegativeStockAllowed' => true
]
],
'buffer' => 123,
'globalMinimumStockLevel' => 123,
'hasBatch' => true,
'isInventoryManagementActive' => true,
'isBestBeforeManaged' => true,
'isStockDivisible' => true
],
'salesChannels' => [
[
'salesChannelId' => '<string>',
'includeItemImages' => true
]
]
]),
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"
payload := strings.NewReader("{\n \"categories\": {\n \"categories\": [\n {\n \"categoryId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"identifiers\": {\n \"sku\": \"<string>\",\n \"amazonFnsku\": \"<string>\",\n \"gtin\": \"<string>\",\n \"manufacturerNumber\": \"<string>\",\n \"isbn\": \"<string>\",\n \"tariccode\": \"<string>\",\n \"upc\": \"<string>\",\n \"unNumber\": \"<string>\",\n \"hazardNumber\": \"<string>\",\n \"ownIdentifier\": \"<string>\",\n \"defaultAsin\": \"<string>\",\n \"jfsku\": \"<string>\"\n },\n \"descriptions\": {\n \"defaultDescriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"salesChannelDescriptions\": [\n {\n \"salesChannelId\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"platformDescriptions\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ]\n },\n \"productGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"shippingClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"manufacturerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": {\n \"ignoreDiscounts\": true,\n \"salesPriceNet\": 123,\n \"suggestedRetailPrice\": 123,\n \"purchasePriceNet\": 123,\n \"ebayPrice\": 123,\n \"amazonPrice\": 123,\n \"salesChannelPrices\": [\n {\n \"saleschannelId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerGroupPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"isActive\": true\n }\n ],\n \"customerPrices\": [\n {\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"defaultPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ]\n },\n \"suppliers\": {\n \"defaultSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultDropshippingSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"suppliers\": [\n {\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 ]\n },\n \"measurements\": {\n \"height\": 123,\n \"length\": 123,\n \"shippingWeight\": 123,\n \"weight\": 123,\n \"width\": 123\n },\n \"variations\": {\n \"variations\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"position\": 123,\n \"values\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"itemNumber\": \"<string>\",\n \"gTIN\": \"<string>\",\n \"weightOffset\": 123,\n \"surcharges\": {\n \"defaultSurchargeNet\": 123,\n \"customerGroupSurcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ],\n \"salesChannelSurcharges\": [\n {\n \"salesChannelId\": \"<string>\",\n \"surcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"position\": 123,\n \"image\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ]\n },\n \"features\": {\n \"features\": [\n {\n \"featureId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"attributes\": {\n \"values\": [\n {\n \"attributeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultValues\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"salesChannelValues\": [\n {\n \"salesChannelId\": \"<string>\",\n \"values\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"unitPricing\": {\n \"salesUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"packagingUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"innerQuantity\": 123,\n \"innerQuantityUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isBasePriceDeclared\": true,\n \"basePriceReferenceUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"basePriceReferenceAmount\": 123\n },\n \"specialPrices\": {\n \"isActive\": true,\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"isEndDateActive\": true,\n \"minimumStockQuantity\": 123,\n \"isStockRestrictionActive\": true,\n \"salesChannelSpecialPrices\": [\n {\n \"salesChannelId\": \"<string>\",\n \"specialPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"netPrice\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"crosssellingGroups\": {\n \"groups\": [\n {\n \"crosssellingGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"items\": [\n {\n \"id\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"sku\": \"<string>\"\n }\n ]\n }\n ]\n },\n \"images\": {\n \"defaultImages\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ],\n \"platformImages\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"saleschannelImages\": [\n {\n \"saleschannelId\": \"<string>\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"ebayImages\": [\n {\n \"ebayAccountId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ]\n },\n \"storageConstraints\": {\n \"allowNegativeStock\": true,\n \"itemPlatformNegativeStocks\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"itemSalesChannelNegativeStocks\": [\n {\n \"salesChannelId\": \"<string>\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"buffer\": 123,\n \"globalMinimumStockLevel\": 123,\n \"hasBatch\": true,\n \"isInventoryManagementActive\": true,\n \"isBestBeforeManaged\": true,\n \"isStockDivisible\": true\n },\n \"salesChannels\": [\n {\n \"salesChannelId\": \"<string>\",\n \"includeItemImages\": true\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")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"categories\": {\n \"categories\": [\n {\n \"categoryId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"identifiers\": {\n \"sku\": \"<string>\",\n \"amazonFnsku\": \"<string>\",\n \"gtin\": \"<string>\",\n \"manufacturerNumber\": \"<string>\",\n \"isbn\": \"<string>\",\n \"tariccode\": \"<string>\",\n \"upc\": \"<string>\",\n \"unNumber\": \"<string>\",\n \"hazardNumber\": \"<string>\",\n \"ownIdentifier\": \"<string>\",\n \"defaultAsin\": \"<string>\",\n \"jfsku\": \"<string>\"\n },\n \"descriptions\": {\n \"defaultDescriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"salesChannelDescriptions\": [\n {\n \"salesChannelId\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"platformDescriptions\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ]\n },\n \"productGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"shippingClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"manufacturerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": {\n \"ignoreDiscounts\": true,\n \"salesPriceNet\": 123,\n \"suggestedRetailPrice\": 123,\n \"purchasePriceNet\": 123,\n \"ebayPrice\": 123,\n \"amazonPrice\": 123,\n \"salesChannelPrices\": [\n {\n \"saleschannelId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerGroupPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"isActive\": true\n }\n ],\n \"customerPrices\": [\n {\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"defaultPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ]\n },\n \"suppliers\": {\n \"defaultSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultDropshippingSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"suppliers\": [\n {\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 ]\n },\n \"measurements\": {\n \"height\": 123,\n \"length\": 123,\n \"shippingWeight\": 123,\n \"weight\": 123,\n \"width\": 123\n },\n \"variations\": {\n \"variations\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"position\": 123,\n \"values\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"itemNumber\": \"<string>\",\n \"gTIN\": \"<string>\",\n \"weightOffset\": 123,\n \"surcharges\": {\n \"defaultSurchargeNet\": 123,\n \"customerGroupSurcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ],\n \"salesChannelSurcharges\": [\n {\n \"salesChannelId\": \"<string>\",\n \"surcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"position\": 123,\n \"image\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ]\n },\n \"features\": {\n \"features\": [\n {\n \"featureId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"attributes\": {\n \"values\": [\n {\n \"attributeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultValues\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"salesChannelValues\": [\n {\n \"salesChannelId\": \"<string>\",\n \"values\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"unitPricing\": {\n \"salesUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"packagingUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"innerQuantity\": 123,\n \"innerQuantityUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isBasePriceDeclared\": true,\n \"basePriceReferenceUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"basePriceReferenceAmount\": 123\n },\n \"specialPrices\": {\n \"isActive\": true,\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"isEndDateActive\": true,\n \"minimumStockQuantity\": 123,\n \"isStockRestrictionActive\": true,\n \"salesChannelSpecialPrices\": [\n {\n \"salesChannelId\": \"<string>\",\n \"specialPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"netPrice\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"crosssellingGroups\": {\n \"groups\": [\n {\n \"crosssellingGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"items\": [\n {\n \"id\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"sku\": \"<string>\"\n }\n ]\n }\n ]\n },\n \"images\": {\n \"defaultImages\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ],\n \"platformImages\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"saleschannelImages\": [\n {\n \"saleschannelId\": \"<string>\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"ebayImages\": [\n {\n \"ebayAccountId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ]\n },\n \"storageConstraints\": {\n \"allowNegativeStock\": true,\n \"itemPlatformNegativeStocks\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"itemSalesChannelNegativeStocks\": [\n {\n \"salesChannelId\": \"<string>\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"buffer\": 123,\n \"globalMinimumStockLevel\": 123,\n \"hasBatch\": true,\n \"isInventoryManagementActive\": true,\n \"isBestBeforeManaged\": true,\n \"isStockDivisible\": true\n },\n \"salesChannels\": [\n {\n \"salesChannelId\": \"<string>\",\n \"includeItemImages\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.jtl-cloud.com/erp/v2/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 \"categories\": [\n {\n \"categoryId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"identifiers\": {\n \"sku\": \"<string>\",\n \"amazonFnsku\": \"<string>\",\n \"gtin\": \"<string>\",\n \"manufacturerNumber\": \"<string>\",\n \"isbn\": \"<string>\",\n \"tariccode\": \"<string>\",\n \"upc\": \"<string>\",\n \"unNumber\": \"<string>\",\n \"hazardNumber\": \"<string>\",\n \"ownIdentifier\": \"<string>\",\n \"defaultAsin\": \"<string>\",\n \"jfsku\": \"<string>\"\n },\n \"descriptions\": {\n \"defaultDescriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"salesChannelDescriptions\": [\n {\n \"salesChannelId\": \"<string>\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ],\n \"platformDescriptions\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"languageIso\": \"<string>\",\n \"descriptionData\": {\n \"itemName\": \"<string>\",\n \"shortDescription\": \"<string>\",\n \"description\": \"<string>\",\n \"metaDescription\": \"<string>\",\n \"metaKeywords\": \"<string>\",\n \"titleTag\": \"<string>\",\n \"urlPath\": \"<string>\"\n }\n }\n ]\n },\n \"productGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"shippingClassId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"manufacturerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": {\n \"ignoreDiscounts\": true,\n \"salesPriceNet\": 123,\n \"suggestedRetailPrice\": 123,\n \"purchasePriceNet\": 123,\n \"ebayPrice\": 123,\n \"amazonPrice\": 123,\n \"salesChannelPrices\": [\n {\n \"saleschannelId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"customerGroupPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"isActive\": true\n }\n ],\n \"customerPrices\": [\n {\n \"customerId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ],\n \"defaultPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"prices\": [\n {\n \"fromQuantity\": 123,\n \"netPrice\": 123,\n \"reduceStandardPriceByPercent\": 123\n }\n ]\n }\n ]\n },\n \"suppliers\": {\n \"defaultSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultDropshippingSupplier\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"suppliers\": [\n {\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 ]\n },\n \"measurements\": {\n \"height\": 123,\n \"length\": 123,\n \"shippingWeight\": 123,\n \"weight\": 123,\n \"width\": 123\n },\n \"variations\": {\n \"variations\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"position\": 123,\n \"values\": [\n {\n \"descriptions\": [\n {\n \"languageIso\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"variationValueId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"itemNumber\": \"<string>\",\n \"gTIN\": \"<string>\",\n \"weightOffset\": 123,\n \"surcharges\": {\n \"defaultSurchargeNet\": 123,\n \"customerGroupSurcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ],\n \"salesChannelSurcharges\": [\n {\n \"salesChannelId\": \"<string>\",\n \"surcharges\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"surcharge\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"position\": 123,\n \"image\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n }\n ]\n },\n \"features\": {\n \"features\": [\n {\n \"featureId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\"\n }\n ]\n },\n \"attributes\": {\n \"values\": [\n {\n \"attributeId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"defaultValues\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"salesChannelValues\": [\n {\n \"salesChannelId\": \"<string>\",\n \"values\": [\n {\n \"languageIso\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n },\n \"unitPricing\": {\n \"salesUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"packagingUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"innerQuantity\": 123,\n \"innerQuantityUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isBasePriceDeclared\": true,\n \"basePriceReferenceUnitId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"basePriceReferenceAmount\": 123\n },\n \"specialPrices\": {\n \"isActive\": true,\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"isEndDateActive\": true,\n \"minimumStockQuantity\": 123,\n \"isStockRestrictionActive\": true,\n \"salesChannelSpecialPrices\": [\n {\n \"salesChannelId\": \"<string>\",\n \"specialPrices\": [\n {\n \"customerGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"netPrice\": 123,\n \"isActive\": true\n }\n ]\n }\n ]\n },\n \"crosssellingGroups\": {\n \"groups\": [\n {\n \"crosssellingGroupId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"items\": [\n {\n \"id\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"sku\": \"<string>\"\n }\n ]\n }\n ]\n },\n \"images\": {\n \"defaultImages\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ],\n \"platformImages\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"saleschannelImages\": [\n {\n \"saleschannelId\": \"<string>\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ],\n \"ebayImages\": [\n {\n \"ebayAccountId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"images\": [\n {\n \"blobIdentifier\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sortNumber\": 123,\n \"isMainImage\": true\n }\n ]\n }\n ]\n },\n \"storageConstraints\": {\n \"allowNegativeStock\": true,\n \"itemPlatformNegativeStocks\": [\n {\n \"platformId\": \"b45f6432-2462-4c6f-b00f-1d9d01000000\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"itemSalesChannelNegativeStocks\": [\n {\n \"salesChannelId\": \"<string>\",\n \"isNegativeStockAllowed\": true\n }\n ],\n \"buffer\": 123,\n \"globalMinimumStockLevel\": 123,\n \"hasBatch\": true,\n \"isInventoryManagementActive\": true,\n \"isBestBeforeManaged\": true,\n \"isStockDivisible\": true\n },\n \"salesChannels\": [\n {\n \"salesChannelId\": \"<string>\",\n \"includeItemImages\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"itemId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}{
"errorCode": "<string>",
"validationErrors": {},
"errors": {},
"errorMessage": "<string>",
"stacktrace": "<string>"
}{
"errorCode": "<string>",
"validationErrors": {},
"errors": {},
"errorMessage": "<string>",
"stacktrace": "<string>"
}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.
Body
application/json
Request parameters
Creates a new regular item with all specified properties. This command enables complete configuration of an item including identifiers, descriptions, prices, and measurements. - Request
Category assignments of the item. Defines all categories to which the item should be assigned for better organization and navigation.
Show child attributes
Show child attributes
Identifiers of the item with all relevant markings and numbers for unique identification of the item in various systems.
Show child attributes
Show child attributes
Descriptions of the item in different languages and for different platforms/sales channels. Includes names, short and long descriptions as well as SEO-relevant information.
Show child attributes
Show child attributes
The ID of the product group to which the item should be assigned. Product groups serve for categorical classification of items for reports and analyses.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
The ID of the shipping class to which the item should be assigned.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
The ID of the manufacturer to which the item should be assigned.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Price structures of the item for different sales channels, customer groups and individual customers. Includes sales prices, purchase prices and tier prices.
Show child attributes
Show child attributes
Suppliers associated with the item including supplier-specific information such as purchase prices, delivery times and order intervals.
Show child attributes
Show child attributes
Physical dimensions and weight specifications of the item for storage, shipping and product presentation. Important for shipping cost calculations and storage space optimization.
Show child attributes
Show child attributes
Custom fields defined for the item to store additional information. Useful for special requirements or integrations.
Show child attributes
Show child attributes
Variations of an item
Show child attributes
Show child attributes
Features of an item
Show child attributes
Show child attributes
Attributes of an item
Show child attributes
Show child attributes
UnitPricing information of an item
Show child attributes
Show child attributes
SpecialPrices information of an item
Show child attributes
Show child attributes
CrosssellingGroups of an item
Show child attributes
Show child attributes
Images of the item. Not processed by this operation - assign images with PATCH /v2/items/{itemId} once the item exists.
Show child attributes
Show child attributes
ItemStorageConstraints information of an item
Show child attributes
Show child attributes
A list of sales channels that should be activated after a successful creation of the item. Omitting the property, sending an empty list and sending null all activate no sales channel. A sales channel that does not resolve to an activatable sales channel is rejected before the item is created, so no item is left behind. A sales channel that resolves but is incompatible with the item is skipped without an error. IncludeItemImages has no effect on this endpoint, because a newly created item has no images to copy.
Show child attributes
Show child attributes
Response
Item was successfully created
Creates a new regular item with all specified properties. This command enables complete configuration of an item including identifiers, descriptions, prices, and measurements. - Response
Unique ID of the newly created item - this key is used for all further operations with the item.
Example:
"b45f6432-2462-4c6f-b00f-1d9d01000000"
Was this page helpful?