ShipStation 建立運輸標籤 - 知行之桥文档

建立運輸標籤操作會在 ShipStation 上建立運輸標籤。此操作應位於工作流程末尾。建立運輸標籤時：

透過 XML 對映設定包裝資訊、收件方（Ship To）值和其它自定義資訊。
在端口配置面板中指定 Ship From 並測試標籤。

XML 對映: 包裝（Package），收件方（Ship To），自定義（Customs）

你需要將 XML Map 端口連線到 ShipStation 端口，以對映包裝細節、收件方和其它自定義資訊。在下面的範例中，運輸資訊顯示在 Source 列中，ShipStation 運輸標籤參數顯示在 Destination 列中。

ShipStation Label Mapping

運輸標籤值

下表列出了可以使用 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 InsureShipment	String	否	貨件是否應投保。
InsuranceOptions Provider	String	否	首選保險提供商。允許值為 shipsurance、carrier 或 provider。provider 表示貨件由 ShipSurance 或承運人以外的第三方投保。Provider 保險由 ShipStation 外部處理，且不會影響處理標籤的成本。
InternationalOptions Contents	String	否	國際貨件的內容物。允許值為 merchandise、documents、gift、returned_goods 或 sample。
InternationalOptions CustomsItems CustomsItemId	String	否	海關物品的 ItemId 值。如果有多個值，請用逗號分隔（例如，121221,21211,12121）。
InternationalOptions CustomsItems Description	String	否	海關物品的簡短說明。如果有多個物品，請用逗號分隔每個物品的說明（例如，desc1,desc2,desc3）。
InternationalOptions CustomsItems Quantity	String	否	每個海關物品的數量。如果有多個物品，請用逗號分隔每個物品的數量（例如，5,1,4）。
InternationalOptions CustomsItems Value	String	否	每個海關物品的價值（美元）。如果有多個物品，請用逗號分隔每個物品的價值（例如，10,50,100）。
InternationalOptions CustomsItems HarmonizedTariffCode	String	否	每個海關物品的海關協調商品編碼。如果有多個物品，請用逗號分隔每個物品的編碼（例如，10012,40021,30091）。
InternationalOptions CustomsItems CountryOfOrigin	String	否	每個海關物品的兩位 ISO 國家或地區程式碼。如果有多個物品，請用逗號分隔每個物品的程式碼（例如，US,US,US）。
InternationalOptions NonDelivery	String	否	國際貨件的不送達選項。允許值為 return_to_sender 或 treat_as_abandoned。
AdvancedOptions WarehouseId	Integer	否	訂單將從其發貨的倉庫 ID。如果訂單使用履約提供商完成，則沒有附加倉庫，此值為 null。
AdvancedOptions NonMachinable	Boolean	否	訂單是否不可機加工。
AdvancedOptions SaturdayDelivery	Boolean	否	訂單是否在週六送達。
AdvancedOptions ContainsAlcohol	Boolean	否	訂單是否含有酒精。
AdvancedOptions StoreId	Integer	否	與訂單關聯的商店 ID。如果未指定此值，ShipStation 預設使用帳號上的第一個手動商店。
AdvancedOptions CustomField1	String	否	允許將自定義資料與訂單關聯的欄位。
AdvancedOptions CustomField2	String	否	允許將自定義資料與訂單關聯的欄位。
AdvancedOptions CustomField3	String	否	允許將自定義資料與訂單關聯的欄位。
AdvancedOptions Source	String	否	訂單的原始來源或市場。
AdvancedOptions MergedOrSplit	Boolean	否	訂單是否已與另一個訂單合併或從另一個訂單拆分。
AdvancedOptions MergedIds	Integer	否	如果訂單已合併，這是被合併訂單的 orderId 陣列。
AdvancedOptions ParentId	Integer	否	如果訂單從父訂單拆分而來，這是父訂單的 orderId。
AdvancedOptions BillToParty	String	否	為貨件計費的一方。允許值為 my_account、my_other_account、recipient 或 third_party。
AdvancedOptions BillToAccount	String	否	為貨件計費的一方的帳號。
AdvancedOptions BillToPostalCode	String	否	為貨件計費的一方的郵政編碼。
AdvancedOptions BillToCountryCode	String	否	為貨件計費的一方的兩位 ISO 國家或地區程式碼。
AdvancedOptions BillToMyOtherAccount	String	否	如果 AdvancedOptions 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	運輸標籤是否為測試標籤。預設停用。