245.15

v 10.0 v 11.0 v 12.0 Third Party 61
Live Preview
Required Apps Employees (hr)
Included Dependencies
Safe Confirm Button (56 lines of code)
TVTMA Base (292 lines of code)
Lines of code 4286
Technical Name to_attendance_device
LicenseOPL-1
Websitehttps://www.tvtmarine.com
Also available in version v 13.0 v 11.0 v 10.0
You bought this module and need support? Click here!
Required Apps Employees (hr)
Included Dependencies
Safe Confirm Button (56 lines of code)
TVTMA Base (292 lines of code)
Lines of code 4286
Technical Name to_attendance_device
LicenseOPL-1
Websitehttps://www.tvtmarine.com
Also available in version v 13.0 v 11.0 v 10.0

Key Features

  • Support both UDP and TCP for large attendance data (tested with a real machine that store more than 90 thousand attendance records)

  • Support connection with either domain name or IP

  • Authenticate devices with password.

  • Multiple Devices for multiple locations

  • Multiple device time zones at multiple locations

  • Multiple Attendance Status support (e.g. Check-in, Check-out, Start Overtime, End Overtime, etc)

  • Store fingerprint templates in employee profiles to quickly set up new device (Added since version 1.1.0)

  • Delete Device's Users from Odoo

  • Upload new users into the devices from Odoo's Employee database

  • Auto Map Device Users with Odoo employee base on Badge ID mapping, or name search mapping if no Badge ID match found

  • Store Device Attendance data permanently

  • Manual/Automatic download attendance data from all your devices into Odoo (using scheduled actions)

  • Manual/Automatic synchronize device attendance data with HR Attendance so that you can access them in your salary rules for payslip computation

  • Automatically Clear Attendance Data from the Device periodically, which is configurable.

  • Designed to work with all attendance devices that based on ZKTeco platform.

    • Fully TESTED with the following devices:
      • RONALD JACK B3-C
      • ZKTeco K50
      • ZKTeco MA300
      • ZKTeco U580
      • ZKTeco T4C
      • ZKTeco G3
      • RONALD JACK iClock260
    • Reported by clients that the module has worked great with the following devices
      • ZKTeco K40
      • ZKTeco U580
      • iFace402/ID
      • ZKTeco MB20
      • ZKteco IN0A-1
      • Uface 800
      • ... (please advise us your devices. Tks!)

Credit

Tons of thanks to fananimi for his pyzk library @ https://github.com/fananimi/pyzk

We got inspired from that and customize it for more features (device information, Python 3 support, TCP/IP support, etc) then we integrated into Odoo by this great Attendance Device application

Editions Supported

  1. Community Edition
  2. Enterprise Edition

Installation

  1. Navigate to Apps
  2. Find with keyword 'to_attendance_device'
  3. Install it as usual then you are done

