准备变更输入
通过GraphQL API计算landed cost涉及多个步骤;我们已将这些步骤组织成工作流。最后,您将拥有进行一次调用所需的所有信息,以根据运输目的地、购物车中的商品和运输进行获取landed cost。
每个工作流需要特定的输入数据。GraphQL允许您包含比所需更多的信息;请参考我们的完API参考以查看所有可能的字段。所需字段在我们的API参考中标记为必需,但此标记仅适用于功能所需的字段。在使用我们的保证时,还需要一些额外字段。
以下是计算保证 landed cost所需的所有字段。确保您准备好这些信息。
保证计算所需输入
partyCreateWorkflowInput
partyCreateWorkflowInput
标识相关方及其位置。查看我们GraphQL API 参考中的完整架构。所需字段包括:
location
administrativeAreaCode
:州或省代码,两个字母。仅在CA和BR时必需。countryCode
:国家的两个字ISO代码。line1
:地址的第一行。postalCode
:地址的邮政编码或邮政区号。
person
email
:个人的电子邮件地址。firstName
:个人的名字。lastName
:个人的姓氏。phone
:个人的电话号码。
type
DESTINATION
:运输目的地的location
和person
信息。ORIGIN
:运输起点的location
信息。与运输起点相关的person
不是必需的。
itemCreateWorkflowInput
shipmentRatingCreateWorkflowInput
当您已经知道运输服务和费用时使用此工作流;如果您希望Zonos为您计算已启用服务的费用,请替换此工作流并使用shipmentRatingCalculateWorkflow
。
shipmentRatingCreateWorkflowInput
传达运输费用。查看我们GraphQL API 参考中的完整架构。所需字段包括:
amount
:运输费用。currencyCode
:运输费用的货币代码。serviceLevelCode
:指示在运输评级中使用的运输服务级别的代码。
landedCostWorkflowInput
landedCostWorkflowInput
规定landed cost计算的偏好。查看我们GraphQL API 参考中的完整架构。所需字段包括:
calculationMethod
:指示您计划如何运输的偏好:DDP(预付关税和税费)或DAP(关税和税费在交付时支付,或者如果适用汇款计划,则通过税号汇款)。- 如果您使用我们的landed cost保证,此值应始终为
DDP_PREFERRED
,这将在可能的情况下提供DDP报价,而在不允许DDP报价时提供DAP报价。使用DAP
可能会导致到岸成本不再被保证,因为这通常会导致在交付时支付关税和税费。
- 如果您使用我们的landed cost保证,此值应始终为
endUse
:指示商品是出售给其他企业(FOR_RESALE
)还是供消费者最终使用(NOT_FOR_RESALE
)。tariffRate
:指示Zonos在此报价中应使用的计算关税率的方法,以防有一系列可能适用的关税率。*在使用我们的landed cost保证时,这应始终为ZONOS_PREFERRED
。
添加计算的运输费用: 如果您希望Zonos为您计算运输费用,请将
shipmentRatingCreateWorkflow
替换为shipmentRatingCalculateWorkflow
。如果您希望Zonos在找到运输费用之对您的商品进行分类,请添加cartonizeWorkflow
(用体积重量)。
计算landed cost时的选项
GraphQL 让您可以根据自己的偏好自定义请求。有几种选项可以在请求中包含 HS 代码 和运费。
HS 代码
HS 代码影响关税,因此是必需的。您可以为每个项目传递 HS 代码,或者让 Classify 生成它们。
Zonos 强烈建议使用特定于产品的 HS 代码,因为这会导致更准确的 landed cost 报价。如果您知道您的 HS 代码,请在 itemCreateWorkflow
中为每个 item
传递 hsCode
。
如果您传递了 HS 代码,Zonos 将在获取 landed cost 报价时实时验证它。如果您提供的 HS 代码无效(意味着它不存在),Zonos 将 重新-classify 您的项目,并使用新的有效 HS 代码替代您提供的代码。
如果您需要帮助生成产品的 HS 代码,请了解 Zonos Classify 以及如何 请求分类。
如果您没有向 Zonos 传递 hsCode
,我们将首先检查 Zonos Catalog 以查看您是否为您的项目存储了 HS 代码。如果没有,我们将调用 Classify 生成分类,以支持您的 landed cost 计算,基于以下 itemCreateWorkflow
产品详细字段:description
、category
和 material
。如果您的产品详细字段不够详细,无法基于 Classify's confidence scoring 生成分类,将使用分配给您商店的 default HS code。
默认情况下,如果您不提供 hsCode
并且我们调用 Classify,则 Classify 生成的 hsCode
将不会在响应中返回,因为它将仅用于内部生成您的 landed cost。但是,如果您拥有 Classify 订阅,我们将在您的 Classify's 响应中返回 landed cost HS 代码。
运费
运输服务级别及其费用都会影响关税、税费和费用,因此是必需的。Zonos 可以计算运费,或者您可以将其传递给我们。
如果您知道运输的 serviceLevel
和 amount
,可以在请求的 shipmentRatingCreateWorkflow
部分传递这些值。我们将使用这些值计算任何相关的承运人费用,并在响应中返回这些费用。
发送变更
一旦您拥有所需的输入数据,请使用您选择的客户端库或工具将 GraphQL 变更发送到 API 端点。以下是您可以构建变更的一些示例。
变更
mutation {
partyCreateWorkflow(
input: [
{
location: {
administrativeArea: "Utah"
administrativeAreaCode: "UT"
countryCode: US
line1: "345 N 2450 E"
line2: "#151"
locality: "St George"
postalCode: "84790"
}
type: ORIGIN
}
{
location: {
administrativeArea: "BC"
administrativeAreaCode: "BC"
countryCode: CA
line1: "27 Sussex Dr."
locality: "Victoria"
postalCode: "V8T 2V9"
}
person: {
email: "test@gmail.com"
firstName: "firstName"
lastName: "lastName"
phone: "5022303021"
companyName: "goProTest"
metadata: { key: "key", value: "value" }
}
type: DESTINATION
}
{
type: PAYOR
location: {
administrativeArea: "ON"
administrativeAreaCode: "ON"
countryCode: CA
latitude: 1.2
line1: "asdf"
line2: "asdf"
locality: "locality"
longitude: 3423.2
postalCode: "M4C 1A1"
}
person: {
email: "test@gmail.com"
firstName: "firstName"
lastName: "lastName"
phone: "5022303021"
companyName: "goProTest"
metadata: { key: "key", value: "value" }
}
}
]
) {
type
id
organization
}
itemCreateWorkflow(
input: [
{
amount: 69
currencyCode: USD
countryOfOrigin: US
quantity: 1
productId: "productId"
hsCode: "1006.30"
description: "description"
measurements: [
{ type: WIDTH, value: 2, unitOfMeasure: CENTIMETER }
{ type: WEIGHT, value: 2, unitOfMeasure: POUND }
]
}
{
amount: 62
currencyCode: CAD
countryOfOrigin: US
hsCode: "1006.30"
quantity: 1
productId: "productId2"
description: "description2"
measurements: [
{ type: WIDTH, value: 2, unitOfMeasure: CENTIMETER }
{ type: WEIGHT, value: 2, unitOfMeasure: POUND }
]
}
]
) {
id
amount
}
cartonizeWorkflow {
id
type
items {
item {
id
}
}
}
shipmentRatingCalculateWorkflow {
id
amount
}
landedCostCalculateWorkflow(
input: { endUse: FOR_RESALE, method: DAP, tariffRate: ZONOS_PREFERRED }
) {
id
duties {
amount
currency
}
taxes {
amount
currency
}
fees {
amount
currency
}
}
}
响应
{
"data": {
"partyCreateWorkflow": [
{
"type": "ORIGIN",
"id": "party_749959ae-b9ff-4de4-b4ac-59cc990c53ba",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
},
{
"type": "DESTINATION",
"id": "party_cd7ff245-76b6-464f-a7bf-151ebe1f8833",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
},
{
"type": "PAYOR",
"id": "party_00e63a9e-9735-44d9-b129-3b3e76c5df25",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
}
],
"itemCreateWorkflow": [
{
"id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e",
"amount": 69
},
{
"id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115",
"amount": 62
}
],
"cartonizeWorkflow": [
{
"id": "carton_b34b29c1-ce27-464b-b91b-df8e4a696312",
"type": "PACKAGE",
"items": [
{
"item": {
"id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e"
}
},
{
"item": {
"id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115"
}
}
]
}
],
"shipmentRatingCalculateWorkflow": [
{
"id": "shipment_rating_96787309-9510-43cc-b4fa-c341ff80f4cc",
"amount": 173.2
},
{
"id": "shipment_rating_b0ccb109-7794-4c7c-b5cc-e2cfbbc5c8ac",
"amount": 190.1
}
],
"landedCostCalculateWorkflow": [
{
"id": "landed_cost_74d3ce11-bff2-4326-9e6f-368e03ac88b4",
"duties": [
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"taxes": [
{
"amount": 3.45,
"currency": "USD"
},
{
"amount": 3.1,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"fees": [
{
"amount": 0.13,
"currency": "USD"
},
{
"amount": 1.44,
"currency": "USD"
}
]
},
{
"id": "landed_cost_7bbfd354-028c-457f-8c8e-c81bb8fa09a0",
"duties": [
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"taxes": [
{
"amount": 3.45,
"currency": "USD"
},
{
"amount": 3.1,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"fees": [
{
"amount": 0.13,
"currency": "USD"
},
{
"amount": 1.44,
"currency": "USD"
}
]
}
]
}
}
计算landed cost
使用GraphQL计算关税、税费和费用。GraphQL
Zonos计算运输的总landed cost,包括关税、税费以及海关、代理或运输承运人可能收取的任何额外费用。我们通常通过自己支付关税、税费和费用账单来保证这些计算,同时向您收取我们计算的确切金额。在少数情况下,我们的计算可以在没有我们保证的情况下使用,您将承担我们计算与关税和税费账单之间的任何差额。