预收款项详情列表

接口地址:/zxb/advancePaymentDetail/list

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "projectId":"1978396803251109890",
  "zxbCustomerId":"1978396051791216641"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
open-platform 预收款对象Req 组织 body true open-platform
款对象Req open-platform 预收款对象Req
  projectId 工地id false integer(int64) 与zxbCustomerId二选一
  zxbCustomerId 签约客户id false integer(int64) 与projectId二选一

响应状态:

状态码 说明 schema
200 OK R«long»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data integer(int64) integer(int64)
  id 预收款id integer(int64) integer(int64)
  projectId 工地id integer(int64) integer(int64)
  zxbCustomerId 签约客户id integer(int64) integer(int64)
  paymentItem 预收款项 string
  amount 预收金额 BigDecimal(16,2)
  remark 收款说明 string
  deductionAmount 定金抵扣金额 BigDecimal(16,2)
  balanceDeductionAmount 发起预收款时账户的余额 BigDecimal(16,2)
  paymentStatus 支付状态 string 枚举类（AWAITING_DEPOSIT:待预存,ALREADY_DEPOSITED:已预存,AWAITING_UNLOCK:待解锁,ALREADY_UNLOCKED:已解锁,UNLOCKED_FAILED:解锁失败,INVALID:作废）
  paymentStatusName 支付状态名称 string
  unlockedAmount 解冻金额 string
  outFlowId 支付宝的流水号 string
  advancePaymentRemark 预收款说明 string
  otherInfo 其他信息 string
  paymentTime 解冻时间（支付宝划款时间） Date
  isDepositDeduction 是否使用定金抵扣 boolean
  createdTime 创建时间 Date
  accountBalance 账户当前余额 BigDecimal(16,2)
  actualAmount 实际金额（待预存：预收金额-定金余额-账户余额，其他状态：预收金额-定金余额） BigDecimal(16,2)
message string
successful boolean

响应示例:

{
  "code": 200,
  "message": "成功",
  "data": [
    {
      "id": "1978432445586628609",
      "projectId": "1978396803251109890",
      "zxbCustomerId":"1978396051791216641",
      "paymentItem": "开工开工",
      "amount": 300000.0,
      "remark": null,
      "deductionAmount": 10000.0,
      "balanceDeductionAmount": 0.0,
      "paymentStatus": "AWAITING_DEPOSIT",
      "paymentStatusName": "待预存",
      "unlockedAmount": null,
      "outFlowId": null,
      "advancePaymentRemark": "收了这么多钱",
      "otherInfo": null,
      "paymentTime": null,
      "isDepositDeduction": true,
      "createdTime": "2025-10-15 20:07:07",
      "accountBalance": null,
      "actualAmount": null
    }
  ],
  "successful": true
}

获取当前账户和定金余额

接口地址:/zxb/advancePaymentDetail/getPreData

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "projectId":"1978396803251109890",
  "zxbCustomerId":"1978396051791216641"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
open-platform 预收款对象Req 组织 body true open-platform预收款对象Req open-platform 预收款对象Req
  projectId 工地id false integer(int64) 与zxbCustomerId二选一
  zxbCustomerId 签约客户id false integer(int64) 与projectId二选一

响应状态:

状态码 说明 schema
200 OK R«long»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data integer(int64) integer(int64)
  projectId 工地id integer(int64) integer(int64)
  deductionAmount 定金可抵扣金额 BigDecimal(16,2)
  balanceDeductionAmount 账户的余额 BigDecimal(16,2)
message string
successful boolean

响应示例:

{
  "code": 200,
  "message": "成功",
  "data": {
    "projectId": "1978363673974734850",
    "zxbCustomerId":"1978396051791216641",
    "deductionAmount": 5000.0,
    "balanceDeductionAmount": 1000.0
  },
  "successful": true
}

创建预收款详情

接口地址:/zxb/advancePaymentDetail/create

请求方式:POST

请求数据类型:multipart/form-data

响应数据类型:*/*

接口描述:

请求示例:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
  paymentItem 预收款项 true string
  amount 预收款 true BigDecimal(16,2)
  projectId 工地id false integer(int64) 与zxbCustomerId二选一
  zxbCustomerId 签约客户id false integer(int64) 与projectId二选一
  advancePaymentRemark 预收款说明 false string
  isDepositDeduction 是否定金抵扣 true boolean
  files 文件数组 false file[]
  otherInfo 其他数据（jsonArray字符串, key：表示title显示的名字，type：（text:文本,iamges:图片，pdf：pdf文件），value：显示的值（type为iamges、pdf:该值为files文件对应的文件名字带后缀，text：文字内容），sort:显示的顺序升序） false josnArray_string [{“key”:”value1”,”type”:”text”,”value”:”valu1”,”sort”:”1”},{“key”:”value2”,”type”:”images”,”value”:”valu1”,”sort”:”2”},{“key”:”value2”,”type”:”pdf”,”value”:”valu1”,”sort”:”2”}]

响应状态:

状态码 说明 schema
200 OK R«long»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data boolean
message string
successful boolean

响应示例:

{
  "code": 200,
  "message": "成功",
  "data": true,
  "successful": true
}

解锁付款

接口地址:/zxb/advancePaymentDetail/updateStatus

请求方式:POST

请求数据类型:multipart/form-data

响应数据类型:*/*

接口描述:

请求示例:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
open-platform 预收款对象Req 组织 body true open-platform预收款对象Req open-platform 预收款对象Req
  id 预收款id true integer(int64)
  projectId 工地id false integer(int64) 与zxbCustomerId二选一
  zxbCustomerId 签约客户id false integer(int64) 与projectId二选一
  remark 收款说明 false string
  files 文件数组 false file[]
  otherInfo 其他数据（jsonArray字符串, key：表示title显示的名字，type：（text:文本,iamges:图片，pdf：pdf文件），value：显示的值（type为iamges、pdf:该值为files文件对应的文件名字带后缀，text：文字内容），sort:显示的顺序升序） false josnArray_string [{“key”:”value1”,”type”:”text”,”value”:”valu1”,”sort”:”1”},{“key”:”value2”,”type”:”images”,”value”:”valu1”,”sort”:”2”},{“key”:”value2”,”type”:”pdf”,”value”:”valu1”,”sort”:”2”}]

响应状态:

状态码 说明 schema
200 OK R«long»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data boolean
message string
successful boolean

响应示例:

{
  "code": 200,
  "message": "成功",
  "data": true,
  "successful": true
}
作者：admin  创建时间：2025-10-22 15:21
最后编辑：admin  更新时间：2025-12-01 15:12