XML 映射: 包装(Package),收件方(Ship To),自定义(Customs)
你需要将 XML Map 端口连接到 ShipStation 端口,以映射包装细节、收件方和其它自定义信息。 在下面的示例中,运输信息显示在 Source 列中,ShipStation 运输标签参数显示在 Destination 列中。
运输标签值
下表列出了可以使用 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 | 运输标签是否为测试标签。默认禁用。 |