Spring Global (Spring Omni) -Fehler: Leere Antwort beim Abrufen des Etiketts

Bei dem Versuch, eine Sendung zu erstellen, ist ein Problem aufgetreten (Verwendung der / shipments API) und danach holten wir das Etikett (Verwenden der API / shipments / {delivery_id} / files). Das Problem war, dass wir eine leere Antwort bekamen. Als wir die Sendungen im Backoffice überprüft haben, sah es wie folgt aus:

Leere Antwort

Als wir auf die Sendung geklickt haben (mit status = "concept"), wir haben eine Nachricht als "Die Sendung wurde erstellt, ist aber (noch) nicht beim Spediteur registriert.“

Als wir das Konzept dieser neuen Versanderstellung in Spring Omni verstanden haben, haben wir erfahren, dass wir in Spring Global eine Sendung registrieren müssen, anstatt nur die Sendung zu erstellen, bevor wir das Etikett abrufen, das der Sendung entspricht. Es gibt zwei mögliche Szenarien für die Registrierung einer Sendung:

  1. Legen Sie die Sendung an und registrieren Sie sich gleichzeitig
  2. Erstellen Sie die Sendung, registrieren Sie sie jedoch zu einem bestimmten Zeitpunkt, dh in der Zukunft

1. So registrieren Sie eine Sendung sofort

Beim Senden der Sendungsanfrage müssen wir die "register_at"Parameterwert als 0 oder vergangene Zeit (UNIX-Zeitstempel) in den Anforderungsdaten. Bitte beziehen Sie sich auf den folgenden Code:

{
  "data": {
    "type": "shipments",
    "attributes": {
      "recipient_address": {
        "street_1": "Baker Street",
        "street_2": "Marylebone",
        "street_number": 221,
        "street_number_suffix": "B",
        "postal_code": "NW1 6XE",
        "city": "London",
        "region_code": "ENG",
        "country_code": "GB",
        "first_name": "Sherlock",
        "last_name": "Holmes",
        "company": "Holmes Investigations",
        "email": "s.holmes@holmesinvestigations.com",
        "phone_number": "+31 234 567 890"
      },
      "return_address": {
        "street_1": "Baker Street",
        "street_2": "Marylebone",
        "street_number": 221,
        "street_number_suffix": "B",
        "postal_code": "NW1 6XE",
        "city": "London",
        "region_code": "ENG",
        "country_code": "GB",
        "first_name": "Sherlock",
        "last_name": "Holmes",
        "company": "Holmes Investigations",
        "email": "s.holmes@holmesinvestigations.com",
        "phone_number": "+31 234 567 890"
      },
      "sender_address": {
        "street_1": "Baker Street",
        "street_2": "Marylebone",
        "street_number": 221,
        "street_number_suffix": "B",
        "postal_code": "NW1 6XE",
        "city": "London",
        "region_code": "ENG",
        "country_code": "GB",
        "first_name": "Sherlock",
        "last_name": "Holmes",
        "company": "Holmes Investigations",
        "email": "s.holmes@holmesinvestigations.com",
        "phone_number": "+31 234 567 890"
      },
      "pickup_location": {
        "code": "205604",
        "address": {
          "street_1": "Baker Street",
          "street_2": "Marylebone",
          "street_number": 221,
          "street_number_suffix": "B",
          "postal_code": "NW1 6XE",
          "city": "London",
          "region_code": "ENG",
          "country_code": "GB",
          "first_name": "Sherlock",
          "last_name": "Holmes",
          "company": "Holmes Investigations",
          "email": "s.holmes@holmesinvestigations.com",
          "phone_number": "+31 234 567 890"
        }
      },
      "description": "Order #8008135",
      "physical_properties": {
        "height": 150,
        "width": 300,
        "length": 500,
        "volume": 22.5,
        "weight": 5000
      },
      "items": [
        {
          "sku": "123456789",
          "description": "OnePlus X",
          "item_value": {
            "amount": 995,
            "currency": "EUR"
          },
          "quantity": 2,
          "hs_code": "8517.12.00",
          "origin_country_code": "GB",
          "item_weight": 135
        }
      ],
      "customs": {
        "content_type": "merchandise",
        "invoice_number": "9000",
        "non_delivery": "return",
        "incoterm": "DAP",
        "license_number": "218532158",
        "certificate_number": "12122121"
      },
      "register_at": 0
    },
    "relationships": {
      "service_options": {
        "data": [
          {
            "type": "service-options",
            "id": "4c675b1a-516c-4410-abff-d237fd45bcd0"
          }
        ]
      },
      "shop": {
        "data": {
          "type": "shops",
          "id": "35eddf50-1d84-47a3-8479-6bfda729cd99"
        }
      },
      "service": {
        "data": {
          "type": "services",
          "id": "175a235f-aff5-4e44-87b5-3657b75c1deb"
        }
      },
      "contract": {
        "data": {
          "type": "contracts",
          "id": "2cb32706-5762-4b96-9212-327e6afaeeff"
        }
      }
    }
  }
}

