Mapsly is a standalone software platform that exchanges data with your Odoo account through its API.

Also, 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.

Note for users of Odoo Online. While Mapsly works with both Odoo On-premise and Odoo Online, we strongly recommend using Mapsly with Odoo On-premise because Odoo Online API cannot be called more frequently than once per second, which significantly slows down the automatic assignment of territories and mass-updates of Odoo records from Mapsly and may cause significant delays in synchronization of updates from Odoo to Mapsly while the mentioned processes are in progress. Odoo On-premise doesn't impose such limits on the use of its API, so data sync between Mapsly and Odoo On-premise is significantly faster.

If you are using Odoo On-premise, skip this step and proceed to step #2.

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:

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:

If you are using Odoo On-premise v17 or Odoo Online, don't do this step — your Mapsly installation is already complete.

Odoo clients using Odoo On-premise v16 or lower need to install the Mapsly extension to enable real-time sync of removed records between Odoo and Mapsly. For Odoo v17 and Odoo Online, sync or 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:

To log into Mapsly, go to app.mapsly.com and enter your Mapsly login and password into the Mapsly login form.

If you already have an a Mapsly account, you can add your Odoo CRM as a data source to it:

Note!

If you encounter the following error:

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.

Follow this guide to add or remove users in 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.

Unfortunately Mapsly connector is not supported for Odoo ERP and can be integrated only with Odoo CRM module.

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: