Docs/Integrations/Magento
M

Magento Integration

Coming Soon

Adobe Commerce E-Rechnungs-Modul. Enterprise-ready für hohe Bestellvolumen und Multi-Store Setups.

Magento 2 Extension in Entwicklung

Unsere offizielle Magento 2 Extension ist aktuell in Entwicklung. In der Zwischenzeit kannst du invoice.xhub über Magento Observer oder die REST/GraphQL API integrieren.

Features

Adobe Commerce

Native Integration für Magento 2 und Adobe Commerce

Multi-Store

E-Rechnungen für alle Store Views und Websites

Enterprise-ready

Skalierbar für hohe Bestellvolumen und B2B

GraphQL API

Moderne Integration über Magento GraphQL

Observer Integration

Verfügbare Events

Nutze Magento Events um E-Rechnungen basierend auf Shop-Events zu erstellen.

sales_order_invoice_save_after

E-Rechnung in Magento erstellt

sales_order_payment_pay

Zahlung eingegangen

checkout_submit_all_after

Checkout abgeschlossen

sales_order_save_commit_after

Bestellung gespeichert

php
1<?php
2// Magento 2 Observer für E-Rechnung
3// app/code/Xhub/EInvoice/Observer/InvoiceSaveAfter.php
4 
5namespace Xhub\EInvoice\Observer;
6 
7use Magento\Framework\Event\Observer;
8use Magento\Framework\Event\ObserverInterface;
9 
10class InvoiceSaveAfter implements ObserverInterface
11{
12    private $invoiceService;
13 
14    public function __construct(
15        \Xhub\EInvoice\Service\InvoiceService $invoiceService
16    ) {
17        $this->invoiceService = $invoiceService;
18    }
19 
20    public function execute(Observer $observer)
21    {
22        $invoice = $observer->getEvent()->getInvoice();
23        $order = $invoice->getOrder();
24 
25        // Nur für B2B mit USt-ID
26        $vatId = $order->getBillingAddress()->getVatId();
27        if (empty($vatId)) {
28            return;
29        }
30 
31        // E-Rechnung erstellen
32        $this->invoiceService->createEInvoice($order, $invoice);
33    }
34}

REST API Integration

Alternativ kannst du die Magento REST API nutzen und mit n8n oder Make.com verbinden.

  1. 1

    Webhook in Magento erstellen

    Oder Observer für sales_order_invoice_save_after

  2. 2

    Order-Daten abrufen

    GET /rest/V1/orders/:orderId

  3. 3

    Daten transformieren

    Magento-Format → invoice.xhub-Format

  4. 4

    E-Rechnung erstellen

    POST /api/v1/invoice/de/xrechnung/generate an invoice.xhub API

typescript
1// Magento REST API → invoice.xhub
2// Integration über Magento Webhooks oder Observer
3 
4const magentoOrder = await fetch(
5  `${MAGENTO_URL}/rest/V1/orders/${orderId}`,
6  { headers: { Authorization: `Bearer ${MAGENTO_TOKEN}` }}
7).then(r => r.json());
8 
9const invoiceData = {
10  type: "xrechnung-3.0",
11  seller: {
12    name: storeConfig.general.store_information.name,
13    vatId: storeConfig.general.store_information.merchant_vat_number,
14    address: {
15      street: storeConfig.general.store_information.street_line1,
16      city: storeConfig.general.store_information.city,
17      zip: storeConfig.general.store_information.postcode,
18      country: storeConfig.general.store_information.country_id
19    }
20  },
21  buyer: {
22    name: magentoOrder.billing_address.company
23      || `${magentoOrder.billing_address.firstname} ${magentoOrder.billing_address.lastname}`,
24    vatId: magentoOrder.billing_address.vat_id,
25    address: {
26      street: magentoOrder.billing_address.street.join(", "),
27      city: magentoOrder.billing_address.city,
28      zip: magentoOrder.billing_address.postcode,
29      country: magentoOrder.billing_address.country_id
30    }
31  },
32  items: magentoOrder.items.map(item => ({
33    description: item.name,
34    quantity: item.qty_ordered,
35    unitPrice: parseFloat(item.price),
36    vat: parseFloat(item.tax_percent)
37  })),
38  reference: magentoOrder.increment_id
39};
40 
41const response = await fetch('https://api.invoice.xhub.io/api/v1/invoice/de/xrechnung/generate', {
42  method: 'POST',
43  headers: {
44    'Authorization': `Bearer ${XHUB_API_KEY}`,
45    'Content-Type': 'application/json'
46  },
47  body: JSON.stringify(invoiceData)
48});

Anwendungsfälle

B2B Marketplace

E-Rechnungen für B2B-Plattformen mit Vendor-Management

  1. 1Vendor erstellt Bestellung
  2. 2Magento verarbeitet B2B-Checkout
  3. 3XRechnung mit Vendor-Daten
  4. 4Automatischer Peppol-Versand

Multi-Store Enterprise

Zentrale E-Rechnung für alle Store Views

  1. 1Bestellung in beliebigem Store
  2. 2Store-spezifische Verkäuferdaten
  3. 3Einheitliches E-Rechnungsformat
  4. 4Zentrale Archivierung

Adobe Commerce B2B

Integration mit Magento B2B Features

  1. 1Company Account mit USt-ID
  2. 2Requisition List Bestellung
  3. 3XRechnung mit Kostenstelle
  4. 4Purchase Order Referenz

Benachrichtigt werden wenn die Extension verfügbar ist?

Trage dich ein und wir informieren dich sobald die offizielle Magento 2 Extension auf dem Adobe Commerce Marketplace verfügbar ist.