56 lines
1.4 KiB
Markdown
56 lines
1.4 KiB
Markdown
|
# NGP 销售收入合计接口
|
||
|
|
|
||
|
|
## 请求
|
||
|
|
|
||
|
|
`POST /api/ngp/sales-income/total`
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"startDate": "2026-08-03",
|
||
|
|
"endDate": "2026-08-10",
|
||
|
|
"businessType": "普通销售",
|
||
|
|
"employeeName": "蔡少华",
|
||
|
|
"storeName": ""
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
- `startDate`、`endDate` 和 `businessType` 必填，日期范围最多 31 天。
|
||
|
|
- `employeeName` 和 `storeName` 选填；不传或传空字符串时不限制对应条件。
|
||
|
|
- 日期包含首尾两天，时间范围为开始日 `00:00:00` 至结束日 `23:59:59`。
|
||
|
|
- 服务按 `businessTypeName`、`efullname`、`ofullname` 精确筛选，并汇总
|
||
|
|
`detailList.currencyDisedTaxedTotal`；缺少明细时使用 `currencyBillTotal`。
|
||
|
|
|
||
|
|
## 成功响应
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"success": true,
|
||
|
|
"startDate": "2026-08-03",
|
||
|
|
"endDate": "2026-08-10",
|
||
|
|
"businessType": "普通销售",
|
||
|
|
"employeeName": "蔡少华",
|
||
|
|
"storeName": "全部店铺",
|
||
|
|
"salesIncomeAmount": 102719.35,
|
||
|
|
"formattedSalesIncome": "102,719.35",
|
||
|
|
"currency": "CNY"
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## 缓存处理中
|
||
|
|
|
||
|
|
每日维度缓存缺失或过期时返回 HTTP `202`，并在后台读取 NGP 全部分页：
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"success": false,
|
||
|
|
"status": "PROCESSING",
|
||
|
|
"message": "后台正在汇总 8 天的销售收入数据，请稍后重试",
|
||
|
|
"pendingDays": 8,
|
||
|
|
"retryAfterSeconds": 10
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
调用方按照 `retryAfterSeconds` 重试相同请求。历史日缓存默认 24 小时，当日缓存默认
|
||
|
|
10 分钟。缓存表为 `ngp_sales_income_daily_total` 和
|
||
|
|
`ngp_sales_income_daily_status`。
|