Mit einem Stuart-Kurier liefern lassen

Stuart stellt Ihnen seine unabhängigen Kuriere zur Verfügung, ohne Umweg über eine Bestellplattform: Der Kunde bestellt in Ihrer App, unter Ihrem Namen, und Stuart stellt nur den Fahrer. Sie zahlen jede Fahrt zum Stuart-Tarif, ohne Provision auf Ihren Umsatz.

In XPRIO heißt das Kurier auf Abruf. Sie verbinden ihn einmal für Ihr Unternehmen und entscheiden dann für jeden Betrieb einzeln, ob er alle Bestellungen liefert oder nur Ihre eigenen Fahrer ergänzt.

Was Sie vorher wissen sollten

Das Stuart-Konto gehört Ihnen. Sie erstellen es bei Stuart, und Stuart berechnet Ihnen jede Fahrt. XPRIO verdient daran nichts.
Der Kunde zahlt Ihre Liefergebühr, also die Ihres Betriebs, zusammen mit der Bestellung. Die Kosten der Stuart-Fahrt werden separat berechnet, je nach Entfernung, Paketgröße und Uhrzeit. Ist Ihre Gebühr niedriger als der Fahrpreis, tragen Sie die Differenz; ist sie höher, gehört der Überschuss Ihnen. Nach der Verbindung zeigt XPRIO Ihnen den Bruttopreis einer typischen Fahrt.
Online-Zahlung ist Pflicht. Ein Kurier auf Abruf kassiert nichts. Die Modi mit Kurier auf Abruf sind erst verfügbar, wenn die Online-Kartenzahlung (Stripe) in Ihrer App eingerichtet ist. Zahlungsmethoden einrichten
Abgedeckte Länder: Frankreich, Vereinigtes Königreich und Polen, jeweils in den großen Städten, in denen Stuart tätig ist (129 Städte im Jahr 2025). XPRIO bietet Stuart nur für Betriebe in diesen Ländern an und prüft jede Adresse im Warenkorb.
Bei Stuart muss eine Bankkarte hinterlegt sein, bevor die erste Fahrt möglich ist, auch im Testkonto. Ohne Karte lehnt Stuart die Erstellung der Lieferung ab.
Kein Übergabecode bei Stuart: Als Liefernachweis dient die Bestätigung des Stuart-Kuriers (Unterschrift oder Foto).
Eine Stornierung kann kostenpflichtig sein, sobald ein Kurier zugewiesen ist. XPRIO weist Sie vor der Bestätigung darauf hin.

Schritt 1: Ihre Stuart-Konten eröffnen

Stuart bietet zwei Dashboards mit jeweils eigener Registrierung:

Testkonto auf dashboard.sandbox.stuart.com: simulierte Fahrten, nichts wird berechnet, sofort verfügbar. Hier führen Sie Ihre Tests durch.
Echtes Konto auf dashboard.stuart.com: Beantragen Sie die Eröffnung auf stuart.com (Schaltfläche Kunde werden oder ähnlich). Stuart ruft Sie zurück, um Ihre Tätigkeit zu prüfen, und schaltet dann den Zugang frei.

Nach der Anmeldung gehen Sie in beiden Fällen so vor:

Klicken Sie oben rechts auf Ihren Avatar und dann auf Mein Konto.
Klicken Sie im linken Menü auf Abrechnung und hinterlegen Sie eine Bankkarte. Im Testkonto genügt jede Testkarte (außer American Express), zum Beispiel 4242 4242 4242 4242 mit einem zukünftigen Ablaufdatum und einem dreistelligen Code. Im echten Konto hinterlegen Sie je nach Vertrag Ihre echte Karte oder Ihre Rechnungsdaten.

Schritt 2: Ihre Schlüssel abrufen

Klicken Sie unter Mein Konto im linken Menü auf API.
Zeigt die Seite Keine API-Zugangsdaten, klicken Sie auf Jetzt generieren.
Der Bereich API-Zugangsdaten zeigt drei Zeilen, jeweils mit Kopiersymbol:
- Client-ID: eine lange Zeichenfolge (die „Client ID“).
- Geheimer API-Schlüssel: eine weitere lange Zeichenfolge (das „Client secret“). Geben Sie ihn an niemanden weiter.
- Stuart-Konto-ID: eine sechsstellige Zahl. Diese brauchen Sie in XPRIO nicht.

Die Werte sind auf dem Bildschirm abgeschnitten: Nutzen Sie immer das Kopiersymbol und markieren Sie sie nie mit der Maus. Testkonto und echtes Konto haben jeweils eigene Schlüssel.

Schritt 3: Stuart mit XPRIO verbinden

Öffnen Sie in XPRIO im linken Menü App-Konfiguration und dann Kuriere auf Abruf.
Klicken Sie auf der Karte Stuart auf Verbinden.
Wählen Sie unter Umgebung Test für die Schlüssel des Testkontos oder Produktion für die des echten Kontos.
Fügen Sie die Client-ID in Client ID und den geheimen API-Schlüssel in Client secret ein. Das Augensymbol blendet das Secret zur Kontrolle ein.
Lassen Sie Authentifizierungsschlüssel der Webhooks vorerst leer (Schritt 4).
Klicken Sie auf Speichern und testen. XPRIO verbindet sich mit Stuart, prüft, ob die Adresse Ihres Betriebs im Liefergebiet liegt, und fordert ein Probeangebot an. Wechselt die Karte auf Verbunden (Test) oder Verbunden (Produktion), ist alles in Ordnung. Andernfalls gibt eine rote Meldung die Antwort von Stuart wieder: meist unvollständige Schlüssel oder ein Betrieb außerhalb der Stuart-Zonen.

