Employee Check-in
Introduction
Employee Check-in is a feature introduced by ERPGulf in ERPNext that integrates with BioTime devices for recording employees’ punch-in and punch-out. The system uses a single document type for both IN and OUT logs, making attendance tracking simple and automated.
Pre-requisites
- HRMS Module must be installed in ERPNext.
- Access to BioTime
- A valid BioTime URL and Token (unique for each company).
Getting BioTime URL & Token
To connect ERPNext with BioTime, you need a URL and an Auth Token.
Steps to Get Token
- Open Browser
- Enter: http://
: /api/docs/#/jwt-api-token-auth - serverIP → BioTime server/computer IP (e.g., 192.168.218.8)
- serverPort → Server port (default: 8090)
- Enter Credentials
- Username: BioTime system username
- Password: BioTime system password
- Click “Try it out” (in API docs) or use Postman to send request:
- Copy Token
- The system will return a token like this:
- { "token": "a9e60c0af10aeed83af39365b3a96c174752b7" }
Example: http://192.168.218.8:8090/api/docs/#/jwt-api-token-auth
{
"username": "admin",
"password": "admin"
}
Configure BioTime in ERPNext
In ERPNext:
- Go to BioTime Settings.
- Enter:
- BioTime URL (your server URL)
- BioTime Token (the one generated above)
- Save settings.
Employee Check-in Usage
When employees punch in/out on BioTime devices, ERPNext will record logs automatically.
Each Check-in record includes:
- Employee ID & Name
- Log Type → IN / OUT
- Time → Exact punch time (based on timezone)
- Device ID → Captured from BioTime
- Skip Auto Attendance → Option to exclude entry from attendance
⚠️ If the check-in is outside shift hours, you’ll see a warning. Adjust the shift timing and click Fetch Shift if needed.
Benefits
- Real-time sync with BioTime
- Eliminates manual entry of attendance
- Single DocType for IN/OUT logs
- Works with Auto Attendance in ERPNext