Install WooCommerce
Configure WooCommerce for integration with Order Invoicer
Prerequisites
Before starting the installation, make sure that:
- Your WordPress is up to date (version 5.8+ recommended)
- WooCommerce is installed and active (version 6.0+ recommended)
- You have access to the WordPress back office with administrator rights
- Your site is accessible via HTTPS
Generate WooCommerce API keys
To use the WooCommerce REST API with Order Invoicer, you need to generate secure API keys.
1. Access the API settings
- Log in to your WordPress back office
- Navigate to WooCommerce > Settings
- Click the Advanced tab
- Go to the REST API section
2. Create a new API key
- Click Add key to create a new API key
- Configure the key with the following settings:
Basic configuration
- Description: Add a clear description (e.g. "Order Invoicer - Sellsy Integration")
- User: Select an administrator user or a user with sufficient rights
- Permissions: In the Permissions dropdown, choose Read/Write. This level is required — do not choose "Read", or the connection will not work.
Why you must choose "Read/Write"
WooCommerce lets you pick one permission level for the key: Read, Write, or Read/Write. You cannot allow only certain data — it is a single setting that covers everything. Always choose Read/Write.
Order Invoicer reads the following from your shop to create your invoices:
- Your orders
- Your customers
- Your products
- Your taxes
Order Invoicer also needs to send a few things back to your shop, which is why a "Read" (read-only) key is not enough:
- It picks up your new orders automatically, so you never have to import them by hand
- It marks an order as paid in WooCommerce once the payment is confirmed
- It keeps your products and stock levels up to date, if you have turned on product and stock synchronization
Important: If you choose "Read" instead of "Read/Write", the connection will fail. Make sure you select Read/Write.
- Click Generate API key
3. Retrieve the connection information
After generating the key, immediately note the following information:
- Your store URL:
https://your-store.com - Consumer Key: The generated public key
- Consumer Secret: The generated private key
Important:
- Keep this information secure
- The secret key will no longer be visible after you close this page
- You will need it to configure the connector in Order Invoicer
4. Verify the configuration
Testing the API
To verify that your configuration works:
- Test API access:
https://your-store.com/wp-json/wc/v3/ - You should see a JSON page with the API information
- If you get an error, check that:
- WooCommerce is active
- Your site is accessible
- The permissions are correctly configured
Testing with the keys
You can test access with your keys using a tool such as cURL:
curl -X GET "https://your-store.com/wp-json/wc/v3/orders" \
-H "Authorization: Basic [your-base64-encoded-key]"Common troubleshooting
Configuration errors
"WooCommerce not active" error
- Check that WooCommerce is installed and active
- Check that you are on the correct version of WooCommerce
"Invalid API keys" error
- Check that you copied the complete keys
- Make sure the key is active
- Check the permissions granted to the user
"Access denied" error
- Check that your store URL is correct
- Make sure your site is accessible over HTTPS
- Check that the user has sufficient rights
"API not accessible" error
- Check that WordPress permalinks are configured
- Temporarily disable security plugins
- Check the web server configuration
Incompatible plugins
WooCommerce Price Based on Country (WCPBC)
If you use the Price Based on Country for WooCommerce plugin (Pro version), you must disable the "Round to Nearest" option in the settings of your pricing zones.
This option rounds the prices converted by the exchange rate to obtain more "elegant" prices (for example rounding to the nearest 0.50 CHF). This creates discrepancies between the actual amounts of the WooCommerce order and the amounts calculated by Order Invoicer, which can lead to differences on the generated invoices.
How to disable it
- Go to WooCommerce → Settings → Zone Pricing → Zones
- Hover over the name of the relevant zone and click Edit
- Find the "Round to Nearest" field
- Clear the field (leave it empty)
- Click Save changes
- Repeat for each pricing zone
Important: The values offered by the plugin (500, 50, 5, 0.50, 0.05) modify the unit prices. This causes inconsistencies between the amount invoiced by WooCommerce and the amount recalculated by Order Invoicer.
Advanced configuration
Multi-store mode
If you use WooCommerce in multi-store mode:
- Create an API key for each store
- Configure each connector with the correct keys
- Check the permissions for each store
Field customization
Order Invoicer can retrieve custom fields:
- Make sure your custom fields are visible through the API
- Configure the mappings in Order Invoicer if necessary
- Test the retrieval of custom data
Support
If you run into difficulties:
- Check the troubleshooting section above
- Consult the official WooCommerce documentation
- Contact our support:
contact@orderinvoicer.com
Note: Once this configuration is complete, you can move on to the next step: configuring the connector in Order Invoicer.