[IMP] sales: update list products on ebay for 16

content/applications/sales/sales/ebay_connector/manage.rst

@@ -1,50 +1,105 @@
-======================
-How to list a product?
-======================
+=====================
+List products on eBay
+=====================
 
-Listing without variation
-=========================
+Odoo makes it possible for users to list products on eBay through the database by implementing the
+following configurations.
 
-In order to list a product, you need to check the **use eBay** field on a product
-form. The eBay tab will be available.
+Listing (without product variants)
+==================================
 
-.. image:: manage/manage01.png
-  :align: center
+To list a product on eBay through Odoo, some necessary configurations must be completed on the
+desired product form.
 
-When the **Use Stock Quantity** field is checked, the quantity sets on eBay will
-be the Odoo **Forecast Quantity**.
+To access products, navigate to :menuselection:`Sales app --> Products --> Products`, and select the
+desired the product to be listed on eBay.
 
-The **Description Template** allows you to use templates for your listings. The
-default template only use the **eBay Description** field of the product. You can
-use html inside the **Description Template** and in the **eBay Description**.
+Once on the product form, open the :guilabel:`eBay` tab. Under the :guilabel:`eBay` tab, check the
+box beside :guilabel:`Sell on eBay`.
 
-To use pictures in your listing, you need to add them as **Attachments** on the product template.
+.. image:: manage/sell-on-ebay-checkbox.png
+   :align: center
+   :alt: The sell on eBay checkbox under the ebay tab on a product form in Odoo sales.
 
-Listing with variations
-=======================
+Upon activating that feature, a number of other options appear in the :guilabel:`eBay` tab on the
+product form. These fields can be used to customize the configuration of the product, and how it
+appears on eBay.
 
-When the **use eBay** on a product with variations is checked and with **Fixed
-Price** as **Listing Type**, the eBay form is slightly different. In the
-variants array, you can choose which variant will be listed on eBay as well as
-set the price and the quantity for each variant.
+.. image:: manage/sell-on-ebay-configurations.png
+   :align: center
+   :alt: The sell on eBay configurations under the ebay tab on a product form in Odoo sales.
 
-.. image:: manage/manage02.png
-  :align: center
+.. tip::
+   The :guilabel:`Description Template` allows the use of templates for eBay listings. To create a
+   template, type the desired name of the template in the :guilabel:`Description Template` field,
+   and click :guilabel:`Create and edit...` from the drop-down menu that appears.
 
-Listing with item specifics
-===========================
+   When that's selected, a :guilabel:`Create Description Template` pop-up form appears, in which
+   the body of the description can be added, along with any attachments that may be necessary.
 
-In order to add item specifics, you should create a product attribute with one
-value in the **Variants** tab on the product form.
+   .. image:: manage/create-description-template-popup-form.png
+      :align: center
+      :alt: The crete description template pop-up form in eBay tab on product form in Odoo sales.
 
-.. image:: manage/manage03.png
-  :align: center
+Listing (with product variants)
+===============================
 
-Product Identifiers
+When the :guilabel:`Sell on eBay` feature is activated under the :guilabel:`eBay` tab on a product
+form for a product with variants, the available field configurations are the same as products
+without variants.
+
+However, when the :guilabel:`Listing Type` is changed to :guilabel:`Fixed Price`, Odoo presents a
+variant table at the bottom of the :guilabel:`eBay` tab, in which the :guilabel:`Fixed Price` can be
+entered, and the decision to :guilabel:`Publish on eBay` can be made for specific variants, along
+with other options.
+
+.. image:: manage/fixed-listing-price.png
+   :align: center
+   :alt: The fixed price listing type in the eBay tab on a product form in Odoo sales.
+
+Listing (with item specifics)
+=============================
+
+In order to add product specifics, such as brand names, a product attribute dedicated to that
+specific detail should be created -- with that detail represented by a single value -- in the
+:guilabel:`Attributes & Variants` tab of the product form.
+
+Open the desired product form, and click into the :guilabel:`Attributes & Variants` tab.
+
+Then, click :guilabel:`Add a line`, name the :guilabel:`Attribute` after the product detail (e.g.
+`Brand`), and enter the specific detail in the :guilabel:`Values` column (e.g. `Apple`).
+
+.. image:: manage/item-specific-listing-variants.png
+   :align: center
+   :alt: Sample of product specific variant listing for eBay purposes in Odoo sales.
+
+List item on eBay
+=================
+
+Once all configurations and customizations have been entered on the product form, click the
+:guilabel:`List Item on eBay` button to list that product on the synchronized eBay account.
+
+Or, click the :guilabel:`Link With Existing eBay Listing` to combine the product with an existing
+product listing on the synchronized eBay account.
+
+.. important::
+   Products can **only** be listed or linked to eBay if the proper configurations have been made to
+   synchronize an eBay account with Odoo. Check out the documentation on
+   :doc:`/applications/sales/sales/ebay_connector/setup` to learn more.
+
+Product identifiers
 ===================
 
-Products identifiers such as EAN, UPC, Brand or MPN are required in most of the eBay category.
-The module manages the EAN and UPC identifiers with the **Barcode** field of the product variant.
-If the **Barcode** field is empty or is value is not valid, the EAN and UPC values will be set as 'Does not apply' as recommended by eBay.
-The Brand and MPN values are working as item specifics and should be define in the **Variants** tab on the product form.
-If these values are not set, 'Does not apply' will be used for the eBay listing.
+Different product identifiers (such as EAN, UPC, Brands, or MPN) are required in most of the
+categories on eBay listings.
+
+The module manages EAN and UPC identifiers via the :guilabel:`Barcode` field on the product form in
+Odoo. However, if the :guilabel:`Barcode` field is empty, or the value itself is not valid for any
+reason, the EAN and UPC values are set as `Does not apply`, as recommended by eBay.
+
+The Brand and MPN (Manufacturing Part Number) values of a product operate as item specifics, and
+should be defined in the :guilabel:`Attributes & Variants` tab. If these values are *not* set in
+this fashion, a similar `Does not apply` is used for the eBay listing.
+
+.. seealso::
+   :doc:`/applications/sales/sales/ebay_connector/setup`