Royalties HQ For WooCommerce Wordpress Plugin - Rating, Reviews, Demo & Download
Plugin Description
This plugin is for book publishers who sell from their own WooCommerce shop and want to make book royalties easy using Royalties HQ. Every sale of a book earns royalties for its authors and other rights holders. This plugin adds up each book’s sales every month and sends them to Royalties HQ, ready for your next royalty run. No more wrangling of manually exported spreadsheets.
Royalties HQ imports the figures alongside your other sales channels, so your shop’s sales appear on the next royalty statements with ease.
Requires a Royalties HQ account. No sales are sent until you connect the plugin to your account and switch sending on. Before that, the plugin contacts Royalties HQ only when you click “Test connection”, which checks your API address and token and sends no sales.
What it does
- Monthly sales, per book. Units sold, units returned and net receipts for each book, in your shop’s currency.
- Automatic or manual. Leave it to send each month on a schedule you choose, or switch to manual and send one month at a time when you are ready.
- Only the products you choose. Tick “Include in Royalties HQ” on your books. Tote bags, gift cards and other stock stay out. An “Unticked products” report shows anything that sold but was left out, so nothing is missed by accident.
- ISBNs from where you keep them. The SKU, WooCommerce’s GTIN/ISBN field, or a custom field. Invalid ISBNs are flagged, not sent.
- Refunds handled properly. A refund made before a month is sent reduces that month’s sales. A later refund is reported in the month it happened, so a month already sent is never changed.
- Held orders are never lost. A paid order you put on hold counts once you release it. If its month has already been sent, it is reported in the month you release it. It is never counted twice, even if you put it on hold again later.
- Pre-orders your way. A pre-order paid in advance is reported in the month it was paid, like any other sale. Or choose to report pre-orders only when they are released. Works with pre-order plugins that give pre-orders their own order status, such as WooCommerce Pre-Orders.
- Bundles split fairly. Sales of bundles made with WPC Product Bundles, YITH WooCommerce Product Bundles or Easy Product Bundles are shared between the books inside them. You can also define the books in a bundle you sell as a single product.
- Your deductions. Optionally deduct a store commission, card fees (a flat percentage or the fee your payment gateway recorded) and count shipping as revenue.
- Check before you send. Build any month, check its totals, download it as a Royalties HQ sales CSV, or run a dry run to test it against your account without importing anything.
- A clear status page. Every month’s status, totals and refund cut-off in one place, with an email to you if a month needs attention.
Privacy
No customer data leaves your shop: no names, email addresses or postal addresses, and no order details. No tax amounts are sent either. Royalties HQ receives each included book’s monthly sales totals, the book’s identifiers, title and list price, your shop’s currency, country and time zone, your deduction settings and your site’s address. “External service” below lists exactly what is sent and when.
Royalties HQ is a service of Consilience Media Limited (registered in England and Wales, company number 04214205), which publishes and maintains this plugin as the official WooCommerce integration for its own platform. WooCommerce is a trademark of Automattic Inc.; this plugin is an independent integration and is not affiliated with or endorsed by Automattic.
External service (Royalties HQ)
This plugin sends data to Royalties HQ, at the API address you enter in its settings: your publisher’s own Royalties HQ account, such as https://yourpress.royaltieshq.com/api/v1. It sends nothing anywhere else.
- What: for each month, and for each product you tick, its identifiers (ISBN, SKU or Royalties HQ product ID), title, list price, units sold and returned and net receipts excluding tax, with your shop’s currency, base country and time zone. It also sends counts of what was left out and the deduction settings used. Every request carries your API token and names the plugin, its version and your site’s address.
- When: each month on your push schedule (automatic mode) or when you click Push (manual mode); when you click Validate, Send now or Test connection; retries of a push that Royalties HQ asked to be repeated later; a daily check of your connection’s details and which months Royalties HQ already holds; and a check of the saved connection when you open the Royalties HQ settings tab while sending is on. No sales are sent until you have saved an API address and token and ticked “Send sales to Royalties HQ”. Before that, the only request is a Test connection you click yourself: it sends the API token you entered, the plugin’s name and version and your site’s address, and no sales.
- Settings in wp-config.php:
ROYALTIES_HQ_WOO_API_TOKENsets the API token instead of the settings screen.ROYALTIES_HQ_WOO_ALLOW_HTTPallows an API address that is not HTTPS; leave it unset on a live shop.
Your use of Royalties HQ is governed by its Terms and Privacy Policy.
Screenshots
WooCommerce → Settings → Royalties HQ: paste the API address and token from Royalties HQ, and test the connection in one click.
The status page: every month’s status, totals and refund cut-off, with Build, Validate, Push and Download CSV.
Unticked products: anything that sold but was left out, with a one-click Include.
The Royalties HQ tab on a product: include it, give it a Royalties HQ product ID, or list the books in a bundle sold as one product.
The Products list shows each product’s Royalties HQ status, with bulk actions to include or exclude many at once.
