Skip to main content
All CollectionsIntegration
[Odoo On-Premise] Mapsly setup guide
[Odoo On-Premise] Mapsly setup guide

A step-by-step guide for setting up your Mapsly account with Odoo On-Premise

Yulia Egorova avatar
Written by Yulia Egorova
Updated this week

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:

  1. 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/

  2. Go to Apps, search and install the Mapsly extension

  3. 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:

  4. In your Odoo settings activate the developer mode

  5. Go to Settings > Technical > System parameters:

  6. Create mapsly.api_key parameter and save the previously generated API key here:

  7. Make sure web.base.url parameter exactly matches the "Odoo server URL" you set while creating a Mapsly data source.

    Correct it, if needed.

  8. Create web.base.url.freeze parameter with value True

  9. 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:

Did this answer your question?