Skip to content

PO 数据

以下接口适用于 通用数据集成

请求地址

  • API
环境URL
测试https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/sync/odm/po
正式https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/sync/odm/po

请求参数

字段KEY类型必填长度备注示例
uidStringN32数据行唯一标识,存在按 uid 变更,不存在按 业务 key 变更
poYStringY10订单号码
po_lineYStringY6订单 Line
po_typeStringY10
buStringY50PCG 包含:ThinkNB、IdeaNB、ThinkDT、IdeaDT、Workstation;ISG/MBG
odmYStringY40LCFC
vendorStringY150NEC/Medion/Brazil
odm_pnYStringY20ODM 料号
odm_pn_descStringY50ODM 料号描述
lenovo_pnYStringY50联想料号
order_statusStringY20Active(Open)
order_dateDateY下单日期YYYY-MM-DD
total_po_qtyIntegerY10本张订单原始数量
po_open_qtyIntegerY10本张订单未清数量
re_rsd_dateDateYYYYY-MM-DD
rsd_dateDateYRequest ship dateYYYY-MM-DD
versionStringY14ODM 抓取系统 PO 明细的时间作为版本号20231123171603
comment1String100预留字段,以备之后使用
comment2String100预留字段,以备之后使用
comment3String100预留字段,以备之后使用
comment4String100预留字段,以备之后使用

响应参数

参数类型是否必填描述
codeStringY0 成功其它失败
msgStringY响应具体信息

请求示例

json
{
  "batch_id": "90397",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [{
    "po": "322323",
    "po_line": "112122",
    "po_type": "1",
    "bu": "ThinkNB",
    "odm": "LCFC",
    "vendor": "demo Vendor",
    "odm_pn": "121323",
    "odm_pn_desc": "demo odm_pn_desc",
    "lenovo_pn": "demo lenovo_pn",
    "order_status": "Active",
    "order_date": "2023-11-23",
    "total_po_qty": "986",
    "po_open_qty": "245",
    "re_rsd_date": "2023-11-22",
    "rsd_date": "2023-11-23",
    "version": "12312",
    "comment1": "demo comment1",
    "comment2": "demo comment2",
    "comment3": "demo comment3",
    "comment4": "demo comment4"
  }]
}

响应示例

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

异常示例

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

业务错误码

错误码错误描述解决方案