itemMasterImport
测试中
POST
/posservice/rest/import/itemmaster
该接口根据请求内的数据，插入到本地数据库中对应表数据（表名：货品主档表，货号对照表，条码表）
This interface inserts the corresponding table data into the local database based on the data in the request . (table name: xf_itemmas,xf_itemlookup,xf_altlookup)
PS. 如果貨品有顏色尺碼的貨品，第一次創建先只導入itemRecord 信息，第二次才導入pluRecods 信息
请求参数
Authorization
在 header 添加参数
apiKey
示例：
apiKey: ********************Body 参数application/json
示例
{
"records": [
{
"itemRecord": {
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_desci": "test item",
"xf_longdesc": "test item long description",
"xf_colorlist": "WH*BK",
"xf_sizegroup": "SG02",
"xf_storechoice": "$001$002$",
"xf_itemoption": "L",
"xf_itemlotmethod": null,
"xf_remark": "",
"xf_stkunit": "PC",
"xf_salesunit": "PC",
"xf_exstk2sales": 1,
"xf_replpackqty": 1,
"xf_group0": "TT",
"xf_group1": "XXL",
"xf_group2": null,
"xf_group3": null,
"xf_group4": null,
"xf_group5": null,
"xf_group6": null,
"xf_group7": null,
"xf_group8": null,
"xf_group9": null,
"xf_group10": null,
"xf_group11": null,
"xf_group12": null,
"xf_group13": null,
"xf_group14": null,
"xf_group15": null,
"xf_group16": null,
"xf_group17": null,
"xf_group18": null,
"xf_group19": null,
"xf_group20": null,
"xf_group21": null,
"xf_group22": null,
"xf_group23": null,
"xf_group24": null,
"xf_group25": null,
"xf_group26": null,
"xf_group27": null,
"xf_group28": null,
"xf_group29": null,
"xf_createby": "HKADMIN",
"xf_createdate": "2023-06-01 16:20:00",
"xf_version": 1
},
"pluRecords": [
{
"xf_plu": "AC01WHS",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "WH",
"xf_size": "S",
"xf_version": 1
},
{
"xf_plu": "AC01WHM",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "WH",
"xf_size": "M",
"xf_version": 1
},
{
"xf_plu": "AC01WHL",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "WH",
"xf_size": "L",
"xf_version": 1
},
{
"xf_plu": "AC01BKS",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "BK",
"xf_size": "S",
"xf_version": 1
},
{
"xf_plu": "AC01BKM",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "BK",
"xf_size": "M",
"xf_version": 1
},
{
"xf_plu": "AC01BKM",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "BK",
"xf_size": "L",
"xf_version": 1
}
],
"barcodeRecords": [
{
"xf_altitem": "1112333456",
"xf_itemorgid": "000001",
"xf_plu": "AC01",
"xf_alttype": "1",
"xf_altformat": null,
"xf_alt2plufactor": null,
"xf_promid": null,
"xf_version": 1
},
{
"xf_altitem": "123456184",
"xf_itemorgid": "000001",
"xf_plu": "AC01",
"xf_alttype": "1",
"xf_altformat": null,
"xf_alt2plufactor": null,
"xf_promid": null,
"xf_version": 1
}
]
}
],
"apiKey": "{{apiKey}}"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/posservice/rest/import/itemmaster' \
--header 'apiKey: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"records": [
{
"itemRecord": {
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_desci": "test item",
"xf_longdesc": "test item long description",
"xf_colorlist": "WH*BK",
"xf_sizegroup": "SG02",
"xf_storechoice": "$001$002$",
"xf_itemoption": "L",
"xf_itemlotmethod": null,
"xf_remark": "",
"xf_stkunit": "PC",
"xf_salesunit": "PC",
"xf_exstk2sales": 1,
"xf_replpackqty": 1,
"xf_group0": "TT",
"xf_group1": "XXL",
"xf_group2": null,
"xf_group3": null,
"xf_group4": null,
"xf_group5": null,
"xf_group6": null,
"xf_group7": null,
"xf_group8": null,
"xf_group9": null,
"xf_group10": null,
"xf_group11": null,
"xf_group12": null,
"xf_group13": null,
"xf_group14": null,
"xf_group15": null,
"xf_group16": null,
"xf_group17": null,
"xf_group18": null,
"xf_group19": null,
"xf_group20": null,
"xf_group21": null,
"xf_group22": null,
"xf_group23": null,
"xf_group24": null,
"xf_group25": null,
"xf_group26": null,
"xf_group27": null,
"xf_group28": null,
"xf_group29": null,
"xf_createby": "HKADMIN",
"xf_createdate": "2023-06-01 16:20:00",
"xf_version": 1
},
"pluRecords": [
{
"xf_plu": "AC01WHS",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "WH",
"xf_size": "S",
"xf_version": 1
},
{
"xf_plu": "AC01WHM",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "WH",
"xf_size": "M",
"xf_version": 1
},
{
"xf_plu": "AC01WHL",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "WH",
"xf_size": "L",
"xf_version": 1
},
{
"xf_plu": "AC01BKS",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "BK",
"xf_size": "S",
"xf_version": 1
},
{
"xf_plu": "AC01BKM",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "BK",
"xf_size": "M",
"xf_version": 1
},
{
"xf_plu": "AC01BKM",
"xf_style": "AC01",
"xf_itemorgid": "000001",
"xf_color": "BK",
"xf_size": "L",
"xf_version": 1
}
],
"barcodeRecords": [
{
"xf_altitem": "1112333456",
"xf_itemorgid": "000001",
"xf_plu": "AC01",
"xf_alttype": "1",
"xf_altformat": null,
"xf_alt2plufactor": null,
"xf_promid": null,
"xf_version": 1
},
{
"xf_altitem": "123456184",
"xf_itemorgid": "000001",
"xf_plu": "AC01",
"xf_alttype": "1",
"xf_altformat": null,
"xf_alt2plufactor": null,
"xf_promid": null,
"xf_version": 1
}
]
}
],
"apiKey": "{{apiKey}}"
}'返回响应
🟢200成功
application/json
Body
示例
{
"asynCode": null,
"asynMessage": null,
"asynStatus": 0,
"className": "com.techtrans.api.master.website.itemimport.ItemMasterImportResponse",
"errorCode": 0,
"errorLog": null,
"errorMessage": null,
"failureCount": 0,
"importErrorLog": {},
"length": 25,
"sort": "",
"start": 0,
"successCount": 1,
"total": 0
}🟢200处理数据失败
🟠404响应失败
修改于 2026-03-20 08:45:59