qmai-finance

name	qmai-finance
version	1.0.0
description	财务服务：分账明细、支付账单、营业统计、商品销售汇总
metadata	{"bins":["qmai"],"help":"qmai finance --help"}

前置条件: 请先阅读 ../qmai-shared/SKILL.md 了解认证和配置

核心概念

• statement: 分账明细、微信账单、支付宝账单、微信账单下载地址
• stats: 营业统计、订单渠道、结账方式、商品销售汇总

命令概览

对账与账单

qmai finance statement split-flows --created-at-start "2026-04-01 00:00:00" --created-at-end "2026-04-07 23:59:59" --page 1 --page-size 20
qmai finance statement wechat-bills --bill-date 2026-04-07 --page 1 --page-size 20
qmai finance statement alipay-bills --bill-date 2026-04-07 --page 1 --page-size 20
qmai finance statement wechat-bill-url --bill-date 2026-04-07 --shop-code S001

统计与字典

qmai finance stats business-summary --shop-code S001 --start-date 2026-04-01 --end-date 2026-04-07
qmai finance stats order-types
qmai finance stats settle-scenes
qmai finance stats item-turnover --shop-code S001 --start-date 2026-04-01 --page 1 --page-size 20

开放平台 API 端点

操作	端点
查询分账明细	POST /v3/payCenter/split/orderFlow
查询微信支付账单	POST /v3/payCenter/custom/wechatBill
查询支付宝支付账单	POST /v3/payCenter/offlinePayments/pullAlipayBillData
查询营业统计数据	POST /v3/dataone/finance/summary/businessRecord
查询订单渠道	POST /v3/dataone/finance/detail/orderType
查询订单结账方式	POST /v3/dataone/finance/detail/settleScene
查询微信支付账单URL	POST /v3/pay/getWechatMerchantBillUrl
查询门店商品销售汇总	POST /v3/dataone/item/store/turnover

注意事项（Agent 必读）

• alipay-bills 的官方文档没有给出明确业务字段明细，CLI 先保留原始记录列；需要完整结构时优先用 --format json
• split-flows、wechat-bills、business-summary、item-turnover 当前都是显式分页，不会自动拉全量
• item-turnover 的 page-size 官方最大支持 200
• 7.2 交易支付 和 7.3 门店账户 在官方文档仍标记待上线，当前只保留在覆盖矩阵，不进入正式命令面