Zweck: In diesem Artikel erklären wir, wie du mehrere Verträge mit demselben Versanddienstleister zu deinem Sendcloud-Konto hinzufügen und verbinden kannst, damit du mit deinen eigenen Tarifen versenden kannst.
Deine Verträge hinzufügen
Um mehrere Versandverträge in einem Sendcloud-Konto hinzuzufügen, ist es notwendig, diese Schritte so oft zu wiederholen, wie die gewünschte Anzahl der Verträge erreicht wurde:
- Gehe in deinem Sendcloud-Panel auf Versand > Versanddienstleister > Meine Verträge
- Klicke auf ''Eigenen Vertrag hinzufügen''
- Suche den gewünschten Versanddienstleister und füge die erforderlichen Informationen für die Hinterlegung hinzu
- Klicke auf speichern, um den Vertrag hinzuzufügen
Du kannst eine unbegrenzte Anzahl von Verträgen hinzufügen.
Für weitere Informationen findest du hier einen ausführlichen Artikel: Eigenen Versandvertrag hinzufügen
Du kannst Labels über die API oder direkt in deinem Sendcloud-Panel erstellen (manuell oder mit Versandregeln). Lese dazu den entsprechenden Abschnitt:
Erstelle Labels über die API
- Suche zunächst die contract id des Vertrags, den du verwenden möchtest. Dies kann auf zwei Arten erfolgen:
-
- Gehe in deinem Sendcloud-Panel zu den Versand > Versanddienstleister > Meine Verträge > wähle den gewünschten Vertrag aus und klicke auf das Stiftsymbol, um die Bearbeitungsansicht zu öffnen > Kopiere den letzten Teil der URL nach dem letzten Schrägstrich. Dabei handelt es sich um die contract id.
- Über den "Retrieve a list of contracts" API Endpunkt. Dieser Endpunkt ruft Informationen über alle verfügbaren Verträge ab, die in Deinem Sendcloud-Konto hinterlegt wurden. Diese gibt auch die contract_id Deiner Verträge zurück, die du verwenden kannst, um weitere Details über einen bestimmten Vertrag zu erhalten. Ausführlichere Informationen findest du in unserer API Dokumentation.
- Gehe in deinem Sendcloud-Panel zu den Versand > Versanddienstleister > Meine Verträge > wähle den gewünschten Vertrag aus und klicke auf das Stiftsymbol, um die Bearbeitungsansicht zu öffnen > Kopiere den letzten Teil der URL nach dem letzten Schrägstrich. Dabei handelt es sich um die contract id.
-
- Das Paket ankündigen und das Versandlabel erstellen
-
- Suche nach deiner aktuellen API request (siehe Beispielanfrage unten)
- Füge die Vertragsnummer ein, die du im vorherigen Schritt mit dem Parameter "contract" erhalten hast. Ersetze im folgenden Beispiel die Werte xxxx durch die Vertragskennung, um ein Paket anzukündigen.
Hinweis: Mit dem Parameter
request_label: "true"
kannst du das Paket ankündigen und gleichzeitig das Versandlabel erstellen. Weitere Informationen findest du in unserer API Dokumentation.
Beispielanfrage
{
"parcel": {
"order_number": "83773",
"external_reference": "83773",
"name": "John Doe",
"company_name": "FlowerShop",
"email": "john@doe.com",
"telephone": "+31611223344",
"address": "Fürstenrieder Str.",
"house_number": "70",
"address_2": "",
"city": "Munich",
"country": "DE",
"postal_code": "80686",
"country_state": null,
"to_service_point": 10168633,
"to_post_number": 262373726,
"customs_invoice_nr": "",
"customs_shipment_type": null,
"parcel_items": [
{
"description": "T-Shirt",
"hs_code": "6109",
"origin_country": "SE",
"product_id": "898678671",
"properties": {
"color": "Blue",
"size": "Medium"
},
"quantity": 2,
"sku": "TST-OD2019-B620",
"value": "19.95",
"weight": "0.9"
},
{
"description": "Laptop",
"hs_code": "84713010",
"origin_country": "DE",
"product_id": "5756464758",
"properties": {
"color": "Black",
"internal_storage": "2TB"
},
"quantity": 1,
"sku": "LT-PN2020-B23",
"value": "876.97",
"weight": "1.69"
}
],
"weight": "3.49",
"length": "31.5",
"width": "27.2",
"height": "12.7",
"total_order_value": "896.92",
"total_order_value_currency": "EUR",
"shipment": {
"id": xxxx,
"name": "DHL Parcel Connect 2-5kg to ParcelShop"
},
"shipping_method_checkout_name": "Battery WarehouseX DHL",
"sender_address": xxxxxx,
"quantity": 1,
"total_insured_value": 0,
"shipment_uuid": "4a84d84f-aa76-44b7-985d-3ef9e04dad38",
"is_return": false,
"request_label": true,
"apply_shipping_rules": false,
"request_label_async": false,
"contract": xxxx
}
}
FAQ
Was passiert, wenn ich mehr als einen aktiven Vertrag habe und die contract id nicht angebe?
- In diesem Fall wird die Antwort eine Fehlermeldung zurückgeben.
Was passiert, wenn ich nur einen aktiven Vertrag habe und die contract id nicht angebe?
- Nichts, wir werden immer den aktiven, direkten Vertrag verwenden.
Kann ich auch mit Sendcloud-Tarifen versenden?
- Ja, aber du kannst die contract id nur über den contracts endpoint erfahren und nicht über das Sendcloud Panel.
Ist die contract id eines Vertrages ausschließlich für ein Benutzerkonto oder für Sendcloud als Ganzes?
- Dies ist ausschließlich für Sendcloud als Ganzes.
Erstelle deine Labels im Sendcloud Panel
Manuell
- Erstelle deine Sendung manuell, indem du auf Versand > + Neue Sendung klickst.
- Hinterlege die erforderlichen Informationen, einschließlich der Versandmethode
- Am Ende der Seite befindet sich ein Abschnitt mit der Überschrift Versandvertrag. Klicke auf den Pfeil, um das Dropdown-Menü anzuzeigen, und wähle hier den gewünschten Vertrag aus. Es werden hier alle deine aktiven Verträge angezeigt.
- Wähle den relevanten Vertrag.
- Klicke auf Label erstellen, sobald du fertig bist.
Mit Versandregeln
Um die Auswahl des richtigen Versandvertrags für jeden Fall zu automatisieren, kannst du Versandregeln verwenden. Um eine neue Versandregel zu erstellen, gehe zu Versand > Versandregeln > Erstelle eine neue Regel. Hinterlege die Bedingung/en und die Aktion/en > klicke auf Versandregel speichern. Um einen Versandvertrag auszuwählen, wähle die Aktion"Use shipping contract" und klicke auf den Pfeil, um alle deine verfügbaren Verträge und die Sendcloud-Tarife anzuzeigen.
Hier findest du einige Vorschläge:
-
Wenn “Absenderadresse” “ist/ ist nicht” “xxxx” UND “Paketdienstleister” “ist/ist nicht” “xxxx” DANN “Use shipping contract” “xxxx”
-
Wenn “Absenderadresse” “ist/ ist nicht” “xxxx” UND “Checkout Versandmethode” “ist/ist nicht/…” “xxxx” DANN “Use shipping contract” “xxxx”
-
Wenn “Paketdienstleister” “ist/ist nicht” “xxxx” DANN “Use shipping contract” “xxxx”
-
Wenn “Checkout Versandmethode” “is/is not/…” “xxxx” DANN “Use shipping contract” “xxxx” UND "Versenden mit" "xxxx"
Hier erfährst du mehr über die Versandregeln: Versandregeln: Übersicht und Anwendung.
Retourenlabels
Derzeit unterstützen wir keine vertragsbezogenen Versandregeln. Wir bieten nur die Aktion "Use shipping contract" für Versandregeln an.
Wichtiger Hinweis zu Rücksendungen mit DHL Deutschland
Wenn ein Vertrag mit DHL Deutschland zu Sendcloud hinzugefügt wird, muss festgelegt werden, aus welchen Ländern dein Vertrag die Retouren zulässt.
Da wir keine vertragsbezogene Retourenregeln unterstützen, stelle sicher, dass du manuell den richtigen Vertrag vorab auswählst, bevor das Label erstellt wird, insbesondere wenn du mehrere DHL Deutschland Verträge hast, die Retouren aus verschiedenen Ländern unterstützt.
Du kannst dies tun, indem du eine neue Retoure erstellst oder eine eingehende Retoure bearbeitest.