Compare commits

...

214 Commits

Author SHA1 Message Date
Michael (mcm) dc7681af00 [IMP] web: update documentation of patch function
This commit updates the documentation of the patch function
with the changes done in https://github.com/odoo/odoo/pull/125716.
2023-08-03 12:38:53 +02:00
tiku-odoo 7e29da60b9 [IMP] Misc: Oauth Azure
closes odoo/documentation#5041

closes odoo/documentation#5255

X-original-commit: 66b2a3d50e
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Co-authored-by: Zachary Straub <zst@odoo.com>
2023-08-03 00:33:44 +02:00
John Holton (hojo) 8edb63948c [IMP] Inventory: Update Multi-package shipments doc
closes odoo/documentation#5246

X-original-commit: 7df2d749a8
Signed-off-by: John Holton (hojo) <hojo@odoo.com>
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-08-02 11:16:53 +02:00
“Chiara 76c781226d [ADD] l10n: saudi arabia e-invoicing
task-3422500

closes odoo/documentation#5233

X-original-commit: 24ff6624bb
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-28 23:16:34 +02:00
Martin Trigaux fd4065b3c6 [I18N] *: export translations
closes odoo/documentation#5223

X-original-commit: 013da823cc
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2023-07-28 10:33:22 +02:00
Xavier (XPL) b755d0330e [IMP] payments: update ACH section content to match 16.0
closes odoo/documentation#5216

X-original-commit: 992fc9f4d6
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-27 03:50:48 +02:00
Xavier (XPL) b5dbf4779a [IMP] accounting: year-end closing
task-2823858

closes odoo/documentation#5211

X-original-commit: 8c03442791
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-26 16:11:49 +02:00
Victor Feyens db05d69be6 [IMP] accounting: new behavior of the sepa provider
Sepa mandates are not automatically confirmed anymore,
customers have to make one successful bank transfer
matching the expected payment details to confirm
their mandate.

See https://github.com/odoo/odoo/commit/fd2fb212c50952ca5a8e162ba5d82ce433cd5989
See https://github.com/odoo/enterprise/commit/9b729b157b6978e10fbbed45052226f150e5559f

closes odoo/documentation#5201

X-original-commit: bc1cf93455
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-26 13:22:07 +02:00
Donatienne Pirlot c795231f1c [ADD] elearning: creating a new elearning doc page
To add updated information related to the elearning app

closes odoo/documentation#5155

Id: 3251391
X-original-commit: 2e9c99c941
Signed-off-by: Donatienne Pirlot (dopi) <dopi@odoo.com>
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-26 08:08:02 +02:00
Xavier (XPL) 5114140efe [IMP] payments: add section about ACH payments
task-3303591

closes odoo/documentation#5198

X-original-commit: 0155844ef5
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-25 21:22:56 +02:00
Levi Siuzdak (sile) dd7ab18b9e [IMP] developer: add notes on entity references & fix illegal XML
Using `<` inside XML elements will result in a parsing error,
an entity reference should be used instead: `&lt;`.

closes odoo/documentation#5184

X-original-commit: a7743d513b
Signed-off-by: Levi Siuzdak (sile) <sile@odoo.com>
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-24 23:04:05 +02:00
Tom Aarab (toaa) 32cb0d8244 [IMP] accounting: multicurrency
Changed the "bank statement" section to "bank transactions"

taskid-3433653

closes odoo/documentation#5171

X-original-commit: 4b142c2a70
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
Signed-off-by: Tom Aarab (toaa) <toaa@odoo.com>
2023-07-20 15:45:03 +02:00
“Dallas” 80b4cd05d3 [IMP] accounting: update payment terms
task-3211595

closes odoo/documentation#5175

X-original-commit: 26c4c01889
Signed-off-by: Dallas Dean (dade) <dade@odoo.com>
2023-07-20 14:23:33 +02:00
tong-odoo 421e760581 [ADD] accounting: add Vietnam localisations
Impacted Version:

- 16.4 and above

This commit improve below features:

- Vietnam accounting documentation
- Vietnamese QR banking code documentation

task-3344654

closes odoo/documentation#5043

Related: odoo/odoo#127689
Signed-off-by: Tommy Ng (tong) <tong@odoo.com>
2023-07-20 06:40:45 +02:00
Valentin Chevalier 3bd570ae64 [IMP] Stripe: update doc to match the new flow
Stripe now implements a direct flow instead a redirect.

This commit focuses on updating the documentation to match the changes.

task-3322020

closes odoo/documentation#4719

Related: odoo/upgrade#4748
Related: odoo/enterprise#42196
Related: odoo/odoo#123573
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-19 13:13:04 +02:00
Xavier (XPL) 3e199d9825 [IMP] general: add screenshot of stacked line chart in reporting
task-3375264

closes odoo/documentation#5156

X-original-commit: 5ee932e14b
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-19 10:24:02 +02:00
Demesmaeker ca475f8ad5 [IMP] sale_amazon: support stock synchronization from Odoo
task-2864098

closes odoo/documentation#4773

Related: odoo/enterprise#40720
Related: odoo/upgrade#4810
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-18 19:27:41 +02:00
Louis Wicket ae0c4d809d [FIX] incoterms: fix typo: DPA → DAP
closes odoo/documentation#5146

X-original-commit: 1227c9cf79
Signed-off-by: Louis Wicket (wil) <wil@odoo.com>
2023-07-18 18:18:23 +02:00
chyde-clearwater 3758cd5899 [IMP] tutorials/getting_started: disambiguate example model name
I removed the dot notation in the  "_name" variable for the example
model. AKA, "test.model" is now named "test_model".

Dot notation implies a data structure relationship between a <model> and
it's parent (or class etc) <test> (like test.model() or Test.model).
There is no relationship like this between a <test> and <model> - it's
just one thing: a <test model>.

The seeming "benefit" of the ORM translating dots to underscores doesn't
justify this naming convention.  Yes, I know it's a string, but still,
this seems confusing for newbies and adds unnecessary complexity (why
name the same thing differently in different places?)

closes odoo/documentation#5141

X-original-commit: f36c612d13
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-18 13:07:47 +02:00
Henrique Dias 9514d7df55 [FW][ADD] rpc: Go examples
Examples rely on `kolo/xmlrpc` as well as on the standard library package `log` to panic on error, matching snippets in other languages (which tend to raise exceptions).

As with other languages, only the RPC interaction is spelled out.

closes odoo/documentation#5129

Forward-port-of: odoo/documentation#5064
Signed-off-by: Xavier Morel (xmo) <xmo@odoo.com>
2023-07-15 12:00:28 +02:00
John Holton (hojo) f704ee9cc1 [DEL] MRP: Delete Alternative Work Centers 16.0
closes odoo/documentation#5123

X-original-commit: a67a69beae
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-15 12:00:01 +02:00
Martin Trigaux 0031e37c63 [FIX] developer: document changes of message_post API
closes odoo/documentation#5119

X-original-commit: 8bf2d026b7
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2023-07-15 10:54:41 +02:00
Lara Martini (larm) 89b550252a [IMP] Inventory: update for 16
closes odoo/documentation#5104

X-original-commit: 29db8bf1e6
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-13 20:37:30 +02:00
Jess Rogers (jero) 27d8dc2acd [IMP] live chat: add note for 16.3 command changes
closes odoo/documentation#5103

X-original-commit: a187b7cde4
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-13 20:37:27 +02:00
Loredana Perazzo 4367502c08 [IMP] pos: move part of the intro into generate tab
task-3372676

closes odoo/documentation#5115

X-original-commit: d5466bea0d
Signed-off-by: Loredana Perazzo (lrpz) <lrpz@odoo.com>
2023-07-13 19:28:23 +02:00
Marc Durepos 9988d0b214 [FIX] Remove reference to assets_qweb in assets.rst
Reflects the fact that assets_qweb bundle is no longer used in 16.0

closes odoo/documentation#5109

X-original-commit: c85031b3fc
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-13 19:28:18 +02:00
Odoo's Mergebot 665bf423ec [FW][FIX] install: remove duplicate note
The notes displayed before and after the tabs under the Git paragraph in `install.rst` were identical, except for one sentence. Added the sentence to the post-tabs note and removed the pre-tabs one.

closes odoo/documentation#5092

Forward-port-of: odoo/documentation#5087
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-13 08:28:26 +02:00
Aymen Sellami 8bf5772a97 Remove duplicate note
The notes displayed before and after the tabs under the Git paragraph in install.rst were identical, except for one sentence. Added the sentence to the post-tabs note and removed the pre-tabs one.

X-original-commit: 481a867a05
Part-of: odoo/documentation#5092
2023-07-13 08:28:25 +02:00
Leonardo Pavan Rocha 6462ed0112 [IMP] web: merge quick_add with quick_create_form_view id in views
https://github.com/odoo/odoo/pull/114827 added a new attribute
quick_create_form_view_id to the calendar view that would allow showing a form
view when clicking on quick_create. This attribute was only used in calendar,
however it could be useful for other modules as well. It was decided to merge
this new attribute with the quick_add attribute, as they are related. Now, the
quick_add attribute accepts either a boolean or a form view id. This commit
changes the documentation of this attribute.

task-3286969

closes odoo/documentation#4707

Related: odoo/odoo#122923
Signed-off-by: Arnaud Joset (arj) <arj@odoo.com>
2023-07-12 20:33:53 +02:00
Xavier (XPL) 1c2ce72416 [IMP] payments: clarify authorize.net statement import steps
task-2382237

closes odoo/documentation#5077

X-original-commit: 22d45407c4
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-11 04:52:41 +02:00
Martin Trigaux fb681d1305 [I18N] *: export translations
closes odoo/documentation#5069

X-original-commit: 921b483e2e
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2023-07-10 16:59:30 +02:00
Tom Aarab (toaa) e005fa9896 [IMP] authorize.net statement import
taskid-2382237

closes odoo/documentation#5063

X-original-commit: ca38752795
Signed-off-by: Tom Aarab (toaa) <toaa@odoo.com>
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-07 17:58:09 +02:00
Antoine Vandevenne (anv) 7d70725925 [FIX] odoo_theme/switchers: fallback to the original target URL
Attempting to switch from one version to another when navigating
<old_version>/applications/hr/employees.html led to the user being
redirected to /applications/documentation/<new_version>/hr/employees.html
because `hr` was interpreted as a version string, and thus the generated
target URLs of the version switcher were all wrong.

This commit ensures the redirection now falls back onto the original
target URL when all the generated ones point to a 404.

closes odoo/documentation#5059

X-original-commit: c81a91db9c
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-07-07 17:58:06 +02:00
Zuzanna Luczynska 4590a4c25a [ADD] project: recurring tasks, FW port edit 16.2
closes odoo/documentation#5049

Id: 3255317
X-original-commit: c2d174fb4e
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-07 17:57:52 +02:00
tong-odoo 057a1c11d2 [FIX] accounting: AU rebrands Keypay to Employment Hero
task-3250954

closes odoo/documentation#5035

X-original-commit: d252a96747
Related: odoo/enterprise#43735
Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
Signed-off-by: Tommy Ng (tong) <tong@odoo.com>
2023-07-06 19:46:32 +02:00
Xavier (XPL) 7d01392c9a [IMP] accounting: l10n chile deliver guides warning
task-3410367

closes odoo/documentation#5030

X-original-commit: b729d05e57
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-05 15:58:34 +02:00
Julien Mougenot 35aae86dbd [IMP] web: Owl DateTimePicker
This commit introduces a date picker OWL component meant to handle the
following use-cases:
- date picker
- date & time picker
- date range picker
- date & time range picker

Basically, this component is the union of the two previous third-party
libraries handling these cases: TempusDominus and DateRangePicker.

New components introduced:

* The main addition of this commit is the `DateTimePicker` itself which
handles the display and interactions of the calendar and time pickers.
> see @web/core/datetime/datetime_picker

* The picker can then be coupled to an input using the
`useDateTimePicker` hook. The purpose of this hook is to handle events
on a given input element and syncronize its value to a date picker it
will spawn in a popover.
> see @web/core/datetime/datetime_hook

* Lastly, a simple `DateTimeInput` component will render an input and
call the hook mentioned above to handle it. This component is
effectively replacing the previous DatePicker and DateTimePicker
components (note that it does not handle range values).
> see @web/core/datetime/datetime_input

Another noticeable change of this commit is the definition of daterange
fields in views:

- Previously, the arch would have to define both fields
and bind them via their options, while also adding an arrow between
inputs or other forms of connection.

- In the new implementation, only the start date field must be declared,
and a date range can be spawned by providing an `end_date_field` in its
options.

Example:
```xml
<field
    name="start_datetime"
    widget="daterange"
    options="{'end_date_field': 'end_datetime'}"
/>
```

warning Added limitations:

- this new way of declaring date ranges means that templates have been
revised to declare one field tag instead of two. This means that list
views using date ranges have lost the ability to be sorted on their end
date fields.

> Justification: the current use cases have been reviewed and it has
been decided that it was not needed to sort on the end date on the
affected list views.

> Workaround: drop the date range and declare both fields as simple date
pickers (i.e. without the end_date_field option).

- all modifiers applied to a field using a date range will be copied and
applied to the end date field. There is no way to define modifiers
specific to one field or the other.

> Justification: there was no use case where one of the two fields
needed specific modifiers.

> Workaround: same as the previous point: split the range into 2 simple
date picker fields.

Additional notes:

- the widget="daterange" is not mandatory in form views, but is required
in list views because only fields with explicit widgets will not be
rendered as simple <span> elements. The date range feature will be
available as soon as an end_date_field is specified.

- as the end date field is not explicitly defined in the view anymore,
any modifier depending on it need to have it defined as invisible
somewhere in the arch.

Task ID: 3121497

closes odoo/documentation#5013

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Julien Mougenot (jum) <jum@odoo.com>
2023-07-04 12:47:02 +02:00
Julien Mougenot a9c82ebb94 [REF] web: update JS fields documentation
This commit updates the documentation of JS fields:

- style and notation have been adapted to keep in line with the current
documentation writing guidelines;

- some outdated bits have been updated or removed (this is rather a
correction of misleading information than a proper update as no new
information has been added).

Part-of: odoo/documentation#5013
2023-07-04 12:47:01 +02:00
Brandon Seltenrich (BRSE) 453284ba8e [IMP] purchase: update manage vendor bills
closes odoo/documentation#5012

X-original-commit: 688220bb51
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-07-04 07:55:31 +02:00
Xavier 42115759bc [IMP] maintain: odoo online database management
task-2995394

closes odoo/documentation#5006

X-original-commit: c6e6401e36
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-04 07:55:29 +02:00
tong-odoo 94a6a0b204 [IMP] localization: AU rebrands Keypay to Employment Hero
task-3250954

closes odoo/documentation#4998

X-original-commit: 35fc637ed4
Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2023-07-04 07:55:26 +02:00
AMZIL Ayoub f51b991fd4 [DOC] cleanup of pec server documentation
PEC Server is removed from 16 (onwards)

closes odoo/documentation#4991

X-original-commit: f3e3490ba4
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-07-04 00:51:48 +02:00
John Holton (hojo) c76f97777a [ADD] Inventory: Add Replenish on order (MTO)
closes odoo/documentation#4984

X-original-commit: d9ece7b353
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-01 19:13:00 +02:00
John Holton (hojo) e80d7ae220 [ADD] Inventory: Add reordering rules
closes odoo/documentation#4977

X-original-commit: eb347c2681
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-01 19:12:57 +02:00
John Holton (hojo) f27df8f077 [ADD] MRP: Work center time off
closes odoo/documentation#4970

X-original-commit: 18a9b88a11
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-01 19:12:55 +02:00
Jess Rogers (jero) 06d5e0b096 [ADD] livechat: added chatbot doc
closes odoo/documentation#4969

X-original-commit: 729881c7b1
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-01 18:05:18 +02:00
Lara Martini (larm) 137e58719b [IMP] Inventory: updated images and removed edit and save directions
closes odoo/documentation#4959

X-original-commit: 710c373354
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-07-01 04:44:58 +02:00
John Holton (hojo) 9cac3b3d1a [IMP] Administration: Rewrite Upgrade Odoo SaaS
closes odoo/documentation#4951

X-original-commit: 45b1a62782
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-06-30 10:42:11 +02:00
Tom Aarab (toaa) 7dfd6421db [IMP] accounting: checks
task-2979887

closes odoo/documentation#4942

X-original-commit: 5b78ee96af
Signed-off-by: Tom Aarab (toaa) <toaa@odoo.com>
2023-06-29 11:59:51 +02:00
Xavier b0a042b928 [FIX] accounting: remove fullscreen property from tutorial link
task-3389168

closes odoo/documentation#4936

X-original-commit: 88da0a9256
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-06-28 19:08:51 +02:00
Jess Rogers (jero) facb3f184e [IMP] livechat: update commands and canned responses
closes odoo/documentation#4931

X-original-commit: e8aaefd283
Signed-off-by: Jessica Rogers (jero) <jero@odoo.com>
2023-06-28 17:41:59 +02:00
Rémy Voet (ryv) 13544bca17 [IMP] orm: name_get into display_name
odoo/odoo#122085
odoo/enterprise#42599
odoo/upgrade#4780

closes odoo/documentation#4639

Signed-off-by: Rémy Voet (ryv) <ryv@odoo.com>
2023-06-28 17:41:15 +02:00
Xavier 9e54525d61 [ADD] website: reCAPTCHA
task-3336129

closes odoo/documentation#4920

X-original-commit: 329f6dd8d5
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-06-27 22:40:15 +02:00
Timothy Kukulka (tiku) 1ed317ebd7 [IMP] IoT: edits to all IoT docs
closes odoo/documentation#4927

X-original-commit: e7457c992b
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-27 21:27:56 +02:00
Benoit Socias 0df9068892 [FIX] howto/rdtraining: ch.13 adapt reference to salesperson field
In chapter 13 the `property_ids` field is defined as the inverse of a
`user_id` field. But in chapter 8 when the salesperson field is added,
no such name is given to it.

This commit adapts the description to reference the general concept of
the field used to link to the salesperson instead of an actual field
identifier.

task-3381757

closes odoo/documentation#4913

X-original-commit: 3a131c829a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-06-27 13:44:38 +02:00
Benoit Socias 2161dd5acf [IMP] developer/views: add optional attribute for fields of list views
The attributes of fields of list views do not mention the `optional`
attribute while it is used by chapter 12 of the R&D Training.

This commit describes this `optional` attribute.

task-3380953

closes odoo/documentation#4912

X-original-commit: 5a446f5c59
Signed-off-by: Benoit Socias (bso) <bso@odoo.com>
2023-06-27 13:44:35 +02:00
KC (ksc) 9989131931 [IMP] sales: updated down payment doc for RST and image reasons
closes odoo/documentation#4897

X-original-commit: 802dc467de
Signed-off-by: Kevin Scannell (ksc) <ksc@odoo.com>
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-27 01:34:51 +02:00
Brandon Seltenrich (BRSE) f1d048fdff [IMP] inventory: update expiration dates doc
closes odoo/documentation#4890

X-original-commit: 49029eda37
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-06-26 23:23:09 +02:00
Jess Rogers (jero) 5cfd1623ae [IMP] live chat:update getting started doc
closes odoo/documentation#4883

