养馋记发货预约
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 |
| ycjOrderNumber | 养馋记订单号 | 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",
"ycjOrderNumber":"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"
}