Nach der Verbindung zeigt die Karte „Typische Fahrt ab Ihrem Betrieb (etwa 1,5 km)“ mit dem echten Bruttopreis von Stuart.

Schritt 4: Echtzeit-Benachrichtigungen aktivieren (empfohlen)

Ohne diesen Schritt fragt XPRIO den Status jeder Fahrt alle 20 Sekunden ab, und das funktioniert. Mit diesem Schritt informiert Stuart XPRIO sofort bei jeder Änderung (Kurier zugewiesen, Position, Bestellung abgeholt, geliefert).

Öffnen Sie in XPRIO das Fenster Stuart erneut (Bearbeiten auf der Karte). Kopieren Sie die Beim Anbieter zu hinterlegende Benachrichtigungs-URL.
Denken Sie sich im selben Fenster einen langen Schlüssel aus (z. B. 20 Zeichen ohne Leerzeichen), fügen Sie ihn in Authentifizierungsschlüssel der Webhooks ein und klicken Sie auf Speichern und testen.
Öffnen Sie im Stuart-Dashboard Mein Konto, API: Unter den Zugangsdaten zeigt der Bereich Webhooks den Hinweis Keine Webhooks. Klicken Sie auf + Neuen Endpunkt hinzufügen.
Fügen Sie die URL in Webhook-URL ein. Geben Sie unter Authentifizierungs-Header genau Authentication-Key ein (ohne diesen Namen sendet Stuart den Schlüssel nicht, und XPRIO lehnt die Ereignisse ab). Fügen Sie unter Authentifizierungsschlüssel denselben Schlüssel wie in XPRIO ein. Aktivieren Sie alle V2-Ereignisse (job, delivery, driver). Speichern Sie.

Die Karte Stuart in XPRIO zeigt ab der ersten Fahrt „Echtzeit-Benachrichtigungen aktiv“.

Schritt 5: Den Modus je Betrieb wählen

Öffnen Sie in XPRIO im Menü Betriebe den gewünschten Betrieb (Bearbeiten) und dann den Tab Lieferung und Dienstleistungen.
Prüfen Sie, ob der Service Lieferung aktiviert ist.
Wählen Sie im Abschnitt Wer liefert Ihre Bestellungen:
- Meine Fahrer: Nichts ändert sich.
- Meine Fahrer + Kurier auf Abruf als Ergänzung: Ihre Fahrer haben Vorrang; bei jeder online bezahlten Lieferbestellung erscheint die Schaltfläche Kurier anfordern, solange kein Fahrer zugewiesen ist. Optional: Automatisch einen Kurier anfordern, wenn kein Fahrer die Bestellung übernimmt, mit einer Frist von 5 bis 30 Minuten nach „fertig“.
- Nur Kurier auf Abruf: Jede Lieferbestellung geht automatisch an den Stuart-Kurier, zu dem von Ihnen gewählten Zeitpunkt (Wann der Kurier angefordert wird). Der Kunde sieht nur die Online-Zahlung.
Sind die Partnerkarten mit „Online-Zahlung erforderlich“ ausgegraut, aktivieren Sie zuerst Stripe unter App-Konfiguration, Zahlungsmethoden.
Wählen Sie Stuart unter Anbieter.
Wählen Sie im Modus „Nur Kurier auf Abruf“ die dem Kunden berechnete Gebühr: Meine festen Gebühren oder Der Kurierpreis (+ Marge). Im Modus Ergänzung zahlt der Kunde immer Ihre festen Gebühren.
Fügen Sie bei Bedarf einen Abholhinweis für den Kurier hinzu und entscheiden Sie, ob das Trinkgeld des Kunden an den Kurier weitergegeben wird. Speichern Sie.

Im Live und auf Kundenseite

Bei der Bestellung zeigt der Block Kurier auf Abruf ab der Zuweisung den Stuart-Kurier, seine Telefonnummer, seinen aktuellen Status (Kurier unterwegs, Kurier im Geschäft, Abgeholt, Beim Kunden, Geliefert) und die voraussichtliche Ankunftszeit. Vor der Anforderung zeigt das Bestätigungsfenster die Kosten der Fahrt (brutto).

Die Bestellung wechselt auf In Lieferung, sobald der Kurier sie abholt, und bei der Übergabe auf Geliefert, ohne Ihr Zutun. Solange der Kurier die Bestellung nicht abgeholt hat, können Sie ihn stornieren. Storniert Stuart oder kommt die Bestellung zurück, erhalten Sie eine Benachrichtigung, einen Ton und eine Meldung im Live und können einen neuen Kurier anfordern oder einen Ihrer Fahrer zuweisen.

In Ihrer App sieht der Kunde eine Kontaktkarte Kurier auf Abruf mit dem Vornamen des Kuriers, einer Anruf-Schaltfläche, einem Tracking-Link und der Live-Position auf der Karte. Bei einem Betrieb im Modus „Nur Kurier auf Abruf“ zeigt der Warenkorb nur die Kartenzahlung.

Häufige Fragen

Kann ich ohne echte Fahrt testen? Ja, mit dem Testkonto in der Umgebung Test. Im Test-Dashboard können Sie über den Tab Idealszenario eine simulierte Fahrt Schritt für Schritt durchspielen und das Ergebnis im Live verfolgen.

Stuart lehnt die Fahrt mit einem Zahlungsfehler ab? In der Abrechnung dieses Kontos ist keine Karte hinterlegt, oder sie ist abgelaufen. Fügen Sie eine Karte hinzu und versuchen Sie es erneut.