beetlehr_sdk

Description:

beetlehr sdk

The BeetleHR SDK Flutter

The BeetleHR SDK Flutter is a powerful software development kit that allows developers to integrate BeetleHR functionality into their Flutter applications. BeetleHR is a human resources management platform that provides various features related to employee management, such as attendance tracking, leave management, and employee performance evaluation. This documentation will guide you through the process of integrating and utilizing the BeetleHR SDK in your Flutter projects.
Features #
Here are all the features available on our sdk, take advantage and make your development easier with us.
Server

✅ feature to retrieve server status from an endpoint


Authentication Employee

✅ login with email and password
✅ reset password with email


Profile Employee

✅ get profile employee
✅ update profile


Attendance Employee

✅ get attendence overview
✅ upload attendence image
✅ get attendence logs
✅ check branch office
✅ get attendance detail
✅ check accept clock
✅ clock attendence
✅ get schedule
✅ check accept clock attendance
✅ get schedule log
✅ get clock button type
✅ sync attendance
✅ upload attendance image
✅ cancel attendance
✅ break time
✅ check breaktime setting


Notice Employee

✅ Retrieves the notice board data
✅ Retrieves all approval requests based on the specified parameters
✅ Retrieves the approval request detail
✅ Approves a request with the provided [body] and [id]
✅ Rejects a request and returns the response
✅ Retrieves notification data and returns the response
✅ Retrieves the details of a notification based on its [id]
✅ Retrieves employee data based on name filtering parameters


Payroll Employee

✅ Retrieves a list of payrolls
✅ Retrieves the details of a payroll
✅ Retrieves a list of THR (holiday allowance) payrolls
✅ Retrieves the details of a THR (holiday allowance) payroll


Beetlehr SDK Versions #
Note: Updated to new sdk with new features.
Documentation #
Get Started #
Add dependency
You can add beetlehr_sdk in your pubspec.yaml or use the command to add beetlerhr_sdk as a dependency with the latest stable version:
flutter pub add beetlehr_sdk
copied to clipboard
If you want to use it directly from github you can add it in pubspec.yaml as follows:
dependencies:
flutter:
sdk: flutter

beetlehr_sdk:
git:
url: https://github.com/kodingworks/beetlehr_sdk.git
ref: master # branch name
copied to clipboard
Initialisasi Client #
Before using the function on the sdk, make sure you initialize the client. You can use Dependency Injection (DI) like get_it. so you don't have to always initialize your Client. here's an example of initialization that you can try:
BeetleHRClient client = BeetleHRClient(
'https://demo.beetlehr.com/api/v1',
isLog: true,
);
copied to clipboard
Usage Simple #
Here is an example of using login authentication with email and password, you don't need to save the token because this package already helps save it. but we still return the token from the login result so you can use it for other purposes. here's an example:
void login() async {
try {
final client = BeetleHRClient(
'https://demo.beetlehr.com/api/v1',
isLog: true,
);

final result = await client.loginWithEmail(
email: '[email protected]',
password: 'password',
);

print(result.meta); // return MetaData
print(result.token); // return String
print(result.user); // return UserModel
} catch (e) {
print('Something wrong!');
}
}
copied to clipboard
Error Handling #



Name
Item




Exception
ServerException



GeneralServerException



TimeOutServerException



NotFoundServerException



UnAuthenticationServerException



UnAuthorizeServerException



InternalServerException


Failure
CodeFailure



ServerFailure



Community & Group Discussion #
You could join us at Telegram Group https://t.me/+Fbaf_eCVHEg4NTY1
Contributing #
We are very glad if you want to contribute and join our community.
Please take note when you make a pull request. You must be very clear when making a commit message.
When you contribute code, the best thing to do is imitate the existing pattern BeetleHR code.
License #
Beetlehr SDK is released under the MIT license.