Concepts

  1. Device Location: is a model to store locations where your attendance devices are installed. Each location consists of the following information

    • Name: the name of the location.
    • Time zone: the time zone of the location. This is to support for attendance logs at multiple locations of different time zones
  2. Attendance State: is a model to store states of attendance activity that can be defined by users. States could be Check in, Check out, Overtime Check in, Overtime Start, etc. Please navigate to Attendance > Configuration > Attendance Status to see the list of default states that were created during installation of this application.

  3. Attendance Activity: is a model that classifies attendances in activities such as Normal Working, Overtime, etc. Navigate to Attendance > Configuration > Attendance Activity to see the list of default activities that were created during installation of this application. Each Attendance Activity is defined with the following

    • Name: the unique name of the activity
    • Attendance Status: List of the attendance states that are applied to this Activity.
  4. Device User is a model that stores all the devices' users in your Odoo instance and map such the users with Employees in the Odoo instance. Each Device User consists of (but not limited to) the following information

    • Name: The name of the user stored in the device
    • Attendance Device: The device to which this user belong
    • UID: The ID (technical field) of the user in the device storage, which is usually invisible at the device's inteface/screen
    • ID Number: The ID Number of the user/employee in the device storage. It is also known as "User ID" in some devices
    • Employee: the employee that is mapped with this user. If you have multiple device, each employee may map with multiple corresponding device users
  5. User Attendance: is a model that stores all the attendance records downloaded from all the devices. In other words, it a central database of attendance logs for all your devices. This log will be used as the based to create HR Attendance. During that creation, Odoo will also check for a validity of the attendance to ensure that the HR Attendance data is clean and valid.

  6. HR Attendance: is a model offered by the Odoo's standard module hr_attendance and is extended to have the following fields

    • Check In: the time of check in
    • Check Out: the time of check out
    • Employee: the related employee
    • Checkin Device: the attendance device that logged the check in
    • Checkout Device: the attendance device that logged the check out

    HR Attendance records is created automatically and periodically by the Scheduled Action named "Synchronize attendances scheduler"

  7. Employee: is a model in Odoo that is extended for additional following information

    • Unmapped Devices: to show the list of attendance devices that have not get this employee mapped
    • Created from Device: to indicate if the employee profile was created from device (i.g. Download users -> auto create employee -> au map them).

    This will helps you filter your employees to see ones that were or were not created from devices

  8. Attendance Device: is a model that store all the information of an attendance device. It also provides a lot of tools such as

    • Upload Users: to upload all your employee to an attendance device (e.g an new and fresh device)
    • Download Users: to download all the device's users data into odoo and map those users with employees (if auto mapping is set)
    • Map Employee: to map device users with employees in your Odoo instance
    • Check connection: to check if your Odoo instance could connect to the device
    • Get Device Info: to get the most important information about the device (e.g. OEM Vendor, Device Name, Serial Number, Firmware Version, etc)
    • Download Attendance: to download manually all the attendance data from the device into your Odoo database, although this could be done automatically be the scheduled action named "Download attendances scheduler"
    • Restart: to restart the device
    • Clear Data: this is to empty your data. It is very DANGEROUS function and is visible to and accessible by the HR Attendance Manager only
    • And many more...

Setup a new attendance device

  1. Navigate to Attendances > Attendance Devices > Devices Manager

  2. Click Create button to open device form view

  3. Input the name of the device (optional)

  4. Enter the IP of the device. It must be accessible from your Odoo server. If your Odoo instance is on the Internet while the device is in your office, behind a router, please insure that port forwarding is enabled and the device's network configuration is properly set to allow accessing your device from outside via Internet. You may need to refer to your router manufacturers for documentation on how to do NAT / port forwarding

  5. Port: the port of the device. It is usually 4370

  6. Protocol: which is either UDP or TCP. Most the modern devices nowadays support both. TCP is more reliable but may not be supported by a behind-a-decade device

  7. Location: the location where the device is physically installed. It is important that the time zone of the location should be correct.

  8. You may want to see other options (e.g. Map Employee Before Download, Time zone, Create Employees During Mapping, etc)

  9. Hit Save button to create a new device in your Odoo.

  10. Hit Check Connection to test if the connection works. If it did not work, please trouble shout for the following cases

    • Check network setting inside the physical device: IP, Gateway, Port, Net Mask
    • Check your firewall / router to see if it blocks connection from your Odoo instance.
    • Try on switching between UDP and TCP
  11. Map Devices Users and Employees

    • If this is a fresh device without any data stored inside:
      • Hit Upload users
    • If this is not a fresh device,
      • you may want to Clear Data before doing the step 10.1 mentioned above
      • Or, you may want to Download Users and map them to existing employee or create a new employee accordingly
    • Validate the result:
      • All Device Users should link to a corresponding employee
      • No unmapped employees shown on the device form view
  12. Test Attendance Data download and synchronization

    • Do some check-in and check out at the physical device

      • Wait for seconds between check in and check out
      • Try some wrong actions: check in a few times before check out
    • Come back to the device form view in Odoo

      • Hit Download Attendance Data and wait for its completion. For just a few attendance records, it may take only a couple of seconds even

      your device is located in a country other than the Odoo instance's

    • Validate the result

      • Navigating to Attendances > Attendance Devices > Attendance Data to validate if the attendance log is recorded there.
      • If found, you are done now. You can continue with the following steps to bring the new device into production
        • Clear the sample attendance data you have created:
          • Navigate to Attendances > Attendance Devices > Attendance Data, find and delete those sample records
          • Navigate to Attendances > Attendance Devices > Synchronize and hit Clear Attendance Data button
        • Hit the Confirmed state in the header of the device form view. If you don't do it, the schedulers will ignore the device during their runs
      • If not found, there should be some trouble that need further investigation
        • Check the connection
        • Try to get the device information
        • Check the work codes of the device if they are match with the ones specified in the "Attendance Status Codes" table in the device form view
        • Contact the author of the "Attendance Device" application if you could not solve the problem your self.

