Mapsly is a standalone software platform that exchanges data with your Odoo account through its API.
This guide describes steps for your Odoo On-Premise, please refer to this guide if you have an Odoo Online account.
For Odoo On-Premise v16 and lower, Mapsly offers an Odoo extension that implements real-time sync of records removed in Odoo — to ensure they are immediately removed in Mapsly as well.
Signing up for a Mapsly account and connecting your Odoo
1. Follow Mapsly sign-up guide
Create a Mapsly account and connect it to your Odoo CRM by following this Mapsly sign-up wizard.
Please note that on step #4 "Access to data" you'll be prompted to enter your Odoo administrator's login and password, your full Odoo server URL (Odoo web application URL) including "https://" (i.e. https://mycompany.odoo.com), as well as your Odoo database name:
3. Install and configure the Mapsly extension for Odoo
If you use Odoo On-Premise v16 or earlier, install the Mapsly extension to enable real-time sync of removed records between Odoo and Mapsly.
When using Odoo On-Premise v17 or Odoo Online, you don’t need to install the Mapsly extension, since the sync of removed records is performed during the regular sync, along with the sync of new and updated records.
To install the Mapsly extension in your Odoo instance simply follow the steps:
Download the Mapsly extension and connector and add them to your /addons folder:
Mapsly Extension:
https://apps.odoo.com/apps/modules/16.0/mapsly_connector/
Connector:
https://apps.odoo.com/apps/modules/16.0/connector/Go to Apps, search and install the Mapsly extension
After installing the extension you will need to create
mapsly.api_key
. To generate it, inside Mapsly go to Setup > Odoo > General properties and then click the 'Generate' button:
In your Odoo settings activate the developer mode
Go to Settings > Technical > System parameters:
Create
mapsly.api_key
parameter and save the previously generated API key here:
Make sure
web.base.url
parameter exactly matches the "Odoo server URL" you set while creating a Mapsly data source.
Correct it, if needed.
Create
web.base.url.freeze
parameter with valueTrue
Configuration is complete and you can now open Mapsly inside your Odoo instance:
More information
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.
Adding more users to Mapsly
Please note that you will need to add to Mapsly only those users who will be using Mapsly (not all Odoo users). It is also possible to add users to Mapsly who are not registered in Odoo.
Link Odoo to existing Mapsly account
You can connect your Odoo as a data source in your Mapsly account, learn more in this guide.
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);