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