> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Admin

> Richte die Shopify Admin Integration in Langdock mit deiner eigenen Shopify App ein.

Verbinde Shopify Stores mit Langdock über deine eigene Shopify App. Erstelle die App im [Shopify Dev Dashboard](https://dev.shopify.com/dashboard). Trag Client ID und Client Secret in Langdock ein. Shopify Admin nutzt [Bring Your Own OAuth Client](/de/admin/manage-integrations/bring-your-own-oauth). Das Client Secret bleibt in den Workspace Admin Einstellungen, nicht im Chat.

<Warning>
  Diese Connection nutzt [Berechtigungen auf Anwendungsebene](/de/using-langdock/integrations/connections#benutzerdefinierte-scopes-und-berechtigungen-auf-anwendungsebene). Anfragen laufen mit den Admin API Scopes der App, nicht mit der Shopify Rolle der Person, die installiert hat.
</Warning>

Du brauchst:

* Zugriff auf das [Shopify Dev Dashboard](https://dev.shopify.com/dashboard). Wenn der Store nicht dir gehört, brauchst du die Berechtigung **App development → Develop**.
* Die Berechtigung, Apps auf dem Store zu installieren, den du verbinden willst
* Workspace Admin Zugriff in Langdock

## Einrichtung

<Steps>
  <Step title="App erstellen">
    Öffne das [Shopify Dev Dashboard](https://dev.shopify.com/dashboard). Klicke auf **Create app**.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/3UrDRxB6aEoTqUa4/de/images/shopify_admin_setup1.png?fit=max&auto=format&n=3UrDRxB6aEoTqUa4&q=85&s=938f9935ad9494f0063fcf3a54ace6af" alt="Shopify Dev Dashboard Apps-Seite mit dem Button Create app" style={{borderRadius: '6px'}} width="1840" height="1178" data-path="de/images/shopify_admin_setup1.png" />
    </Frame>
  </Step>

  <Step title="App benennen">
    Gib **Langdock** ein oder einen anderen Namen, den Leute wiedererkennen. Nutze **Start from Dev Dashboard**, nicht die Shopify CLI. Klicke auf **Create**.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/3UrDRxB6aEoTqUa4/de/images/shopify_admin_setup2.png?fit=max&auto=format&n=3UrDRxB6aEoTqUa4&q=85&s=181328f3bf2d9164e5195a06216f347a" alt="Create an app Screen mit Langdock als App-Namen unter Start from Dev Dashboard" style={{borderRadius: '6px'}} width="1840" height="1204" data-path="de/images/shopify_admin_setup2.png" />
    </Frame>
  </Step>

  <Step title="Scopes und Redirect URL hinzufügen">
    Öffne die App Version. Öffne **API access**. Unter **Scopes** fügst du diese kommagetrennte Liste ein.

    ```
    read_discounts,read_inventory,read_locations,read_orders,read_products,write_discounts,write_files,write_inventory,write_merchant_managed_fulfillment_orders,write_products
    ```

    Geh in Langdock zu **Admin → Integrations → Shopify Admin**. Erstelle den Custom OAuth Client. Kopiere **Redirect URL** aus Langdock. Füge sie unter **Redirect URLs** in Shopify ein. Die Domain hängt von deinem Deployment ab.

    ```
    https://app.langdock.com/api/integrations/{integration-id}/callback
    ```

    Speichere Scopes und Redirect URL. Veröffentliche die App Version.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/3UrDRxB6aEoTqUa4/de/images/shopify_admin_setup3.png?fit=max&auto=format&n=3UrDRxB6aEoTqUa4&q=85&s=bb4733537e79a152d926b3c6d7a5a5c0" alt="API access Einstellungen mit den Feldern Scopes und Redirect URLs" style={{borderRadius: '6px'}} width="1840" height="1214" data-path="de/images/shopify_admin_setup3.png" />
    </Frame>
  </Step>

  <Step title="Client und Secret in Langdock eintragen und authentifizieren">
    Öffne im Dev Dashboard **Settings**. Kopiere **Client ID** und **Client secret**.

    Füge sie in Langdock in den Custom OAuth Client für Shopify Admin ein. Speichere.

    Verbinde einen Store. Gib eine Custom Domain wie `shop.acme.com` ein, eine `*.myshopify.com` Domain oder den Store Handle. Schließ den Shopify Install Screen ab. Danach hat die App die Admin API Scopes aus Schritt 3.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/3UrDRxB6aEoTqUa4/de/images/shopify_admin_setup4.png?fit=max&auto=format&n=3UrDRxB6aEoTqUa4&q=85&s=db8a322db09e516db53a421c90dfd7c2" alt="Settings-Seite der App mit Client ID und Client secret" style={{borderRadius: '6px'}} width="1840" height="1142" data-path="de/images/shopify_admin_setup4.png" />
    </Frame>
  </Step>
</Steps>

<Info>
  Jede Langdock Connection ist ein Shop. Verbinde jeden Store einzeln. Denselben Custom OAuth Client kannst du wiederverwenden. Du brauchst weiterhin die Berechtigung, Apps auf jedem Shop zu installieren.
</Info>

## Was du nach der Einrichtung tun kannst

Du kannst Produkte, Inventar, Locations, Bestellungen, Fulfillments, Rabatte und Dateien im verbundenen Store nachschlagen und aktualisieren.

## Fehlerbehebung

**Invalid redirect URI**
Die Redirect URL in Shopify muss exakt mit der **Redirect URL** in Langdock übereinstimmen. Nimm `https` und `/callback` mit.

**OAuth Client ist nicht konfiguriert**
Speichere Client ID und Client Secret unter **Admin → Integrations → Shopify Admin**, bevor du einen Store verbindest.

**Access denied / forbidden**
Die App Version muss die Scopes oben enthalten. Schließ den Shopify Install Screen mit einem Konto ab, das Apps installieren darf.

**Ungültige Store Domain**
Gib die Domain ein, die du für den Store nutzt, die `*.myshopify.com` Domain oder den Store Handle. Streiche `https://`.