POST/settlement/uploadProof管理后台

上传打款凭证

结算与分配 / 卡·明细·支付· SettlementCardDetailPaymentController#uploadProof

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/settlement/uploadProof
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文上传付款凭证
维护人 / 最后改动luoli　2024-06-28　最近提交：上传付款凭证
读写数据表settlement_card_detail_payment、settlement_card_detail、settlement_card　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#uploadProof
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/settlement/SettlementCardDetailPaymentController.java:369
判定依据1 个调用点：dscp-html-manage/src/api/settlement/index.ts

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

参数名	参数值	是否必填	参数类型	描述说明
无

参数名	参数值	是否必填	参数类型	描述说明
无

Body 类型 SettlementUploadInvoiceRequest

参数名	参数值	是否必填	参数类型	描述说明
settlementId	…	是	Long	结算单id → settlement_card_detail_payment.settlement_id
settlementMerchantId	…	是	Long	结算商户id（即开票方） → settlement_card_detail_payment.settlement_merchant_id
settlementMerchantName	…	是	String	结算商户名称 → settlement_card_detail_payment.settlement_merchant_name
merchantFinance	…	是	String	开户名称 → settlement_card_detail_payment.merchant_finance
merchantEbank	…	是	String	开户行 → settlement_card_detail_payment.merchant_ebank
merchantEbankAccount	…	是	String	银行账号 → settlement_card_detail_payment.merchant_ebank_account
paymentAmountActual	…	否	Long	实际打款金额，单位为分 → settlement_card_detail_payment.payment_amount_actual
remark	…	否	String	备注 → settlement_card_detail_payment.remark
invoiceFiles	…	否	List<String>	发票文件列表 → settlement_card_detail_payment.invoice_files
paymentProofFiles	…	否	List<String>	付款凭证，逗号分隔 → settlement_card_detail_payment.payment_proof_files

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

参数名	参数值	是否必填	参数类型	描述说明
void —— 不返回业务数据（外层包装见全局公共参数）

{"errcode":0,"errmsg":""}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：settlement_card_detail_payment、settlement_card_detail、settlement_card　反查全部引用接口 →

SettlementCardDetailPaymentController#uploadProof
SettlementCardDetailPaymentService#update（SettlementCardDetailPaymentServiceImpl）
SettlementCardDetailPaymentMapper#update
SettlementCardDetailService#queryList（SettlementCardDetailServiceImpl）
SettlementCardDetailMapper#queryList
SettlementCardDetailService#updateList（SettlementCardDetailServiceImpl）
SettlementCardDetailMapper#updateList
SettlementCardService#update（SettlementCardServiceImpl）
SettlementCardMapper#update
SessionUserService#getSessionUser
SessionUserService#getSessionId

其它依赖：ChaosTransactionTemplate.execute

逻辑摘要：查询详情（settlementCardDetailPaymentService.get）；调用 execute（newTransactionTemplate.execute）；更新（settlementCardDetailPaymentService.update）

操作日志：settlement / 上传打款凭证

源码内联注释（旧站解析结果）

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据