> 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/automation/connectors/equipme-pro.md).

# equipme Connector – Pro-Module

Der equipme Connector für Provider: Modul „Equipme Pro“ mit Triggern und Aktionen für Kunden, Services, Angebote, Serviceinstanzen, Aufträge, Fulfillment, Pakete, Einkauf, Abrechnung.

Mit dem **equipme Connector** verbindest du Equipme Pro in [Workflows](/pro/dokumentation/automation/workflows.md) mit deinen übrigen Systemen – etwa ERP, PSA, Lagerverwaltung, Distributor oder Versanddienstleister. Für Provider gibt es dafür das eigene Modul **„Equipme Pro“**. Es arbeitet auf Provider-Ebene und greift auf die Daten **aller deiner Kunden** zu.

**Beispiele:**

* Neuer Kundenauftrag in Pro → Auftrag im ERP anlegen
* Neue Fulfillment-Position → Kommissionierauftrag im Lagersystem anlegen → Status in Pro zurückmelden
* Versand im Lagersystem → Paket mit Sendungsnummer in Pro anlegen → Kunde sieht den Lieferstatus
* Neuer Kunde im CRM → Kunde in Pro anlegen, Standorte und Ansprechpartner übernehmen
* Preisänderung beim Distributor → Einkaufsangebot des Produkts in Pro aktualisieren

## Module

Der equipme Connector besteht aus mehreren Modulen. Jedes Modul erscheint im Flow-Designer als eigene Kachel.

| Modul                                                                           | Inhalt                                                                                                                                                                                                    | Dokumentation                             |
| ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| **Equipme Pro**                                                                 | Provider-Funktionen: Kunden und deren Organisation, Services, Angebote, Serviceinstanzen, Kundenaufträge, Fulfillment, Pakete, Einkaufsbestellungen, Produktstammdaten, Abrechnung, Bestellberechtigungen | diese Seite                               |
| **Equipme**, **Equipme Approval**, **Equipme Operations**, **Email**, **Forms** | Funktionen für die eigene Organisation (Mitarbeiter, Standorte, Gruppen, Assets, Genehmigungen, Tickets) sowie E-Mail-Versand und Formulare                                                               | siehe Kundenhandbuch, „equipme Connector“ |
| **Equipme Integration**                                                         | Individuell eingerichtete Auswertungen (z. B. ein Provisionsbericht) als Liste abrufen                                                                                                                    | nur nach Einrichtung durch equipme        |