X-original-commit: c24f4b237e
Signed-off-by: Jessica Rogers (jero) <jero@odoo.com>
2023-06-26 23:23:01 +02:00
Lara Martini (larm) 432d9bb10b [ADD] Employees: anning a new employee
closes odoo/documentation#4858

X-original-commit: 547ad6fca5
Signed-off-by: Lara Martini (larm) <larm@odoo.com>
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-26 21:09:52 +02:00
Donatienne Pirlot 1be31fda81 [ADD] localization: belgian accounting
closes odoo/documentation#4842

Id: 3143421
X-original-commit: 4d477a598f
Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2023-06-26 20:01:07 +02:00
Lara Martini (larm) 4d61833e46 [IMP] inventory: update strategies second person and images
closes odoo/documentation#4869

X-original-commit: 6201ee8760
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-24 04:41:55 +02:00
Jess Rogers (jero) 46d85d4f00 [IMP] helpdesk: update help center documentation
closes odoo/documentation#4875

X-original-commit: bafe824f38
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-24 01:03:01 +02:00
Xavier 5720cd2802 [ADD] Spreadsheet: templates
task-3235170

closes odoo/documentation#4863

X-original-commit: 1853f226e7
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
Co-authored-by: Xavier <xpl@odoo.com>
Co-authored-by: Loredana <lrpz@odoo.com>
2023-06-23 10:27:55 +02:00
“Audrey 9fc59e3237 [IMP] Payment providers - Stripe: Add missing webhook events
task-3373642

closes odoo/documentation#4780

X-original-commit: c04399c0b3
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
2023-06-23 09:20:53 +02:00
Lara Martini (larm) 5b04581623 [IMP] Expenses: updating for new 16 design
closes odoo/documentation#4850

X-original-commit: 0433e84a0c
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-22 03:20:29 +02:00
Felicious 5c82ba7762 [IMP] inventory: adjust manual val for v.16
closes odoo/documentation#4846

X-original-commit: 4c750d1bb7
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Co-authored-by: ksc-odoo <73958186+ksc-odoo@users.noreply.github.com>
Co-authored-by: Sam Lieber (sali) <36018073+samueljlieber@users.noreply.github.com>
Co-authored-by: Zachary Straub <zst@odoo.com>
2023-06-22 02:02:47 +02:00
Jonathan b7316e2e2e [IMP] accounting: add tutorials links to chart of accounts
closes odoo/documentation#4836

X-original-commit: a85e064ffc
Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2023-06-21 22:40:59 +02:00
Jonathan 4e61b3585e [FIX] discuss: broken link in ice_servers.rst
closes odoo/documentation#4827

X-original-commit: 8efbe3ef84
Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2023-06-21 20:10:34 +02:00
Lara Martini (larm) 11401af3dd [IMP] Inventory: Updating for 16.0 no save button
closes odoo/documentation#4814

X-original-commit: e074580ffb
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-21 20:10:20 +02:00
Loredana Perazzo 3d0a19f329 [IMP] pos: write content on the Payment Terminals page
task-3358474

closes odoo/documentation#4798

X-original-commit: 2a5a45d6a4
Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
Signed-off-by: Loredana Perazzo (lrpz) <lrpz@odoo.com>
2023-06-21 13:46:03 +02:00
Martin Trigaux 89bccb44ff [I18N] *: export 16.0 source terms
closes odoo/documentation#4801

X-original-commit: ad7b636275
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2023-06-20 22:03:07 +02:00
Christophe Monniez 899ee1c4c1 [FIX] deploy: reference the config parameter
The deploy documentation is assuming that `/etc/odoo.conf` is the
default config file, which is not the case.

With this commit, the configuration file references the cli
documentation.

closes odoo/documentation#4808

X-original-commit: 8aed7988ba
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Christophe Monniez (moc) <moc@odoo.com>
2023-06-20 18:02:00 +02:00
Christophe Monniez ab4cfb431f [IMP] maintain: switch to enterprise windows
* Update the title as `Upgrade Community to Enterprise` is confusing.
* Update 9.0 screenshots to more recent ones
* As the windows installer uses a real python interpreter, the install
  command is updated accordingly.

X-original-commit: f03b4ca649
Part-of: odoo/documentation#4808
2023-06-20 18:01:59 +02:00
Antoine Vandevenne (anv) 9f65cba6dc [FIX] legal: fix broken PDF link
Apply the fix of e6aa5dd0 to `terms_of_sale.rst` and
`terms_of_sale_fr.rst` that were forgotten.

closes odoo/documentation#4791

X-original-commit: 8cffb57dae
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-06-20 00:24:01 +02:00
“Dallas” 3b50c7a565 [MOV] accounting: update/move customer addresses to accounting
task-3304975

closes odoo/documentation#4778

X-original-commit: cf5a3276c9
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-16 23:01:31 +02:00
Xavier 4af52da507 [IMP] accounting/sales: default terms and conditions + quotation templates
task-3304938

closes odoo/documentation#4766

X-original-commit: 7ddbeb9223
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
2023-06-16 12:19:00 +02:00
Tom Aarab (toaa) a7bb89ce47 [IMP] payment providers: PayPal
taskid-3184602.

16.0 -> Change extra fees category to :ref: main page payment provider
16.2 -> Remove Odoo credentials section
        Remove PDT identity token
        Remove merchant ID note
        Remove test mode section on environment test

Took the opportunity to redo the whole page.

closes odoo/documentation#4735

X-original-commit: ede03aa87b
Signed-off-by: Tom Aarab (toaa) <toaa@odoo.com>
2023-06-16 10:52:45 +02:00
KC (ksc) 532b6be429 [IMP] sales: updated pro-forma invoice doc
closes odoo/documentation#4762

X-original-commit: 3e4e8acfed
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-16 01:40:21 +02:00
Sam Lieber (sali) 80e8576263 [IMP] marketing: workflow_activities.rst - Format fixes
closes odoo/documentation#4754

X-original-commit: a09ca7bd0f
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-16 01:40:13 +02:00
Sam Lieber (sali) 75fd5255eb [IMP] marketing: testing_running.rst format fixes
closes odoo/documentation#4755

X-original-commit: 4b327417b0
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-16 00:30:01 +02:00
Sam Lieber (sali) 070ffa86c0 [IMP] Update rst for target_audiences.rst (v14)
closes odoo/documentation#4741

X-original-commit: 89c1c1b357
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-15 19:59:31 +02:00
tong-odoo 7b5ce24bba [IMP] accounting: update Hong Kong FPS content
Impacted versions:

- saas-16.4 or above

tast-3130633

closes odoo/documentation#4565

Related: odoo/odoo#122802
Related: odoo/upgrade#4727
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-15 17:36:11 +02:00
tong-odoo 05a09da86a [ADD] accounting: add Singapore localisations
Impacted versions:

- saas-16.4 or above

This commit improve below features:

- Singapore accounting documentation
- PayNow QR code documentation

task-3130633

Part-of: odoo/documentation#4565
2023-06-15 17:36:11 +02:00
“Audrey d0ca9fbafe [FIX] Adyen: Fix live/test URLs
closes odoo/documentation#4729

X-original-commit: 1f2f11c42b
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: auva-odoo <auva@odoo.com>
2023-06-15 09:05:22 +02:00
“Audrey c7713b218f [IMP] Website: Multiple websites
task-3190493

closes odoo/documentation#4715

X-original-commit: 1042ba86fb
Signed-off-by: auva-odoo <auva@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-13 12:49:43 +02:00
Tom Aarab (toaa) 978bebf93c [IMP] accounting: OSS report
Added a section on where to find OSS reports and how to export them

task-3305037

closes odoo/documentation#4716

X-original-commit: 0494082a55
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Tom Aarab (toaa) <toaa@odoo.com>
2023-06-13 08:44:23 +02:00
Loredana Perazzo 388003e6f1 [IMP] pos: update the register customers section
task-3357882

closes odoo/documentation#4706

X-original-commit: ee4b279e7c
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Perazzo Loredana (lrpz) <lrpz@odoo.com>
2023-06-12 12:41:57 +02:00
Tom Aarab (toaa) 7a41103958 [IMP] accounting: follow-up reports
task-3316301.

closes odoo/documentation#4700

X-original-commit: 256ddb30ab
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Tom Aarab (toaa) <toaa@odoo.com>
2023-06-12 12:41:29 +02:00
Morfosys 63a9962742 [IMP] l10n: update links in mexico.rst
Update the link for Smarter Web to the appropriate landing page for
Odoo.

closes odoo/documentation#4690

X-original-commit: 7510b4bb23
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-09 13:50:20 +02:00
Benjamin Hanquin 414bae03ec [IMP] odoo.sh: settings collaborators access matrix
Add the Upgrade submenu, Fix the Settings submenu to User only in
staging branches and improve the style in order to be similar to
supported versions matrix
(https://www.odoo.com/documentation/16.0/administration/maintain/supported_versions.html)

closes odoo/documentation#4689

X-original-commit: 98207740d5
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-09 13:50:17 +02:00
Lara Martini (larm) bbd5b4da50 [IMP] Expenses: updaitng out of date information and images
closes odoo/documentation#4553

closes odoo/documentation#4669

X-original-commit: 01f40f24ba
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-09 02:32:43 +02:00
Xavier-Do 2954463d6e [FIX] werkzeug version
https://werkzeug.palletsprojects.com/en/1.0.x/objects.inv now returns a
404.
2023-06-09 01:07:49 +02:00
“Audrey 18280ab5da [IMP] Adyen: Update directions for setting the URLs
task-3338125

closes odoo/documentation#4661

X-original-commit: 35d355f624
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: auva-odoo <auva@odoo.com>
2023-06-08 14:32:37 +02:00
Loredana Perazzo 1fb6059a90 [IMP] pos: update multi employees management
task-3005118

closes odoo/documentation#4657

X-original-commit: e3665393c3
Signed-off-by: Perazzo Loredana (lrpz) <lrpz@odoo.com>
2023-06-08 09:10:07 +02:00
Brandon Seltenrich (BRSE) ae506cb484 [FIX] inventory: fix two step doc
closes odoo/documentation#4652

X-original-commit: c9dcbf6d01
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-06-07 23:26:04 +02:00
“Dallas” 10683c03c7 [IMP] accounting: update VIES VAT number validation
task-3329992

closes odoo/documentation#4641

X-original-commit: d472c646a8
Signed-off-by: Dallas Dean (dade) <dade@odoo.com>
2023-06-07 18:01:19 +02:00
luvi 898b0280db [IMP] web: add documentation for Core components
This commit adds some documentation for features recently added to SelectMenu
and TagsList components during the saas-16.3 development. A screenshot has
been provided to the advances use case of the SelectMenu, with a customization
of the bottom area of the dropdown, to create display a button allowing the
creation of items.

closes odoo/documentation#4631

X-original-commit: 0aad6eafda
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Luca Vitali <luvi@odoo.com>
2023-06-06 14:48:43 +02:00
Antoine Vandevenne (anv) 369aa4a662 [IMP] supported_versions: release saas-16.3
"September" didn't fit in the current table, so this commit also
replaces the previous implementation of the table by a `list-table`
directive... The real reason is that it was long due to ease future
updates of the table.

closes odoo/documentation#4629

X-original-commit: 3d1293757a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-06-06 10:30:08 +02:00
Julien Castiaux 8459cf4db8 [FIX] install: minimal python version is 3.8
See odoo/odoo@44d60e3

closes odoo/documentation#4621

X-original-commit: 38e6d5d368
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2023-06-05 23:59:09 +02:00
Martin Trigaux 885bf17e4c [I18N] *: export saas-16.1 source terms
closes odoo/documentation#4619

X-original-commit: cedd35f653
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2023-06-05 14:50:16 +02:00
Tom Aarab (toaa) 844c2ef62e [IMP] accounting: OSS note removal
Removal of a note in 16 that only applies to versions below it.

task-3305037

closes odoo/documentation#4614

X-original-commit: adee414578
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-02 22:29:33 +02:00
Tom Aarab (toaa) f2ce4374aa [ADD] accounting: incoterms
Seperating Incoterms section from "Intrastat" doc to make it a stand
alone documentation.

task-3305222

closes odoo/documentation#4613

X-original-commit: 971543266a
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-06-02 22:29:31 +02:00
tiku-odoo 670f8bb76c [NEW]IoT- Windows IoT doc
closes odoo/documentation#4599

X-original-commit: f449011c39
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-06-02 00:35:55 +02:00
Brandon Seltenrich (BRSE) a4461a7ee4 [FIX] inventory: fix sn doc typos
closes odoo/documentation#4595

X-original-commit: 17b53be028
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-06-01 20:17:13 +02:00
Brandon Seltenrich (BRSE) c30ecfb20d [FIX] inventory: fix note in inv val config
closes odoo/documentation#4594

X-original-commit: 5a55437adc
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-06-01 20:17:10 +02:00
Jess Rogers (jero) 1eb2037c30 [IMP] helpdesk: combine and update invoice time docs
closes odoo/documentation#4579

X-original-commit: b7efbb61b1
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Jessica Rogers (jero) <jero@odoo.com>
2023-06-01 17:55:15 +02:00
“Audrey e3a28d6cf1 [IMP] payment providers: Wire Transfer
task-3301001

closes odoo/documentation#4571

X-original-commit: 882b4b852b
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: auva-odoo <auva@odoo.com>
2023-05-31 14:23:26 +02:00
Loredana Perazzo e99891c7b7 [ADD] k7e: how to manage articles (add, del, move, structure, share).
Task-3049957

closes odoo/documentation#4557

X-original-commit: 163d653468
Signed-off-by: Perazzo Loredana (lrpz) <lrpz@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-30 10:31:52 +02:00
Olivier Dony ac0e703863 [FIX] legal: fix link to pt_BR PDF version 2023-05-26 20:04:54 +02:00
oco-odoo 21b604e0db [IMP] accounting: subformulas for aggregation engine in custom reports
https://github.com/odoo/enterprise/commit/f39862263c7e2332468a69736589a35d66d87b16
introduced two new subformulas for aggregations, but they were still
missing in the doc.

closes odoo/documentation#4562

X-original-commit: de095cc4ad
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-26 17:29:32 +02:00
“Dallas” 4566a8ec30 [IMP] accounting: update epc qr code
task-3336175

closes odoo/documentation#4545

X-original-commit: fd23308e93
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Signed-off-by: Dean Dallas (dade) <dade@odoo.com>
2023-05-26 16:15:51 +02:00
Olivier Dony 57e2f90924 [FIX] legal: add pt_BR translation of OEEL
Courtesy of LANA :)

closes odoo/documentation#4552

X-original-commit: a718922b0c
Signed-off-by: Olivier Dony (odo) <odo@odoo.com>
2023-05-26 11:40:39 +02:00
Olivier Dony d7324b6950 [FIX] legal: rename pt_BR + build PDF version
X-original-commit: 0df79a70e0
Part-of: odoo/documentation#4552
2023-05-26 11:40:39 +02:00
jopa-odoo c2cfc63466 [ADD] Legal: Portuguese (Brasil) translation of Odoo Enterprise Agreement
X-original-commit: 966bade927
Part-of: odoo/documentation#4552
2023-05-26 11:40:39 +02:00
“Chiara 3894c41631 [IMP] accounting: fiscal position update
task-3272939

closes odoo/documentation#4532

X-original-commit: 440c18ca01
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
Signed-off-by: chiaraprattico <chpr@odoo.com>
2023-05-25 12:23:36 +02:00
Gauthier Wala (gawa) 99c1636974 [IMP] accounting: default taxes in taxes.rst
Since https://github.com/odoo/odoo/pull/115222, a new line on an invoice
won't have the default sales tax put on by default. If there are no
taxes on the product, the account or from predictive, the tax will stay
empty. Its use has been restricted back to the tax put on new products.
It is still used in Accounting Firms mode, as we don't want people
to have to input the product when quick encoding.

task-3045026

closes odoo/documentation#4533

X-original-commit: 768c2b231b
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-25 01:08:42 +02:00
Brandon Seltenrich (BRSE) 2a11aa8a82 [IMP] inventory: fix and update lots
closes odoo/documentation#4528

X-original-commit: 5bc3b94b61
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-05-24 18:17:46 +02:00
“Dallas” 76b013bbe3 [IMP] contributing: change gui abbreviation to lower case
closes odoo/documentation#4514

X-original-commit: 20972dc033
Signed-off-by: Dean Dallas (dade) <dade@odoo.com>
2023-05-24 15:45:29 +02:00
“Chiara 9783721529 [IMP] accounting: improve accounting concept
task-2846856

closes odoo/documentation#4520

X-original-commit: 4fc24468e4
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
Signed-off-by: chiaraprattico <chpr@odoo.com>
2023-05-24 08:39:37 +02:00
Tom Aarab (toaa) e7dad58064 [ADD] Sales: loyalty and discount programs
closes odoo/documentation#4474

X-original-commit: 04f67c0b3f
Signed-off-by: Melanie Nguyen (meng) <meng@odoo.com>
2023-05-23 16:31:55 +02:00
Tom Aarab (toaa) 93b9d802e7 [ADD] accounting: VAT units
task-2557013

16.0: Line 36 = "Create" --> "New"

closes odoo/documentation#4503

X-original-commit: 214ce3075c
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-05-23 14:52:19 +02:00
tiku-odoo a01bd25041 [IMP]Misc:SysParm-edits-email-doc
closes odoo/documentation#4494

X-original-commit: 9267ce21a5
Signed-off-by: Timothy Kukulka (tiku) <tiku@odoo.com>
2023-05-22 23:18:24 +02:00
Melanie Nguyen (meng) 9fcd175e58 [IMP] subscriptions: update subscription plans
closes odoo/documentation#4490

X-original-commit: 71024deb7b
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-05-22 22:10:44 +02:00
Brandon Seltenrich (BRSE) 863a04708c [IMP] inventory: update serial numbers doc
closes odoo/documentation#4486

X-original-commit: af4ad4cf4d
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-05-22 20:11:44 +02:00
Jonathan Castillo (jcs) 8553f68bb8 [MOV] accounting: restructuration of the accounting documentation
This commit improves the structure of the accounting documentation by
- reducing the levels necessary to reach the information
- grouping some docs
- moving content to their parent category page (content in all levels)
- renaming some sections to reflect the structure of the app better

task-3330093

closes odoo/documentation#4479

X-original-commit: c68cc154ed
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-22 11:43:14 +02:00
Olivier Dony 36d1e577fe [CHG] legal: partnership contract v11 (updated level requirements + clarifications) 2023-05-19 12:41:44 +02:00
Mathieu Duckerts-Antoine 70b69857e9 [IMP] abstract actions: adapt code after some legacy code removal
closes odoo/documentation#3722

Signed-off-by: Géry Debongnie <ged@odoo.com>
2023-05-17 14:46:58 +02:00
Mathieu Duckerts-Antoine b4ebef7d20 [IMP] gantt: adapt doc to last changes brought during owl conversion
Part-of: odoo/documentation#3722
2023-05-17 14:46:58 +02:00
Mathieu Duckerts-Antoine 1491cce9d6 [IMP] views: document attributes "class" and "js_class"
Part-of: odoo/documentation#3722
2023-05-17 14:46:58 +02:00
Jonathan Castillo (jcs) 16224865de [FIX] accounting: mark salt edge bank sync provider available worldwide
task-3329454

