---
title: "Academy App"
canonical_url: "https://academy.laioutr.com/apps/magento-2-anbinden"
locale: de
meta:
  "og:title": "Academy App"
---

[Zur Startseite](https://academy.laioutr.com/)

- [Apps](https://academy.laioutr.com/bereiche/apps)

- [Commerce-Systeme](https://academy.laioutr.com/leitfaeden/commerce-systeme)

- [Magento 2 anbinden](https://academy.laioutr.com/apps/magento-2-anbinden)

In Vorbereitung

# Magento 2 anbinden

Die App für Magento 2 und Adobe Commerce verbindet den Shop über die GraphQL API mit Laioutr. Die App liefert Kategorien, Menü, Produkte, Varianten mit Bestand und Staffelpreisen und legt Artikel in den Warenkorb.

## Bevor du startest

<dl>

<dt>Tarif</dt>
<dd>Jeder Laioutr-Plan, dazu eine Magento-2- oder Adobe-Commerce-Instanz</dd>

<dt>Rolle</dt>
<dd>Developer-Rolle in der Umgebung</dd>

<dt>Dauer</dt>
<dd>10 Min.</dd></dl>

### Voraussetzungen

- Erreichbare GraphQL API unter /graphql
- Integrations- oder Admin-Token mit Rechten für Katalog und Warenkorb

Zuletzt geprüft am 15. Oktober 2026

Bindet Magento 2 und Adobe Commerce über die GraphQL API an: Kategorien mit SEO-Daten und Menü, Produkte nach URL-Schlüssel, Produktlisten mit Filtern und Sortierung, Varianten mit Bestand und Staffelpreisen, Artikel in den Warenkorb legen, Bilder in passenden Größen.

[Entwicklerdokumentation](https://docs.laioutr.com/apps/app-docs/adobe-commerce)

## So funktioniert es

1. GraphQL API unter /graphql erreichbar machenWo: Magento-Server · Rolle: Magento-Entwickler · Dauer: 10 min
2. Integration mit Rechten für Katalog und Warenkorb anlegenWo: Magento Admin · Rolle: Shop-Admin · Dauer: 10 min
3. App im Katalog installierenWo: Laioutr Cockpit, Apps · Rolle: Developer · Dauer: 2 min
4. Werte unter Configuration eintragen, testen und speichernWo: Laioutr Cockpit, Configuration · Rolle: Developer · Dauer: 5 min
5. Umgebung deployen und Daten in Studio prüfenWo: Laioutr Cockpit und Studio · Rolle: Developer, Content Manager · Dauer: 10 min

## Konfiguration

| Feld | Zweck | Woher | Pflicht | Pro Environment |
| --- | --- | --- | --- | --- |
| `baseURL` | Basis-URL der Instanz ohne Schrägstrich am Ende, daraus entsteht der GraphQL-Endpunkt. | Adresse des Shops, zum Beispiel https://shop.example.com. | Ja | Ja |
| `consumerKey` | OAuth Consumer Key der Integration. | Magento Admin, Integration. | Ja | Ja |
| `consumerSecret` | OAuth Consumer Secret der Integration. | Magento Admin, Integration. | Ja | Ja |
| `accessToken` | Bearer Token für alle GraphQL-Anfragen, mit Rechten für Katalog und Warenkorb. | Magento Admin, Integration oder Admin-Token. | Ja | Ja |
| `accessTokenSecret` | OAuth Access Token Secret der Integration. | Magento Admin, Integration. | Ja | Ja |
| `imagesConfig` | Bildgrößen für kleine Bilder und Thumbnails, optional mit Größenerkennung. | Projektentscheidung, Standard 1000 x 1000 und 600 x 600. | Nein | Ja |

## Häufige Fehler

<dl>

<dt>Seiten melden CATEGORY_NOT_FOUND oder PRODUCT_NOT_FOUND.</dt>
<dd>**Ursache:** Zum URL-Schlüssel existiert keine Kategorie oder kein Produkt.</dd>
<dd>**Lösung:** URL-Schlüssel im Magento Admin prüfen und den Link korrigieren.</dd>

<dt>Artikel lassen sich nicht in den Warenkorb legen.</dt>
<dd>**Ursache:** Dem Access Token fehlen Rechte für den Warenkorb.</dd>
<dd>**Lösung:** Rechte der Integration erweitern und den Token neu eintragen.</dd>

<dt>Produktbilder wirken unscharf oder falsch beschnitten.</dt>
<dd>**Ursache:** Die Bildgrößen in imagesConfig passen nicht zu den Bildern im Shop.</dd>
<dd>**Lösung:** Größen anpassen oder die Größenerkennung aktivieren.</dd>

<dt>Neue Zugangsdaten zeigen keine Wirkung auf der Storefront.</dt>
<dd>**Ursache:** Gespeicherte Einstellungen gelten erst ab dem nächsten Deployment der Umgebung.</dd>
<dd>**Lösung:** Die Umgebung mit Deploy neu bauen.</dd></dl>

Magento 2 und Adobe Commerce teilen sich dieselbe GraphQL API. Die App **Adobe Commerce** nutzt sie, um den Shop als Commerce-Backend an Laioutr anzubinden, und übersetzt die Daten über Orchestr in das einheitliche Datenmodell.

Die App liest Kategorien mit Beschreibung, Bild und SEO-Angaben und baut daraus das Menü. Produkte kommen über ihren URL-Schlüssel, Produktlisten je Kategorie mit Filtern, Sortierung und Seiten. Für konfigurierbare Produkte liefert sie die Varianten mit Bestand, Optionen und Staffelpreisen. Artikel landen über die App im Warenkorb, der bei Bedarf automatisch angelegt wird. In Studio stehen die Kategorien als Vorlagen für Menüs und Produktlisten zur Auswahl.

Bilder kommen in mehreren Größen aus dem Shop, die Bildauslieferung wählt jeweils die passende. Wer von einem bestehenden Magento-Frontend kommt, behält Magento als führendes System für Katalog und Bestellungen, Laioutr übernimmt das Frontend.

## Schritt für Schritt

1. 1 ### Schritt 1: GraphQL API prüfen

   Sicherstellen, dass die GraphQL API des Shops unter der Basis-URL mit dem Pfad `/graphql` erreichbar ist.
2. 2 ### Schritt 2: Integration anlegen

   Im Magento Admin eine Integration mit Rechten für Katalog und Warenkorb anlegen und deren Zugangsdaten notieren: Consumer Key, Consumer Secret, Access Token und Access Token Secret.
3. 3 ### Schritt 3: App installieren

   Im Cockpit unter **Apps** im Reiter **Ecommerce** die App Adobe Commerce mit **Install** zum Projekt hinzufügen.
4. 4 ### Schritt 4: Werte eintragen und testen

   Im Umgebungsmenü **Configuration** öffnen, die Werte eintragen, mit **Test connection** prüfen und mit **Save settings** speichern.
5. 5 ### Schritt 5: Deployen und prüfen

   Die Umgebung mit **Deploy** neu bauen und danach in Studio prüfen, ob Produkte und Kategorien in der Vorschau erscheinen.

## Ergebnis prüfen

Der Verbindungstest meldet Erfolg, das Menü zeigt die Kategorien aus Magento, die Produktdetailseite zeigt Varianten mit Bestand, und ein Testartikel lässt sich in den Warenkorb legen.

## Häufige Fragen

Gilt die App für Magento Open Source und Adobe Commerce?

Ja. Beide Editionen nutzen dieselbe GraphQL API, die App heißt im Katalog Adobe Commerce.

Werden mehrere Store Views unterstützt?

Ja. Über den Store-Code leitet die App Anfragen an den richtigen Store weiter. Das richtet das Entwicklungsteam ein.

Was bedeutet die Meldung PRODUCT\_NOT\_FOUND?

Zum angefragten URL-Schlüssel gibt es kein Produkt. Den URL-Schlüssel im Magento Admin prüfen. Für Kategorien gilt dasselbe mit CATEGORY\_NOT\_FOUND.

## Passend dazu

- [Apps finden, installieren und konfigurieren](https://academy.laioutr.com/artikel/apps-finden-installieren-und-konfigurieren)6 Min.

  Apps stehen im Cockpit unter Apps als Katalog bereit, werden je Umgebung installiert und unter Configuration eingerichtet. Die Storefront nutzt sie ab dem nächsten Deployment.
- [Zugangsdaten eintragen und Verbindung testen](https://academy.laioutr.com/artikel/zugangsdaten-eintragen-und-verbindung-testen)5 Min.

  Zugangsdaten einer App werden je Umgebung unter Configuration eingetragen, mit Test connection geprüft und mit Save settings gespeichert. Wirksam werden sie mit dem nächsten Deployment.
- [Echte Daten in Studio prüfen](https://academy.laioutr.com/artikel/echte-daten-in-studio-pruefen)5 Min.

  Studio zeigt in der Vorschau echte Daten aus den angebundenen Apps. Auf dynamischen Seiten wie der Produktdetailseite wählt das Feld Preview Data, welches Produkt die Vorschau zeigt.
- [Produktlisten mit Filter und Sortierung einrichten](https://academy.laioutr.com/artikel/produktlisten-mit-filter-und-sortierung-einrichten)6 Min.

  Eine Produktliste entsteht in Studio aus Product Listing Grid, Filter Bar und Sortierung; Produkte, Filter und Sortieroptionen liefert die angebundene Commerce-App über Orchestr. Welche Filter erscheinen, hängt davon ab, was das Backend bereitstellt.

## [Commerce-Systeme](https://academy.laioutr.com/leitfaeden/commerce-systeme)

In diesem Leitfaden suchen

1. [Shopify anbinden](https://academy.laioutr.com/apps/shopify-anbinden)10 Min.
2. [Shopware mit Checkout-Plugin anbinden](https://academy.laioutr.com/apps/shopware-mit-checkout-plugin-anbinden)12 Min.
3. [VTEX anbinden](https://academy.laioutr.com/apps/vtex-anbinden)8 Min.
4. [Sylius anbinden](https://academy.laioutr.com/apps/sylius-anbinden)8 Min.
5. [JTL-Wawi anbinden](https://academy.laioutr.com/apps/jtl-wawi-anbinden)8 Min.
6. [B2B Sellers für Shopware anbinden](https://academy.laioutr.com/apps/b2b-sellers-fuer-shopware-anbinden)8 Min.
7. [Magento 2 anbinden](https://academy.laioutr.com/apps/magento-2-anbinden)10 Min. In Vorbereitung

## Structured Data

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@id": "https://academy.laioutr.com/#website",
      "@type": "WebSite",
      "inLanguage": "de",
      "name": "Default",
      "url": "https://academy.laioutr.com/",
      "workTranslation": {
        "@id": "https://academy.laioutr.com/#website"
      }
    },
    {
      "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#webpage",
      "name": "Academy App",
      "url": "https://academy.laioutr.com/apps/magento-2-anbinden",
      "@type": [
        "WebPage",
        "FAQPage"
      ],
      "breadcrumb": {
        "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#breadcrumb"
      },
      "isPartOf": {
        "@id": "https://academy.laioutr.com/#website"
      },
      "mainEntity": [
        {
          "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#/schema/question/1"
        },
        {
          "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#/schema/question/2"
        },
        {
          "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#/schema/question/3"
        }
      ],
      "potentialAction": [
        {
          "@type": "ReadAction",
          "target": [
            "https://academy.laioutr.com/apps/magento-2-anbinden"
          ]
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#breadcrumb",
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "name": "Home",
          "item": "https://academy.laioutr.com/",
          "position": 1
        },
        {
          "@type": "ListItem",
          "name": "Apps",
          "item": "https://academy.laioutr.com/bereiche/apps",
          "position": 2
        },
        {
          "@type": "ListItem",
          "name": "Commerce-Systeme",
          "item": "https://academy.laioutr.com/leitfaeden/commerce-systeme",
          "position": 3
        },
        {
          "@type": "ListItem",
          "name": "Magento 2 anbinden",
          "item": "https://academy.laioutr.com/apps/magento-2-anbinden",
          "position": 4
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#/schema/question/1",
      "@type": "Question",
      "inLanguage": "de",
      "name": "Gilt die App für Magento Open Source und Adobe Commerce?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Ja. Beide Editionen nutzen dieselbe GraphQL API, die App heißt im Katalog Adobe Commerce.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#/schema/question/2",
      "@type": "Question",
      "inLanguage": "de",
      "name": "Werden mehrere Store Views unterstützt?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Ja. Über den Store-Code leitet die App Anfragen an den richtigen Store weiter. Das richtet das Entwicklungsteam ein.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/apps/magento-2-anbinden#/schema/question/3",
      "@type": "Question",
      "inLanguage": "de",
      "name": "Was bedeutet die Meldung PRODUCT_NOT_FOUND?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Zum angefragten URL-Schlüssel gibt es kein Produkt. Den URL-Schlüssel im Magento Admin prüfen. Für Kategorien gilt dasselbe mit CATEGORY_NOT_FOUND.</p>"
      }
    }
  ]
}
```