Mapsly is a standalone software platform that exchanges data with your Odoo account through its API, while synchronization of records removal from Odoo to Mapsly is implemented via an Odoo extension installed in Odoo On-premise.
Limitations of Odoo Online
While Mapsly works with both Odoo Online and Odoo On-premise, we strongly recommend using Mapsly with Odoo On-premise because of the following limitations of Odoo Online:
Since Odoo Online does not support extensions, records removed in Odoo Online will NOT be automatically removed in Mapsly, since this sync is implemented in the Mapsly extension for Odoo. (Records removed in Odoo On-premise are automatically removed in Mapsly.)
Odoo Online API cannot be called more frequently than once per second, which significantly slows down automatic assignment of territories and mass-updates of Odoo records in Mapsly and may cause significant delays in synchronization of updates from Odoo to Mapsly while these processes are in progress. (Odoo On-premise doesn't impose limits on the use of its API.)
Signing up for a Mapsly account and connecting your Odoo
1. Set password for your Odoo Online administrator (only if using Odoo Online)
If using Odoo On-premise, skip this step.
Mapsly uses your Odoo administrator credentials in your Odoo instance to sync data. However, unlike in Odoo On-premise, in Odoo Online (<domain>.odoo.com), users are initially created without a local password; instead, you are logged in to your Odoo Online instance via the Odoo Online authentication system, not with your instance's administrator's credentials. To enable the use of API in your Odoo Online instance, set a password for your administrator user account:
Log in to your Odoo Online instance as an administrator
Go to Configuration ‣ Settings ‣ General settings ‣ Users ‣ Users
Click on the user you want to use for API access
Click the Change Password button
Set a New Password value then click Change Password.
2. Follow Mapsly sign-up guide
To create your Mapsly account and connect it to your Odoo CRM, following this Mapsly sign-up wizard.
Please note that on step #3 "Access to data" you'll be prompted to enter your Odoo administrator's login and password, as well as your full Odoo server URL (Odoo web application URL) including "https://" (like https://dev2mapsly.odoo.com), as well as your Odoo database name:
Installing and configuring the extension
To install Mapsly extension in your Odoo instance simply follow the steps:
Download Mapsly extension and conector and add them to your /addons folder:
Go to Apps, search and install Mapsly extension
After installing extension you will need to create
mapsly.api_key. To generate that key, inside Mapsly go to Setup > Odoo > General properties:
and click Generate button:
In your Odoo settings activate the developer mode
Go to Settings > Technical > System parameters:
mapsly.api_keyparameter and save the previously generated API key here:
web.base.urlparameter exactly matches the "Odoo server URL" you set while creating a mapsly data source.
If it doesn't match, edit the parameter value.
web.base.url.freezeparameter with value
Configuration is complete and you can now open Mapsly inside your Odoo instance:
How to log into Mapsly
To log into Mapsly, go to app.mapsly.com and enter your Mapsly login and password into the Mapsly login form.
How to add Odoo CRM as a data source to an existing Mapsly account
If you already have an a Mapsly account, you can add your Odoo CRM as a data source to it:
Go to Setup in the Mapsly main menu:
Click the + button, select Odoo and follow instructions on the screen:
If you encounter the following error:
 Connected to Odoo database successfully but method ‘search_read’ on ‘ir.model’ returned error you
This means that your Odoo instance needs to be updated to the recent most commit which was fixed by Odoo on March 22, 2022.
If you are still seeing the above error, you need to scroll down and check the module's name that causes this error:
Then, you need to verify this inside Odoo by going to Settings:
Activate the developer mode:
Go to Technical > Models:
Search for that model:
If you are seeing the same error, as inside Mapsly, it means that this issue is caused by Odoo. Please contact the Odoo support team.
Adding more users to Mapsly
Please note that you will need to add to Mapsly only those users who will actually be using Mapsly (not all Odoo users). Also, it is possible to add users to Mapsly who are not registered in Odoo.
Using Mapsly with Odoo ERP
Unfortunately Mapsly connector is not supported for Odoo ERP and can be integrated only with Odoo CRM module.
More useful articles
If you'd like to see on the map only standard objects like contacts, the wizard's instructions are self-explanatory. In more complex scenarios when you'd like to see other objects in Mapsly as well or use coordinates instead of an object's address, please refer to these articles:
how to use an object's coordinates stored in the CRM instead of its address in Mapsly (how to skip geocoding for locations that cannot be described by an address or those for which you already have GPS coordinates in your CRM);