eliDocs
/
Integrations

Shopware

Turn Shopware 6 orders into EN 16931 e-invoices with the Beliq plugin: generate and validate XRechnung, ZUGFeRD, Factur-X and Peppol BIS Billing 3.0.

Listing pending

A Shopware 6 plugin that turns store orders into EN 16931 e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS Billing 3.0) 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

Requirements

  • Shopware 6.7. The plugin requires shopware/core ~6.7.0, and 6.6 is not supported: the document renderer targets the 6.7 RenderedDocument constructor.
  • 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

Install

Clone the plugin into your Shopware installation’s custom/plugins/, then refresh and activate:

git clone https://github.com/beliq-eu/shopware-beliq.git custom/plugins/BeliqShopware
bin/console plugin:refresh
bin/console plugin:install --activate BeliqShopware
bin/console cache:clear

If you deploy with Composer, add the repository explicitly until the Packagist listing is up:

composer config repositories.beliq-shopware vcs https://github.com/beliq-eu/shopware-beliq
composer require beliq/shopware-beliq:dev-main
Configure

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

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 rule packs and schemas of its format before it is stored. How verification works says how deep that check goes for each format.

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

See also