Set up for a new Employee

  1. Create an employee as usual
  2. Hit the Action button in the header area of the employee form view to find the menu item "Upload to Attendance Machine" in the dropped down list
  3. Select the device(s) that will be used for this employee then hit Upload Employees button
  4. You can also do mass upload by selecting employees from the employee list view. Or go to the devices

How the automation works

There are two schedule actions:

  1. Download attendances scheduler: By default, it runs every 30 minutes to
    • Download the attendance log/data from all your devices that are set in Confirmed status. Devices that are not in this status will be ignored
    • Create User Attendance records in your Odoo database
    • Depending on the configuration you made on the devices, it may also do the following automatically
      • Create new employees and map with the corresponding device users if new users are found in the devices
      • Clear the attendance data from the device if it's time to do it.
  2. Synchronize attendances scheduler: By default, it runs every 30 minutes to
    • find the valid attendance in the user attendance log
    • create HR Attendance records from such the log
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.
Very happy with the product
by
fernando@ganemo.co
on 7/31/19, 6:38 PM

I tried it with my ZKteco IN0A-1 and Uface 800, and in both cases everything worked fine.

Re: Very happy with the product
by
David Tran
on 8/2/19, 9:16 AM Author

Great! Thank you for letting us know the application works with both the ZKteco IN0A-1 and the Uface 800!


Good
by
Wainaina
on 4/29/19, 4:34 AM

Does this module privide any salary rules?

Re: Good
by
David Tran
on 4/29/19, 5:15 AM Author

No, it should not. Its job is to feed HR Attendance


Dose this Module Work with Device Serial Number?
by
Mohammed
on 7/19/20, 12:14 PM

If you Can Add Customization to Support connection with Device Serial Number Please Let me Know Thanks


Device compatibility
by
Fransisca Maria
on 7/10/20, 12:43 AM

Hello Sir, Is this compatible with ZKTeco SFace900 model? Thank you.


Device compatibility
by
Linh To Nguyen
on 5/4/20, 3:28 AM

Hi! Is this application compatible with Ronald Jack X628 Pro models? Thank you!

Re: Device compatibility
by
David Tran
on 5/4/20, 4:37 AM Author

We have not tested with the Ronald Jack X628 Pro. However, you could try the model with a demo instance of ours: https://v12demo-int.erponline.vn


Is it compatible with satellite x-100 c
by
Rico Parapat
on 1/13/20, 1:22 AM Confirmed Purchase

Is it compatible with satellite x-100 c or at least this model ZKteco model 'uFace 202', ZKteco model 'iFace990'?or will you support for setting after purchase?

Re: Is it compatible with satellite x-100 c
by
David Tran
on 1/13/20, 2:27 AM Author

As the 'uFace 202' is a zkteco based device, I believe it will work with our module. I couldn't find any information about the satellite x-100. You could try it with our demo instance to if if they could work with our module. Anyway, these devices are not in our tested device. We will try our best to support you but no guarantee. Please do test before buying.


Samples of Reports available
by
Alejandro Ruva
on 10/31/19, 10:54 AM Confirmed Purchase

