Best Practice - Sendungsnummern per API an Billbee übermitteln
Sendungsdaten können zusammen mit dem Status "Versendet" von Billbee zum Shop / Marktplatz übertragen werden. Nutzt du für den Versand nicht Billbee, sondern bspw. einen Fulfiller, kann dieser die Sendungsdaten per API an Billbee übermitteln. Anschließend können die Daten dann übertragen werden. Damit das klappt, müssen die Daten korrekt und vollständig zu Billbee übertragen werden. Wie genau das funktioniert, erklären wir dir im Folgenden.
Vorbereitung
Damit Sendungsdaten an den Shop / Marktplatz übermittelt werden können, muss ein korrekter Versanddienstleister übermittelt werden. Falls du keine direkte Anbindung an den Versanddienstleister in deinem Billbeeaccount hast, musst du hierfür unter Einstellungen / Versand & Fulfillment einen Freien Provider anlegen.
Klicke auf den Button "+Neu" und wähle "Freier Provider". Ein "Freier Provider" ist eine Art Dummy-Versandanbindung. Du kannst deinem Freien Provider unter "Produkte" Carrier (Versanddienstleister wie z. B. DHL) zuordnen. Unter 'Anzeigename' vergibst du einen Namen für das Versandprodukt, z. B. DHL Paket.
Es lassen sich mehrere Carrier einem Freien Provider hinterlegen.
Das Hinterlegen von Carriern ist z. B. für manche Marktplätze wie Amazon wichtig, da hier ein Versanddienstleister oder für nicht trackbare Sendungen "Andere" übertragen werden muss.
Datenübertragung
Folgende Daten müssen mit POST an den Endpunkt /api/v1/orders/{id}/shipment
übertragen werden:
{
"ShippingId": "string",
"OrderId": "string",
"Comment": "string",
"ShippingProviderId": 0,
"ShippingProviderProductId": 0,
"CarrierId": 0,
"ShipmentType": 0
}
Dabei sollten folgende Werte hinterlegt sein:
- ShippingId: Sendungsnummer
- OrderId: Auftragsnummer des Versanddienstleisters (bei DHL gleich der Sendungsnummer)
- ShippingProviderId: Kann über GET /api/v1/shipment/shippingproviders abgerufen werden
- ShippingProviderProductId: Ebenfalls über vorherigen Call
- CarrierId: Über GET /api/v1/shipment/shippingcarriers
- ShipmentType: 0=Sendung (Standard, wenn nichts angegeben wird) 1=Retoure
Ist alles korrekt übermittelt, kann es in Billbee beispielhaft so aussehen:
Alle Details zu unserer API findest du in unserer API Dokumentation.