成品/部件库存同步

请求地址

• API

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

请求参数

字段	类型	必填	长度	示例	描述
source_system	String	Y	20	LCFC	数据来源系统
inventory_type	String	Y	1	1	库存类型： (0：部件良品库；1：成品库；2：备件；3：在途已发；4：在制；5：部件不良品库；6：在途未发；7:中转仓;8:整机不良品库；9:Buffer库)
inventory_directive	String	Y	32	XXX-20180613202531469-0801054668	库存反馈指令（若⼚家主动反馈，⽣成规则CODE+编码；CODE:英⽂品牌的⼤写前三个字⺟；编码为时间格式（yyyyMMddHHmmssSSS)+⼗位随机数字字符串）
machine_brand	String	Y	50	品牌code	整机品牌
factory_code	String	Y	32	North-001	⼯⼚编码
version_seq_no	String	Y	13	1531317939902	版本号 （计算数据时刻的时间戳）
customer_inventory_list	Array	Y		CustomerInventoryLinesDTO	客户库存⾏JSON数组
remark	String	N	100	供应商选填	备注
inventory_part_belonging	String	N	20	ODM/S54/AQ7/Z97	物料⼦库的归属(特定⼚商必传)-20221128

CustomerInventoryLinesDTO 结构

字段	类型	必填	长度	示例	描述
customer_inventory_line_number	String	Y	10	1	客户库存⾏，从1开始递增
config_model	String	N	50	N58.2B.C3V1P0U2	三段机型即ALIBom
mpn	String	Y	20		⼚商bom名称
inventory_batch	String	N	8	20180701	⼊库时间（部件良品库必传，其他不传）
vendor_inventory_quantity	Number	Y		200	⼚家实际库存
delivering_quantity	Number	N		200	⼚家收到PO未发货量
delivered_quantity	Number	N		200	⼚家收到PO已发货量
item_type	Number	Y		1	0:服务器部件；1:服务器整机；2:⽹络整机；3:⽹络部件；4:整机柜

注：当库存类型为整机库时，delivering_quantity、delivered_quantity 二选一必填

响应参数

参数	必填	类型	定义	描述
code	Y	String	状态码	"0"代表成功,其他失败可参考返回码
msg	N	String	提示消息	非"0"时,会提示错误消息
result	N	object	数据体	请参照响应示例

请求示例

{
  "batch_id": "90397",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "source_system": "MAMMOTHTEK",
      "inventory_type": "1",
      "inventory_directive": "XXX-20180613202531469-0801054668",
      "machine_brand": "品牌code",
      "factory_code": "North-001",
      "version_seq_no": "1531317939902",
      "customer_inventory_list": [
        {
          "customer_inventory_line_number": "1",
          "config_model": "N58.2B.C3V1P0U2",
          "mpn": "ad102342",
          "inventory_batch": "20180701",
          "vendor_inventory_quantity": 200,
          "delivering_quantity": 200,
          "delivered_quantity": 200,
          "item_type": 1
        }
      ],
      "remark": "供应商选填",
      "inventory_part_belonging": "ODM/S54/AQ7/Z97"
    }
  ]
}

成功响应示例

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

异常响应示例

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