Zum Hauptinhalt gehen
ZurĂĽck an den Anfang

Sendcloud APIs - FAQ

Louise Thomasson
  • Aktualisiert
🤖KI-unterstützte Übersetzung

Thema: In diesem Artikel beantworten wir die am häufigsten gestellten Fragen zu benutzerdefinierten Shop-Integrationen mit den Sendcloud-APIs.

Was sind die Rate Limits?

Anfragen an unsere API sind pro Sendcloud-Konto begrenzt. Wenn du mehrere API-SchlĂĽssel pro Sendcloud-Konto hast, wird das Kontingent zwischen diesen SchlĂĽsseln geteilt.

Rate Limits

Unsere API verfügt über Rate Limits, die die Anzahl der Anfragen begrenzen, die pro Minute gestellt werden können. Bitte beachte, dass es unterschiedliche Rate Limits für versandbezogene Endpunkte gibt.

  • Sichere Anfragen (GET): 1000 Anfragen pro Minute
  • Unsichere Anfragen (POST/PATCH/PUT/DELETE): 100 Anfragen pro Minute.

Maximale Burst-Rate

Endpunkte, die als unsicher gelten, haben eine festgelegte Burst-Rate, also die maximale Anzahl gleichzeitiger Anfragen, die die API verarbeiten kann. Dadurch ist eine vorübergehende Erhöhung der Anfragerate möglich, um kurze Phasen mit hohem Traffic zu bewältigen, ohne die allgemeinen Rate Limits zu überschreiten.

  • Unsichere Anfragen (POST/PATCH/PUT/DELETE): 15 Anfragen pro Sekunde.
Um Unterbrechungen zu vermeiden und eine optimale Nutzung der API sicherzustellen, ist es wichtig, innerhalb der API-Rate-Limits zu bleiben. Wird das Limit überschritten, erhältst du eine HTTP 429 (Too Many Requests) Antwort.

Weitere Informationen zur Ratenbegrenzung findest du in unserer Entwicklerdokumentation.

Dies kann nach Ermessen von Sendcloud geändert werden.

Ich möchte beim Erstellen einer Sendung über die API sofort Labels erstellen. Wie kann ich das tun?

Um Sendungen und Versandlabels in einem einzigen API-Aufruf zu erstellen, verwende den synchronen Endpunkt der Shipments oder der Ship an Order API. Das Label wird automatisch in der Antwort im Feld data.parcels.label_file zurĂĽckgegeben. Dies ist nur fĂĽr Single-Collo-Sendungen verfĂĽgbar (Sendung besteht aus nur einem Paket).

Wie kann ich Idempotenz fĂĽr Bestellungen/Sendungen sicherstellen, die ich in Sendcloud importiere oder erstelle?

Im Kontext von APIs bedeutet Idempotenz, dass mehrere identische Anfragen denselben Effekt haben wie eine einzelne Anfrage. Dies soll Benutzerfehler verhindern und im Fall der Sendcloud-APIs die Duplizierung von Bestellungen in unserem System vermeiden. Es gibt vier Endpunkte, die idempotent arbeiten:

  • Alle POST- Shipments-Endpunkte
    Verwende das Feld external_reference_id, um die Idempotenz sicherzustellen. 

Kann ich Versandregeln verwenden, wenn ich Sendungen ĂĽber die API erstelle?

Versandregeln werden angewendet auf Sendungen, die du über die API erstellst, sofern du Sendungen mit den Endpunkten „Create a shipment with rules and/or defaults“ synchron oder asynchron erstellst. Wir empfehlen, die Versandoption „Unfrankierter Brief“ ("shipping_option_code": "sendcloud:letter") zu verwenden, wenn du möchtest, dass Versandregeln korrekt angewendet werden. Dadurch kannst du das erforderliche ship_with-Objekt umgehen, und alle von dir konfigurierten Regeln, die die Auswahl der Versandoption beeinflussen, werden korrekt auf dein Paket angewendet. 

Kann ich die API testen, ohne für die erstellten Labels belastet zu werden? 

Du kannst die Sendcloud-Versandoption „Unfrankierter Brief“ ("shipping_option_code": "sendcloud:letter") verwenden, um deine Sendungen zu erstellen. So kannst du die API testen, ohne das Risiko einzugehen, für erstellte Labels berechnet zu werden.

Bitte beachte, dass es nicht möglich ist, diese Versandoption zum Testen der Erstellung von Rücksendeetiketten zu verwenden. Um Rücksendeetiketten zu testen, nutze eine Versandoption, die Stornierungsanfragen von Sendcloud unterstützt, und storniere das Label vor 23:59 Uhr am Tag der Erstellung. Weitere Informationen findest du in unserer Dokumentation zu Testlabels. 

Ich erhalte die Fehlermeldung „User is not allowed to announce“. Was läuft schief?

Stelle sicher, dass du alle Schritte der grundlegenden Kontoeinrichtung durchgeführt und eine Lastschrift-Zahlungsmethode aktiviert hast. Siehe: Starte mit Sendcloud. 

Kann ich alle meine Versandoptionen ĂĽber die API sehen, wenn ich einen direkten Carrier-Vertrag verbinde?

Ja – wenn du deinen eigenen Carrier-Vertrag verbunden hast, kannst du deine eigenen Versandoptionen zusammen mit den Sendcloud-Versandoptionen abrufen, indem du eine Anfrage an den Shipping options API-Endpunkt sendest. Beachte, dass deine Vertragspreise nur abgerufen werden, wenn du deine eigenen Carrier-Preise hochgeladen hast. 

