Woocommerce Configurations
Configurations holds the REST API credentials and webhooks that connect your ERP to your WooCommerce store. This is the first thing to set up and the first thing to check when nothing is syncing — without valid keys and a working webhook, every other screen in the module is inert.
ERP to WooCommerce Rest API Integration - Rest API Configuration
These settings establish the communication channel between the ERP and your store.
Rest API Settings
| Field | Description |
|---|---|
| WooCommerce URL | The address of your store, for example https://woostoreurl.com. |
| Consumer Key | Generated in your store's API settings. Begins ck_. |
| Consumer Secret Key | Also generated there. Begins cs_. |
Accessing the REST API Settings Page
- Log in to your WooCommerce admin dashboard.
- Go to WooCommerce > Settings.
- Open the Advanced tab.
- Select REST API from the submenu.
Adding a New API Key
- Click Add Key to open the key form.
- Give it a description you will recognise, and select the user it acts as.
- Set permissions to Read/Write — the ERP needs to write back as well as read.
- Generate the key, then copy the consumer key and secret into the fields above.
The secret is shown once. Copy it into the ERP before leaving the WooCommerce page — if you lose it there is no way to retrieve it and the key has to be revoked and recreated.
Webhook Configurations
Webhooks are what make the store push events to the ERP as they happen, rather than the ERP polling for them. A customer sign-up or a new order reaches you immediately because of these.
Accessing the Webhook Settings Page
- In the WooCommerce admin, go to WooCommerce > Settings.
- Open the Advanced tab.
- Select Webhooks.
Creating a New Webhook
- Click Add webhook.
- Name it, and set its status to Active.
- Choose the topic — order created, customer created and so on.
- Set the delivery URL to the endpoint your ERP provides.
- Save, then use WooCommerce's own delivery log to confirm it is reaching you.
Options
Additional options fine-tune how data moves between the ERP and WooCommerce.
| Option | What it does |
|---|---|
| Synchronize Stock in Hand | Yes pushes ERP stock quantity changes to WooCommerce. No leaves store stock untouched. |
| Woo Stock Location | Which inventory location the store draws stock from — Default, Secondary Warehouse and so on. |
| Sales Account | The GL account store sales are recorded to, for example 4010 - Sales. |
Leave stock synchronisation off until item mapping is complete. Pushing quantities before every product has matched to an ERP item sets store stock from records that do not line up, and the storefront starts selling what you do not have.
Order of operations
Set the API keys before the webhooks. A webhook firing at an ERP that cannot authenticate back to the store produces entries in the failure log rather than data.
Related pages
- General Settings — what to configure next
- Failure Logs — diagnosing connection problems
- Customers — what the webhook delivers