Payhawk × Odoo 19 — Quick Start
This guide takes you from a fresh Odoo 19 instance to a working, two-way Payhawk integration. Follow the steps in order. The whole process takes about 20–30 minutes.
Which version?
You are reading the Odoo 19 guide (module 19.0.x). Switch versions from the Payhawk version menu in the top bar. See version differences for what changed.
Download the guide
Prefer to read offline, or working in an environment where docs.planapulse.com isn't reachable? Get the entire guide as a single PDF.
The full Payhawk × Odoo 19.0 integration guide as a single offline PDF — covers prerequisites, installation, configuration, sync, webhooks, and going live. Useful for environments where docs.planapulse.com isn't reachable.
Video walkthrough
Four short, topic-scoped demos — watch the general walkthrough first, then dive into the specifics.
1 General walkthrough 14 min
End-to-end overview of the integration.
Watch online: youtube.com/watch?v=-Vmy-1UZFQU
2 Settings passed between Payhawk and Odoo 7 min
What configuration syncs in each direction and how to set it up.
Watch online: youtube.com/watch?v=v82Rwu6oo18
3 Expenses in Payhawk 5 min
Capturing and reviewing expenses on the Payhawk side.
Watch online: youtube.com/watch?v=y_MC9O6jru4
4 How the info is transformed into Odoo 2 min
How reviewed expenses become bills, receipts, and bank statement lines.
Watch online: youtube.com/watch?v=CyIILbFXz94
Download the module
Get the latest packaged build of the connector for Odoo 19.0. Unzip into your Odoo addons path, then update the apps list and install.
The Payhawk × PLANA connector is proprietary software. We send the package to licensed customers on request — usually within one business day.
At a glance
| Step | What you do | Where |
|---|---|---|
| 1 | Check prerequisites | Odoo apps + server |
| 2 | Install the module | Odoo Apps |
| 3 | Get an API key | Payhawk portal |
| 4 | Configure the connection | Settings → Payhawk |
| 5 | Run the first sync | Settings → Payhawk |
| 6 | Enable webhooks | Odoo + Payhawk |
| 7 | Go live | Switch to Production |
How the integration works
Odoo 19 Payhawk
┌──────────────┐ ┌──────────────┐
│ Expense accts │ ──push codes──▶ │ Account codes │
│ Taxes │ ──push rates──▶ │ Tax rates │
│ Products │ ──categories──▶ │ Categories │
│ Analytics │ ──cust fields─▶ │ Custom fields │
│ Suppliers │ ◀──two-way────▶ │ Suppliers │
│ Bills/Receipts│ ◀──expenses──── │ Expenses │
│ Bank stmts │ ◀──fund accts── │ Fund accounts │
└──────────────┘ └──────────────┘
▲ │
└──────── webhooks (real-time) ─────┘
+ scheduled sync every 15 minData is pushed and pulled both by a scheduled job (every 15 minutes) and in real time via webhooks when an expense is reviewed or a supplier changes.
Start with Prerequisites →