Zonos einrichten
Registrieren Sie sich zunächst für ein Zonos-Konto und konfigurieren Sie Ihr Konto im Zonos Dashboard. Anschließend erhalten Sie Ihren API-Schlüssel, mit dem Sie sich bei der Zonos API authentifizieren können.
Basiswährung festlegen
Um Kontext zu den in einer Landed-Cost-Anfrage enthaltenen Geldbeträgen bereitzustellen, müssen Sie den Basiswährungscode Ihrer Anfrage angeben (als ISO-Währungscode). Dies bezieht sich auf alle Geldbeträge in der Anfrage und auf die Währung, in der das resultierende Landed-Cost-Angebot ausgegeben wird. Eine Liste der unterstützten Währungen und deren ISO-Codes finden Sie in unserer Landed-Cost-Dokumentation.
{ "currency": "USD"}Artikeldetails angeben
Um ein möglichst genaues Landed-Cost-Angebot mit Zonos zu erhalten, müssen Sie so viele Details wie möglich pro Artikel angeben, einschließlich harmonisierter (HS) Codes. Im Allgemeinen gilt: Je mehr Informationen Sie angeben, desto genauer wird Ihr Angebot sein.
Während die Bereitstellung von HS-Codes es Zonos Landed Cost ermöglicht, die genauesten und vollständigsten Berechnungen zurückzugeben, ist es möglich, den tatsächlichen Landed Cost ohne HS-Code anzunähern. Beachten Sie jedoch, dass möglicherweise ein HS-Code erforderlich ist, wenn die Gesamtkosten Ihrer Artikel den De-minimis-Schwellenwert überschreiten. In diesen Fällen führt das Senden einer Anfrage ohne HS-Code zu einem Fehler.
Fügen Sie für jeden Artikel, den Sie in Ihr Landed-Cost-Angebot aufnehmen möchten, einen Eintrag zum items-Array im Anfragetext hinzu.
{ "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ]}Versandadressen hinzufügen
Für die Berechnung des Landed Cost werden die Absender- und Empfängerorte Ihrer Sendung benötigt. Für den Versandzielort ist eine vollständige Adresse erforderlich; für die meisten Landed-Cost-Angebote reicht jedoch die Angabe des Absenderlandes aus.
{ "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000", "state": "SP" }}Versandkosten angeben
Die Zonos Landed Cost API berechnet keine Versandkosten – sie konzentriert sich auf Zölle, Steuern und Gebühren. Da der Versand einen erheblichen Teil eines gesamten Landed-Cost-Angebots und einen wichtigen Faktor bei der Berechnung darstellt, ist es wichtig, die Versandkosten im Voraus anzugeben. Dieser Wert kann mithilfe einer Versandbewertungs-API wie der Zonos Rating API oder auf andere Weise ermittelt werden, z. B. über die Versandsoftware Ihres Spediteurs, Tariftabellen usw.
Informationen zu den Versandkosten, einschließlich des Gesamtversandbetrags, werden über das Feld shipping in Ihrer API-Anfrage gesendet.
{ "shipping": { "amount": 14.23 }}Während nur der Betrag erforderlich ist, können Sie auch einen Service-Level-Namen angeben, damit die API die Spediteurgebühren anhand des angegebenen Betrags berechnen kann. Eine Liste der unterstützten Spediteure und Service-Level finden Sie in unserer Landed-Cost-Dokumentation.
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}API-Anfrage senden
Nachdem Sie Ihre Anfrage erstellt und konfiguriert haben, können Sie eine POST-Anfrage an die Zonos Landed Cost API senden. Stellen Sie sicher, dass Sie sich mit Ihrem API-Schlüssel authentifizieren und in Ihrer Anfrage den richtigen Versionsheader angeben.
POST https://api.zonos.com/v1/landed_cost
{ "currency": "USD", "items": [ { "id": "294395", "amount": 75, "country_of_origin": "FR", "description_customs": null, "hs_code": "6116.10.00", "quantity": 1 } ], "ship_from_country": "US", "ship_to": { "city": "Campinas", "country": "BR", "postal_code": "75828-000",
Landed Cost berechnen
Erfahren Sie, wie Sie einen Landed Cost über die REST API anfordern.
REST
Mit der Zonos Landed Cost API erhalten Sie schnell ein hochpräzises Landed-Cost-Angebot für grenzüberschreitende Import- und Exportsendungen. Während die Angabe von harmonisierten (HS) Codes es Zonos Landed Cost ermöglicht, die genaueste Zollberechnung zurückzugeben, liefern wir die ungefähre Höhe der Zölle und Steuern auch dann, wenn kein harmonisierter Code angegeben wird.