Home

⌘K
  2. Home
  4. Docs
  6. Home
  8. Client Profile
  10. WooCommerce

WooCommerce

Purpose

Use the WooCommerce page to configure the client’s WooCommerce integration in Resico ERP. This page controls whether WooCommerce is enabled, stores the API connection details, defines the default unit of measure and stock balance source, and provides actions for exporting or importing all products.

Roles involved

  • System administrator
  • E-commerce manager
  • Integration / support team

Preconditions

  • You need permission to edit Client profile.
  • The WooCommerce store URL, customer key and customer secret must already be available.
  • The default unit of measure and stock balance location must already exist in Resico ERP.
  • If the client plans to use product import or export, the WooCommerce connection should be tested first on a controlled data set.

Navigation path

Client profile → WooCommerce

Step-by-step procedure

  1. Open Client profile → WooCommerce.
  2. Enable the integration using Enable WooCommerce.
  3. Enter the main connection values:
    • Woo URL
    • Woo customer key
    • Woo customer secret
  4. Select the Default UOM from the available units of measure.
  5. Select the Woo stock balance source.
    • You can choose All locations (Totals).
    • Or choose one specific location from the configured location list.
  6. Enable Woo auto sales invoice if WooCommerce orders should automatically create sales invoices in Resico.
  7. Review the WooCommerce v2 section:
    • Use Plugin download to download the Resico stock management integration plugin.
    • Review the generated API key shown on the page.
  8. If a Woo URL for access request is available, use Woo request API access to open the related request link.
  9. If Woo information is available for the client, use:
    • Woo export all products
    • Woo import all products
    to start full product synchronization.
  10. Click Save to apply the setup.
  11. Use Cancel to leave the page without saving.

Required fields

  • Woo URL
  • Woo customer key
  • Woo customer secret
  • Default UOM
  • Woo stock balance

Additional field when automatic document creation is required:

  • Woo auto sales invoice

Validation rules

  • Woo URL must point to the target WooCommerce environment.
  • Woo customer key and Woo customer secret must match the WooCommerce API credentials.
  • Default UOM must be selected from configured units of measure.
  • Woo stock balance must be either All locations or one valid configured location.
  • Product import and export actions are available only when Woo integration information is available for the client.

Exceptions

  • In some environments, WooCommerce configuration is marked as support-only and standard users may only see a support warning.
  • The Woo request API access button is shown only when a request URL is available.
  • The Woo export all products and Woo import all products buttons are shown only when the client already has Woo integration information available.
  • The right-side WooCommerce API info panel is visible only when Woo integration information exists for the client.

Common errors

  • Incorrect WooCommerce URL, customer key or customer secret prevents the integration from connecting.
  • The wrong stock balance source is selected, causing incorrect stock values to be sent to WooCommerce.
  • The wrong default UOM is selected, causing imported or exported product data to be inconsistent.
  • Users start full import or export without validating the connection first.
  • Woo auto sales invoice is enabled without confirming the downstream sales document workflow.

Troubleshooting

  • If WooCommerce synchronization does not work, first verify the Woo URL, Woo customer key and Woo customer secret.
  • If stock sent to WooCommerce is incorrect, review the selected Woo stock balance value.
  • If product synchronization behaves unexpectedly, confirm the selected Default UOM.
  • Use the Woo request API access link if API access has not yet been granted in the WooCommerce environment.
  • After saving the setup, test with a small set of products before using Woo export all products or Woo import all products.

Questions / Gaps

  • The page shows a generated API key and plugin download for the v2 flow, but the exact role of that API key in the final WooCommerce integration should be confirmed in live implementation.
  • The WooCommerce API info panel is loaded dynamically, so the exact information displayed there should be confirmed in the tenant.
  • It should also be confirmed whether Woo auto sales invoice always creates fully usable sales invoices or whether additional document processing is required after import.