Gwii Invoice Hash for WooCommerce
| 开发者 | gwii |
|---|---|
| 更新时间 | 2026年10月3日 17:39 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- SHA-256 chained hash built from the 8-field canonical string defined in the specification. The calculation matches the three official test vectors published by the AEAT.
- One invoice number. With WooCommerce PDF Invoices & Packing Slips active, the hash and the QR use its invoice number and date. Otherwise the plugin assigns its own sequential numbering, independent from the order ID.
- Database lock (MySQL
GET_LOCK, or an atomic row lock on SQLite) so that two orders completed at the same time cannot break the chain. - Timestamps in the WordPress time zone (+01:00 / +02:00 in Spain).
- Cancellation record chained to the previous hash when a registered order is cancelled or fully refunded.
- QR verification URL with the four official parameters:
nif,numserie,fechaandimporte. - HPOS compatible and integrates with WooCommerce PDF Invoices & Packing Slips (adds text rows with the hash and the verification URL).
- No external services: no API keys, no data sent to third parties.
- It does not generate or sign the XML invoice record.
- It does not submit records to the AEAT.
- It does not keep the event log nor provide the manufacturer's responsible declaration required by RD 1007/2023.
- It does not handle partial refunds (corrective invoices).
- It does not embed the QR image in the PDF (only the URL and the hash as text).
安装:
- Upload the
gwii-invoice-hash-for-woocommercefolder to/wp-content/plugins/, or upload the.zipfrom Plugins > Add New > Upload Plugin. - Activate the plugin. WooCommerce must be installed and active.
- Go to WooCommerce > Huella VeriFactu.
- Enter the issuer tax ID (NIF, checked with its control digit), the invoice series prefix and the default invoice type, then save.
- Every order that changes to Completed will get its invoice number, chained hash and QR URL, stored as order meta and shown in the order edit screen.
常见问题:
Does this plugin make my shop compliant with Orden HAC/1177/2024?
No. It implements the hash calculation and the QR URL exactly as defined by the regulation, and the calculation is checked against the official AEAT test vectors. But the regulation also requires generating the XML record, signing it or submitting it to the AEAT, keeping an event log and having a responsible declaration from the software manufacturer. None of that is done by this plugin.
When is the hash generated?
When the order changes to the Completed status. The invoice date and the timestamp are taken at that moment, in the time zone configured in WordPress.
What happens if I cancel or refund a registered order?
A chained cancellation record is generated and stored in the order. Partial refunds do not generate any record.
Is it compatible with PDF invoice plugins?
Yes. With WooCommerce PDF Invoices & Packing Slips active, the plugin uses that plugin's invoice number and date (creating the invoice when the order is completed if it does not exist yet), so the PDF shows a single invoice number and the hash and QR refer to it. The hash and the verification URL are added as text rows to the PDF. You can switch back to the plugin's own numbering in the settings. The data is also stored as order meta (_verifactu_num_serie, _verifactu_hash, _verifactu_qr_url, among others).
I was using version 1.0.x under the previous name. Will my chain continue?
Yes. On activation the plugin copies the settings and the last hash saved by version 1.0.x, so the chain continues without gaps.
更新日志:
- With WooCommerce PDF Invoices & Packing Slips active, the hash and the QR now use its invoice number and date, so the PDF no longer shows two different invoice numbers. New setting "Numeración de facturas" to keep the plugin's own numbering instead.
- If that plugin cannot provide an invoice number, no hash is generated and an order note explains why.
- The settings page warns when the WordPress time zone is not a Spanish one (Madrid, Canary Islands or Ceuta), since the invoice date and the record timestamp are taken in that zone. Fixed offsets such as UTC+1 also trigger the warning because they ignore daylight saving time.
- Fixed: no hash was generated on sites whose database does not support GET_LOCK (SQLite, including WordPress Playground). The plugin now falls back to an atomic row lock in the options table.
- Renamed to Gwii Invoice Hash for WooCommerce. Option names now use the
gwiih_prefix; previous settings and the last hash are migrated automatically. - Fixed the QR URL: it now uses https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR with the
nif,numserie,fechaandimporteparameters. - Timestamps use the WordPress time zone instead of UTC.
- Database lock (GET_LOCK) protects the hash chain against concurrent orders.
- Sequential invoice numbering independent from the order ID.
- Cancellation record when a registered order is cancelled or fully refunded.
- Tax ID control digit is validated when saving settings.
- Fixed the order meta box when HPOS is enabled.
- Added the
Requires Plugins: woocommerceheader. - Rewritten descriptions: the plugin no longer presents itself as a complete compliance solution.
- Initial release.