eliDocs
/
Integrations

Shopware

Turn Shopware 6 store orders into compliant EN 16931 e-invoices with the Beliq plugin. Generate and validate XRechnung, ZUGFeRD, Factur-X, and Peppol BIS from an order.

Listing pending

A Shopware 6 plugin that turns store orders into compliant EN 16931 e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS) through the Beliq API. When an order reaches the state you pick, the plugin maps its lines, taxes, parties, and totals to a valid invoice, sends it to Beliq to generate the document in your chosen format, and stores the result on the order.

Requirements

  • Shopware 6.6 or newer.
  • PHP 8.2 or newer with the curl and json extensions.
  • A Beliq account and API key. The free tier is enough to evaluate the plugin.

Install

With Composer from your Shopware root, then refresh and activate:

composer require beliq/shopware-beliq
bin/console plugin:refresh
bin/console plugin:install --activate BeliqShopware
bin/console cache:clear

You can also install the built plugin from the store’s Extensions → My extensions by uploading it as a zip.

Configure

Open Extensions → My extensions → beliq e-invoicing → Configure:

  • beliq connection: paste an API key from the Beliq dashboard (Integration → API Keys), and, if you run a custom endpoint, an API base URL.
  • Seller details: EN 16931 requires the seller block, so fill in your legal name, VAT ID, and address. XRechnung also needs the seller contact e-mail, name, and phone (BR-DE-5/6/7).
  • Payment details: choose the payment means and an IBAN. XRechnung rejects a SEPA credit transfer without one (BR-DE-23-a).
  • Invoice generation: pick the document format (ZUGFeRD / Factur-X hybrid PDF by default), the profile, and whether to output a hybrid PDF or XML only. Choose when to generate, on payment paid (default) or order completed, and set the zero-rate VAT category if you sell zero-rated lines.
  • Turn on Generate invoices automatically. Generation stays off until you do.

By default the plugin generates only for business orders (the buyer carries a VAT ID, or the order is flagged business at checkout), which is where a structured e-invoice is legally meaningful. You can widen generation to all orders.

What it does

  • Generate an EN 16931 invoice from a completed order, in the format you choose, as a hybrid PDF or XML.
  • Validate the document against the authority-pinned rules before it is stored.

The generated document lands on the order’s Documents tab as private media, downloadable there as XML or a hybrid PDF depending on the format you chose.

See also