Skip to content

产品SN上报

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

Frequency
Real time

请求地址

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

请求参数

字段类型必填长度示例描述
source_systemStringY20LCFC数据来源系统
manufacture_directive_noStringY32指令编号
manufacture_order_noStringY32工单编号
categoryStringY业务分类(服务器server、整机柜rack、网络network、采购拓展pe、板卡pcba)
product_snProductSNDTOY产品SN

ProductSNDTO 结构

字段类型必填长度示例描述
material_categoryStringY32Server、CPU、SSD物料分类
material_nameString32物料名称(三段机型、整机柜)
material_mpnString128物料MPN(部件原厂料号)
material_bomString64000000000000230615物料BOM(工厂成品料号)
sn_noStringN64SN编码(服务器和作为控制节点的DPU必传)
material_quantityIntY数量,有SN的默认为1,无SN的填写数量
factory_mpnString64工厂MPN
oob_macString64oob_mac(服务器和作为控制节点的DPU必传)
td_idString64阿里资产id(服务器和作为控制节点的DPU必传)
positionString3221-22位置
price_levelString16L1计价层级
product_snList<ProductSNDTO>产品SN(递归)

响应参数

参数必填类型定义描述
codeYString状态码"0"代表成功,其他失败可参考返回码
msgNString提示消息非"0"时,会提示错误消息
resultNobject/array数据体

请求示例

json
{
  "batch_id": "90397",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "source_system": "LCFC",
      "manufacture_directive_no": "123456",
      "manufacture_order_no": "123456",
      "category": "server",
      "product_sn": {
        "material_category": "Server",
        "material_name": "Server",
        "material_mpn": "000000000000230615",
        "material_bom": "000000000000230615",
        "sn_no": "SN201807010001",
        "material_quantity": 1,
        "factory_mpn": "000000000000230615",
        "oob_mac": "00:00:00:00:00:00",
        "td_id": "123456",
        "position": "21-22",
        "price_level": "L1",
        "product_sn": [
          {
            "material_category": "CPU",
            "material_name": "CPU",
            "material_mpn": "000000000000230615",
            "material_bom": "000000000000230615",
            "sn_no": "SN201807010002",
            "material_quantity": 1,
            "factory_mpn": "000000000000230615",
            "oob_mac": "00:00:00:00:00:00",
            "td_id": "123456",
            "position": "21-22",
            "price_level": "L1",
            "product_sn": []
          },
          {
            "material_category": "SSD",
            "material_name": "SSD",
            "material_mpn": "000000000000230615",
            "material_bom": "000000000000230615",
            "sn_no": "SN201807010003",
            "material_quantity": 1,
            "factory_mpn": "000000000000230615",
            "oob_mac": "00:00:00:00:00:00",
            "td_id": "123456",
            "position": "21-22",
            "price_level": "L1",
            "product_sn": []
          }
        ]
      }
    }
  ]
}

成功响应示例

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

异常响应示例

json
{
  "code": "-1",
  "msg": "system error!"
}