Express Kurier. Direkt.
Auch Overnight.
x25pronto Schweiz bringt Ware direkt ans Ziel. Für kleine Ware fährt ein Auto. Für mehr Platz gibt es Transporter oder XL. Direkt, Express und Overnight fahren von Montag bis Sonntag. Freie Zeiten stehen im Kalender.
API-Integration für automatische Kurierbuchungen: Setup und Vorteile
Erklärt, wie die x25pronto API funktioniert, welche Endpunkte für Buchung und Reports nötig sind, welche Authentifizierung verwendet wird und wie lange Integration in der Praxis dauert.
Kurzantwort
Die x25pronto API ermöglicht automatisierte Kurierbuchungen direkt aus Ihrem IT-System. Sie authentifizieren via API-Key/Token, senden Buchungsdaten an einen Booking-Endpunkt und holen Status oder Reports über Reporting-Endpunkte. Eine erste Integration dauert je nach IT-Umfang meist 1–4 Wochen und reduziert manuelle Arbeit bei Sendungen in der ganzen Schweiz.
Was macht die x25pronto API?
Die API verbindet Ihr ERP, WMS oder Bestellsystem direkt mit dem x25pronto-Buchungssystem. Sie überträgt Abhol- und Lieferdaten, Paketmasse, Zeitfenster und Empfängerinformationen. Damit lösen Sie einzelne Kurieraufträge automatisch aus, ohne manuelle Eingaben in ein Webportal.
Authentifizierung und Sicherheit
Zugriff erfolgt über einen API-Key und ein OAuth-ähnliches Token-System. Jede Anfrage nutzt HTTPS mit TLS. Rollenbasierter Zugriff begrenzt, welche Endpunkte Ihr System ansteuern darf. Wir empfehlen zusätzlich IP-Whitelist und regelmässigen Key-Rotation-Zyklus für erhöhte Sicherheit.
Wichtige Endpunkte: Buchung, Status, Reports
Booking-Endpunkt: POST /api/v1/bookings — sendet Abholadresse, Ziel, Abholfenster, Paketdetails und Referenzen. Response enthält booking_id und initialen Status. Status-Endpunkt: GET /api/v1/bookings/{booking_id} — liefert aktuellen Status, Fahrerinfo und ETA. Reporting-Endpunkt: GET /api/v1/reports?from=...&to=... — erzeugt Tages- oder Monatsreports mit Sammeldaten, Auslieferungszeiten und Zustellnachweisen (POD) als PDF/JSON.
Datenformat und Validierung
Die API verwendet JSON für Anfragen und Antworten. Pflichtfelder sind Abholadresse, Empfängeradresse, Paketgewicht, Abmessungen und Referenznummer. Die API antwortet mit klaren Fehler-Codes (z. B. 400 für Validierung, 401 für Authentifizierung). Validierungsregeln verhindern Buchungen mit unvollständigen oder unsicheren Sendungsdaten.
Typische Integrationsdauer und Projektphasen
Kleine Integrationen (z. B. Webshop oder CRM): 1–2 Wochen. Mittlere Integrationen (ERP- oder WMS-Anbindung): 2–4 Wochen. Grössere Projekte mit Workflow-Anpassungen oder mehreren Systemen: 4–8 Wochen. Phasen: Analyse der Felder, Sandbox-Zugang, Implementierung der Endpunkte, Testläufe, UAT und Live-Schaltung.
Fehlerbehandlung und Monitoring
Nutzen Sie Retry-Logik für zeitweilige Fehler (5xx). Für dauerhafte Fehler loggen und alarmieren Sie Ihr Team. Die API liefert Webhooks für Status-Updates, damit Ihr System sofort reagiert. Zusätzlich sollten Sie ein Dashboard für erfolgreiche und fehlgeschlagene Buchungen einrichten.
Häufige Fragen
Welche Authentifizierung brauche ich für die API?
Sie erhalten einen API-Key und ein Token-basiertes Verfahren. Alle Anfragen laufen über HTTPS. Eine IP-Whitelist ist optional, aber empfohlen.
Kann ich Testbuchungen vor Live-Betrieb machen?
Ja. Es gibt eine Sandbox-Umgebung für Testbuchungen, Status-Simulationen und Validierung ohne reale Abholungen.
Welche Informationen muss mein System liefern?
Mindestens Abhol- und Lieferadresse, Paketgewicht, Abmessungen und eine Referenznummer. Optional: Empfänger-Telefon, Service-Level (Sameday/Overnight) und spezielle Hinweise.
Wie erhalte ich Zustellnachweise?
Zustellnachweise (POD) werden per Reporting-Endpunkt als PDF oder als strukturierte JSON-Attachment bereitgestellt. Sie können auch per Webhook benachrichtigt werden.