> 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/weclapp.md).

# weclapp Connector

Der weclapp Connector für Provider: Kundenaufträge, Rechnungen, Verträge und Kunden aus Equipme Pro in weclapp anlegen, Lieferungen und Seriennummern zurückmelden.

**Pfad:** „Automation“ → „Workflows“ → Flow-Designer → Connector **„Weclapp“**

Mit dem **weclapp Connector** verbindest du Equipme Pro in [Workflows](https://hub.equipme.io/pro/dokumentation/automation/workflows.md) mit deinem ERP **weclapp**. Aufträge deiner Kunden werden zu Verkaufsaufträgen, Lieferungen zu Rechnungen, laufende Services zu Verträgen – und Lieferdaten aus weclapp fließen zurück nach Pro.

## Wofür?

* **Kundenaufträge ins ERP:** Ein neuer Auftrag eines Kunden in Pro wird automatisch als Verkaufsauftrag in weclapp angelegt.
* **Kunden synchron halten:** Neue Kunden aus Pro auch in weclapp anlegen und die weclapp-ID in Pro speichern.
* **Rechnungen an Kunden:** Abrechnungsdaten aus Pro als Ausgangsrechnung in weclapp erzeugen.
* **Verträge für laufende Services:** Für Mietgeräte oder Managed Services einen Vertrag mit Abrechnungsart in weclapp anlegen.
* **Lieferstatus zurückmelden:** Lieferungen und Seriennummern aus weclapp abrufen und als Paket bzw. Metadatum in Pro hinterlegen.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/pro/dokumentation/automation.md)
* Ein **weclapp-Konto** (Mandant) mit einem Benutzer, der Verkauf, Einkauf, Verträge und Lager lesen und bearbeiten darf
* Den **API-Token** dieses Benutzers (in weclapp unter den persönlichen Einstellungen des Benutzers)
* Für die Trigger: Der Benutzer muss in weclapp Webhooks anlegen dürfen
* Für die Pro-Seite der Flows: eine Verbindung des [equipme Connectors](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) mit einem API-Key aus Pro

## Verbindung einrichten

1. In weclapp den **API-Token** des Benutzers kopieren und den **Mandantennamen** notieren – das ist der erste Teil deiner weclapp-Adresse (bei `meinefirma.weclapp.com` also `meinefirma`).
2. Im Flow-Designer eine Komponente des weclapp Connectors auf die Arbeitsfläche ziehen (z. B. *ListCustomers*).
3. **Connect account** klicken und eintragen:
   * **Tenant** – der Mandantenname
   * **Token** – der API-Token
4. Die Verbindung wird gegen weclapp geprüft und unter dem Mandantennamen gespeichert. Danach steht sie in allen weclapp-Komponenten zur Verfügung und erscheint unter **„Accounts“**.

{% hint style="info" %}
Die Komponenten tragen im Flow-Designer ihren technischen Namen (z. B. *AddSalesOrder*). Auswahlfelder wie „Sales channel“, „Warehouse“, „Payment method“ oder „Cost center“ laden ihre Werte direkt aus deinem weclapp-Mandanten.
{% endhint %}

## Trigger

| Komponente        | Löst aus, wenn …                                                                 |
| ----------------- | -------------------------------------------------------------------------------- |
| NewArticle        | in weclapp ein neuer Artikel angelegt wird. Liefert den vollständigen Artikel.   |
| ChangedSalesOrder | in weclapp ein Verkaufsauftrag geändert wird. Liefert den vollständigen Auftrag. |

Beide Trigger haben keine Einstellungen. weclapp meldet das Ereignis beim Start des Flows sofort an Pro; eine regelmäßige Abfrage findet nicht statt. *ChangedSalesOrder* eignet sich, um Statusänderungen eines Auftrags (z. B. Versand) nach Pro zurückzuspielen.

## Aktionen

### Kunden und Artikel

| Komponente    | Zweck                         | Wichtige Optionen                                                                                                                                  |
| ------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddCustomer   | Kunden (Organisation) anlegen | Pflicht: „Company“, „Country code“, „Sales channel“; optional E-Mail, „Customer number“, Adresse, Kontakte, „Additional fields“ (eigene Attribute) |
| ListCustomers | Kunden auflisten              | „Filter“                                                                                                                                           |
| GetArticle    | Einen Artikel lesen           | „Article ID“                                                                                                                                       |
| ListArticles  | Artikel auflisten             | „Filter“                                                                                                                                           |

