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 বা অ্যাকাউন্ট নম্বর নেই।
• সঙ্গে সঙ্গে থামাতে প্রত্যাহার বাছুন। তালিকায় শেষ ব্যবহার ও কলের সংখ্যা থাকে।
• কী সেকেন্ডে ১০ কল, অল্প সময়ের চাপে ৬০ পর্যন্ত পারে। চাওয়া সময়কাল সর্বোচ্চ ৯২ দিন।
• API পাঞ্চ কী-এর নামকে লেখক ধরে সংশোধন হিসেবে যোগ হয়। একবার পাঠান: দুবার পাঠালে টাইমশিটে দুবার আসে, ব্যবস্থাপক একটি সরান।
• ওয়েবহুক গোপন মানে স্বাক্ষরিত (X-Hr-Signature হেডারে HMAC-SHA256)। ব্যর্থ ডেলিভারি প্রায় এক দিন পুনরায় চেষ্টা করে; টানা ২০ ব্যর্থতায় আবার চালু না করা পর্যন্ত বন্ধ হয়।
• সরাসরি এন্ডপয়েন্টে এখনো পরীক্ষা নয়: শুধু নিজস্ব পরীক্ষার ব্যবস্থায় ডেলিভারি পরীক্ষা হয়েছে। নির্ভর করার আগে নিজের ব্যবস্থায় পরীক্ষা করুন।
• কী তৈরি, প্রত্যাহার ও প্রতিটি পাঠানো পাঞ্চ কার্যকলাপ লগে থাকে।
• ডেভেলপারের প্রযুক্তিগত নির্দেশিকার লিঙ্ক পৃষ্ঠায়: কীভাবে কল করবেন পড়ুন।