1、概述
????????飛書和E簽寶在各自領域都屬于領先的產品,但因為E簽寶與釘釘的特殊關系,一直以來E簽寶都只實現了與釘釘的深度集成,一家企業如果想同時使用飛書和E簽寶,則需要通過S-HUB這樣的產品來進行橋接,用戶在飛書端審批,審批通過后把附件或表單信息同步到E簽寶進行簽署,簽署完的結果回傳飛書審批流。
????????S-HUB電子簽章集成對接方案支持附件審批對接、模板審批對接、靜默方式、單方電子簽、多方電子簽、文檔水印等復雜場景對接。
2、業務對接流程
2.1、審批流對接
流程說明
- 內部員工通過飛書審批流發起一個審批;
- 完成簽章前的審批工作;
- 審批流程發起人選擇簽章方式,簽章方式有“電子簽”、“線下簽”、“我方電子簽|對方線下簽”三種;
- 當審批狀態到達待簽章狀態時,簽章人員打開詳情能看到通過、拒絕、發起電子簽章三個操作,如果是“線下簽章”,則需要把文件蓋章掃描并上傳,然后點通過,也可以通過此處發起電子簽章,如果選擇線下簽章,后續操作跟目前正在運行的流程沒有任何差別,如果采用電子簽章,還需要經過如下步驟;
- 飛書調用S-HUB提供的鏈接,通知S-HUB需要發起電子簽章;
- S-HUB請求飛書API接口,獲取審批流詳細信息;
- S-HUB請求E簽定API接口,按要求發起電子簽章;
- 內部員工在飛書收到一條機器人推送的消息通知,提醒有一個電子簽章需要處理,點擊打開飛書內嵌瀏覽器進行身份認證和簽章;
- 如果是需要外部人員參與的多方簽章,相關人員會收到一條短信和郵件,點擊鏈接完成用戶驗證并簽章;
- 各相關方簽章完畢后,S-HUB獲取簽章后的文件提交到飛書審批流;
- 自動更新飛書審批流的狀態為已簽章狀態;
- 人工操作歸檔,至此流程結束。
2.2、飛書合同對接
流程說明
- 內部員工通過飛書合同發起一個新的合同審批;
- 完成簽章前的審批工作;
- 審批流程發起人選擇簽章方式,簽章方式有“電子簽”、“線下簽”、“我方電子簽|對方線下簽”三種;
- S-HUB會接收到每一個審批動作觸發的事件推送,當到達待簽章狀態時,S-HUB請求飛書API接口,獲取審批流詳細信息;
- S-HUB請求E簽定API接口,按要求發起電子簽章;
- 內部員工在飛書收到一條機器人推送的消息通知,提醒有一個電子簽章需要處理,點擊打開飛書內嵌瀏覽器進行身份認證和簽章,簽章操作步驟參考審批流對接章節;
- E簽寶通過短信和郵件通知外部人員,外部人員點擊鏈接完成用戶驗證并簽章,簽章操作步驟參考審批流對接章節;
- 各相關方簽章完畢后,S-HUB獲取簽章后的文件提交到飛書審批流;
- 自動更新飛書審批流的狀態為已簽章狀態;
- 人工操作歸檔,至此流程結束。
3、技術對接流程
(整體對接時序圖)
3.1、飛書審批流事件通知
審批流類事件訂閱參考“審批\審批事件\訂閱審批事件”文檔https://open.feishu.cn/document/server-docs/approval-v4/event/event-interface/subscribe
飛書合同類事件訂閱參考“飛書合同\事件\合同狀態變更”文檔https://open.feishu.cn/document/server-docs/contract-v1/contract/events/change
3.2、獲取飛書審批流詳情
參考“飛書合同管理\查看合同詳情”文檔https://open.feishu.cn/open-apis/contract/v1/contracts/:contract_id
3.3、向E簽寶發起簽章請求
(E簽寶接口調用時序圖:雙方電子簽)
(E簽寶接口調用時序圖:我方電子簽對方線下簽)
3.4、給內部簽章人發通知
參考飛書在線文檔“消息\發送消息內容”章節https://open.feishu.cn/document/server-docs/im-v1/message-content-description/create_json
3.5、e簽寶給外部用戶發通知
(短信或郵件通知)
3.6、用戶簽章
(驗證登錄)
(經辦人實名認證)
(企業認證)
(簽章)