The endoint definition can be found in the common information.
The importconfigkey for the simple item import is defaultimportitemsV2.
The valid json looks like that for a set item:
[
{
"__id": "{{__id}}",
"__organizationalId": "{{__organizationalId}}",
"taxGroupID": "{{taxGroupID}}",
"unitlistprice": {{unitlistprice}},
"key": {
"itemIdentifier": {}
},
"texts": {
"name": {
"i18nVariants": {
"de_DE": "{{name_de_de}}"
}
}
},
"image": [],
"discountFlag": {{discountFlag}},
"returnAble": {{returnAble}},
"manualPriceOverwriteAllowed": {{manualPriceOverwriteAllowed}},
"zeroPriceAllowed": {{zeroPriceAllowed}},
"manualPriceEntry": {{manualPriceEntry}},
"taxExemptProhibitedFlag": {{taxExemptProhibitedFlag}},
"buttonGroups": [],
"itemGroups": [],
"mainPOSItemId": "{{mainPOSItemId}}",
"optionItems": [],
"setComponents": [
{
"id": "{{set_part1_id}}",
"name": {
"i18nVariants": {
"de_DE": "{{set_part1_name_de_de}}"
}
},
"items": [
{
"relation": "{{set_item_1_id}}",
"quantity": {{set_item_1_qty}}
}
]
},
{
"id": "{{set_part2_id}}",
"name": {
"i18nVariants": {
"de_DE": "{{set_part2_name_de_de}}"
}
},
"items": [
{
"relation": "{{set_item_2_id}}",
"quantity": {{set_item_2_qty}}
}
]
},
{
"id": "{{set_part3_id}}",
"name": {
"i18nVariants": {
"de_DE": "{{set_part3_name_de_de}}"
}
},
"items": [
{
"relation": "{{set_item_3_id}}",
"quantity": {{set_item_3_qty}}
}
]
}
],
"itemCategory": "{{itemCategory}}",
"choiceGroups": [],
"printUsecases": [],
"additions": []
}
]Field | |
__id | Type: NNNNN - string Sample: "12345" Description: The internal, unique ID for the item. Should be the same as the MainPosItemID |
__organizationalId | Type:- Sample: "Nli1bkf_0" or "-1" Description: The unique ID for the concerning organization. If there are multiple stores and the item is only available in specific store, you need the organizationalId for the appropiate store. |
taxGroupID | Type: "N" - string Sample: "2" Description: 1 - Item without tax 2 - Item with standard tax rate 3- Item with reduced tax rate |
unitlistprice | Type: NN.NN - numeric Sample: 39.99 Description: The price of the item. Important: It is necessary to use a point as seperator. |
texts/name | Type: "TEXT" - string Sample: "Newspaper" Description: The name of the item. |
image | Type: - Sample: "Nli1bkf_A0" Description: The internal id of the image. |
discountFlag | Type: True / False - boolean Sample: True Description: Specifies whether an item is discountable or not. |
returnAble | Type: True / False - boolean Sample: True Description: Specifies whether an item is returnable or not. |
manualPriceOverwriteAllowed | Type: True / False - boolean Sample: True Description: Specifies whether an item price may be manually overwritten or not. |
zeroPriceAllowed | Type: True / False - boolean Sample: True Description: Specifies whether an item may have a price of "0.00" or not. |
manualPriceEntry | Type: True / False - boolean Sample: True Description: Specifies whether a window for manual price entry should be opened after scanning the item or not. |
taxExemptProhibitedFlag | Type: True / False - boolean Sample: True Description: Specifies whether the item can be sold as tax free or not. |
mainPOSItemId | Type: "NNNNN" - string Sample: "12345" or "ABC-123 Description: The unique ID for the item, like a item or part number. This ID will be scanned at the POS. |
itemGroup | Type: "NNNN" - string Sample: "12345" or "ABC-123" Description: Links this item to the selected item group. |
buttonGroups | Type: string Sample: "12345" Description: The unique ID for the link to the assigned item groups |
itemCategory | Type: "DEFAULT", "GIFTCARD", "VARIANTMASTER", "VARIANTSSUB", "SET", "OPTION" Sample: "VARIANT_MASTER" Description: The category to which an item should be assigned. (e.g. default, set etc.) |
setComponents_id | Type: NNNNN - string Sample: "12345" Description: The internal, unique ID for the set part. |
setComponents_name | Type: "TEXT" - string Sample: "Part #1" Description: The name of the set part. |
setComponents_items_relation | Type: NNNNN - string Sample: "12345" Description: The internal, unique ID of the item which should be inside the part of the set. |
setComponents_items_qty | Type: Number Sample: "1" Description: In what quantity should the set part contain the item? |
The Postman project below contains all the necessary files to illustrate an example use-case.
Download postman project "Set case"
Import all the existing .json files into postman.
Enter the following data in the included environments:
- baseURL
- username
- password
Leave all other entries unchanged.
Open the imported "ITEM API | Set Parts"-Collection in the postman app.
On the top right corner, assign the imported "ITEM API | Set Part 1"-Environment to the opened collection.
Click the "Send"-Button to send the post to your management console.
Switch back to the opened collection and assign "ITEM API | Set Part 2"-Environment on the top right corner.
Click the "Send"-Button to send the post to your management console.
Switch back to the opened collection and assign "ITEM API | Set Part 3"-Environment on the top right corner.
Click the "Send"-Button to send the post to your management console.
Open the imported "ITEM API | Set"-Collection in the postman app.
On the top right corner, assign the imported "ITEM API | Set"-Environment to the opened collection.
Click the "Send"-Button to send the post to your management console.
Result: The four items should now appear in your management console. Furthermore, in the detail/edit view you should be able to see that the set item includes the 3 default items.