Can you send available ready to use reports samples?..

Re: Samples of Reports available
by
David Tran
on 11/13/19, 2:23 AM Author

This page does not allow attachment. Please try the demo instance (the Live Preview button on this page)


SKD Integration Re Post
by
Stivens Bermudez
on 10/23/19, 9:43 AM

The SDK Biometric maker is Nitgen. These devices are used in our company for fingerprint attendace.

Re: SKD Integration Re Post
by
David Tran
on 11/14/19, 11:59 PM Author

I don't know this device. However, you could try it with our demo instance to see if it works.


SDK Integration
by
Stivens Bermudez
on 10/22/19, 10:33 AM

Please let me know if this app can be integrated with SDK Biometric Scanner.

Re: SDK Integration
by
David Tran
on 10/22/19, 6:48 PM Author

I am not sure what you mean about SDK Biometric Scanner. What make is that device?


odoo 13
by
Hongna
on 10/7/19, 7:53 AM

when it available for odoo 13?

Re: odoo 13
by
David Tran
on 11/13/19, 2:22 AM Author

It is now available for Odoo 13


odoo 13
by
Hongna
on 10/7/19, 7:53 AM

When it ready for odoo 13

Re: odoo 13
by
David Tran
on 10/22/19, 6:50 PM Author

It is expected to be released by the end of November 2019.


Please share you Skype ID
by
Akram Malik
on 9/27/19, 7:26 AM Confirmed Purchase

Need your assistance to setup the module, please share your Skype ID.

Re: Please share you Skype ID
by
David Tran
on 9/27/19, 8:23 AM Author

Please use support button on this page to avoid spaming other users.


How to Map the Device User IDs with Existing Employees in Odoo
by
Akram Malik
on 9/26/19, 9:18 AM

Hi, We have Old Employees in Odoo, and we have Users in the Device, we now want to Map the Device User IDs to the Employees in Odoo before downloading the Attendances, could you please tell me how can we do that?

Re: How to Map the Device User IDs with Existing Employees in Odoo
by
David Tran
on 9/26/19, 9:03 PM Author

1. There is a function to map device users with employees. The mapping mechanism is by: user id employee barcode or user name employee name 2. There is also a switch that allows Odoo to generate employees from device users in case there remains unmapped users.


Compatibility?
by
Diogo Ruivo
on 9/24/19, 10:51 AM

Hi! Is this application compatible with MA500 or uFace402 models? Thanks!

Re: Compatibility?
by
David Tran
on 9/26/19, 8:59 PM Author

Not tested with those ones yet but it should be compatible with those. Please test the module with the demo instance first.


Works well with essl uface 302, but unable to upload users!
by
ovidsk@gmail.com
on 9/18/19, 6:39 AM Confirmed Purchase

While uploading users from odoo, it throws the following error. "Could not get max uid from the device [ROW] [ x 2008] /Sample If you had connected to your device, perhaps your device had problem. Here is the debugging error message: 'ZK' object has no attribute 'get_max_uid' . " Any help on this would be appreciated!

Re: Works well with essl uface 302, but unable to upload users!
by
David Tran
on 9/18/19, 7:37 AM Author

It seems that you are using an old version. Please download the latest one. Please note that we are always available at support (at) ma.tvtmarine.com.


Cannot recommend this software
by
stefan@hicell.co.za
on 9/11/19, 7:48 AM Confirmed Purchase

I received no help from the developer and they basically tried to blackmail me into increasing the rating I gave them before they would help solve some issues with their development. Since I cannot change my rating, only admins can I was given a lot of flack about this and eventually had to resort to getting my refund from Odoo itself as the developers stopped responding. The irony is I did not even want a refund in the beginning, I just wanted to use the software properly.

Re: Cannot recommend this software
by
David Tran
on 9/12/19, 5:59 AM Author

We refuse to serve you and refunded you since you raised the war even before the first communication. Again, we are not be able to serve you.


