Odoo Documentation

repository·19.0·Indexed 22 days ago

https://github.com/odoo/documentation

Source files and build configuration for the official Odoo documentation. Includes instructions for building documentation locally using Python (3.10 to 3.14) and Make, configuring language and version switchers, and integrating local Odoo sources. Additionally provides guides on Odoo.sh administration, including module scaffolding, development and staging branch management, deploying to production, and managing external Python libraries via requirements.txt.

Tokens
230.6K
Snippets
274
Records
1.2K
Agent score
79%

What's inside Odoo Documentation

  1. Overview of Saudi Arabian Localization Features

    19.0

    The Saudi Arabian localization package ensures compliance with local fiscal and accounting regulations through several key features:

    • Predefined Chart of Accounts: A structure aligned with Saudi Arabian regulations.
    • Preconfigured Tax Rates: Includes standard 15% VAT, zero-rated, and exempt options.
    • Fiscal Positions: Automated tax adjustments based on customer or supplier registration status.
    • Withholding Taxes: Predefined rules for applicable service categories.
    • Automated Tax Reporting: Specialized reports for VAT and withholding.
    • ZATCA E-invoicing: Integration for electronic invoicing in line with government requirements.
  2. Overview of Cloud Storage Integration

    19.0

    The cloud storage integration allows Odoo to store chatter and email attachments on Google Cloud or Microsoft Azure instead of the local database server. This is useful for preventing large files from consuming database storage or when the database requires more capacity than the hosting solution provides.

    Important Limitations:

    • Files generated by Odoo (e.g., sales orders) and files from the Documents/Sign apps are always stored on the database's server.
    • Storage limits depend on your hosting:
      • Odoo Online: 100 GB
      • Odoo.sh Shared: 512 GB
      • Odoo.sh Dedicated: 4 TB
      • On-premise: Limited by your infrastructure.
  3. Overview of Odoo WhatsApp Integration

    19.0

    Odoo integrates with the WhatsApp Business API to allow businesses to communicate with customers directly from their Odoo database. This integration is an Odoo Enterprise-only application.

    Key Capabilities:

    • Send and receive WhatsApp messages within Odoo.
    • Send pre-approved templates with dynamic placeholders (e.g., Quotations from Sales, Receipts from Point of Sale, or Tickets from Events).

    Communication Flows:

    • Company-initiated: The company sends a template to a customer. If the customer replies within 15 days, a Discuss chat window opens to continue the conversation.
    • Customer-initiated: When a customer messages the company's public WhatsApp number, Odoo opens a group chat for all operators assigned to that WhatsApp channel.

    Compatibility Requirements:

    • Requires a WhatsApp Business Platform Account.
    • NOT compatible with Personal WhatsApp accounts or WhatsApp Business App accounts.
  4. Overview of Colombian Localization in Odoo

    19.0

    Odoo's Colombian localization package provides the necessary accounting, fiscal, and legal features for businesses operating in Colombia. This includes:

    • Chart of Accounts: Pre-configured accounts compliant with local standards.
    • Taxes: Local tax configurations.
    • Electronic Invoicing: Integration with DIAN for compliant electronic document issuance.
  5. Use the Odoo External JSON-2 API

    19.0

    Odoo provides an external HTTP interface to access its ORM API via the /json/2 endpoint. This allows for external analysis or integration with other software.

    Important Constraints:

    • Pricing: Access is only available on Custom Odoo pricing plans. It is not available on One App Free or Standard plans.
    • Availability: The specific models, fields, and methods available depend on your database. You can consult your database's specific documentation at the /doc endpoint.
    • Version: This API was added in version 19.0.
  6. Upgrade Odoo databases: Overview and Requirements

    19.0

    Upgrading involves moving a database from an older version to a newer supported version (e.g., 16.0 to 18.0). Each major version is supported for three years.

    Mandatory Upgrade Rules by Hosting Type:

    • Odoo Online: Mandatory every two years for major versions. For minor versions (e.g., 17.1, 17.2), upgrades are mandatory a few weeks after the next version release.
    • Odoo.sh: Upgrades are required after the initial three years of support. You will receive notifications.
    • On-premise: You can stay on the same version indefinitely, though it is not recommended.

    Important Constraints:

    • Upgrades do not cover downgrading, switching editions (e.g., Community to Enterprise), changing hosting types, or migrating from other ERPs.
    • Custom Modules: If your database contains custom modules, the upgrade cannot proceed until a version of those modules compatible with the target Odoo version is available. It is recommended to parallelize the process by requesting an upgraded database while simultaneously upgrading your custom module source code.
  7. Link third-party shipping carriers to Odoo

    19.0

    Odoo allows linking third-party shipping carriers to your database to:

    • Verify carrier delivery to specific addresses.
    • Automatically calculate shipping costs.
    • Generate shipping labels.

    Shipping carriers can be applied to Sales Orders (SO), Invoices, or Delivery Orders (DO).

    Available Shipping Connectors

    CarrierRegion availability
    DHL ExpressAll
    Envia.comAll
    FedExAll
    UPSAll
    US Postal ServiceUnited States of America
    SendcloudSome European countries (see details below)
    BpostBelgium
    EasyPostNorth America
    ShiprocketIndia
    StarshipitAustralia and New Zealand

    Important Notes:

    • Other services from DHL are not supported.
    • Sendcloud supports shipping from Austria, Belgium, France, Germany, Italy, the Netherlands, Spain, and the United Kingdom, and to any European country.
  8. Understand the Odoo Enterprise Subscription Agreement

    19.0

    The Odoo Enterprise Subscription Agreement governs the use of Odoo Enterprise or Community Edition software, whether hosted on Odoo's Cloud Platform or via Self-Hosting. By subscribing to Odoo Enterprise services, customers agree to terms regarding software licensing, access, and service levels.

    Key Concepts:

    • Term: The duration of the agreement is specified in writing and automatically renews for an equal term unless written notice of termination is provided at least 30 days before the end of the current term.
    • Deployment Options: Customers can use the Cloud Platform (fully managed by Odoo SA) or Self-Hosting (hosted on systems of the customer's choice).
    • Licensing: Odoo SA grants a non-exclusive, non-transferable license to use, modify, and execute the Odoo Enterprise Edition software.
  9. Odoo Editions: Community vs Enterprise

    19.0

    Odoo is distributed in two versions:

    1. Odoo Community: The open-source version.
    2. Odoo Enterprise: A licensed version that includes extra functionalities. Technically, Enterprise functionalities are implemented as new modules installed on top of the Community version modules.