cf_Ghbf

Appearance

财务管理 ​

汇总核心业务和各插件订单的统一财务视图。

查询系统订单列表 ​

接口地址 ​

text
GET /admin/finance/order/list

接口说明 ​

查询核心业务和所有已接入订单提供者的插件订单；查询前会执行插件增量同步。

接口参数说明 ​

Query 参数类型必填说明
source_plugin_idstring否来源业务模块标识
pay_statusinteger否支付状态：1未支付，2已支付，3已退款
keywordstring否订单号、订单摘要、用户昵称或手机号关键词
start_atstring否来源订单创建开始时间，格式 YYYY-MM-DD HH:mm:ss
end_atstring否来源订单创建结束时间，格式 YYYY-MM-DD HH:mm:ss
pageinteger否
page_sizeinteger否

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "uid": "",
        "finance_order_no": "FOc123",
        "source_plugin_id": "",
        "source_plugin_name": "",
        "source_order_uid": "",
        "order_no": "",
        "business_order_no": "EC202610150001",
        "order_title": "",
        "products": [
          {
            "uid": "",
            "name": "",
            "cover": "",
            "spec_text": "",
            "quantity": 0
          }
        ],
        "member_nickname": "",
        "member_avatar": "",
        "member_mobile": "",
        "user_channel": 1,
        "user_channel_text": "微信小程序",
        "order_status": 0,
        "status_text": "",
        "pay_status": 1,
        "pay_method": "",
        "payment_channel": 1,
        "payment_channel_text": "微信支付",
        "payment_scene": 1,
        "payment_scene_text": "微信小程序",
        "product_amount": "",
        "shipping_amount": "",
        "discount_amount": "",
        "pay_amount": "",
        "paid_at": "2026-09-25T10:00:00+08:00",
        "created_at": "2026-09-25T10:00:00+08:00",
        "updated_at": "2026-09-25T10:00:00+08:00"
      }
    ],
    "total": 0,
    "pay_counts": null,
    "plugin_options": [
      {
        "plugin_id": "",
        "name": "",
        "count": 0
      }
    ]
  }
}

响应参数说明 ​

响应字段类型说明
listarray<FinanceOrderItem>
list[].uidstring核心统一订单UID
list[].finance_order_nostring核心基座订单号
list[].source_plugin_idstring来源插件标识
list[].source_plugin_namestring来源业务模块名称
list[].source_order_uidstring来源业务订单UID
list[].order_nostring业务订单号
list[].business_order_nostring业务订单号明确字段
list[].order_titlestring订单摘要
list[].productsarray<FinanceOrderProduct>
list[].products[].uidstring来源商品或订单项UID
list[].products[].namestring商品或服务名称快照
list[].products[].coverstring按当前存储配置补全的封面地址
list[].products[].spec_textstring规格文本快照
list[].products[].quantityinteger数量
list[].member_nicknamestring用户昵称快照
list[].member_avatarstring用户头像完整地址
list[].member_mobilestring用户手机号快照
list[].user_channelinteger用户渠道，与会员注册来源一致
list[].user_channel_textstring用户渠道名称
list[].order_statusinteger来源业务订单状态值
list[].status_textstring来源业务订单状态文案
list[].pay_statusinteger支付状态
list[].pay_methodstring支付方式快照
list[].payment_channelinteger支付渠道：0未支付，1微信，2支付宝
list[].payment_channel_textstring支付渠道名称
list[].payment_sceneinteger支付场景：0未支付，1至7对应统一支付场景
list[].payment_scene_textstring支付场景名称
list[].product_amountstring商品金额
list[].shipping_amountstring配送金额
list[].discount_amountstring优惠金额
list[].pay_amountstring实际支付金额
list[].paid_atstring支付时间
list[].created_atstring来源订单创建时间
list[].updated_atstring来源订单更新时间
totalinteger符合筛选条件的订单总数
pay_countsobject各支付状态订单数量
plugin_optionsarray<FinancePluginOption>
plugin_options[].plugin_idstring业务模块标识
plugin_options[].namestring业务模块名称
plugin_options[].countinteger当前模块订单数量

