Skip to main content

Odoo integration

This app enables users to edit and collaborate on office documents within Odoo Documents using ONLYOFFICE Docs.

Features​

  • Currently, the following document formats can be opened and edited with this app: DOCM, DOCX, DOTM, DOTX, PDF, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSB, XLSM, XLSX, XLTM, XLTX.
  • The following formats are available for viewing only: CSV, DJVU, DOC, DOCXF, DOT, DPS, DPT, EPUB, ET, ETT, FB2, FODP, FODS, FODT, HTM, HTML, HWP, HWPX, KEY, MD, MHT, MHTML, NUMBERS, ODG, ODP, ODS, ODT, OFORM, OTP, OTS, OTT, OXPS, PAGES, POT, PPS, PPT, RTF, STW, SXC, SXI, SXW, TXT, VSDM, VSDX, VSSM, VSSX, VSTM, VSTX, WPS, WPT, XLS, XLT, XML, XPS.
  • The app will create a new Open in ONLYOFFICE menu option within the document library for Office documents. This allows multiple users to collaborate in real time and to save back those changes to Odoo.

Installing ONLYOFFICE Docs​

You will need an instance of ONLYOFFICE Docs (Document Server) that is resolvable and connectable both from Odoo and any end clients. If that is not the case, use the official ONLYOFFICE Docs documentation page. ONLYOFFICE Docs must also be able to POST to Odoo directly.

The easiest way to start an instance of ONLYOFFICE Docs is to use Docker.

Installing ONLYOFFICE app for Odoo​

To start using ONLYOFFICE Docs with Odoo, the following steps must be performed:

Option 1. Installation from the administration panel

  1. Log into your existing Odoo account or sign up for a new account.
  2. Go to the Odoo administration panel and click Apps on the top menu bar.
  3. Search for ONLYOFFICE in the Apps catalog.
  4. Click the Install button.

Option 2. Manual installation

  1. Navigate to the Odoo Apps catalog and select the Odoo version you have installed.

  2. Search for ONLYOFFICE and download it. You can also download the latest app version from the official GitHub repository.

  3. Put ONLYOFFICE app into /path/to/odoo/addons. Make sure the ONLYOFFICE folder is named as onlyoffice_odoo.

    Alternatively, you can add the following lines in the /path/to/odoo/config/odoo.conf file specifying your path to the folder with apps/addons:

    [options]
    addons_path = /mnt/extra-addons

  4. Install the pyjwt package:

    pip install pyjwt

  5. Switch your Odoo to the developer mode and click Apps -> Update Apps List or just restart your Odoo instance.

note

ONLYOFFICE demo templates will only be added to the Odoo modules that are already installed (refers to the ONLYOFFICE Templates app). That's why we strongly recommend installing ONLYOFFICE Templates after installing other Odoo modules such as CRM, Sales, Calendar, etc.

Configuring ONLYOFFICE app for Odoo​

To configure the app, go to Settings. Find ONLYOFFICE on the left sidebar and click it. Specify the URL of the installed ONLYOFFICE Docs:

https://<documentserver>/

where the documentserver is the name of the server with ONLYOFFICE Docs installed. The address must be accessible from both the user's browser and the Odoo server. The Odoo server address must also be accessible from ONLYOFFICE Docs for correct work. You can register a free ONLYOFFICE Cloud and use its public IP address or public DNS that can be found in the Instances section of the cloud console.

caution

Starting from version 7.2, JWT is enabled by default and the secret key is generated automatically to restrict access to ONLYOFFICE Docs and for security reasons and data integrity. Specify your own Secret key on the Odoo configuration page. In the ONLYOFFICE Docs config file, specify the same secret key and enable the validation.

How it works​

The ONLYOFFICE integration follows the API documented here.

Working with forms​

You can create, upload, and use fillable form templates within the ONLYOFFICE Templates module in Odoo. The module allows you to generate documents with fields that can be automatically filled with data from Odoo records.

Requirements​

  • An instance of ONLYOFFICE Docs with support for fillable forms.
  • A valid ONLYOFFICE license with the Automation API option enabled.
  • The ONLYOFFICE Templates module in Odoo (automatically installs the main ONLYOFFICE module).
info

For Odoo integration specifics, see the ONLYOFFICE Odoo connector guide.

note

If you are planning to deploy fillable form workflows in Odoo, make sure that your edition of ONLYOFFICE Docs supports PDF forms. For the minimum supported versions in your environment (Community, Enterprise, Cloud), please check the ONLYOFFICE release notes or contact the support team.

Download the ONLYOFFICE app for Odoo here.