HR खुले API से दूसरी प्रणालियाँ जोड़ें

HR खुला API आपकी बनाई कुंजी से दूसरी प्रणाली को लोग, उपस्थिति, छुट्टी और अंतिम पेरोल पढ़ने तथा पंच भेजने देता है। HR वेबहुक घटनाओं पर उसे बताते हैं।

शुरू करने से पहले

• मालिक होना चाहिए। सभी HR अनुमतियों के बाद भी प्रबंधक कुंजी नहीं बना सकते।
• HR चालू हो।

कुंजी बनाएँ

1. HR → HR सेटिंग्स के स्वयं सेवा और टीम में HR खुला API चुनें।
2. खुला API चालू है चुनकर सहेजें चुनें। पृष्ठ आधार पता दिखाता है।
3. कुंजी बनाएँ में किसलिए लिखें (जैसे "पेरोल सेवा")।
4. अनुमति में केवल आवश्यक चुनें: लोग पढ़ें, उपस्थिति पढ़ें, पंच भेजें, छुट्टी पढ़ें, अंतिम पेरोल पढ़ें, वेबहुक प्रबंधित करें।
5. कुंजी बनाएँ चुनें।
6. अभी कॉपी करके दूसरी प्रणाली को दें। एक बार दिखती है; Kluvan केवल हैश रखता है।

वेबहुक जोड़ें

1. वेबहुक जोड़ें में अपनी प्रणाली का URL लिखें (https से शुरू होना चाहिए)।
2. घटनाएँ चुनें: employee.created, employee.left, punch.recorded, leave.approved और payroll.paid। शुरू में सभी चुनी हैं।
3. जोड़ें चुनकर एक बार दिखने वाला हस्ताक्षर सीक्रेट कॉपी करें।
4. क्या भेजा, स्थिति और प्रयास देखने के लिए डिलीवरी जाँचें।

उपयोगी जानकारी

• अलग कुंजियाँ। HR कुंजियों की अपनी व्यवस्था है, दूसरी Kluvan API कुंजियों से अलग; केवल संगठन के HR डेटा तक पहुँचती हैं।
• कुंजी बैंक विवरण, दस्तावेज़ या बायोमेट्रिक डेटा कभी नहीं पढ़ती। अंतिम पेरोल पढ़ें केवल चुकाए रन देता है, ड्राफ़्ट कभी नहीं; IBAN या खाता नंबर नहीं।
• तुरंत रोकने के लिए रद्द करें चुनें। सूची अंतिम इस्तेमाल और कॉल संख्या दिखाती है।
• कुंजी प्रति सेकंड 10 कॉल, थोड़े समय में 60 तक कर सकती है। माँगी अवधि अधिकतम 92 दिन।
• API पंच कुंजी के नाम को लेखक मानकर सुधार के रूप में जुड़ता है। एक बार भेजें: वही दो बार भेजने पर टाइमशीट में दो बार आता है और प्रबंधक एक हटाता है।
• वेबहुक सीक्रेट से हस्ताक्षरित हैं (X-Hr-Signature हेडर में HMAC-SHA256)। विफल डिलीवरी लगभग एक दिन फिर कोशिश करती है; लगातार 20 विफलता पर वेबहुक दोबारा चालू करने तक बंद होता है।
• लाइव एंडपॉइंट पर अभी नहीं आज़माया: डिलीवरी केवल अपने परीक्षण सेटअप में जाँची है। निर्भर होने से पहले अपनी प्रणाली में परीक्षण करें।
• कुंजी बनाना, रद्द करना और हर भेजा पंच गतिविधि लॉग में दर्ज हैं।
• डेवलपर के लिए पृष्ठ पर तकनीकी संदर्भ है: इसे कॉल करने का तरीका पढ़ें।