DOCS

Berechnen Sie landed cost - GraphQL

Landed Cost•
StartseiteFür Logistikdienstleister Landed Cost Berechnen Sie landed cost - GraphQL

Berechnen Sie eine landed cost

Berechnen Sie Zölle, Steuern und Gebühren mit GraphQL.

GraphQL

Zonos berechnet die gesamte landed cost für internationale Sendungen – einschließlich Zöllen, Steuern und zusätzlichen Gebühren, die von Zollbehörden, Maklern oder Spediteuren erhoben werden. In den meisten Fällen garantieren wir diese Berechnungen, indem wir die endgültige Rechnung selbst bezahlen und Ihnen genau das berechnen, was wir kalkuliert haben. In einigen Fällen können Sie unsere landed cost ohne Garantie nutzen, was bedeutet, dass Sie die Verantwortung für etwaige Unterschiede zwischen unserer Berechnung und den tatsächlichen Gebühren übernehmen.

Bereiten Sie die Anfrage vor 

Die Berechnung einer landed cost API erfordert mehrere Eingaben, die wir in Workflows organisiert haben. Sobald dies abgeschlossen ist, können Sie eine einzelne Anfrage stellen, um eine landed cost basierend auf dem Versandziel, den Artikeln im Warenkorb und den Versanddetails zurückzugeben.

Jeder Workflow hat seine eigenen erforderlichen Eingaben. GraphQL ermöglicht es Ihnen, mehr Daten als nötig zu übermitteln, aber nur bestimmte Felder sind erforderlich, um eine landed cost zurückzugeben. Diese sind in unserem API-Referenzdokument klar gekennzeichnet, um alle möglichen Felder zu sehen.

Bitte beachten Sie, dass einige Felder bedingt erforderlich sind, wenn Sie möchten, dass Ihre Berechnung garantiert wird.

Im Folgenden haben wir alle Felder aufgeführt, die erforderlich sind, um eine garantierte landed cost zu berechnen. Stellen Sie sicher, dass diese Informationen enthalten sind, bevor Sie Ihre Anfrage stellen.

Erforderliche Eingaben für garantierte Berechnungen

partyCreateWorkflowInput

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

  • location
    • administrativeAreaCode: Der Bundesstaat oder Provinzcode, in zwei Buchstaben. Nur erforderlich für CA und BR.
    • countryCode: Der zweibuchstabige ISO-Code des Landes.
    • line1: Die erste Zeile der Adresse.
    • postalCode: Die Postleitzahl oder ZIP-Code 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 & person Informationen für das Versandziel.
    • ORIGIN: Die location Informationen für den Versandursprung. Die person, die mit dem Versandursprung verbunden ist, ist nicht erforderlich.