closes odoo/documentation#4446

Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-17 13:38:07 +02:00
Christophe Monniez 38b1d8c153 [FIX] requirements: bump libsass to match odoo
In Odoo, the libsass version was bumped to 0.20.1 in order to match the
Jammy version. As a consequence, in the Docker images on the runbot this
strange behavior was observed during the image build:

* the debian package is installed -> 0.20.1
* the documentation requirements are installed -> 0.18.0
* the odoo requirements are installed -> 0.20.1

This is useless and moreover, the final version used is the one from pip
instead of the Debian package.

closes odoo/documentation#4397

X-original-commit: dcc819469a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Christophe Monniez (moc) <moc@odoo.com>
2023-05-16 08:24:19 +02:00
Jess Rogers (jero) 129a8f33ed [IMP] helpdesk: update aftersales services
closes odoo/documentation#4438

X-original-commit: cbffc99b0f
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-05-15 23:31:42 +02:00
Jonathan Castillo (jcs) f8bcfcb83a [REM] accounting: remove page about purchase receipts
Sale and purchase receipts aren't really useful anymore. However, they
are left in the app for corner cases and to avoid upgrade issues. Since
this page is already deprecated, it is best to remove it.

closes odoo/documentation#4434

X-original-commit: b3db7fdd48
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-15 18:50:24 +02:00
Tommy (tong) f71915e945 [ADD] accounting: add Hong Kong localisations
closes odoo/documentation#4309

Related: odoo/odoo#120050
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
2023-05-15 11:41:23 +02:00
Tom Aarab (toaa) 9556b85133 [IMP] accounting: follow-up reports
taskid-2057352.

Forward to master.

closes odoo/documentation#4390

X-original-commit: 767ee598ac
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-05-12 19:55:02 +02:00
CVDE-odoo 26f00581c4 [ADD] developer/howto: guide for theming
A complete guide on how to create a custom website theme for Odoo

closes odoo/documentation#4420

X-original-commit: 892fd3e2ac
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-12 08:17:09 +02:00
Melanie Nguyen (meng) 8460cbc372 [IMP] subscriptions: update product configuration
closes odoo/documentation#4419

X-original-commit: e650e86173
Signed-off-by: Melanie Nguyen (meng) <meng@odoo.com>
2023-05-12 08:17:06 +02:00
Antoine Vandevenne (anv) fd933208d3 [IMP] tutorials/getting_started: rework the environment setup guide
This commit replaces a big chunk of the instructions relative to the
environment setup with a reference to the equivalent steps listed in the
contribution guide. It also moves the content of the "Create your first
PR" section from chapter 16 to chapter 2, as readers were struggling
with the Git configuration required to push their work to GitHub as they
progressed through the tutorial.

closes odoo/documentation#4413

X-original-commit: 26e12696c1
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-05-11 18:25:41 +02:00
Jess Rogers (jero) bf294f37cc [IMP] helpdesk: updated 16.0 reporting doc
closes odoo/documentation#4409

X-original-commit: 84390f4461
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-05-11 16:01:22 +02:00
Loredana Perazzo b29ced49c5 [IMP] pos: note about businesses requirements to use Adyen
task-3251524

closes odoo/documentation#4372

X-original-commit: 6740ad7811
Signed-off-by: Perazzo Loredana (lrpz) <lrpz@odoo.com>
2023-05-11 13:55:09 +02:00
Ahmed Elhadi 76904fe8fa [IMP] sales: Update different_addresses.rst
closes odoo/documentation#4384

X-original-commit: 2d630dffb6
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-05-10 21:18:06 +02:00
Xavier 60133f01dd [IMP] upgrade: clarify and update the SLA section
task-3300955

closes odoo/documentation#4365

X-original-commit: 8763fef3f7
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
2023-05-09 06:08:01 +02:00
Loredana Perazzo 5736d332d2 [IMP] pos: correct a typo in note
task-3296759

closes odoo/documentation#4363

X-original-commit: 89a1a95a2b
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
Signed-off-by: Perazzo Loredana (lrpz) <lrpz@odoo.com>
2023-05-09 06:07:56 +02:00
“Audrey d30c04ba6a [ADD] website: cookies bar
Task ID: 3297795

closes odoo/documentation#4349

X-original-commit: 3fbe44b49d
Related: odoo/odoo#120718
Signed-off-by: auva-odoo <auva@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-05 21:36:23 +02:00
Xavier 2472f29e32 [IMP] studio: add a note about duplicating standard reports
Task ID: 3301013

closes odoo/documentation#4342

X-original-commit: af93e6532d
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
2023-05-05 08:06:08 +02:00
Sam Lieber (sali) 64ca4e915c [IMP] inventory: delivery orders and incoming shipments restructure
closes odoo/documentation#4336

X-original-commit: bea00ecb40
Related: odoo/odoo#120535
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-05-04 21:32:29 +02:00
John Holton (hojo) 92110f5948 [ADD] Inventory: add create second warehouse
closes odoo/documentation#4329

X-original-commit: f2c1cb228a
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-05-03 06:25:14 +02:00
Jonathan Castillo (jcs) e10b927f08 [ADD] UAE localization
closes odoo/documentation#4314

Taskid: 2906051
X-original-commit: eea4029a33
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
2023-05-02 18:06:56 +02:00
Melanie Nguyen (meng) 2d87962b37 [ADD] subscriptions: add ecommerce configuration
closes odoo/documentation#4308

X-original-commit: 591532ecca
Signed-off-by: Melanie Nguyen (meng) <meng@odoo.com>
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-05-02 15:59:07 +02:00
tiku-odoo da79ee1c06 [IMP]Maintain:Fix typo in Azure Mail
closes odoo/documentation#4287

X-original-commit: d2e6c1d647
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-05-02 14:47:21 +02:00
Timothy Kukulka (tiku) 5683287892 [IMP] Google Oauth Docs edits final review
closes odoo/documentation#4303

X-original-commit: 5b63bfcba9
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-30 20:08:49 +02:00
Melanie Nguyen (meng) 09ce44f314 [IMP] sales: update customer addresses
closes odoo/documentation#4293

X-original-commit: 07249080ca
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-28 17:22:55 +02:00
Brandon Seltenrich (BRSE) 819864f0c2 [IMP] purchase: split purchase agreements docs
closes odoo/documentation#4290

X-original-commit: a217787ad3
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-04-28 16:04:41 +02:00
Antoine Vandevenne (anv) 8c29d1fd6a [FIX] reference/services: mark optional the params parameter of rpc
closes odoo/documentation#4282

X-original-commit: c1b38dc1f3
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-27 18:25:21 +02:00
Antoine Vandevenne (anv) b1a76aec63 [IMP] tutorials/js_framework: reword, clarify and improve instructions
X-original-commit: b58dbb1fbb
Part-of: odoo/documentation#4282
2023-04-27 18:25:21 +02:00
Antoine Vandevenne (anv) 08f472ef28 [IMP] tutorials/js_framework: freeze GitHub links with line numbers
A few links were already outdated. Either the referenced code was no
longer on the same line, or the file didn't exist anymore.

This commit freezes all links targeting a specific line on the odoo/odoo
repository by selecting a specific commit.

X-original-commit: 6e746c851f
Part-of: odoo/documentation#4282
2023-04-27 18:25:20 +02:00
Antoine Vandevenne (anv) d90e09c8b7 [IMP] tutorials/js_framework: retarget links to the current major branch
Commits pushed on the odoo/tutorials repository are not automatically
forward-ported, which makes it cumbersome to keep all SaaS branches up
to date.

Because of this, and because Odoo developers are very unlikely to follow
tutorials specific to a SaaS branch, links to odoo/tutorials now target
the current major branch, or master if applicable. SaaS branches have
also been deleted from the odoo/tutorials repository.

X-original-commit: ce14b2cfb5
Part-of: odoo/documentation#4282
2023-04-27 18:25:20 +02:00
Sam Lieber (sali) 446ecbfc39 [REF] surveys: remove overview folder
closes odoo/documentation#4276

X-original-commit: 50824b6677
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-26 12:44:44 +02:00
Brandon Seltenrich (BRSE) 1f50e937d5 [IMP] inventory: update stock_warehouses
closes odoo/documentation#4269

X-original-commit: 31889ddc3b
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-26 02:03:33 +02:00
Jonathan 918766abe1 [IMP] contributing/dev: add cd command to the git config section
closes odoo/documentation#4259

X-original-commit: 817e332160
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-25 14:07:43 +02:00
Jess Rogers (jero) 3a124f000c [IMP] helpdesk: update ratings doc
closes odoo/documentation#4252

X-original-commit: 6c6f2398dd
Signed-off-by: Jessica Rogers (jero) <jero@odoo.com>
2023-04-25 14:07:27 +02:00
Géry Debongnie adb845eb17 [IMP] developer/tutorials: separate js framework tutorial in two parts
This commit splits the 7 chapters of the JS tutorial in two
smaller and more focused tutorials:
- a basic one (Discover the JS framework)
- and an advanced one (Master the odoo web framework)

closes odoo/documentation#4248

X-original-commit: b6b9de70d2
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-25 11:22:48 +02:00
Leonardo Pavan Rocha fe2111ccbf [IMP] web: add quick_create_form_view_id attribute
In https://github.com/odoo/odoo/pull/114827, a new attribute was added in
calendar views to allow passing the id of a form view that is used internally
in the calendar module to show a different form view when quick_creating an
event.

task-3129030

closes odoo/documentation#4221

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2023-04-24 18:26:01 +02:00
Jonathan 27647fcb38 [MOV] pos: restructuration of pos toctree
task-3284514

+ update of access pos settings + + update menu button + cash register
Task-3256407

closes #4212

closes odoo/documentation#4242

X-original-commit: f851ea0e0a
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Co-authored-by: Jonathan Castillo <jcs@odoo.com>
Co-authored-by: Loredana Perazzo <lrpz@odoo.com>
2023-04-22 18:41:10 +02:00
KC (ksc) 6d25f69513 [ADD] social marketing: added social marketing documentation to v14
closes odoo/documentation#4235

X-original-commit: 42148acbec
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-22 06:54:02 +02:00
Artygo8 ef4c3555bc [IMP] reference/extract: update documentation
task-3071317

closes odoo/documentation#4224

X-original-commit: 07eef81a95
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Arthur Gossuin (goa) <goa@odoo.com>
2023-04-22 06:53:41 +02:00
Jonathan 56cf4288c7 [FIX] website: missing redirection for plausible.rst
The redirection rule for plausible.rst was missing from the forward-port
in PR #4107. Because of that, a link in the app leads to a 404 page
instead of the appropriate doc page. This commit fixes it.

closes odoo/documentation#4216

X-original-commit: b40fd5b284
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-19 23:41:42 +02:00
Zuzanna Luczynska 1fddd2cd67 [IMP] field service: default warehouse
task-2948598

closes odoo/documentation#4208

X-original-commit: 3ae4fbab84
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-19 21:58:42 +02:00
Rémy Voet (ryv) 584e44396b [ADD] add documentation about Model._read_group
task-3001022

odoo/odoo#110737

closes odoo/documentation#4064

Related: odoo/enterprise#38639
Signed-off-by: Rémy Voet <ryv@odoo.com>
2023-04-19 21:58:12 +02:00
John Holton (hojo) f4bc10e4b0 [ADD] Maintenance: add new equipment
closes odoo/documentation#4203

X-original-commit: eb067d6dc1
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-19 00:37:56 +02:00
Julien Van Roy 67ddab9fbc [IMP] accounting: send and print workflow in electronic_invoicing
From saas-16.2, the choice of the format can be made from the partner
form view (for the formats present in `account_edi_ubl_cii` only). And
the attachment are generated during the Send & Print flow.

PR to select the EDI format based on the partner:
https://github.com/odoo/odoo/pull/115934

PR refactoring the Send & Print flow:
https://github.com/odoo/odoo/pull/111857

closes odoo/documentation#4197

X-original-commit: 2e9789e436
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-18 23:35:19 +02:00
Jonathan 53aa00c871 [IMP] fiscal localizations: configuration
task-3277592

closes odoo/documentation#4195

X-original-commit: 5ce77e9fc7
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-18 09:24:47 +02:00
Mahmoud Metwally d69383d7ae [FW][FIX] howtos/company: fix typos
closes odoo/documentation#4183

Forward-port-of: odoo/documentation#4147
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-17 18:01:15 +02:00
Zuzanna Luczynska f9e15dffd5 [MOV] field service: improve the structure and merge docs
Currently, there are two pages about onsite interventions in two
separate categories. This task aims to merge both pages into a single
one and remove the useless categories.

task-3275322

closes odoo/documentation#4192

X-original-commit: 151e0554fa
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-15 14:54:55 +02:00
hapa-odoo 4b15e67358 [ADD] fiscal localizations: Indian GST service
In this commit, I have added documentation for GST return filing.
I have explained how to register on GST Portal, configure it in odoo,
and enable GST API Access on GST Portal. I have also explained different
GSTR Report.

task-3272960

closes odoo/documentation#4172

X-original-commit: 5280cb147e
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-15 13:57:52 +02:00
Elisabeth Dickinson f9f2785d9c [IMP] odoo_theme: fix menu links
When searching for a word, if that word happens to be in the menu, the
`display-flex` on the `a` would remove the space around the word because
a `span class=highlight` gets added around it.
Fixed by changing `display-flex` on the `a` to display-block (but
keeping it for `.o_toc_entry_wrapper`)

closes odoo/documentation#4185

X-original-commit: c758071861
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-14 19:45:57 +02:00
Julien Van Roy 0f0144abf8 [IMP] accounting/electronic_invoicing: add SG einvoicing format
Since commit
https://github.com/odoo/odoo/commit/bd06decccfffa5629c21c41a80280b6f84884bae,
the 'SG BIS Billing 3.0' format is available for singaporean companies.

closes odoo/documentation#4166

X-original-commit: 875d5ea61f
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-14 11:49:35 +02:00
Mahmoud Metwally 3117592e26 [FW][FIX] developer/web_services: fix typo
closes odoo/documentation#4160

Forward-port-of: odoo/documentation#4146
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-14 11:49:17 +02:00
Julien Van Roy e4ab323e9e [IMP] accounting/electronic_invoicing: remove useless section
In previous versions (from 14.0 to saas-15.4), `account_edi_ubl_cii` was
not auto-installed. From 16.0, it is. Thus, we no longer need the
section advising to install this module.

Manifest in saas-15.4:
https://github.com/odoo/odoo/blob/saas-15.4/addons/account_edi_ubl_cii/__manifest__.py
Manifest in 16.0:
https://github.com/odoo/odoo/blob/16.0/addons/account_edi_ubl_cii/__manifest__.py

closes odoo/documentation#4163

X-original-commit: 136187f0fb
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-14 10:45:06 +02:00
Martin Trigaux 62a362f30a [I18N] *: export source terms
closes odoo/documentation#4150

X-original-commit: d53ba8c7e2
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2023-04-13 17:57:26 +02:00
wangting 9fb8c5c354 [FIX] tutorials/js_framework: fix typo
closes odoo/documentation#4148

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-13 16:40:41 +02:00
Martin Trigaux 1e39949363 [IMP] reference: update markup documentation
closes odoo/documentation#3612

Related: odoo/odoo#111850
Related: odoo/enterprise#36728
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2023-04-13 16:39:45 +02:00
Brandon Seltenrich (BRSE) afe0282420 [IMP] inventory: update owned_stock
closes odoo/documentation#4143

