Richten Sie Zonos ein
Zuerst registrieren Sie sich für ein Zonos Konto und konfigurieren Ihr Konto im Zonos Dashboard. Sie können dann Ihren API-Schlüssel erhalten, mit dem Sie sich bei der Zonos API authentifizieren können.
Basiswährung festlegen
Um Kontext zu den Geldbeträgen zu geben, die in einer landed cost Anfrage enthalten sind, müssen Sie den Basiswährungscode Ihrer Anfrage angeben (als ISO-Währungscode). Dies bezieht sich auf alle Geldwerte in der Anfrage und in welcher Währung das resultierende landed cost Angebot dargestellt wird. Eine Liste der unterstützten Währungen und ihrer ISO-Codes finden Sie in unseren landed cost Dokumenten.
Anfrage
{
"currency": "USD"
}
Artikelinformationen bereitstellen
Um ein möglichst genaues Angebot für die landed cost unter Verwendung von Zonos zu erhalten, müssen Sie so viele Artikelinformationen wie möglich bereitstellen, einschließlich der harmonisierten (HS) Codes. Im Allgemeinen gilt: Je mehr Informationen Sie angeben, desto genauer wird Ihr Angebot sein.
Durch die Angabe von HS-Codes kann Zonos Landed Cost die genauesten und vollständigsten Berechnungen zurückgeben. Es ist jedoch auch möglich, den tatsächlichen landed cost ohne HS-Code anzunähern. Beachten Sie jedoch, dass bei Überschreiten der De-minimis-Schwelle für die Gesamtkosten Ihrer Artikel ein HS-Code erforderlich sein kann. In solchen 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 Angebot für die landed cost aufnehmen möchten, einen Eintrag zum items-Array im Anforderungskörper hinzu.
Anfrage
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
Versandadressen hinzufügen
Die Versand- und Empfangsorte für Ihre Sendung sind erforderlich, um die landed cost zu berechnen. Eine vollständige Adresse ist für das Versandziel erforderlich, aber für die meisten landed cost-Angebote reicht es aus, das Versandland anzugeben.
Anfrage
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
Versandkosten bereitstellen
Die Zonos Landed Cost API berechnet keine Versandkosten - sie konzentriert sich auf Zollgebühren, Steuern und Gebühren. Da der Versand ein wesentlicher Bestandteil eines Gesamtangebots für landed cost ist und ein bedeutender Faktor bei der Berechnung darstellt, ist es wichtig, die Versandkosten im Voraus anzugeben. Dieser Wert kann durch die Verwendung einer Versandbewertungs-API wie der Zonos Rating API oder auf verschiedene andere Weise, wie z.B. die Versandsoftware Ihres Spediteurs, rate-Tabellen usw., erhalten werden.
Informationen zu den Versandkosten, einschließlich des Gesamtbetrags für den Versand, werden über das Feld shipping in Ihrer API-Anfrage gesendet.
Anfrage
{
"shipping": {
"amount": 14.23
}
}
Während nur der Betrag erforderlich ist, können Sie auch einen Servicenamen angeben, um der API zu ermöglichen, die Frachtgebühren basierend auf dem angegebenen Betrag zu berechnen. Sie können eine Liste der unterstützten Frachtführer und Servicelevel in unseren Landed Cost-Dokumenten einsehen.
Anfrage
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
Sende eine API-Anfrage
Nachdem du deine Anfrage erstellt und konfiguriert hast, kannst du eine POST-Anfrage an die Zonos Landed Cost API senden. Stelle sicher, dass du dich mit deinem API-Schlüssel authentifizierst und den richtigen Versionsheader in deiner Anfrage angibst.
POST https://api.zonos.com/v1/landed_cost
Anfrage
{
"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",
"state": "SP"
},
"shipping": {
"amount": 14.23,
"amount_discount": 0,
"service_level": "ups_express_saver"
}
}
Antwort
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
Berechnen Sie ein landed cost
Erfahren Sie, wie Sie ein landed cost über die REST API anfordern.
REST
Die Zonos Landed Cost API ermöglicht es Ihnen, schnell ein hochgenaues landed cost Angebot für grenzüberschreitende Import- und Exportlieferungen zu erhalten. Während die Bereitstellung von harmonisierten (HS) Codes es Zonos Landed Cost ermöglicht, die genaueste Zollberechnung zurückzugeben, werden wir auch den ungefähren Betrag an Zöllen und Steuern zurückgeben, selbst wenn kein harmonisierter Code bereitgestellt wird.