### Verkauf

| Komponente                      | Zweck                                               | Wichtige Optionen                                                                                                                                                                                                                                                                        |
| ------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddSalesOrder                   | Verkaufsauftrag anlegen                             | Pflicht: „Customer ID“, „Sales channel“; abweichende Liefer- und Rechnungsadresse, „Customer order number“, Positionen, Versandkosten, „Type“ („Standard“, „Advance payment“, „Prepayment“, „Part payment“, „Retail sale“), „Warehouse“, „Shipment type“, Liefertermine, „Only services“ |
| GetSalesOrder / ListSalesOrders | Verkaufsaufträge lesen                              | „Order ID“                                                                                                                                                                                                                                                                               |
| CancelSalesOrder                | Verkaufsauftrag stornieren bzw. manuell abschließen | „Order ID“                                                                                                                                                                                                                                                                               |
| AddSalesInvoice                 | Ausgangsrechnung anlegen                            | Pflicht: „Customer ID“, „Sales channel“; Positionen, Leistungszeitraum, „Due date“, „Grouping of items“, Belegtexte, „Dunning block“ („Without“, „Temporary“, „Indefinite“), Kostenstelle                                                                                                |

### Verträge

| Komponente  | Zweck           | Wichtige Optionen                                                                                                                                                                                                                                                     |
| ----------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddContract | Vertrag anlegen | Pflicht: „Label“, „Sales channel“; „Contract partner“, „Start date“, „End date“ oder „Unlimited“, „Type“, „Status“ („Active“, „Draft“, „Inactive“), Positionen („Revenue“/„Expenditure“), Kosten, „Billing type“, „Billing day“, „Desired invoice status“, Erinnerung |

Die **„Billing type“** legt fest, wie weclapp den Vertrag abrechnet: „Create invoice before billing period“, „Create invoice after billing period“, „Create sales order“, „Not invoiceable“ oder „None“.

### Einkauf

| Komponente         | Zweck                                       | Wichtige Optionen                                                                                                                                |
| ------------------ | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| AddPurchaseOrder   | Einkaufsbestellung beim Lieferanten anlegen | Pflicht: „Supplier“, „Warehouse“; Positionen, Versandkosten, Zahlungsart, „Delivery conditions“, Liefertermine, Sendungsnummer und Tracking-Link |
| AddPurchaseInvoice | Eingangsrechnung erfassen                   | Pflicht: „Supplier“; Rechnungsnummer und -datum, Positionen, „Cost center“, „Cost type“, Buchungsdaten, „Payment block“                          |

### Lager und Logistik

| Komponente                          | Zweck               | Wichtige Optionen                |
| ----------------------------------- | ------------------- | -------------------------------- |
| GetShipment / ListShipments         | Lieferungen lesen   | „Shipment ID“ bzw. „Filter“      |
| GetSerialNumber / ListSerialNumbers | Seriennummern lesen | „Serial Number ID“ bzw. „Filter“ |

### Positionen und Filter

* **Positionen:** „Items (static)“ erfasst Positionen einzeln im Formular („Article ID“, „Position title“, „Quantity“, „Unit“, Preis, Rabatt); Positionen mit Menge 0 werden übersprungen. „Items (dynamic)“ übernimmt eine fertige Positionsliste aus einem vorherigen Schritt, z. B. die Positionen eines Kundenauftrags aus Pro. Versandkosten funktionieren genauso.
* **Filter:** *ListArticles*, *ListCustomers*, *ListShipments* und *ListSerialNumbers* filtern über „Property“ (Feldname in weclapp, z. B. `customerNumber`), „Operator“ (z. B. „equals“, „like expression“) und Wert, kombinierbar mit UND und ODER.

## Beispiele

### Kundenauftrag aus Pro als Verkaufsauftrag anlegen

