GR 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(Incremental)

• API

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

business data description

Parameter	key	Field Type	Required	Length	Description	Example
bu	Y	String	Y	50	Lenovo business unit, fixed values as shown in Appendix	ThinkNB
ems	Y	String	Y	40	EMS name	****
ems_pn	Y	String	Y	20	EMS part number	****
ems_pn_desc		String		100	EMS part number description
lenovo_pn		String		18	Lenovo part number	****
material_type		String		10	SFG/BS/DS/DB	BS
mfg_pn		String		200	manufacturer Part Number
ems_po	Y	String	Y	20	purchase order number	****
ems_po_line	Y	String	Y	10	purchase order line	10
gr_qty		Number	Y	13,3	goods received quantity	100
gr_date	Y	Date	Y		goods received date	2022-08-01
movement_type	Y	String	Y	20	Return/GR/CANCEL	GR
ems_supplier_code		String	Y	20	EMS supplier code	****
ems_supplier_name		String		100	EMS supplier name	****LIMITED
ship_to_name		String		100	ship to plant	**** plant
gr	Y	String	Y	50	gr batch ID	****
gr_line	Y	String	Y	50	gr batch line	1
dn		String	Y	50	delivery note	****
dn_line		String	Y	50	delivery note line	1
version		String	Y	14	Data cutoff time yyyyMMddHHmmss	20220809070623
comment1		String		100
comment2		String		100

request sample

{
  "batch_id": "90497",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "gr": "***",
      "gr_line": "1",
      "bu": "ThinkNB",
      "ems": "****",
      "ems_pn": "****",
      "ems_pn_desc": "",
      "lenovo_pn": "****",
      "material_type": "BS",
      "mfg_pn": "",
      "ems_po": "****",
      "ems_po_line": "10",
      "gr_qty": "100",
      "gr_date": "2022-08-01 ",
      "movement_type": "GR",
      "ems_supplier_code": "****",
      "ems_supplier_name": "****",
      "ship_to_name": "",
      "dn": "****",
      "dn_line": "1",
      "version": "20220809070623",
      "comment1": "",
      "comment2": ""
    }
  ]
}

success response sample

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

failed response sample

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