养馋记发货预约
1. 前言:
2. 交互时序图:
3. 请求场景:
养馋记发货预约
4. 接口要求:
使用来伊份openapi加密协议进行加密请求
5. 接口标准
5.1 基本信息
描述 | 值 |
---|---|
服务名称 | supplier-app-api |
URL | 测试环境:https://openapi.test.laiyifen.com/supplier-app-api/v1/purchase/transport/pa 生产环境:https://openapi.laiyifen.com/supplier-app-api/v1/purchase/transport/pa |
认证方式 | 令牌 |
请求方式 | HTTP(POST) |
功能描述(适用场景) | 养馋记发货预约 |
5.2 请求头公共参数 (Header)
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
X-Co-Client | String | 是 | 客户端Id(来伊份提供) |
X-Co-Sign | String | 是 | 签名 |
X-Co-TimeStamp | String | 是 | 签名时间戳 |
5.3 入参 Parameters
参数名称 | 参数说明 | 是否必须 | 数据类型 |
---|---|---|---|
orderNo | 销售订单号 | true | String |
appointmentDate | 预约到货日期(yyyy-MM-dd) | true | Date |
driver | 司机 | true | String |
telephone | 联系手机号 | true | String |
licensePlateNumber | 车牌号码 | true | String |
supplierRemark | 派车备注 | true | String |
creator | 工号id | true | long |
creatorName | 工号 | true | String |
skuCodeList | 预约明细 | true | List |
body | skuCodeList | true | List |
skuCode | 商品编码 | true | String |
skuName | 商品名称 | false | String |
appointmentQty | 发货量-基本单位 | true | BigDecimal |
batchList | 生产批次 | true | List |
body | batchList | true | List |
qty | 生产数量(基本单位) | true | BigDecimal |
productionDate | 生产日期(yyyy-MM-dd) | true | Date |
5.4 入参示例
{
"orderNo": "PO2025091232321",
"appointmentDate": {{$microTimestamp}},
"creator": 42968,
"creatorName": "00042968",
"driver": "张三",
"telephone": "17681160411",
"licensePlateNumber": "粤A124FS",
"supplierRemark": "养馋记发货预约",
"skuCodeList": [
{
"skuCode": "11441",
"skuName": "商品名称",
"appointmentQty": 10,
"batchList": [
{
"productionDate": {{$microTimestamp}},
"qty": 10
}
]
}
]
}
5.5 返回统一参数
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
code | String | 是 | 返回请求业务代码 |
msg | String | 是 | 返回信息描述 |
data | Json | 是 | 返回参数 |
5.6 返回参数Data
参数名字 | 参数类型 | 是否必须 | 说明 |
---|
5.7 返回示例
{
"code": "0",
"msg": "success"
}