Unified Order API

Ein API-Call statt vieler: Erstelle Xentral-Aufträge mit einem einzigen Request. Kunde, Artikel, Versand - alles in einem Aufruf.

Anfrage stellenAlle Add-Ons

Das Problem mit der Xentral API

Xentral API erfordert mehrere sequenzielle Calls für einen Auftrag
Kunde muss erst gesucht und ggf. angelegt werden, bevor der Auftrag erstellt werden kann
Fehlerbehandlung über mehrere API-Calls ist komplex und fehleranfällig
Externe Systeme müssen die Xentral-Logik kennen und abbilden

Die Lösung: Eine API für alles

Ein einziger API-Request erstellt den kompletten Auftrag
Kunde wird automatisch gesucht oder angelegt - du sendest nur die Daten
Zentrale Validierung und Fehlerbehandlung mit klaren Fehlermeldungen
Externe Systeme senden nur Auftragsdaten - die Proxy-API erledigt den Rest

So einfach geht's

Ein Request - ein Auftrag. Keine komplexe Logik in deinem System.

// Vorher: 4+ API-Calls nötig
// 1. Kunde suchen
// 2. Wenn nicht gefunden: Kunde anlegen
// 3. Artikel-IDs ermitteln
// 4. Auftrag erstellen

// Nachher: 1 API-Call
POST /api/orders
{
  "customer": {
    "email": "kunde@example.com",
    "name": "Max Mustermann",
    "street": "Musterstraße 1",
    "zip": "12345",
    "city": "Musterstadt",
    "country": "DE"
  },
  "items": [
    { "sku": "ART-001", "quantity": 2 },
    { "sku": "ART-002", "quantity": 1 }
  ],
  "shipping": "dhl_standard",
  "payment": "paypal",
  "reference": "SHOP-12345"
}

So funktioniert's

Vom Request bis zum fertigen Auftrag in Xentral - vollautomatisch.

1

Request empfangen

Externes System sendet Auftragsdaten an die Unified API.

2

Validierung

Daten werden geprüft: Pflichtfelder, Artikelnummern, Format.

3

Kunde suchen/anlegen

Kunde wird per E-Mail gesucht. Wenn nicht gefunden: automatisch anlegen.

4

Auftrag erstellen

Auftrag wird in Xentral erstellt und Auftragsnummer zurückgegeben.

Alle Features im Überblick

  • Ein Request für alles: Kunde + Auftrag + Positionen

  • Automatische Kundensuche nach E-Mail oder Kundennummer

  • Kundenanlage wenn nicht vorhanden (konfigurierbar)

  • Artikelvalidierung vor Auftragsanlage

  • Konfigurierbare Standardwerte (Projekt, Zahlungsart, etc.)

  • Idempotenz-Support für sichere Wiederholungen

  • Detaillierte Fehlermeldungen mit Kontext

  • Webhook-Callback bei Auftragsanlage (optional)

Typische Anwendungsfälle

Shop-Integration

WooCommerce, Shopware oder Custom-Shop sendet Bestellungen direkt an Xentral - ohne komplexe Plugin-Logik.

Marktplatz-Anbindung

Amazon, eBay oder andere Marktplätze über eigene Middleware anbinden - die Unified API übernimmt die Xentral-Logik.

B2B-Portal

Händler-Portal oder Außendienst-App erstellt Aufträge direkt in Xentral - mit einer simplen API-Schnittstelle.

Preis

Auf Anfrage

Der Preis richtet sich nach deinem Auftragsvolumen und den benötigten Features. Im kostenlosen Erstgespräch analysieren wir deinen Bedarf.

Angebot anfragen

Häufige Fragen zur Unified Order API

Die API sucht zuerst nach der E-Mail-Adresse in Xentral. Optional kann auch nach Kundennummer oder anderen Feldern gesucht werden. Wird kein Kunde gefunden, wird automatisch ein neuer angelegt - sofern diese Option aktiviert ist.
Bei Fehlern wird eine detaillierte Fehlermeldung zurückgegeben, die genau beschreibt, was schiefgelaufen ist. Zum Beispiel: "Artikel SKU-123 nicht gefunden" oder "Pflichtfeld 'email' fehlt". Der Auftrag wird nur erstellt, wenn alle Validierungen erfolgreich sind.
Ja, das ist einer der Hauptanwendungsfälle. Shops wie WooCommerce, Shopware oder Custom-Shops können Aufträge direkt über die Unified API an Xentral senden, ohne die komplexe Xentral-API-Logik implementieren zu müssen.
Die API unterstützt Idempotenz. Du kannst eine eindeutige Referenz (z.B. Shop-Bestellnummer) mitsenden. Wenn ein Auftrag mit dieser Referenz bereits existiert, wird kein neuer angelegt, sondern der bestehende zurückgegeben.
Alle relevanten Auftragsdaten: Kundendaten (Name, Adresse, E-Mail), Positionen (Artikelnummer, Menge, ggf. Preis), Versand (Versandart), Zahlung (Zahlungsart, Status), sowie benutzerdefinierte Felder und interne Notizen.
Der Preis richtet sich nach deinem Auftragsvolumen und den benötigten Features. Im Erstgespräch klären wir deinen Bedarf und ich erstelle dir ein individuelles Angebot.

Das könnte dich auch interessieren

API Programmierung

Individuelle API-Entwicklung für Xentral

Mehr erfahren

Integrationen

Shops, Marktplätze und mehr anbinden

Mehr erfahren

Interesse an der Unified Order API?

Lass uns in einem kostenlosen Gespräch deinen Bedarf analysieren.

Gespräch vereinbaren