Skip to content

WooCommerce Integration

← Integrations

Add photos to your inventory and choose which categories to keep in sync with your WooCommerce store.

Requirements

  • Working and web-accessible WooCommerce v2.6 +. We recommend v3.0 or higher.
Note: Currently the integration does not work with GoDaddy shared hosting services.

What it does

  • You can add photos to products (via web interface only).
  • We will create matching nested categories in WooCommerce (WC) to match what you have in RepairShopr.
  • You can choose which categories to send to your WC store.
  • You can set up webhooks to point to us and we'll try to create matching invoices/payments when your orders are marked "Complete" in WC, i.e. "Paid".
  • Syncs inventory levels based on sales in WC.
  • Imports products from WC.

What it doesn't do

  • Generate unpaid invoices.
  • Create a customer. The customer must already exist for the invoice to be created.
  • Updates products with "Maintain Stock" unchecked.
  • Sync serialized items in WC back to RepairShopr (RS). Any updates made to serialized items in WC will need to manually be made to the same items in RS.

Table of Contents

How it works
Setup
Processing Orders
Troubleshooting

 

How it works

Inventory levels will be synced when the product is updated in our software for all products that say maintain stock: true. Other products will be created and available in WC at all times.

Product imports from WooCommerce will also pull the associated product descriptions into Syncro.

Descriptions are synced from RS to WC thereafter and changes in RS will be reflected in WC. This is a one-way sync, however, and manual changes to product descriptions in WC will halt further product description syncing to prevent accidental overwrites. This behavior can be overridden by forcing a "Sync With Descriptions" from the WooCommerce app card in your RS account.

We will attempt to set the first image as the "featured image" on the product, and we'll use the same categories when we first create the products (you can edit those).

We setup a SKU on the product in WooCommerce that is an identifier we need to be able to make updates to the product and not create duplicates, so don't change that.

When we get a webhook POST about an order, we'll try to find a customer on email/phone/full name, otherwise we won't create it for you within the software.

 

Setup

1. Head to your WordPress site and make sure you have the latest WooCommerce plugin.

2. Enable the REST API in WooCommerce.
    Note: Make sure that your WordPress permalinks are enabled. The link below will walk
    you through those steps.
    https://www.2can.io/woocommerce/enable-woocommerce-api-access/


3. Setup an API key on your user, make sure it has write access.

4. In our application, head to Admin > App Center > WooCommerce to set up the app.

Be sure your URL has https, if you don't have SSL we cannot use the REST API and the integration will not work.

Your URL should be set to the root domain and should look like this: https://yourstore.com/

It should NOT look like this: https://yourstore.com/shop

To test whether you're using the correct domain, try entering the URL into your browser and adding /wc-api/v3 to the URL. The wrong URL will show a -1 or 404. The right one will display a page of data.

5. Setup the webhooks from WooCommerce to your account with us by copying the webhook URL out of the App page and putting it into WooCommerce.

6. Optionally go to products and start adding photos.

 

Processing Orders

Inside your Integration card, click the WooCommerce Orders button to see the status of your invoices. Please keep in mind that the invoice will not be created until it is in "Completed" status, in other words there needs to be a payment on the invoice for it show up in RepairShopr.

 

Those statuses are based on WooCommerce's invoice processing workflow. Please refer to WooCommerce Documentation here for more information.
WooCommerce Managing Orders

 

Troubleshooting

WooCommerce error in product sync WORDPRESS-CONNECTION-PROBLEM-401-{"errors":[{"code":"woocommerce_api_authentication_error","message":"Consumer Secret is invalid"}]}

That error means that either:

1. The consumer key/secret were not entered correctly.

2. Your host is not allowing the connection. Users with GoDaddy have not been able to connect. We are recommending https://www.bluehost.com/ as a known host that works with WooCommerce.

NOTE: We have received reports that suggest that GoDaddy shared hosting services will not pass auth headers but that the Business level may. We recommend investigating and potentially updating your hosting service.

3. The key is set to WRITE only.


Important Note:
There is know problem with iThemes security plugin for Wordpress. It doesn't allow us to sync products. To work around this you need to turn off the setting "iThemes plugin > System Tweaks > Filter Long URL Strings" in your WordPress to allow us sync products.

Feedback and Knowledge Base

(thinking…)