{"id":402770,"date":"2026-11-15T19:08:21","date_gmt":"2026-11-15T19:08:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/beliq-e-invoicing\/"},"modified":"2026-11-16T14:22:29","modified_gmt":"2026-11-16T14:22:29","slug":"beliq-e-invoicing","status":"publish","type":"plugin","link":"https:\/\/tw.wordpress.org\/plugins\/beliq-e-invoicing\/","author":23561388,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.2.2","stable_tag":"0.2.2","tested":"7.1.4","requires":"6.5","requires_php":"8.2","requires_plugins":null,"header_name":"beliq e-invoicing","header_author":"beliq","header_description":"Generate EN 16931 e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS) from WooCommerce orders through the beliq API. beliq generates and validates the document; sending, archiving, and filing stay with you.","last_updated":"2026-11-16 14:22:29","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/docs.beliq.eu\/integrations\/woocommerce\/","header_author_uri":"https:\/\/beliq.eu","rating":0,"author_block_rating":0,"active_installs":0,"downloads":74,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.2.2":{"tag":"0.2.2","author":"beliq","date":"2026-11-16 14:22:29","revision":3805351}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3803831,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3803831,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3803831,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3803916,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3803916,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3803734,"resolution":"1","location":"assets","locale":"","width":1600,"height":976},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3803734,"resolution":"2","location":"assets","locale":"","width":1600,"height":976}},"screenshots":{"1":"The beliq integration settings under WooCommerce &gt; Settings &gt; Integration: the API key, seller legal details, payment account, and invoice generation options.","2":"The beliq e-invoice box on the order screen (highlighted), showing the generation status and a capability-checked download."}},"plugin_section":[],"plugin_tags":[225611,249779,286,263529,263530],"plugin_category":[45],"plugin_contributors":[292944],"plugin_business_model":[],"class_list":["post-402770","plugin","type-plugin","status-publish","hentry","plugin_tags-e-invoicing","plugin_tags-peppol","plugin_tags-woocommerce","plugin_tags-xrechnung","plugin_tags-zugferd","plugin_category-ecommerce","plugin_contributors-beliq","plugin_committers-beliq"],"banners":{"banner":"https:\/\/ps.w.org\/beliq-e-invoicing\/assets\/banner-772x250.png?rev=3803916","banner_2x":"https:\/\/ps.w.org\/beliq-e-invoicing\/assets\/banner-1544x500.png?rev=3803916","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/beliq-e-invoicing\/assets\/icon.svg?rev=3803831","icon":"https:\/\/ps.w.org\/beliq-e-invoicing\/assets\/icon.svg?rev=3803831","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/beliq-e-invoicing\/assets\/screenshot-1.png?rev=3803734","caption":"The beliq integration settings under WooCommerce &gt; Settings &gt; Integration: the API key, seller legal details, payment account, and invoice generation options."},{"src":"https:\/\/ps.w.org\/beliq-e-invoicing\/assets\/screenshot-2.png?rev=3803734","caption":"The beliq e-invoice box on the order screen (highlighted), showing the generation status and a capability-checked download."}],"raw_content":"<!--section=description-->\n<p>beliq e-invoicing for WooCommerce turns a WooCommerce order into a structured EN 16931 electronic invoice using the beliq API. When an order reaches the status you choose, the plugin maps the order onto invoice semantics, calls beliq to produce the document, validates it against the business rules, and stores it with the order for download.<\/p>\n\n<p>beliq covers three steps of an e-invoice: generate, validate, and deliver (in development). This plugin runs the first two: it generates and validates the document and stores it with the order. It does not send, file, or archive it. Until delivery through beliq is available, Peppol transmission, e-mail delivery, and tax-authority reporting stay with you.<\/p>\n\n<p>beliq validates every document against the EN 16931 business rules and the rules of the chosen format before it returns it. That helps you meet e-invoicing obligations, but no plugin can guarantee legal compliance: whether your invoices meet the rules that apply to your business stays your responsibility. The rule sets beliq validates against, with their versions and dates, are listed at https:\/\/docs.beliq.eu\/compliance\/validation-artifacts\/.<\/p>\n\n<p>Supported output formats:<\/p>\n\n<ul>\n<li>XRechnung (XML)<\/li>\n<li>ZUGFeRD \/ Factur-X (hybrid PDF)<\/li>\n<li>Peppol BIS Billing (XML)<\/li>\n<\/ul>\n\n<p>Features:<\/p>\n\n<ul>\n<li>Automatic generation when an order becomes processing or completed. When beliq cannot be reached or is unavailable, the plugin tries again later, for up to about an hour, and shows each failure on the order.<\/li>\n<li>A business-only default: generate only when the buyer looks like a business (VAT ID or company), or widen it to every order.<\/li>\n<li>Seller legal details, payment account, and VAT category for zero-rated lines, all configurable.<\/li>\n<li>Reads a buyer VAT ID and a buyer reference (for example a Leitweg-ID) from order meta keys you name, so data another plugin stores can flow onto the invoice.<\/li>\n<li>Manual generate and regenerate from the order screen, with a capability-checked download.<\/li>\n<li>High-Performance Order Storage (HPOS) compatible.<\/li>\n<\/ul>\n\n<p>A beliq API key is required. The free tier is enough to evaluate the plugin.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the beliq API at https:\/\/api.beliq.eu, a third-party service operated by beliq, to generate and validate your e-invoices. The plugin cannot produce a document without it.<\/p>\n\n<p>When an invoice is generated (automatically when an order reaches the status you configure, again later from a scheduled action when that attempt could not reach beliq or beliq was unavailable, or manually from the order screen), the plugin sends that order's invoice data to the beliq API: the seller details you configure, the buyer's billing details and VAT ID, the order line items, and the amounts and taxes. The request is authenticated with your beliq API key. beliq returns the generated document, which the plugin stores with the order. No data is sent to beliq at any other time, and nothing is sent to any other service.<\/p>\n\n<p>For how beliq handles this data, see the beliq Terms of Service at https:\/\/beliq.eu\/legal\/terms-of-service\/ and the Privacy Policy at https:\/\/beliq.eu\/legal\/privacy-policy\/.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce.<\/li>\n<li>Upload the plugin to wp-content\/plugins and activate it, or install it from the plugin directory.<\/li>\n<li>Go to WooCommerce &gt; Settings &gt; Integration &gt; beliq e-invoicing.<\/li>\n<li>Enter your beliq API key and your seller legal details.<\/li>\n<li>Choose the document format and the order status that generation runs on, then enable automatic generation.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20send%20my%20invoices%20to%20my%20customers%3F\"><h3>Does this send my invoices to my customers?<\/h3><\/dt>\n<dd><p>Not yet. Delivery through beliq is in development; https:\/\/docs.beliq.eu\/compliance\/scope\/ shows what beliq does today and where delivery fits. For now the plugin sends the order's invoice data to the beliq API to generate and validate the document (see External services), and stores the returned document with the order. Delivering it to your customer, filing, and archiving stay with you.<\/p><\/dd>\n<dt id=\"do%20i%20need%20a%20beliq%20account%3F\"><h3>Do I need a beliq account?<\/h3><\/dt>\n<dd><p>Yes, you need a beliq API key. The free tier is enough to evaluate the plugin.<\/p><\/dd>\n<dt id=\"which%20orders%20get%20an%20invoice%3F\"><h3>Which orders get an invoice?<\/h3><\/dt>\n<dd><p>By default, only orders that look like a business purchase (a VAT ID or a company on the billing details). You can widen this to every order in the settings.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20beliq%20is%20unavailable%20when%20an%20order%20is%20paid%3F\"><h3>What happens when beliq is unavailable when an order is paid?<\/h3><\/dt>\n<dd><p>The order's status change goes through as always. The plugin notes the failure on the order and in the beliq box, and tries again with Action Scheduler at about 2, 5, 10, 14, 30 and 60 minutes after the first attempt, or later when beliq asks for a longer wait. A failure the order's data causes (beliq rejects the invoice) is not retried, since the same data would fail again; it stays on the order next to the \"Generate now\" button. A request that may have run at beliq (a lost connection, a timeout of the first attempt, or beliq's engine being unavailable) is retried at most three times, and only within the first 15 minutes: beliq does not charge a repeat of a request it charged in the last 15 minutes (with a key of the same mode, up to 10 repeats), and a repeat after that could be charged again. An outage that follows such a failure still gets the later attempts, so in that case one more unit can be charged for an invoice that would otherwise not be made.<\/p>\n\n<p>Action Scheduler runs from WP-Cron, which runs when the site gets a visit. On a quiet shop a later attempt can run late. A real cron job that calls wp-cron.php, or <code>wp action-scheduler run<\/code>, every minute keeps it on time.<\/p><\/dd>\n<dt id=\"where%20is%20the%20document%20stored%3F\"><h3>Where is the document stored?<\/h3><\/dt>\n<dd><p>In a protected subdirectory of your WordPress uploads folder. It is served only through a capability-checked download on the order screen, never linked publicly.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.2.2<\/h4>\n\n<ul>\n<li>The plugin header's Plugin URI points at the plugin's documentation page instead of the beliq home page, which is the Author URI.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>An automatic invoice that fails because beliq is unavailable is tried again later with Action Scheduler, at about 2, 5, 10, 14, 30 and 60 minutes, or later when beliq asks for a longer wait. A rejection is not retried.<\/li>\n<li>Every failure of the automatic invoice shows on the order, as an order note and in the beliq box, with the next attempt's time.<\/li>\n<li>Two status changes of one order at once make one attempt.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial release: order-to-EN 16931 mapping, the beliq API client, the settings screen, automatic generation on the configured order status, manual generate\/regenerate, protected download, and HPOS compatibility.<\/li>\n<\/ul>","raw_excerpt":"Turn WooCommerce orders into validated EN 16931 e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS). Delivery through beliq is in development.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/402770","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=402770"}],"author":[{"embeddable":true,"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/beliq"}],"wp:attachment":[{"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=402770"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=402770"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=402770"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=402770"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=402770"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=402770"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}