> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ShipStation 创建运输标签

> 在工作流程末尾在 ShipStation 中创建运输标签。

export const siteNameShort = "知行之桥";

创建运输标签操作会在 ShipStation 上创建运输标签。此操作应位于工作流末尾。

创建运输标签时：

* [通过 XML 映射](#xml-映射-包装package收件方ship-to自定义customs)设置包装信息、收件方（Ship To）值和其它自定义信息。
* 在[端口配置面板](#端口配置-发件方ship-from)中指定 **Ship From** 并测试标签。

## XML 映射: 包装（Package），收件方（Ship To），自定义（Customs）

你需要将 [XML Map](../xml-map/xml-map) 端口连接到 ShipStation 端口，以映射包装细节、收件方和其它自定义信息。

在下面的示例中，运输信息显示在 **Source** 列中，ShipStation 运输标签参数显示在 **Destination** 列中。

<img src="https://mintcdn.com/qiao/ilnLy7gsSdFqbKmI/public/images/shipstation_labelmapping.png?fit=max&auto=format&n=ilnLy7gsSdFqbKmI&q=85&s=169f85b21f0e90d7d75c252676d89454" alt="ShipStation Label Mapping" width="700" data-path="public/images/shipstation_labelmapping.png" />

### 运输标签值

下表列出了可以使用 XML Map 端口界面为运输标签映射的值。

| 名称                                                               | 数据类型    | 是否必填？ | 描述                                                                                                                                                          |
| ---------------------------------------------------------------- | ------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CarrierCode                                                      | String  | 是     | 运输承运人代码。                                                                                                                                                    |
| ServiceCode                                                      | String  | 是     | 运输服务代码。                                                                                                                                                     |
| PackageCode                                                      | String  | 是     | 包装类型代码。                                                                                                                                                     |
| Confirmation                                                     | String  | 否     | 要使用的投递确认类型。允许值为 **none**、**delivery**、**signature**、**adult\_signature** 或 **direct\_signature**。**direct\_signature** 仅适用于 FedEx。                          |
| ShipDate                                                         | String  | 是     | 订单应发货的日期。                                                                                                                                                   |
| WeightValue                                                      | Integer | 是     | 货件的重量值。                                                                                                                                                     |
| WeightUnits                                                      | String  | 是     | 重量值的单位。                                                                                                                                                     |
| WeightWeightUnits                                                | Integer | 否     | 货件的重量单位值。                                                                                                                                                   |
| DimensionsLength                                                 | String  | 否     | 包装长度。                                                                                                                                                       |
| DimensionsWidth                                                  | String  | 否     | 包装宽度。                                                                                                                                                       |
| DimensionsHeight                                                 | String  | 否     | 包装高度。                                                                                                                                                       |
| DimensionsUnits                                                  | String  | 否     | 尺寸的计量单位。允许值为 **inches** 或 **centimeters**。                                                                                                                  |
| ShipToName                                                       | String  | 是     | 收件人姓名。                                                                                                                                                      |
| ShipToCompany                                                    | String  | 是     | 收件公司名称。                                                                                                                                                     |
| ShipToStreet1                                                    | String  | 是     | 地址第一行。                                                                                                                                                      |
| ShipToStreet2                                                    | String  | 否     | 地址第二行（如果适用）。                                                                                                                                                |
| ShipToStreet3                                                    | String  | 否     | 地址第三行（如果适用）。                                                                                                                                                |
| ShipToCity                                                       | String  | 是     | 城市名称。                                                                                                                                                       |
| ShipToState                                                      | String  | 是     | 州/省名称。                                                                                                                                                      |
| ShipToPostalCode                                                 | String  | 是     | 邮政编码。                                                                                                                                                       |
| ShipToCountry                                                    | String  | 是     | 两位 ISO 国家或地区代码。                                                                                                                                             |
| ShipToPhone                                                      | String  | 否     | 收件人的电话号码。                                                                                                                                                   |
| ShipToResidential                                                | Boolean | 是     | ShipTo 地址是否为住宅地址。                                                                                                                                           |
| ShipToAddressVerified                                            | String  | 否     | 地址是否已由 ShipStation 验证。允许值为 **Address not yet validated**、**Address validated successfully**、**Address validation warning** 或 **Address validation failed**。 |
| InsuranceOptions<br />InsureShipment                             | String  | 否     | 货件是否应投保。                                                                                                                                                    |
| InsuranceOptions<br />Provider                                   | String  | 否     | 首选保险提供商。允许值为 **shipsurance**、**carrier** 或 **provider**。**provider** 表示货件由 ShipSurance 或承运人以外的第三方投保。Provider 保险由 ShipStation 外部处理，且不会影响处理标签的成本。             |
| InternationalOptions<br />Contents                               | String  | 否     | 国际货件的内容物。允许值为 **merchandise**、**documents**、**gift**、**returned\_goods** 或 **sample**。                                                                      |
| InternationalOptions<br />CustomsItems<br />CustomsItemId        | String  | 否     | 海关物品的 ItemId 值。如果有多个值，请用逗号分隔（例如，**121221,21211,12121**）。                                                                                                    |
| InternationalOptions<br />CustomsItems<br />Description          | String  | 否     | 海关物品的简短说明。如果有多个物品，请用逗号分隔每个物品的说明（例如，**desc1,desc2,desc3**）。                                                                                                  |
| InternationalOptions<br />CustomsItems<br />Quantity             | String  | 否     | 每个海关物品的数量。如果有多个物品，请用逗号分隔每个物品的数量（例如，**5,1,4**）。                                                                                                              |
| InternationalOptions<br />CustomsItems<br />Value                | String  | 否     | 每个海关物品的价值（美元）。如果有多个物品，请用逗号分隔每个物品的价值（例如，**10,50,100**）。                                                                                                      |
| InternationalOptions<br />CustomsItems<br />HarmonizedTariffCode | String  | 否     | 每个海关物品的海关协调商品编码。如果有多个物品，请用逗号分隔每个物品的编码（例如，**10012,40021,30091**）。                                                                                            |
| InternationalOptions<br />CustomsItems<br />CountryOfOrigin      | String  | 否     | 每个海关物品的两位 ISO 国家或地区代码。如果有多个物品，请用逗号分隔每个物品的代码（例如，**US,US,US**）。                                                                                               |
| InternationalOptions<br />NonDelivery                            | String  | 否     | 国际货件的不送达选项。允许值为 **return\_to\_sender** 或 **treat\_as\_abandoned**。                                                                                          |
| AdvancedOptions<br />WarehouseId                                 | Integer | 否     | 订单将从其发货的仓库 ID。如果订单使用履约提供商完成，则没有附加仓库，此值为 **null**。                                                                                                           |
| AdvancedOptions<br />NonMachinable                               | Boolean | 否     | 订单是否不可机加工。                                                                                                                                                  |
| AdvancedOptions<br />SaturdayDelivery                            | Boolean | 否     | 订单是否在周六送达。                                                                                                                                                  |
| AdvancedOptions<br />ContainsAlcohol                             | Boolean | 否     | 订单是否含有酒精。                                                                                                                                                   |
| AdvancedOptions<br />StoreId                                     | Integer | 否     | 与订单关联的商店 ID。如果未指定此值，ShipStation 默认使用账号上的第一个手动商店。                                                                                                            |
| AdvancedOptions<br />CustomField1                                | String  | 否     | 允许将自定义数据与订单关联的字段。                                                                                                                                           |
| AdvancedOptions<br />CustomField2                                | String  | 否     | 允许将自定义数据与订单关联的字段。                                                                                                                                           |
| AdvancedOptions<br />CustomField3                                | String  | 否     | 允许将自定义数据与订单关联的字段。                                                                                                                                           |
| AdvancedOptions<br />Source                                      | String  | 否     | 订单的原始来源或市场。                                                                                                                                                 |
| AdvancedOptions<br />MergedOrSplit                               | Boolean | 否     | 订单是否已与另一个订单合并或从另一个订单拆分。                                                                                                                                     |
| AdvancedOptions<br />MergedIds                                   | Integer | 否     | 如果订单已合并，这是被合并订单的 orderId 数组。                                                                                                                                |
| AdvancedOptions<br />ParentId                                    | Integer | 否     | 如果订单从父订单拆分而来，这是父订单的 orderId。                                                                                                                                |
| AdvancedOptions<br />BillToParty                                 | String  | 否     | 为货件计费的一方。允许值为 **my\_account**、**my\_other\_account**、**recipient** 或 **third\_party**。                                                                      |
| AdvancedOptions<br />BillToAccount                               | String  | 否     | 为货件计费的一方的账号。                                                                                                                                                |
| AdvancedOptions<br />BillToPostalCode                            | String  | 否     | 为货件计费的一方的邮政编码。                                                                                                                                              |
| AdvancedOptions<br />BillToCountryCode                           | String  | 否     | 为货件计费的一方的两位 ISO 国家或地区代码。                                                                                                                                    |
| AdvancedOptions<br />BillToMyOtherAccount                        | String  | 否     | 如果 **AdvancedOptions<br />BillToParty** 设置为 **my\_other\_account**，这是所需账号的 shippingProviderId 值。你可以调用 *List Carriers* 来获取 shippingProviderId 值。             |

## 端口配置: 发件方（Ship From）

创建运输标签的配置面板允许你指定 **Ship From** 信息，并在测试标签与真实标签之间切换。下表概述了这些值：

| 设置                             | 描述                                                                                                                                                          |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ship From Name**             | 发件人姓名。                                                                                                                                                      |
| **Ship From Company**          | 公司名称。                                                                                                                                                       |
| **Ship From Street 1**         | 地址第一行。                                                                                                                                                      |
| **Ship From Street 2**         | 地址第二行（如果适用）。                                                                                                                                                |
| **Ship From Street 3**         | 地址第三行（如果适用）。                                                                                                                                                |
| **Ship From City**             | 城市名称。                                                                                                                                                       |
| **Ship From State**            | 州/省名称。                                                                                                                                                      |
| **Ship From Postal Code**      | 邮政编码。                                                                                                                                                       |
| **Ship From Country**          | 两位 ISO 国家或地区代码。                                                                                                                                             |
| **Ship From Phone**            | 发件人的电话号码。                                                                                                                                                   |
| **Ship From Residential**      | Ship From 地址是否为住宅地址。                                                                                                                                        |
| **Ship From Address Verified** | 地址是否已由 ShipStation 验证。允许值为 **Address not yet validated**、**Address validated successfully**、**Address validation warning** 或 **Address validation failed**。 |
| **Enable Test Mode**           | 运输标签是否为测试标签。默认禁用。                                                                                                                                           |
