Erste Schritte als Fulfillment-Unternehmen (API)
Dieser Leitfaden richtet sich an Fulfillment-Unternehmen (3PLs), die für mehrere Webshops verpacken und versenden und diesen Webshops digitales Payment on Delivery anbieten möchten, während sie ihr eigenes Lagerverwaltungssystem (WMS) behalten. Ihr WMS empfängt Bestellungen weiterhin wie bisher. Für Payment on Delivery Bestellungen fordert es über die QrX Public API das Etikett des Versanddienstleisters und das QrX Zahlungsetikett bei QrX an. An der Tür scannt der Käufer den QrX QR-Code und bezahlt über den eigenen Zahlungsanbieter des Webshops. QrX verwahrt das Geld niemals, und es fließt auch nie über Ihr Unternehmen.
In PortalX ist das der Einrichtungsweg Ich bin ein Fulfillment-Unternehmen und verbinde mein eigenes WMS über die API im Leitfaden Erste Schritte (Einstellungen > Geschäft > Erste Schritte).
Ihr Kontomodell wählen
QrX arbeitet mit Vertriebskanälen (Händlerkanälen). Jeder Kanal hat seinen eigenen Zahlungsanbieter, API-Schlüssel, sein eigenes Branding und seinen Standard-Versanddienstleister. Es gibt zwei Möglichkeiten, Ihre Mandanten einzurichten:
Sie verwalten die Mandanten (am häufigsten): Ihr Unternehmen hat ein QrX Konto mit einem Händlerkanal pro Mandanten-Webshop. Sie verbinden den eigenen Zahlungsanbieter jedes Mandanten mit dessen Kanal, sodass Zahlungen an der Tür direkt an den Mandanten ausgezahlt werden. Sie erhalten eine QrX Rechnung für alle Mandanten.
Die Mandanten haben ein eigenes QrX Konto: Jeder Webshop registriert sich selbst, verbindet seinen Zahlungsanbieter und gewährt Ihrem Unternehmen Zugriff mit Partnerzugriff (Einstellungen > Geschäft > Partnerzugriff, Umfang Reseller operations oder Carrier operations). Ihr WMS verwendet dann den API-Schlüssel des Kanals des Mandanten, oder Sie verbinden sich über QrX Connect (siehe "QrX Connect: Ihre Plattform per OAuth verbinden").
Vereinbaren Sie mit QrX, welches Modell Sie nutzen, bevor Ihr erster Mandant live geht. Partnergebühren für Fulfillment-Unternehmen werden pro Partnerschaft vereinbart; siehe "Partner und wie Sie Partner von QrX werden".
1. Richten Sie Ihr Unternehmen ein
Unternehmensdaten. QrX übernimmt Firmenname, Adresse und USt-IdNr. oder Handelsregisternummer aus Ihrer Registrierung. Wenn etwas fehlt oder sich geändert hat, klicken Sie im Schritt auf QrX fragen, und QrX vervollständigt die Angaben für Sie. Der Schritt wird abgehakt, sobald alle Angaben bekannt sind.
Absenderadresse des Lagers mit einem kurzen Code für API-Aufrufe: Einstellungen > Betrieb > Adressen.
Team: Laden Sie Ihre Kollegen aus Lager und IT unter Einstellungen > Team & Zugang > Benutzer ein und weisen Sie ihnen unter Rollen und Berechtigungen Rollen zu.
2. Ihre Mandanten hinzufügen
Ein Kanal pro Mandanten-Webshop: Einstellungen > Geschäft > Händlerkanäle. Verwenden Sie den Shopnamen des Mandanten, damit Käufer ihn auf der Zahlungsseite wiedererkennen.
Verbinden Sie den Zahlungsanbieter jedes Kunden im Tab Zahlungen des Kanals (Stripe, Mollie oder MultiSafePay). Der Mandant schließt das Onboarding beim Anbieter mit seinen eigenen Unternehmensdaten ab.
Branding pro Mandant: Logo und Farben am Kanal, eine Track & Trace Vorlage (Einstellungen > Betrieb > Track & Trace) und Nachrichtenvorlagen, damit Käufer den Webshop sehen und nicht das Lager.
3. Versanddienstleister und Druck verbinden
Versanddienstleister: Einstellungen > Betrieb > Versanddienstleister. Nutzen Sie Ihre eigenen Verträge mit Versanddienstleistern oder das QrX UPS Payment on Delivery Konto. Verknüpfen Sie ein Konto mit allen Kanälen oder mit einem Mandantenkanal.
Etikettenformat: Wählen Sie PDF oder ZPL und, für UPS, Standard (Etikett des Versanddienstleisters plus QrX Zahlungsetikett) oder Extended (ein kombiniertes Etikett). Drucken Sie für jedes Payment on Delivery Paket den vollständigen Satz.
Wenn Ihr WMS selbst druckt, verwendet es die von der API zurückgegebenen Etiketten. Andernfalls verbinden Sie PrintNode unter Einstellungen > Einstellungen > Druck.
4. Ihr WMS verbinden
API-Schlüssel pro Mandantenkanal: Händlerkanäle, Kanal öffnen, Tab Einstellungen, API-Schlüssel neu generieren (Regenerate API Key). Speichern Sie die Schlüssel verschlüsselt auf Ihrem Server, einen pro Mandant.
Token: POST /api/v1/auth/token mit dem Header QrX-MerchantChannel-API-Key.
Codes nachschlagen mit /api/v1/reference/shipping-methods und /api/v1/reference/senders. Codieren Sie niemals IDs eines anderen Mandanten fest ein.
Die Transaktion mit ihrem Etikett erstellen in einem Aufruf: POST /api/v1/transactions mit dem Typ Payment für Payment on Delivery oder No payment für vorausbezahlte Bestellungen, plus einem Paketblock mit CreateCarrierLabel. Speichern Sie die zurückgegebene Transaktions-ID und die Etiketten, bevor Sie das Paket als verpackt melden, damit ein erneuter Versuch nie ein zweites Etikett kauft.
Webhooks: Einstellungen > Erweitert > Webhooks. Abonnieren Sie die Ereignisse Transaktion bezahlt, storniert und Sendung, pro Kanal oder für alle Kanäle. Prüfen Sie den Header X-QrX-Signature.
Testen Sie durchgängig im Testmodus für jeden Mandanten, bevor Sie live gehen: Bestellung eingegangen, Etikett gedruckt, Testzahlung an der Tür, Webhook empfangen.
5. Livegang pro Mandant
Bitten Sie QrX, den Live-Modus zu aktivieren (Mit QrX chatten im Leitfaden).
Stellen Sie jeweils einen Mandanten um und behalten Sie für diesen Mandanten den alten Ablauf bei, bis die ersten Live-Zahlungen an der Tür bestätigt sind.
Gut zu wissen
Eine stornierte Transaktion kann nicht mehr bezahlt, etikettiert oder erfüllt werden. Stornieren Sie in QrX, wenn der Webshop storniert.
HTTP 201 beim Erstellen ist kein Zahlungsnachweis. Warten Sie auf den Webhook für bezahlt.
Ihre Partnergebühr wird in Ihrer Partnervereinbarung festgelegt; es gibt keinen allgemein veröffentlichten Satz.
Bestand und Kommissionierung bleiben auf diesem Weg in Ihrem eigenen WMS. Möchten Sie Ihr Lager stattdessen in QrX führen? Siehe "Erste Schritte als Fulfillment-Unternehmen mit dem QrX WMS".
Wann Sie unser Support-Team kontaktieren sollten
Kontaktieren Sie QrX, um Ihr Kontomodell und Ihre Partnerbedingungen zu vereinbaren, um Ihre Etikettenausgabe und Ihren Drucker zu zertifizieren, wenn das Onboarding eines Mandanten beim Zahlungsanbieter hängt oder wenn Webhooks wiederholt fehlschlagen.