Harbor EU E-Invoicing for WooCommerce
| 开发者 | harborplugins |
|---|---|
| 更新时间 | 2026年7月25日 01:35 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Peppol BIS Billing 3.0 (the default) is the profile used by the Peppol network. It requires an electronic address for both parties. In practice that means the buyer must supply a valid EU VAT number at checkout. An order without one cannot be issued as a Peppol invoice, and the plugin will say so instead of producing a document that a Peppol access point would reject.
- EN 16931 is the profile to choose if you also sell to consumers, or to business buyers who have no VAT number. It is the European semantic standard without the Peppol-specific rules, and the buyer's electronic address is optional.
- Adds a VAT number field and a purchase order reference field to the checkout. Both are registered on the block checkout (WooCommerce 8.9 or later) and on the classic shortcode checkout, and both are optional.
- Adds a Generate button and a Download link to the order screen.
- Produces UBL 2.1 Invoice XML in the Peppol BIS Billing 3.0 or EN 16931 profile.
- Derives the VAT category from the tax WooCommerce actually charged: standard rate, zero rate, exempt, reverse charge for services, intra-community supply of goods, export outside the EU, and not subject to VAT for a seller without a VAT number.
- Issues invoice numbers in an unbroken sequence, resettable yearly or monthly, that never change once assigned.
- Stores every invoice in the database. Downloads are served through WordPress with a capability check and a nonce, so the file is never exposed by a URL.
- Works with High-Performance Order Storage.
- WordPress 6.3 or later
- WooCommerce 8.0 or later (8.9 or later for the VAT field on the block checkout)
- PHP 8.0 or later
- A complete seller record: legal name, street, city, postcode, country, contact name, contact phone and contact email. These are mandatory under the German, Italian and Dutch national rules, and the plugin will not issue an invoice without them.
hein_is_service- whether a line item is a service. By default a virtual or downloadable product is a service, which determines whether a cross-border EU supply is reported as an intra-community supply of goods or as a reverse charge on services. Use this filter for a service that is sold as an ordinary simple product.hein_tax_category- the resolved VAT category for a line, charge or allowance.hein_invoice_data- the complete invoice array before it is serialized.hein_invoice_number- the assigned invoice number.hein_buyer_endpoint- the buyer's electronic address, when it cannot be derived from a VAT number.hein_manage_capability- the capability required to generate and download an invoice. Defaults toedit_shop_order.hein_item_tax_percent- the VAT rate resolved for a line, when your tax setup is not one WooCommerce reports per line.hein_unit_code- the UN/ECE Rec 20 unit of measure for a line. Defaults toC62(piece).hein_payment_means_code- the UNTDID 4461 payment means code derived from the order's gateway.hein_rounding_tolerance- how far the document total may differ from the sum of its parts before generation fails. Defaults to 0.05.hein_eu_countries- the list of country codes treated as EU member states.hein_generator_formats- the list of available invoice formats.hein_invoice_filename- the filename used for a downloaded invoice.hein_store_to_filesystem- whether an invoice is also written to the uploads folder.
安装:
- In your WordPress admin, go to Plugins > Add New, search for "Harbor EU E-Invoicing for WooCommerce", and click Install Now, then Activate. Or upload the plugin zip via Plugins > Add New > Upload Plugin.
- Go to WooCommerce > E-Invoicing and fill in the seller section: legal name, VAT number, street, city, postcode, country code, contact name, contact phone and contact email.
- Choose the profile. Peppol requires a buyer VAT number on every order; EN 16931 does not.
- Add your IBAN under Payment if you accept direct bank transfer. Without it, a bank transfer order records the payment means as undefined rather than as a credit transfer.
- Open any order and use the Generate button in the E-invoice box.
常见问题:
Generating an invoice says "The Peppol profile requires a buyer electronic address". What now?
The order has no valid buyer VAT number, and the Peppol profile requires one. Either add the customer's VAT number to the VAT number field on the order screen and generate again, or switch the profile to EN 16931 under WooCommerce > E-Invoicing if you invoice consumers.
Which VAT category does an order get?
The category follows the tax that was actually charged. A line that carries a positive VAT rate is always standard rated. A line with no VAT is reported as an intra-community supply when the buyer is in another EU member state with a valid VAT number and the item is a physical product, as a reverse charge when it is a virtual or downloadable item, as an export when the buyer is outside the EU, as not subject to VAT when you have no VAT number of your own, and otherwise as zero rated or exempt, as configured.
My digital product is being reported as an intra-community supply of goods.
A line counts as a service when the product is marked virtual or downloadable. If you sell a service as an ordinary simple product, use the hein_is_service filter to declare it.
Where are the invoices stored?
In a database table that belongs to the plugin. A copy in your uploads folder is optional and can be turned off. Downloads always come from the database through WordPress, and require the capability to edit the order.
Can I change an invoice number after it is issued?
No. Once a number is assigned to an order it does not change, and regenerating the XML reissues the same number: the document is a rendering of one invoice, not a new one.
Does the plugin handle refunds and credit notes?
An invoice documents the original supply and is not altered by a later refund. Credit notes are not generated at all. The order screen shows a warning when an order has been refunded.
Does it validate VAT numbers against VIES?
No. VAT numbers are checked offline against the published format for each member state. No request leaves your server.
更新日志:
- Initial release.