[IMP] amazon_connector: list supported marketplaces

As not all Amazon marketplaces are natively supported, and because new
ones are regularly added by Amazon, this commit adds an exhaustive list
of supported marketplaces.

It also makes a few changes to the guide for adding an unsupported
marketplace in order to point the difference between an unsupported
and an incompatible marketplace.

task-2330255

sales/amazon_connector/features.rst

@@ -1,11 +1,14 @@
-====================================
+=========================
-Amazon Connector: supported features
+Amazon Connector Features
-====================================
+=========================
 
 The **Amazon Connector** synchronizes the orders between Amazon and your Odoo database, which
 reduces considerably the amount of time spent on your Amazon Seller Central dashboard, making your
 daily routine a lot easier.
 
+Supported Features
+==================
+
 The connector is able to:
 
 - Synchronize (Amazon to Odoo) all confirmed orders (both FBA and FBM) and their order items which
@@ -49,9 +52,44 @@ The connector is able to:
 
 .. note::
    The connector is designed to synchronize orders' data as detailed above. Other actions, such as
-   downloading monthly fees report, handling disputes, or issuing refunds must be managed from
+   downloading monthly fees reports, handling disputes, or issuing refunds must be managed from
    Amazon Seller Central, as usual.
 
+.. _amazon/supported-marketplaces:
+
+Supported Marketplaces
+======================
+
+The Amazon Connector currently supports 9 marketplaces.
+If a marketplace is not listed below, it may be possible for you to :ref:`add it as an unsupported
+marketplace <amazon/add-unsupported-marketplace>`.
+
++-------------------------------+
+| **North America region**      |
++===============+===============+
+| Canada        | Amazon.ca     |
++---------------+---------------+
+| Mexico        | Amazon.com.mx |
++---------------+---------------+
+| US            | Amazon.com    |
++---------------+---------------+
+
++-------------------------------+
+| **Europe region**             |
++===============+===============+
+| Germany       | Amazon.de     |
++---------------+---------------+
+| Spain         | Amazon.es     |
++---------------+---------------+
+| France        | Amazon.fr     |
++---------------+---------------+
+| UK            | Amazon.co.uk  |
++---------------+---------------+
+| Italy         | Amazon.it     |
++---------------+---------------+
+| Netherlands   | Amazon.nl     |
++---------------+---------------+
+
 .. seealso::
    - :doc:`setup`
    - :doc:`manage`

sales/amazon_connector/setup.rst

@@ -115,47 +115,47 @@ the subtotals between Seller Central and Odoo.
    that order totals differ by a few cents from that on Seller Central. Those differences can be
    resolved with a write-off when reconciling the payments in Odoo.
 
-Add an unsupported marketplace to the Amazon Connector
+.. _amazon/add-unsupported-marketplace:
-======================================================
 
-Some Amazon Marketplaces, such as Amazon Brazil or Amazon Netherlands, are
+Add an unsupported marketplace
-not included by default in the Amazon Connector list of possible marketplaces.
+==============================
 
-These marketplaces can be added manually should you wish to use them.
+Some Amazon Marketplaces, such as Amazon Brazil, are not officially supported by Odoo but might be
+compatible with your seller account. These marketplaces can be added manually should you wish to use
+them. See :ref:`here <amazon/supported-marketplaces>` for the exhaustive list of natively supported
+marketplaces.
 
-.. important::
+.. tip::
-    These marketplaces are not officially supported by Odoo - there is no guarantee
+   To find out if a marketplace is eventually compatible, check the `Amazon Documentation
-    that adding a new marketplace as described here will work, nor can this be considered
+   <https://docs.developer.amazonservices.com/en_US/dev_guide/DG_Endpoints.html>`_. The marketplace
-    as a bug when contacting Odoo Support.
+   must belong to the same region as that of your seller account.
 
-.. note::
+To add a new marketplace, you must first enable :doc:`Developer mode
-    Amazon marketplaces are only supported in the European and North American region;
+<../../general/developer_mode/activate>`.
-    though Amazon includes Brazil with the North American region and India in the
-    European region, so your mileage may vary; check the `Amazon Documentation
-    <https://docs.developer.amazonservices.com/en_US/dev_guide/DG_Endpoints.html>`_
-    to know to which region your marketplace belongs.
 
-To add a new marketplace, you must first enable 
+Once that is done, go to :menuselection:`Sales --> Configuration --> Settings --> Connectors -->
-:doc:`Developer mode <../../general/developer_mode/activate>`.
+Amazon Sync --> Amazon Marketplaces`.
 
-Once that is done, go to :menuselection:`Sales --> Configuration --> Settings --> Connectors --> Amazon Sync -->
+From there, you can create a new marketplace record. You will need the Marketplace ID and Endpoint
-Amazon Marketplaces`.
+for your marketplace as described in the `Amazon Documentation
+<https://docs.developer.amazonservices.com/en_US/dev_guide/DG_Endpoints.html>`_.
 
-From there, you can create a new marketplace record. You will need the Marketplace ID and Endpoint for your
+Set the name of the record to ``Amazon.<domain>`` to easily retrieve it (for instance:
-marketplace as described in the
+``Amazon.se``). The **Code**, **Domain** and **API Identifier** fields should respectively hold
-`Amazon Documentation <https://docs.developer.amazonservices.com/en_US/dev_guide/DG_Endpoints.html>`_.
+the *Country Code*, *Amazon MWS Endpoint* and *MarketplaceId* values from the Amazon Documentation.
-
-Set the name of the record to ``Amazon.<domain>`` to easily retrieve it. The **Code**, **Domain** and
-**API Identifier** fields should contain the *Country Code*, *Amazon MWS Endpoint* and *MarkteplaceId*
-values from the Amazon Documentation respectively.
 
 Once the marketplace is saved, you should then update the Amazon Account configuration by going to 
-:menuselection:`Sales --> Configuration --> Settings --> Connectors --> Amazon Sync --> Amazon Accounts`,
+:menuselection:`Sales --> Configuration --> Settings --> Connectors --> Amazon Sync -->
-open the account on which you wish to use the new marketplace, go to the **Marketplaces** tab and click
+Amazon Accounts`, open the account on which you wish to use the new marketplace, go to the
-on **Update available marketplaces** (an animation should confirm the success of the operation). You can then
+**Marketplaces** tab and click on **Update available marketplaces** (an animation should confirm the
-edit the Amazon Account to add the new marketplace in the list of synchronized marketplaces - if the new
+success of the operation). Newly added marketplaces are automatically added to the list of
-marketplace is not available in the list, it means it is either incompatible with the account's region or
+synchronized marketplaces. If the new marketplace is not added to the list, it means that it is
-simply that it is not supported by the Amazon Connector.
+either incompatible or unavailable for your seller account.
+
+.. important::
+   As manually added marketplaces are not officially supported by Odoo, there is no guarantee that
+   adding one as described above will work, nor can this be considered as a bug when contacting Odoo
+   Support.
 
 .. seealso::
    - :doc:`features`