应收记录
添加应收记录️
请求方式:POST
请求地址:/api/jediopenplatformopenapi/transaction/receivablesRecord/addReceivablesRecord
请求参数:
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
receivablesUuid | 外部应收编号【outReceivablesUuid】 | String | 是 | 100 |
payeeCode | 付款方 | String | 是 | 100 |
feeTypeCode | 费用类型 | String | 是 | 100 |
receivables | 应收金额 | BigDecimal | 是 | (18,2) |
badDebt | 坏账 | BigDecimal | 否 | (18,2) |
badDebtContent | 坏账备注 | String | 否 | 255 |
reviewState | 审核状态 | String | 是 | 100 |
transactionUuid | 交易编号 | String | 是 | 100 |
请求示例:
{
"param": {
"badDebtContent": "我是备注信息我是备注信息",
"feeTypeCode": "receiptProperty-commissionAmount",
"payeeCode": "aymentParty-developer",
"receivables": 1.00,
"receivablesUuid": "fa7edd6d96024bcf8d43706f9f6f7365",
"reviewState": "pass",
"transactionUuid": "d4b7e8590f1e4072a2d525639594986e"
}
}
出参:
参数名 | 描述 | 数据类型 | 字节长度 |
---|---|---|---|
receivablesRecordUuid | 应收账款Uuid【内部Uuid】 | String | \ |
返回示例:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": "6fae30af6e6e4daab79dfe081844ef70"
}
更新应收记录【不能更新其他枚举,应付/坏账】️
请求方式:POST
请求地址:/api/jediopenplatformopenapi/transaction/receivablesRecord/updateReceivablesRecord
请求参数:
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
receivablesUuid | 外部应收编号【outReceivablesUuid】 | String | 是 | 100 |
payeeCode | 付款方 | String | 是 | 100 |
feeTypeCode | 费用类型 | String | 是 | 100 |
receivables | 应收金额 | BigDecimal | 是 | (18,2) |
badDebt | 坏账 | BigDecimal | 否 | (18,2) |
badDebtContent | 坏账备注 | String | 否 | 255 |
reviewState | 审核状态【pass/inAudit/reject】 | String | 否 | 100 |
transactionUuid | 交易编号 | String | 是 | 100 |
请求示例:
{
"param": {
"badDebtContent": "我是一条坏账备注信息【写了数据库不会更新字段,因为这条数据不是坏账】",
"feeTypeCode": "receiptProperty-commissionAmount",
"payeeCode": "aymentParty-developer",
"receivables": 1.00,
"receivablesUuid": "fa7edd6d96024bcf8d43706f9f6f7365",
"reviewState": "pass",
"transactionUuid": "d4b7e8590f1e4072a2d525639594986e"
}
}
出参:无
返回示例:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": null
}
删除应收
请求方式:POST
请求地址:/api/jediopenplatformopenapi/transaction/receivablesRecord/deleteReceivablesRecord
请求参数:
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
transactionUuid | 交易uuid | String | 是 | 100 |
receivablesUuid | 外部应收编号【outReceivablesUuid】 | String | 是 | 100 |
请求示例:
{
"param": {
"receivablesUuid": "fa7edd6d96024bcf8d43706f9f6f7365",
"transactionUuid": "d4b7e8590f1e4072a2d525639594986e"
}
}
出参:无
返回示例:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": null
}
查询应收记录
请求方式:POST
请求地址:/api/jediopenplatformopenapi/transaction/receivablesRecord/queryReceivablesRecord
请求参数:
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
transactionUuid | 交易uuid | String | 否 | 100 |
receivablesUuid | 应收uuid | String | 是 | 100 |
reviewState | 审核状态 | String | 否 | 100 |
feeTypeCode | 费用类型 | String | 否 | 100 |
page | 页码 | Integer | 是 | \ |
pageSize | 每页数量 | Integer | 是 | 19 |
signingDateStart | 签约日期开始时间 | Date | 否 | \ |
signingDateEnd | 签约日期结束时间 | Date | 否 | \ |
earnestDateStart | 转定日期开始时间 | Date | 否 | \ |
earnestDateEnd | 转定日期结束时间 | Date | 否 | \ |
changeHouseDateStart | 过户日期开始时间 | Date | 否 | \ |
changeHouseDateEnd | 过户日期结束时间 | Date | 否 | \ |
receivablesTypeEnum | 类型 新加 RECEIVABLES:应收 PAYABLE:应付 BADDEBT:坏账 |
枚举 | 否 | 100 |
请求示例:
{
"param": {
"feeTypeCode": "",
"page": 1,
"pageSize": 20,
"receivablesTypeEnum": "RECEIVABLES",
"receivablesUuid": "",
"reviewState": "",
"transactionUuid": ""
}
}
出参:
参数名 | 描述 | 数据类型 | 备注 |
---|---|---|---|
transactionUuid | 交易uuid | String | |
receivablesUuid | 应收uuid | String | |
reviewState | 审核状态 | String | |
reviewStateName | 审核状态名称 | String | |
feeTypeCode | 费用类型 | String | |
feeTypeName | 费用类型名称 | String | |
payeeCode | 付款方 | String | |
payeeName | 付款方名称 | String | |
receivables | 金额 | BigDecimal | |
txNo | 交易编号 | String | |
propertyUuid | 房源uuid | String | |
txTypeCode | 交易性质 | String | |
txTypeName | 交易性质名称 | String | |
txCategoryCode | 交易类别 | String | |
txCategoryName | 交易类别名称 | String | |
receivablesTypeCode | 类型 新加 receivables:应收 payable :应付 badDebt:坏账 |
String | |
receivablesCreateTime | 录入日期 新加 | Date | |
overdueFlag | 是否过期 | boolean | true: 表示已过期(修改之前的数据, 已删除), false: 未过期, 最新数据 |
返回示例:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": {
"count": 3154,
"items": [
{
"receivablesUuid": "08c54e2f9c044888a06f3b32ce705572",
"payeeCode": "paymentParty-customer",
"payeeName": "客户",
"feeTypeCode": "receiptProperty-commissionAmount",
"feeTypeName": "佣金",
"receivables": 20000,
"badDebt": null,
"badDebtContent": "",
"reviewState": "pass",
"reviewStateName": "审核通过",
"transactionUuid": "71b218a7f9fd42398f2f8bc99f80e6ce",
"txNo": "JY959400701436099",
"propertyUuid": "203bab0ded704861ac1dcc3f88ae780d",
"txTypeCode": "txTypeSale",
"txTypeName": "二手交易",
"txCategoryCode": "txTypeSale",
"txCategoryName": "二手交易",
"receivablesTypeCode": "receivables",
"receivablesCreateTime": 1631808000000,
"overdueFlag": false
}
]
}
}
新增应收V2 新加接口
请求方式:POST
请求地址:/api/jediopenplatformopenapi/transaction/receivablesRecord/addReceivablesRecordV2
请求参数:
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
transactionUuid | 交易uuid | String | 是 | 100 |
receivablesUuid | 外部应收/应付/坏账uuid | String | 是 | 100 |
payeeCode | 付款方 | String | 是 | 100 |
feeTypeCode | 应收科目 | String | 是 | 100 |
receivables | 金额 | BigDecimal | 是 | (18,2) |
reviewState | 审核状态 | String | 是 | 100 |
receivablesTypeEnum | 类型 | String | 是 | RECEIVABLES:应收,PAYABLE:应付,BADDEBT:坏账 |
receivablesCreateTime | 录入日期 | Date | 是 | \ |
请求示例:
{
"param": {
"affixs": [],
"feeTypeCode": "receiptProperty-commissionAmount",
"payeeCode": "aymentParty-developer",
"receivables": 1,
"receivablesCreateTime": 0,
"receivablesTypeEnum": "RECEIVABLES",
"receivablesUuid": "fa7edd6d96024bcf8d43706f9f6f7366",
"remark": "我是一条备注",
"reviewState": "pass",
"transactionUuid": "d4b7e8590f1e4072a2d525639594986e"
}
}
出参:
参数名 | 描述 | 数据类型 | 字节长度 |
---|---|---|---|
receivablesUuid | 巧房应收/应付/坏账uuid </br>内部应收编号 | String | 100 |
返回示例:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": "8b2be8860a174208b7a2aa231f917604"
}
编辑应收V2 新加接口
请求方式:POST
请求地址:/api/jediopenplatformopenapi/transaction/receivablesRecord/updateReceivablesRecordV2
请求参数:
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
transactionUuid | 交易uuid | String | 是 | 100 |
receivablesUuid | 外部应收/应付/坏账uuid | String | 是 | 100 |
payeeCode | 付款方 | String | 是 | 100 |
feeTypeCode | 应收科目 | String | 是 | 100 |
receivables | 金额 | BigDecimal | 是 | (18,2) |
reviewState | 审核状态 | String | 是 | 100 |
receivablesTypeEnum | 类型 | 枚举 | 是 | RECEIVABLES:应收,PAYABLE:应付,BADDEBT:坏账 |
receivablesCreateTime | 录入日期 | Date | 是 | \ |
请求示例:
{
"param": {
"affixs": [],
"feeTypeCode": "receiptProperty-commissionAmount",
"payeeCode": "aymentParty-developer",
"receivables": 1.00,
"receivablesCreateTime": 0,
"receivablesTypeEnum": "RECEIVABLES",
"receivablesUuid": "fa7edd6d96024bcf8d43706f9f6f7366",
"remark": "我是一条坏账备注信息【V2接口写了数据库会更新字段",
"reviewState": "pass",
"transactionUuid": "d4b7e8590f1e4072a2d525639594986e"
}
}
出参:无
返回示例:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": null
}
查询应收实收
请求方式:POST
请求地址:/api/jediopenplatformopenapi/transaction/receivablesRecord/listReceivablesRecordByTransactionUuids
请求参数:
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
param | 交易uuids | List < String > | 是 | |
receiptCategorySettingUuid | 科目(常用科目) { receiptProperty-intentionAmount: 意向金, receiptProperty-earnestAmount: 定金, receiptProperty-commissionAmount: 佣金, receiptProperty-deposit: 押金, receiptProperty-thirdParty: 代收代付 } |
String | 否 | 100 |
receivablesTypeCode | 收付类型 { receivables: 应收, payable: 应付, badDebt: 坏账 fixedCost: 固定成本, customerCost: 自定义成本 } |
String | 否 | 100 |
payeeCode | 来源/去向 { paymentParty-customer: 客户, paymentParty-proprietor: 业主, paymentParty-developer: 开发商, paymentParty-distributor: 分销商, paymentParty-thirdParty: 第三方 } |
String | 否 | 100 |
reviewState | 状态 { inAudit: 审核中, pass: 审核通过, reject: 审核驳回, obsolete: 审核作废, } |
String | 否 | 100 |
请求示例:
{
"param": {
"receiptCategorySettingUuid": "receiptProperty-intentionAmount",
"payeeCode": "paymentParty-customer",
"receivablesTypeCode": "receivables",
"reviewState": "pass",
"uuids": [
"8fd10101a0a64bdc8bc18308e6898023"
]
}
}
返回参数:List<String, List<ReceivablesRecordListDTO>>
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
transactionUuid | 交易uuids | List < String > | 是 | 100 |
list | 应收实收列表 | List<ReceivablesRecordOpenDTO> | 是 | |
receivablesSum | 合计应收金额(元) | BigDecimal | 是 | (18,2) |
payableSum | 合计应付金额(元) | BigDecimal | 是 | (18,2) |
badDebtSum | 合计坏账(元) | BigDecimal | 是 | (18,2) |
fixedCostSum | 合计固定成本(元) | BigDecimal | 是 | (18,2) |
customerCostSum | 合计自定义成本(元) | BigDecimal | 是 | (18,2) |
参数名 | 描述 | 数据类型 | 必填 | 字节长度 |
---|---|---|---|---|
transactionUuid | 交易uuid | String | 是 | 100 |
receivablesUuid | 应收uuid | String | 是 | 100 |
receiptCategorySettingUuid | 科目 (常用科目) { receiptProperty-intentionAmount: 意向金, receiptProperty-earnestAmount: 定金, receiptProperty-commissionAmount: 佣金, receiptProperty-deposit: 押金, receiptProperty-thirdParty: 代收代付 } |
String | 是 | 100 |
receiptName | 科目名称 | String | 是 | 100 |
feeTypeCode | 费用类目code(冗余字段可忽略) | String | 是 | 100 |
receivablesTypeCode | 收付类型 { receivables: 应收, payable: 应付, badDebt: 坏账 } |
String | 是 | 100 |
payeeCode | 来源/去向 { paymentParty-customer: 客户, paymentParty-proprietor: 业主, paymentParty-developer: 开发商, paymentParty-distributor: 分销商, paymentParty-thirdParty: 第三方 } |
String | 否 | 100 |
receivables | 金额(冗余字段可忽略) | BigDecimal | 是 | (18,2) |
receiptMoney | 应收金额(元) | BigDecimal | 是 | (18,2) |
payable | 应付金额(元) | BigDecimal | 是 | (18,2) |
badDebt | 坏账(元) | BigDecimal | 是 | (18,2) |
fixedCost | 固定成本(元) | BigDecimal | 是 | (18,2) |
customerCost | 自定义成本(元) | BigDecimal | 是 | (18,2) |
receivablesCreateTime | 录入日期 | Date | 是 | |
reviewState | 状态 { inAudit: 审核中, pass: 审核通过, reject: 审核驳回, obsolete: 审核作废, } |
String | 是 | 100 |
affixList | 附件 | List<AffixDTO> | 否 | |
badDebtContent | 备注 | String | 否 | 255 |
参数名 | 描述 | 类型 | 必填 | 字节长度 |
---|---|---|---|---|
affixUuid | 附件uuid | String | 是 | 100 |
transactionUuid | 交易uuid | Stirng | 是 | 100 |
affixName | 附件名称 | Stirng | 是 | 1000 |
affixUrl | 附件url | Stirng | 是 | 1000 |
meta | 文件类型 | Stirng | 是 | 100 |
affixTypeCfgUuid | 附件类型uuid | Stirng | 是 | 100 |
businessUuid | 业务uuid | Stirng | 是 | 100 |
返回示例:
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": [
{
"transactionUuid": "8fd10101a0a64bdc8bc18308e6898023",
"list": [
{
"transactionUuid": "8fd10101a0a64bdc8bc18308e6898023",
"receivablesUuid": "8ee2a3a3113543389d06e9164ad3a17e",
"receiptCategorySettingUuid": "receiptProperty-intentionAmount",
"receiptName": "意向金",
"feeTypeCode": "receiptProperty-intentionAmount",
"receivablesTypeCode": "receivables",
"payeeCode": "paymentParty-customer",
"receivables": 1000.00,
"receiptMoney": 1000.00,
"payable": 0,
"badDebt": 0,
"fixedCost": 0,
"customerCost": 0,
"receivablesCreateTime": 1608134400000,
"reviewState": "pass",
"affixList": null,
"badDebtContent": null
}
],
"receivablesSum": 1000.00,
"payableSum": 0,
"badDebtSum": 0,
"fixedCostSum": 0,
"customerCostSum": 0
}
]
}