GR Data

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

Request address

• API

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

• FTP

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

Sample：/Planning/SCC/LCFC/odm/gr/gr_update_20220928123000_001

Frequency	Time	Data amount
Daily or Real time	00:00:00	Daily version of data(Incremental)

Request data description

TIP

Note: field requirements are different on bu, please refer to the following table

Param	Key	Type	Default requird	PCG-NB	ISG	MDSC-TB	PCG-DT	PCG-Docking	Smart Device	Length	Description	Example
uid		String								32	Unique id
gr	Y	String	Y	Y	Y	Y	Y	Y	Y	50
gr_line	Y	String	Y	Y	Y	Y	Y	Y	Y	50
bu	Y	String	Y	Y	Y		Y	Y	Y	50	Business unit	ThinkNB
odm	Y	String				Y				40	ODM name	WINGTECH
odm_pn	Y	String	Y	Y	Y	Y	Y	Y	Y	20	ODM part number	BLXSB18C53808
odm_pn_desc		String				Y	Y	Y	Y	240	ODM part number description	XXXX
lenovo_pn		String		Y for DS material	Y for DS material	Y	Y	Y	Y	18	Lenovo part number	SB18C53808
material_type		String					Y	Y for DS	Y for DS	10	DB/DS/BS	DS
mfg_pn		String	Y	Y	Y		Y	Y	Y	200	manufacturing part number	XXX
odm_po	Y	String	Y	Y	Y		Y	Y	Y	20	purchase order	HG21100014
odm_po_line	Y	String		Y	Y		Y	Y	Y	10	purchase order line	10
gr_qty		Number	Y	Y	Y		Y	Y	Y	13,3	Goods receive quantity	100
gr_date	Y	Date	Y	Y	Y		Y	Y	Y		Goods receive time	2022-08-01
movement_type	Y	String	Y	Y	Y	Y	Y	Y	Y	20	RMA/Return/GR/CANCEL/Drop to VMI/Drop to ODM/HUB Pull	GR
odm_supplier_code		String	Y	Y	Y			Y	Y	20	ODM supplier code	W121081473
odm_supplier_name		String		Y	Y			Y	Y	100	ODM supplier name	GOLD WIN TRADING (HK) LIMITED
ship_to_name		String				Y				100	ship to odm factory
version		String	Y	Y	Y	Y	Y	Y	Y	14	version in format yyyyMMddHHmmss	20220809070623
comment1		String								100
comment2		String								100
dn		String								50	delivery note
dn_line		String								50

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": "90497",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "gr": "G202211183201",
      "gr_line": "10",
      "bu": "MDSC-TB",
      "odm": "odm_1",
      "odm_pn": "Wingtech",
      "odm_pn_desc": "",
      "lenovo_pn": "HG21100014",
      "material_type": "",
      "mfg_pn": "10",
      "odm_po": "28080",
      "odm_po_line": "HG21100014",
      "gr_qty": "10",
      "gr_date": "2022-09-15",
      "movement_type": "GR",
      "odm_supplier_code": "W121081473",
      "odm_supplier_name": "GOLDWINTRADING(HK)LIMITED",
      "ship_to_name": "",
      "version": "20220809070600",
      "comment1": "",
      "comment2": "",
      "dn": "",
      "dn_line": ""
    }
  ]
}

Successful response sample

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

Failed response sample

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