Inventory Data

This interface is applicable for data integration API, read Api Access Process first

frequency	time	data amount
Daily	0:00 BJ Time	Daily version of data (full amount)

• API

Env	URL
test	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/ems/inventory
prd	https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/ems/inventory

business data description

Parameter	Key	Field type	Field Length	Required	description	Example
bu	Y	String	50	Y	Lenovo business unit, fixed values as shown in Appendix, use slash to concatenate multiple BUs	IdeaNB/ThinkNB
ems	Y	String	40	Y	EMS name	ems1
ems_pn	Y	String	20	Y	EMS part number	parts1
lenovo_pn		String	18	Y for material_type=DS /BS /FG	Lenovo part number	lnv_pn1
material_type		String	10	Y	FG/SFG/DB/DS/BS, fixed values as shown in Appendix	DS
location	Y	String	50	Y	EMS storage location	ABCD
location_desc		String	100		EMS storage location description
ems_qty		Number	10,6	Y	EMS own inventory =unrestricted_qty+inspection_qty+block_qty	1
ems_hub_qty		Number	10,6
po	Y	String	200	Y	Purchase order number, use slash to concatenate multiple POs, put '0' for non-FG	po1
unrestricted_qty		Number	10,6	Y	unrestricted stock	1
inspection_qty		Number	10,6	Y	inspection stock
block_qty		Number	10,6		blocked stock	1
remark		String	200
version	Y	String	14	Y	Data cutoff time, yyyyMMddHHmmss	20220915000000
comment1		String	100
comment2		String	100

request sample

{
  "batch_id": "10097",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "bu": "IdeaNB/ThinkNB",
      "ems": "ems1",
      "ems_pn": "parts1",
      "lenovo_pn": "lnv_pn1",
      "material_type": "DS",
      "location": "ABCD",
      "location_desc": "12312312",
      "ems_qty": "104",
      "ems_hub_qty": "20",
      "po": "po1",
      "unrestricted_qty": "0.00",
      "inspection_qty": "2",
      "block_qty": "",
      "remark": "",
      "version": "20220915020433",
      "comment1": "",
      "comment2": ""
    }
  ]
}

success response sample

{
  "code": "0",
  "msg": "request success"
}

failed response sample

{
    "code": "E00V00",
    "msg": "data verification failed！",
    "result": [{
        "row": {
            "ems": "ems1",
            ...
        },
        "verify": [{
            "type": "value length exceed",
            "fields": "version"
        }]
    }]
}