shoporder - 门店要货单接口
- api/shop/shoporder/get GET 根据id获取
- api/shop/shoporder/getlist GET 获取列表
- api/shop/shoporder/getstatuslist GET 获取所有状态
- api/shop/shoporder/getdetaillist GET 获取明细列表
- api/shop/shoporder/getdetailgrouplist GET 根据条件获取明细汇总列表
- api/shop/shoporder/getdetailgrouplistbyorders GET 根据要货单获取明细汇总列表
- api/shop/shoporder/create POST 新增
- api/shop/shoporder/update POST 修改
- api/shop/shoporder/delete POST 删除
- api/shop/shoporder/submit POST 提交
- api/shop/shoporder/check POST 审核
- api/shop/shoporder/checkall POST 批量审核
- api/shop/shoporder/revoke POST 撤回
- api/shop/shoporder/reject POST 退回
- api/shop/shoporder/invalid POST 作废
- api/shop/shoporder/getshopordersummarylist GET 获取汇总列表
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| code | string | 单号 |
| createTime | date | 创建时间 |
| date | date | 要货日期 |
| details | [...] | 订单明细 |
| ┆- id | integer | id |
| images | [...] | 图片路径 |
| ┆- productClass | string | 商品分类 |
| ┆- productCode | string | 商品货号 |
| ┆- productId | integer | 商品Id |
| ┆- productName | string | 商品名称 |
| ┆- productUnit | string | 商品单位 |
| ┆- qty | decimal number | 要货数量 |
| ┆- shopOrderCode | string | 要货单单号 |
| ┆- shopOrderId | integer | 要货单Id |
| ┆- sort | integer | 排序 |
| ┆- supplierName | string | 供应商 |
| id | integer | id |
| log | string | 日志 |
| remark | string | 备注 |
| shopId | integer | 门店Id |
| shopName | string | 门店名称 |
| shopOrderBatchTag | string | 要货批次标签 |
| status | string | 0:未提交; 1:未审核; 2:已退回; 3:已完成; 4:已作废 |
| statusName | string | 状态名 |
| userId | integer | 创建人Id |
| userName | string | 创建人名称 |
响应示例
application/json, text/json
{
"shopId": 1,
"shopName": "",
"code": "",
"status": 0,
"date": "2026-01-15 10:11:28",
"statusName": "",
"shopOrderBatchTag": "",
"userId": 7,
"userName": "",
"createTime": "2026-01-15 10:11:28",
"remark": "",
"log": "",
"details": [
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
},
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
}
],
"id": 12
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| code | string | |
| endDate | date | |
| pageIndex | integer | |
| pageSize | integer | |
| shopId | integer | |
| startDate | date | |
| status | integer | |
| tag | string |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| data | [...] | |
| ┆- code | string | 单号 |
| ┆- createTime | date | 创建时间 |
| ┆- date | date | 要货日期 |
| details | [...] | 订单明细 |
| ┆- id | integer | id |
| images | [...] | 图片路径 |
| ┆- productClass | string | 商品分类 |
| ┆- productCode | string | 商品货号 |
| ┆- productId | integer | 商品Id |
| ┆- productName | string | 商品名称 |
| ┆- productUnit | string | 商品单位 |
| ┆- qty | decimal number | 要货数量 |
| ┆- shopOrderCode | string | 要货单单号 |
| ┆- shopOrderId | integer | 要货单Id |
| ┆- sort | integer | 排序 |
| ┆- supplierName | string | 供应商 |
| ┆- id | integer | id |
| ┆- log | string | 日志 |
| ┆- remark | string | 备注 |
| ┆- shopId | integer | 门店Id |
| ┆- shopName | string | 门店名称 |
| ┆- shopOrderBatchTag | string | 要货批次标签 |
| ┆- status | string | 0:未提交; 1:未审核; 2:已退回; 3:已完成; 4:已作废 |
| ┆- statusName | string | 状态名 |
| ┆- userId | integer | 创建人Id |
| ┆- userName | string | 创建人名称 |
| pageIndex | integer | |
| pageSize | integer | |
| sumData | {...} | |
| ┆- code | string | 单号 |
| ┆- createTime | date | 创建时间 |
| ┆- date | date | 要货日期 |
| details | [...] | 订单明细 |
| ┆- id | integer | id |
| images | [...] | 图片路径 |
| ┆- productClass | string | 商品分类 |
| ┆- productCode | string | 商品货号 |
| ┆- productId | integer | 商品Id |
| ┆- productName | string | 商品名称 |
| ┆- productUnit | string | 商品单位 |
| ┆- qty | decimal number | 要货数量 |
| ┆- shopOrderCode | string | 要货单单号 |
| ┆- shopOrderId | integer | 要货单Id |
| ┆- sort | integer | 排序 |
| ┆- supplierName | string | 供应商 |
| ┆- id | integer | id |
| ┆- log | string | 日志 |
| ┆- remark | string | 备注 |
| ┆- shopId | integer | 门店Id |
| ┆- shopName | string | 门店名称 |
| ┆- shopOrderBatchTag | string | 要货批次标签 |
| ┆- status | string | 0:未提交; 1:未审核; 2:已退回; 3:已完成; 4:已作废 |
| ┆- statusName | string | 状态名 |
| ┆- userId | integer | 创建人Id |
| ┆- userName | string | 创建人名称 |
| totalCount | integer |
响应示例
application/json, text/json
请求参数
无.
响应参数
响应示例
application/json, text/json
[
{
"key": 1,
"value": ""
},
{
"key": 1,
"value": ""
}
]
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| orderId | integer |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer | id |
| images | [...] | 图片路径 |
| productClass | string | 商品分类 |
| productCode | string | 商品货号 |
| productId | integer | 商品Id |
| productName | string | 商品名称 |
| productUnit | string | 商品单位 |
| qty | decimal number | 要货数量 |
| shopOrderCode | string | 要货单单号 |
| shopOrderId | integer | 要货单Id |
| sort | integer | 排序 |
| supplierName | string | 供应商 |
响应示例
application/json, text/json
[
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
},
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
}
]
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| code | string | |
| date | date | |
| pageIndex | integer | |
| pageSize | integer | |
| shopId | integer | |
| supplierId | integer | |
| tag | string |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| data | [...] | |
| ┆- id | integer | id |
| images | [...] | 图片路径 |
| ┆- productClass | string | 商品分类 |
| ┆- productCode | string | 商品货号 |
| ┆- productId | integer | 商品Id |
| ┆- productName | string | 商品名称 |
| ┆- productUnit | string | 商品单位 |
| ┆- qty | decimal number | 要货数量 |
| ┆- shopOrderCode | string | 要货单单号 |
| ┆- shopOrderId | integer | 要货单Id |
| ┆- sort | integer | 排序 |
| ┆- supplierName | string | 供应商 |
| pageIndex | integer | |
| pageSize | integer | |
| sumData | {...} | |
| ┆- id | integer | id |
| images | [...] | 图片路径 |
| ┆- productClass | string | 商品分类 |
| ┆- productCode | string | 商品货号 |
| ┆- productId | integer | 商品Id |
| ┆- productName | string | 商品名称 |
| ┆- productUnit | string | 商品单位 |
| ┆- qty | decimal number | 要货数量 |
| ┆- shopOrderCode | string | 要货单单号 |
| ┆- shopOrderId | integer | 要货单Id |
| ┆- sort | integer | 排序 |
| ┆- supplierName | string | 供应商 |
| totalCount | integer |
响应示例
application/json, text/json
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| orderIds | string | |
| supplierId | integer |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer | id |
| images | [...] | 图片路径 |
| length | integer | 名称长度 |
| productClass | string | 商品分类 |
| productCode | string | 商品货号 |
| productId | integer | 商品Id |
| productName | string | 商品名称 |
| productUnit | string | 商品单位 |
| qty | decimal number | 要货数量 |
| shopOrderCode | string | 要货单单号 |
| shopOrderId | integer | 要货单Id |
| sort | integer | 排序 |
| stockProductCode | string | 库存商品货号 |
| stockProductId | integer | 库存商品Id |
| stockProductName | string | 库存商品名称 |
| stockProductUnit | string | 库存商品单位 |
| stockRelQty | decimal number | 关系数量 |
| supplierName | string | 供应商 |
响应示例
application/json, text/json
[
{
"stockProductId": 1,
"stockProductName": "",
"stockProductCode": "",
"stockProductUnit": "",
"stockRelQty": 5.0,
"length": 6,
"shopOrderId": 7,
"shopOrderCode": "",
"productId": 9,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 14.0,
"supplierName": "",
"sort": 16,
"images": [
"",
""
],
"id": 17
},
{
"stockProductId": 1,
"stockProductName": "",
"stockProductCode": "",
"stockProductUnit": "",
"stockRelQty": 5.0,
"length": 6,
"shopOrderId": 7,
"shopOrderCode": "",
"productId": 9,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 14.0,
"supplierName": "",
"sort": 16,
"images": [
"",
""
],
"id": 17
}
]
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| code | string | 单号 |
| createTime | date | 创建时间 |
| date | date | 要货日期 |
| details | [...] | 订单明细 |
| ┆- id | integer | id |
| images | [...] | 图片路径 |
| ┆- productClass | string | 商品分类 |
| ┆- productCode | string | 商品货号 |
| ┆- productId | integer | 商品Id |
| ┆- productName | string | 商品名称 |
| ┆- productUnit | string | 商品单位 |
| ┆- qty | decimal number | 要货数量 |
| ┆- shopOrderCode | string | 要货单单号 |
| ┆- shopOrderId | integer | 要货单Id |
| ┆- sort | integer | 排序 |
| ┆- supplierName | string | 供应商 |
| id | integer | id |
| log | string | 日志 |
| remark | string | 备注 |
| shopId | integer | 门店Id |
| shopName | string | 门店名称 |
| shopOrderBatchTag | string | 要货批次标签 |
| status | string | 0:未提交; 1:未审核; 2:已退回; 3:已完成; 4:已作废 |
| statusName | string | 状态名 |
| userId | integer | 创建人Id |
| userName | string | 创建人名称 |
请求示例
application/json, text/json
{
"shopId": 1,
"shopName": "",
"code": "",
"status": 0,
"date": "2026-01-15 10:11:28",
"statusName": "",
"shopOrderBatchTag": "",
"userId": 7,
"userName": "",
"createTime": "2026-01-15 10:11:28",
"remark": "",
"log": "",
"details": [
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
},
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
}
],
"id": 12
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| data | integer | |
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"data": 1,
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| code | string | 单号 |
| createTime | date | 创建时间 |
| date | date | 要货日期 |
| details | [...] | 订单明细 |
| ┆- id | integer | id |
| images | [...] | 图片路径 |
| ┆- productClass | string | 商品分类 |
| ┆- productCode | string | 商品货号 |
| ┆- productId | integer | 商品Id |
| ┆- productName | string | 商品名称 |
| ┆- productUnit | string | 商品单位 |
| ┆- qty | decimal number | 要货数量 |
| ┆- shopOrderCode | string | 要货单单号 |
| ┆- shopOrderId | integer | 要货单Id |
| ┆- sort | integer | 排序 |
| ┆- supplierName | string | 供应商 |
| id | integer | id |
| log | string | 日志 |
| remark | string | 备注 |
| shopId | integer | 门店Id |
| shopName | string | 门店名称 |
| shopOrderBatchTag | string | 要货批次标签 |
| status | string | 0:未提交; 1:未审核; 2:已退回; 3:已完成; 4:已作废 |
| statusName | string | 状态名 |
| userId | integer | 创建人Id |
| userName | string | 创建人名称 |
请求示例
application/json, text/json
{
"shopId": 1,
"shopName": "",
"code": "",
"status": 0,
"date": "2026-01-15 10:11:28",
"statusName": "",
"shopOrderBatchTag": "",
"userId": 7,
"userName": "",
"createTime": "2026-01-15 10:11:28",
"remark": "",
"log": "",
"details": [
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
},
{
"shopOrderId": 1,
"shopOrderCode": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"supplierName": "",
"sort": 10,
"images": [
"",
""
],
"id": 11
}
],
"id": 12
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 无 |
|---|
请求示例
application/json, text/json
{}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| log | string | 备注 |
| mainId | integer | 主单据id |
请求示例
application/json, text/json
{
"mainId": 1,
"log": ""
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| log | string | 备注 |
| mainId | integer | 主单据id |
请求示例
application/json, text/json
{
"mainId": 1,
"log": ""
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
请求示例
application/json, text/json
[ 1, 2 ]
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| log | string | 备注 |
| mainId | integer | 主单据id |
请求示例
application/json, text/json
{
"mainId": 1,
"log": ""
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| log | string | 备注 |
| mainId | integer | 主单据id |
请求示例
application/json, text/json
{
"mainId": 1,
"log": ""
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| log | string | 备注 |
| mainId | integer | 主单据id |
请求示例
application/json, text/json
{
"mainId": 1,
"log": ""
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| code | string | |
| endDate | date | |
| orderByShop | boolean | |
| shopId | integer | |
| startDate | date | |
| status | integer | |
| tag | string |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer | id |
| productClass | string | 商品分类 |
| productCode | string | 商品货号 |
| productId | integer | 商品Id |
| productName | string | 商品名称 |
| productUnit | string | 商品单位 |
| qty | decimal number | 要货数量 |
| shopId | integer | 门店Id |
| shopName | string | 门店名称 |
响应示例
application/json, text/json
[
{
"shopId": 1,
"shopName": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"id": 9
},
{
"shopId": 1,
"shopName": "",
"productId": 3,
"productCode": "",
"productName": "",
"productClass": "",
"productUnit": "",
"qty": 8.0,
"id": 9
}
]