{% hint style="info" %}
Die Module **Equipme**, **Equipme Approval**, **Equipme Operations**, **Email** und **Forms** funktionieren in Pro genauso wie im Kundenportal und beziehen sich auf deine **eigene** Organisation. Ihre Trigger und Aktionen sind im Kundenhandbuch beschrieben und werden hier nicht wiederholt.
{% endhint %}

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](/pro/dokumentation/automation.md)
* Ein **API-Key** aus Equipme Pro (siehe [Integrationen → „API-Key“](/pro/dokumentation/administration/integrations.md#api-key))
* Die Rolle **„Administrator“** in Pro, um API-Keys zu verwalten

## Verbindung einrichten

1. In Pro unter **„Administration“ → „Integrationen“ → „API-Key“** einen API-Key erzeugen und sicher aufbewahren – wie ein Passwort.
2. Im Flow-Designer eine Komponente des Moduls „Equipme Pro“ auf die Arbeitsfläche ziehen (z. B. *List Customers*).
3. **Connect account** klicken und eintragen:
   * **Label** – frei wählbarer Name der Verbindung (z. B. „Pro Produktion“)
   * **API Key** – der API-Key aus Pro
4. Die Verbindung wird geprüft. Danach steht sie in allen Komponenten des equipme Connectors zur Verfügung und erscheint unter **„Accounts“**.

{% hint style="warning" %}
Der API-Key muss aus **Equipme Pro** stammen (Provider-Ebene). Ein API-Key aus einem Kundenportal gibt nur Zugriff auf die Daten dieses einen Kunden; die Pro-Komponenten liefern damit keine oder unvollständige Ergebnisse.
{% endhint %}

## Grundkonzepte

Die Grundkonzepte entsprechen denen des Kunden-Connectors (siehe Kundenhandbuch):

* **Trigger** (Namen beginnen mit *New …*) fragen Pro regelmäßig nach neuen Einträgen ab und lassen sich nach Datum (*After*) und weiteren Kriterien filtern.
* **Aktionen** lesen oder verändern Daten (*List …*, *Get …*, *Search …*, *Add …*, *Update …*, *Set …*, *Remove …*, *Delete …*).
* **Listen-Aktionen** bieten die Einstellung **Output Type** („All items at once“, „One item at a time“, „First item only“, „Store to CSV file“).
* **Metadaten** (Schlüssel/Wert) speichern Kennungen aus Fremdsystemen, z. B. die ERP-Kundennummer am Kunden oder die ERP-Auftragsnummer an der Serviceinstanz.
* **Anfragelimit:** 10 Anfragen pro Sekunde je API-Key; der Connector hält es automatisch ein und wiederholt Anfragen bei Überschreitung bis zu dreimal.

## Modul „Equipme Pro“

### Trigger

| Komponente                | Löst aus, wenn …                                                      | Filter                                                            |
| ------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------- |
| New Customer              | ein neuer Kunde hinzukommt                                            | After                                                             |
| New Sales Order           | ein Kunde einen neuen Auftrag bei dir aufgibt                         | Customers, After                                                  |
| New Fulfillment Order     | eine neue Fulfillment-Position entsteht                               | Customers, Service categories, Services, Transaction types, After |
| New Fulfillment Parcel    | ein neues Paket angelegt wird                                         | After                                                             |
| New Dropshipping Order    | eine neue Einkaufsbestellung (Dropshipping) beim Lieferanten entsteht | After                                                             |
| New Invoice               | eine neue Rechnung erzeugt wird                                       | After                                                             |
| New Authorization Request | ein Kunde die Bestellberechtigung anfragt                             | Customers, Type („Order authorization“), After                    |

**Transaktionsarten** („Transaction types“) bei Fulfillment-Positionen: „Order“ (Bestellung), „Delivery Request“ (Abruf), „Return“ (Rückgabe), „Change“ (Änderung), „Swap“ (Tausch), „Cancellation“ (Abbestellung).

### Kunden und deren Organisation

| Bereich           | Aktionen                                                                                                              |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- |
| Kunden            | Add / Update / Get / List Customers, Get / Update Customer Metadata                                                   |
| Kundenmitarbeiter | Add Customer Employee, Get / List Customer Employees, Get / Update Customer Employee Metadata                         |
| Kundenstandorte   | Add / Get / List / Search Customer Locations, Add Customer Location Managers, Get / Update Customer Location Metadata |
| Kundengruppen     | Get / List Customer Groups, Get / Update Customer Group Metadata                                                      |

*Add Customer* legt einen Kunden mit Name, Kundennummer, Beschreibung, Status („Active“), den drei [Kundenattributen](/pro/dokumentation/administration/supplier-profile.md#reiter-kundenattribute), Ansprechpartner (Name, E-Mail, Telefon), Sprache, Account Manager sowie Firmen- und Rechnungsadresse an. *List Customers* filtert nach Namen, Kundennummern und Status. *List Customer Locations* lässt sich zusätzlich auf Standorttypen („Location“, „Home office“) einschränken; Lager eines Standorts werden immer mitgeliefert.

### Services und Angebote (Service Portfolio)

| Bereich                         | Aktionen                                                            |
| ------------------------------- | ------------------------------------------------------------------- |
| Services                        | Add / Update / Remove / Get / List Services, Set Service Attributes |
| Angebote                        | Add / Update / Remove / Get / List Service Offers                   |
| Kategorien                      | Get / List Service Categories                                       |
| Kundenspezifische Service-Daten | Get / Update Customer Service Metadata                              |

### Serviceinstanzen

| Bereich          | Aktionen                                                                                                    |
| ---------------- | ----------------------------------------------------------------------------------------------------------- |
| Serviceinstanzen | Add / Update / Get / List Service Instances, List Customer Service Instances                                |
| Metadaten        | Get / Set Service Instance Metadata (gesamt), Get / Set Service Instance Metadata Entry (einzelner Eintrag) |
| Anhänge          | List / Get / Download / Upload / Delete Service Instance Attachments                                        |

*Add Service Instance* erfasst eine aktive Serviceinstanz direkt beim Kunden – mit Angebot, Kunde, Standort, Gruppe oder Mitarbeiter, Inventarnummer, einmaligen und laufenden Kosten, Laufzeit, Verlängerung, Aktivierungs- und Ablaufdatum sowie Metadaten. Das eignet sich z. B. zur Übernahme von Bestandsdaten. *List Service Instances* filtert nach Services, Kunden, Standorten, Gruppen, Mitarbeitern und Status. Anhänge löschen kann nur das Unternehmen, das sie hochgeladen hat.

### Kundenaufträge und Bestellberechtigung

| Bereich               | Aktionen                                                                                           |
| --------------------- | -------------------------------------------------------------------------------------------------- |
| Kundenaufträge        | List Sales Orders (Filter: Customers, Status „New“, „In Process“, „Processed“, „Cancelled“, After) |
| Bestellberechtigungen | Get / List / Update Authorization Requests                                                         |

Mit *Update Authorization Request* setzt du eine Anfrage auf „In process“, „Approved“ oder „Denied“, optional mit Notiz – z. B. nach einer automatischen Bonitätsprüfung. Was die Bestellberechtigung für den Kunden bedeutet, beschreibt [Kunden anlegen und einladen](/pro/dokumentation/customers/create-and-invite-customers.md).

### Fulfillment und Pakete

| Bereich                | Aktionen                                                                |
| ---------------------- | ----------------------------------------------------------------------- |
| Fulfillment-Positionen | Get / List / Update Fulfillment Orders, Update Fulfillment Order Status |
| Pakete                 | Add / Get / List / Update Fulfillment Parcels                           |

*List Fulfillment Orders* filtert nach Kunden, Service-Kategorien, Services, Transaktionsarten, Status, Auftragsnummer, externen IDs und Zeitraum.

*Update Fulfillment Order Status* führt einen Statusschritt aus:

| Aktion                                                | Bedeutung                                               |
| ----------------------------------------------------- | ------------------------------------------------------- |
| Process                                               | Position in Bearbeitung nehmen                          |
| Dispatch Delivery                                     | Auslieferung versenden                                  |
| Reject Delivery                                       | Zustellung als nicht möglich melden                     |
| Confirm Delivery                                      | Zustellung bestätigen                                   |
| Process Returned Item                                 | Zurückgegebenen Artikel bearbeiten                      |
| Complete                                              | Position abschließen                                    |
| Complete return by decommissioning the affected asset | Rückgabe abschließen und das Asset außer Betrieb nehmen |
| Cancel                                                | Position stornieren                                     |

Welche Schritte für eine Position erlaubt sind, hängt von ihrem aktuellen Status und dem hinterlegten Prozess ab (siehe [Fulfillment](/pro/dokumentation/fulfillment.md)).

*Add Fulfillment Parcel* legt ein Paket für bestimmte Fulfillment-Positionen an – mit Liefer- und Absenderadresse, Lieferscheinnummer, Versanddienstleister („Carrier“), Empfänger, Referenz, externer ID, Status, erwartetem und tatsächlichem Lieferdatum, Sendungsnummer und Tracking-Link. Paketstatus: „New“, „Ready“, „In Transit“, „Delayed“, „Delivered“, „Picked Up“, „Failed“, „Refused by Recipient“, „Returned-to Sender“, „Cancelled“.

### Einkauf (Dropshipping-Bestellungen)

| Bereich              | Aktionen                                                                  |
| -------------------- | ------------------------------------------------------------------------- |
| Einkaufsbestellungen | Get / List / Update Dropshipping Orders, Update Dropshipping Order Status |
| Bestellpositionen    | List Dropshipping Order Items, Update Dropshipping Order Item Status      |

Statusschritte für Bestellung und Positionen: „Confirm“, „Process“, „Dispatch Delivery“, „Reject Delivery“, „Confirm Delivery“, „Complete“, „Cancel“. So meldest du z. B. die Auftragsbestätigung oder den Versand eines Distributors automatisch in Pro zurück (siehe [Bestellungen](/pro/dokumentation/procurement/purchase-orders.md)).

### Produktstammdaten

| Bereich          | Aktionen                                    |
| ---------------- | ------------------------------------------- |
| Produkte         | Add / Update / Get / List Sourcing Products |
| Einkaufsangebote | Add / Update / Get / List Sourcing Offers   |
| Lieferanten      | Get Sourcing Supplier                       |

*Add Sourcing Product* legt ein Produkt mit Name, Beschreibung, EAN, Herstellernummer („Part number“), Hersteller, Kategorie, Quelle, externer ID, Lagerartikel-Kennzeichen, Mindestbestand, Lieferant, Einkaufspreis, Lagerbestand und Verkaufspreis an. Doppelte Herstellernummern sind nur mit „Allow duplicate part number“ erlaubt. Siehe auch [Produktstammdaten](/pro/dokumentation/portfolio/products.md).

### Abrechnung

| Bereich               | Aktionen                 |
| --------------------- | ------------------------ |
| Rechnungen            | List Invoices            |
| Abrechnungspositionen | Add / List Billing Items |

*Add Billing Item* erzeugt eine zusätzliche Abrechnungsposition mit Typ („Fee“, „Tax“, „Refund“, „Discount“, „Credit“), Zyklus („None“, „Daily“, „Weekly“, „Biweekly“, „Monthly“, „Annually“, „Triennial“), Bezug (Resource ID), Beschreibung, Zeitraum, Satz, Menge und Notiz. *List Billing Items* filtert nach Kunden, Rechnungen, Typ, Status und Zeitraum. Siehe [Abrechnung](/pro/dokumentation/sales/billing.md).

## Beispiel: Neue Kunden aus dem CRM anlegen

1. **Trigger:** neuer Eintrag im CRM (CRM-Connector oder Webhook).
2. **Equipme Pro › List Customers** mit der Kundennummer, um Doppelungen zu vermeiden; mit einem **Filter** nur weitermachen, wenn kein Treffer gefunden wurde.
3. **Equipme Pro › Add Customer** mit Name, Kundennummer, Ansprechpartner, Sprache, Account Manager und Adressen.
4. **Equipme Pro › Update Customer Metadata:** CRM-ID als Metadatum speichern.
5. **Email › Send Email:** Information an den zuständigen Account Manager.

## Fehlersuche

| Problem                                             | Ursache / Lösung                                                                                                                                              |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| „Connect account“ schlägt fehl                      | API-Key prüfen (Tippfehler, abgelaufen, gelöscht, Key aus einem Kundenportal statt aus Pro).                                                                  |
| Pro-Komponente liefert keine Kunden oder Positionen | Der API-Key stammt nicht aus Pro oder Filter (Customers, After, Status) schränken zu stark ein.                                                               |
| Statusänderung wird abgelehnt                       | Der gewünschte Schritt ist im aktuellen Status nicht erlaubt (z. B. „Complete“ vor „Dispatch Delivery“). Aktuellen Status mit *Get Fulfillment Order* prüfen. |
| Fehlermeldung zum Anfragelimit                      | Zu viele parallele Flows mit demselben API-Key. Flows zeitlich entzerren oder *One item at a time* mit Verzögerung nutzen.                                    |
| Aktion liefert „403/Forbidden“                      | Dem API-Key fehlt die Berechtigung für diese Ressource, oder der Datensatz gehört nicht zu deinen Kunden.                                                     |
| Pflichtfeld fehlt / Wert ungültig                   | Feldlängen und Formate beachten (z. B. E-Mail-Format, ISO-Datum, zulässige Werte).                                                                            |

Bei Fehlern helfen die Protokolle unter **„Insights“**. Für Unterstützung an den [Support](/pro/dokumentation/help/support.md) wenden und dabei Flow-Name, Komponente und Fehlermeldung angeben.

## Häufige Fragen

**Brauche ich für Pro und für mein eigenes Unternehmen zwei Verbindungen?**

Nein. Der API-Key aus Pro gilt für alle Module des equipme Connectors. Die Pro-Komponenten arbeiten mit den Daten deiner Kunden, die übrigen Module mit deiner eigenen Organisation.

**Kann ein Flow im Namen eines Kunden bestellen?**

Nein, das Modul „Equipme Pro“ bildet die Provider-Seite ab (Aufträge empfangen, liefern, abrechnen). Bestellungen löst der Kunde in seinem Kundenportal aus.


---

# 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/automation/connectors/equipme-pro.md?ask=<question>&goal=<user_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.