1. **Trigger:** *Equipme Pro › New Sales Order*.
2. **Equipme Pro › Get Customer Metadata:** weclapp-Kunden-ID des Kunden lesen.
3. **Weclapp › AddSalesOrder** mit „Customer ID“, „Sales channel“, Lieferadresse des Kundenstandorts, „Customer order number“ (Auftragsnummer aus Pro) und den Positionen.
4. **Equipme Pro › Set Service Instance Metadata Entry:** weclapp-Auftragsnummer an der Serviceinstanz speichern.

### Neue Kunden in weclapp anlegen

1. **Trigger:** *Equipme Pro › New Customer*.
2. **Weclapp › ListCustomers** mit Filter `customerNumber` „equals“ Kundennummer; nur weitermachen, wenn kein Treffer gefunden wurde.
3. **Weclapp › AddCustomer** mit Firmenname, Kundennummer, Adresse und „Sales channel“.
4. **Equipme Pro › Update Customer Metadata:** weclapp-ID am Kunden speichern.

### Versand aus weclapp nach Pro zurückmelden

1. **Trigger:** *Weclapp › ChangedSalesOrder*; mit einem **Filter** nur Aufträge mit Versandstatus weiterverarbeiten.
2. **Weclapp › ListShipments** mit Filter auf den Auftrag, um Sendungsnummer und Versanddienstleister zu lesen.
3. **Equipme Pro › Add Fulfillment Parcel** mit Sendungsnummer und Tracking-Link – dein Kunde sieht den Lieferstatus im Kundenportal.
4. **Equipme Pro › Update Fulfillment Order Status** mit „Dispatch Delivery“.

## Hinweise und Grenzen

* Die Trigger reagieren nur auf **neue Artikel** und **geänderte Verkaufsaufträge**. Für andere Ereignisse einen Scheduler mit einer Listen-Aktion kombinieren.
* Listen-Aktionen liefern die **erste Ergebnisseite** von weclapp, nicht zwingend alle Einträge. Mit Filtern die Treffermenge klein halten. *ListSalesOrders* hat keinen Filter.
* Eine abweichende Liefer- oder Rechnungsadresse wird nur übernommen, wenn dort ein „Country code“ eingetragen ist.
* Die Zuordnung Kunde in Pro ↔ Kunde in weclapp musst du selbst pflegen, am besten als Metadatum am Kunden.
* Alle Aktionen arbeiten mit den Rechten des weclapp-Benutzers, dessen Token du verwendest.

## Fehlersuche

| Problem                        | Ursache / Lösung                                                                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| „Connect account“ schlägt fehl | Mandantenname (nur der erste Teil der Adresse, ohne `.weclapp.com`) und Token prüfen.                                                            |
| Auswahlfeld bleibt leer        | Die Verbindung fehlt oder der Benutzer darf den Bereich (z. B. Lager, Vertriebskanäle) nicht lesen.                                              |
| Trigger löst nicht aus         | Ist der Flow gestartet? Darf der Benutzer in weclapp Webhooks anlegen? Nach Änderungen den Flow stoppen und neu starten.                         |
| Verkaufsauftrag wird abgelehnt | „Customer ID“ ist keine gültige weclapp-ID oder „Article ID“ einer Position fehlt. IDs vorher mit *ListCustomers* bzw. *ListArticles* ermitteln. |
| Kunde doppelt angelegt         | Vor *AddCustomer* mit *ListCustomers* prüfen und die weclapp-ID als Metadatum in Pro speichern.                                                  |

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

## Häufige Fragen

**Wo finde ich die „Customer ID“ für einen Verkaufsauftrag?**

Das ist die interne ID des Kunden in weclapp, nicht die Kundennummer. Ermittle sie einmalig mit *ListCustomers* und speichere sie als Metadatum am Kunden in Pro – dann steht sie in jedem Auftrags-Flow bereit.

**Kann ich Rechnungen aus Pro statt aus weclapp verschicken?**

Beides geht. Wenn weclapp führend ist, legst du mit *AddSalesInvoice* die Rechnung dort an; die Abrechnung in Pro dient dann als Quelle (siehe [Abrechnung](https://hub.equipme.io/pro/dokumentation/sales/billing.md)).

**Brauche ich je Kunde eine eigene weclapp-Verbindung?**

Nein. Eine Verbindung zu deinem weclapp-Mandanten reicht für alle Kunden.


---

# 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/weclapp.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.
