What moves, and as what
Integrator's WooCommerce to Moneybird integration books paid orders. In WooCommerce, an order with the status Processing or Completed counts as paid. Orders that are pending payment, on hold, failed, cancelled or still a checkout draft are not treated as paid. An order with a status that a plugin added is not booked as paid either.
Each paid order becomes an external sales invoice in Moneybird. That is an invoice Moneybird keeps for your books but does not send: it is not emailed to your customer. If your customers need an invoice from you, it has to come from somewhere else.
The invoice gets the contact, the order reference, the date and the order lines, each with its own VAT rate. Shipping and discounts are included. The order is then marked paid with a payment that has a date and an amount.
A refund in WooCommerce becomes a credit invoice in Moneybird. It holds the refunded lines and refunded shipping, each with its VAT rate.
- One invoice per order and one credit invoice per refund, also when an order is sent again.
- It runs every 15 minutes, and when you press Run now. Changes made in the last minute are read on the next run.
- Invoices that already exist in Moneybird are not deleted or changed.
- Orders in WooCommerce are only read, not changed.
What does not move, and what stops for review
Some orders contain things that cannot be booked safely yet. Instead of guessing, Integrator stops that order for review, explains why, and carries on with the other orders. You then book it by hand or fix the cause and send it again.
One kind of change does not move at all. Apart from refunds, changes to an order after it was booked are not followed. If you edit a booked order in WooCommerce, adjust the invoice in Moneybird by hand.
- Orders with order fees.
- Orders with compound taxes, or with more than one tax rate on one line.
- Orders whose line discounts do not add up to the order discount.
- Orders whose lines, shipping and discounts do not add up to what the customer paid, for example after a gift card or a change made by hand.
- Orders that changed while they were being read. These can be retried once the change in WooCommerce is finished.
- Refunds that return an amount that cannot be tied to one VAT rate, such as refunded shipping or an amount typed in by hand on an order with more than one VAT rate.
- Refunds with more than 50 lines, refunds that refer to a product no longer on the order, and orders with more than 10 refunds.
- Credit invoices whose lines and VAT do not add up to the amount returned to the customer.
Prepare WooCommerce
The integration works with WooCommerce 8 or later through its REST API. The shop must be on an https:// address. In WordPress, Settings, Permalinks must be set to anything other than Plain.
Create a read-only API key. Sign in to WordPress as an administrator or shop manager and go to WooCommerce, Settings, Advanced, REST API, then choose Add key. Name the key, choose a user with the Shop manager or Administrator role, set Permissions to Read and generate the key. Copy the consumer key and consumer secret straight away: WooCommerce shows the secret only once.
Enter the address your shop ends up on when you open it in a browser, with or without www exactly as it appears. An address that redirects to another one is refused. If you use a security plugin, allow /wp-json/wc/v3, the address of the WooCommerce API.
Finally, look at how your shop uses fees and taxes. Orders with order fees or compound taxes stop for review. If many of your orders have them, plan for booking those by hand.
Prepare Moneybird
One connection books in one Moneybird administration. You can sign in with Moneybird, or create a personal API token: open your name at the top right, then Developers, and create a token with the sales invoices and settings scopes. If the login opens more than one administration, also copy the administration number from the address bar, the digits after moneybird.com/.
Check your VAT rates under Instellingen, Btw-tarieven. Every VAT percentage you sell at, and every customer country you sell to, needs an active sales tax rate. Without one, those orders stop until you add the rate and send them again.
Moneybird can have several active rates with the same percentage, for example 0% for reverse charge and 0% for export. In that case, fill in the integration's settings with the name of the rate to use for orders without VAT. Copy the name exactly as Moneybird shows it.
Moneybird allows 150 requests per 5 minutes, shared with the other apps on your administration. A large backlog of orders is booked in batches. When Moneybird asks to slow down, Integrator tries again automatically.
Test before you turn it on
Start with a dry run. It reads up to 20 recent orders with real data and shows, for each one, what would be written to Moneybird. It writes nothing and opens no problems, so it is safe on a live shop.
Because the dry run looks at recent orders, place a few test orders that cover your real cases just before. Compare each proposed invoice with the order in WooCommerce: lines, VAT per line, shipping, discount and the amount paid.
After you turn the integration on, check the first real invoices in Moneybird against WooCommerce. Integrator is in beta, so treat the first days as part of the test.
- An order with products at 21% and 9% VAT.
- An order with a coupon and shipping.
- Orders with prices including and excluding VAT, if your shop has used both.
- A partial refund and a full refund.
- An order to a customer in another country.
- An order with a fee or a compound tax, if you use them, to see that it stops for review.
When an order stops
A stopped order does not hold up the others. Open the record to see when it was found, how it was prepared and what Moneybird answered, with an explanation written and approved by the CLATE team. If there is no approved explanation yet, the record says so instead of guessing.
Most stops have one of two fixes. Fix the cause and send the order again, for example after adding a missing VAT rate in Moneybird or after a change in WooCommerce has finished. Or book the order or refund by hand in Moneybird and mark the problem as solved. If every order stops for review, ask the person who administers Integrator.
Sending an order again does not create a second invoice. One case needs a manual step first: if more than one credit invoice for the customer has the same refund reference, remove the extra credit invoice in Moneybird, then try again. Integrator itself does not delete data in Moneybird.
If a system refuses the login itself, the whole run stops until you reconnect. In WooCommerce, the key may have been deleted, belong to another shop, or your web host may remove the login header: add a new Read key, and if that fails too, ask your host to pass the Authorization header to WordPress. In Moneybird, sign in again or create a new token with the sales invoices scope.
