This article includes instructions on how to install and configure the Shoppingfeed Module in Magento 2.

1. Module Installation
A. Choose module version
B. Create/Connect Shoppingfeed account

2. Feed (Account) Settings
A. Exportable Products
B. Automatic Refresh Option
C. Stock
D. Prices
E. Attributes
F. Images
G. Categories
H. Shipping
I. Product List
J. Orders

3. Additional Settings

A. Cron Tasks
B. Marketplace Orders
C. Shipping Method Rules
D. Product Catalog

Module Installation

Choose module version

The module is available here: https://marketplace.magento.com/shoppingfeed-magento2-manager.html

Make sure to select the correct Magento 2 version (2.3 or 2.4).

Create/Connect Shoppingfeed Account

Go to Marketing -> Shoppingfeed -> Accounts, from there you will see 2 buttons to either Create a new Shoppingfeed account or connect your Magento 2 store with the existing account by importing it.

1. Connect to your existing Shoppingfeed account.

You can either provide the API Key (Token) or enter your Shoppingfeed username and password by selecting the corresponding option. Once done, click the "Import account" button.

Once the account is connected, you will see all the relevant account details (Shoppingfeed Username, API Key (Token), Feed URL, etc.) in the Marketing -> Shoppingfeed -> Accounts section.

2) Create a new Shoppingfeed account.

Simply click on the "Create an Account" button and provide all the necessary details. Please make sure to select the country that you'd like to integrate your account with.

Feed (Account) Settings

Once the account is created/connected you can proceed with the setup by clicking Select -> Edit under the Actions section.

The settings are divided into several sections to make the setup process easier.
Feel free to skip the first "Feed - General" section and leave the setting as it is there.

Exportable Products

This section allows you to define which products need to be exported in the source feed file according to a few criteria:
- Export All Products or only Selected Products based on a given criterion;
- Export Products based on their Type and Visibility;
- Export Products based on their Condition, Status, and Availability;
- Determine how you want to export the product variations.

Automatic Refresh Option

The option defines whether each product in the catalog should be loaded individually or not. If yes - it takes longer, but in some rare cases, it helps to ensure that the correct values are retrieved for a specific attribute.

"Force Full Loading of Products for Refresh"
If the option is checked, this will systematically load the section in its entirety with each passage of the cron jobs (which can be potentially more server-intensive).
If unchecked, this will only update the data considered modified by the module.

“Force Automatic Refresh”
- No: data is only updated when a change is detected;
- Advised: the data will be updated within the specified time frame, but without blocking the generation of the feed;
- Required: the same operation as "Advised", but the feed will only be generated when this data has been updated.

This allows you to optimize your feeds according to the importance of the sections (you may want to update the stocks faster than the images or the attributes, for example).

Stock

This section allows you to configure the stock/inventory management for exportable products.

- Use Actual Stock State
If the option is checked, we will use the actual Inventory values for the products that have those values tracked in Magento.
If the option is unchecked, you can specify a default quantity for all products at once. (for example "100")

- Force Zero Quantity for Non Salable Products
Related to the "Exportable products" section which allows you to define whether or not non-saleable products are exported, and if so, with real stock or zero stock.

- Update Quantities in Real Time
Very powerful option allowing to update the stock in real-time via the Shoppingfeed API.
It is useful for small shops. If your catalog is larger than 1000 SKUs, it is better not to use this option at the risk of overloading your Magento servers.

Prices

Use Prices from Customer Group
You can use price values according to your customer groups if this has been configured in Magento previously.

Export Discount Prices in
Allows you to determine how to export the discounted price values (regular Price attribute VS separate attribute for a discounted price).

Configurable Products Price Type
Allows you to define the way to set the price on the parent for configurable products (take the maximum or the minimum among the variations on the parent product).

Attributes

This section allows you to configure the export of the product fields/attributes from Magento to the Source Feed file.

- You can determine if you want to use the generic Magento IDs or product SKUs for product IDs/SKUs in Shoppingfeed;
- You can map the corresponding Magento fields for the Brand, long/short Description, and GTIN (barcode) attributes in the Shoppingfeed;
- You can select a custom list of additional attributes that you'd like to be included in the feed.

