szamlazzhu-document-xml-compatibility
Szamlazz.hu Document/XML Compatibility
Use this skill when a WooCommerce extension must cooperate with Integration for Szamlazz.hu & WooCommerce instead of sending its own invoice to Számlázz.hu. The plugin already owns the Számlázz.hu Agent request, PDF storage, order meta, admin actions, automations, IPN, and Woo webhooks. A crossover plugin should hook that contract, not duplicate it.
The validated plugin version is 6.2.2. The installed source declares HPOS, Cart/Checkout Blocks, and product block editor compatibility, while the plugin header says WC tested up to 10.7.0; this skill was checked locally against WooCommerce 10.9.4. The plugin header/readme are 6.2.2, but WC_Szamlazz::$version is still 6.2.1 in the main class and is used as an asset version; do not use that static property for feature detection.
When to use this skill
Trigger when ANY of these are true:
- A plugin changes WooCommerce order items, fees, discounts, bundles, subscriptions, shipping, payment method names, order numbers, language, or VAT labels and the invoice must match.
- You need to add invoice XML data, line comments, accounting data, custom buyer data, or custom notes.
- You need to prevent or defer automatic invoice generation.
- You need to react after a Szamlazz.hu document is created, expose a document URL, or sync document numbers to another system.
- The code touches
_wc_szamlazz_*order meta,wc_szamlazz_xml,wc_szamlazz_invoice_line_item,wc_szamlazz_document_created, orWC_Szamlazz()->generate_invoice().
Mental model
WC_Szamlazz()->generate_invoice( $order_id, $type, $options ) builds a WCSzamlazzSimpleXMLElement, sends it to Számlázz.hu through the plugin XML generator, saves the returned PDF under wp-content/uploads/wc_szamlazz/, writes HPOS-safe order meta, and fires success/error hooks.