Landed Cost berechnen

Der partyCreateWorkflowInput identifiziert die beteiligten Parteien und deren Standorte. Das vollständige Schema finden Sie in unserer GraphQL-API-Referenz. Erforderliche Felder sind:

• location
  • administrativeAreaCode: Der Code für Bundesstaat oder Provinz in zwei Buchstaben. Nur erforderlich für CA und BR.
  • countryCode: Der zweistellige ISO-Code des Landes.
  • line1: Die erste Zeile der Adresse.
  • postalCode: Die Postleitzahl der Adresse.
• person
  • email: Die E-Mail-Adresse der Person.
  • firstName: Der Vorname der Person.
  • lastName: Der Nachname der Person.
  • phone: Die Telefonnummer der Person.
• type
  • DESTINATION: Die location- und person-Informationen für das Versandziel.
  • ORIGIN: Die location-Informationen für den Versandursprung. Die person, die mit dem Versandursprung verknüpft ist, ist nicht erforderlich.

Der itemCreateWorkflowInput listet die Artikel im Warenkorb auf. Es gibt viele optionale Felder (alle Möglichkeiten finden Sie in unserer API-Referenz), aber die folgenden Felder sind erforderlich.

• amount: Der Wert einer einzelnen Einheit des versendeten Produkts, bevor er mit der Menge multipliziert wird. Beachten Sie, dass sich dies von der postalischen Definition eines Postartikels unterscheidet. Wenn die quantity des Artikels 1 ist, sind dies die Gesamtkosten des Artikels. Wenn die quantity des Artikels >1 ist, multipliziert die API den Artikel-amount mit der quantity des Artikels, um die Summe für die Position zu erhalten. Geben Sie nicht den Gesamtpreis aller Einheiten des Artikels in amount an.
• currencyCode: Der Währungscode für den Artikelbetrag.
• quantity: Die Menge des Artikels. Die API multipliziert den Artikel-amount mit der quantity des Artikels, um die Summe für die Position zu erhalten.
• countryOfOrigin: Das Land, in dem der Artikel hergestellt wurde.
• Eines der folgenden (je nachdem, was als Ihre Artikelschlüssel-Präferenz festgelegt ist. Ihr Artikelschlüssel verbindet im Catalog gespeicherte Informationen mit dem Artikel im Warenkorb und wird bei der Label-Erstellung verwendet.)
  • productId: Die Produkt-ID des Artikels.
  • sku: Die SKU des Artikels.

Die measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) sind nur erforderlich, wenn Sie Ihre Artikel kartieren möchten, wenn Sie eine Sendungsbewertung erhalten.

Der cartonsCreateWorkflowInput erfordert nur die Eingabe selbst. Das vollständige Schema finden Sie in unserer GraphQL-API-Referenz, um alle Werte zu sehen, die übergeben werden können. Es ist wichtig, die Abmessungen und das Gewicht des Kartons zu übergeben, wenn Zonos die Versandkosten berechnet.

Dieser Workflow wird verwendet, wenn Sie den Versandservice und die Kosten bereits kennen; wenn Sie möchten, dass Zonos diese Kosten für von Ihnen aktivierte Services berechnet, ersetzen Sie diesen Workflow durch den shipmentRatingCalculateWorkflow.

Der shipmentRatingCreateWorkflowInput übermittelt die Versandkosten. Das vollständige Schema finden Sie in unserer GraphQL-API-Referenz. Erforderliche Felder sind:

• amount: Die Versandkosten.
• currencyCode: Der Währungscode der Versandkosten.
• serviceLevelCode: Der Code, der die in der Sendungsbewertung verwendete Versandservice-Stufe angibt.

Der landedCostWorkFlowInput legt Präferenzen für die Landed-Cost-Berechnung fest. Das vollständige Schema finden Sie in unserer GraphQL-API-Referenz. Erforderliche Felder sind:

