1. Master Import
V8STD
  • Index
  • Inventory
    • TrfRsAdj
      POST
    • GRConfirm
      POST
    • ItemStockOnHand
      POST
    • GRUpdate
      POST
    • QtyAdj
      POST
    • TrfRsOut
      POST
    • QtyAdjConfirm
      POST
    • StkCntUpdate
      POST
    • GoodsReturnUpdate
      POST
    • GoodsReturnConfirm
      POST
    • TrfRsIn
      POST
    • TrfReqConfirm
      POST
    • TrfReq
      POST
    • POUpdate
      POST
    • POStatusChange
      POST
    • TrfRsConfirm
      POST
  • Inventory Enquiry
    • enq_TrfRsOsNote
      POST
    • enq_TrfRs
      POST
  • Master
    • itemSearchTTPos
      POST
  • Master Export
    • barCodeExport
      POST
    • storeExport
      POST
    • staffExport
      POST
    • ReasonExport
      POST
    • itemPriceExport
      POST
    • itemMasterExport
      POST
    • tenderExport
      POST
  • Master Import
    • itemPriceImport
      POST
    • barcodeImport
      POST
    • itemMasterImport
      POST
    • staffImport
      POST
  • Sales
    • salesTransStd
    • salesValidate
    • salesVoid
    • salesMemoStdEnquiry
  • Vip
    • vipBonusAdjustVipStd
    • vipSearchVipStd
    • vipMasterBasicCreateVipStd
    • vipBonusEnquiryVipStd
  • Device Login
    • Get_APIKEY
  1. Master Import

itemMasterImport

测试中
POST
/posservice/rest/import/itemmaster
itemMasterImport 货品主档信息导入
该接口根据请求内的数据,插入到本地数据库中对应表数据(表名:货品主档表,货号对照表,条码表)
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
上一页
barcodeImport
下一页
staffImport
Built with