Zum Hauptinhalt springen

Mit einem Stuart-Kurier liefern lassen

Verbinden Sie Ihr Stuart-Konto mit XPRIO und lassen Sie Ihre Bestellungen von einem Kurier liefern, wenn Sie keinen Fahrer haben oder Spitzen abfangen möchten. Verfügbar in Frankreich, im Vereinigten Königreich und in Polen, in den großen Städten.

Verfasst von XPRIO

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 Ihre Verkäufe.

In XPRIO heißt das Partnerkurier. Sie verbinden ihn einmal für Ihr Unternehmen und entscheiden dann Betrieb für Betrieb, 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 nimmt nichts.

  • Der Kunde zahlt Ihre Liefergebühr, die Ihres Betriebs, die mit der Bestellung eingezogen wird. Die Kosten der Stuart-Fahrt werden separat berechnet, je nach Entfernung, Paketgröße und Uhrzeit. Ist Ihre Gebühr niedriger als die Fahrt, tragen Sie die Differenz; ist sie höher, behalten Sie sie. Nach der Verbindung zeigt XPRIO Ihnen den Bruttopreis einer typischen Fahrt.

  • Online-Zahlung ist Pflicht. Ein Partnerkurier kassiert nichts. Die Partnerkurier-Modi 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, 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: Der Liefernachweis ist der des Stuart-Kuriers (Unterschrift oder Foto).

  • Eine Stornierung kann berechnet werden, sobald ein Kurier zugewiesen ist. XPRIO warnt Sie vor der Bestätigung.

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 machen Sie Ihre Versuche.

  • Echtes Konto auf dashboard.stuart.com: Beantragen Sie die Eröffnung auf stuart.com (Button Kunde werden oder ähnlich). Stuart ruft Sie zurück, um Ihre Tätigkeit zu prüfen, und schaltet dann den Zugang frei.

In beiden Fällen nach der Anmeldung:

  1. Klicken Sie oben rechts auf Ihren Avatar und dann auf Mein Konto.

  2. 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 Ihre echte Karte oder Ihre Rechnungsdaten je nach Vertrag.

Schritt 2: Ihre Schlüssel abrufen

  1. Klicken Sie unter Mein Konto im linken Menü auf API.

  2. Zeigt die Seite Keine API-Zugangsdaten, klicken Sie auf Jetzt generieren.

  3. 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, nie die Auswahl mit der Maus. Testkonto und echtes Konto haben jeweils eigene Schlüssel.

Schritt 3: Stuart mit XPRIO verbinden

  1. In XPRIO öffnen Sie im linken Menü App-Konfiguration und dann Partnerkuriere.

  2. Klicken Sie auf der Karte Stuart auf Verbinden.

  3. Wählen Sie unter Umgebung Test für die Schlüssel des Testkontos, Produktion für die des echten Kontos.

  4. 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.

  5. Lassen Sie Authentifizierungsschlüssel der Webhooks vorerst leer (Schritt 4).

  6. Klicken Sie auf Speichern und testen. XPRIO verbindet sich mit Stuart, prüft, dass die Adresse Ihres Betriebs bedient wird, 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: unvollständige Schlüssel oder 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: Das funktioniert. Mit ihm informiert Stuart XPRIO sofort bei jeder Änderung (Kurier zugewiesen, Position, Bestellung abgeholt, geliefert).

  1. Öffnen Sie in XPRIO das Fenster Stuart erneut (Bearbeiten auf der Karte). Kopieren Sie die Beim Anbieter zu hinterlegende Benachrichtigungs-URL.

  2. 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.

  3. Im Stuart-Dashboard unter Mein Konto, API: Unter den Zugangsdaten zeigt der Bereich Webhooks Keine Webhooks. Klicken Sie auf + Neuen Endpunkt hinzufügen.

  4. 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.

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

Schritt 5: Den Modus je Betrieb wählen

  1. In XPRIO, Menü Betriebe, öffnen Sie den Betrieb (Bearbeiten) und dann den Tab Lieferung und Dienstleistungen.

  2. Prüfen Sie, dass der Service Lieferung aktiviert ist.

  3. Im Abschnitt Wer liefert Ihre Bestellungen wählen Sie:

    • Meine Fahrer: Nichts ändert sich.

    • Meine Fahrer + Partnerkurier als Ergänzung: Ihre Fahrer haben Vorrang; auf jeder online bezahlten Lieferbestellung erscheint der Button Partnerkurier rufen, solange kein Fahrer zugewiesen ist. Option Automatisch einen Partnerkurier rufen, wenn kein Fahrer die Bestellung übernimmt, mit einer Frist von 5 bis 30 Minuten nach „fertig“.

    • Nur Partnerkurier: 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.

  4. Wählen Sie Stuart unter Anbieter.

  5. Im Modus „Nur Partnerkurier“ wählen Sie 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.

  6. 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.

Im Live und auf Kundenseite

Auf der Bestellung zeigt der Block Partnerkurier den Stuart-Kurier ab der Zuweisung, seine Telefonnummer, seine Etappe (Kurier unterwegs, Kurier im Geschäft, Abgeholt, Beim Kunden, Geliefert) und die voraussichtliche Ankunftszeit. Vor der Bestellung zeigt das Bestätigungsfenster die Kosten der Fahrt brutto.

Die Bestellung wechselt auf In Lieferung, wenn der Kurier sie abholt, und auf Geliefert bei Übergabe, ohne Ihr Zutun. Sie können den Kurier stornieren, solange er die Bestellung nicht abgeholt hat. 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 Partnerkurier mit dem Vornamen des Kuriers, einem Anrufbutton, einem Tracking-Link und der Live-Position auf der Karte. Bei einem Betrieb im Modus „Nur Partnerkurier“ 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 voranbringen und das Ergebnis im Live sehen.

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 hinzu und versuchen Sie es erneut.

Verwandte Artikel

Hat dies deine Frage beantwortet?