Odoo Documentation
repository·19.0·Indexed 22 days ago
https://github.com/odoo/documentationSource 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.
What's inside Odoo Documentation
- The Odoo Canada localization package provides tailored features and configurations specifically for Canadian businesses. It includes specialized accounting setups, reports, and check printing capabilities. For visual guidance on setting up configurations and common workflows, Odoo provides eLearning resources.
Overview of Canadian Localization in Odoo
19.0The Canadian localization package ensures compliance with Canadian fiscal and accounting regulations. It provides a predefined chart of accounts, automated tax adjustments via fiscal positions, pre-configured tax rates (standard VAT, zero-rated, and exempt), and specialized reporting tools.Overview of Saudi Arabian Localization Features
19.0The 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.
Overview of Cloud Storage Integration
19.0The 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.
Overview of Odoo WhatsApp Integration
19.0Odoo 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.
Overview of Colombian Localization in Odoo
19.0Odoo'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.
Overview of Odoo Testing Types
19.0Odoo utilizes three primary testing methodologies to ensure application stability:
- Python unit tests: Used for testing model business logic.
- JS unit tests: Used to test JavaScript code in isolation.
- Tours (Integration Testing): Simulates real user scenarios to ensure Python and JavaScript components interact correctly.
Use the Odoo External JSON-2 API
19.0Odoo provides an external HTTP interface to access its ORM API via the
/json/2endpoint. 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
/docendpoint. - Version: This API was added in version 19.0.
Upgrade Odoo databases: Overview and Requirements
19.0Upgrading 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.
Link third-party shipping carriers to Odoo
19.0Odoo 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
Carrier Region availability DHL Express All Envia.com All FedEx All UPS All US Postal Service United States of America Sendcloud Some European countries (see details below) Bpost Belgium EasyPost North America Shiprocket India Starshipit Australia 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.
Understand the Odoo Enterprise Subscription Agreement
19.0The 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.
Odoo Editions: Community vs Enterprise
19.0Odoo is distributed in two versions:
- Odoo Community: The open-source version.
- 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.