Connect and set up WooCommerce integration

By default, WooCommerce integration uses webhooks. Webhooks can retrieve product updates in near-real time. If webhooks are not supported, Marketplacer uses API polling to retrieve product updates every 15 minutes.

Configure WooCommerce

To establish an API connection between WooCommerce and Marketplacer, you must first complete these steps in your WooCommerce Admin: 

Refer to the Generate API keys section in this article from WooCommerce to get your API consumer key and consumer secret key. 

1. WordPress Permalinks must be enabled in Settings > Permalinks.
   

2. To generate the API Keys required for Marketplacer, go to WooCommerce > Settings. 
   
   
3. When the page loads, go to Advanced > REST API. Click Add key to generate an API key for Marketplacer.
   
4. Provide a Description.
5. From the User dropdown, select the user that you want to generate a key for.
   
   Note: This user needs to have admin access. Ensure that the associated user account for this API key is a site administrator with full privileges to manage the WooCommerce site.
6. Select the level of access (permission) to Read/Write access.
7. Click Generate API Key. WooCommerce creates API keys for that user. 
   
   
8. After you select Generate API Key, copy the Consumer Key and the Consumer Secret keys. These keys are required to be entered in Marketplacer.
   
   This sets up the WooCommerce side of the integration. You can now set up the Marketplacer side.

Connect to Marketplacer

After configuring API access, set up the Marketplacer integration.

Start with manual product sync to verify the import before enabling automatic sync.

For images, select Sync images to use WooCommerce images or Don’t sync images for Marketplacer-specific ones.

For manual invoice management, select Don’t sync invoices.

If migrating from manual invoicing, select Sync invoices and set a start date.

For automatic invoicing from the start, select Sync invoices without a date.

To connect to Marketplacer

1. Sign in to the Seller Portal.
2. Go to:
   • Legacy Portal: API & Integrations from the account settings menu.
   • Seller Portal 2.0: Extensions > MConnect.
3. Click Go to MConnect to launch the setup wizard.
4. On the Select your integration platform tab, choose WooCommerce.
5. Click Set my account type to continue. In the Choose what to sync tab, configure:
   • Products:
     • Sync automatically: Product data imports automatically.
     • Sync manually: Trigger imports manually through the Import menu.
   • Images:
     • Sync images: Pull images from WooCommerce to Marketplacer.
     • Don’t sync images: Skip image synchronization.
   • Invoices:
     • Sync invoices: Syncs invoices to WooCommerce as orders. Use the Date field to specify when to start syncing invoices.
     • Don’t sync invoices: Disables invoice synchronization.
6. Click Continue to move to the Configure currency conversion tab:
   • Select the currency to convert from, then click Enable currency conversion if needed.
     Otherwise, choose Don’t use currency conversion.
     
     Note: Configuring currency conversion after the initial import requires a full re-import to update product pricing.
7. On the Connect your WooCommerce account tab, enter the WooCommerce Store URL, Consumer Key, and Consumer Secret Key.
8. Click Submit. If successful, a notification appears at the top of the page.
9. Once the connection is successful, two buttons appear:
   • Start Import: Manually begin product import. See WooCommerce integration for sellers: Manual product import.
   • Review settings: See WooCommerce integration for sellers: Review settings.
10. Select Start Import to begin the initial product import from WooCommerce.

Initial product import

The initial import fetches the product (advert) details from the WooCommerce store and loads them into Marketplacer. All products (adverts) in the WooCommerce Online Store sales channel are imported unless changes are made to the settings that exclude products based on stock levels or brands.

If you did not select the import option in the previous step, you can start the import manually.
For more information, see WooCommerce integration for sellers: Manual product import.

You can view the outcome of the import in the Imports menu in the Seller portal. The issues that may occur with the data you imported are listed on that page. You can correct the errors in WooCommerce if possible and re-import the data.

Once you have run the initial import, you will see product (advert) details on the Items page.

Next steps

1. Review and publish products (adverts)
2. Review the settings and enable product imports.