| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Expenses (hr_expense) • Discuss (mail) • Invoicing (account) |
| Lines of code | 3085 |
| Technical Name |
cabify_connector |
| License | LGPL-3 |
| Website | https://github.com/bernardo-martinez |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Expenses (hr_expense) • Discuss (mail) • Invoicing (account) |
| Lines of code | 3085 |
| Technical Name |
cabify_connector |
| License | LGPL-3 |
| Website | https://github.com/bernardo-martinez |
| Versions | 17.0 18.0 19.0 |
Cabify Connector
Operate Cabify resources directly from Odoo
Built for Operations Teams
A complete Cabify workspace inside Odoo
- Manage Cabify Users, Sales, Journeys, Labels, and async User Update jobs from one place.
- Keep teams aligned with one-click fetch actions and automatic upsert flows.
- Gain reliability with secure webhook validation and automatic retry handling for async updates.
This is an unofficial Cabify module designed to manage all resources currently available through the Cabify public API.
1. Fast setup and secure connectivity
Configure credentials and environment in minutes
Set your Cabify Client ID, Client Secret, environment (staging/production), and user matching strategy (email or employee code) from Odoo Settings. The connector handles token lifecycle and keeps communication secure with signature-validated webhooks.
2. Complete Cabify resource management
Users, sales, journeys, and labels fully connected
Fetch and synchronize users, sales, journeys, and labels with one click. Sales can auto-link to journeys and users, and can automatically generate Odoo expenses for powerful finance and HR visibility.
User management with auto-matching and upsert logic keeps your Cabify user base in sync with Odoo employees.
3. Reliable async sync and webhook automation
Enterprise-grade resilience for user updates
Local changes can sync back to Cabify, async jobs are tracked in Odoo, webhook responses confirm outcomes, and timed-out jobs are retried automatically. Your operations team gets clear statuses, auditability, and fewer manual interventions.
Cabify Connector
Turn Cabify data into operational value inside Odoo.
This module gives your team a fast, reliable way to manage Cabify resources directly from Odoo, with built-in sync workflows, webhook handling, and HR/Expense integration that reduces manual work from day one.
Key Highlights
- One workspace for Cabify Users, Sales, Journeys, Labels, and User Update jobs.
- Powerful "Fetch From Cabify" actions in list views for fast day-to-day operations.
- Automatic sync from Odoo employee/user changes to Cabify, including async job tracking.
- Secure webhook processing with signature validation and robust event handling.
- Smart retry engine for async user updates when webhook confirmation does not arrive in time.
- Native links with HR Employee and HR Expense records for better operational visibility.
- Production/Staging environment support from settings, with managed token refresh.
Feature Breakdown
1. Cabify Users Management
- Import users from Cabify and upsert into Odoo in one click.
- Match and link imported users to employees by configurable strategy: * Email match * Employee Code match
- Manage Cabify user fields from Odoo: * Name and surname * Email * Mobile country code and number * Default charge code * Locale * Permission flags (can manage, can order for others, disabled)
- Store and display raw payloads for transparency and troubleshooting.
- Open linked employee and related sales directly from the user form.
2. Sales Synchronization and Expense Linking
- Fetch Cabify sales with a guided wizard (date range, currency, page, per page).
- Import and upsert sales with duplicate protection by unique sale code.
- Automatically create and link hr.expense records for new sales.
- Backfill missing expense links when existing sales are updated.
- Smart date-range optimization to avoid unnecessary refetching of older days.
- Open linked journey and expense from each sale record.
- With direct links to Cabify web app from sale records.
3. Journey Visibility
- Fetch and store full Cabify journey details by journey ID.
- Keep journey state, timing, location/pricing metadata, and payload traceability.
- Link journeys to Cabify users and Cabify sales for full trip context.
4. Labels Synchronization
- Fetch Cabify labels in one click.
- Upsert labels with active/inactive status handling.
- Keep label payload snapshots for audit and support workflows.
5. Bi-Directional User Sync (Odoo -> Cabify)
- On local user create/write, push changes to Cabify for supported fields.
- Automatically choose create vs update path based on remote identity presence.
- Register async job responses and surface status to users.
- Capture sync errors without blocking all operational work.
6. Async Job Monitoring and Retry Engine
- Dedicated User Updates model and menu for operational monitoring.
- Track status, attempts, retries, affected users, and webhook deadlines.
- Automatic retries when webhook confirmation times out.
- Safe failure states with explicit reasons when retries are exhausted.
8. Native HR and Expense Integration
- HR Employee smart button to open linked Cabify users.
- Automatic employee-to-Cabify user sync on relevant employee field updates.
- HR Expense smart button to open linked Cabify sales.
- Consistent relationships across Users, Sales, Journeys, Employees, and Expenses.
9. Admin-Friendly Configuration
- Central settings panel under Odoo configuration.
- Configure Cabify client credentials.
- Switch between Staging and Production environments.
- Configure user matching strategy (Email or Employee Code).
- Automatic token cache invalidation when credentials change.
Screenshot Placeholders
Replace these placeholders with your real screenshots.
Cabify Users List
Cabify User Form
Sales Fetch Wizard
Cabify Sales View
Cabify Journey Form
Cabify Labels View
User Updates Monitor
Please log in to comment on this module