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.
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
Note: Updated to new sdk with new features.
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
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
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,
);
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@email.com',
password: 'password',
);
print(result.meta); // return MetaData
print(result.token); // return String
print(result.user); // return UserModel
} catch (e) {
print('Something wrong!');
}
}
Name | Item |
---|---|
Exception | ServerException |
GeneralServerException | |
TimeOutServerException | |
NotFoundServerException | |
UnAuthenticationServerException | |
UnAuthorizeServerException | |
InternalServerException | |
Failure | CodeFailure |
ServerFailure |
You could join us at Telegram Group https://t.me/+Fbaf_eCVHEg4NTY1
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.
Beetlehr SDK is released under the MIT license.