by
David Tran
on 9/9/19, 6:40 AM Author

It should since this is also a zkteco based hardware. Anyway, you should carry out a test with the demo instance before buying. Don't forget to do NAT / Port forwarding to make your device visible from the Internet for the demo instance to connect.


ESSL UFACE 302
by
ovidsk@gmail.com
on 9/9/19, 5:29 AM Confirmed Purchase

Does this work with Essl Uface 302 or anyother essl devices?

Re: ESSL UFACE 302
by
David Tran
on 9/9/19, 6:40 AM Author

It should since this is also a zkteco based hardware. Anyway, you should carry out a test with the demo instance before buying. Don't forget to do NAT / Port forwarding to make your device visible from the Internet for the demo instance to connect.


MB10 works
by
Zaryan Ali
on 9/7/19, 3:02 PM

Thanks the connection works. But it only displays information

Re: MB10 works
by
David Tran
on 9/7/19, 8:57 PM Author

Great! You may need to hit other functional buttons to start downloading attendance data.


Can we test before buy
by
Zaryan Ali
on 9/7/19, 11:04 AM

I have Zkteco MB10 and I would like to test before i can purchase this module. Can we do that or do you've a demo module ? Thanks

Re: Can we test before buy
by
David Tran
on 9/7/19, 12:16 PM Author

You can test it with the demo instance: https://v12demo-int.erponline.vn Please ensure you setup your routers with proper NAT / Port Forwarding so that your Zkteco MB10 will be visible from the Internet for the demo instance to connect.


by
Dhanang Nurkusuma
on 9/3/19, 9:53 PM

Is it work with ZKCO FP100TA?

Re:
by
David Tran
on 9/3/19, 10:24 PM Author

It should. You can test it with the demo instance: https://v12demo-int.erponline.vn Please ensure you setup your routers with proper NAT / Port Forwarding so that your FP100TA will be visible from the Internet.


is this integrated with tools that I showed
by
Taner
on 8/26/19, 8:43 AM

http://www.perkotek.com/magic-pass-20657-mf-cift-parmak-izi-okuma-sistemi/

Re: is this integrated with tools that I showed
by
David Tran
on 9/2/19, 1:12 AM Author

I don't know if this one is a zkteco based device. If it is, the module should work. BTW, you can always test the device using a demo instance of ours. Please hit the button Live Preview on this page to see the demo instance.


by
Sayed
on 8/19/19, 4:58 AM

When I go to checkout, it automatically adds another module to buy which is TVTMA Base. Is it mandatory to purchase them both in order to run the Biometric Attendance Device module only?

Re:
by
David Tran
on 8/19/19, 5:27 AM Author

Yes, you will need all the dependencies. Otherwise, it will not work.


by
Sayed
on 8/17/19, 4:40 AM

If I have multiple systems that I intend to use the module on, should I buy a license for each system or I can use one license for all of them?

Re:
by
David Tran
on 8/17/19, 7:29 AM Author

you can use one license for all the system you own.


by
CR&D
on 8/14/19, 10:11 AM

Hi! Is it working with ZKTeco IN05 & IN05-A?

Re:
by
David Tran
on 8/14/19, 11:45 AM Author

It should be. It is designed to work with all ZKTeco based attendance devices


by
Sayed
on 8/14/19, 6:55 AM

Hi, is it working on UA300 device?

Re:
by
David Tran
on 8/14/19, 7:43 AM Author

It should be.


by
Samuel
on 7/25/19, 11:49 AM

Hi, I need to know if this module can read from the ZKTeco MB300 model. Thank you

Re:
by
David Tran
on 7/25/19, 7:11 PM Author

The module is designed to work with all Zkteco based attendance device.


by
J.deep
on 7/24/19, 3:19 AM

Thanks you very much. I was connected with my device successful.But i don't know how config password required for my device, where i can find to set password ? Thank you.

Re:
by
David Tran
on 7/24/19, 4:18 AM Author

