Install WooCommerce

PrerequisitesCopy Anchor Link

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 keysCopy Anchor Link

To use the WooCommerce REST API with Order Invoicer, you need to generate secure API keys.

1. Access the API settingsCopy Anchor Link

1. Log in to your WordPress back office
2. Navigate to WooCommerce > Settings
3. Click the Advanced tab
4. Go to the REST API section

2. Create a new API keyCopy Anchor Link

1. Click Add key to create a new API key
2. Configure the key with the following settings:

Basic configurationCopy Anchor Link

• 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"Copy Anchor Link

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.

3. Click Generate API key

3. Retrieve the connection informationCopy Anchor Link

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 configurationCopy Anchor Link

Testing the APICopy Anchor Link

To verify that your configuration works:

1. Test API access: https://your-store.com/wp-json/wc/v3/
2. You should see a JSON page with the API information
3. If you get an error, check that:
   • WooCommerce is active
   • Your site is accessible
   • The permissions are correctly configured

Testing with the keysCopy Anchor Link

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 troubleshootingCopy Anchor Link

Configuration errorsCopy Anchor Link

"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 pluginsCopy Anchor Link

WooCommerce Price Based on Country (WCPBC)Copy Anchor Link

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 itCopy Anchor Link

1. Go to WooCommerce → Settings → Zone Pricing → Zones
2. Hover over the name of the relevant zone and click Edit
3. Find the "Round to Nearest" field
4. Clear the field (leave it empty)
5. Click Save changes
6. 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.

API usedCopy Anchor Link

Order Invoicer only uses the WooCommerce REST API v3 (https://your-store.com/wp-json/wc/v3/...), with the API key you generated above. It does not use the legacy /wc-api/v3/ API and installs no plugin on your store.

Advanced configurationCopy Anchor Link

Multi-store modeCopy Anchor Link

If you use WooCommerce in multi-store mode:

1. Create an API key for each store
2. Configure each connector with the correct keys
3. Check the permissions for each store

Field customizationCopy Anchor Link

Order Invoicer can retrieve custom fields:

1. Make sure your custom fields are visible through the API
2. Configure the mappings in Order Invoicer if necessary
3. Test the retrieval of custom data

Change the store addressCopy Anchor Link

Has your store moved to a new address (new domain or subdomain) on the same WooCommerce install? Keep your connector, its settings and its history:

1. In My applications, open your WooCommerce application.
2. Click Change store address, next to Update credentials.
3. Enter the full new address, starting with https://.

Order Invoicer checks that your current API keys work on the new address before saving it. Every connector of this application then uses it. If another connection already uses the address, contact support.

Description of synced productsCopy Anchor Link

WooCommerce products have a short and a long description. In the Products from your store card, choose under Description sent which one the product sync sends to your invoicing software:

• Short description, else the long one (default): the short description, or the long one when the product has no short description.
• Short description only: the short description. A product without one sends no description, and your invoicing software keeps the one it already has.
• Long description only: the long description, with the same rule when it is empty.
• No description: the sync sends no description.

The description is sent without formatting and limited to 255 characters. Some software, such as Axonaut, copies it onto your invoice lines: choose Short description only to keep those lines short.

SupportCopy Anchor Link

If you run into difficulties:

1. Check the troubleshooting section above
2. Consult the official WooCommerce documentation
3. 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.