消息推送到第三方平台的接口定义
应用场景
客户如有自己的OA系统或第三方OA系统，需要在每刻配置外部接口，在发生消息通知的时候，每刻系统会推送到该接口。
接口限制
该接口只支持旗舰版
请求类型
POST
接口配置说明
管理员进入设置页面，在"消息管理"页面点击"消息属性设置"按钮进入配置页面。
然后点击"修改接口地址"按钮进入如下图页面。配置地址后，需要点击"接口校验"按钮。只有校验通过的地址才能点击"确定"按钮。点击"
确定"后即自动保存。
请求参数
参数说明
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| msgId |
String(50) |
是 |
消息编号 |
| entCode |
String(50) |
是 |
企业编号 |
| receiveEntities |
List<ReceiveEntity> |
是 |
消息接收人列表 |
| formType |
String(50) |
否 |
单据类型 |
| formNo |
String(50) |
否 |
单据号 |
| procId |
String(50) |
否 |
流程实例编号 |
| taskId |
String(50) |
否 |
任务实例编号 |
| submitter |
String(50) |
否 |
消息发送人 |
| submitterJobNum |
String(50) |
否 |
消息发送人工号 |
| msgType |
String(50) |
是 |
消息类型 |
| msg |
Message |
否 |
消息内容 |
ReceiveEntity 说明
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| url |
String(50) |
否 |
接收人跳转连接 |
| pcUrl |
String(50) |
否 |
接收人跳转连接 |
| receiveJobNum |
String(50) |
是 |
接收人员工编号 |
Message 说明
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| title |
String(500) |
是 |
标题 |
| body |
String(2000) |
是 |
消息体 |
msgType说明
msgType为枚举类型，分别为：
| 值 |
说明 |
| approval |
审批通知 |
| reject |
驳回通知 |
| cc |
抄送通知 |
| urge |
催办通知 |
| completed |
单据完成通知 |
| settling |
出纳通知 |
| forward |
转交提醒通知 |
| bill_collection |
票据催收通知 |
| process_node_notice |
流程节点通知 |
| expenses_notice |
账本费用通知 |
| mileage_allowance |
里程补贴通知 |
| approval_email |
审批邮件通知（仅旗舰版） |
| dissatisfaction |
满意度通知 |
| urge_email |
催办邮件通知（仅旗舰版） |
| cashier_edit_notice |
出纳编辑通知 |
| cashier_split_notice |
出纳拆分通知 |
| contract_deadline_notice |
合同到期通知 |
| estimated_arrival_invoice_date_notice |
预计到票日期提醒 |
| pending_manual_dispatch_notice |
手动分派通知 |
| auto_reimburse_notice |
自动报销通知（需 license=AUTO_REIMBURSE） |
| scheduled_payment_time_notice |
计划付款时间提醒 |
| cash_expected_overdue_reminder |
借款-预计归还时间逾期提醒 |
| approval_summary |
待审批汇总通知 |
| work_handover_notice |
工作交接通知 |
| push_fail_notify |
单据外推失败通知 |
| message_node_notice_reimburse |
消息节点通知-报销单 |
| message_node_notice_preconsume |
消息节点通知-申请单 |
| message_node_notice_loan |
消息节点通知-借款单 |
| message_node_notice_contract |
消息节点通知-合同 |
| message_node_notice_payment |
消息节点通知-付款单 |
| agent_update_start_notice |
责任人变更发起通知 |
| agent_update_reject_notice |
责任人变更驳回通知 |
| pending_signing_notice |
待签收通知 |
| completion_signing_notice |
签收完成通知 |
| rejected_signing_notice |
签收驳回通知 |
| recalled_signing_notice |
签收召回通知 |
| payment_failure_notice |
支付失败通知 |
| payment_return_notice |
支付退回通知 |
| at |
抄送通知-被@的人员 |
| or_sign |
抄送通知-或签抄送未审批人 |
formType为枚举类型，分别为：
| 值 |
说明 |
| REIMBURSE |
报销单 |
| PRECONSUME |
申请单 |
| CONTRACT |
合同 |
| LOAN |
借款单 |
| REPAYMENT |
还款单 |
| INSTALLMENT |
分期付款单 |
参数样例
{
"msgId": "MSG_216427077107209369",
"entCode": "EC34VFIKCJ0VU9",
"formType": "REIMBURSE",
"formNo": "BXD25010093",
"procId": "c4fddb3c-d6f4-11ef-bd2d-0a580af4211c",
"msgType": "cashier_split_notice",
"submitter": "张三",
"submitterJobNum": "MK0001",
"msg": {
"title": "出纳拆分通知",
"body": "BXD25010093报销单-无行程-20251104251200490.900000支付单25120049被拆分出金额为0.10的新支付单 26040032"
},
"receiveEntities": [
{
"url": "/approve/REIMBURSE/null/BX136001951216185345",
"pcUrl": "/approve/REIMBURSE/null/BX136001951216185345",
"receiveJobNum": "MK0001",
"lang": "zh",
"userId": "MK0001"
},
{
"url": "/approve/REIMBURSE/null/BX136001951216185345",
"pcUrl": "/approve/REIMBURSE/null/BX136001951216185345",
"receiveJobNum": "MK0002",
"lang": "zh",
"userId": "MK0002"
}
]
}
响应参数
参数说明
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| success |
boolean |
是 |
是否成功， true ｜ false |
| errorMsg |
String |
否 |
错误信息 |
参数样例
- 正常响应参数示例
{
"success": true,
"errorMsg": null
}
- 错误响应参数示例
{
"success": false,
"errorMsg": "单号不存在****"
}
修改记录
2026-06-29 msgType 字段新增 30 项补充枚举值。
2023-04-28 新增