每日上架来伊份清单同步
1. 前言:
2. 交互时序图:
3. 请求场景:
每日上架来伊份清单同步
4. 接口要求:
使用来伊份openapi加密协议进行加密请求
5. 接口标准
5.1 基本信息
| 描述 | 值 |
|---|---|
| 服务名称 | supplier-app-api |
| URL | 测试环境:https://openapi.test.laiyifen.com/supplier-app-api/v1/mpd/sku/supply-list-sync 生产环境:https://openapi.laiyifen.com/supplier-app-api/v1/mpd/sku/supply-list-sync |
| 认证方式 | 令牌 |
| 请求方式 | HTTP(POST) |
| 功能描述(适用场景) | 每日上架来伊份清单同步 |
5.2 请求头公共参数 (Header)
| 参数名字 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| X-Co-Client | String | 是 | 客户端Id(来伊份提供) |
| X-Co-Sign | String | 是 | 签名 |
| X-Co-TimeStamp | String | 是 | 签名时间戳 |
5.3 入参 Body
| 参数名字 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| lyfCode | String | 否 | 来一份商品编码 |
| ycjCode | String | 是 | 养馋记商品编码 |
| name | String | 是 | 商品名称 |
| shelfDate | String | 是 | 上架日期(yyyy-MM-dd) |
| offShelfDate | String | 是 | 下架日期(yyyy-MM-dd) |
| remark | String | 否 | 备注 |
5.4 入参示例
[
{
"lyfCode": "S00302010303",
"ycjCode": "8807",
"name": "西瓜(3-4斤)",
"shelfDate": "2025-08-11",
"offShelfDate": "2025-08-12",
"remark": "养馋记上架商品"
}
]
5.5 返回统一参数
| 参数名字 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| code | String | 是 | 返回请求业务代码 |
| msg | String | 是 | 返回信息描述 |
| data | Json | 是 | 返回参数 |
5.6 返回参数Data
| 参数名字 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| code | String | 是 | 商品编码 |
| name | String | 是 | 商品名称 |
| success | Boolean | 是 | 同步是否成功 |
| message | String | 是 | 同步结果信息 |
5.7 返回示例
{
"code": "0",
"msg": "OK",
"data": [
{
"code": "S20240709032",
"name": "西瓜(3-4斤)",
"success": true,
"message": "Successful"
},
{
"code": "S20240708001",
"name": "五香瓜子",
"success": false,
"message": "采购成本价不能为空"
}
]
}