Some devices have password function, some others do not. Please refer to your device documentation.


by
J.deep
on 7/23/19, 4:27 AM

Are you have details document to connect biometric device with server? I still can not download data from my device to odoo on web.Thanks you!!!

Re:
by
David Tran
on 7/23/19, 5:14 AM Author

No, it is not that "connect device to Odoo". Devices must be visible to Odoo. And you need to do that at your network first. You need to know how to do NAT / Port forwarding. You may need to refer to the documentation from the network router's maker.


by
J.deep
on 7/23/19, 1:22 AM

Why I can not connect with my biometric, how can i config server to connect to my device

Re:
by
David Tran
on 7/23/19, 3:11 AM Author

You may need to do NAT / Port forwarding with you network router so that the device can be reached by your Odoo instance if the instance is on the Internet.


Module to match time off and attandance and meeting ?
by
thanh nguyen
on 7/5/19, 5:01 AM

Hi David Tran, I wonder do you have any module to match with leaves, meetings, and attendance to calculate workday for the employee ?

Re: Module to match time off and attandance and meeting ?
by
David Tran
on 7/5/19, 6:57 AM Author

This module can only synchronize with Odoo attendance only. More work (on separated modules) would be required for matching leaves and meetings. Fortunately no more hardware integration work would be required.


Worked with Zkteco MB20
by
thanh nguyen
on 7/5/19, 4:58 AM

Hi David Tran, Your module worked with Zkteco MB20. I am trying with some another device. Many thanks

Re: Worked with Zkteco MB20
by
David Tran
on 7/5/19, 6:53 AM Author

Thank you for let us know that it works with ZKTeco MB20.


Not yet
by
semajimaj@gmail.com
on 6/7/19, 4:31 AM

Still waiting on a demo I gave you my sky.pe but no reply


There is no bulk device management option
by
stefan@hicell.co.za
on 6/6/19, 7:33 AM Confirmed Purchase

This is a great interface system, but the fact that there is no bulk management option make it difficult when running multiple sites

Re: There is no bulk device management option
by
David Tran
on 6/6/19, 9:11 AM Author

What do you mean that "bulk management option"? If you mean the following, I can say Yes, they are available: 1. One-click upload/download users (including employee mapping option) to/from multiple devices. 2. One-click attendance data synchronization with multiple devices 3. Automatic data synchronization Please advise...


is it compatible with?
by
Jose
on 5/24/19, 5:35 PM Confirmed Purchase

we have different model IN01-A U560-C k-20 zkteko is it work in the same database? some of the device works in other database or the same we are really interesting

Re: is it compatible with?
by
David Tran
on 5/30/19, 7:31 PM Author

With this, multiple devices in the same database is supported.


we are interested in a demo
by
katherine.rinze@solucionesabacus.com
on 5/9/19, 12:46 PM

we have the model ZKTeco K40, is it compatible with this app?

Re: we are interested in a demo
by
David Tran
on 5/9/19, 6:07 PM Author

Not tested with that device but I believe it will work since the device is also based on ZKTeco platform.


demo please.. on zkteco uface 402
by
semajimaj@gmail.com
on 4/12/19, 8:51 PM

i want to buy this i just want to see it work on a demo with my biometric scanner can you do that today.. call me here majimaj1 < sky i need this today

Re: demo please.. on zkteco uface 402
by
David Tran
on 6/6/19, 9:17 AM Author

I missed this message from you. Did you get a demo session from our team?


by
David Tran
on 1/29/19, 11:32 PM Author

This module is compatible with both odoo community edition and odoo enterprise edition.


Can I install the module in my ODOO 11 Enterprise Edition?
by
Oleh Mirianov
on 1/25/19, 7:38 AM

Can I install the module in my ODOO 11 Enterprise Edition? If yes, do I need a module ODOO sh ?

Re: Can I install the module in my ODOO 11 Enterprise Edition?
by
David Tran
on 6/6/19, 9:15 AM Author

Yes, you can. It does support both Odoo EE and CE