Note: We do not recommend selecting additional price attributes since this can cause errors on the Shoppingfeed side. Price management is already automated. {price} and {price_before_discount} are the fields exported by default.

Images

This section allows you to configure the export of the Product Images in the Source Feed file.
You can export either all the images or choose a specific number of images that will be exported for each product.

Shipping

This section allows you to configure the management of your Shipping Settings for Shoppingfeed. Please note that the Shipping Settings for every channel in Shoppingfeed still need to be set up separately.
Here you can set up the placeholders and default values for different Shipping attributes like Carrier Name, and Shipping Cost.

Product List

This section includes information about all products in Magento. Here you can see if a particular product has been included in the Source Feed file as well as see the product status and other details.

You can see the details for each of the module sections and their update status by clicking on the “View Details” button on a given SKU.

Orders

This section allows you to control the Order Management between Shoppingfeed and Magento.

- Choose the day range on which the module will import your Shoppingfeed orders;
- Decide if you want to rely on the generic product IDs or SKUs when importing the orders to Magento;
- Decide if you want to block orders from import based on the product availability and the selection of required product options;
- If you have multiple stores, you can determine how the orders with SKUs that do not exist in a particular store should be processed;
- Decide if you'd like to import Customers' information from the marketplace or if the Orders will be imported using a guest mode (no customer account will be created in Magento);
- Assign a default email address if it is missing in the order details. You can assign a different email address for each marketplace;
- Assign a default phone number if it is missing in the order details;
- Assign a default address if it is missing in the order details;
- Assign a default Payment Type. You can assign a different Payment Type for orders imported from each marketplace;
- Enable the Force Cross Border Trade feature that helps to avoid discrepancies based on address and VAT for international orders;
- Decide if you want to create an invoice for all imported orders automatically;
- Decide if you'd like to import the orders to Magento if they have been Shipped/Fulfilled on the marketplace already;
- Decide if you'd like to update Magento orders accordingly if the corresponding order has been canceled on the marketplace;
- Configure synchronization actions according to the order status on the Marketplace (refusal, cancellation, refund).

Cron Tasks (Marketing tab)

The Shoppingfeed module contains 7 cron tasks configured by default. They can be found in the corresponding section of the Marketing tab.

- Synchronize Product List - updates the list of products for export (launches every hour by default);

- Force Automatic Data Refresh - forces an update of the product data in the export feed based on the delays configured in each section of the feed settings;

- Refresh Data - updates the data in the Product List section specifically;

- Export Feed - updates the data on the Source Feed URL that is used to import the product information to Shoppingfeed;

- Fetch Marketplace Orders - calls Shoppingfeed for orders and imports those orders into the "Sales -> Shoppingfeed -> Marketplace Orders" tab in Magento;

- Import Orders - brings the orders to the actual Orders pane in Magento;

- Send State Updates - sends Order Status Updates back to Shoppingfeed (Shipping / Tracking information, for example).

You can manage the corn tasks by clicking the "Select" button in the Actions Column for a corresponding task.

Marketplace Orders

Sales -> Shoppingfeed -> Marketplace Orders

In this tab, you will see all the Shoppingfeed orders and their import status.
By default, every order has 3 import attempts launched every 15 minutes by the Import Orders cron task mentioned above.

If an order has been imported to Magento successfully, you will see a button to open the corresponding Magento order in the "Actions" column.

If the order has not been imported to Magento successfully, you can either Cancel Import or Reset Import Attempts to force the import of a particular again.

You can find more detailed information about the order import as well as see the reason why a specific order has not been imported in the Order Logs section.

Sales -> Shoppingfeed -> Order Logs

Shipping Method Rules

Sales -> Shoppingfeed -> Shipping Method Rules

In this section, you can create the shipping method rules in order to automatically assign a default carrier for the Shoppingfeed orders imported from different marketplaces.

All you need to do is to create a new rule and choose its condition and assign a corresponding Shipping Method. A rule condition can be based on the product price or destination country, etc.

Product Catalog

There are Shoppingfeed sections within the Product Details page (at the very bottom) and the Attributes page in Magento. From there, you can:

- choose the store views for which the product will be enabled (related to the Exportable Products section of the module);
- choose the forced category of the product for export to Shoppingfeed instead of the original Magento category assigned to this product;
- update product attributes in bulk (in the attributes form).