Skip to content

Booking Qty & PO details Data

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

请求地址

  • API
EnvironmentURL
Testhttps://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/odm/booking_qty_po_details
Prodhttps://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/booking_qty_po_details
  • FTP
EnvironmentPartner directoryLenovo directoryFile name
Test/Planning/SCC/{appName}/odm/booking_qty_po_details//Planning/SCC/{appName}/odm/booking_qty_po_details/feedback/booking_qty_po_details_{crud}_{yyyyMMddHHmmss}_
Prod/Planning/SCC/{appName}/odm/booking_qty_po_details//Planning/SCC/{appName}/odm/booking_qty_po_details/feedback/booking_qty_po_details_{crud}_{yyyyMMddHHmmss}_

Sample:/Planning/SCC/LCFC/odm/booking_qty_po_details/booking_qty_po_details_update_20220928123000_001

FrequencyTimeData amount
Daily/Weekly00:00:00

Note:VMI currently prepared FCST version. Current FCST version. The netting to go qty in LT is calculated and provided by PN. For VMI materials, there is only one line for each material.
The netting to go qty in Direct Ship's currently prepared FCST version LT is calculated and provided by PN. The information of these two fields in all POs of a PN is consistent, and Lenovo calculation will output the result by substitution group.

Request data description

purchase_type corresponds to the Direct Ship type parameter
ParamKeyTypedefault requiredPCG-NBISGMBG-MoblieMDSC-TBPCG-DT/DTPCG-DockingSmart DeviceLengthDescriptionExample
uidString32Unique id
buYStringYYYYYYY50PCG includes:ThinkNB、IdeaNB、ThinkDT、IdeaDT、Workstation;ISG/MBGMDSC-TB
odmYStringYYYYYYYY40WINGTECH
odm_supplier_nameYStringYYYYYYYY150
commodityStringY50
material_typeStringYYYYYYYY10material type:DB/DS/BS
type_of_orderStringYYYYYYY50Real order or Blank orderForecast/PO
odm_pnYStringYYYYYYYY20ODM part number820000000000
odm_pn_descStringYYYYYYY50ODM part number descriptionAudio-AMP;Class K;4.3W;2.483.170.58mm
lenovo_pnStringY for DSY for DSY for BS/DSY for DSY for DSY for DSY for DS18Lenovo part number
uomString20unitST
lead_timeIntegerYYYYYYYY10lead time(Weeks)0
purchase_typeYStringYYYYY20Direct ship(PO trigger)/VMI(FCST trigger)
fcst_versionStringYYYYYYY8current FCST version
fcst_qtyIntegerYYYY10(netting to go qty),MBG:Actual+To go qty
life_cycle_ttl_demandIntegerY10Parts level demand (MBG)
actionStringY20Action/ Cancel / Delay / Expedite / Past Due
order_statusStringYYYYY20Active/close/Block/Cancel(PO status)released_PO
scheduled_receipt_order_typeString20PO Line Type(361_PurchaseOrder_AR)
poYStringYYYYYYY10purchase orderH121050122
po_lineYStringYYYYYYY6purchase order Line20
order_dateDateYYYYYYYorder date2022/1/1
total_po_qtyIntegerYYYYYYYY10origin order quantity
po_open_qtyIntegerYYYYYYYY10open quantity10
need_dateDateYYYYYYYRequest ETA2022-01-01
due_dateDateYYYYYestimate end time, usually same with needdate2022-01-01
need_ship_dateDateYYYYYYRequet ETD2022-01-01
confirm_ship_dateDateYYYYYYconfirm ship date2022-01-01
buyer_nameString50Buyer ID
planner_nameString50Buyer Name
qty_to_reduce_inv_uomInteger10Qty to Reduce Inv UOM(No must)
need_qty_inv_uomInteger10Order_QTY(no must)
incotermString50Incoterm
incoterm_destinationString50City name
storage_locationString20storage locationWINTECH
versionYStringYYYYYYYY14po time as version in format yyyyMMddHHmmss20220201101304
comment1String100reserved field
comment2String100reserved field
purchase_type corresponds to the Direct Ship type parameter
ParamkeyTypedefault RequiredPCG-NBISGMDSC-TBPCG-DTPCG-DockingSmart Device 必填LengthDescriptionExample
uidString32Unique id
buYStringYYYYYY50PCG includes:ThinkNB、IdeaNB、ThinkDT、IdeaDT、Workstation;ISG/MBGACC
odmYStringYYYYYYY40Wingtech
odm_supplier_nameYStringYYYYYYY50
commodityStringY50
material_typeStringYYYYYYY10material type:DB/DS/BS
type_of_orderStringYYYYYY50Real order or Blank orderForecast/PO
odm_pnYStringYYYYYYY20ODM part number820000000000
odm_pn_descStringYYYYYY50ODM part number descriptionAudio-AMP;Class K;4.3W;2.483.170.58mm
lenovo_pnStringY for DSY for DSY for BS/DSY for DSY for DSY for DS18Lenovo part number
uomString20unitST
lead_timeIntegerYYYYYYY10lead time(Weeks)0
purchase_typeYStringYYYYY20Direct ship(PO trigger)/VMI(FCST trigger)
fcst_versionStringYYYYYYY8current FCST version
fcst_qtyIntegerYYYY10(netting to go qty),MBG:Actual+To go qty
order_dateDateYYYYYYYorder date2022-01-01
total_po_qtyIntegerYYYYYYY10order quantity
po_open_qtyIntegerYYYYYYYYorder open quantity
buyer_nameString50Buyer ID
planner_nameString50Buyer Name
storage_locationStringYYYYYYY8storage locationWingtech
versionYStringYYYYYYY16po time as version in format yyyyMMddHHmmss20220809070600
comment1String100reserved field
comment2String100reserved field

Response data description

ParamTypeDescription
codeString0: success, others:failed
msgStringthe detail message, especially useful on failure

Request sample

json
{
  "batch_id": "90397",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "bu": "ThinkNB",
      "odm": "WINGTECH",
      "odm_supplier_name": "LCFC",
      "commodity": "sdndd",
      "material_type": "DS",
      "type_of_order": "Forecast trigger",
      "odm_pn": "820000000000",
      "odm_pn_desc": "Audio-AMP;Class K;4.3W;2.483.170.58mm",
      "lenovo_pn": "45109112310",
      "uom": "ST",
      "lead_time": "0",
      "purchase_type": "VMI",
      "fcst_version": "1.234",
      "fcst_qty": "23",
      "life_cycle_ttl_demand": "234",
      "action": "Delay",
      "order_status": "Active",
      "scheduled_receipt_order_type": "",
      "po": "H121050122",
      "po_line": "20",
      "order_date": "2022-01-01",
      "total_po_qty": "200",
      "po_open_qty": "10",
      "need_date": "2022-01-01",
      "due_date": "2022-01-03",
      "need_ship_date": "2022-01-01",
      "confirm_ship_date": "2022-01-02",
      "buyer_name": "",
      "planner_name": "",
      "qty_to_reduce_inv_uom": "",
      "need_qty_inv_uom": "123",
      "incoterm": "",
      "incoterm_destination": "",
      "storage_location": "WINGTECH",
      "version": "20220809070600",
      "comment1": "",
      "comment2": ""
    }
  ]
}

Successful response sample

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

Failed response sample

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