Download the PHP package xhubio/jtl-shop-invoice-api-xhub without Composer

On this page you can find all versions of the php package xhubio/jtl-shop-invoice-api-xhub. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package jtl-shop-invoice-api-xhub

Invoice-api.xhub for JTL-Shop

License: MIT

Free, MIT-licensed plugin that turns JTL-Shop orders into compliant e-invoices via the invoice-api.xhub.io service. Live formats: PDF, XRechnung 3.0 (German B2G/B2B, EN 16931 / Peppol BIS Billing 3.0) and ZUGFeRD 2.3/2.4 (hybrid PDF/A-3 with embedded XML, Germany/Austria).

🇩🇪 Deutsche Anleitung im README.de.md.

How it works

When an order's status changes the plugin sends the order to invoice-api.xhub.io and stores the returned invoice file under plugins/xhubio_invoice_api_xhub/files/<orderID>/. Trigger states (off / on_pending / on_on_hold / on_processing / on_completed) and target format are configurable per shop. Invoices can also be generated manually for any order from the plugin's admin Settings tab.

Requirements

Install

  1. Download jtl-shop-invoice-api-xhub-1.0.0.zip from the latest GitHub release.
  2. JTL-Shop admin → Plugins → Plugin-Manager → "Verfügbar" tab → Plugin-ZIP hochladen → upload the ZIP.
  3. Switch to the "Aktiviert" tab → toggle the plugin on.
  4. Plugins → Installierte Plugins → Invoice-api xhub for JTL-Shop.
  5. Tab "Configuration" → fill in:
    • API key (from console.invoice-api.xhub.io/api-keys)
    • Country (default DE) and Format (PDF / XRechnung / ZUGFeRD)
    • Trigger (default: when order goes to "in Bearbeitung")
    • Seller block — your company name, VAT-ID, address, email, phone
    • Bank — IBAN + BIC (required for SEPA payment instructions in XRechnung/ZUGFeRD)
    • Country-specific (DE) — Default Leitweg-ID for B2G XRechnung (optional)
    • Template — UUID of a custom PDF template from console.invoice-api.xhub.io/pdf/templates (optional)
  6. Save.

Generate your first invoice

After install:

  1. Plugins → Installierte Plugins → Invoice-api xhub for JTL-Shop → tab "Settings" → "Generate invoice (manual trigger)" card.
  2. Pick an order from the dropdown → click "Generate now".
  3. The plugin posts to invoice-api.xhub.io, stores the result on disk, and shows a green confirmation card with a clickable filename.
  4. The "Generated invoices" history table on the same tab lists every invoice with format, byte size, timestamp and a download link.

For automatic generation: change an order's status in your JTL-Wawi-driven workflow (or directly in the JTL-Shop admin if your setup permits). The plugin's listener fires on order-status-change and generates the invoice when the new status matches the configured trigger.

Custom PDF templates — when the output looks the same

Configure the Template UUID in the Configuration tab. The plugin sends it to the API on every generation. The Settings tab shows for each generated invoice exactly which template UUID was sent (column "Template" in the History table) and the API's content hash.

A custom template inherits the system default until you actually edit its layout, logo and colors at console.invoice-api.xhub.io/pdf/templates. If your generated PDF still looks identical to the default, the UUID is reaching the API correctly (visible in the History table) — the template content itself has not yet been customised.

Country support (11 country profiles)

Country Code XRechnung ZUGFeRD PDF
Germany DE ✅ ✅ ✅
Austria AT — ✅ ✅
France FR — — ✅
Italy IT — — ✅
Spain ES — — ✅
Belgium BE — — ✅
Netherlands NL — — ✅
Bulgaria BG — — ✅
Romania RO — — ✅
Czech Republic CZ — — ✅
Hungary HU — — ✅

API roadmap (Q3 2026 onwards): Factur-X (FR), FatturaPA (IT), Facturae (ES), ebInterface (AT), UBL, ISDOC (CZ), NAV (HU). The plugin will surface these in the Format dropdown automatically as soon as the API supports them.

Compliance

Where files and data go

The Settings tab in the plugin admin shows the resolved storage path, total invoice count, and the most-recent generation timestamp.

Support

License

MIT — see the "Lizenzvereinbarungen" tab for the full text.

All versions of jtl-shop-invoice-api-xhub with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package xhubio/jtl-shop-invoice-api-xhub contains the following files

Loading the files please wait ...