第三方集成用友待办

一、对接流程

• 1、三方系统注册监听待办事件订阅
• 2、YonBIP/YonSuite发送待办事件，三方系统接收到待办事件后根据事件编码确定走不同的逻辑（新增/更新待办）。
• 3、事件订阅返回的新增/更新待办中的businessKey是成对出现的，也就是说根据businessKey可以判断将哪条待办数据更新为已办。
• 4、三方在接收道待办信息后建议将businessKey和待办动作信息存储入库，原因事件订阅方式可能会存在消费失败的情况，如果配置了重试可能会造成接收到的更新待办早于新增待办。 从而三方可能会有一条无法删除的待办记录。所以在处理逻辑的时候需要判断数据库中是否存在对应的businessKey+动作，区分多种情况。

1)、新增事件逻辑：首先判断businessKey是否在系统中存在，如果存在，直接结束执行；如果不存在， 则正常走逻辑

2)、更新事件逻辑：首先判断businessKey是否在系统中存在，如果不存在说明消息顺序反了。需要存储入库。标记为更新动作；如果存在相同更新动作的businessKey，则不需要做后续执行操作；如果存在且不是更新动作，说明是新增动作。那就需要正常处理更新逻辑；

• 5、确定好逻辑后，需确定发送给哪个三方用户，建议三方系统和YonBIP/YonSuite的用户编码/手机号/邮箱一致。待办信息会返回yhtUserId。可以根据 yhtUserId调用开放平台接口（详见五章节）获取用户编码/手机号/邮箱。三方系统根据用户编码/手机号/邮箱获取三方的唯一标识。然后就可以发送给指定三方用户。
• 6、三方用户在三方系统中点击待办开始走单点登录相关逻辑（详见六章节）

二、指定租户开通接收待办

提交工单给指定租户开通接收待办事件; 工单说明如下:

需要开通接收待办事件 租户id: ****** 租户名称:****** 标注是哪个数据中心

三、订阅待办事件

请点击链接查看:

事件订阅

• 添加以下两个事件，

四、待办数据格式

businessKey是成对出现的，一个新增待办对应一个更新待办

4.1、创建代办接收数据格式

{ “msgTsLong“: 1635583234094, “resendable“: true, “omitNotify“: false, “todoType“: “approve“, “srcMsgId“: “20211030202110307d0f6df7-d4d6-4f0e-ad11-76f26aa8819d:ubpm20200520“, “typeName“: “待办消息“, “approveSource“: “PU“, “richText“: “来自倪帅臣于10-30 15:48提交的采购订单CGDD0000211030000002,请处理。 “, “title“: “待办提醒“, “content“: “来自倪帅臣于10-30 15:48提交的采购订单CGDD0000211030000002,请处理。 “, “mUrl“: “https://mdf-node-yonsuite.diwork.com/meta/voucher/st_purchaseorder/2496594306814208?domainKey=upu&apptype=mdf&taskFlag=todo&typecode=approve&tenantId=aen06kxy&qzId=278401&code=${esncode}&isReturnNative=true&source=PU,u8c,UIT&yssource=PU,u8c,UIT“, “yyUserIds“: [“0f059088-9c92-4769-a3e7-8f1a341cc3df“], “webUrl“: “https://mdf-node-yonsuite.diwork.com/meta/voucher/st_purchaseorder/2496594306814208?domainKey=upu&bipCasTag&taskFlag=todo&typecode=approve&tenantId=aen06kxy&qzId=278401&source=PU,u8c,UIT