• calculationMethod: Gibt Ihre Präferenz an, wie Sie versenden möchten: DDP (Zölle und Steuern im Voraus bezahlt) oder DAP (Zölle und Steuern werden bei der Zustellung bezahlt, oder bei einem Remittance-Schema werden sie über eine Steuer-ID abgeführt).
  • Wenn Sie unsere Landed-Cost-Garantie nutzen, sollte dieser Wert immer DDP_PREFERRED sein, was ein DDP-Angebot liefert, wenn möglich, und ein DAP-Angebot, wenn ein DDP-Angebot nicht zulässig ist. Die Verwendung von DAP kann dazu führen, dass Landed Costs nicht mehr garantiert sind, da Zölle und Steuern typischerweise bei der Zustellung bezahlt werden.
• endUse: Gibt an, ob die Waren an ein anderes Unternehmen verkauft werden (FOR_RESALE) oder für den Endverbrauch mit einem Konsumenten bestimmt sind (NOT_FOR_RESALE).
• tariffRate: Gibt die Methode an, die Zonos zur Berechnung der Zollsätze für dieses Angebot verwenden soll, falls ein Bereich von Zollsätzen angewendet werden könnte. *Bei Verwendung unserer Landed-Cost-Garantie sollte dies immer ZONOS_PREFERRED sein.

Zonos empfiehlt dringend die Verwendung produktspezifischer HS-Codes, da dies zu einem genaueren Landed-Cost-Angebot führt. Wenn Sie Ihre HS-Codes kennen, übergeben Sie den hsCode für jeden item während des itemCreateWorkflow.

Wenn Sie einen HS-Code übergeben, validiert Zonos ihn bei der Erstellung eines Landed-Cost-Angebots in Echtzeit. Wenn der von Ihnen angegebene HS-Code ungültig ist (d. h. nicht existiert), klassifiziert Zonos Ihren Artikel in Echtzeit neu und verwendet den neuen, gültigen HS-Code anstelle Ihres angegebenen Codes.

Wenn Sie Hilfe bei der Generierung von HS-Codes für Ihre Produkte benötigen, erfahren Sie mehr über Zonos Classify und wie Sie eine Klassifizierung anfordern.

Wenn Sie Zonos keinen hsCode übergeben, prüfen wir zuerst im Zonos Catalog, ob Sie einen HS-Code für Ihren Artikel gespeichert haben. Wenn nicht, rufen wir Classify auf, um eine Klassifizierung zu generieren, die Ihre Landed-Cost-Berechnung auf Basis der folgenden Produktdetailfelder des itemCreateWorkflow unterstützt: description, category und material. Wenn Ihre Produktdetailfelder nicht detailliert genug sind, um eine Klassifizierung basierend auf Classifys Confidence Score zu generieren, wird der Standard-HS-Code verwendet, der Ihrem Shop zugewiesen ist.

Um Zonos die Versandkosten berechnen zu lassen, verwenden Sie den shipmentRatingCalculateWorkflow. Die in der Antwort für berechneten Versand zurückgegebenen Versandoptionen korrespondieren mit den serviceLevels, die Sie Versandprofilen im Dashboard zugewiesen haben.

Fehlerbehebung: Wenn Sie einen serviceLevel in der Antwort erwarten, dieser aber nicht angezeigt wird, stellen Sie bitte sicher, dass der serviceLevel aktiviert ist und von der von Ihnen gewählten method unterstützt wird.

Fügen Sie den cartonizeWorkflow (ohne Eingaben) hinzu, wenn Zonos Ihre Artikel in Kartons sortieren soll, bevor die Versandkosten ermittelt werden (verwendet für Volumengewicht).

Wenn Sie den serviceLevel und den amount für eine Sendung kennen, können Sie diese im shipmentRatingCreateWorkflow-Teil der Anfrage übergeben. Wir verwenden diese Werte, um alle zugehörigen Spediteurgebühren zu berechnen und in der Antwort zurückzugeben.