Skip to content

部件接收入库

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

Frequency
Real time

请求地址

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

请求参数

字段类型父类型必填长度示例描述
source_systemStringNAY20LCFC数据来源系统
actual_departure_note_numberStringNAY13ATD0000000001实际发货通知单号(全局唯一),ATD开头,后面10位数字
delivery_noteStringNAY512发运单号发运单号
customer_rt_numberStringNAN10供应商自己定义客户接收单
customer_po_numberStringNAN10供应商自己定义客户PO
ticket_typeStringNAY10RT单据类型(接收单)
customer_rt_line_listArray<GRLINE>NAYRT签收(GR)行数组
customer_po_line_numberStringGRLINEN101客户PO行,从1开始递增
brandStringGRLINEN50Intel采购品牌Intel、Samsung
mpnStringGRLINEY50IXX1234567MPN
quantityNumberGRLINEY1000接收数量
actual_time_rtStringGRLINEY2017-05-20 00:00:00接收日期,格式"yyyy-MM-dd HH:mm:ss"
rejection_quantityNumberGRLINEN100拒收数量:3PL方必填
bad_quantityNumberGRLINEN200不良品量:OMD厂商必填
firmwareStringGRLINENxxxxx固件信息
asn_lineNumberGRLINEY1asn行号
receipt_location_codeStringGRLINENInspur101收货组织编码
receipt_location_sub_codeStringGRLINEN收货子组织编码,默认良品库
delivery_location_codeStringGRLINENInspur101发货组织编码
delivery_location_sub_codeStringGRLINENInspur101发货子组织编码,默认良品库
inventory_batchStringGRLINEN3220210530库存批次
child_gr_listArray<GRLINE>GRLINEN子设备清单
child_gr_list.sku_idStringGRLINEY32设备ID,当为BOX时为箱包SKUID(真实箱包号用box_num承载),当为MPN时是MPN,当为SN时是SN
child_gr_list.ali_poStringGRLINENPO62516065箱包po
child_gr_list.sku_typeStringGRLINEY32BOX(default)/MPN/SN/VBOX/VSN设备类型
child_gr_list.sku_controlStringGRLINEN32SN管控类型,支持MPN(默认)/SN/BOX
child_gr_list.areaStringGRLINEY32stock1库区
child_gr_list.shelfStringGRLINEN32shelf1货架
child_gr_list.binStringGRLINEY32bin11-2库位
child_gr_list.trayStringGRLINEN32EA112托盘编号
child_gr_list.specificationsNumberGRLINEN10100规格:1个GRLINE内的设备数量,比如sku_type是BOX的,则代表一个箱包内的MPN或SN数量
child_gr_list.quantityNumberGRLINEY5数量
child_gr_list.target_sub_inventory_typeStringGRLINEN100/1/2/3收货方库存质量类型(0良品 1不良品 2拒收 3不良品待验收)
child_gr_list.target_sub_inventory_reservoir_typeStringGRLINEN100/1/2/3收货方库区类型
child_gr_list.cooStringGRLINEN10中国原产国
child_gr_list.is_rejectStringGRLINEY10true箱子是否拒收,true拒收 false接收
child_gr_list.product_modelStringGRLINEN1288163产品型号
child_gr_list.date_codeStringGRLINEN1282024-5原厂批次
child_gr_list.warehouse_locationStringGRLINEY128original库位枚举值 original:原箱区 mix:混箱区
child_gr_list.ali_inv_batchStringGRLINEY12820240620阿里批次yyyyMMdd

响应参数

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

请求示例: BOX-箱包签收

--CMI仓箱包签收只会按原箱签, ODM签收可按原箱 / 混箱签收

json
{
  "batch_id": "90397",
  "batch_size": 1,
  "seq_id": "1",
  "seq_size": 1,
  "data": [
    {
      "source_system": "LCFC",
      "customer_rt_number": "NICK202233616515",
      "delivery_note": "DN20221024",
      "ticket_type": "ASN",
      "actual_departure_note_number": "ATD1000071549",
      "receipt_finish": true,
      "customer_rt_line_list": [{
        "brand": "Micron",
        "mpn": "MTA18ASF2G72HZ-2G6E1",
        "quantity": 20,
        "actual_time_rt": 1674106006000,
        "rejection_quantity": 0,
        "bad_quantity": 0,
        "sku_id": "MTA18ASF2G72HZ-2G6E1",
        "sku_type": "MPN",
        "sku_control": "BOX",
        "asn_line": 1,
        "child_gr_list": [{
          "quantity": 1,
          "is_reject": "false",
          "sku_id": "NICK2022sku160675",
          "sku_type": "BOX",
          "specifications": "5",
          "ali_po": "PO6382700",
          "coo": "中国台湾",
          "ali_inv_batch": "20240512",
          "warehouse_location": "original",
          "date_code": "2024-04"
        }, {
          "quantity": 1,
          "is_reject": "false",
          "sku_id": "NICK2022sku160676",
          "sku_type": "BOX",
          "specifications": "3",
          "ali_po": "PO6382700",
          "coo": "中国台湾",
          "ali_inv_batch": "20240512",
          "warehouse_location": "original",
          "date_code": "2024-04",
          "child_gr_list": [{
            "quantity": 1,
            "sku_id": "SN001",
            "sku_type": "SN"
          }, {
            "quantity": 1,
            "sku_id": "SN002",
            "sku_type": "SN"
          }, {
            "quantity": 1,
            "sku_id": "SN003",
            "sku_type": "SN"
          }]
        }, {
          "quantity": 1,
          "sku_id": "NICK2022sku160677",
          "is_reject": "false",
          "sku_type": "BOX",
          "specifications": "3",
          "ali_po": "PO6382700",
          "coo": "中国台湾",
          "ali_inv_batch": "20240512",
          "date_code": "2024-04",
          "warehouse_location": "mix",
          "child_gr_list": [{
            "quantity": 1,
            "sku_id": "SN04",
            "sku_type": "SN"
          }, {
            "quantity": 1,
            "sku_id": "SN05",
            "sku_type": "SN"
          }, {
            "quantity": 1,
            "sku_id": "SN06",
            "sku_type": "SN"
          }]
        }]
      }]
    }
  ]
}

成功响应示例

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

异常响应示例

json
{
  "code":"-1",
  "msg":"request failed"
}