通用数据同步 FTP 方案

用于合作伙伴向 Lenovo 同步数据的统一 FTP 方案，对接前请了解 FTP 接入流程

文件目录

确定集成方案后，Lenovo 会分配对应的文件目录

环境	服务地址	合作伙伴发送文件目录	Lenovo 发送文件目录	文件名
测试	***.lenovo.com	/Planning/SCC/{appName}/{data_category}/{biz_key}/	/Planning/SCC/{appName}/{data_category}/{biz_key}/feedback/	{biz_key}_{crud}_{yyyyMMddHHmmss}_
正式	***.lenovo.com	/Planning/SCC/{appName}/{data_category}/{biz_key}/	/Planning/SCC/{appName}/{data_category}/{biz_key}/feedback/	{biz_key}_{crud}_{yyyyMMddHHmmss}_

公共目录参数

参数位置	参数名称	描述	示例
路径	appName	合作伙伴简称	固定分配
路径	data_category	数据分类	ODM、T1、TN 等，具体业务接口固定分配
文件名	biz_key	业务数据名	具体业务接口固定分配
文件名	crud	同步类型	全量覆盖：all(清除历史数据，然后写入当前数据)、新增：insert、修改：update、删除：delete
文件名	yyyyMMddHHmmss	时间	20221001003000
文件名	serial	当天流水	主要避免重复

公共请求参数

位置	名称	必填	类型	长度	描述
Body	appName		String	10	合作伙伴简称，非必须
Body	batch_id	Y	String	16	批次 ID，合作伙伴生成，保证批次唯一性
Body	batch_size	Y	Number	---	批次内，总数据量
Body	seq_id	Y	String		批次内，每次序号
Body	seq_size	Y	Number	---	每次，要推送的数据量 5000 >= size >= 1

公共响应参数

位置	名称	必填	类型	格式	描述	示例
Body	code	Y	String	---	状态码	"0"代表成功,其他失败可参考返回码
Body	msg	N	String	---	提示消息	非"0"时,会提示错误消息
Body	result	N	object/array	---	数据体
Body	row	N	object	---	原数据行
Body	verify	N	object	---	具体错误字段及错误原因

请求示例

json

{
  "batch_id": "LCFC202206230001",
  "batch_size": "250000",
  "seq_id": "1",
  "seq_size": "2",
  "data": [
    {
      "LENOVO_PN": "SD10W87241",
      "PLANT": "H121",
      "QTY": "1000"
    },
    {
      "LENOVO_PN": "SD10W87241",
      "PLANT": "H121",
      "QTY": "1000"
    }
  ]
}

响应示例

json

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

异常示例

json

{
  "code": "E00V00",
  "msg": "data verification failed！",
  "result": [
    {
      "row": {
        "odm": "LCFC",
        "odm_pn": "45109112310",
        "location": "1234",
        "version": "20220915080100123456"
      },
      "verify": [
        {
          "type": "value length exceed",
          "fields": "version"
        }
      ]
    }
  ]
}

通用数据同步 FTP 方案 ​

文件目录 ​

公共目录参数 ​

公共请求参数 ​

公共响应参数 ​

通用数据同步 FTP 方案

文件目录

公共目录参数

公共请求参数

公共响应参数