Booksmor Accounting | Simplified
Start free trial

Connect WooCommerce to Booksmor

This guide walks you through connecting your WooCommerce store to Booksmor so that every order, edit, and refund posts into your books automatically — with the right GST handling.

This guide walks you through connecting your WooCommerce store to Booksmor so that every order, edit, and refund posts into your books automatically — with the right GST handling.

Time to set up: ~5 minutes. You’ll need: a WordPress admin account on your store, and your Booksmor account.

What you get when this is done

  • Every new WooCommerce order → posted automatically as a Sales voucher in Booksmor (with GST split correctly based on the buyer’s state).
  • Every refund issued in WooCommerce → automatically becomes a Credit Note in Booksmor, linked to the original sale.
  • Edits made to an order after creation (qty change, line added, price changed) → posted as a Debit Note (if the new total is higher) or Credit Note (if lower) for the financial difference. Your original sales voucher stays intact for audit.
  • A live activity log in Booksmor showing every order Booksmor has received from your store, with delivery status.

Step 1 — Create the WooCommerce connection in Booksmor

  1. Sign in to your Booksmor account: https://app.booksmor.com.
  2. From the left sidebar, click E-Commerce.
  3. Click + Connect store (top right).
  4. In the dialog:
    • Platform: select WooCommerce.
    • Display name: anything — e.g. “Main store” or “shop.example.com”. This is just how it appears in your Booksmor dashboard.
  5. Click Save.

You’ll be returned to the E-Commerce overview list with your new connection. Click its name to open the detail page.

Step 2 — Download the Booksmor plugin

On the connection detail page, scroll to the Booksmor for WooCommerce plugin card. Click the big ↓ Download .zip (v1.0.2) button.

A ~20 KB ZIP file (booksmor-for-woocommerce-1.0.2.zip) downloads to your computer.

Optional / advanced: if you’d rather wire up the webhooks by hand without the plugin, scroll to the Webhook URL card on the same page — it shows the URL and signing secret you’d need to register manually in WooCommerce → Settings → Advanced → Webhooks. The plugin handles all of this for you; only do this if you have a specific reason not to install plugins.

Step 3 — Install the plugin in WordPress

In your WordPress admin (yourstore.com/wp-admin):

  1. Go to Plugins → Add New Plugin.
  2. Click Upload Plugin (top of page).
  3. Choose the booksmor-for-woocommerce-1.0.2.zip you just downloaded.
  4. Click Install Now.
  5. After install completes, click Activate Plugin.

If WooCommerce isn’t yet active on your site, the plugin will display a yellow notice asking you to activate WooCommerce first.

Step 4 — Generate a pairing code in Booksmor

Back in Booksmor, on the same connection detail page (Step 1):

  1. In the Booksmor for WooCommerce plugin card, click Generate pairing code.
  2. An 8-character code appears (e.g. WKhcX0DY) with a timer — it’s valid for 10 minutes.
  3. Copy the code (button next to it) or just remember it.

Step 5 — Pair the plugin in WordPress

In your WordPress admin:

  1. From the left sidebar, click WooCommerce → Booksmor.
  2. You’ll see a “Pair this site with your Booksmor account” form.
  3. Paste the 8-character pairing code into the Pairing code field.
  4. Click Pair this site.

The plugin will:

  • Contact Booksmor and exchange the code for your real connection credentials.
  • Automatically register two webhooks in your WooCommerce site: order.created and order.updated.
  • Show a green “Paired with Booksmor” status panel.

You’re connected.

Step 6 — Verify it works

Place a test order in your WooCommerce store:

  1. In your WP admin: WooCommerce → Orders → Add order.
  2. Add any product, set status to Processing, save.

Within a few seconds:

  • In Booksmor → E-Commerce → your connection → scroll to Recent activity from your store: you’ll see “New order #…” with a green Saved ✓ pill.
  • In Booksmor → Transactions: a posted sales voucher with the order id as its reference number.

Try a refund too:

  1. In WP admin: open the order → Refund button → refund one line item → save.
  2. In Booksmor: within seconds, “Refund issued #…” appears in Recent activity, and a credit note appears in Transactions.

Common questions

Will it slow down my WordPress site? No. The plugin only acts when an order or refund event fires. Order traffic continues normally; Booksmor receives a small HTTP POST in the background.

What happens if my site goes down briefly? WooCommerce retries failed webhook deliveries up to 5 times automatically. The plugin’s “Recent activity” panel (inside WordPress, under WooCommerce → Booksmor) shows the last 10 deliveries with their status so you can spot anything that didn’t go through.

What happens if my Booksmor account is unreachable? Same as above — WooCommerce retries. If a delivery permanently fails, the order is still in WooCommerce; you can either click Re-deliver on the webhook in WP admin or contact Booksmor support.

Can I deactivate the plugin temporarily? Yes. WooCommerce → Booksmor → click Unpair this site. This disables the webhooks but keeps your stored credentials. Re-pairing later picks up where you left off. To fully remove, deactivate then delete the plugin in Plugins.

What if I have multiple WooCommerce sites? Create one connection in Booksmor per site, generate a separate pairing code for each, and install the plugin on each site separately. Each site keeps its own webhook URL and credentials.

How are SKUs matched to my Booksmor products? On the connection detail page in Booksmor, the Bulk import via CSV and Sku sections let you map your WooCommerce product SKUs to your Booksmor item SKUs. Unmapped SKUs still import (the line item shows as “Unmapped SKU XYZ” on the voucher) so you don’t lose orders while you fix mappings.

What does the plugin send to Booksmor? For each order or refund: the order ID, customer name (first + last, for the pseudo-customer Booksmor uses), the buyer’s state code (for GST), and each line item (SKU, name, quantity, price, tax rate). Nothing else. Buyer email, address, payment details — none of that leaves your store.

Does it update by itself? Yes. When Booksmor publishes a new plugin version, WordPress’s standard Plugins → Updates screen will show “Booksmor for WooCommerce — update available”. One click to update.

I changed my mind, how do I disconnect entirely?

  1. In Booksmor → E-Commerce → your connection → Disconnect / Delete connection.
  2. In WP admin → WooCommerce → Booksmor → Unpair this site, then in Plugins → deactivate + delete the plugin.

Troubleshooting

“Pairing code not found or expired” The code is one-time-use and expires in 10 minutes. Generate a fresh one in Booksmor and try again.

“Booksmor for WooCommerce needs WooCommerce active” The plugin requires WooCommerce. Install + activate it from Plugins → Add New, then re-pair Booksmor.

Orders fire but nothing shows in Booksmor Open WP admin → WooCommerce → Booksmor → Recent activity table. If you see HTTP status codes other than 200, hover over them for the error. Common ones:

  • 401 — the plugin’s stored credentials no longer match Booksmor’s. Click Unpair, generate a fresh pairing code in Booksmor, re-pair.
  • 404 — the connection has been deleted on the Booksmor side. Re-create it.
  • 5xx — Booksmor is temporarily unavailable. WooCommerce will retry automatically.

I see the green status but no orders appear Click Test connection in the plugin’s settings page. It shows whether Booksmor is reachable and how many orders it has booked from this store so far.

Need help? Contact support@booksmor.com with: your store domain, the connection name in Booksmor, and a screenshot of the Recent activity table.