养馋记同步MPD新增主数据
1. 前言:
2. 交互时序图:
3. 请求场景:
养馋记同步MPD新增主数据
4. 接口要求:
使用来伊份openapi加密协议进行加密请求
5. 接口标准
5.1 基本信息
描述 | 值 |
---|---|
服务名称 | supplier-app-api |
URL | 测试环境:https://openapi.test.laiyifen.com/supplier-app-api/v1/mpd/sku/batch-add 生产环境:https://openapi.laiyifen.com/supplier-app-api/v1/mpd/sku/batch-add |
认证方式 | 令牌 |
请求方式 | HTTP(POST) |
功能描述(适用场景) | 养馋记同步MPD新增主数据 |
5.2 请求头公共参数 (Header)
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
X-Co-Client | String | 是 | 客户端Id(来伊份提供) |
X-Co-Sign | String | 是 | 签名 |
X-Co-TimeStamp | String | 是 | 签名时间戳 |
5.3 入参 Body
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
body | List | 是 | 商品信息 |
code | String | 是 | 商品编码 |
name | String | 是 | 商品名称 |
category | String | 是 | MDM分类 |
supplierCode | String | 是 | 供应商编码 |
purchasePrice | BigDecimal | 是 | 采购成本价 |
outputTaxRate | String | 是 | 销项税率 |
inputTaxRate | String | 是 | 进项税率 |
shelfLife | Integer | 是 | 商品保质期(天) |
commodityProducer | String | 是 | 商品产地 |
baseUnitCode | String | 是 | 基础单位编码 |
boxReplacementRatio | BigDecimal | 是 | 箱转换值 |
5.4 入参示例
[
{
"code": "8807",
"name": "西瓜(3-4斤)",
"category": "",
"supplierCode": "501692",
"purchasePrice": 17.9,
"outputTaxRate": "13%销项税, 中国",
"inputTaxRate": "13%进项税, 中国",
"shelfLife": 7,
"commodityProducer": "中国",
"baseUnitCode": "",
"boxReplacementRatio": 36
}
]
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": "采购成本价不能为空"
}
]
}