简要描述：

  • 科研系统新增经费报销后，实时推送到第三方平台。

接口版本：

版本号 制定人 制定日期 修订日期
1.0.0 海浪 2023-08-06 null

请求URL:

  • 需第三方平台提供推送地址

请求方式：

  • POST

请求头：

参数名 是否必须 类型 说明
Authorization 是 string 请求签名
Content-Type 是 string application/json

请求示例:

POST 第三方地址 HTTP/1.1
Authorization: Bearer a34000ad9f1c456f942acc4ffb5423ae
Host: yourhost
Content-Type: application/json

{
    "projectId": "3643e421840a40feb4f13b428c3cc25e",
    "projectTitle": "项目111",
    "paymentMethod": "对公银行转账",
    "fundCategory": "专项经费",
    "subjectId": "0cfc583906cb3451ea60b82035bd3458",
    "subjectName": "设备费用",
    "subjectItems": [
        {
            "subjectId": "0cfc583906cb3451ea60b82035bd3458",
            "subjectName": "1. 设备费用",
            "budget": 32000.00,
            "budgetFundBalance": 31900.01,
            "reimbursedFund": 99.99,
            "reimburseFund": 12.34
        },
        {
            "subjectId": "b10bcd5954932657a9e9efc0346fbd71",
            "subjectName": "1.1 设备购置费",
            "budget": 22000.00,
            "budgetFundBalance": 21940.01,
            "reimbursedFund": 59.99,
            "reimburseFund": 11.34
        },
        {
            "subjectId": "b10bcd5954932657a9e9efc0346fbd71",
            "subjectName": "1.2 设备租赁费",
            "budget": 10000.00,
            "budgetFundBalance": 9960.00,
            "reimbursedFund": 40.00,
            "reimburseFund": 1.00
        }
    ],
    "reimbursementDetails": [
        {
            "payee": "上药集团",
            "bank": "中国银行上海漕宝路支行",
            "account": "622126237818781873",
            "amount": 99.99,
            "invoiceCode": "044002000211",
            "invoiceNumber": "78494203",
            "details": [
                {
                    "deviceName": "设备1",
                    "brandModel": "品牌",
                    "quantity": 1,
                    "price": 49.99,
                    "total": 49.99
                },
                {
                    "deviceName": "设备2",
                    "brandModel": "品牌",
                    "quantity": 2,
                    "price": 25.00,
                    "total": 50.00
                }
            ]
        }
    ],
    "attachments": [
        {
            "name": "附件1.png",
            "base64": "JVBERi0xLjcKCjQgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL0xlbmd0aCAxMDM4OQo+Pg......"
        },
        {
            "name": "附件2.png",
            "base64": "JVBERi0xLjcKCjQgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL0xlbmd0aCAxMDM4OQo+Pg......"
        }
    ]
}

请求参数说明:

参数名 类型 说明
id string 经费报销id，唯一，不会为null或空字符串
projectId string 项目id，不会为null或空字符串
projectTitle string 项目名称
paymentMethod string 付款方式（对外个人银行转账、内部转账、对公银行转账），不会为null或空字符串
fundCategory string 经费类别（专项经费或配套经费），不会为null或空字符串
subjectId string 科目ID，不会为null或空字符串
subjectName string 科目名称
subjectItems.budget decimal 预算经费（元），精确到小数点后2位
subjectItems.budgetFundBalance decimal 已报销经费（元），精确到小数点后2位
itsubjectItemsems.reimbursedFund decimal 预算剩余经费（元），精确到小数点后2位
subjectItems.reimburseFund decimal 本次报销金额（元），精确到小数点后2位
reimbursementDetails.payee string 收款方
reimbursementDetails.bank string 开户行
reimbursementDetails.account string 账户
reimbursementDetails.amount decimal 金额（元），精确到小数点后2位
reimbursementDetails.invoiceCode string 发票代码
reimbursementDetails.invoiceNumber string 发票号码
reimbursementDetails.details Object[] 这个不固定，第三方可自定义，如果科研系统中有的都可以传。（上面例子中是设备费明细）
attachments.name string 附件名
attachments.base64 string 附件base64编码

返回示例:

正确时返回:
第三方接口正确处理后，应该返回Http状态码 200

错误时返回:

Http状态码返回非 200 视为异常，科研平台会每隔1分钟重试 1 次，3 次后仍不成功会放弃推送。

作者：admin  创建时间：2023-08-10 11:55
最后编辑：admin  更新时间：2025-01-23 09:40