X-original-commit: 1289a9ec45
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
2023-04-13 05:07:57 +02:00
Loan (LSE) 74f4204857 [IMP] iot: add documentation regarding HTTPS certificate
Also include details/troubleshoot/solutions for redundant
support issues:
 - Error code details for HTTPS certificate generation
   (see: https://github.com/odoo/odoo/pull/114993 )
 - DNS issue with HTTPS domain

 OPW-3227004

closes odoo/documentation#4137

X-original-commit: 6f4822cb2b
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-13 05:07:52 +02:00
Elisabeth Dickinson 81d1f2d21b [IMP] odoo_theme: design improvements
Revamp of the side menu;
Round all borders for consistency with the buttons;
Improve .sig-* and .o_code elements;
Improve sphinx-tabs hover effect;

task-3046383

closes odoo/documentation#4114

X-original-commit: 3056c7b62d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-12 12:26:14 +02:00
Elisabeth Dickinson 9dc32cdd4e [IMP] odoo_theme: general cleanup
A general reorganization of the code was needed for more clarity.
The different markup styles have been grouped together under a common
"chapter", comments have been rewritten and example pages have been
added for context.

Some levels have been removed Where there were too many for no reason.
By removing one level of styles (e.g.: `#wrap`) we avoid needing to
force overrides or adding `!important` to our code.
⌙ e.g.: before commit 9ef86cd93d8c6fc0fd96b437f629237e7a562c6e,
`.o_spoilers .accordion-body >:first-child` was being involuntarily
overridden.

task-3046383

X-original-commit: 620e3c33ef
Part-of: odoo/documentation#4114
2023-04-12 12:26:14 +02:00
Antoine Vandevenne (anv) febf7c4188 [IMP] odoo_theme: tweak the HTML structure of TOC entries
task-3046383

X-original-commit: 877d1de3c2
Part-of: odoo/documentation#4114
2023-04-12 12:26:14 +02:00
Antoine Vandevenne (anv) 71f3ea88bd [IMP] extensions/custom_admonitions: tweak the HTML structure of dfn
The structure of the `dfn` role is changed from its default
`<em class="dfn">text</em>` to
`<span class="dfn"><span>text</span></span>` to ease the styling.

task-3046383

X-original-commit: 281a893540
Part-of: odoo/documentation#4114
2023-04-12 12:26:13 +02:00
Jonathan Castillo (jcs) ad4e8e649a [MOV] calendar: "Calendar" app from "Misc" to "Productivity"
To improve the structure of the documentation, the "Miscellaneous"
section should be limited as much as possible.

This commit:
- renames "Calendars" into "Calendar" (as the app name)
- moves the app from the "Miscellaneous" section to the "Productivity"
  section
- fixes the wrong file structure to follow the toc
  (e.g. general/calendars/outlook/outlook_calendar -> productivity/calendar/outlook)

task-3217827

closes odoo/documentation#4128

X-original-commit: 3d2c5d7c16
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-12 08:05:50 +02:00
Jonathan Castillo (jcs) 5cfec84463 [MOV] live chat: structure
task-3269837

closes odoo/documentation#4129

X-original-commit: 1685449f61
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-12 07:07:47 +02:00
Jonathan Castillo (jcs) 59066fed29 [MOV] website: structure
As a first step to update the doc - at last! - we first need to update
its structure.

task-3269837

X-original-commit: 180963cd89
Part-of: odoo/documentation#4129
2023-04-12 07:07:46 +02:00
fvz-odoo eabb865415 [l10n_mx] Update exempt tax configuration.
In Mexico there are two 0% taxes, 0% VAT and 0% exempt VAT. This change
makes the tip clearer so users do not confuse both taxes. Forward to
master.

closes odoo/documentation#4120

X-original-commit: 5ef339fe82
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-11 19:48:38 +02:00
Jess Rogers (jero) e4624b9fdb [IMP] helpdesk: update ticket closing
closes odoo/documentation#4104

X-original-commit: a1b86849b7
Signed-off-by: Jessica Rogers (jero) <jero@odoo.com>
2023-04-11 18:49:34 +02:00
Victor Feyens b5140e2d22 [ADD] tests: image size checker
closes odoo/documentation#4100

X-original-commit: 380a5499de
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-11 15:17:26 +02:00
Brandon Seltenrich (BRSE) 4314b73e2c [IMP] purchase: update bill control policies doc
closes odoo/documentation#4094

X-original-commit: c59db7d9f8
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-11 01:35:58 +02:00
John Holton (hojo) 46881ee8fb [IMP] Inventory: Update dropshipping
closes odoo/documentation#4082

X-original-commit: bbbca62f6f
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-10 23:07:48 +02:00
John Holton (hojo) e445c1117b [ADD] Quality: add Create quality alerts
closes odoo/documentation#4090

X-original-commit: 1b640a7a30
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-10 22:10:54 +02:00
Jonathan Castillo (jcs) 6b4bc0b680 [IMP] subscriptions: overhaul of the basic docs
This commit improves the structure of the Subscription doc and updates
its content (recurring products, subscription plans, sales flow)

task-3222232

closes odoo/documentation#4070

X-original-commit: 878fc0e21f
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
Co-authored-by: Xavier Platteau <xpl@odoo.com>
Co-authored-by: Tom Aarab <toaa@odoo.com>"
2023-04-08 13:40:25 +02:00
Sam Lieber (sali) cd55555d79 [IMP] purchase: update reordering rules config doc
closes odoo/documentation#4076

X-original-commit: 728a462762
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-08 05:27:49 +02:00
Jess Rogers (jero) c44801c718 [IMP] helpdesk: updated sla policies
closes odoo/documentation#4069

X-original-commit: 401a19fcdc
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-08 00:54:56 +02:00
“Chiara 2eafd205de [IMP] accounting: update batch payments
closes odoo/documentation#4058

X-original-commit: 67f10d3eca
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
Signed-off-by: chiaraprattico <chpr@odoo.com>
2023-04-06 13:51:59 +02:00
John Holton (hojo) 2c819a05c2 [IMP] Inventory: Update inter-warehouse replenishment
closes odoo/documentation#4046

X-original-commit: 6f6e018db4
Signed-off-by: John Holton (hojo) <hojo@odoo.com>
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-06 04:16:51 +02:00
KC (ksc) 6a597e2e94 [ADD] sms marketing: added essentials/getting started docs
closes odoo/documentation#4051

X-original-commit: e8ad53cead
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-04-06 03:15:42 +02:00
Jonathan Castillo (jcs) 03dc488290 [IMP] accounting: bank statements in the transactions page
task-3264491

closes odoo/documentation#4041

X-original-commit: 2d7a48a65e
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>
2023-04-05 23:25:15 +02:00
Melanie Nguyen (meng) 5c2e78c8a5 [FIX] crm: replace old lead scoring content with predictive lead scoring
closes odoo/documentation#4030

X-original-commit: 9f72036be8
Signed-off-by: Melanie Nguyen (meng) <meng@odoo.com>
2023-04-05 21:03:54 +02:00
Tiffany Chang (tic) ab1563e7c7 [REF] developer: rewrite sql view as a howto
SQL view was formerly part of the dashboard tutorial which is now
obsolete. Since creating a SQL view as a tutorial does not make sense
anymore, it has been converted into a simple howto.

closes odoo/documentation#4035

Task: 3226581
X-original-commit: 7124542ed9
Signed-off-by: Tiffany Chang <tic@odoo.com>
2023-04-05 17:31:58 +02:00
Tiffany Chang (tic) e18b24a176 [REM] developer: remove references to web_dashboard view
Since odoo/enterprise#31641 the dashboard view no longer exists since it
is now replaced with spreadsheet_dashboard, therefore we remove it from
the backend Views documentation.

Task: 3226581
X-original-commit: e2c880aafe
Part-of: odoo/documentation#4035
2023-04-05 17:31:58 +02:00
fdardenne 56a5b0480e [IMP] create JavaScript howtos
The JavaScript cheatsheet is outdated, we therefore remove it and
replace it by multiple howtos:

- Create a view from scratch
- Extending an existing view
- Create a field from scratch
- Extend an existing field
- Create a client action

There is other subjects to introduce as the web framework is big. Other
future contributions will cover them.

closes odoo/documentation#4020

X-original-commit: 7e4435deb8
Signed-off-by: Dardenne Florent (dafl) <dafl@odoo.com>
2023-04-05 13:57:53 +02:00
“Audrey 931920bc31 [IMP] payment_providers/flutterwave: recommend ticking all checkboxes
task-3254461

closes odoo/documentation#4023

X-original-commit: 0a384a2a35
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: auva-odoo <auva@odoo.com>
2023-04-05 09:42:34 +02:00
Tom Aarab (toaa) 2b784e9ec1 [ADD] ecommerce: performance monitoring
Adding a doc page on performance monitoring and analysis for eCommerce
websites

closes odoo/documentation#4019

Taskid: 3246984
X-original-commit: 4c623b69b1
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
2023-04-05 07:44:42 +02:00
luvi 5e248b7017 [IMP] web: Add core components documentation
This commit adds the documentation for core components that have
been improved or moved during the Studio refactor. Some new props
have been added, and the documentation is now present as expected.

Components involved:
- Notebook
- SelectMenu
- TagsList

closes odoo/documentation#4007

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-04 18:07:11 +02:00
kcv-odoo ff846cc48d [IMP] backend: add disable_linking option in cohort view
Related PR: https://github.com/odoo/enterprise/pull/37396

task-3186590

closes odoo/documentation#3646

Related: odoo/enterprise#37396
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-04-04 18:07:01 +02:00
Loredana Perazzo 41e1bda1cc [ADD] pos: how to add/modify customer notes from POS UI
Task ID: 2622090

closes odoo/documentation#4013

X-original-commit: 3a0e23f3f9
Signed-off-by: Platteau Xavier (xpl) <xpl@odoo.com>
Signed-off-by: Perazzo Loredana (lrpz) <lrpz@odoo.com>
2023-04-04 16:02:03 +02:00
1842 changed files with 61253 additions and 42881 deletions
+6 -2
View File
@@ -195,7 +195,7 @@ todo_include_todos = False
intersphinx_mapping = {
'pillow': ('https://pillow.readthedocs.io/en/stable/', None),
'python': ('https://docs.python.org/3/', None),
'werkzeug': ('https://werkzeug.palletsprojects.com/en/1.0.x/', None),
'werkzeug': ('https://werkzeug.palletsprojects.com/en/2.3.x/', None),
}
github_user = 'odoo'
@@ -213,6 +213,7 @@ sphinx.transforms.i18n.docname_to_domain = (
# is populated. If a version is passed to `versions` but is not listed here, it will not be shown.
versions_names = {
'master': "Master",
'saas-16.3': "Odoo Online",
'saas-16.2': "Odoo Online",
'saas-16.1': "Odoo Online",
'16.0': "Odoo 16",
@@ -317,13 +318,16 @@ latex_documents = [
'Odoo Enterprise Subscription Agreement (ES)', '', 'howto'),
('legal/terms/i18n/partnership_tex_es',
'odoo_partnership_agreement_es.tex', 'Odoo Partnership Agreement (ES)', '', 'howto'),
('legal/terms/i18n/enterprise_tex_pt_BR', 'odoo_enterprise_agreement_pt_BR.tex',
'Odoo Enterprise Subscription Agreement (PT)', '', 'howto'),
]
# List of languages that have legal translations (excluding EN). The keys must be in
# `languages_names`. These translations will have a link to their versions of the legal
# contracts, instead of the default EN one. The main legal documents are not part of the
# translations since they have legal meaning.
legal_translations = ['de', 'es', 'fr', 'nl']
legal_translations = ['de', 'es', 'fr', 'nl', 'pt_BR']
# The name of an image file (relative to this directory) to place at the top of the title page.
latex_logo = 'static/img/odoo_logo.png'
+5 -5
View File
@@ -43,7 +43,7 @@ Configuration samples
* Show only databases with names beginning with 'mycompany'
in ``/etc/odoo.conf`` set:
in :ref:`the configuration file <reference/cmdline/config_file>` set:
.. code-block:: ini
@@ -55,7 +55,7 @@ in ``/etc/odoo.conf`` set:
was sent to ``www.mycompany.com`` or ``mycompany.co.uk``, but not
for ``www2.mycompany.com`` or ``helpdesk.mycompany.com``.
in ``/etc/odoo.conf`` set:
in :ref:`the configuration file <reference/cmdline/config_file>` set:
.. code-block:: ini
@@ -150,7 +150,7 @@ Configuration sample
* with 'pwd' as a password
* filtering only db with a name beginning with 'mycompany'
in ``/etc/odoo.conf`` set:
in :ref:`the configuration file <reference/cmdline/config_file>` set:
.. code-block:: ini
@@ -238,7 +238,7 @@ Configuration sample
* We'll use 8 workers + 1 for cron. We'll also use a monitoring system to measure cpu load, and check if it's between 7 and 7.5 .
* RAM = 9 * ((0.8*150) + (0.2*1024)) ~= 3Go RAM for Odoo
in ``/etc/odoo.conf``:
in :ref:`the configuration file <reference/cmdline/config_file>`:
.. code-block:: ini
@@ -273,7 +273,7 @@ Configuration sample
* Redirect http requests to https
* Proxy requests to odoo
in ``/etc/odoo.conf`` set:
in :ref:`the configuration file <reference/cmdline/config_file>` set:
.. code-block:: ini
+7 -12
View File
@@ -282,14 +282,6 @@ SSH. If you do not know the difference between the two, the best option is most
are following the :doc:`Getting started </developer/tutorials/getting_started>` developer tutorial,
or plan on contributing to Odoo source code, choose SSH.
.. note::
**The Enterprise Git repository does not contain the full Odoo source code**. It is only a
collection of extra add-ons. The main server code is in the Community version. Running the
Enterprise version actually means running the server from the Community version with the
addons-path option set to the folder with the Enterprise version. You need to clone both the
Community and Enterprise repository to have a working Odoo Enterprise installation. See
:ref:`setup/install/editions` to get access to the Enterprise repository.
.. tabs::
.. group-tab:: Windows
@@ -351,7 +343,8 @@ or plan on contributing to Odoo source code, choose SSH.
collection of extra add-ons. The main server code is in the Community version. Running the
Enterprise version actually means running the server from the Community version with the
addons-path option set to the folder with the Enterprise version. You need to clone both the
Community and Enterprise repository to have a working Odoo Enterprise installation.
Community and Enterprise repository to have a working Odoo Enterprise installation. See
:ref:`setup/install/editions` to get access to the Enterprise repository.
.. _setup/install/source/prepare:
@@ -365,7 +358,7 @@ Python
.. group-tab:: Windows
Odoo requires Python 3.7 or later to run. Visit `Python's download page <https://www.python.org/downloads/windows/>`_
Odoo requires Python 3.8 or later to run. Visit `Python's download page <https://www.python.org/downloads/windows/>`_
to download and install the latest version of Python 3 on your machine.
During installation, check **Add Python 3 to PATH**, then click **Customize Installation** and make
@@ -387,7 +380,7 @@ Python
.. group-tab:: Linux
Odoo requires Python 3.7 or later to run. Use your package manager to download and install Python 3
Odoo requires Python 3.8 or later to run. Use your package manager to download and install Python 3
on your machine if it is not already done.
.. note::
@@ -406,7 +399,7 @@ Python
.. group-tab:: Mac OS
Odoo requires Python 3.7 or later to run. Use your preferred package manager (homebrew_, macports_)
Odoo requires Python 3.8 or later to run. Use your preferred package manager (homebrew_, macports_)
to download and install Python 3 on your machine if it is not already done.
.. note::
@@ -645,6 +638,8 @@ Dependencies
<the wkhtmltopdf download page_>`_ for it to support headers and footers. See our `wiki
<https://github.com/odoo/odoo/wiki/Wkhtmltopdf>`_ for more details on the various versions.
.. _setup/install/source/running_odoo:
Running Odoo
------------
@@ -13,7 +13,7 @@ personal email address or an address created by a custom domain.
.. seealso::
- :doc:`/applications/general/auth/azure`
- :doc:`/applications/general/calendars/outlook/outlook_calendar`
- :doc:`/applications/productivity/calendar/outlook`
Setup in Microsoft Azure Portal
===============================
@@ -47,7 +47,7 @@ API permissions
---------------
The :guilabel:`API permissions` should be set next. Odoo will need specific API permissions to be
able to read (IMAP) and send (IMAP) emails in the Microsoft 365 setup. First, click the
able to read (IMAP) and send (SMTP) emails in the Microsoft 365 setup. First, click the
:guilabel:`API permissions` link, located in the left menu bar. Next, click on the :guilabel:`(+)
Add a Permission` button and select :guilabel:`Microsoft Graph` under :guilabel:`Commonly Used
Microsoft APIs`. After, select the :guilabel:`Delegated Permissions` option.
@@ -71,7 +71,7 @@ way to verify the ownership of your domain name is by adding a DNS record. You c
other providers.
.. seealso::
- :doc:`/applications/websites/website/optimize/seo`
- :doc:`/applications/websites/website/pages/seo`
- `Google Search Console Help - Verify your site ownership <https://support.google.com/webmasters/answer/9008080>`_
- `Bing Webmaster Tools - Add and Verify site <https://www.bing.com/webmasters/help/add-and-verify-site-12184f8b>`_
@@ -1,9 +1,9 @@
.. _setup/enterprise:
===============================
Upgrade Community to Enterprise
===============================
===================================
Switch from Community to Enterprise
===================================
Depending on your current installation, there are multiple ways to upgrade
your community version.
@@ -98,7 +98,7 @@ On Windows
.. code-block:: console
$ odoo.exe -d <database_name> -i web_enterprise --stop-after-init
$ ..\python\python.exe odoo-bin -d <database_name> -i web_enterprise --stop-after-init
* No need to manually launch the server, the service is running.
You should be able to connect to your Odoo Enterprise instance using your usual
Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 39 KiB

@@ -13,7 +13,7 @@ email address or an address created by a custom domain.
.. seealso::
- :doc:`/applications/general/auth/google`
- :doc:`/applications/general/calendars/google/google_calendar_credentials`
- :doc:`/applications/productivity/calendar/google`
Setup in Google
===============
@@ -21,64 +21,87 @@ Setup in Google
Create a new project
--------------------
To get started, go to the `Google API Platform
<https://console.cloud.google.com/apis/credentials/consent>`_. Log in with your *Google Workspace*
account if you have one, otherwise log in with your personal Gmail account (this should match the
email address you want to configure in Odoo).
To get started, go to the `Google API Console <https://console.developers.google.com>`_. Log in
with your *Google Workspace* account if you have one, otherwise log in with your personal Gmail
account (this should match the email address you want to configure in Odoo).
After that, click on :guilabel:`Create Project`, located on the far right of the OAuth consent
screen. If a project has already been created in this account, then the :guilabel:`New Project`
option will be located on the top left under the :guilabel:`Select a project` drop-down menu.
After that, click on :guilabel:`Create Project`, located on the far right of the :guilabel:`OAuth
consent screen`. If a project has already been created in this account, then the :guilabel:`New
Project` option will be located on the top right under the :guilabel:`Select a project` drop-down
menu.
On the :guilabel:`New Project` screen, rename the :guilabel:`Project name` to `Odoo` and browse for
the :guilabel:`Location`. Set the :guilabel:`Location` as the `Google Workspace` organization. If
you are using a personal Gmail account, then leave the :guilabel:`Location` as `No Organization`.
On the :menuselection:`New Project` screen, rename the :guilabel:`Project name` to `Odoo` and
browse for the :guilabel:`Location`. Set the :guilabel:`Location` as the *Google Workspace
organization*. If you are using a personal Gmail account, then leave the :guilabel:`Location` as
:guilabel:`No Organization`.
.. image:: google_oauth/new-project.png
:align: center
:alt: Project Name and Location for Google Oauth.
:alt: Project Name and Location for Google OAuth.
Click on :guilabel:`Create` to finish this step. On the next screen, :guilabel:`User Type` options,
select the :guilabel:`External` option, and then click on :guilabel:`Create` again, which will
finally navigate to the :guilabel:`Edit app registration` page.
Click on :guilabel:`Create` to finish this step.
OAuth consent screen
--------------------
If the page doesn't redirect to the :menuselection:`User Type` options, click on :guilabel:`OAuth
consent screen` in the left menu.
Under :guilabel:`User Type` options, select the appropriate :guilabel:`User Type`, and then click on
:guilabel:`Create` again, which will finally navigate to the :menuselection:`Edit app registration`
page.
.. warning::
*Personal* Gmail Accounts are only allowed to be **External** User Type, which means Google may
require an approval, or for *Scopes* to be added on. However, using a *Google WorkSpace* account
allows for **Internal** User Type to be used.
Note, as well, that while the API connection is in the *External* testing mode, then no approval is
necessary from Google. User limits in this testing mode is set to 100 users.
Edit app registration
---------------------
- On the :guilabel:`Oauth consent screen` step, under the :guilabel:`App information` section,
enter `Odoo` in the :guilabel:`App name` field. Select the organization's email address under the
:guilabel:`User support` email field.
- Next, under :menuselection:`App Domain --> Authorized domains`, click on :guilabel:`Add Domain`
and enter `odoo.com`.
- After that, under the :guilabel:`Developer contact information` section, enter the organization's
email address. Google uses this email address to notify the organization about any changes to
your project.
- Next, click on the :guilabel:`Save and Continue` button.
- Then, skip the :guilabel:`Scopes` page by scrolling to the bottom and clicking on
:guilabel:`Save and Continue`.
- Next, add the email being configured under the :guilabel:`Test users` step by clicking on
:guilabel:`Add Users` and then the :guilabel:`Save and Continue` button. A summary of the
:guilabel:`App registration` appears.
- Finally, scroll to the bottom and click on :guilabel:`Back to Dashboard`.
Next we will configure the app registration of the project.
On the :guilabel:`OAuth consent screen` step, under the :guilabel:`App information` section, enter
`Odoo` in the :guilabel:`App name` field. Select the organization's email address under the
:guilabel:`User support` email field.
Next, under :menuselection:`App Domain --> Authorized domains`, click on :guilabel:`Add Domain` and
enter `odoo.com`.
After that, under the :guilabel:`Developer contact information` section, enter the organization's
email address. Google uses this email address to notify the organization about any changes to your
project.
Next, click on the :guilabel:`Save and Continue` button. Then, skip the :menuselection:`Scopes` page
by scrolling to the bottom and clicking on :guilabel:`Save and Continue`.
If continuing in testing mode (External), add the email addresses being configured under the
:guilabel:`Test users` step, by clicking on :guilabel:`Add Users`, and then the :guilabel:`Save and
Continue` button. A summary of the app registration appears.
Finally, scroll to the bottom and click on :guilabel:`Back to Dashboard` to finish setting up the
project.
Create Credentials
------------------
Now that you have set up the project, you need to create credentials, which includes the
:guilabel:`Client ID` and :guilabel:`Client Secret`. First, click on :guilabel:`Credentials` in the
left sidebar menu.
Now that the project is set up, credentials should be created, which includes the *Client ID* and
*Client Secret*. First, click on :guilabel:`Credentials` in the left sidebar menu.
Then, click on :guilabel:`Create Credentials` in the top menu and select
:guilabel:`OAuth client ID` from the dropdown menu.
Then, click on :guilabel:`Create Credentials` in the top menu and select :guilabel:`OAuth client ID`
from the dropdown menu.
- Under :guilabel:`Application Type`, select :guilabel:`Web Application` from the dropdown menu.
- In the :guilabel:`Client ID` field, enter `Odoo`.
- In the :guilabel:`Name` field, enter `Odoo`.
- Under the :guilabel:`Authorized redirect URIs` label, click the button :guilabel:`ADD URI`, and
then input `https://yourdbname.odoo.com/google_gmail/confirm` in the :guilabel:`URIs 1` field. Be
sure to replace the *yourdbname* part of the URL with your actual Odoo database name.
- Next, click on :guilabel:`Create` to generate an OAuth :guilabel:`Client ID` and
:guilabel:`Client Secret`. Finally, copy each generated value for later use when configuring in
Odoo, and then navigate to the Odoo database.
then input `https://yourdbname.odoo.com/google_gmail/confirm` in the :guilabel:`URIs 1` field.
Be sure to replace the *yourdbname* part of the URL with the actual Odoo database name.
- Next, click on :guilabel:`Create` to generate an OAuth :guilabel:`Client ID` and :guilabel:`Client
Secret`. Finally, copy each generated value for later use when configuring in Odoo, and then
navigate to the Odoo database.
.. image:: google_oauth/client-credentials.png
:align: center
@@ -91,32 +114,37 @@ Enter Google Credentials
------------------------
First, open Odoo and navigate to the :guilabel:`Apps` module. Then, remove the :guilabel:`Apps`
filter from the search bar and type in `Google`. Install the module called :guilabel:`Google Gmail`.
filter from the search bar and type in `Google`. Install the module called :guilabel:`Google
Gmail`.
Next, navigate to :menuselection:`Settings --> General Settings`, and under the :guilabel:`Discuss`
section, ensure that the checkbox for :guilabel:`Custom Email Servers` is checked. This populates a
new option for :guilabel:`Gmail Credentials`. Then, copy and paste the :guilabel:`Client ID` and
:guilabel:`Client Secret` into the respective fields and :guilabel:`Save` the settings.
section, ensure that the checkbox for :guilabel:`Custom Email Servers` or :guilabel:`External Email
Servers` is checked. This populates a new option for :guilabel:`Gmail Credentials` or :guilabel:`Use
a Gmail Sever`. Then, copy and paste the respective values into the :guilabel:`Client ID` and
:guilabel:`Client Secret` fields and :guilabel:`Save` the settings.
Configure outgoing email server
-------------------------------
After that, on the :guilabel:`General Settings` page, under :guilabel:`Custom Email Servers`, click
:guilabel:`Outgoing Email Servers` to configure the external Gmail account.
To configure the external Gmail account, return to the top of the :guilabel:`Custom Email Servers`
setting and then click the :guilabel:`Outgoing Email Servers` link.
.. image:: google_oauth/outgoing-servers.png
:align: center
:alt: Configure Outgoing Email Servers in Odoo.
Then, :guilabel:`Create` a new email server and select the option for :guilabel:`Gmail`. Next, fill
in the :guilabel:`Description` (can be anything) and the email :guilabel:`Username` and click on
:guilabel:`Connect your Gmail account`.
Then, click on :guilabel:`New` or :guilabel:`Create` to create a new email server, and fill in the
:guilabel:`Name`, :guilabel:`Description`, and the email :guilabel:`Username` (if required).
A new window from :guilabel:`Google` opens to complete the authorization process. Select the
Next, click on :guilabel:`Gmail OAuth Authentication` or :guilabel:`Gmail` (under the
:guilabel:`Authenticate with` or :guilabel:`Connection` section). Finally, click on
:guilabel:`Connect your Gmail Account`.
A new window labeled :guilabel:`Google` opens to complete the authorization process. Select the
appropriate email address that is being configured in Odoo.
If the email address is a personal account, an extra step pops up, click :guilabel:`Continue` to
allow the verification and connect the Gmail account to Odoo.
If the email address is a personal account, then an extra step pops up, so click
:guilabel:`Continue` to allow the verification and connect the Gmail account to Odoo.
Then, allow Odoo to access the Google account by clicking on :guilabel:`Continue` or
:guilabel:`Allow`. After that, the page navigates back to the newly configured outgoing email
@@ -127,9 +155,8 @@ server in Odoo. The configuration automatically loads the token in Odoo, and a t
:align: center
:alt: Configure Outgoing Email Servers in Odoo.
Finally, save the settings and :guilabel:`Test the Connection`. A confirmation message should
appear. The Odoo database can now send safe, secure emails through Google using OAuth
authentication.
Finally, :guilabel:`Test the Connection`. A confirmation message should appear. The Odoo database
can now send safe, secure emails through Google using OAuth authentication.
Google OAuth FAQ
================
@@ -137,8 +164,8 @@ Google OAuth FAQ
Production VS Testing Publishing Status
---------------------------------------
Choosing :guilabel:`Production` as the :guilabel:`Publishing Status` (instead of Testing) will
display the following warning message:
Choosing :guilabel:`Production` as the :guilabel:`Publishing Status` (instead of
:guilabel:`Testing`) will display the following warning message:
.. image:: google_oauth/published-status.png
:align: center
@@ -158,39 +185,35 @@ populate.
:align: center
:alt: 403 Access Denied Error.
To correct this error, return to the :guilabel:`OAuth consent screen` under
:guilabel:`APIs & Services` and add test user(s) to the app. Add the email that you are configuring
in Odoo.
To correct this error, return to the :guilabel:`OAuth consent screen` under :guilabel:`APIs &
Services` and add test user(s) to the app. Add the email that you are configuring in Odoo.
Gmail Module not updated
------------------------
If the :guilabel:`Gmail Module` in Odoo has not been updated to the latest version, then a
If the *Google Gmail* module in Odoo has not been updated to the latest version, then a
:guilabel:`Forbidden` error message populates.
.. image:: google_oauth/forbidden-error.png
:align: center
:alt: Forbidden you don't have the permission to access the requested resource.
To correct this error, go to the :guilabel:`Apps` module and clear out the search terms. Then,
search for `Gmail` or `Google` and upgrade the :guilabel:`Google Gmail` module. Finally, click on
the three dots on the upper right of the module and select :guilabel:`Upgrade`.
To correct this error, go to the :menuselection:`Apps` module and clear out the search terms. Then,
search for `Gmail` or `Google` and upgrade the :guilabel:`Google Gmail` module. Finally, click
on the three dots on the upper right of the module and select :guilabel:`Upgrade`.
Application Type
----------------
When creating the :guilabel:`Credentials` (OAuth Client ID and Client Secret), if
:guilabel:`Desktop App` is selected for the :guilabel:`Application Type`, an
:guilabel:`Authorization Error` appears.
When creating the credentials (OAuth *Client ID* and *Client Secret*), if :guilabel:`Desktop App` is
selected for the :guilabel:`Application Type`, an :guilabel:`Authorization Error` appears.
.. image:: google_oauth/error-400.png
:align: center
:alt: Error 400 Redirect URI Mismatch.
To correct this error, delete the credentials already created and create new credentials, selecting
:guilabel:`Web Application` for the :guilabel:`Application Type`. Then, under
:guilabel:`Authorized redirect URIs`, click :guilabel:`ADD URI` and type:
`https://yourdbname.odoo.com/google_gmail/confirm` in the field.
.. note::
Replace *yourdbname* in the URL with the Odoo database name.
:guilabel:`Web Application` for the :guilabel:`Application Type`. Then, under :guilabel:`Authorized
redirect URIs`, click :guilabel:`ADD URI` and type:
`https://yourdbname.odoo.com/google_gmail/confirm` in the field, being sure to replace *yourdbname*
in the URL with the Odoo database name.
+45 -68
View File
@@ -2,25 +2,15 @@
Odoo Online database management
===============================
To manage a database, sign in to https://www.odoo.com and access the `database management page
<https://www.odoo.com/my/databases>`_ by clicking on the user icon, then on
:guilabel:`My Databases`.
To manage a database, go to the `database manager <https://www.odoo.com/my/databases>`_ and sign in
as the database administrator.
.. image:: odoo_online/my-databases.png
:align: center
:alt: Clicking on the user icon opens a drop-down menu. "My databases" button is highlighted.
All the main database management options are available by clicking the database name, except the
upgrade option, which can be accessed by clicking the **arrow in a circle** icon next to the
database name. It is only displayed if an upgrade is available.
.. note::
Make sure to connect as the administrator of the database that changes will be made on.
.. image:: odoo_online/dropdown-menu.png
:align: right
:alt: Clicking on the gear icon opens the drop-down menu.
Open the drop-down menu next to the database that changes will be made on by clicking on the gear
icon.
Several actions are available:
.. image:: odoo_online/database-manager.png
:alt: Accessing the database management options
- :ref:`odoo_online/upgrade`
- :ref:`odoo_online/duplicate`
@@ -37,39 +27,24 @@ Several actions are available:
Upgrade
=======
If the database is *not* on the latest **Online version**, the administrator should receive an
invitation to :doc:`upgrade <../upgrade>` the database. A :guilabel:`Rolling Release`` button on the
database's main screen proposes an upgrade to the latest version (e.g., 14.0 to 16.1).
.. important::
- | **If the Odoo database's version is lower than the latest major release:**
| The database must be upgraded within two months. After these two months, an automatic
upgrade is initiated.
- | **If the Odoo database's version is equal to or higher than the latest major release:**
| Disregard the invitation to upgrade as the database probably wouldn't benefit from new
features every two months.
.. note::
Versions that are not supported anymore become deprecated and need to be updated to avoid
security issues. Odoo recommends that the company initiate the upgrade, as this method allows for
the company to request a test upgrade of the database to check for any discrepancies.
Trigger a database upgrade.
.. seealso::
- :doc:`../upgrade`
- :doc:`supported_versions`
For more information about the upgrade process, check out the :doc:`Odoo Online upgrade
documentation <../upgrade/odoo_online>`.
.. _odoo_online/duplicate:
Duplicate
=========
This allows to make an exact copy of the database to be able to perform testing without compromising
the daily operations.
Create an exact copy of the database, which can be used to perform testing without compromising
daily operations.
.. important::
- By checking :guilabel:`For testing purposes`, all external communication (emails, payments,
delivery orders, etc.) are disabled by default on the duplicated database.
- Duplicate databases expire automatically after 15 days.
- By checking :guilabel:`For testing purposes`, all external actions (emails, payments, delivery
orders, etc.) are disabled by default on the duplicated database.
- Duplicated databases expire automatically after 15 days.
.. _odoo_online/rename:
@@ -83,28 +58,31 @@ Rename the database and its URL.
Download
========
Instantly download a ZIP file with a backup of the database.
Download a ZIP file containing a backup of the database.
.. note::
Databases are backed up daily according to the `Odoo Cloud SLA
Databases are backed up daily as per the `Odoo Cloud Hosting SLA
<https://www.odoo.com/cloud-sla>`_.
.. _odoo_online/domains:
Domains
=======
Domain names
============
Configure custom domains to access the database via another URL.
Use a custom :doc:`domain name <domain_names>` to access the database via another URL.
.. seealso::
- :doc:`domain_names`
.. tip::
You can :ref:`register a domain name for free <domain-name/odoo-register>`.
.. _odoo_online/tags:
Tags
====
Add tags to sort your databases out. You can search the tags in the search bar.
Add tags to easily identify and sort your databases.
.. tip::
You can search for tags in the search bar.
.. _odoo_online/delete:
@@ -114,44 +92,43 @@ Delete
Delete a database instantly.
.. danger::
Deleting a database means that all data is permanently lost. The deletion is instant and for all
users. It is recommended to create a backup of the database before deleting it.
Deleting a database means that all data is permanently lost. The deletion is instant and applies
to all users. It is recommended to create a backup of the database before deleting it.
Carefully read the warning message that pops up and proceed only if the implications of deleting a
database are fully understood:
Carefully read the warning message and only proceed if the implications of deleting a database are
fully understood.
.. image:: odoo_online/delete.png
:align: center
:alt: A warning message is prompted before deleting a database.
:alt: The warning message displayed before deleting a database
.. note::
- Only an administrator can delete a database.
- The database name is immediately available for a new database.
- It is not possible to delete a database if it is expired or linked to a subscription. If
needed, please get in touch with `Odoo Support <https://www.odoo.com/help>`_.
- The database name is immediately made available to anyone.
- Deleting a database if it has expired or is linked to a subscription is impossible. In that
case, contact `Odoo Support <https://www.odoo.com/help>`_.
.. _odoo_online/contact-support:
Contact Support
===============
Contact us
==========
Access the Odoo `support page <https://www.odoo.com/help>`_ with your database's details already
Access the `Odoo.com support page <https://www.odoo.com/help>`_ with the database's details already
pre-filled.
.. _odoo_online/users:
Invite / Remove Users
Invite / remove users
=====================
To invite users, fill out the email address of the new user and click on :guilabel:`Invite`. To add
multiple users, click on :guilabel:`Add more users`.
To invite users, fill out the new user's email address and click :guilabel:`Invite`. To add multiple
users, click :guilabel:`Add more users`.
.. image:: odoo_online/invite-users.png
:align: center
:alt: Clicking on "Add more users" adds additional email fields.
:alt: Inviting a user on a database
To remove users, select the users to remove and click on :guilabel:`Remove`.
To remove users, select them and click :guilabel:`Remove`.
.. seealso::
- :doc:`/applications/general/users/manage_users`
- :doc:`/applications/general/users/delete_account`
- :doc:`../../applications/general/users/manage_users`
- :doc:`../../applications/general/users/delete_account`
Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.6 KiB

@@ -23,47 +23,136 @@ This matrix shows the support status of every version.
**Major releases are in bold type.**
+-----------------+-------------+----------+-------------+----------------+------------------------+
| | Odoo Online | Odoo.sh | On-Premise | Release date | End of support |
+=================+=============+==========+=============+================+========================+
| Odoo saas~16.2 | |green| | N/A | N/A | March 2023 | June 2023 (planned) |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo saas~16.1 | |green| | N/A | N/A | February 2023 | April 2023 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 16.0** | |green| | |green| | |green| | October 2022 | October 2025 (planned) |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo saas~15.2 | |red| | N/A | N/A | March 2022 | January 2023 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo saas~15.1 | |red| | N/A | N/A | February 2022 | July 2022 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 15.0** | |green| | |green| | |green| | October 2021 | October 2024 (planned) |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 14.0** | |green| | |green| | |green| | October 2020 | October 2023 (planned) |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 13.0** | |red| | |red| | |red| | October 2019 | October 2022 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo saas~12.3 | |red| | N/A | N/A | August 2019 | |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 12.0** | |red| | |red| | |red| | October 2018 | October 2021 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo saas~11.3 | |red| | N/A | N/A | April 2018 | |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 11.0** | |red| | |red| | |red| | October 2017 | October 2020 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo 10.saas~15 | |red| | N/A | N/A | March 2017 | |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo 10.saas~14 | |red| | N/A | N/A | January 2017 | |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 10.0** | |red| | |red| | |red| | October 2016 | October 2019 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo 9.saas~11 | |red| | N/A | N/A | May 2016 | |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 9.0** | |red| | N/A | |red| | October 2015 | October 2018 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| Odoo 8.saas~6 | |red| | N/A | N/A | February 2015 | |
+-----------------+-------------+----------+-------------+----------------+------------------------+
| **Odoo 8.0** | |red| | N/A | |red| | September 2014 | October 2017 |
+-----------------+-------------+----------+-------------+----------------+------------------------+
.. list-table::
:header-rows: 1
:widths: auto
* -
- Odoo Online
- Odoo.sh
- On-Premise
- Release date
- End of support
* - Odoo saas~16.3
- |green|
- N/A
- N/A
- June 2023
- September 2023 (planned)
* - Odoo saas~16.2
- |green|
- N/A
- N/A
- March 2023
- July 2023 (planned)
* - Odoo saas~16.1
- |red|
- N/A
- N/A
- February 2023
- April 2023
* - **Odoo 16.0**
- |green|
- |green|
- |green|
- October 2022
- October 2025 (planned)
* - Odoo saas~15.2
- |red|
- N/A
- N/A
- March 2022
- January 2023
* - Odoo saas~15.1
- |red|
- N/A
- N/A
- February 2022
- July 2022
* - **Odoo 15.0**
- |green|
- |green|
- |green|
- October 2021
- October 2024 (planned)
* - **Odoo 14.0**
- |green|
- |green|
- |green|
- October 2020
- October 2023 (planned)
* - **Odoo 13.0**
- |red|
- |red|
- |red|
- October 2019
- October 2022
* - Odoo saas~12.3
- |red|
- N/A
- N/A
- August 2019
-
* - **Odoo 12.0**
- |red|
- |red|
- |red|
- October 2018
- October 2021
* - Odoo saas~11.3
- |red|
- N/A
- N/A
- April 2018
-
* - **Odoo 11.0**
- |red|
- |red|
- |red|
- October 2017
- October 2020
* - Odoo 10.saas~15
- |red|
- N/A
- N/A
- March 2017
-
* - Odoo 10.saas~14
- |red|
- N/A
- N/A
- January 2017
-
* - **Odoo 10.0**
- |red|
- |red|
- |red|
- October 2016
- October 2019
* - Odoo 9.saas~11
- |red|
- N/A
- N/A
- May 2016
-
* - **Odoo 9.0**
- |red|
- N/A
- |red|
- October 2015
- October 2018
* - Odoo 8.saas~6
- |red|
- N/A
- N/A
- February 2015
-
* - **Odoo 8.0**
- |red|
- N/A
- |red|
- September 2014
- October 2017
.. note::
@@ -45,41 +45,101 @@ these databases if they have one, using their regular credentials.
In addition, they cannot use the webshell nor have access to the server logs.
+---------------------+-----------------+-----------+-----------+
| | | User | Admin |
+=====================+=================+===========+===========+
|Development | History | X | X |
+---------------------+-----------------+-----------+-----------+
| | 1-click connect | X | X |
+---------------------+-----------------+-----------+-----------+
| | Logs | X | X |
+---------------------+-----------------+-----------+-----------+
| | Shell/SSH | X | X |
+---------------------+-----------------+-----------+-----------+
| | Mails | X | X |
+---------------------+-----------------+-----------+-----------+
| | Settings | X | X |
+---------------------+-----------------+-----------+-----------+
|Production & Staging | History | X | X |
+---------------------+-----------------+-----------+-----------+
| | 1-click connect | | X |
+---------------------+-----------------+-----------+-----------+
| | Logs | | X |
+---------------------+-----------------+-----------+-----------+
| | Shell/SSH | | X |
+---------------------+-----------------+-----------+-----------+
| | Mails | | X |
+---------------------+-----------------+-----------+-----------+
| | Monitoring | | X |
+---------------------+-----------------+-----------+-----------+
| | Backups | | X |
+---------------------+-----------------+-----------+-----------+
| | Settings | X | X |
+---------------------+-----------------+-----------+-----------+
|Status | | X | X |
+---------------------+-----------------+-----------+-----------+
|Settings | | | X |
+---------------------+-----------------+-----------+-----------+
.. list-table::
:header-rows: 1
:widths: auto
* -
-
- User
- Admin
* - Development
- History
- |green|
- |green|
* -
- 1-click connect
- |green|
- |green|
* -
- Logs
- |green|
- |green|
* -
- Shell/SSH
- |green|
- |green|
* -
- Mails
- |green|
- |green|
* -
- Upgrade
- |green|
- |green|
* -
- Settings
- |green|
- |green|
* - Production & Staging
- History
- |green|
- |green|
* -
- 1-click connect
-
- |green|
* -
- Logs
-
- |green|
* -
- Shell/SSH
-
- |green|
* -
- Mails
-
- |green|
* -
- Monitoring
-
- |green|
* -
- Backups
-
- |green|
* -
- Upgrade
-
- |green|
* -
- Settings
- |green|\*
- |green|
* - Status
-
- |green|
- |green|
* - Settings
-
-
- |green|
.. note::
\* Only in staging branches
.. |green| raw:: html
<span class="text-success" style="font-size: 32px; line-height: 0.5">●</span>
.. |orange| raw:: html
<span class="text-warning" style="font-size: 32px; line-height: 0.5">●</span>
.. |red| raw:: html
<span class="text-danger" style="font-size: 32px; line-height: 0.5">●</span>
Public Access
=============
+32 -25
View File
@@ -196,7 +196,7 @@ Help
.. _upgrade/contact:
Contact our Upgrade service support
Contact our upgrade service support
-----------------------------------
Should you have any more questions about the upgrade, do not hesitate to send a message to `Odoo
@@ -219,39 +219,46 @@ upgrade again).
.. _upgrade/sla:
Service Level Agreement
=======================
Service-level agreement (SLA)
=============================
What is covered by the Enterprise Licence?
------------------------------------------
With Odoo Enterprise, upgrading a database to the most recent version of Odoo is **free**, including
any support required to rectify potential discrepancies in the upgraded database.
Databases hosted on Odoo's Cloud platforms (Odoo Online and Odoo.sh) or On-Premise (Self-Hosting)
enjoy the following services at all times.
Information about the upgrade services included in the Enterprise Licence is available in the
:ref:`Odoo Enterprise Subscription Agreement <upgrade>`. However, this section clarifies what
upgrade services you can expect.
The upgrade of:
Upgrade services covered by the SLA
-----------------------------------
* standard applications
* Studio customization (as long as the :guilabel:`Studio` app is still active)
* customizations *if* they are covered by a "Maintenance of Customizations" subscription
Databases hosted on Odoo's cloud platforms (Odoo Online and Odoo.sh) or self-hosted (On-Premise) can
benefit from upgrade services at all times for:
The Upgrade Service is limited to your database's technical conversion and adaptation (standard
modules and data) to make it compatible with the targeted version.
- the upgrade of all **standard applications**;
- the upgrade of all **customizations created with the Studio app**, as long as Studio is still
installed and the respective subscription is still active; and
- the upgrade of all **developments and customizations covered by a maintenance of customizations
subscription**.
What upgrading does NOT cover
-----------------------------
Upgrade services are limited to the technical conversion and adaptation of a database (standard
modules and data) to make it compatible with the version targeted by the upgrade.
* The cleaning of pre-existing data & configuration while upgrading
* Any new developments and/or upgrades of your own :ref:`custom modules
<upgrade-faq/custom-modules>`
* Lines of code added to standard modules that are not created with Odoo Studio.
* `Training <https://www.odoo.com/learn>`_ on the latest version
Upgrade services not covered by the SLA
---------------------------------------
You can get more information about your Enterprise Licence on our :ref:`Odoo Enterprise Subscription
Agreement <upgrade>` page.
The following upgrade-related services are **not** included:
- the **cleaning** of pre-existing data and configurations while upgrading;
- the upgrade of **custom modules created in-house or by third parties**, including Odoo partners;
- lines of **code added to standard modules**, i.e., customizations created outside the Studio app,
code entered manually, and :ref:`automated actions using Python code
<studio/automated-actions/action>`; and
- **training** on using the upgraded version's features and workflows.
.. note:: |assistance-contact|
.. seealso::
- :doc:`upgrade/faq`
- :doc:`odoo_sh`
- :doc:`maintain/supported_versions`
- :doc:`Upgrade FAQ <upgrade/faq>`
- :doc:`Odoo.sh documentation <odoo_sh>`
- :doc:`Supported Odoo versions <maintain/supported_versions>`
+80 -18
View File
@@ -2,29 +2,91 @@
Odoo Online
===========
Requesting a test upgrade
=========================
Odoo databases can be manually upgraded directly from the main Odoo website. To upgrade an Odoo
database, navigate to the `database manager <https://www.odoo.com/my/databases>`_ page and sign in.
#. Go to your `database manager <https://www.odoo.com/my/databases/>`_
#. Click on your profile icon and select *My Databases*.
The database manager page displays all of the Odoo databases associated with the user's account. Any
databases that are not already on the most recent version of Odoo display an **arrow in a circle**
icon next to the database name, indicating that the database can be upgraded.
.. image:: odoo_online/accessing-my-databases.png
:alt: Selecting My Databases under my profile
.. image:: odoo_online/databases-page.png
:align: center
:alt: The database manager page with an upgrade button next to the name of a database.
#. Click on the up arrow button next to your main database name to proceed to the test upgrade.
.. important::
- If the database's version is **lower** than the latest major release: the database must be
upgraded within two months. After these two months, an automatic upgrade is initiated.
- If the database's version is **equal** to or **higher** than the latest major release:
you can disregard the invitation to upgrade, as the database probably would not benefit from
new features every two months.
.. image:: odoo_online/upgrade-option.png
:alt: Selecting the action settings icon
If a database is *not* on the latest online version, its administrator should receive an invitation
to upgrade on the database's dashboard, displayed as an **arrow in a circle**.
#. In the pop-up message that appears, select the target version and then :guilabel:`Test` as
purpose.
.. image:: odoo_online/database-notification.png
:alt: Invitation to upgrade on the database dashboard.
.. note::
The :guilabel:`Production` purpose doesn't appear if you didn't test your upgraded database at
least once.
.. note::
Versions that are not supported anymore become deprecated and must be updated to avoid
security issues. It is recommended to initiate the upgrade yourself and not wait for the
automatic upgrade, as the former method allows you to request a test upgrade of the database to
check for any discrepancies.
#. This triggers the automated upgrade process. A confirmation email is then sent to you with the
the link to the upgraded database or to provide information if the upgrade failed.
Test database
=============
.. note::
You can also see and access your test database from your *My Databases* page.
Click on the **arrow in a circle** icon to start the upgrade process. On the :guilabel:`Upgrade your
database` pop-up, select the version of Odoo that the platform will be upgraded to. In the
:guilabel:`Email to notify` field, enter an email address that will receive email notifications
about the database upgrade.
There is also a :guilabel:`Purpose` section on the pop-up that is used to specify the reason for the
upgrade. However, at this stage of the process, the only selectable option is :guilabel:`Test`, as
Odoo requires users to create a test copy of the upgraded database before converting the actual
database.
.. image:: odoo_online/upgrade-pop-up.png
:align: center
:alt: The "Upgrade your database" pop-up.
After filling out the form, click the :guilabel:`Upgrade` button. The pop-up disappears and the
database being upgraded shows a red :guilabel:`Upgrade in progress` tag next to its name. An email
confirming that the upgrade is in progress is also sent to the email address specified on the
pop-up.
.. image:: odoo_online/upgrade-in-progress.png
:align: center
:alt: The "Upgrade in progress" tag next to the database name.
Once the upgrade is complete, a new test database appears on the `database manager
<https://www.odoo.com/my/databases>`_ page. To access the test database, click the drop-down arrow
(:guilabel:`⯆`) to the left of the main database's name. Doing so makes the test version appear
below it. Finally, click the green :guilabel:`Connect` button on the right side of the test
version's row to go to the database.
.. image:: odoo_online/test-database.png
:align: center
:alt: A test database on the database manager page.
Except for being on the newer version of Odoo, the test database is an exact copy of the one being
upgraded. It is important to do extensive testing in this database to ensure that the upgrade has
not altered or corrupted any data, and that all workflows still proceed as expected.
Production database
===================
After confirming the integrity of the new version, return to the `database manager
<https://www.odoo.com/my/databases>`_ page. Once again, click on the **arrow in a circle** icon next
to the database being upgraded. The :guilabel:`Upgrade your database` pop-up appears as before,
except that there is now a :guilabel:`Production` option under the :guilabel:`Purpose` section.
Select the :guilabel:`Production` option and then click :guilabel:`Upgrade` to begin the upgrade
process. As before, a notification email is sent to the email address provided and a red
:guilabel:`Upgrade in progress` tag appears next to the name of the database.
The production database is then taken offline and will be upgraded automatically. The time it takes
to upgrade the production database should be similar to the time that was necessary to upgrade the
test database. Make sure to inform database users of the scheduled downtime.
After the upgrade is finished, the :guilabel:`Upgrade in progress` tag disappears and the database
is upgraded to the version specified.
Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

+219 -10
View File
@@ -1,7 +1,4 @@
:nosearch:
:show-content:
:hide-page-toc:
:show-toc:
========================
Accounting and Invoicing
@@ -15,17 +12,229 @@ development with features such as AI-powered invoice recognition, synchronizatio
accounts, smart matching suggestions, etc.
.. seealso::
- `Odoo Tutorials: Accounting <https://www.odoo.com/slides/accounting-19>`_
- :doc:`Accounting Cheat Sheet <accounting/getting_started/cheat_sheet>`
`Odoo Tutorials: Accounting <https://www.odoo.com/slides/accounting-19>`_
.. cards::
.. card:: Get started
:target: accounting/get_started
:large:
Basic concepts of accounting and initial setup of your accounting
.. card:: Taxes
:target: accounting/taxes
Taxes, fiscal positions, and integrations
.. card:: Customer invoices
:target: accounting/customer_invoices
Customer invoices, payment terms, and electronic invoicing
.. card:: Vendor bills
:target: accounting/vendor_bills
Vendor bills, assets, and invoice digitization (OCR)
.. card:: Payments
:target: accounting/payments
Invoices and bills payments (online, checks, batches) and follow-up on invoices
.. card:: Bank and cash accounts
:target: accounting/bank
Bank synchronization, reconciliation, and cash registers
.. card:: Reporting
:target: accounting/reporting
Reporting, declarations, and analytic accounting
Double-entry bookkeeping
========================
Odoo automatically creates all the underlying journal entries for all accounting transactions (e.g.,
customer invoices, vendor bills, point-of-sales orders, expenses, inventory valuations, etc.).
Odoo uses the double-entry bookkeeping system, whereby every entry needs a corresponding and
opposite counterpart in a different account, with one account debited and the other credited.
It ensures that all transactions are recorded accurately and consistently and that the accounts
always balance.
.. seealso::
:doc:`Accounting Cheat Sheet <accounting/get_started/cheat_sheet>`
Accrual and cash basis
======================
Both accrual and cash basis accounting are supported in Odoo. This allows reporting income and
expense either when the transaction occurs (accrual basis) or when the payment is made or received
(cash basis).
.. seealso::
:doc:`Cash basis <accounting/taxes/cash_basis>`
Multi-company
=============
Several companies can be managed within the same database. Each company has its :doc:`chart of
accounts <accounting/get_started/chart_of_accounts>`, which is also useful to generate consolidation
reports. Users can access several companies but can only work on a single company's accounting at a
time.
Multi-currency environment
==========================
A :doc:`multi-currency <accounting/get_started/multi_currency>` environment with an automated
exchange rate to ease international transactions is available in Odoo. Every transaction is recorded
in the company's default currency; for transactions occurring in another currency, Odoo stores both
the value in the company's currency and the transactions' currency value. Odoo generates currency
gains and losses after reconciling the journal items.
.. seealso::
:doc:`Manage a bank in a foreign currency <accounting/bank/foreign_currency>`
International standards
=======================
Odoo Accounting supports more than 70 countries. It provides the central standards and mechanisms
common to all nations, and thanks to country-specific modules, local requirements are fulfilled.
Fiscal positions exist to address regional specificities like the chart of accounts, taxes, or any
other requirements.
.. seealso::
:doc:`Fiscal localization packages <fiscal_localizations>`
Accounts receivable and payable
===============================
By default, there is a single account for the account receivable entries and one for the account
payable entries. As transactions are linked to your **contacts**, you can run a report per customer,
vendor, or supplier.
The **Partner Ledger** report displays the balance of your customers and suppliers. It is available
by going to :menuselection:`Accounting --> Reporting --> Partner Ledger`.
Reporting
=========
The following financial :doc:`reports <accounting/reporting>` are available and updated in
real-time:
+-----------------------------------------------+
| Financial reports |
+============+==================================+
| Statement | Balance sheet |
| +----------------------------------+
| | Profit and loss |
| +----------------------------------+
| | Cash flow statement |
| +----------------------------------+
| | Tax report |
| +----------------------------------+
| | ES sales list |
+------------+----------------------------------+
| Audit | General ledger |
| +----------------------------------+
| | Trial balance |
| +----------------------------------+
| | Journal report |
| +----------------------------------+
| | Intrastat report |
| +----------------------------------+
| | Check register |
+------------+----------------------------------+
| Partner | Partner ledger |
| +----------------------------------+
| | Aged receivable |
| +----------------------------------+
| | Aged payable |
+------------+----------------------------------+
| Management | Invoice analysis |
| +----------------------------------+
| | Unrealized currency gains/losses |
| +----------------------------------+
| | Depreciation schedule |
| +----------------------------------+
| | Disallowed expenses |
| +----------------------------------+
| | Budget analysis |
| +----------------------------------+
| | Product margins |
| +----------------------------------+
| | 1099 report |
+------------+----------------------------------+
.. tip::
:doc:`Create and customize reports <accounting/reporting/customize>` with Odoo's report engine.
Tax report
----------
Odoo computes all accounting transactions for the specific tax period and uses these totals to
calculate the tax obligation.
.. important::
Once the tax report has been generated for a period, Odoo locks it and prevents the creation of
new journal entries involving VAT. Any correction to customer invoices or vendor bills has to
be recorded in the next period.
.. note::
Depending on the country's localization, an XML version of the tax report can be generated to be
uploaded to the VAT platform of the relevant taxation authority.
Bank synchronization
====================
The bank synchronization system directly connects with your bank institution to automatically
import all transactions into your database. It gives an overview of your cash flow without logging
into an online banking system or waiting for paper bank statements.
.. seealso::
:doc:`Bank synchronization <accounting/bank/bank_synchronization>`
Inventory valuation
===================
Both periodic (manual) and perpetual (automated) inventory valuations are supported in Odoo. The
available methods are standard price, average price, :abbr:`LIFO (Last-In, First-Out)` and
:abbr:`FIFO (First-In, First-Out).`
.. seealso::
:doc:`View the impact of the valuation methods on transactions
<../inventory_and_mrp/inventory/management/reporting/inventory_valuation_config>`
Retained earnings
=================
Retained earnings are the portion of income retained by a business. Odoo calculates current year
earnings in real-time, so no year-end journal or rollover is required. The profit
and loss balance is automatically reported on the balance sheet report.
.. seealso::
:doc:`Accounting Cheat Sheet <accounting/get_started/cheat_sheet>`
Fiduciaries
===========
The :guilabel:`Accounting Firms` mode can be activated by going to :menuselection:`Accounting -->
Configuration --> Settings --> Accounting Firms mode`. When enabled:
- The document's sequence becomes editable on all documents;
- The :guilabel:`Total (tax incl.)` field appears to speed up and control the encoding by automating
line creation with the right account and tax;
- :guilabel:`Invoice Date` and :guilabel:`Bill Date` are pre-filled when encoding a transaction.
- A :guilabel:`Quick encoding` option is available for customer invoices and vendor bills.
.. toctree::
:titlesonly:
accounting/getting_started
accounting/receivables
accounting/payables
accounting/get_started
accounting/taxes
accounting/customer_invoices
accounting/vendor_bills
accounting/payments
accounting/bank
accounting/taxation
accounting/reporting
accounting/others
@@ -1,14 +1,194 @@
:nosearch:
:show-content:
======================
Bank and cash accounts
======================
You can manage as many bank or cash accounts as needed on your database. Configuring them well
allows you to have all your banking data up-to-date and ready for :doc:`reconciliation
<bank/reconciliation>` with your journal entries.
In Odoo Accounting, each bank account has a dedicated journal set to post all entries in a dedicated
account. Both the journal and the account are automatically created and configured whenever you add
a bank account.
.. note::
Cash journals and accounts must be configured manually.
Bank journals are displayed by default on the :guilabel:`Accounting Dashboard` in the form of cards
which include action buttons.
.. image:: bank/card.png
:alt: Bank journals are displayed on the Accounting Dashboard and contain action buttons
.. _bank_accounts/manage:
Manage your bank and cash accounts
==================================
Connect your bank for automatic synchronization
-----------------------------------------------
To connect your bank account to your database, go to :menuselection:`Accounting --> Configuration
--> Banks: Add a Bank Account`, select your bank in the list, click on :guilabel:`Connect`, and
follow the instructions.
.. seealso::
:doc:`bank/bank_synchronization`
Create a bank account
---------------------
If your banking institution is not available in Odoo, or if you don't want to connect your bank
account to your database, you can configure your bank account manually.
To manually add a bank account, go to :menuselection:`Accounting --> Configuration --> Banks:
Add a Bank Account`, click on :guilabel:`Create it` (at the bottom right), and fill out the form.
.. note::
- Odoo automatically detects the bank account type (e.g., IBAN) and enables some features
accordingly.
- A default bank journal is available and can be used to configure your bank account by going to
:menuselection:`Accounting --> Configuration --> Accounting: Journals --> Bank`. Open it and
edit the different fields to match your bank account information.
Create a cash journal
---------------------
To create a new cash journal, go to :menuselection:`Accounting --> Configuration --> Accounting:
Journals`, click on :guilabel:`Create` and select :guilabel:`Cash` in the :guilabel:`Type` field.
For more information on the accounting information fields, read the
:ref:`bank_accounts/configuration` section of this page.
.. note::
A default cash journal is available and can be used straight away. You can review it by going to
:menuselection:`Accounting --> Configuration --> Accounting: Journals --> Cash`.
Edit an existing bank or cash journal
-------------------------------------
To edit an existing bank journal, go to :menuselection:`Accounting --> Configuration --> Accounting:
Journals` and select the journal you want to modify.
.. _bank_accounts/configuration:
Configuration
=============
Bank and cash
=============
You can edit the accounting information and bank account number according to your needs.
.. image:: bank/bank-journal-config.png
:alt: Manually configure your bank information
.. seealso::
- :doc:`get_started/multi_currency`
- :doc:`bank/transactions`
.. _bank_accounts/suspense:
Suspense account
----------------
Bank statement transactions are posted on the :guilabel:`Suspense Account` until the final
reconciliation allows finding the right account.
Profit and loss accounts
------------------------
The :guilabel:`Profit Account` is used to register a profit when the ending balance of a cash
register differs from what the system computes, while the :guilabel:`Loss Account` is used to
register a loss when the ending balance of a cash register differs from what the system computes.
Currency
--------
You can edit the currency used to enter the statements.
.. seealso::
:doc:`get_started/multi_currency`
Account number
--------------
If you need to **edit your bank account details**, click on the external link arrow next to your
:guilabel:`Account Number`. On the new page, click on the external link arrow next to your
:guilabel:`Bank` and update your bank information accordingly. These details are used when
registering payments.
.. image:: bank/bank-account-number.png
:alt: Edit your bank information
Bank feeds
----------
:guilabel:`Bank Feeds` defines how the bank statements are registered. Three options are available:
- :guilabel:`Undefined yet`, which should be selected when you dont know yet if you will
synchronize your bank account with your database or not.
- :guilabel:`Import (CAMT, CODA, CSV, OFX, QIF)`, which should be selected if you want to import
your bank statement using a different format.
- :guilabel:`Automated Bank Synchronization`, which should be selected if your bank is synchronized
with your database.
.. seealso::
- :doc:`bank/bank_synchronization`
- :doc:`bank/transactions`
.. _bank/outstanding-accounts:
Outstanding accounts
====================
By default, payments are registered through transitory accounts named **outstanding accounts**,
before being recorded in your bank account.
- An **outstanding payments account** is where outgoing payments are posted until they are linked
with a withdrawal from your bank statement.
- An **outstanding receipts account** is where incoming payments are posted until they are linked
with a deposit from your bank statement.
These accounts should be of :ref:`type <chart-of-account/type>` :guilabel:`Current Assets`.
.. note::
The movement from an outstanding account to a bank account is done automatically when you
reconcile the bank account with a bank statement.
Default accounts configuration
------------------------------
The outstanding accounts are defined by default. If necessary, you can update them by going to
:menuselection:`Accounting --> Configuration --> Settings --> Default Accounts` and update your
:guilabel:`Outstanding Receipts Account` and :guilabel:`Outstanding Payments Account`.
Bank and cash journals configuration
------------------------------------
You can also set specific outstanding accounts for any journal with the :ref:`type
<chart-of-account/type>` :guilabel:`Bank` or :guilabel:`Cash`.
From your :guilabel:`Accounting Dashboard`, click on the menu selection ⋮ of the journal you want to
configure, and click on :guilabel:`Configuration`, then open the :guilabel:`Incoming/Outgoing
Payments` tab. To display the outstanding accounts column, click on the toggle button and check the
:guilabel:`Outstanding Receipts/Payments accounts`, then update the account.
.. image:: bank/toggle-button.png
:align: center
:alt: Select the toggle button and click on outstanding Accounts
.. note::
- If you do not specify an outstanding payments account or an outstanding receipts account for a
specific journal, Odoo uses the default outstanding accounts.
- If your main bank account is added as an outstanding receipts account or outstanding payments
account, when a payment is registered, the invoice or bill's status is directly set to
:guilabel:`Paid`.
.. toctree::
:titlesonly:
bank/setup
bank/bank_synchronization
bank/transactions
bank/reconciliation
bank/interbank
bank/reconciliation_models
bank/foreign_currency
bank/cash_register
@@ -17,7 +17,7 @@ To connect to the banks, Odoo uses multiple web-services:
- **Plaid**: United States of America and Canada
- **Yodlee**: Worldwide
- :doc:`Salt Edge <bank_synchronization/saltedge>`: Europe
- :doc:`Salt Edge <bank_synchronization/saltedge>`: Worldwide
- :doc:`Ponto <bank_synchronization/ponto>`: Europe
- :doc:`Enable Banking <bank_synchronization/enablebanking>`: Scandinavian countries

Before

Width:  |  Height:  |  Size: 6.4 KiB

After

Width:  |  Height:  |  Size: 6.4 KiB

@@ -1,6 +1,6 @@
======================
Manage a cash register
======================
=============
Cash register
=============
The cash register is a journal to register receivings and payments transactions.
It calculates the total money in and out, computing the total balance.
@@ -8,7 +8,7 @@ It calculates the total money in and out, computing the total balance.
Configuration
=============
.. image:: manage_cash_register/journal.png
.. image:: cash_register/journal.png
:align: center
1. Configure the Cash journal in :menuselection:`Accounting --> Configuration -->
@@ -40,7 +40,7 @@ Put money in is used to placed your cash manually before starting your
transactions. From the Register Transactions window, go to :menuselection:`More
--> Put money in`
.. image:: manage_cash_register/put-money-in.png
.. image:: cash_register/put-money-in.png
:align: center
Take money out
@@ -50,7 +50,7 @@ Take money out is used to collect/get yor your cash manually after
ending all your transactions. From the Register Transaction windows, go to :menuselection:`More
--> Take money out`
.. image:: manage_cash_register/put-money-out.png
.. image:: cash_register/put-money-out.png
:align: center
The transactions will be added to the current cash payment registration.

Before

Width:  |  Height:  |  Size: 5.9 KiB

After

Width:  |  Height:  |  Size: 5.9 KiB

@@ -1,11 +1,95 @@
:nosearch:
===================
Bank reconciliation
===================
.. toctree::
:titlesonly:
Overview
========
reconciliation/use_cases
reconciliation/reconciliation_models
Matching your bank statements with your accounting records can be a tedious task. You need to find the corresponding invoices, compare the amounts and partners' details with those in the bank statement. These steps can take a lot of time. Luckily, with Odoo you can very easily match your invoices or any other payment document with your bank statements.
Two options of the reconciliation process exist in Odoo.
1. We can directly specify the payment on the invoice
2. We can reconcile open invoices with bank statements
Configuration
=============
No special configuration is necessary to record invoices. All we need
to do is to install the accounting app.
.. image:: reconciliation/use01.png
Use cases
=========
Case 1: Payments registration
-----------------------------
We received the proof of payment of our invoice in the amount of 2100 euros issued to
Smith & Co.
We start at our issued Invoice of 2100 euros for Smith & Co. Because the
sold product is a service we demand an immediate payment. Our accountant
only handles bank statements at the end of week, so we have to mark
this invoice as paid immediately in order to indicate that we can start rendering services to our
customer.
Our customer send us a payment confirmation. We can thus register a
payment and mark the invoice as paid.
.. image:: reconciliation/use02.png
By clicking on **register payment,** we are telling Odoo that our
customer has paid the Invoice. We thus have to specify the amount and the
payment method.
.. image:: reconciliation/use03.png
Now we can always find the payment details in the Invoice by clicking on the
:menuselection:`Info --> Open Payment`.
.. image:: reconciliation/use04.png
The invoice has been paid and **the reconciliation has been done
automatically.**
Case 2: Bank statements reconciliations
---------------------------------------
We start at our issued Invoice of 3000 euros for Smith & Co. Let's also
assume that other Invoices are open for different customers.
.. image:: reconciliation/use05.png
We receive our bank statement and find that not only the invoice issued to Smith & Co has
been paid, but the one to Buzz of 92 euros as well.
**Import** or **Create** the bank statements. Please refer to the
documents from the Bank Feeds section.
.. image:: reconciliation/use06.png
On the dashboard, click on **Reconcile # Items**
.. image:: reconciliation/use07.png
If everything was right (correct partner name, right amount) odoo will
do the reconciliations **automatically**.
.. image:: reconciliation/use08.png
If some issues are found, you will need to take **manual actions**.
For example, if the partner is missing from your bank statement, just
fill it in :
.. image:: reconciliation/use09.png
If the payment is done with a down payment, just check if it is all
right and validate all related payments :
.. image:: reconciliation/use10.png
.. seealso::
:doc:`bank_synchronization`

Before

Width:  |  Height:  |  Size: 3.7 KiB

After

Width:  |  Height:  |  Size: 3.7 KiB

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

Before

Width:  |  Height:  |  Size: 5.1 KiB

After

Width:  |  Height:  |  Size: 5.1 KiB

Before

Width:  |  Height:  |  Size: 9.0 KiB

After

Width:  |  Height:  |  Size: 9.0 KiB

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

Before

Width:  |  Height:  |  Size: 8.1 KiB

After

Width:  |  Height:  |  Size: 8.1 KiB

Before

Width:  |  Height:  |  Size: 4.3 KiB

After

Width:  |  Height:  |  Size: 4.3 KiB

Before

Width:  |  Height:  |  Size: 7.1 KiB

After

Width:  |  Height:  |  Size: 7.1 KiB

Before

Width:  |  Height:  |  Size: 4.5 KiB

After

Width:  |  Height:  |  Size: 4.5 KiB

Before

Width:  |  Height:  |  Size: 7.1 KiB

After

Width:  |  Height:  |  Size: 7.1 KiB

@@ -1,105 +0,0 @@
=======================================
Bank reconciliation process - use cases
=======================================
Overview
========
Matching your bank statements with your accounting records can be a tedious task. You need to find the corresponding invoices, compare the amounts and partners' details with those in the bank statement. These steps can take a lot of time. Luckily, with Odoo you can very easily match your invoices or any other payment document with your bank statements.
Two options of the reconciliation process exist in Odoo.
1. We can directly specify the payment on the invoice
2. We can reconcile open invoices with bank statements
Configuration
=============
No special configuration is necessary to record invoices. All we need
to do is to install the accounting app.
.. image:: use_cases/use01.png
:align: center
Use cases
=========
Case 1: Payments registration
-----------------------------
We received the proof of payment of our invoice in the amount of 2100 euros issued to
Smith & Co.
We start at our issued Invoice of 2100 euros for Smith & Co. Because the
sold product is a service we demand an immediate payment. Our accountant
only handles bank statements at the end of week, so we have to mark
this invoice as paid immediately in order to indicate that we can start rendering services to our
customer.
Our customer send us a payment confirmation. We can thus register a
payment and mark the invoice as paid.
.. image:: use_cases/use02.png
:align: center
By clicking on **register payment,** we are telling Odoo that our
customer has paid the Invoice. We thus have to specify the amount and the
payment method.
.. image:: use_cases/use03.png
:align: center
Now we can always find the payment details in the Invoice by clicking on the
:menuselection:`Info --> Open Payment`.
.. image:: use_cases/use04.png
:align: center
The invoice has been paid and **the reconciliation has been done
automatically.**
Case 2: Bank statements reconciliations
---------------------------------------
We start at our issued Invoice of 3000 euros for Smith & Co. Let's also
assume that other Invoices are open for different customers.
.. image:: use_cases/use05.png
:align: center
We receive our bank statement and find that not only the invoice issued to Smith & Co has
been paid, but the one to Buzz of 92 euros as well.
**Import** or **Create** the bank statements. Please refer to the
documents from the Bank Feeds section.
.. image:: use_cases/use06.png
:align: center
On the dashboard, click on **Reconcile # Items**
.. image:: use_cases/use07.png
:align: center
If everything was right (correct partner name, right amount) odoo will
do the reconciliations **automatically**.
.. image:: use_cases/use08.png
:align: center
If some issues are found, you will need to take **manual actions**.
For example, if the partner is missing from your bank statement, just
fill it in :
.. image:: use_cases/use09.png
:align: center
If the payment is done with a down payment, just check if it is all
right and validate all related payments :
.. image:: use_cases/use10.png
:align: center
.. seealso::
:doc:`../bank_synchronization`
@@ -12,7 +12,7 @@ with recurrent entries such as bank fees.
.. note::
Reconciliation Models are also useful to handle *Cash Discounts*. Please refer to
:doc:`this documentation <../../receivables/customer_invoices/cash_discounts>` for more
:doc:`this documentation <../customer_invoices/cash_discounts>` for more
information.
.. _reconciliation_models_types:
@@ -124,6 +124,6 @@ line*.
.. seealso::
- :doc:`use_cases`
- :doc:`../bank_synchronization`
- :doc:`../../receivables/customer_invoices/cash_discounts`
- :doc:`reconciliation`
- :doc:`bank_synchronization`
- :doc:`../customer_invoices/cash_discounts`
@@ -1,13 +0,0 @@
:nosearch:
=====
Setup
=====
.. toctree::
:titlesonly:
setup/bank_accounts
setup/outstanding_accounts
setup/manage_cash_register
setup/foreign_currency
@@ -1,136 +0,0 @@
======================
Bank and cash accounts
======================
You can manage as many bank or cash accounts as needed on your database. Configuring them well
allows you to have all your banking data up-to-date and ready for :doc:`reconciliation
<../reconciliation/use_cases>` with your journal entries.
In Odoo Accounting, each bank account has a dedicated journal set to post all entries in a dedicated
account. Both the journal and the account are automatically created and configured whenever you add
a bank account.
.. note::
Cash journals and accounts must be configured manually.
Bank journals are displayed by default on the :guilabel:`Accounting Dashboard` in the form of cards
which include action buttons.
.. image:: bank_accounts/card.png
:align: center
:alt: Bank journals are displayed on the Accounting Dashboard and contain action buttons
.. _bank_accounts/manage:
Manage your bank and cash accounts
==================================
Connect your bank for automatic synchronization
-----------------------------------------------
To connect your bank account to your database, go to :menuselection:`Accounting --> Configuration
--> Banks: Add a Bank Account`, select your bank in the list, click on :guilabel:`Connect`, and
follow the instructions.
.. seealso::
:doc:`../bank_synchronization`
Create a bank account
---------------------
If your banking institution is not available in Odoo, or if you don't want to connect your bank
account to your database, you can configure your bank account manually.
To manually add a bank account, go to :menuselection:`Accounting --> Configuration --> Banks:
Add a Bank Account`, click on :guilabel:`Create it` (at the bottom right), and fill out the form.
.. note::
- Odoo automatically detects the bank account type (e.g., IBAN) and enables some features
accordingly.
- A default bank journal is available and can be used to configure your bank account by going to
:menuselection:`Accounting --> Configuration --> Accounting: Journals --> Bank`. Open it and
edit the different fields to match your bank account information.
Create a cash journal
---------------------
To create a new cash journal, go to :menuselection:`Accounting --> Configuration --> Accounting:
Journals`, click on :guilabel:`Create` and select :guilabel:`Cash` in the :guilabel:`Type` field.
For more information on the accounting information fields, read the
:ref:`bank_accounts/configuration` section of this page.
.. note::
A default cash journal is available and can be used straight away. You can review it by going to
:menuselection:`Accounting --> Configuration --> Accounting: Journals --> Cash`.
Edit an existing bank or cash journal
-------------------------------------
To edit an existing bank journal, go to :menuselection:`Accounting --> Configuration --> Accounting:
Journals` and select the journal you want to modify.
.. _bank_accounts/configuration:
Configuration
=============
You can edit the accounting information and bank account number according to your needs.
.. image:: bank_accounts/bank-journal-config.png
:align: center
:alt: Manually configure your bank information
.. seealso::
- :doc:`../../others/multi_currency`
- :doc:`../transactions`
- :doc:`../../bank/setup/outstanding_accounts`
Suspense account
----------------
Bank statement transactions are posted on the :guilabel:`Suspense Account` until the final
reconciliation allows finding the right account.
Profit and loss accounts
------------------------
The :guilabel:`Profit Account` is used to register a profit when the ending balance of a cash
register differs from what the system computes, while the :guilabel:`Loss Account` is used to
register a loss when the ending balance of a cash register differs from what the system computes.
Currency
--------
You can edit the currency used to enter the statements.
.. seealso::
:doc:`../../others/multi_currency`
Account number
--------------
If you need to **edit your bank account details**, click on the external link arrow next to your
:guilabel:`Account Number`. On the new page, click on the external link arrow next to your
:guilabel:`Bank` and update your bank information accordingly. These details are used when
registering payments.
.. image:: bank_accounts/bank-account-number.png
:align: center
:alt: Edit your bank information
Bank feeds
----------
:guilabel:`Bank Feeds` defines how the bank statements are registered. Three options are available:
- :guilabel:`Undefined yet`, which should be selected when you dont know yet if you will
synchronize your bank account with your database or not.
- :guilabel:`Import (CAMT, CODA, CSV, OFX, QIF)`, which should be selected if you want to import
your bank statement using a different format.
- :guilabel:`Automated Bank Synchronization`, which should be selected if your bank is synchronized
with your database.
.. seealso::
- :doc:`../bank_synchronization`
- :doc:`../transactions`
@@ -1,49 +0,0 @@
====================
Outstanding accounts
====================
By default, payments are registered through transitory accounts named **outstanding accounts**,
before being recorded in your bank account.
- An **outstanding payments account** is where outgoing payments are posted until they are linked
with a withdrawal from your bank statement.
- An **outstanding receipts account** is where incoming payments are posted until they are linked
with a deposit from your bank statement.
These accounts should be of :ref:`type <chart-of-account/type>` :guilabel:`Current Assets`.
.. note::
The movement from an outstanding account to a bank account is done automatically when you
reconcile the bank account with a bank statement.
Configuration
=============
Default accounts configuration
------------------------------
The outstanding accounts are defined by default. If necessary, you can update them by going to
:menuselection:`Accounting --> Configuration --> Settings --> Default Accounts` and update your
:guilabel:`Outstanding Receipts Account` and :guilabel:`Outstanding Payments Account`.
Bank and cash journals configuration
------------------------------------
You can also set specific outstanding accounts for any journal with the :ref:`type
<chart-of-account/type>` :guilabel:`Bank` or :guilabel:`Cash`.
From your :guilabel:`Accounting Dashboard`, click on the menu selection ⋮ of the journal you want to
configure, and click on :guilabel:`Configuration`, then open the :guilabel:`Incoming/Outgoing
Payments` tab. To display the outstanding accounts column, click on the toggle button and check the
:guilabel:`Outstanding Receipts/Payments accounts`, then update the account.
.. image:: outstanding_accounts/toggle-button.png
:align: center
:alt: Select the toggle button and click on outstanding Accounts
.. note::
- If you do not specify an outstanding payments account or an outstanding receipts account for a
specific journal, Odoo uses the default outstanding accounts.
- If your main bank account is added as an outstanding receipts account or outstanding payments
account, when a payment is registered, the invoice or bill's status is directly set to
:guilabel:`Paid`.

Before

Width:  |  Height:  |  Size: 9.0 KiB

After

Width:  |  Height:  |  Size: 9.0 KiB

@@ -8,10 +8,13 @@ and reconciling them with the ones recorded in your accounting.
:doc:`Bank synchronization <bank_synchronization>` automates the process. However, if you do not
want to use it or if your bank is not yet supported, other options exist:
- :ref:`Import bank transactions <import-statements>` delivered by your bank;
- :ref:`Register bank transactions <register-transactions>` manually.
- :ref:`Import bank transactions <transactions/import>` delivered by your bank;
- :ref:`Register bank transactions <transactions/register>` manually.
.. _import-statements:
.. note::
:ref:`Grouping transactions by statement <transactions/statements>` is optional.
.. _transactions/import:
Import transactions
===================
@@ -28,15 +31,17 @@ To import a file, go to the :guilabel:`Accounting Dashboard`, and in the :guilab
click on :guilabel:`Import Transactions`.
.. image:: transactions/import-transactions.png
:align: center
:alt: Import bank transactions from bank journal
:alt: Import bank transactions from the bank journal
Next, select the file and upload it.
After setting the necessary formatting options and mapping the needed columns, you can run a
:guilabel:`Test` and :guilabel:`Import` your bank transactions.
After setting the necessary formatting options and mapping the file columns with their related Odoo
fields, you can run a :guilabel:`Test` and :guilabel:`Import` your bank transactions.
.. _register-transactions:
.. seealso::
:doc:`/applications/general/export_import_data`
.. _transactions/register:
Register bank transactions manually
===================================
@@ -44,3 +49,46 @@ Register bank transactions manually
You can also record your bank transactions manually. To do so, go to :guilabel:`Accounting
Dashboard`, click on the :guilabel:`Bank` journal, and then on :guilabel:`New`. Make sure to fill
out the :guilabel:`Partner` and :guilabel:`Label` fields to ease the reconciliation process.
.. _transactions/statements:
Statements
==========
A **bank statement** is a document provided by a bank or financial institution that lists the
transactions that have occurred in a particular bank account over a specified period of time.
In Odoo Accounting, it is optional to group transactions by their related statement, but depending
on your business flow, you may want to record them for control purposes.
.. important::
If you want to compare the ending balances of your bank statements with the ending balances of
your financial records, *don't forget to create an opening transaction* to record the bank
account balance as of the date you begin synchronizing or importing transactions. This is
necessary to ensure the accuracy of your accounting.
To access a list of statements, go to your :guilabel:`Accounting Dashboard`, click on the vertical
ellipsis (:guilabel:`⋮`) button next to the bank or cash journal you want to check, then on
:guilabel:`Statements`
Statement creation from the kanban view
---------------------------------------
Open the bank reconciliation view by clicking on the name of the bank journal, and identify the
transaction corresponding to the last transaction of your bank statement. Click on the
:guilabel:`STATEMENT` button when hovering on the upper separator line.
.. image:: transactions/statements-kanban.png
:alt: A "STATEMENT" button is visible when hovering on the line separating two transactions.
Fill out the statement's details and save. The newly created statement includes the previous
transactions following the last statement.
Statement creation from the list view
-------------------------------------
Open the list of transactions by clicking on the name of the bank journal and switching to the list
view. Select all the transactions corresponding to the bank statement, and, in the
:guilabel:`Statement` column, select an existing statement or create a new one by typing its
reference, clicking on :guilabel:`Create and edit...`, filling out the statement's details, and
saving.
Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

@@ -1,4 +1,9 @@
============================================
:show-content:
=================
Customer invoices
=================
From Customer Invoice to Payments Collection
============================================
@@ -9,7 +14,7 @@ spanning multiple invoices and taking discounts for early payments, you
can do so efficiently and accurately.
From Draft Invoice to Profit and Loss
=====================================
-------------------------------------
If we pick up at the end of a typical 'order to cash' scenario, after
the goods have been shipped, you will: issue an invoice; receive
@@ -27,7 +32,7 @@ point, Odoo supports the creation of what is called a Draft Invoice by
Warehouse staff.
Invoice creation
================
----------------
Draft invoices can be manually generated from other documents such as
Sales Orders, Purchase Orders,etc. Although you can create a draft
@@ -39,7 +44,7 @@ and delivered. It must also include other information needed to pay the
invoice in a timely and precise manner.
Draft invoices
==============
--------------
The system generates invoice which are initially set to the Draft state.
While these invoices
@@ -55,11 +60,9 @@ Let's create a customer invoice with following information:
- Unit Price: 100
- Taxes: Tax 15%
.. image:: customer_invoice/invoice01.png
:align: center
.. image:: customer_invoices/invoice01.png
.. image:: customer_invoice/invoice02.png
:align: center
.. image:: customer_invoices/invoice02.png
The document is composed of three parts:
@@ -68,7 +71,7 @@ The document is composed of three parts:
- the bottom of the page, with detail about the taxes, and the totals.
Open or Pro-forma invoices
==========================
--------------------------
An invoice will usually include the quantity and the price of goods
and/or services, the date, any parties involved, the unique invoice
@@ -80,25 +83,22 @@ then moves from the Draft state to the Open state.
When you have validated an invoice, Odoo gives it a unique number from a
defined, and modifiable, sequence.
.. image:: customer_invoice/invoice03.png
:align: center
.. image:: customer_invoices/invoice03.png
Accounting entries corresponding to this invoice are automatically
generated when you validate the invoice. You can see the details by
clicking on the entry in the Journal Entry field in the "Other Info"
tab.
.. image:: customer_invoice/invoice04.png
:align: center
.. image:: customer_invoices/invoice04.png
Send the invoice to customer
============================
----------------------------
After validating the customer invoice, you can directly send it to the
customer via the 'Send by email' functionality.
.. image:: customer_invoice/invoice05.png
:align: center
.. image:: customer_invoices/invoice05.png
A typical journal entry generated from a validated invoice will look
like as follows:
@@ -114,7 +114,7 @@ like as follows:
+-----------------------+---------------+----------------+-------------+--------------+
Payment
=======
-------
In Odoo, an invoice is considered to be paid when the associated
accounting entry has been reconciled with the payment entries. If there
@@ -133,7 +133,7 @@ follows:
+-----------------------+---------------+----------------+-------------+--------------+
Receive a partial payment through the bank statement
====================================================
----------------------------------------------------
You can manually enter your bank statements in Odoo, or you can import
them in from a csv file or from several other predefined formats
@@ -142,16 +142,14 @@ according to your accounting localisation.
Create a bank statement from the accounting dashboard with the related
journal and enter an amount of $100 .
.. image:: customer_invoice/invoice06.png
:align: center
.. image:: customer_invoices/invoice06.png
Reconcile
=========
---------
Now let's reconcile!
.. image:: customer_invoice/invoice07.png
:align: center
.. image:: customer_invoices/invoice07.png
You can now go through every transaction and reconcile them or you can mass reconcile with instructions at the bottom.
@@ -159,20 +157,17 @@ After reconciling the items in the sheet, the related invoice will now
display "You have outstanding payments for this customer. You can
reconcile them to pay this invoice. "
.. image:: customer_invoice/invoice08.png
:align: center
.. image:: customer_invoices/invoice08.png
.. image:: customer_invoice/invoice09.png
:align: center
.. image:: customer_invoices/invoice09.png
Apply the payment. Below, you can see that the payment has been added to
the invoice.
.. image:: customer_invoice/invoice10.png
:align: center
.. image:: customer_invoices/invoice10.png
Payment Followup
================
----------------
There's a growing trend of customers paying bills later and later.
Therefore, collectors must make every effort to collect money and
@@ -189,14 +184,14 @@ will be executed.
By going to the customer record and diving into the "Overdue Payments"
you will see the follow-up message and all overdue invoices.
.. image:: customer_invoice/invoice11.png
:align: center
.. image:: customer_invoices/invoice11.png
.. image:: customer_invoice/invoice12.png
:align: center
.. image:: customer_invoices/invoice12.png
.. _customer-invoices/aging-report:
Customer aging report:
----------------------
~~~~~~~~~~~~~~~~~~~~~~
The customer aging report will be an additional key tool for the
collector to understand the customer credit issues, and to prioritize
@@ -205,32 +200,44 @@ their work.
Use the aging report to determine which customers are overdue and begin
your collection efforts.
.. image:: customer_invoice/invoice13.png
:align: center
.. image:: customer_invoices/invoice13.png
Profit and loss
===============
---------------
The Profit and Loss statement displays your revenue and expense details.
Ultimately, this gives you a clear image of your Net Profit and Loss. It
is sometimes referred to as the "Income Statement" or "Statement of
Revenues and Expenses."
.. image:: customer_invoice/invoice14.png
:align: center
.. image:: customer_invoices/invoice14.png
Balance sheet
=============
-------------
The balance sheet summarizes your company's liabilities,
assets and equity at a specific moment in time.
.. image:: customer_invoice/invoice15.png
:align: center
.. image:: customer_invoices/invoice15.png
.. image:: customer_invoice/invoice16.png
:align: center
.. image:: customer_invoices/invoice16.png
For example, if you manage your inventory using the perpetual accounting
method, you should expect a decrease in account "Current Assets" once
the material has been shipped to the customer.
.. toctree::
:titlesonly:
customer_invoices/overview
customer_invoices/customer_addresses
customer_invoices/payment_terms
customer_invoices/terms_conditions
customer_invoices/cash_discounts
customer_invoices/credit_notes
customer_invoices/cash_rounding
customer_invoices/deferred_revenues
customer_invoices/electronic_invoicing
customer_invoices/snailmail
customer_invoices/epc_qr_code
customer_invoices/incoterms
@@ -176,4 +176,4 @@ into account to define if they can benefit from the cash discount or not.
whether to mark the invoice as fully paid with a write-off or as partially paid.
.. seealso::
:doc:`../customer_payments/recording`
:doc:`../payments`
@@ -0,0 +1,39 @@
==============================
Delivery and invoice addresses
==============================
Companies often have multiple locations, and it is common that a customer invoice should be sent to
one address and the delivery should be sent to another. Odoo's **Customer Addresses** feature is
designed to handle this scenario by making it easy to specify which address to use for each case.
.. seealso::
:doc:`overview`
Configuration
=============
To specify a sales order's invoice and delivery addresses, first go to :menuselection:`Accounting
--> Configuration --> Settings`. In the :guilabel:`Customer Invoices` section, enable
:guilabel:`Customer Addresses` and click :guilabel:`Save`.
On quotations and sales orders, there are now fields for :guilabel:`Invoice Address` and
:guilabel:`Delivery Address`. If the customer has an invoice or delivery address listed on their
contact record, the corresponding field will use that address by default, but any contact's address
can be used instead.
Invoice and deliver to different addresses
==========================================
Delivery orders and their delivery slip reports use the address set as the :guilabel:`Delivery
Address` on the sales order. By default, invoice reports show both the shipping address and the
invoice address to assure the customer that the delivery is going to the correct location.
Emails also go to different addresses. The quotation and sales order are sent to the main contact's
email, as usual, but the invoice is sent to the email of the address set as the
:guilabel:`Invoice Address` on the sales order.
.. note::
- Reports, such as the delivery slip and invoice report, can be :doc:`customized using Studio
</applications/productivity/studio/pdf_reports>`.
- If :doc:`Send by Post <snailmail>` is checked when you click :guilabel:`Send & Print`, the
invoice will be mailed to the invoice address.
@@ -191,5 +191,5 @@ You have three choices for the **Automate Deferred Revenue** field:
automate its sale. (see: `Choose a different Income Account for specific products`_).
.. seealso::
* :doc:`../../getting_started/initial_configuration/chart_of_accounts`
* :doc:`../get_started/chart_of_accounts`
* `Odoo Academy: Deferred Revenues (Recognition) <https://www.odoo.com/r/EWO>`_
@@ -0,0 +1,123 @@
================================================================
Electronic invoicing (:abbr:`EDI (electronic data interchange)`)
================================================================
EDI, or electronic data interchange, is the inter-company communication of business documents, such
as purchase orders and invoices, in a standard format. Sending documents according to an EDI
standard ensures that the machine receiving the message can interpret the information correctly.
Various EDI file formats exist and are available depending on your company's country.
EDI feature enables automating the administration between companies and might also be required by
some governments for fiscal control or to facilitate the administration.
Electronic invoicing of your documents such as customer invoices, credit notes or vendor bills is
one of the application of EDI.
Odoo supports, among others, the following formats.
.. list-table::
:header-rows: 1
* - Format Name
- Applicability
* - Factur-X (CII)
- All customers
* - Peppol BIS Billing 3.0
- All customers
* - XRechnung (UBL)
- All customers
* - Fattura PA (IT)
- Italian companies
* - CFDI (4.0)
- Mexican companies
* - Peru UBL 2.1
- Peruvian companies
* - SII IVA Llevanza de libros registro (ES)
- Spanish companies
* - UBL 2.1 (Columbia)
- Colombian companies
* - Egyptian Tax Authority
- Egyptian companies
* - E-Invoice (IN)
- Indian companies
* - NLCIUS (Netherlands)
- Dutch companies
* - EHF 3.0
- Norwegian companies
* - SG BIS Billing 3.0
- Singaporean companies
* - A-NZ BIS Billing 3.0
- All customers
.. note::
- The **Factur-X (CII)** format enables validation checks on the invoice and generates PDF/A-3
compliant files.
- Every PDF generated by Odoo includes an integrated **Factur-X** XML file.
.. seealso::
:doc:`../../fiscal_localizations`
.. _e-invoicing/configuration:
Configuration
=============
By default, the format available in the :ref:`send window <e-invoicing/generation>` depends on your
customer's country.
You can define a specific e-invoicing format for each customer. To do so, go to
:menuselection:`Accounting --> Customers --> Customers`, open the customer form, go to the
:guilabel:`Accounting` tab and select the appropriate format.
.. image:: electronic_invoicing/customer-form.png
:alt: Select an EDI format for a specific customer
Peppol formats
--------------
Use the fields :guilabel:`Peppol e-address (EAS)` and :guilabel:`Peppol Endpoint` to identify the
recipient in the Peppol Network.
.. seealso::
`Peppol BIS Billing 3.0 - Electronic Address Scheme (EAS) code list
<https://docs.peppol.eu/poacc/billing/3.0/codelist/eas/>`_
.. example::
.. list-table::
:header-rows: 1
* - Partner's country
- Peppol e-address (EAS)
- Peppol Endpoint
* - Luxembourg
- 9938 - Luxemburg VAT number
- a valid Luxemburgish VAT number
* - Netherlands
- 0190 - Dutch Originator's Identification Number
- a valid OIN number
* - Belgium
- 9925 - Belgium VAT number
- a valid Belgian VAT number
National electronic invoicing
-----------------------------
Depending on your company's country (e.g., :doc:`Italy <../../fiscal_localizations/italy>`,
:doc:`Spain <../../fiscal_localizations/spain>`, :doc:`Mexico
<../../fiscal_localizations/mexico>`, etc.), you may be required to issue e-invoicing documents in
a specific format for all your invoices. In this case, you can define a default e-invoicing format
for your sales journal.
To do so, go to :menuselection:`Accounting --> Configuration --> Journals`, open your sales journal,
go to the :guilabel:`Advanced Settings` tab, and enable the formats you need for this journal.
.. _e-invoicing/generation:
E-invoices generation
=====================
From a confirmed invoice, click :guilabel:`Send & Print` to open the send window. Check the
e-invoicing option to generate and attach the e-invoice file.
.. image:: electronic_invoicing/send-window.png
:alt: The Peppol option is checked and an e-invoicing XML file is attached to the email.
Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

@@ -0,0 +1,61 @@
============
EPC QR codes
============
European Payments Council quick response codes, or **EPC QR codes**, are two-dimensional barcodes
that customers can scan with their **mobile banking applications** to initiate a **SEPA credit
transfer (SCT)** and pay their invoices instantly.
In addition to bringing ease of use and speed, it greatly reduces typing errors that would
potentially make for payment issues.
.. note::
This feature is only available for companies in several European countries such as Austria,
Belgium, Finland, Germany, and the Netherlands.
.. seealso::
- :doc:`../bank`
- `Odoo Academy: QR Code on Invoices for European Customers <https://www.odoo.com/r/VuU>`_
Configuration
=============
Go to :menuselection:`Accounting --> Configuration --> Settings` and activate the :guilabel:`QR
Codes` feature in the :guilabel:`Customer Payments` section.
Configure your bank account's journal
-------------------------------------
Make sure that your :guilabel:`Bank Account` is correctly configured in Odoo with your IBAN and BIC.
To do so, go to :menuselection:`Accounting --> Configuration --> Journals`, open your bank journal,
then fill out the :guilabel:`Account Number` and :guilabel:`Bank` under the :guilabel:`Bank Account
Number` column.
.. image:: epc_qr_code/bank-journal.png
:alt: Bank account number column in the bank journal
Issue invoices with EPC QR codes
================================
EPC QR codes are added automatically to your invoices. Customers whose bank supports making payments
via EPC QR codes will be able to scan the code and pay the invoice.
Go to :menuselection:`Accounting --> Customers --> Invoices`, and create a new invoice.
Before posting it, open the :guilabel:`Other Info` tab. Odoo automatically fills out the
:guilabel:`Recipient Bank` field with your IBAN.
.. note::
In the :guilabel:`Other Info` tab, the account indicated in the :guilabel:`Recipient Bank` field
is used to receive your customer's payment. Odoo automatically populates this field with your
IBAN by default and uses it to generate the EPC QR code.
When the invoice is printed or previewed, the QR code is included at the bottom.
.. image:: epc_qr_code/invoice-qr-code.png
:alt: QR code on a customer invoice
.. tip::
If you want to issue an invoice without an EPC QR code, remove the IBAN indicated in the
:guilabel:`Recipient Bank` field, under the :guilabel:`Other Info` tab of the invoice.
Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

@@ -0,0 +1,46 @@
=========
Incoterms
=========
:abbr:`Incoterms (International Commercial Terms)` are standardized trade terms used in
international transactions to define the rights and responsibilities of buyers and sellers. They
establish the obligations related to the delivery of goods, the transfer of risks, and the
distribution of costs between the parties involved. Incoterms specify important details, such as the
point at which the risk and costs transfer from the seller to the buyer, the responsibility for
transportation, insurance, customs clearance, and other relevant aspects of the transaction.
.. note::
By default, all 11 Incoterms are available in Odoo:
- **EXW**: Ex works
- **FCA**: Free carrier
- **FAS**: Free alongside ship
- **FOB**: Free on board
- **CFR**: Cost and freight
- **CIF**: Cost, insurance and freight
- **CPT**: Carriage paid to
- **CIP**: Carriage and insurance paid to
- **DPU**: Delivered at place unloaded
- **DAP**: Delivered at place
- **DDP**: Delivered duty paid
.. seealso::
:doc:`../reporting/intrastat`
.. _incoterms/invoices:
Define an Incoterm
==================
To define an Incoterm manually, create an invoice or bill, click the :guilabel:`Other Info` tab, and
select the :guilabel:`Incoterm`.
.. _incoterms/default:
Default Incoterm configuration
==============================
You can set a default Incoterm rule to **automatically** populate the Incoterm field on all newly
created invoices and bills. Under :menuselection:`Accounting/Invoicing --> Configuration -->
Settings`, scroll down to the :guilabel:`Customer Invoices` section, and select an Incoterm in the
:guilabel:`Default Incoterm` field.

Some files were not shown because too many files have changed in this diff Show More