SHIPMENT 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/shipment
Prod	https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/shipment

Request data description

Param	Key	Type	Required	Length	Description	Example
uid		String		32	Unique id
bu		String	Y	50	PCG contains：ThinkNB、IdeaNB、ThinkDT、IdeaDT、Workstation；ISG/MBG
po	Y	String	Y	50	Purchase order number	4601044323
po_line	Y	String	Y	10		10
order_type		String		10		ZEF1
family		String	Y	100		X9_CLAM_KO/机型
product	Y	String	Y	20		MTM
site_id	Y	String	Y	20		LCFC
customer	Y	String	Y	20		NEC/Medion/Brazil
order_qty		Integer	Y	10		1
ship_qty		Integer	Y	10		1
open_qty		Integer	Y	10
ocd		Date			order create date	2023-11-20
re_rsd		Date	Y		YYYY-MM-DD	2023-11-21
rsd		Date	Y		YYYY-MM-DD	2023-11-22
ship_date		Date	Y		YYYY-MM-DD	2023-11-23
delivery	Y	String	Y	24	delivery note（DN）
dn_line_num	Y	String	Y	25	delivery line（DN Line)
comment1		String		100	reserved field
comment2		String		100	reserved field
comment3		String		100	reserved field
comment4		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": "90397",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [{
    "bu": "ThinkNB",
    "po": "4601044323",
    "po_line": "10",
    "order_type": "ZEF1",
    "family": "X9_CLAM_KO/机型",
    "product": "MTM",
    "site_id": "LCFC",
    "customer": "NEC",
    "order_qty": "1",
    "ship_qty": "1",
    "open_qty": "1",
    "ocd": "2023-11-22",
    "re_rsd": "2023-11-21",
    "rsd": "2023-11-23",
    "ship_date": "2023-11-24",
    "delivery": "demo delivery",
    "dn_line_num": "demo dn_line_num",
    "comment1": "demo comment1",
    "comment2": "demo comment2",
    "comment3": "demo comment3",
    "comment4": "demo comment4"
  }]
}

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"
        }]
    }]
}