设置Zonos
首先，注册一个Zonos账户并在Zonos Dashboard上配置您的账户。之后，您将能够获取您的API密钥，这将允许您使用Zonos API进行身份验证。
设置基础货币
为了给着陆成本请求中包含的金额提供上下文，您需要指定您的请求的基础货币代码（作为ISO货币代码）。这将涉及请求中的所有货币值，以及最终着陆成本报价将以什么货币形式显示。您可以在我们的着陆成本文档上找到支持的货币及其ISO代码列表。
{ "currency": "USD"}提供项目详情
要使用Zonos获得准确的着陆成本报价，您需要提供尽可能多的逐项详情，包括协调（HS）代码。通常，您包含的信息越多，您的报价就越准确。
虽然提供HS代码可以让Zonos Landed Cost返回最准确和完整的计算，但在没有HS代码的情况下也可以近似实际着陆成本。但是，请注意，如果您的项目总成本超过最低限额阈值，可能需要HS代码。在这些情况下，发送不带HS代码的请求将导致错误。
对于您想要包含在着陆成本报价中的每个项目，将一个条目添加到请求体中的items数组。
{ "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" }}提供运费
Zonos Landed Cost API不会计算运费 - 它专注于海关关税、税收和费用。由于运费是总着陆成本报价的一个相当大的方面，也是计算方式的一个重要因素，因此必须预先指定运费。这个值可以通过使用发货评级API（例如Zonos Rating API）或各种其他方式（例如您的承运人的运费软件、费率表等）获得。
与运费相关的信息，包括总运费金额，通过您API请求中的shipping字段发送。
{ "shipping": { "amount": 14.23 }}虽然只需要金额，但您也可以提供服务级别名称以使API能够从提供的金额计算承运人费用。您可以在我们的Landed Cost文档上看到支持的承运人和服务级别列表。
{ "shipping": { "amount": 14.23, "service_level": "ups_express_saver" }}发送API请求
现在您已构建并配置了请求，您可以向Zonos Landed Cost API发送POST请求。确保使用您的API密钥进行身份验证，并在您的请求中提供正确的版本标头。
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", "state": "SP" }
计算着陆成本
了解如何通过REST API请求着陆成本。REST
Zonos Landed Cost API使您能够快速获得针对跨境进出口商品的高度准确的着陆成本报价。虽然提供协调（HS）代码能够让Zonos Landed Cost返回最准确的关税计算，但即使在没有提供协调代码的情况下，我们仍会返回近似的关税和税收金额。