# Erste Schritte

Willkommen bei Orderport! In wenigen Minuten richten Sie Ihr Konto ein und empfangen Ihre erste Bestellung automatisch.

## Was ist Orderport?

Orderport empfängt Bestellungen Ihrer Kunden in verschiedenen Formaten – ob cXML von Ariba/Coupa oder JSON-Webhooks von Shopware 6, Shopify und WooCommerce – und wandelt sie automatisch in Ihr Wunschformat (openTrans oder JSON) um.

**Kurz gesagt:** Sie erhalten eine Webhook-URL, die Sie in das Einkaufssystem oder den Shop Ihres Kunden eintragen. Ab dann läuft alles automatisch.

## 1. Konto erstellen

Klicken Sie auf der Startseite auf **Kostenlos testen**. Sie erhalten 10 Tage kostenlosen Zugang ohne Kreditkarte.

Geben Sie Folgendes ein:

- **Name** – Ihr vollständiger Name
- **Firmenname** – der Name Ihres Unternehmens (wird als Tenant angelegt)
- **E-Mail-Adresse** – wird für Login und Benachrichtigungen verwendet
- **Passwort** – mindestens 12 Zeichen, Groß- und Kleinbuchstaben sowie Zahlen

Nach der Registrierung landen Sie direkt auf dem **Dashboard**.

## 2. Dashboard verstehen

Das Dashboard zeigt Ihnen auf einen Blick:

- **Bestellungen (30 Tage)** – wie viele Bestellungen insgesamt eingegangen sind
- **Zugestellt** – erfolgreich an Ihr System weitergeleitete Bestellungen
- **Fehlgeschlagen** – Bestellungen, bei denen die Zustellung nicht geklappt hat
- **Letzte Bestellungen** – die 5 neuesten Bestellungen mit Status

## 3. Erste Pipeline anlegen

Eine **Pipeline** ist der Weg, den eine Bestellung durch Orderport nimmt: Empfang, Umwandlung und Zustellung.

Klicken Sie in der Sidebar auf **Pipelines** und dann auf **Neue Pipeline**.

Der Pipeline-Wizard führt Sie in 4 Schritten durch die Einrichtung:

1. **Format** – Name vergeben, Eingabe- und Ausgabeformat wählen (z. B. cXML → openTrans oder Shopware 6 → JSON)
2. **Mapping** – Felder zwischen den Formaten zuordnen (kann übersprungen und später eingerichtet werden)
3. **Transport** – Wohin soll die Bestellung zugestellt werden? (z. B. HTTP POST, REST API oder E-Mail)
4. **Fertig** – Zusammenfassung, Webhook-URL und Zugangsdaten

> **Tipp:** Sie können das Mapping im Schritt 2 überspringen und später über die Pipeline-Detailseite einrichten.

## 4. Webhook-URL an den Kunden geben

Nach Abschluss des Wizards erhalten Sie:

- Eine **Webhook-URL**:
  - cXML-Pipelines: `https://orderport.app/api/v1/cxml/{token}`
  - JSON-Pipelines: `https://orderport.app/api/v1/webhook/{token}`
- Ein **Zugangscode** (SharedSecret, Bearer Token oder HMAC-Secret – einmalig angezeigt, bitte sofort sicher abspeichern!)

Diese Informationen tragen Sie in das Einkaufsnetzwerk (Ariba, Coupa) oder den Shop (Shopware, Shopify, WooCommerce) Ihres Kunden ein.

## 5. Erste Bestellung empfangen

Sobald das Einkaufsnetzwerk eine Bestellung sendet, passiert Folgendes:

1. Orderport empfängt die Bestellung über Ihre Webhook-URL
2. Die Authentifizierung wird geprüft (SharedSecret, Bearer Token oder HMAC-Signatur)
3. Die Bestellung wird normalisiert und ins Ausgabeformat umgewandelt
4. Das Ergebnis wird an Ihren Transport (HTTP POST, REST API oder E-Mail) zugestellt
5. Im Dashboard sehen Sie den Status: **zugestellt** oder **fehlgeschlagen**

Falls die Zustellung fehlschlägt, versucht Orderport es automatisch erneut (bis zu 5 Mal mit steigenden Wartezeiten).

## Nächste Schritte

- [Simple Wizard](/docs/simple-wizard) – 3 Schritte, Preset-basiert
- [Experten-Wizard](/docs/expert-wizard) – volle Kontrolle, 4 Schritte
- [Integrationen-Übersicht](/docs/kategorie/integrationen) – je eine Seite pro Drittsystem
- [Feldmapping](/docs/feldmapping) – Felder zwischen Formaten zuordnen
- [Bestellungen verwalten](/docs/bestellungen) – Status einsehen und Fehler beheben
- [Sicherheit](/docs/sicherheit) – 2FA und IP-Allowlist einrichten