BOM Data

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

remark：Bom covers all business contents of ODM，ODM builds complete machines/half machines and semi-finished products by itself for all Lenovo sites, and this Scope is only available for DBDS. It does not interfere with the BS BOM currently transmitted by ODM and is separate from each other

Frequency	Time	Data amount
Daily	0:00:00	Incremental/full

Request address

• API

Environment	URL
Test	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/odm/bom
Prod	https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/bom

• FTP

Environment	Partner directory	Lenovo directory	File name
Test	/Planning/SCC/{appName}/odm/bom/	/Planning/SCC/{appName}/odm/bom/feedback/	bom_{crud}_{yyyyMMddHHmmss}_
Prod	/Planning/SCC/{appName}/odm/bom/	/Planning/SCC/{appName}/odm/bom/feedback/	bom_{crud}_{yyyyMMddHHmmss}_

Sample：/Planning/SCC/LCFC/odm/bom/bom_update_20220928123000_001

Request data description

Param	Key	Field Type	Length	Required	PCG-NB	ISG	MBG-Moblie	MDSC-TB	PCG-Smart Device	PCG-Docking	PCG-DT	Description	Example
uid		String	32									unique id
bu	Y	String	50	Y	Y	Y	Y	Y	Y	Y	Y	ThinkNB/IdeaNB/ThinkDT/IdeaDT	ThinkNB
odm	Y	String	100	Y	Y	Y	Y	Y	Y	Y	Y	ODM name	LCFC
odm_father_item	Y	String	20	Y	Y	Y	Y	Y	Y	Y	Y	ODM father item part number	712801000000
father_item		String	50	Y	Y	Y	Y	Y	Y	Y	Y	Lenovo father item part number	SA78D09909
odm_child_item	Y	String	20	Y	Y	Y	Y	Y	Y	Y	Y	ODM child item part number	BLXSC28C60966
child_item		String	50									Lenovo child item part number	SC28C60966
quantity_per		Number	10.6	Y	Y	Y	Y	Y	Y	Y	Y	usage num in father item	100
effective_start_date		Date		Y	Y	Y	Y	Y	Y	Y	Y	BOM effective start time	2000-08-01
effective_end_date		Date		Y	Y	Y	Y	Y	Y	Y	Y	BOM effective end time	2000-08-01
priority		Integer	3	Y	Y	Y	Y	Y	Y	Y	Y	priority of alternative item	2
alternative_code	Y	String	50	Y	Y	Y	Y	Y	Y	Y	Y	alternative code	34
split		Number	1.2									split in bom	0.2
version		String	14	Y	Y	Y	Y	Y	Y	Y	Y	version. in format: yyyyMMddHHmmss	20220801152347
remark		String	200									remark
comment1		String	100									reserved field
comment2		String	100									reserved field

Response data description

Param	Type	Description
code	String	0: success, others:failed
msg	String	the detail message, especially useful on failure

Request sample

{
  "batch_id": "10197",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "bu": "ThinkNB",
      "odm": "LCFC",
      "odm_father_item": "712801000000",
      "father_item": "SA78D09909   ",
      "odm_child_item": "BLXSC28C60966",
      "child_item": "SC28C60966   ",
      "quantity_per": "100",
      "effective_start_date": "2022-08-01",
      "effective_end_date": "2022-08-01",
      "priority": "2",
      "alternative_code": "34",
      "split": "0.2",
      "version": "20220801152347",
      "remark": "self input",
      "comment1": "",
      "comment2": ""
    }
  ]
}

Success response sample

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

Fail response sample

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