VAT Right for Easy Digital Downloads
| 开发者 | jeangalea |
|---|---|
| 更新时间 | 2026年11月2日 07:02 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv3 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Adds a VAT number field to the block checkout and the shortcode checkout. Numbers are checked for format first, then against the official registry, and the cart's tax updates as soon as the answer comes back. Logged-in customers get their last number filled in.
- Registries: VIES for EU numbers, HMRC for GB numbers (needs your own free HMRC developer credentials, see the FAQ), the Swiss UID register for CHE numbers and the Brønnøysund register for Norwegian numbers.
- Applies reverse charge to B2B sales with a valid number. When your prices include tax, the included VAT is taken off the price, so a business buyer pays the net amount. The legal wording and the customer's number go on the receipt, in the email tags {vat_number}, {vat_notice} and {vat_company}, and on EDD Invoices and EDD PDF Invoices when either add-on is active. A valid number from your own country never exempts unless you switch that on.
- Charges B2C customers your country's VAT below the EUR 10,000 OSS threshold and the destination country's VAT above it, switching automatically. You can also tell the plugin you're OSS-registered to always charge destination VAT.
- Uses the billing country as location evidence, plus the visitor's IP country when your site is behind Cloudflare or Amazon CloudFront. When the evidence conflicts, the customer can be asked to confirm their country.
- Imports standard and reduced rates from the EU's TEDB into EDD's tax rates. It shows a diff first and never changes a rate until you apply it. Rates you replace are kept as inactive rows, the way EDD keeps them. A weekly check tells you when the EU rates change.
- A VAT category on each download (standard, reduced or super-reduced), so e-books and similar products get their reduced rate in the same cart as standard-rate products.
- Records the decision on every order: the number, the registry answer, the VIES consultation number when you've entered your own VAT number, the location evidence and the rule that applied. It also corrects the tax rate EDD links to the order, so refunds and renewals use the right one. An EU VAT section on the order screen shows the decision, with a log and a button to re-check the number.
- Records orders that skip EDD's checkout checks too, such as wallet payments and manual orders added in the admin, and flags the ones it couldn't decide cleanly.
- Re-checks numbers that couldn't be validated at checkout and can email you when one validates after the order was placed.
- Lets a shop manager correct the VAT number, the country of evidence and the treatment on an order, with a required reason. The change is added to the decision log with who, when, old and new values, and the OSS and EC Sales List reports follow. It never changes the amounts charged or refunds anything.
- Optional: refunds the VAT automatically, through EDD's own refund, when a number that couldn't be checked at checkout validates later. Off by default.
- Quarterly OSS return and EC Sales List reports with CSV export, in EUR. Orders in other currencies are converted at the ECB reference rate. Refunds and revoked orders are recorded against the period they belong to.
- Reports for a quarter, a month or any date range, in the screen, the CSV and the REST endpoints, for countries that want the EC Sales List monthly.
- Emails the store admin when EU sales to consumers reach a share of the EUR 10,000 OSS threshold (80% by default) and again when they pass it, once a year per level. You can turn it off or change the share.
- A separate UK store VAT number: UK customers see it on receipts and invoices and HMRC checks use it, while everyone else gets the EU number and VIES checks keep using that one. With one number set, nothing changes.
- Optional business-only mode: require a valid VAT number at checkout from everyone, from customers billing in the EU or from the countries you choose. The field shows as required for those countries, a number the registry couldn't check is refused, and Buy Now and wallet orders that can't be refused are flagged on the order.
- VAT-exempt user roles: customers with a role you choose pay no VAT, recorded on the order under its own rule. A confirmed VAT number takes precedence, and a role isn't a legal basis on its own, so you stay responsible for each exemption. Renewals follow the same rule.
- A VAT column on EDD's Orders list with the number, its status and the treatment, and a filter for orders pending validation or flagged.
- REST endpoints for both reports, restricted to users who can view shop reports.
- Works with EDD Recurring: renewals are recorded at the amount the gateway charged, with the VAT that decision calls for inside it. See the FAQ.
- A setup check lists what's missing: taxes turned on, your shop country and VAT number, tax rates for destination countries, the IP country source and HMRC credentials.
- Registers WordPress personal data exporters and erasers, and a retention setting for the stored data.
wp vat-right-for-edd import-barn2. Settings are copied on the server and never shown on screen or in logs. Barn2's VATSense key isn't copied, because this plugin checks GB numbers with HMRC instead.
While Barn2's plugin is active, this plugin only offers the import and doesn't touch checkout or orders. Deactivate Barn2's plugin once the import is done.
安装:
- Make sure Easy Digital Downloads is active, then install and activate VAT Right for Easy Digital Downloads.
- Go to Downloads > Settings > Taxes and turn on taxes. EDD only shows the billing address fields, which the plugin needs, when taxes are on.
- Go to Downloads > Settings > Taxes > EU VAT and read the setup check.
- Enter your store VAT number so VIES can return a consultation number for each check.
- Apply the EU rates under Downloads > EU VAT.
- If you used Barn2's EDD EU VAT, run the import under Downloads > Import from Barn2.
屏幕截图:
常见问题:
What happens when VIES is down?
Checkout still works. By default the order is accepted, VAT is charged and the order is flagged as pending validation. The plugin checks the number again later and, if it validates, marks the order and can email you so you can refund the VAT. The setting "When a registry is unavailable" offers two alternatives: accept the order, exempt the VAT and re-check later, or don't accept the order. Registry requests time out after a few seconds. When VIES turns your store away for sending too many requests, or the plugin's own hourly lookup limit is reached, VAT is charged whatever that setting says, because visitors can cause either. Exempting while a registry is down lets anyone enter a made-up number for that country, so the VAT is yours to recover if the re-check fails.
When does the plugin refund VAT automatically?
Only when the setting "Refund the VAT automatically when a number validates after the order" is on (it's off by default), and only for an order that was charged VAT because the registry was down at checkout, when the registry then confirms the number is valid and the order would be reverse-charged with it. The plugin then creates a partial refund in EDD for exactly the VAT charged, once. The order's own totals stay as they were and the refund shows in EDD like one you made yourself, in the decision log and in the VAT reports, in the period of the refund. It does not refund when the order was already refunded in part, when the tax on the order doesn't match the VAT decision, when EDD won't refund the order (its status or refund window), or when the order was paid through a gateway other than EDD's Store Gateway. Those orders are flagged and get an order note, and you get the usual email, so you can decide. EDD's refund only records the refund unless it's issued from its refund form, so for payment providers the plugin doesn't refund through, the money has to be returned by you. A developer can add a gateway with the vatright_edd_auto_refund_gateways filter once refunds on it move money without the form.
How do I validate UK VAT numbers?
HMRC only answers requests that carry credentials from a registered application, so you need your own. They're free.
- Create an account at the HMRC Developer Hub.
- Register an application and subscribe it to the VAT Registered Companies API (check a UK VAT number).
- Copy the client ID and client secret from the application.
- Paste them into Downloads > Settings > Taxes > EU VAT.
Does it work with EDD Recurring?
Yes. At signup the cart's VAT treatment carries over to the subscription, including the reduced rate for downloads in a reduced category. A renewal is decided as a new sale: a recent registry answer is reused, otherwise the number is checked again. The plugin never changes what the gateway charges. It records the renewal at the amount charged, with the VAT the decision calls for inside that amount. If the treatment has changed since signup (the rate moved, you crossed the threshold, or the customer's number stopped being valid), the renewal is flagged on the order so you can update the subscription yourself. This has been tested with EDD Recurring 2.14.
Where does the IP country come from?
From a country header your CDN adds to each request: CF-IPCountry from Cloudflare or CloudFront-Viewer-Country from Amazon CloudFront. Pick yours under "IP country source". Only pick a CDN your site is really behind, because without one a visitor could send the header themselves. With no source set, the plugin decides on the billing country and, when that conflicts with other evidence, the customer's self-certification. Developers can supply the country from elsewhere through the vatright_edd_ip_country filter. The plugin doesn't call any IP lookup service.
What personal data does the plugin store, and for how long?
It stores the customer's VAT number, the registry's name, address and consultation number for it, and the IP country evidence used for the decision, on the order, in the plugin's ledger table and, for logged-in customers, in their customer record. After the retention period (10 years by default, counted from the end of the year of the sale, which matches the OSS record-keeping period) the plugin removes the personal data from the decision record and ledger rows and keeps the scheme, rule, amounts and country evidence. The same applies to the VAT fields Barn2's plugin left on imported orders. Exporters and erasers are registered with the WordPress privacy tools. All plugin data is kept when you delete the plugin, unless you tick "Delete all plugin data when the plugin is deleted".
Which services does the plugin call?
See "External services" below. Nothing else is contacted, and the plugin makes no request unless a VAT number, a rate update or a currency conversion needs it.
Are there known limitations?
The plugin is built for stores established in the EU. The setup check warns when your shop country is outside it. The points below each err on the side of charging VAT.
- Consulting, legal, advertising and similar services to consumers outside the EU (Article 59 of the VAT Directive) are charged your store's VAT.
- Business customers in the UK are treated as consumers unless you add your own HMRC API credentials. Swiss and Norwegian numbers that can't be checked at checkout are charged VAT until they're re-checked.
- In a cart that's partly exempt because of a domestic exemption, the exempt line is charged VAT.
- Wallet payments and Buy Now buttons skip EDD's checkout checks, so a customer there can't be asked to confirm their country. The plugin decides from the order's address and the IP country, and flags any conflict on the order.
- A valid VAT number removes VAT without checking that the buyer is that company, so a published number belonging to someone else would pass.
- The EDD Invoices and EDD PDF Invoices integrations have been tested against stand-ins that fire those add-ons' hooks, not against the add-ons themselves.
更新日志:
- Renamed to VAT Right for Easy Digital Downloads, slug vat-right-for-edd.
- Business-only mode: require a valid VAT number to order, everywhere, in the EU or in chosen countries. Buy Now and wallet orders that miss it are flagged.
- VAT-exempt user roles, recorded on every order they exempt. Roles come from the logged-in customer only, and renewals keep the roles recorded at signup.
- VAT column and a pending/flagged filter on the Orders list.
- Correct an order's VAT number, country of evidence or treatment from the order screen. Each correction needs a reason and is logged with your name; the reports follow, the amounts don't change.
- Optional automatic VAT refund when a number validates after the order, off by default. It only acts on gateways where EDD itself returns the money (the Store Gateway); other orders are flagged for you to refund. See the FAQ.
- OSS return and EC Sales List reports for a month or any date range, as well as by quarter, in the screen, CSV and REST.
- Email warning when cross-border EU consumer sales near the EUR 10,000 threshold, and again when they pass it.
- A separate UK store VAT number, used on receipts and HMRC checks for UK customers. The Barn2 import copies it.
- Fix: on hosts where WordPress fetches over cURL with OpenSSL 3, VIES checks failed and business customers were charged VAT. Registry requests now ask for uncompressed answers.
- Orders outside the EU are no longer flagged as a tax mismatch, and a non-EU order charged VAT by mistake now is.
- EDD Invoices shows your seller details when its own company fields are empty, as after moving from Barn2's plugin.
- The Barn2 import recommends turning on "I'm OSS-registered" when your old setup charged destination VAT.
- First release.