釘釘應(yīng)用
一、功能介紹
推送領(lǐng)星ERP消息至釘釘，在釘釘接收消息并可完成單據(jù)審批。
二、操作流程
1.第一步：創(chuàng)建釘釘內(nèi)部應(yīng)用
步驟1：點(diǎn)擊“創(chuàng)建應(yīng)用”
進(jìn)入釘釘開(kāi)放臺(tái)（https://open-dev.dingtalk.com/），選擇“企業(yè)內(nèi)部應(yīng)用-釘釘應(yīng)用”，點(diǎn)擊創(chuàng)建應(yīng)用
應(yīng)用名稱：領(lǐng)星ERP
應(yīng)用描述：跨境電商ERP管理系統(tǒng)，為跨境賣家提供數(shù)字化解決方案，助力實(shí)現(xiàn)精細(xì)管理和業(yè)務(wù)增長(zhǎng)。
應(yīng)用圖標(biāo)：上傳下圖領(lǐng)星ERP的圖標(biāo)
步驟2：添加網(wǎng)頁(yè)應(yīng)用能力，維護(hù)網(wǎng)頁(yè)應(yīng)用信息
點(diǎn)擊添加網(wǎng)頁(yè)應(yīng)用，配置后維護(hù)好以下信息：
應(yīng)用首頁(yè)地址：https://erp.lingxing.com/dingTips?corpid=$CORPID$
PC端首頁(yè)地址：https://erp.lingxing.com/dingTips?corpid=$CORPID$
（若為獨(dú)立部署環(huán)境，請(qǐng)將鏈接中的“erp”更改為自己的領(lǐng)星域名）
步驟3：填寫(xiě)安全設(shè)置
服務(wù)器出口IP：出口IP內(nèi)容請(qǐng)聯(lián)系您的專屬顧問(wèn)獲取
重定向URL：https://audit.lingxing.com,https://audit.lingxing.com/approvalDetail
端內(nèi)免登地址：https://audit.lingxing.com,https://audit.lingxing.com/approvalDetail
填寫(xiě)完成后點(diǎn)擊“保存”。
步驟4：申請(qǐng)權(quán)限
在“權(quán)限管理”頁(yè)面，點(diǎn)擊“申請(qǐng)權(quán)限”申請(qǐng)以下權(quán)限：通訊錄部門信息讀權(quán)限、通訊錄部門成員讀權(quán)限、成員信息讀權(quán)限、企業(yè)已安裝的應(yīng)用列表查詢權(quán)限、微應(yīng)用后臺(tái)免登訪問(wèn)權(quán)限。
權(quán)限范圍：全部員工
步驟5：創(chuàng)建并發(fā)布版本
至少發(fā)布一個(gè)版本，使應(yīng)用狀態(tài)轉(zhuǎn)為【已上線】后，企業(yè)中其他成員方可使用應(yīng)用。
版本發(fā)布成功后，應(yīng)用為【已上線】狀態(tài)。
2.第二步：企業(yè)授權(quán)、用戶匹配
領(lǐng)星授權(quán)釘釘?shù)钠髽I(yè)信息及應(yīng)用信息獲取頁(yè)面：釘釘內(nèi)部應(yīng)用-領(lǐng)星ERP
（1）企業(yè)授權(quán)：將領(lǐng)星和釘釘?shù)钠髽I(yè)關(guān)聯(lián)起來(lái)
打開(kāi)領(lǐng)星ERP，進(jìn)入“設(shè)置-業(yè)務(wù)配置-全局-釘釘授權(quán)”頁(yè)面，填寫(xiě)釘釘?shù)钠髽I(yè)及應(yīng)用信息，該信息在以下頁(yè)面獲?。横斸旈_(kāi)放平臺(tái)（https://open-dev.dingtalk.com/）的“應(yīng)用信息”頁(yè)面。
填寫(xiě)后點(diǎn)擊保存。
領(lǐng)星ERP填寫(xiě)頁(yè)面：
釘釘?shù)钠髽I(yè)及應(yīng)用信息獲取頁(yè)面：
企業(yè)信息：點(diǎn)擊右上角的頭像，鼠標(biāo)懸浮在“CorpId”上，可復(fù)制“CorpId”
應(yīng)用信息：在"憑證與基礎(chǔ)信息"頁(yè)面和“網(wǎng)頁(yè)應(yīng)用”頁(yè)面，可復(fù)制“AgentId”、“Client ID(AppKey)”、“ClientSecret(AppSecret)”。
（2）用戶匹配：將企業(yè)下領(lǐng)星的用戶和釘釘?shù)挠脩絷P(guān)聯(lián)起來(lái)
在領(lǐng)星ERP“用戶管理-授權(quán)釘釘”進(jìn)行用戶匹配。選擇釘釘用戶進(jìn)行匹配。
3.第三步：消息設(shè)置開(kāi)啟“釘釘”消息通知類型
需在釘釘接收消息的用戶，都要自行在消息中心-消息設(shè)置中打開(kāi)消息推送，消息中心設(shè)置僅對(duì)該用戶賬號(hào)生效。
在領(lǐng)星ERP的“消息中心-消息設(shè)置”頁(yè)面開(kāi)啟需要在釘釘接收的消息類型
至此，釘釘授權(quán)完成，可以在釘釘上接收領(lǐng)星ERP的消息。
4.在釘釘接收領(lǐng)星消息
（1）接收消息
企業(yè)授權(quán)、用戶匹配、消息設(shè)置完成后，后續(xù)領(lǐng)星的新消息就會(huì)同步到釘釘
（2）審批單據(jù)
如果單據(jù)需要審批，會(huì)在消息下方有“查看詳情”按鈕，點(diǎn)擊“查看詳情”，可查看完整的單據(jù)信息并進(jìn)行審批操作
5.日常：修改用戶的釘釘賬號(hào)
在領(lǐng)星ERP-用戶管理頁(yè)面，點(diǎn)擊“編輯“用戶信息，然后修改該用戶的“授權(quán)釘釘”信息
三、常見(jiàn)問(wèn)題
Q1:獲取釘釘企業(yè)agentId列表失敗?
A1:需排查以下情況：
檢查是否有對(duì)應(yīng)接口的調(diào)用權(quán)限。
解決辦法：核對(duì)接口權(quán)限數(shù)據(jù)，申請(qǐng)開(kāi)通截圖中紅色標(biāo)記的所有接口權(quán)限。參考上文的【第一步：創(chuàng)建釘釘內(nèi)部應(yīng)用 - 步驟4】
檢查訪問(wèn)ip是否在白名單之中。
解決辦法：您可以聯(lián)系對(duì)接的實(shí)施顧問(wèn)獲取出口IP，填寫(xiě)至釘釘自建應(yīng)用中。參考上文的【第一步：創(chuàng)建釘釘內(nèi)部應(yīng)用 - 步驟3】
Q2:獲取釘釘企業(yè)accessToken失??？
A2:報(bào)錯(cuò)原因：無(wú)效的clientId和clientSecret
解決辦法：核對(duì)釘釘應(yīng)用的clientId和clientSecret，更新ERP【業(yè)務(wù)配置】頁(yè)面的釘釘配置信息。參考上文的【第二步：企業(yè)授權(quán)】
Q3:獲取釘釘企業(yè)所有部門信息失敗/用戶管理頁(yè)面無(wú)法加載釘釘用戶？
A3:報(bào)錯(cuò)原因：請(qǐng)求的部門id不在授權(quán)范圍內(nèi)。
解決辦法：釘釘應(yīng)用的權(quán)限管理設(shè)置為【全部員工】，參考上文的【第一步：創(chuàng)建釘釘內(nèi)部應(yīng)用 - 步驟4】
未能解決你的問(wèn)題？請(qǐng)聯(lián)系在線客服