agent-foundation/docs/ngp-sales-income-api.md

NGP 销售收入合计接口

请求

POST /api/ngp/sales-income/total

{
  "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。销售出库在 NGP 原始数据中可能使用负数表示出库方向，接口按页面“销售收入”口径取绝对值后返回正数。

成功响应

{
  "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 全部分页：

{
  "success": false,
  "status": "PROCESSING",
  "message": "后台正在汇总 8 天的销售收入数据，请稍后重试",
  "pendingDays": 8,
  "retryAfterSeconds": 10
}

调用方按照 retryAfterSeconds 重试相同请求。历史日缓存默认 24 小时，当日缓存默认 10 分钟。缓存表为 ngp_sales_income_daily_total 和 ngp_sales_income_daily_status。