[ADD] shoppingfeed_integration

TT56368

Author: juancarlosonate-tecnativa

shoppingfeed_integration/README.rst

@@ -0,0 +1,256 @@
+========================
+Shoppingfeed Integration
+========================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:900310fb90d1b308542f357095bbe83e185157a9bf74ec78154f8f636d4d8098
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fshoppingfeed-lightgray.png?logo=github
+    :target: https://github.com/OCA/shoppingfeed/tree/18.0/shoppingfeed_integration
+    :alt: OCA/shoppingfeed
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/shoppingfeed-18-0/shoppingfeed-18-0-shoppingfeed_integration
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/shoppingfeed&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module integrates Odoo with Shoppingfeed, a platform that connects
+your store with multiple marketplaces.
+
+- Export product catalogs to Shoppingfeed in XML format
+- Import orders from connected marketplaces automatically
+- Synchronize product prices and stock levels in real-time
+- Map marketplace channels to Odoo sale order types
+- Map delivery carriers from marketplaces to Odoo carriers
+- Track Shoppingfeed tickets and notifications
+- Configure export filters by product type, category, and stock
+  availability
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+Store Setup
+-----------
+
+Create and authenticate your store
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Go to **Shoppingfeed → Stores**
+2. Click **New** and fill:
+
+   - **Username**: Shoppingfeed API email
+   - **Password**: Shoppingfeed API password
+
+3. Click **Get Token** button
+
+   - Automatically retrieves: catalog ID, channels, country, and
+     language
+
+Configure product export
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+In the store form, configure these tabs:
+
+Exportable Products tab
+^^^^^^^^^^^^^^^^^^^^^^^
+
+- **Export only selected**: Only export products with "Export to
+  Shoppingfeed" enabled
+- **Export Product Types**: Select product types to include (Goods,
+  Services, Combos)
+- **Export Rules**: Control which products to include:
+
+  - Out of stock products
+  - Archived products
+  - Non-salable products
+
+Stock tab
+^^^^^^^^^
+
+- **Use actual stock state**: Use real quantities vs default quantity
+- **Quantity type**: Salable (on-hand) or Virtual (forecasted)
+- **Default quantity**: Quantity for products without stock tracking
+- **Force zero quantity non salable**: Set 0 for non-salable products
+- **Update quantities realtime**: Push stock changes immediately to
+  Shoppingfeed
+
+Prices tab
+^^^^^^^^^^
+
+- **Pricelist**: Optional pricelist for computing export prices
+
+Attributes tab
+^^^^^^^^^^^^^^
+
+- **Use product ID as SKU**: Use product ID instead of default code
+- **Custom SKU field**: Select custom field for SKU (optional)
+- **Additional attribute fields**: Add custom product fields to export
+
+Images tab
+^^^^^^^^^^
+
+- **Export all images**: Include all product images
+- **Exported image count**: Limit number of images (if not exporting
+  all)
+
+Categories tab
+^^^^^^^^^^^^^^
+
+- **Allowed categories**: Restrict export to specific product categories
+
+Shipping tab
+^^^^^^^^^^^^
+
+- **Default delivery carrier**: Fallback carrier for unmapped carriers
+- **Carrier mappings**: Map Shoppingfeed carrier names to Odoo carriers
+
+  - Add lines with Shoppingfeed carrier name and corresponding Odoo
+    carrier
+
+Orders tab
+^^^^^^^^^^
+
+- **Import orders**: Enable automatic order import
+- **Default payment term**: Payment terms for imported orders
+- **Default payment mode**: Payment mode for imported orders
+- **Default order type**: Order type for imported orders
+- **Marketplace customer groups**: Map channels to specific order types
+
+  - Add lines with Channel and Order Type
+
+Product Setup
+-------------
+
+Mark products for export
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Open a product
+2. In **Shoppingfeed** tab:
+
+   - Enable **Export to Shoppingfeed** (if store requires it)
+   - Select **Shoppingfeed Stores** to export this product to
+
+**Note**: Products need default code (internal reference) to export.
+
+Catalog Feed
+------------
+
+After configuration, your XML catalog feed is available at:
+
+::
+
+   https://yourdomain.com/catalog/{catalog_id}.xml
+
+Share this URL with Shoppingfeed for product synchronization.
+
+Usage
+=====
+
+Product Updates
+---------------
+
+Price changes
+~~~~~~~~~~~~~
+
+Product price updates send automatically to linked Shoppingfeed stores.
+
+Stock changes
+~~~~~~~~~~~~~
+
+Stock updates send automatically if store has **Update quantities
+realtime** enabled.
+
+Orders
+------
+
+View orders
+~~~~~~~~~~~
+
+Go to **Shoppingfeed → Marketplace Orders** to see marketplace orders.
+
+Orders show:
+
+- Shoppingfeed Order ID
+- Shoppingfeed Reference
+- Shoppingfeed Store
+- Shoppingfeed Channel (Amazon, eBay, etc.)
+- Shoppingfeed Status
+
+Process orders
+~~~~~~~~~~~~~~
+
+1. Confirm order
+2. Validate delivery → shipment info sends to Shoppingfeed
+3. Validate invoice → PDF uploads to Shoppingfeed (if channel supports
+   it)
+
+Orders auto-acknowledge in Shoppingfeed on import.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/shoppingfeed/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/shoppingfeed/issues/new?body=module:%20shoppingfeed_integration%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+-------
+
+* Tecnativa
+
+Contributors
+------------
+
+- `Tecnativa <https://www.tecnativa.com>`__:
+
+  - Juan Carlos Oñate
+
+Maintainers
+-----------
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+.. |maintainer-juancarlosonate-tecnativa| image:: https://github.com/juancarlosonate-tecnativa.png?size=40px
+    :target: https://github.com/juancarlosonate-tecnativa
+    :alt: juancarlosonate-tecnativa
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-juancarlosonate-tecnativa| 
+
+This module is part of the `OCA/shoppingfeed <https://github.com/OCA/shoppingfeed/tree/18.0/shoppingfeed_integration>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

shoppingfeed_integration/__init__.py

@@ -0,0 +1,2 @@
+from . import controllers
+from . import models

shoppingfeed_integration/__manifest__.py

@@ -0,0 +1,35 @@
+# Copyright 2025 Juan Carlos Oñate - Tecnativa <juancarlos.onate@tecnativa.com>
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
+{
+    "name": "Shoppingfeed Integration",
+    "version": "18.0.1.0.2",
+    "summary": "Integrate Odoo with Shoppingfeed for product export and order sync",
+    "category": "Sales",
+    "author": "Tecnativa, Odoo Community Association (OCA)",
+    "maintainers": ["juancarlosonate-tecnativa"],
+    "website": "https://github.com/OCA/shoppingfeed",
+    "license": "AGPL-3",
+    "depends": [
+        "stock",
+        "website_sale",
+        "product_brand",
+        "sale_order_type",
+        "account_payment_sale",
+    ],
+    "data": [
+        "security/shoppingfeed_security.xml",
+        "security/ir.model.access.csv",
+        "security/ir_rule.xml",
+        "views/sale_order_views.xml",
+        "views/shoppingfeed_ticket_views.xml",
+        "views/shoppingfeed_store_views.xml",
+        "views/shoppingfeed_log_views.xml",
+        "views/product_template_views.xml",
+        "views/product_pricelist_views.xml",
+        "views/shoppingfeed_channel_views.xml",
+        "views/product_attribute_views.xml",
+        "views/menus.xml",
+        "data/cron.xml",
+    ],
+    "installable": True,
+}

shoppingfeed_integration/controllers/__init__.py

@@ -0,0 +1 @@
+from . import catalog