> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/administration/integrations.md). # Integrationen Integrationen in Equipme Pro: API-Key und Tenant ID für Schnittstellen und Automation, Produktimport und Preisupdate aus Distributor-Katalogen, Paketübergabe an Versanddienstleister. **Pfad:** „Administration“ → „Integrationen“ Unter **„Integrationen“** verbindest du Equipme Pro mit anderen Systemen. Welche Reiter du siehst, hängt von deiner Rolle ab: | Reiter | Inhalt | Sichtbar für | | --------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------ | | **„API-Key“** | API-Keys und Tenant ID für Schnittstellen und das Automation-Modul | „Administrator“ | | Distributor-Kataloge (ein Reiter je Anbieter) | Zugangsdaten für den Produktimport und die Preisaktualisierung | „Administrator“, „Portfolio Manager“ | | Versanddienstleister | Zugangsdaten für die Übergabe von Paketen aus dem Fulfillment | „Administrator“ | Die Reiter der Distributor-Kataloge und des Versanddienstleisters tragen den Namen des jeweiligen Anbieters. {% hint style="info" %} Die Anmeldung per Single Sign-On richtest du nicht hier ein, sondern gemeinsam mit equipme (siehe [Anmeldung und Registrierung](/pro/dokumentation/getting-started/sign-in-and-registration.md)). {% endhint %} ## API-Key Mit einem API-Key verbindest du andere Systeme oder das [Automation-Modul](/pro/dokumentation/automation.md) bzw. den [equipme Connector](/pro/dokumentation/automation/connectors/equipme-pro.md) mit Equipme Pro. „Achtung: Der Key wird nur beim Erstellen angezeigt.“ 1. **„Ablaufdatum“** wählen: „Unbegrenzt“, „1 Monat“, „6 Monate“ oder „1 Jahr“. 2. **„Hinzufügen“** klicken. 3. **Den Key sofort kopieren** (Kopier-Symbol) **und sicher speichern.** Zusätzlich findest du hier die **„Tenant ID (wird für die API Kommunikation benötigt)“** mit Kopier-Symbol. Die Liste zeigt „API-Key“ (maskiert), „Ersteller“ und „Ablaufdatum“; abgelaufene Keys sind markiert. **Löschen** macht den Key sofort ungültig: „Solltest du ihn derzeit noch in einer Integration verwenden, wird diese daraufhin keinen Zugriff mehr auf die API haben.“ {% hint style="warning" %} **Ein API-Key aus Pro hat volle Administratorrechte** für dein Provider-Unternehmen und damit Zugriff auf die Daten aller deiner Kunden. Behandle ihn wie ein Passwort, gib ihn nicht weiter und lege für jede Anbindung einen eigenen Key mit möglichst kurzer Laufzeit an. Ist ein Key verloren oder kompromittiert, lösche ihn und erstelle einen neuen. {% endhint %} ## Distributor-Kataloge Über diese Reiter hinterlegst du Zugangsdaten zu angebundenen Distributor- bzw. Produktdaten-Katalogen. Damit importierst du Produktstammdaten direkt aus dem Katalog (siehe [Produktimport](/pro/dokumentation/portfolio/product-import.md)) und hältst die Preise importierter Produkte automatisch aktuell. Je nach Anbieter unterscheidet sich, was du hinterlegst: * **Persönliche Zugangsdaten:** Bei Katalogen mit Benutzerlizenzen gelten die hinterlegten Daten nur für deinen eigenen Benutzer. Jeder Mitarbeiter, der importieren möchte, hinterlegt dann seine eigenen Zugangsdaten. Die Voraussetzungen beim Anbieter (benötigte Lizenzen) nennt der Reiter. * **Firmenzugang:** Zusätzlich lassen sich Zugangsdaten eines administrativen Benutzers für die automatische Preissynchronisierung hinterlegen (nur „Administrator“). * **Login und Passwort:** Andere Anbieter erwarten einen Login mit Passwort für Import und Preisaktualisierung. So gehst du vor: 1. Reiter des Anbieters öffnen. 2. **„Hinzufügen“** bzw. **„Bearbeiten“** und Zugangsdaten eintragen. 3. **„Speichern“**. Gespeicherte Passwörter und Schlüssel werden sicher abgelegt und nicht wieder angezeigt; du kannst sie jederzeit aktualisieren oder mit **„Löschen“** entfernen. ## Versanddienstleister Mit der Anbindung eines Versanddienstleisters überträgst du Pakete, die du im Versandbereich des Fulfillments anlegst, direkt an den Dienstleister. Dort erstellst du Versanddokumente und Labels; Statusaktualisierungen der Sendungen werden zurück nach Pro übertragen (siehe [Kommissionierung, Produktion und Versand](/pro/dokumentation/fulfillment/picking-production-shipping.md)). 1. Im Portal des Versanddienstleisters eine API-Integration anlegen und die Schlüssel kopieren (eine Anleitung mit Link steht im Reiter). 2. In Pro **„Public Key“** und **„Secret Key“** eintragen und speichern. Löschst du die Zugangsdaten („Zugangsdaten löschen“), werden keine Pakete mehr übertragen und keine Statusaktualisierungen mehr synchronisiert. ## Häufige Fragen **Ich sehe den Reiter „API-Key“ nicht.** API-Keys verwalten nur Administratoren. **Mein API-Key funktioniert nicht mehr.** Prüfe in der Liste, ob er abgelaufen oder gelöscht ist. Erzeuge gegebenenfalls einen neuen Key und trage ihn in der Integration bzw. unter „Automation“ → „Accounts“ ein. **Kann ich den API-Key später noch einmal anzeigen?** Nein. Er wird nur beim Erstellen angezeigt. Erstelle bei Verlust einen neuen Key und lösche den alten. **Ein Kollege kann keine Produkte aus dem Distributor-Katalog importieren, obwohl ich meine Zugangsdaten hinterlegt habe.** Bei Katalogen mit Benutzerlizenz gelten die Zugangsdaten nur für den Benutzer, der sie hinterlegt hat. Dein Kollege muss eigene Zugangsdaten hinterlegen. **Welche Distributoren und Versanddienstleister werden unterstützt?** Die verfügbaren Anbieter siehst du als Reiter auf dieser Seite. Weitere Anbindungen sind über das [Automation-Modul](/pro/dokumentation/automation/connectors.md) möglich. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://hub.equipme.io/pro/dokumentation/administration/integrations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.