接口描述
| HTTP Verb | URL |
|---|---|
| POST | /api/supplier-service/v1/b2b/writeOffPayableBill |
Example:
POST /api/supplier-service/v1/b2b/writeOffPayableBill HTTP/1.1 Content-Type: application/json Accept: application/json Host: http://cfs-qa.etowertech.com/ X-WallTech-Date: Thu, 06 Aug 2020 06:44:25 GMT Authorization: WallTech testLvs2jdug2qIoRsJyuxs:F714XG5EBjslUUdx5xJrTCVb9Xs=
请求样例
{
"deductAccount": false,
"writeOffRemark": "88888",
"writeOffTime": "2026-01-04 00:00:00",
"fileList" : [{
"fileBase64" :
"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qL1VR9VDxCMQQ1HesGVD/4JLxplGErbVrCYWMlOCiR0YniwpwWNG4IUyV0pclcSn5+Nnv8zNpLd8+/NvPElHv+8m30Z3oz9FQjRbAs4znTyQnUV4LKQajLJKZVzLjkUlEYf7p5mDUUX/6v/WPNlsklUMF2kYpR0bKKQ9fh1hSgLWduv9uCvp1CHG8ZYIT7eZG+VghwW2Ojd5+15L6ea5VeXXcuu3yu0fe7zdEgplbmRzdHJlYW0KZW5kb2JqCjEgMCBvYmoKPDwvVGFicy9TL0dyb3VwPDwvUy9UcmFuc3BhcmVuY3kvVHlwZS9Hcm91cC9DUy9EZXZpY2VSR0I+Pi9Db250ZW50cyA3IDAgUi9UeXBlL1BhZ2UvUmVzb3VyY2VzPDwvQ29sb3JTcGFjZTw8L0NTL0RldmljZVJHQj4+L1Byb2NTZXQgWy9QREYgL1RleHQgL0ltYWdlQiAvSW1hZ2VDIC9JbWFnZUldL0ZvbnQ8PC9GMSAyIDAgUi9GMiAzIDAgUi9GMyA2IDAgUj4+L1hPYmplY3Q8PC9YZjEgNCAwIFIvaW1nMCA1IDAgUj4+Pj4vUGFyZW50IDggMCBSL01lZGlhQm94WzAgMCA1OTUgODQyXT4+CmVuZG9iago5IDAgb2JqClsxIDAgUi9YWVogMCA4NTIgMF0KZW5kb2JqCjIgMCBvYmoKPDwvU3VidHlwZS9UeXBlMS9UeXBlL0ZvbnQvQmFzZUZvbnQvSGVsdmV0aWNhL0VuY29kaW5nL1dpbkFuc2lFbmNvZGluZz4+CmVuZG9iagozIDAgb2JqCjw8L1N1YnR5cGUvVHlwZTEvVHlwZS9Gb250L0Jhc2VGb250L0hlbHZldGljYS1Cb2xkL0VuY29kaW5nL1dpbkFuc2lFbmNvZGluZz4+CmVuZG9iagoxMCAwIG9iago8PC9EZXNjZW50IC0xMjAvQ2FwSGVpZ2h0IDg4MC9TdGVtViA5My9UeXBlL0ZvbnREZXNjcmlwdG9yL0ZsYWdzIDYvU3R5bGU8PC9QYW5vc2UoAQUCAgQAAAAAAAAAKT4+L0ZvbnRCQm94IFstMjUgLTI1NCAxMDAwIDg4MF0vRm9udE5hbWUvU1RTb25nLUxpZ2h0L0l0YWxpY0FuZ2xlIDAvQXNjZW50IDg4MD4+CmVuZG9iagoxMSAwIG9iago8PC9EVyAxMDAwL1N1YnR5cGUvQ0lERm9udFR5cGUwL0NJRFN5c3RlbUluZm88PC9TdXBwbGVtZW50IDQvUmVnaXN0cnkoQWRvYmUpL09yZGVyaW5nKEdCMSk+Pi9UeXBlL0ZvbnQvQmFzZUZvbnQvU1RTb25nLUxpZ2h0L0ZvbnREZXNjcmlwdG9yIDEwIDAgUj4+CmVuZG9iago2IDAgb2JqCjw8L1N1YnR5cGUvVHlwZTAvVHlwZS9Gb250L0Jhc2VGb250L1NUU29uZy1MaWdodC1VbmlHQi1VQ1MyLUgvRW5jb2RpbmcvVW5pR0ItVUNTMi1IL0Rlc2NlbmRhbnRGb250c1sxMSAwIFJdPj4KZW5kb2JqCjggMCBvYmoKPDwvS2lkc1sxIDAgUl0vVHlwZS9QYWdlcy9Db3VudCAxL0lUWFQoMi4xLjcpPj4KZW5kb2JqCjEyIDAgb2JqCjw8L05hbWVzWyhKUl9QQUdFX0FOQ0hPUl8wXzEpIDkgMCBSXT4+CmVuZG9iagoxMyAwIG9iago8PC9EZXN0cyAxMiAwIFI+PgplbmRvYmoKMTQgMCBvYmoKPDwvTmFtZXMgMTMgMCBSL1R5cGUvQ2F0YWxvZy9QYWdlcyA4IDAgUi9WaWV3ZXJQcmVmZXJlbmNlczw8L1ByaW50U2NhbGluZy9BcHBEZWZhdWx0Pj4+PgplbmRvYmoKMTUgMCBvYmoKPDwvTW9kRGF0ZShEOjIwMjQxMjE3MDk0NTE3KzA4JzAwJykvQ3JlYXRvcihKYXNwZXJSZXBvcnRzIExpYnJhcnkgdmVyc2lvbiA2LjEyLjEtYWMwZWViZGIyOWU0YzA5ODU0NTdiYWIyNzlhNmRiNzQ0ZDY2MTUzMCkvQ3JlYXRpb25EYXRlKEQ6MjAyNDEyMTcwOTQ1MTcrMDgnMDAnKS9Qcm9kdWNlcihpVGV4dCAyLjEuNyBieSAxVDNYVCkvQXV0aG9yKFN5c3RlbSk+PgplbmRvYmoKeHJlZgowIDE2CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMjg5MCAwMDAwMCBuIAowMDAwMDAzMjE3IDAwMDAwIG4gCjAwMDAwMDMzMDUgMDAwMDAgbiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAxMzA2IDAwMDAwIG4gCjAwMDAwMDM3NTUgMDAwMDAgbiAKMDAwMDAwMjI2MCAwMDAwMCBuIAowMDAwMDAzODgwIDAwMDAwIG4gCjAwMDAwMDMxODIgMDAwMDAgbiAKMDAwMDAwMzM5OCAwMDAwMCBuIAowMDAwMDAzNTkwIDAwMDAwIG4gCjAwMDAwMDM5NDMgMDAwMDAgbiAKMDAwMDAwMzk5OCAwMDAwMCBuIAowMDAwMDA0MDMyIDAwMDAwIG4gCjAwMDAwMDQxMzcgMDAwMDAgbiAKdHJhaWxlcgo8PC9JbmZvIDE1IDAgUi9JRCBbPDY5ZDFmOTQ5NTc5OGQzMWM4NTBhMDg3ZGJkZGY5MzRjPjxjMjU4MjVjZmU1ZGM3ZjNiZmFjNWQzOWE2MzIwZTM1YT5dL1Jvb3QgMTQgMCBSL1NpemUgMTY+PgpzdGFydHhyZWYKNDM2MgolJUVPRgo=",
"fileName" : "附件信息111.pdf"
}]
"items": [
{
"amount": 1000,
"currency": "CNY",
"writeOffAmount": "1",
"aggregatorInvoiceId": "",
"billWriteOffRemarks": "1",
"payableBillNo": "PBN186061260107000005O"
},
{
"amount": 35,
"currency": "CNY",
"writeOffAmount": "1",
"aggregatorInvoiceId": "",
"billWriteOffRemarks": "2",
"payableBillNo": "PBN186061260107000004O"
},
{
"amount": 1500,
"currency": "CNY",
"writeOffAmount": "1",
"aggregatorInvoiceId": "",
"billWriteOffRemarks": "3",
"payableBillNo": "PBN186061260107000003O"
}
],
"deductList": []
}
请求字段描述
字段名 | 类型 | 是否必填项 | 描述 | |
| items | List | 是 | 核销项目列表 | |
| payableBillNo | String | 是 | 付款申请编号 | |
| currency | String | 是 | 账单币种 | |
| amount | BigDecimal | 是 | 账单金额 | |
| writeOffAmount | BigDecimal | 是 | 本次核销金额 | |
| aggregatorInvoiceId | Long | 否 | 本公司账户id | |
| billWriteOffRemarks | String | 否 | 账单核销备注(最大长度255) | |
| deductAmount | BigDecimal | 否 | 本次账户扣除金额(目前不支持该功能) | |
| accountId | Long | 否 | 核销账户id(目前不支持该功能) | |
| deductAccount | Boolean | 否 | 是否扣减账户(目前不支持该功能) | |
| writeOffRemark | String | 否 | 核销备注,最多255字符(核销流水记录上的备注) | |
| writeOffTime | Date | 否 | 核销时间,不提供则用当前时间 | |
| fileList | List | 否 | 上传附件列表 | |
| fileBase64 | String | 是 | 附件进行BASE64编码后的数据 | |
| fileName | String | 是 | 附件名称 | |
| deductList | List | 否 | 账户扣减详情(目前不支持该功能) | |
| accountId | Long | 是 | 核销账户id | |
| deductAmount | BigDecimal | 是 | 扣除账户金额 |
返回内容如下
{
"code":"0",
"data":"",
"errors":"",
"message":"",
"messageId":"核销成功",
"success":true,
"warnList":""
}
{
"code": 3,
"message": "参数错误",
"data": null,
"success": false,
"errors": [
{
"code": "BILL_NOT_EXISTS",
"message": "账单不存在"
}
]
}
返回字段描述:
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应码,成功为0 |
| message | String | 响应消息 |
| data | String | 返回数据,成功时返回"核销成功" |
| success | Boolean | 是否成功 |
接口描述
| HTTP Verb | URL |
|---|---|
| POST | /api/supplier-service/v1/b2b/writeOffPayableBill |
Example:
POST /api/supplier-service/v1/b2b/writeOffPayableBill HTTP/1.1 Content-Type: application/json Accept: application/json Host: http://cfs-qa.etowertech.com/ X-WallTech-Date: Thu, 06 Aug 2020 06:44:25 GMT Authorization: WallTech testLvs2jdug2qIoRsJyuxs:F714XG5EBjslUUdx5xJrTCVb9Xs=
请求样例
{
"deductAccount": false,
"writeOffRemark": "88888",
"writeOffTime": "2026-01-04 00:00:00",
"attachment": [],
"items": [
{
"amount": 1000,
"currency": "CNY",
"writeOffAmount": "1",
"aggregatorInvoiceId": "",
"billWriteOffRemarks": "1",
"payableBillNo": "PBN186061260107000005O"
},
{
"amount": 35,
"currency": "CNY",
"writeOffAmount": "1",
"aggregatorInvoiceId": "",
"billWriteOffRemarks": "2",
"payableBillNo": "PBN186061260107000004O"
},
{
"amount": 1500,
"currency": "CNY",
"writeOffAmount": "1",
"aggregatorInvoiceId": "",
"billWriteOffRemarks": "3",
"payableBillNo": "PBN186061260107000003O"
}
],
"deductList": []
}
请求字段描述
字段名 | 类型 | 是否必填项 | 描述 | |
| items | List | 是 | 核销项目列表 | |
| payableBillNo | String | 是 | 付款申请编号 | |
| currency | String | 是 | 账单币种 | |
| amount | BigDecimal | 是 | 账单金额 | |
| writeOffAmount | BigDecimal | 是 | 本次核销金额 | |
| aggregatorInvoiceId | Long | 否 | 本公司账户id | |
| billWriteOffRemarks | String | 否 | 账单核销备注(最大长度255) | |
| deductAmount | BigDecimal | 否 | 本次账户扣除金额(目前不支持该功能) | |
| accountId | Long | 否 | 核销账户id(目前不支持该功能) | |
| deductAccount | Boolean | 否 | 是否扣减账户(目前不支持该功能) | |
| writeOffRemark | String | 否 | 核销备注,最多255字符(核销流水记录上的备注) | |
| writeOffTime | Date | 否 | 核销时间,不提供则用当前时间 | |
| deductList | List | 否 | 账户扣减详情(目前不支持该功能) | |
| accountId | Long | 是 | 核销账户id | |
| deductAmount | BigDecimal | 是 | 扣除账户金额 |
返回内容如下
{
"code":"0",
"data":"",
"errors":"",
"message":"",
"messageId":"核销成功",
"success":true,
"warnList":""
}
{
"code": 3,
"message": "参数错误",
"data": null,
"success": false,
"errors": [
{
"code": "BILL_NOT_EXISTS",
"message": "账单不存在"
}
]
}
返回字段描述:
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应码,成功为0 |
| message | String | 响应消息 |
| data | String | 返回数据,成功时返回"核销成功" |
| success | Boolean | 是否成功 |