> ## 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**           | 運輸標籤是否為測試標籤。預設停用。                                                                                                                                           |