itemCreateWorkflowInput

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

  • amount: Der Preis des Artikels.
  • currencyCode: Der Währungs-Code für den Artikelbetrag.
  • quantity: Die Menge des Artikels.
  • Eines der folgenden (je nachdem, was als Ihre Artikel-Schlüssel-Präferenz festgelegt ist. Ihr Artikel-Schlüssel verbindet Informationen, die im Katalog gespeichert sind, mit dem Artikel im Warenkorb und wird während der Etikettenerstellung 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 beim Erhalten einer Versandbewertung kartonisieren möchten.

cartonsCreateWorkflowInput

Der cartonsCreateWorkflowInput erfordert nur die Eingabe selbst. Sehen Sie das vollständige Schema 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 anzugeben, wenn Zonos die Versandkosten berechnet.

shipmentRatingCreateWorkflowInput

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

Der shipmentRatingCreateWorkflowInput kommuniziert die Versandkosten. Sehen Sie das vollständige Schema in unserer GraphQL API Referenz. Erforderliche Felder sind:

  • amount: Die Versandkosten.
  • currencyCode: Der Währungs-Code der Versandkosten.
  • serviceLevelCode: Der Code, der das verwendete Versanddienstleistungsniveau in der Versandbewertung angibt.
landedCostWorkflowInput

Der landedCostWorkflowInput bestimmt die Präferenzen für die Berechnung der landed cost. Sehen Sie das vollständige Schema in unserer GraphQL API Referenz. Erforderliche Felder sind:

  • calculationMethod: Gibt Ihre Präferenz an, wie Sie versenden möchten: DDP (vorausbezahlte Zölle und Steuern) oder DAP (entweder Zölle und Steuern werden bei der Lieferung bezahlt, oder wenn ein Rückerstattungsschema gilt, werden sie über eine Steuer-ID erstattet).
    • Wenn Sie unsere landed cost-Garantie nutzen, sollte dieser Wert immer DDP_PREFERRED sein, was ein DDP-Angebot bereitstellt, wenn möglich, und ein DAP-Angebot, wenn ein DDP-Angebot nicht zulässig ist. Die Verwendung von DAP anstelle dessen kann dazu führen, dass die Landed Costs nicht mehr garantiert sind, da dies typischerweise bedeutet, dass Zölle und Steuern bei der Lieferung bezahlt werden.
  • endUse: Gibt an, ob die Waren an ein anderes Unternehmen verkauft werden (FOR_RESALE) oder für den Endverbrauch durch einen Verbraucher bestimmt sind (NOT_FOR_RESALE).
  • tariffRate: Gibt die Methode an, die Zonos zur Berechnung der Zolltarife für dieses Angebot verwenden sollte, falls eine Reihe von Zolltarifen angewendet werden könnte. *Bei Verwendung unserer landed cost-Garantie sollte dies immer ZONOS_PREFERRED sein.

Berechnete Versandkosten hinzufügen: Wenn Sie möchten, dass Zonos die Versandkosten für Sie berechnet, ersetzen Sie den shipmentRatingCreateWorkflow durch den shipmentRatingCalculateWorkflow. Fügen Sie den cartonizeWorkflow hinzu, wenn Sie möchten, dass Zonos Ihre Artikel in Kartons sortiert bevor die Versandkosten ermittelt werden (verwendet für dimensionales Gewicht).

HS-Code und Versandoptionen

GraphQL bietet Ihnen die Flexibilität, die Anfrage nach Ihren Wünschen anzupassen. Es gibt ein paar Optionen, wie Sie HS-Codes und Versandkosten in die Anfrage einbeziehen können.

HS-Codes

HS-Codes beeinflussen die Zolltarife und sind daher erforderlich. Sie können den HS-Code für jeden Artikel übermitteln oder Classify sie generieren lassen.

HS-Codes für jeden Artikel übermitteln

Zonos empfiehlt dringend die Verwendung von produktspezifischen HS-Codes, da dies zu einem genaueren landed cost-Angebot führt. Wenn Sie Ihre HS-Codes kennen, übermitteln Sie den hsCode für jeden item während des itemCreateWorkflow.

Wenn Sie einen HS-Code übermitteln, wird Zonos ihn bei der Erstellung eines landed cost-Angebots sofort validieren. Wenn der von Ihnen angegebene HS-Code ungültig ist (d. h. nicht existiert), wird Zonos Ihren Artikel erneut classify und den neuen, gültigen HS-Code anstelle des von Ihnen angegebenen verwenden.

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 können.

HS-Codes mit Classify generieren

Wenn Sie Zonos keinen hsCode übermitteln, prüfen wir zunächst den Zonos Katalog, um zu sehen, ob Sie einen HS-Code für Ihren Artikel gespeichert haben. Wenn nicht, rufen wir Classify auf, um eine Klassifizierung zu erstellen, die Ihre landed cost-Berechnung basierend auf den folgenden itemCreateWorkflow-Produktdetailfeldern unterstützt: description, category und material. Wenn Ihre Produktdetailfelder nicht detailliert genug sind, um eine Klassifizierung basierend auf Classify's Vertrauensbewertung zu generieren, wird der Standard-HS-Code verwendet, der Ihrem Geschäft zugewiesen ist.

Versandkosten

Sowohl das Versanddienstleistungsniveau als auch die Kosten beeinflussen die Zölle, Steuern und Gebühren und sind daher erforderlich. Zonos kann den Versand berechnen oder Sie können uns diese Informationen übermitteln.

Versand berechnen

Um Zonos die Versandkosten berechnen zu lassen, verwenden Sie das shipmentRatingCalculateWorkflow. Die in der berechneten Versandantwort zurückgegebenen Versandoptionen korrelieren mit den serviceLevels, die Sie den Versandprofilen im Dashboard zugewiesen haben.

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

Fügen Sie das cartonizeWorkflow hinzu (das keine Eingaben erfordert), wenn Sie möchten, dass Zonos Ihre Artikel sortiert in Kartons, bevor die Versandkosten ermittelt werden (verwendet für dimensionales Gewicht.

Versandkosten übermitteln

Wenn Sie das serviceLevel und den amount für eine Sendung kennen, können Sie diese im shipmentRatingCreateWorkflow-Teil der Anfrage übermitteln. Wir verwenden diese Werte, um alle damit verbundenen Frachtführergebühren zu berechnen und diese in der Antwort zurückzugeben.

Fordern Sie einen landed cost über die API an 

Sobald Sie die erforderlichen Eingabedaten haben, senden Sie die GraphQL-Mutation an den API-Endpunkt mit Ihrer gewählten Client-Bibliothek oder Ihrem Tool. Hier sind einige Beispiele, wie Sie die Mutation strukturieren können.

Verwenden Sie diese Anfrage, wenn Sie Zonos die Versandkosten im Rahmen der Landed Cost-Anfrage berechnen lassen. Wir berechnen dann Zölle und Steuern auf den Versand, wenn diese vom Zielland erhoben werden.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
mutation CalculateLandedCostWithShipping(
  $parties: [PartyCreateWorkflowInput!]!
  $items: [ItemCreateWorkflowInput!]!
  $landedCostConfig: LandedCostWorkflowInput!
) {
  partyCreateWorkflow(input: $parties) {
    type
    id
    organization
  }

  itemCreateWorkflow(input: $items) {
    id
    amount
  }

  cartonizeWorkflow {
    id
    type
    items {
      item {
        id
      }
    }
  }

  shipmentRatingCalculateWorkflow {
    id
    amount
  }

  landedCostCalculateWorkflow(input: $landedCostConfig) {
    id
    duties {
      amount
      currency
    }
    taxes {
      amount
      currency
    }
    fees {
      amount
      currency
    }
  }
}

Variablen

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
{
  "parties": [
    {
      "location": {
        "administrativeArea": "Utah",
        "administrativeAreaCode": "UT",
        "countryCode": "US",
        "line1": "345 N 2450 E",
        "line2": "#151",
        "locality": "St George",
        "postalCode": "84790"
      },
      "type": "ORIGIN"
    },
    {
      "location": {
        "administrativeArea": "BC",
        "administrativeAreaCode": "BC",
        "countryCode": "CA",
        "line1": "27 Sussex Dr.",
        "locality": "Victoria",
        "postalCode": "V8T 2V9"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      },
      "type": "DESTINATION"
    },
    {
      "type": "PAYOR",
      "location": {
        "administrativeArea": "ON",
        "administrativeAreaCode": "ON",
        "countryCode": "CA",
        "latitude": 1.2,
        "line1": "asdf",
        "line2": "asdf",
        "locality": "locality",
        "longitude": 3423.2,
        "postalCode": "M4C 1A1"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      }
    }
  ],
  "items": [
    {
      "amount": 69,
      "currencyCode": "USD",
      "countryOfOrigin": "US",
      "quantity": 1,
      "productId": "productId",
      "hsCode": "1006.30",
      "description": "description",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    },
    {
      "amount": 62,
      "currencyCode": "CAD",
      "countryOfOrigin": "US",
      "hsCode": "1006.30",
      "quantity": 1,
      "productId": "productId2",
      "description": "description2",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    }
  ],
  "landedCostConfig": {
    "endUse": "FOR_RESALE",
    "method": "DAP",
    "tariffRate": "ZONOS_PREFERRED"
  }
}

Antwort

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
  "data": {
    "partyCreateWorkflow": [
      {
        "type": "ORIGIN",
        "id": "party_749959ae-b9ff-4de4-b4ac-59cc990c53ba",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "DESTINATION",
        "id": "party_cd7ff245-76b6-464f-a7bf-151ebe1f8833",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "PAYOR",
        "id": "party_00e63a9e-9735-44d9-b129-3b3e76c5df25",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e",
        "amount": 69
      },
      {
        "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115",
        "amount": 62
      }
    ],
    "cartonizeWorkflow": [
      {
        "id": "carton_b34b29c1-ce27-464b-b91b-df8e4a696312",
        "type": "PACKAGE",
        "items": [
          {
            "item": {
              "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e"
            }
          },
          {
            "item": {
              "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115"
            }
          }
        ]
      }
    ],
    "shipmentRatingCalculateWorkflow": [
      {
        "id": "shipment_rating_96787309-9510-43cc-b4fa-c341ff80f4cc",
        "amount": 173.2
      },
      {
        "id": "shipment_rating_b0ccb109-7794-4c7c-b5cc-e2cfbbc5c8ac",
        "amount": 190.1
      }
    ],
    "landedCostCalculateWorkflow": [
      {
        "id": "landed_cost_74d3ce11-bff2-4326-9e6f-368e03ac88b4",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      },
      {
        "id": "landed_cost_7bbfd354-028c-457f-8c8e-c81bb8fa09a0",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      }
    ]
  }
}

Fordern Sie ein landed cost im Dashboard an 

Sie können auch die Landekosten direkt im Zonos Dashboard berechnen, ohne die API zu verwenden. Dies ist hilfreich für das Testen von Berechnungen, das Trainieren Ihres Teams oder das schnelle Erhalten von Angeboten für Kundenanfragen.

Das Dashboard verwendet die gleichen API-Endpunkte, die oben beschrieben sind, sodass die Ergebnisse mit denen übereinstimmen, die Sie von direkten API-Aufrufen erhalten würden. Dies macht es zu einer großartigen Möglichkeit, Ihre API-Integration zu validieren oder zu erkunden, wie verschiedene Eingaben die Berechnungen beeinflussen.

Verwendung des Dashboard-Rechners

Mit dem landed cost Rechner im Dashboard können Sie Angebote mit berechneten Versandkosten erhalten, Angebote mit bekannten Versandkosten erstellen oder mehrere Angebote in großen Mengen verarbeiten.

Verwenden Sie diesen Ablauf, wenn Sie den Versanddienstleistungsgrad und die Kosten für Ihre Sendung kennen.

  1. Gehen Sie zu Dashboard → Bestellungen → Angebote
  2. Klicken Sie auf Neues Angebot
  3. Optional — Ändern Sie den Standort Ihrer Absenderadresse
  4. Wählen Sie ein Zielland aus dem Dropdown-Menü
  5. Geben Sie den Versandbetrag ein
    • Der Dienstleistungsgrad ist optional; wenn Sie ihn hinzufügen, können wir die anfallenden Gebühren des Versanddienstleisters berechnen
  6. Fügen Sie die Artikeldetails für die Sendung hinzu
    • Wenn Sie eine Beschreibung eingeben, klassifizieren wir automatisch classify das Produkt und generieren einen HS-Code
    • Sie können den generierten HS-Code bei Bedarf überschreiben
    • Für mehrere Artikel klicken Sie auf Speichern und weiteren hinzufügen. Andernfalls klicken Sie auf Speichern
  7. Optional — Klicken Sie auf Weitere Optionen, um zu ändern:
    • Verkaufstyp auf Zum Wiederverkauf
    • Liefermodus auf Lieferung ohne Zollgebühren
  8. Klicken Sie auf Angebot einholen
    • Um Änderungen vorzunehmen, klicken Sie auf Formular bearbeiten und ändern Sie die Details
    • Klicken Sie erneut auf Angebot einholen, um zu aktualisieren

Ein landed cost Angebot wird rechts angezeigt, einschließlich Produkt-, Versand- und Importkosten. Erweitern Sie das Angebot, um detaillierte Aufschlüsselungen von Artikeln, Versand, Zöllen, Steuern und Gebühren zu sehen. Alle Angebote werden auf der Angebotsseite für zukünftige Referenzen gespeichert.

Vorhandene Angebote bearbeiten: Klicken Sie auf Angebot erneut, um ein bestehendes Angebot zu ändern, anstatt von vorne zu beginnen.

Vorteile der Verwendung des Dashboards

  • Kein Programmieren erforderlich — Generieren Sie Angebote über eine benutzerfreundliche Oberfläche
  • Teamausbildung — Helfen Sie nicht-technischen Teammitgliedern, die Komponenten des landed cost zu verstehen
  • API-Validierung — Überprüfen Sie, ob Ihre API-Integration die erwarteten Ergebnisse liefert
  • Kundensupport — Schnell Angebote für Kundenanfragen generieren
  • Massenverarbeitung — Mehrere Berechnungen effizient bearbeiten (demnächst verfügbar)

Die Angebote im Dashboard enthalten die gleichen detaillierten Aufschlüsselungen, die über die API verfügbar sind, was es zu einer hervorragenden Ergänzung Ihrer automatisierten Integration macht.

War diese Seite hilfreich?

Eine Demo buchen
© 2025 Zonoszonos.com
Auf dieser Seite:
  • Berechnen Sie eine landed cost
  • Bereiten Sie die Anfrage vor
  • Fordern Sie einen landed cost über die API an
  • Fordern Sie ein landed cost im Dashboard an