Richten Sie Zonos ein
Registrieren Sie sich zunächst für ein Zonos-Konto und konfigurieren Sie Ihr Konto im Zonos-Dashboard. Anschließend können Sie Ihren API-Schlüssel abrufen, mit dem Sie sich bei der Zonos API authentifizieren können.
Setzen Sie die Basiswährung fest
Um Kontext über Geldbeträge in einer Anfrage für die landed cost bereitzustellen, müssen Sie den ISO-Währungscode Ihrer Basiswährung angeben. Dieser bezieht sich auf alle Geldbeträge in der Anfrage und auf welche Währung das resultierende Angebot für die landed cost ausgewiesen wird. Eine Liste der unterstützten Währungen und ihrer ISO-Codes finden Sie in unserer landed cost Dokumentation.
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
}
}
Obwohl nur der Betrag erforderlich ist, können Sie auch einen Servicenamen angeben, um es der API zu ermöglichen, die Trägergebühren basierend auf dem angegebenen Betrag zu berechnen. Eine Liste der unterstützten Träger und Serviceniveaus finden Sie in unseren Landed Cost Dokumenten.
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 eine landed cost
Erfahren Sie, wie Sie über die REST-API eine landed cost anfordern können.
REST
Die Zonos Landed Cost API ermöglicht es Ihnen, schnell ein hochpräzises Angebot für die landed cost von grenzüberschreitenden Import- und Exportsendungen zu erhalten. Durch die Angabe von harmonisierten (HS) Codes kann Zonos Landed Cost die genaueste Zollberechnung zurückgeben. Selbst wenn kein harmonisierter Code angegeben wird, geben wir den ungefähren Betrag an Zöllen und Steuern zurück.