Skip to content

WooCommerce

woo-tax-rounding-trace

Trace WooCommerce tax rounding differences

Trace one WooCommerce order to find where tax, totals, refunds or gateway amounts first differ by a cent or a few.

Area
WooCommerce
Checked against
WooCommerce 11.1.2, WordPress 7.1.2
Last verified
29 September 2026
Files
SKILL.md, 13 references, 4 scripts

How it works

  1. 1Record versions, order origin, changed settings and the figures that disagree.
  2. 2Export the order and its tax settings, stored values, refunds and relevant hooks.
  3. 3Add observed checkout, REST, email, refund and gateway figures to the JSON.
  4. 4Run node scripts/tax-trace.mjs order-<id>.json under both rounding settings.
  5. 5Find the first stage that differs and rebuild that arithmetic by hand.
  6. 6Choose one documented change, rehearse it on staging and wait for approval.
  7. 7Export again, rerun the helper and fill the report from its output.

Use it when

  • Trace cent differences between checkout, stored orders, emails, REST or accounting systems.
  • Investigate refund amounts or refunded tax that differ by a cent.
  • Compare a gateway capture or refund with the WooCommerce order.
  • Check changes after rounding, tax-price, decimal or tax-plugin settings changed.

How it stays safe

  • Keeps diagnosis read-only until the owner approves one defined change.
  • Takes a backup, states the check and undo, and rehearses each proposed change on staging.
  • Reproduces orders and refunds on staging with the gateway in test mode.
  • Keeps exports, screenshots and gateway reports out of chats, tickets and repositories, then deletes them after reporting.

Install it

Copy the whole woo-tax-rounding-trace folder into your agent's skills folder, not only SKILL.md.

git clone --depth 1 https://github.com/hamzaahmadaslam/agent-skills.git
cp -R agent-skills/woo-tax-rounding-trace "<your agent's skills folder>/"

More skills in the collection

All 16 skills