WooCommerce Integration 2.0

March 14, 2024


Installation Instructions

  1. Navigate to the Erply backoffice
  2. Open “App Store”
  3. Search for: “WooCommerce Integration”
  4. Click on “Instal”

Setup Instructions

Click on the “Create new integration” tab and follow the steps to configure your new integration.

Step 1: Authentication

Log in to your WordPress dashboard and navigate to WooCommerce → Settings. Click on the Advanced tab and then click on the REST API tab. Click the Add Key/Create an API Key button to create a new API key. API key must have read & write permissions.

  1. Insert your consumer key and consumer secret
  2. Insert your website URL
  3. Insert your company name

Step 2: Inventory

  1. Select a warehouse - This warehouse will be associated with all incoming sales documents and product stock will also be taken from that inventory
  2. Combined inventory - You are able to combine stock quantities between multiple warehouses
  3. Select customer group - This group will be associated will all customers created by the integration
  4. Select SKU value - SKU values will be taken from the select code field
  5. Allow Backorders - Backorders can be either managed from WooCommerce or can be allowed or disabled for the entire product catalogue

Step 3: Syncing Options

  1. Select Sync Type - You can sync the entire Erply product catalogue to WooCommerce or an assortment
  2. Select Sync Rule 
    1. New Website: existing products and product groups on your woocommerce site will be removed and replaced with data coming from Erply
    2. Existing Website: existing products and groups will be left to WooCommerce and data will be added on top of that from Erply. (This will also require manual product mapping for the sync to work correctly – to do so please contact support@erply.com for further instructions)
  3. Sync Related Products - Related products can be synced to WooCommerce as either upsell or cross-sell products
  4. Select Sync Language - Language of the product fields where the data will be taken that will be imported to WooCommerce

Step 4: Payment & Pricing

  1. Document Types: 
    1. Invoice-waybills (depletes inventory quantities)
      1. Stock is moved and the transaction is completed as soon as the document comes into Erply.
    2. Orders (reserves goods by putting them in layby)
      1. A few confirmation steps required to complete the order.
      2. Used for buy online, pickup in-store orders.
  2. Automatic Payment Creation - You can choose if the integration also creates a payment to Erply or not
  3. Price List for Regular Prices - By default the product prices are taken from the product card. Alternatively it is possible to create a price list and use the prices from the price list instead
  4. Price List for Sale Prices - A price list can be created and used for showing discount prices in WooCommerce.
  5. Tax Setup
    1. Use Erply Taxes - Taxes will be synced from Erply to WooCommerce
    2. User WooCommerce Taxes - Taxes will be dynamically applied during checkout and created to Erply
  6. Shipping Item ID - Add your shipping fee productID from Erply to this field to associate incoming shipping fees

Step 5: Selective Sync & Mapping

  1. Selective sync - You can choose which fields will be synced from Erply to WooCommerce. If a field is disabled, it will not get synced or overwritten by the integration
  2. Payment types mapping - You can map together payment types/methods between WooCommerce and Erply. Mapped values will be used when creating payments to Erply
  3. Custom fields mapping - You can create custom fields in Erply and choose which fields will be synced to WooCommerce and which field type will be used in WooCommerce

Integrations Log

Integrations log will show all errors that the integration has encountered. It will show detailed responses from WooCommerce API, together with timestamps and object ID-s that were affected by the error.