Kann ich meine eigenen Preise aus meinen direkten Carrier-Verträgen sehen, wenn ich die API zur Tarifprüfung und zum Methodenvergleich verwende?

Ja, wenn du deine eigenen Preise in deinem Sendcloud-Konto hochgeladen hast, indem du die Schritte in diesem Artikel befolgt hast.  

Ich erhalte die Fehlermeldung „No shipping option could be found for[…]“ wenn ich versuche, eine Sendung über die API zu erstellen. Was läuft schief?

Wahrscheinlich bezieht sich der verwendete shipping_option_code auf eine Versandoption, die den Versand an oder von der angegebenen Adresse nicht unterstĂĽtzt, z. B. wenn du eine nationale Methode fĂĽr eine internationale Sendung verwendest. Es kann auch sein, dass du eine RĂĽcksende-Versandoption fĂĽr eine ausgehende Sendung verwendest oder umgekehrt. Du kannst den Shipping options-Endpunkt verwenden, um eine passende Versandoption fĂĽr deine Sendung basierend auf den in der Anfrage definierten Parametern zu finden.

UnterstĂĽtzt die API den Import von Notizen- oder Bemerkungsfeldern in Bestellungen?

Ja. Dies kann beispielsweise verwendet werden, um Bestellungen Notizen hinzuzufügen, wie z. B. „Bitte diesen Artikel vor dem Versand als Geschenk verpacken“. Diese erscheinen auch auf Packzetteln oder Picklisten, wenn du Pack & Go verwendest. 

Ich habe einen Bericht über die API erstellt, aber meine CSV-Datei ist leer. Was läuft schief?

Bitte achte auf den Filter direction, wenn du die Anfrage an den Reporting-Endpunkt erstellst. Wenn du direction als incoming angibst, werden nur RĂĽcksendungen angezeigt. Wenn keine RĂĽcksendungen eingehen, ist der Bericht leer.

Außerdem musst du die Integrations-ID in deiner Anfrage angeben. Es ist nicht möglich, einen Bericht für alle deine Integrationen zu erstellen. Stelle daher sicher, dass du die richtige ID angibst, um deine ausgehenden oder eingehenden Sendungen pro Integration zu sehen. 

Wie finde ich meine integration_id?

Du findest deine integration_id im Retrieve a list of integrations-Endpunkt, oder in deinem Sendcloud-Panel (Einstellungen > Integrationen > wähle deine Integration in der Liste > Bearbeiten). Die Integrations-ID wird am Ende der URL angezeigt, z. B. „https://app.sendcloud.com/v2/settings/integrations/api/95977“

Wie finde ich meine sender_address_id? 

Über den Retrieve a list of sender addresses-Endpunkt, oder in deinem Sendcloud-Panel (Einstellungen > Adressen > Adresse bearbeiten). Die ID wird am Ende der URL angezeigt, z. B. „https://app.sendcloud.com/v2/settings/addresses/sender/132258'

Wie finde ich meine brand_id?

Über den Retrieve configured brands-Endpunkt, oder in deinem Sendcloud-Panel (Einstellungen > Marken > Marke bearbeiten). Die ID wird am Ende der URL angezeigt, z. B. „https://app.sendcloud.com/v2/settings/brands/86054'

Ich erhalte die Fehlermeldung „Service point delivery is not enabled for this integration.“ Was läuft schief?

Du musst die Zustellung an Service Points im Sendcloud-Panel aktivieren, indem du zu Einstellungen > Integrationen > API > Bearbeiten > Kästchen aktivieren gehst, um die Zustellung an Service Points zu aktivieren. Dies wird hier ausführlicher beschrieben: hier. 

Hausnummern werden auf meinen Versandlabels doppelt angezeigt, wenn ich Pakete über die API erstelle. Was läuft schief?

Das am häufigsten verwendete Adressformat ist wie folgt:

  • address : Stadhuisplein
  • house_number: 10

Eine weitere gängige Methode ist:

  • address: Stadhuisplein 10

Kann ich mehrteilige (Multicollo-)Sendungen ĂĽber die API erstellen?

Ja, das ist möglich – dies wird ausführlicher in unserer Dokumentation beschrieben. 

Kann ich dieselbe Marke mehreren Absenderadressen zuweisen?

Ja, du kannst dieselbe Marke einigen oder allen deiner Absenderadressen zuweisen.

Kann ich mehreren Marken dieselbe Absenderadresse zuweisen?

Pro Absenderadresse kann nur eine Marke zugewiesen werden. Als Workaround kannst du eine doppelte Absenderadresse erstellen und jeder eine andere Marke zuweisen. Nur eine Adresse kann als Standardadresse festgelegt werden. Wir empfehlen daher, der doppelten Adresse einen einprägsamen Namen zu geben, damit du sie im Panel leicht erkennen kannst. 

Kann ich internationale Sendungen ĂĽber die API erstellen?

Ja, absolut. Deine Zolldokumente werden automatisch erstellt, sofern die Pflichtfelder (siehe unten) fĂĽr jedes in der Sendung enthaltene Produkt korrekt angegeben sind. Weitere Details findest du in unserer Dokumentation: Internationaler Versand

Welche Felder sind fĂĽr den internationalen Versand verpflichtend?

  • customs_invoice_number
  • customs_shipment_type
  • country_state (Nur erforderlich fĂĽr Australien, Kanada, Italien und die USA.)
  • parcel_items
    • origin_country (ISO 2) 
    • hs_code

Verwandte Artikel und Ressourcen

→ API Dokumentation und Quick Start Guide

→ Sendcloud API-Referenz

→ Sendcloud Entwicklerportal

→ API Paketshopzustellung