简要描述：

请求域名:

  • http://xx.com

请求URL:

POST/plugin.withdrawal-invoice.frontend.index.withdrawalDetail

参数:

参数名 是否必须 类型 说明
withdraw_sn 是 string 提现单号
withdraw_type 是 int 1供应商提现，不传或其他为默认提现

返回示例:

正确时返回:

默认提现 withdraw_type 不为1
{
    "result": 1,
    "msg": "ok",
  "data": {
        "withdraw_sn": "WS20250618091510502622",
        "type_name": "提现到余额",
        "status_name": "待确认",
        "apply_money": "999.00",
        "created_at": "2025-06-18 09:15:10",
        "money": "949.05",
        "reject_reason": "",
        "has_one_invoice": {
            "id": 4,
            "withdraw_sn": "WS20250618091510502622",
            "invoice_status": 1,
            "invoice_image": [],
            "status_name": "待确认",
			"invoice_money": "20.00",
            "supplier_withdraw": null
        },
        "poundage": "49.95",
        "servicetax": "0.00",
        "is_upload": 1
    },
}
供应商提现withdraw_type ==1
{
    "result": 1,
    "msg": "ok",
 "data": {
        "withdraw_sn": "AY20190704223019uklQOx",
        "type_name": "微信提现",
        "status_name": "待补充",
        "apply_money": "40.00",
        "created_at": "2019-07-04T14:30:19.000000Z",
        "money": "38.00",
        "reject_reason": "",
           "has_one_invoice": {
            "id": 4,
            "withdraw_sn": "AY20190704223019uklQOx",
            "invoice_status": 1,
            "invoice_image": [],
			"invoice_money": "20.00",
            "status_name": "待确认",
            "supplier_withdraw": null
        },
        "is_upload": 0
    },
}

提现详情通用响应结构（供应商/默认）

参数名 类型 说明 示例
公共字段 适用于所有提现类型
withdraw_sn string 提现流水号 "WS..."或"AY..."
withdraw_name string 提现名称 "门店提现"
type_name string 提现方式 "提现到余额"/"微信提现"
status_name string 提现状态 "待确认"/"待补充"
apply_money string 申请金额（固定含两位小数） "999.00"
created_at string 创建时间 标准格式："2025-06-18 09:15:10" 或 ISO格式
money string 实际到账金额（固定含两位小数） "949.05"
reject_reason string 拒绝原因（空字符串表示无） ""
has_one_invoice object 发票信息 详见下方子表
is_upload int 是否可上传发票（0否/1是） 1
默认提现专有字段 当 withdraw_type !=1 时出现
poundage string 提现手续费（固定含两位小数） "49.95"
servicetax string 服务税（固定含两位小数） "0.00"

has_one_invoice 发票信息对象

参数名 类型 说明 示例
id int 发票记录ID 4
withdraw_sn string 对应提现单号 "WS..."
invoice_status int 发票状态(0待确认/1审核中) 1
invoice_image array 发票图片URL数组 []
status_name string 发票状态名称 "待确认"
invoice_money string 开票金额 "20.00"
invoice_time string 开票时间 "2024-12-03 14:56:13"

关键差异说明

  1. 供应商提现(withdraw_type=1)：

    • 流水号以AY开头（默认提现为WS开头）
    • 不包含手续费(poundage)、服务税(servicetax)字段
    • 状态名可能为"待补充"（需补发票材料）
    • is_upload标识是否可上传（0不可/1可）

  2. 时间格式兼容：

    • 创建时间可能为标准格式（YYYY-MM-DD HH:mm:ss）或ISO格式（YYYY-MM-DDTHH:mm:ss.SSSSSSZ）

  3. 金额计算：

    • 实际扣减 = apply_money - (poundage + servicetax)
    • 供应商提现需自行计算：扣减额 = apply_money - money

  4. 状态扩展：

    • status_name 新增"待补充"状态（需用户补充材料）
    • 发票状态(status_name)与提现状态(status_name)独立存在