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.
Digitale Übergabeprotokolle: API-Anbindung an Kurier-Buchungen
Erfahren Sie, wie Sie digitale Übergabeprotokolle mittels API mit Kurier-Buchungen bei x25pronto verknüpfen. Technische Anforderungen, Datenfelder und Beispiel-Workflows inklusive.
Kurzantwort
Sie verknüpfen Übergabeprotokolle automatisch, indem Ihre Anwendung via REST-API Buchungs-IDs erhält und nach Abschluss eines Transports ein PDF oder JSON-Protokoll an x25pronto übermittelt. Benötigt werden Authentifizierung (API-Key), Buchungsreferenzen, Prüfsummen und Metadaten wie Absender/Empfänger. Im Text finden Sie Feldmapping, Beispiel-Requests und typische Fehlerbehandlung.
Warum digitale Übergabeprotokolle an Kurier-Buchungen koppeln?
Digitale Übergabeprotokolle sparen Zeit und reduzieren Fehler. Für Schweizer Unternehmen in Handel, Technik oder Gesundheits-IT bedeutet die automatische Verknüpfung: schnelle Nachverfolgbarkeit, elektronische Archivierung und klarere Audit-Trails. x25pronto-Buchungs-IDs dienen als Primärschlüssel zwischen Buchung und Protokoll.
Technische Voraussetzungen
Sie benötigen einen API-Key von x25pronto, HTTPS-fähige Server und ein System zur Erzeugung von Übergabeprotokollen als PDF oder strukturiertes JSON. Die API verlangt TLS 1.2+, Content-Type Header und eindeutige Buchungsreferenzen (z. B. booking_id). Optional: Webhooks für Push-Benachrichtigungen, wenn die Buchung abgeschlossen ist.
Feldmapping: Pflicht- und optionale Felder
Pflichtfelder: booking_id, timestamp, signer_name, signer_role, signature_type (e.g. manual, e-sign), document_checksum (SHA256). Optionale Felder: pickup_address, delivery_address, package_count, comment, gps_coordinates. Für PDF-Uploads senden Sie metadata als JSON und die Datei als multipart/form-data; für strukturierte Protokolle senden Sie JSON mit einem attachments-Array.
Beispiel-API-Workflow (Push-Modell)
1) Ihre App erhält oder erzeugt das Übergabeprotokoll nach Abschluss der Lieferung. 2) POST /v1/bookings/{booking_id}/handover mit Authorization: Bearer {API_KEY}. 3) Body (multipart): metadata JSON + file (handover.pdf) oder Body (application/json): {booking_id, timestamp, signer_name, document_hash, items: [...]}. 4) x25pronto antwortet mit 200 und einer handover_id. 5) Optional: Webhook-Benachrichtigung an Ihre URL bei Bestätigung.
Beispiel-Request (JSON)
POST /v1/bookings/12345/handover Headers: Authorization, Content-Type: application/json Body: {"booking_id":"12345","timestamp":"2026-09-07T10:15:00+02:00","signer_name":"Marcel Müller","signature_type":"manual","document_checksum":"e3b0c...","items":[{"id":"1","description":"Musterpaket","count":1}]} Antwort: {"status":"accepted","handover_id":"h-67890"}.
Fehlerbehandlung und Best Practices
Validieren Sie Checksums vor dem Upload. Prüfen Sie HTTP-Codes: 400 für fehlende Felder, 401 für Authentifizierung, 409 wenn ein Protokoll bereits existiert. Verwenden Sie idempotente Requests: senden Sie eine handover_id oder document_checksum, um Duplikate zu vermeiden. Loggen Sie Request/Response-Paare lokal für Audits. Testen Sie im Sandbox-Modus vor Produktivbetrieb.
Häufige Fragen
Welche Dateiformate sind erlaubt?
PDF ist empfohlen. Alternativ akzeptieren viele Systeme JSON für strukturierte Protokolle. Wenn Sie Anhänge senden, nutzen Sie multipart/form-data.
Wie verifiziere ich, dass ein Protokoll zur richtigen Buchung gehört?
Senden Sie die booking_id im Body und eine dokumentenprüfsumme (SHA256). x25pronto verknüpft beides und gibt eine handover_id zurück. Prüfen Sie zudem Adresse oder Paketanzahl im Metadaten-Feld.
Kann ich Webhooks für Rückmeldungen nutzen?
Ja. Registrieren Sie eine sichere HTTPS-URL im Partner-Portal. Webhooks informieren Sie, wenn ein Protokoll akzeptiert oder abgelehnt wurde.
Gibt es Limits für Dateigrösse oder Anzahl Uploads?
Begrenzungen gibt es üblicherweise. Testen Sie im Sandbox. Wenn Sie grosse Mengen oder grosse Dateien haben, sprechen Sie mit dem x25pronto-Integrations-Team für passende Lösungen.