Wenn wir den register_at-Wert als aktuellen Zeitstempel senden, kann es zu Verzögerungen bei der Registrierung der Sendung kommen. Daher hat Spring Global vorgeschlagen, den register_at-Wert als 0 zu senden, damit die Zeit in der Vergangenheit berücksichtigt und die Sendung so bald wie möglich registriert wird wie möglich. Da die Sendung jetzt registriert wird, können wir sie nicht löschen / bearbeiten.

2. Registrieren Sie eine Sendung in Zukunft

Wenn wir die Sendung nach dem Erstellen bearbeiten / löschen möchten, müssen wir die Sendung nur in Zukunft oder zu einem bestimmten Zeitpunkt registrieren. Um eine Sendung zu einem späteren Zeitpunkt zu registrieren, z. B. nach 5 Stunden der Sendungserstellung, übergeben Sie einfach den Wert "register_at" als zukünftigen Zeitstempel von fünf Stunden auf der Grundlage der aktuellen Zeit. Jetzt können wir die Sendung bis 5 Stunden bearbeiten / löschen, aber das Etikett und die Handelsrechnung nicht mehr abrufen. Zum angegebenen Zeitpunkt wird die Sendung automatisch registriert und wir können das Etikett und die Handelsrechnung nach dem angegebenen Zeitpunkt abrufen.

Das sind also die beiden Möglichkeiten, die Sendung zu registrieren. Wir können beides auf Grund unserer Anforderung nutzen.

Bitte besuchen Sie hier für verwandte Informationen:

Spring Global (Spring Omni) Fehler: Die Eigenschaft phone_number ist erforderlich

Spring Omni Manifest

Spring Global (Spring Omni) Fehler: Der Versand wird nicht registriert

Spring Global (Spring Omni): Abrechnungskonzept

Spring Global (Spring Omni) -Fehler: Ressource nicht gefunden


DHL-Problem: Der Zielort ist ungültig. Bitte überprüfen Sie die Daten

Bei der Buchung des Versands bei DHL über die API (in unserem Fall war das Lieferland „Irland“), erhielten wir eine Fehlermeldung als Antwort auf die Funktionsanfrage. Der Fehler war “Der Zielort ist ungültig. Bitte überprüfen Sie die Daten“.

Lösung: �

Für dieses Problem haben wir ein Ticket bei DHL erstellt, und als Antwort haben sie wie folgt geantwortet:

Bei der Beantragung von Fähigkeiten ist es wichtig, vollständige und qualitativ hochwertige Adressdaten anzugeben. Es ist notwendig, genaue Routing-Informationen und -Funktionen für den Start- und Zielort zu bestimmen. Folgendes könnte die Ursache für den Fehler sein:

  1. Es kann vorkommen, dass es in verschiedenen Stadtteilen mehrere Städte mit demselben Namen gibt. Um also eine erfolgreiche Antwort zu erhalten, müssen wir speziell für das Lieferland “Irland” Vororte in der Zieladresse hinzufügen.
  2. Für die Zielländer, die keine Postleitzahlen haben, muss der Städtename genau geschrieben werden. Beispiel: Es gibt keine Stadt namens NORTH ROAD im Internet Explorer, die eigentliche Stadt heißt M50 NORTH ROAD.

Aus dieser Antwort ging hervor, dass die Überprüfung der Adresse nicht klar ist, woher wir wissen, ob die Adresse korrekt ist oder nicht, oder ob der Name der Stadt korrekt ist oder nicht. Wenn wir beispielsweise den Städtenamen als “Grafschaft Dublin” In der Sendungserstellungsanfrage erhalten wir einen Fehler “Ungültiger Standort”. Also haben wir erneut ein Ticket erstellt, um zu erfahren, wie wir die Adresse validieren können, und als Antwort schlug DHL ein Tool namens DHL Capability Tool vor (https://dct.dhl.com/). Geben Sie einfach die Absender- und Zieladresse in das Formular ein und klicken Sie auf die Schaltfläche „Suchen“, wie im folgenden Screenshot gezeigt:

Dieses Tool gibt das Ergebnis aus, ob die Adresse gültig ist oder nicht. Wenn Sie also einen Fehler bezüglich des Standorts erhalten, können Sie die Adresse mit diesem Funktionstool validieren.