查询系统订单详情 ​

接口地址 ​

text
GET /admin/finance/order/detail

接口参数说明 ​

Query 参数类型必填说明
uidstring是核心统一订单UID

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "uid": "",
    "source_plugin_id": "",
    "source_plugin_name": "",
    "source_order_uid": "",
    "order_no": "",
    "order_title": "",
    "products": [
      {
        "uid": "",
        "name": "",
        "cover": "",
        "spec_text": "",
        "quantity": 0
      }
    ],
    "member_nickname": "",
    "member_avatar": "",
    "member_mobile": "",
    "order_status": 0,
    "status_text": "",
    "pay_status": 1,
    "pay_method": "",
    "product_amount": "",
    "shipping_amount": "",
    "discount_amount": "",
    "pay_amount": "",
    "paid_at": "2026-09-25T10:00:00+08:00",
    "created_at": "2026-09-25T10:00:00+08:00",
    "updated_at": "2026-09-25T10:00:00+08:00"
  }
}

响应参数说明 ​

响应字段类型说明
uidstring核心统一订单UID
source_plugin_idstring来源插件标识
source_plugin_namestring来源业务模块名称
source_order_uidstring来源业务订单UID
order_nostring业务订单号
order_titlestring订单摘要
productsarray<FinanceOrderProduct>
products[].uidstring来源商品或订单项UID
products[].namestring商品或服务名称快照
products[].coverstring按当前存储配置补全的封面地址
products[].spec_textstring规格文本快照
products[].quantityinteger数量
member_nicknamestring用户昵称快照
member_avatarstring用户头像完整地址
member_mobilestring用户手机号快照
order_statusinteger来源业务订单状态值
status_textstring来源业务订单状态文案
pay_statusinteger支付状态
pay_methodstring支付方式快照
product_amountstring商品金额
shipping_amountstring配送金额
discount_amountstring优惠金额
pay_amountstring实际支付金额
paid_atstring支付时间
created_atstring来源订单创建时间
updated_atstring来源订单更新时间

查询财务报表 ​

接口地址 ​

text
GET /admin/finance/report/overview

接口说明 ​

增量同步各插件订单后，汇总全系统订单、支付趋势、支付状态和业务模块贡献。

接口参数说明 ​

无请求参数。

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "order_count": 0,
    "paid_order_count": 0,
    "pending_count": 0,
    "refund_count": 0,
    "buyer_count": 0,
    "today_order_count": 0,
    "total_pay_amount": "",
    "today_pay_amount": "",
    "trend": [
      {
        "date": "",
        "order_count": 0,
        "pay_amount": ""
      }
    ],
    "pay_statuses": [
      {
        "pay_status": 1,
        "name": "",
        "count": 0
      }
    ],
    "modules": [
      {
        "plugin_id": "",
        "plugin_name": "",
        "order_count": 0,
        "paid_count": 0,
        "refund_count": 0,
        "pay_amount": "",
        "refund_amount": ""
      }
    ]
  }
}

响应参数说明 ​

响应字段类型说明
order_countinteger全业务订单总数
paid_order_countinteger已支付订单数
pending_countinteger未支付订单数
refund_countinteger已退款订单数
buyer_countinteger去重业务用户数
today_order_countinteger今日订单数
total_pay_amountstring累计已支付金额
today_pay_amountstring今日已支付金额
trendarray<object>
trend[].datestring日期 MM-DD
trend[].order_countinteger订单量
trend[].pay_amountstring已支付金额
pay_statusesarray<object>
pay_statuses[].pay_statusinteger
pay_statuses[].namestring
pay_statuses[].countinteger
modulesarray<object>
modules[].plugin_idstring
modules[].plugin_namestring
modules[].order_countinteger
modules[].paid_countinteger
modules[].refund_countinteger
modules[].pay_amountstring
modules[].refund_amountstring