Skip to main content

Installation manual for the WooCommerce Moneybird integration

Updated today

Connect WooCommerce with Moneybird and automatically process orders as invoices. WooCommerce orders are directly visible in Moneybird. Save time on your accounting.


1. Connect to WooCommerce

To connect to WooCommerce, you need an API key and API secret.

Connect to WooCommerce

  1. Log in to your WordPress environment.

  2. In the WooCommerce plugin, go to Settings.

  3. Click on Advanced, then select REST API.

Creating an API Key

  1. Click Add key to create a new API key.

  2. Enter a description, for example, Combidesk.

  3. Select the desired user.

  4. Under Permissions, choose Read/Write.

  5. Save the key and note both the API key and API secret, as you will need them later for the integration.

Setting Pretty Permalinks

To use the WooCommerce API, your WordPress environment must have pretty permalinks enabled.

  1. Go to Settings → Permalinks in WordPress.

  2. Check that the permalink structure is not set to Plain.

    • If it is already set to something other than Plain, no changes are needed.

    • If it is set to Plain, choose a different structure from the list (for example, Post name). Confirm this with your website administrator.

  3. Save the settings.

Updating WordPress and WooCommerce

It is recommended to update both your WordPress environment and the WooCommerce plugin to the latest version.

  • This prevents compatibility issues when using the API.

Installing the WooCommerce Integration

  1. In Combidesk, search for the desired WooCommerce integration.

  2. Click Install this integration.

  3. Connect your WooCommerce account:

    • Enter the URL of your webshop in the top field, for example: https://webshop.nl.

    • Paste the previously created API key in the API key field.

    • Paste the corresponding API secret in the other field.


2. Connect to Moneybird

To connect to Moneybird, click the "Connect your.." button:

If you're not logged on to Moneybird, you'll see this login screen:

After logging in with a user account with sufficient rights, you will see the screen where you can give the app access to your administration:

Here, select the relevant administration and click "Toestaan." Combidesk will now have access to the data in your administration via the Moneybird API.


3. Configuration of the integration

For the integration to work properly, it must be configured correctly. In the paragraph below, we'll go through all the steps of the integration in sequence. Before starting the installation, we recommend that you first carefully read through these steps.


Configure these WooCommerce steps:

  • Select statuses
    Select the statuses at which an order should be synchronised. Make sure the order is no longer edited. More details can be found in this article.

  • Export existing orders

  • Transfer order numbers or invoice numbers
    If you use the WooCommerce 'PDF Invoices & Packing Slips' plug-in, you can choose to transfer order numbers or invoice numbers with PDF attachment to Moneybird.
    Make sure you set 'Document link access type' under WooCommerce > PDF Invoices > Advanced > Settings to 'Full'.

  • Transfer order numbers or invoice numbers
    If you use the WooCommerce 'PDF Invoices & Packing Slips' plug-in, you can choose to transfer order numbers or invoice numbers to Moneybird.
    Make sure you set 'Document link access type' under WooCommerce > PDF Invoices > Advanced > Settings to 'Full'.


Configure these Moneybird steps:

  • Select a ledger account
    This ledger account is used when creating the invoice

  • Insert orders as
    Specify how the orders should be inserted into Moneybird.

  • Select an invoice profile
    This profile is used creating the sales invoice

  • Transfer order line amounts including or excluding VAT?
    Should the order line prices from WooCommerce be inserted including tax in Moneybird?

  • Desired invoice status, and preference for sending the invoice
    Indicate what status the sales invoice should have in Moneybird. You can also choose to have Moneybird send the invoice. In that case, the standard shipping method for the Moneybird contact will be applied.

    Note! We only do the actual sending for invoices that are not part of the initial export of invoices.

  • Register payment
    Do paid invoices have to be registered as 'paid' in Moneybird (note that they have to be marked as 'sent' too in that case)?
    Choose 'Yes' if you use a PSP and want automatic reconciliation.

  • Select workflow
    This workflow will be added to the sales invoices

  • Alternative workflow for credit orders
    If you select a workflow here, it will be added to the credit invoices instead of the previously selected workflow

  • Select firstname format for Moneybird
    We can either fill the firstname with the firstname of WooCommerce, or fill it with the initials as stored in WooCommerce. In case no initials are available, we'll determine them based on the firstname. Additionally, we can prefill a salutation, possibly based on the gender in WooCommerce.

  • Add product numbers to invoice lines
    Should product numbers be added to the invoice lines?

  • Invoice numbers
    Do you want to use the invoice numbers of WooCommerce? If so, make sure you adjust the Invoice id template in Moneybird to '{id}' (via Settings -> Numbering & mail copy). Note that this means that you should not make any invoices in Moneybird yourself, since the invoice numbering needs to be sequential.

  • Select a ledger account for shipping costs
    This ledger account is used for the shipping costs invoice line when creating the invoice

  • Select a ledger account for other costs
    This ledger account is used for other costs invoice line when creating the invoice

  • Moneybird VAT mapping
    Connect the VAT categories of WooCommerce to your Moneybird account

  • How do you want to handle VAT for orders to individuals in other EU countries?
    Do you ship to individuals in other EU countries? Then you can pick one of the VAT arrangements below. If you want to keep using the rules of before July 1, 2021, select "Charge VAT based on the webshop's country", then the regular VAT of your country will be charged.

    Make sure you webshop configuration aligns with this choice!

    For more information, please see this Moneybird article (Dutch).

  • Customer id for Point of Sale orders
    Do you make use of a Point of Sale in WooCommerce and do you want to book these orders in Moneybird as well? Then please enter the customer id of the customer on which these orders should be booked below.

  • Default debtor
    Enter the customer number of the contact in Moneybird on which all orders should be booked. You can find this number in Moneybird under Contacts → click the desired contact → the customer number is shown in the top left of the contact page. This means the integration will not create new contacts in your Moneybird administration.

    Don't have a default debtor yet? Click the button below to create one automatically.

  • Use default customer for B2C only
    Do you want the default customer to be used only for consumer (B2C) customers? If enabled, business (B2B) customers will be created as separate contacts, ensuring that the ICP declaration is processed correctly.

  • Service level
    Pick a Service level matching your needs. You can always change the it at a later time, and the price will be adjusted accordingly.


4. The Combidesk customer dashboard

How does the dashboard work?

If you've created a new Combidesk account or installed a integration, you'll receive an email with access to your Combidesk account. When you log in to combidesk.com, you'll arrive at the dashboard. This is where your integration is located. From here, you can easily adjust your integration and account settings, view the integration logs (history), and access support.

What can you view via your Combidesk account?

From your Combidesk dashboard you also have access to your account settings, connected accounts, billing and support.


5. What can you expect from Combidesk?

We understand you're busy or perhaps have little software experience. That's why our specialized team is always ready to help. Take advantage of our installation packages to save yourself even more time.

Installation appointment

If you're short on time or would like us to handle the entire installation, take advantage of our remote implementation support. We'll take care of everything for you right away and deliver a fully functional connection. For most connections, installation support costs a fixed fee of €150, while others cost €300. If you decide not to continue with the connection after the trial period, there's no charge. Schedule an installation appointment below and schedule it right away.

Explanation of service level (SLA) subscriptions (Basic, Pro, Premium)

To help you use our integration effectively, we offer three service levels: basic, pro, and premium. You can always change the service level in your integration. The price will be adjusted for the next billing period.

Did this answer your question?