Biometric attendance machine integration with Odoo
Odoo Attendances records check-ins and check-outs from many sources. Here are the three ways punches from your attendance machines reach Odoo, and which one fits your Odoo version.
Odoo
Where the punches have to go
Odoo is an open-source business suite used by companies of every size, with Attendances as its time-recording app. Many Odoo users still bring machine punches in through a script on a local PC or a manual import. The routes below need neither.
An integration removes the file in the middle: every punch travels from the terminal to the Cams cloud and on to Odoo by itself, from every site, whatever the terminal brand.
What reaches Odoo
Shift by shift
On the two native routes, Cams keeps each check-in and, when the check-out arrives, records the whole shift in Odoo as one attendance with both times. A check-out counts while it falls within the shift boundary (17 hours unless you set another), so night shifts that cross midnight stay in one piece.
- Employee (by Badge ID)
- Check-in time
- Check-out time
Choose your route
Ways into Odoo
| Route | How it works | On camsbiometrics.com |
|---|---|---|
| Odoo 19 and later | Odoo's own API, no module to install. On Odoo Online this needs the Custom plan, which allows external API access. | Details |
| Odoo 15 to 18 (on-premise or Odoo.sh) | Odoo's own older API, no module. Odoo removes this API in Odoo 22, so switch to the newer route when you upgrade. | Details |
| Other versions, or rules inside Odoo | The Cams module for Odoo receives punches in the Cams 3.0 format and applies your time adjustment and attendance strategy. | Details |
Setup
How to connect Odoo
Connect the terminals to the Cams cloud
Cams terminals connect out of the box. For terminals you already own, check the model for free at developer.camsbiometrics.com: supported models connect directly over the internet, older ones as a Cams Open Terminal.
Line up the employee IDs
Odoo finds each employee by the Badge ID on the employee record: set it to the user ID on the terminal.
Add Odoo in the Cams console
Open Configurations, then Connectors, add Odoo and enter what it asks for (list on the right). Choose which terminals send to it.
Shifts flow
From then on each shift reaches Odoo as soon as its check-out is recorded. Failed deliveries are retried and listed in the console, so problems are visible instead of silent.
What you need
- Your Odoo address and database name
- An API key (and, for Odoo 15 to 18, the login it belongs to)
- A shift boundary, if 17 hours does not suit you (optional)
- For the module route instead: your Odoo domain and the module's authentication token and security key
Good to know
- Pick the route by version: 19 and later, 15 to 18, or the module for anything else.
- Credentials are stored encrypted in the Cams console.
Hardware
Which attendance machines work with Odoo
Every Cams terminal, and terminals from ZKTeco, eSSL, Hikvision, Suprema, Anviz and many of the 90+ other brands that connect to the Cams cloud. Fingerprint, face, palm and card punches all reach Odoo in the same form, so you can mix technologies and brands across sites.
Choosing new terminals? Start with the types of attendance machine. Keeping the ones you have? See connecting existing machines to the cloud.
Set it up with Cams
The Odoo integration is one of 70+ ready-made integrations on the Cams Biometric Gateway. The page on camsbiometrics.com lists every field, the licence that applies and the price.
FAQ
Odoo attendance integration: questions
Do I need to install a module in Odoo?
Not for Odoo 15 and later: the native routes use Odoo's own API. The Cams module is for other versions, or when you want the module's attendance rules inside Odoo.
Does it work with Odoo Online?
Yes, for Odoo 19 and later on the Custom plan, which allows external API access.
What about night shifts that cross midnight?
Cams pairs a check-in with the next check-out inside the shift boundary (17 hours by default), so a 22:00 to 06:00 shift becomes one attendance on the day it started.
Can I use the machines I already have?
In most cases, yes. Check the model for free at developer.camsbiometrics.com. Supported models connect straight to the Cams cloud; older or LAN-only models connect through the Hybrid Connector, a small program on a PC on site. Either way the Odoo integration takes the punches from there. See keeping the machines you have.
What does it cost?
Each terminal needs a Cams API licence: a one-time activation plus a yearly fee, with no per-employee or per-punch charge. Some integrations are included with that licence and some are paid; the Odoo page on camsbiometrics.com shows which applies and the price.
Other software