PHPackages xhubio/shopware-invoice-api-xhub - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [PDF & Document Generation](/categories/documents) 4. / 5. xhubio/shopware-invoice-api-xhub ActiveShopware-platform-plugin[PDF & Document Generation](/categories/documents) xhubio/shopware-invoice-api-xhub ================================ Generate compliant e-invoices (XRechnung, ZUGFeRD, PDF) from Shopware orders via the invoice-api.xhub.io API. Live now: PDF, XRechnung, ZUGFeRD. Coming Q3 2026: Factur-X, FatturaPA, Facturae, ebInterface, UBL, ISDOC, NAV. 1.0.0(2mo ago)00[4 PRs](https://github.com/xhubio/shopware-invoice-api-xhub/pulls)MITPHPCI passing Since May 9Pushed 3w agoCompare [ Source](https://github.com/xhubio/shopware-invoice-api-xhub)[ Packagist](https://packagist.org/packages/xhubio/shopware-invoice-api-xhub)[ RSS](/packages/xhubio-shopware-invoice-api-xhub/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)Dependencies (2)Versions (9)Used By (0) Invoice-api.xhub for Shopware ============================= [](#invoice-apixhub-for-shopware) [![CI](https://github.com/xhubio/shopware-invoice-api-xhub/actions/workflows/ci.yml/badge.svg)](https://github.com/xhubio/shopware-invoice-api-xhub/actions/workflows/ci.yml)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](LICENSE.md) Free, MIT-licensed connector between Shopware 6.6/6.7 and the [invoice-api.xhub.io](https://invoice-api.xhub.io) e-invoicing API. Generates EU-compliant electronic invoices (PDF, XRechnung, ZUGFeRD) directly from Shopware orders. > Deutsche Dokumentation: [README.de.md](./README.de.md) Features -------- [](#features) - Auto-generates invoices on configurable order-state transitions - 3 formats live: **PDF** (14 countries), **XRechnung** (DE), **ZUGFeRD** (DE/AT) - Roadmap Q3 2026: Factur-X, FatturaPA, Facturae, ebInterface, UBL, ISDOC, NAV - Atomic, gap-free invoice numbering (§14 UStG-compliant) - Refund triggers automatic credit-note generation - GDPR / CCPA hooks - Vue.js admin module: re-generate, download, history per order - Symfony Messenger async — non-blocking checkout Installation ------------ [](#installation) ### Via Composer (recommended) [](#via-composer-recommended) ``` composer require xhubio/shopware-invoice-api-xhub bin/console plugin:refresh bin/console plugin:install --activate InvoiceApiXhub bin/console cache:clear ``` ### Manual ZIP [](#manual-zip) 1. Download the latest `InvoiceApiXhub-*.zip` from [GitHub Releases](https://github.com/xhubio/shopware-invoice-api-xhub/releases). 2. Extract to `custom/plugins/InvoiceApiXhub` in your Shopware installation. 3. Run `bin/console plugin:refresh && bin/console plugin:install --activate InvoiceApiXhub`. 4. Clear the cache: `bin/console cache:clear`. Configuration ------------- [](#configuration) 1. Sign up at [invoice-api.xhub.io](https://invoice-api.xhub.io) and generate an API key in the [console](https://console.invoice-api.xhub.io/api-keys). 2. In Shopware Admin: **Extensions -> My Extensions -> "Invoice-api.xhub for Shopware" -> "..." menu -> Configure**. 3. Fill in: - **API connection**: API key + base URL (default: `https://service.invoice-api.xhub.io`) - **Document defaults**: Country, Format, Trigger (when to fire), Email-attach toggle, Payment due days - **Invoice numbering**: Format (e.g. `2026-{seq:0000}` for §14 UStG), reset mode - **Seller**: Your business details + tax ID + bank account (IBAN/BIC required for some country profiles) - **Country specific (DE)**: Default Leitweg-ID for B2G XRechnung 4. Save. How to test (review walkthrough) -------------------------------- [](#how-to-test-review-walkthrough) This section guides the Shopware Marketplace reviewer through a complete test of the plugin. It works against a Shopware installation with the plugin installed and configured per the section above. **Prerequisites:** - Plugin installed and activated - API key set (a sandbox key for review purposes is available — see [Reviewer note](#reviewer-note) below) - One test order with at least one product line item **Test 1 — Auto-generation on order completion** 1. Open Admin -> Orders -> select a test order with status `open`. 2. Transition the order to `completed` (Order status -> "Done"). 3. Wait ~5 seconds (Symfony Messenger sync transport processes in-request). 4. Refresh the order detail page -> scroll to the bottom of the **General** tab. 5. **Expected:** A new card "Invoice-api.xhub" appears with: - "Invoice actions" sub-card showing `Filename: INV-{order-number}.pdf` and `Generated at: ` - "History" sub-card showing one entry with status `success` **Test 2 — Re-generate** 1. On the same order, click the "Re-generate invoice" button. 2. **Expected:** Filename and Generated-at update to current timestamp; History gains another `success` entry. **Test 3 — Download** 1. Click the "Download" button. 2. **Expected:** Browser downloads `INV-{order-number}.pdf` (~20-25 KB), a valid PDF/A-3 file. **Test 4 — XRechnung format** 1. Configuration -> set Format to `XRechnung (DE)`. 2. Re-generate. 3. **Expected:** Filename becomes `INV-{order-number}_xrechnung.xml`, content is valid UBL 2.1 with BIS 3.0 / EN 16931 customizationID. **Test 5 — Refund triggers credit-note (optional)** 1. Open Order -> Refund the order\_transaction (admin -> Refund button). 2. **Expected:** A new generation event fires with `type=credit_note` and negated amounts. ### Reviewer note [](#reviewer-note) For the review process we provide a sandbox API key with the "review" tag — please email `support@invoice-api.xhub.io` with your reviewer ID, and we will send you a key valid for the duration of the review. The plugin makes outbound HTTP requests to `https://service.invoice-api.xhub.io` for invoice generation. Data sent: order line items, billing/shipping addresses, configured seller info. No data is sent before the user has explicitly configured the API key. Privacy policy: External services disclosure ---------------------------- [](#external-services-disclosure) This plugin connects to **invoice-api.xhub.io** (operator: xhub.io) for invoice generation. The plugin POSTs the order's line items, billing address, configured seller info, and tax breakdown to the API and receives a compliant invoice file. No data is sent before the user has configured an API key, and only when the configured order-state trigger fires. - Service operator: xhub.io - Terms: - Privacy: - Pricing: Business model -------------- [](#business-model) The plugin is **free** under MIT license, distributed via GitHub, packagist.org, and (planned) the Shopware Store. Revenue lives in the customer's separate subscription to invoice-api.xhub.io. This is the same SaaS-companion model used by [Stripe](https://store.shopware.com/en/sw5stri93537005054.html), [Mollie](https://store.shopware.com/en/sw5moll170498000150.html), and [PayPal](https://store.shopware.com/en/swag257690075008/paypal-payments.html) on Shopware. There is no Pro tier inside the plugin and no licence-key check. Compatibility ------------- [](#compatibility) - Shopware 6.6 - Shopware 6.7 - PHP 8.2+ Development ----------- [](#development) See `docs/SETUP-WALKTHROUGH-DOCKER.md` for a one-command Docker-based dev/test stack. Support ------- [](#support) - Bug reports / feature requests: - Email: - Docs: License ------- [](#license) MIT — see [LICENSE.md](./LICENSE.md) ### Health Score 35 — LowBetter than 77% of packages Maintenance90 Actively maintained with recent releases Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 77d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/20843387?v=4)[PatrickJ](/maintainers/pa201608)[@pa201608](https://github.com/pa201608) --- Top Contributors [![pa201608](https://avatars.githubusercontent.com/u/20843387?v=4)](https://github.com/pa201608 "pa201608 (5 commits)") --- Tags invoiceinvoice-pdfpdfshopwarex-rechnungzugferd ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/xhubio-shopware-invoice-api-xhub/health.svg) ``` [![Health](https://phpackages.com/badges/xhubio-shopware-invoice-api-xhub/health.svg)](https://phpackages.com/packages/xhubio-shopware-invoice-api-xhub) ``` ### Alternatives [shopware/storefront Storefront for Shopware 674.6M247](/packages/shopware-storefront)[shopware/production 177209.0k](/packages/shopware-production)[frosh/tools Provides some basic things for managing the Shopware Installation 88820.7k3](/packages/frosh-tools)[shopware/administration Administration frontend for the Shopware Core 414.3M119](/packages/shopware-administration)[shopware/elasticsearch Elasticsearch for Shopware 153.9M19](/packages/shopware-elasticsearch)[adyen/adyen-shopware6 Official Shopware 6 Plugin to connect to Payment Service Provider Adyen 25117.9k](/packages/adyen-adyen-shopware6) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)