#8.32.1 提现税费预览【已开发，待云账户联调】

GET /tieup/api/v1/artist/withdrawal-preview

鉴权：需要 Authorization: Bearer <access_token>，且当前账号必须已开通偶像端。

查询参数：

响应字段：

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "withdraw_amount": "2000.00",
    "user_fee": {"fee": "10", "val": "200.00"},
    "provider_pay_amount": "1800.00",
    "estimated_tax_amount": "90.00",
    "estimated_after_tax_amount": "1710.00",
    "estimated_received_amount": "1710.00",
    "estimated_user_fee_amount": "0.00",
    "estimated_recover_tax_amount": "0.00",
    "estimated_recover_personal_tax_amount": "0.00",
    "estimated_refund_tax_amount": "0.00",
    "estimated_refund_personal_tax_amount": "0.00",
    "tax_detail": {
      "user_personal_tax": {"text": "劳动者预扣个税", "val": "90.00"},
      "user_value_added_tax": {"text": "劳动者预扣增值税", "val": "0.00"},
      "user_additional_tax": {"text": "劳动者预扣附加税费", "val": "0.00"},
      "user_recover_tax_amount": {"text": "追缴增附税", "val": "0.00"},
      "user_recover_personal_tax_amount": {"text": "追缴个税", "val": "0.00"},
      "user_refund_tax_amount": {"text": "退回增附税", "val": "0.00"},
      "user_refund_personal_tax_amount": {"text": "退回个税", "val": "0.00"}
    },
    "provider_status": "1",
    "provider_status_message": "成功",
    "preview_token": "preview-token-example",
    "preview_expires_in": 600,
    "signing_status": 1,
    "signing_status_label": "已签约",
    "tax_amount": "90.00",
    "actual_amount": "0.00",
    "can_submit": true,
    "unavailable_reason": null
  }
}

说明：

• 本接口调用云账户订单税费试算 /api/payment/v1/calc-tax，不再使用本地累计税公式，云账户异常时不回退本地税率。
• 平台提现服务费从申请金额内扣，服务费计算结果向下取整到分；扣费后的 provider_pay_amount 才传给云账户试算，且 include_user_service_fee=2。
• 云账户预估到手金额口径基于 provider_pay_amount：云账户税前订单金额 -（劳动者预扣个税 + 劳动者预扣增值税 + 劳动者预扣附加税费）- 追缴增附税 - 追缴个税 + 退回增附税 + 退回个税；接口直接采用云账户返回的 user_real_excluding_vat_amount，不在本地重算。
• tax_detail 只展示 7 项云账户税费；平台提现服务费通过顶层 user_fee 返回，平台企业和云账户承担的其他原始税费仅保留在服务端内部审计快照中。
• 试算结果是预计值；提交提现必须携带本次 preview_token，服务端不会再次计算另一份税费。
• 试算令牌绑定用户、艺人、实名摘要、税前金额和云账户配置版本，十分钟内只能消费一次。
• 旧接口 GET /tieup/api/v1/artist/withdrawal-page 暂时保留为兼容入口，返回结构同本接口；新接入请使用 withdrawal-preview。