DOCS

Calculate landed cost graphql

/

计算landed cost

使用GraphQL计算关税、税费和费用。

GraphQL

Zonos计算运输的总landed cost,包括关税、税费以及海关、代理或运输承运人可能收取的任何额外费用。我们通常通过自己支付关税、税费和费用账单来保证这些计算,同时向您收取我们计算的确切金额。在少数情况下,我们的计算可以在没有我们保证的情况下使用,您将承担我们计算与关税和税费账单之间的任何差额。

准备变更输入 

通过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:运输目的地的locationperson信息。
    • ORIGIN:运输起点的location信息。与运输起点相关的person不是必需的。
itemCreateWorkflowInput

itemCreateWorkflowInput列出购物车中的商品。还有许多可选字段(请参见我API参考中的所有可能性),但以下字段是必需的。

  • amount:商品的价格。
  • currencyCode:商品金额的货币代码。
  • quantity:商品的数量。
  • 以下之一(无论哪个设置为您商品键偏好。您的商品键将存储在目录中的信息与购物车中的商品连接,并在标签创建时使用。)
    • productId:商品的产品ID。
    • sku:商品的SKU。

measurementsWEIGHTLENGTHWIDTHHEIGHT)仅在您希望在获取运输评级纸箱化商品时才是必需的。

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可能会导致到岸成本不再被保证,因为这通常会导致在交付时支付关税和税费。
  • 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 生成它们。

为每个项目传递 HS 代码

Zonos 强烈建议使用特定于产品的 HS 代码,因为这会导致更准确的 landed cost 报价。如果您知道您的 HS 代码,请在 itemCreateWorkflow 中为每个 item 传递 hsCode

如果您传递了 HS 代码,Zonos 将在获取 landed cost 报价时实时验证它。如果您提供的 HS 代码无效(意味着它不存在),Zonos 将 重新-classify 您的项目,并使用新的有效 HS 代码替代您提供的代码。

如果您需要帮助生成产品的 HS 代码,请了解 Zonos Classify 以及如何 请求分类

使用 Classify 生成 HS 代码

如果您没有向 Zonos 传递 hsCode,我们将首先检查 Zonos Catalog 以查看您是否为您的项目存储了 HS 代码。如果没有,我们将调用 Classify 生成分类,以支持您的 landed cost 计算,基于以下 itemCreateWorkflow 产品详细字段:descriptioncategorymaterial。如果您的产品详细字段不够详细,无法基于 Classify's confidence scoring 生成分类,将使用分配给您商店的 default HS code

默认情况下,如果您不提供 hsCode 并且我们调用 Classify,则 Classify 生成的 hsCode 将不会在响应中返回,因为它将仅用于内部生成您的 landed cost。但是,如果您拥有 Classify 订阅,我们将在您的 Classify's 响应中返回 landed cost HS 代码。

运费

运输服务级别及其费用都会影响关税、税费和费用,因此是必需的。Zonos 可以计算运费,或者您可以将其传递给我们。

计算运费

要让 Zonos 计算运费,请使用 shipmentRatingCalculateWorkflow。在计算的运费响应中返回的运输选项将与您在 Dashboard 中为运输配置文件分配的 serviceLevels 相关联。

故障排除: 如果您期望响应中出现 serviceLevel 但未显示,请确保该 serviceLevel 已启用并且受您选择的 method 支持。

如果您希望 Zonos 在找到运费之前 对您的项目进行分类,请添加 cartonizeWorkflow(没有输入)。

传递运费

如果您知道运输的 serviceLevelamount,可以在请求的 shipmentRatingCreateWorkflow 部分传递这些值。我们将使用这些值计算任何相关的承运人费用,并在响应中返回这些费用。

发送变更 

一旦您拥有所需的输入数据,请使用您选择的客户端库或工具将 GraphQL 变更发送到 API 端点。以下是您可以构建变更的一些示例。

计算运费
手动运输

变更

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
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
    }
  }
}

响应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
  "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"
          }
        ]
      }
    ]
  }
}

这个页面有帮助吗?


有问题吗?

联系我们。
在本页上: