3.2 修改货件
描述
本节将向您介绍如何修改您创建的货件.
Url : https://apiv2.unixus.com.my/shipment/v2/Modify
Method : POST
Content-Type: application/json
Accept-Language: en
Authorization: Bearer {access_token}
请求
数据结构
ModifyShipments
| 领域 | 类型 | 强制性 | 备注 |
|---|---|---|---|
| Shipments | ModifyShipmentsDetails[] | 是 | 参考 ModifyShipmentsDetails |
ModifyShipmentsDetails
| 领域 | 类型 | 强制性 | 备注 |
|---|---|---|---|
| Shipper | PersonInfo | 是 | 参考 PersonInfo |
| Consignee | PersonInfo | 是 | 参考 PersonInfo |
| Items | ItemInfo[] | 是 | 参考 ItemInfo |
| Packages | PackageInfo[] | 是 | 参考 Packages |
| ShipmentDate | DateTime | 是 | Example: 2018-07-01T00:00:00+08:00 |
| HawbNo | String | 是 | |
| TOSMode | String | 是 | 参考 TOS Mode |
| ReferenceNo | String | 是 | |
| ReferenceSource | String | 没有 | |
| PackageType | Enum | 是 | 参考 PackageType |
| WeightType | Enum | 是 | 参考 WeightType |
| CurrencyCode | String | 是 | |
| CODValue | Numeric | 没有/是 | 只用于CODType TosMode. 必填如果CODCurrency 已有数据 |
| CODCurrency | String | 没有/是 | 只用于CODType TosMode. 必填如果CODValue 已有数据 |
| InsuranceValue | Numeric | 没有 | |
| InsuranceCurrency | String | 没有 | |
| Remarks | String | 没有 |
PersonInfo
| 领域 | 类型 | 强制性 | 描述 |
|---|---|---|---|
| Name | String | 没有 | |
| ContactPerson | String | 是 | |
| IdentityNo | String | 没有 | |
| Address1 | String | 是 | |
| Address2 | String | 没有 | |
| Address3 | String | 没有 | |
| Postcode | String | 是 | |
| City | String | 是 | |
| State | String | 是 | |
| CountryCode | String | 是 | |
| StationCode | String | 没有 | |
| Phone1 | String | 是 | |
| Phone2 | String | 没有 | |
| MobilePhone | String | 没有 | |
| Fax | String | 没有 | |
| String | 没有 | ||
| Url | String | 没有 |
ItemInfo
| 领域 | 类型 | 强制性 | 备注 |
|---|---|---|---|
| Description | String | 是 | |
| Quantity | Integer | 是 | |
| UnitValue | Numeric | 是 | |
| HSCode | String | 没有 | |
| SKU | String | 没有 | |
| Url | String | 没有 |
PackageInfo
| 领域 | 类型 | 强制性 | 描述 |
|---|---|---|---|
| PackageReference | String | 是 | |
| Length | Numeric | 是 | CM的长度 |
| Width | Numeric | 是 | CM的宽度 |
| Height | Numeric | 是 | CM的高度 |
| ActualWeight | Numeric | 是 | 实际重量以KG计 |
TOS Mode
TOS代表服务类型。装运信息中TOS模式的值基于收货人国家/地区代码。以下代码是您如何分配TOSMode值的示例。如果您遇到无效TOS错误，请联系我们的客户支持.
public string GetTOSMode(string consigneeCountry) {
switch (consigneeCountry) {
case "MY":
return "MY-E-EXPRESS";
case "TH":
return "TH-E-EXPRESS";
case "HK":
return "HK-E-EXPRESS";
case "SG":
return "SG-E-EXPRESS";
case "ID":
return "ID-E-EXPRESS";
case "CN":
return "CN-E-EXPRESS";
default:
// error
}
}
PackageType and WeightType
// If in doubt, choose SPX
public enum PackageType {
DOX,
SPX,
SPX_L,
SPX_P,
SPX_S
}
public enum WeightType {
KG,
LBS
}
Sample:
{
"Shipments": [
{
"Shipper": {
"Name": "Unixus",
"ContactPerson": "IT Dept.",
"Address1": "46-02 JALAN TUN ABDUL RAZAK,",
"Address2": "SUSUR 1,",
"Address3": "",
"Postcode": "80000",
"City": "JOHOR BHARU",
"State": "JOHOR",
"CountryCode": "MY",
"Phone1": "607-2222668",
"Phone2": "",
"MobilePhone": "",
"Fax": "",
"Email": "[email protected]",
"Url": ""
},
"Consignee": {
"Name": "LWE (AU) Ltd.",
"ContactPerson": "Mr. Ng",
"Address1": "Test Address 1",
"Address2": "Test Address 2",
"Address3": "",
"PostCode": "70000",
"City": "JOHOR BHARU",
"State": "JOHOR",
"CountryCode": "MY",
"StationCode": "",
"Phone1": "60-7-2222668",
"Phone2": "",
"MobilePhone": "",
"Fax": "",
"Email": "[email protected]",
"Url": "http://www.lwe.com.hk"
},
"Items": [
{
"Description": "LADIES SHOES",
"Quantity": 3,
"UnitValue": 15,
"HSCode": "HSCode",
"SKU": "SKU",
"Url": "url"
}
],
"Packages": [
{
"PackageReference": "PKG01",
"Length": 10.5,
"Width": 20.2,
"Height": 30.1,
"ActualWeight": 10.7
}
],
"HawbNo": "458040010409730",
"PackageType": "SPX",
"WeightType": "kg",
"ShipmentDate": "2018-07-01T00:00:00+08:00",
"ReferenceNo": "123456",
"ReferenceAgent": "",
"TOSMode": "MY-E-EXPRESS",
"CurrencyCode": "MYR",
"CODValue": 0,
"CODCurrency": ""
"InsuranceValue": 10.0,
"InsuranceCurrency": "MYR"
"Remarks": "The shipment easy to broke, please becareful."
}
]
}
Response
Sample
{
"Summary": {
"Total": 1,
"Success": 1,
"Failed": 0
},
"ShipmentsResponse": [
{
"IsSuccess": true,
"ShipmentDetails": {
"Shipper": {
"Name": "Unixus",
"ContactPerson": "IT Dept.",
"Address1": "46-02 JALAN TUN ABDUL RAZAK,",
"Address2": "SUSUR 1,",
"Postcode": "80000",
"City": "JOHOR BHARU",
"State": "JOHOR",
"CountryCode": "MY",
"Phone1": "607-2222668",
"Email": "[email protected]"
},
"Consignee": {
"Name": "LWE (AU) Ltd.",
"ContactPerson": "Mr. Ng",
"Address1": "Test Address 1",
"Address2": "Test Address 2",
"Postcode": "70000",
"City": "JOHOR BHARU",
"State": "JOHOR",
"CountryCode": "MY",
"Phone1": "60-7-2222668",
"Email": "[email protected]",
"Url": "http://www.lwe.com.hk"
},
"Items": [
{
"Description": "LADIES SHOES",
"Quantity": 3,
"UnitValue": 15.0,
"HSCode": "HSCode",
"SKU": "SKU",
"Url": "url"
}
],
"Packages": [
{
"PackageReference": "PKG01",
"Length": 10.5,
"Width": 20.2,
"Height": 30.1,
"ActualWeight": 10.7
}
],
"ShipmentsReference": [
{
"CarrierName": "POS-LAJU",
"ReferenceNo": "458040010409752"
}
],
"HawbNo": "458040010409752",
"ReferenceNo": "123456",
"TOSMode": "MY-E-EXPRESS",
"CurrencyCode": "MYR",
"PackageType": "SPX",
"WeightType": "KG",
"ShipmentDate": "2018-07-01T00:00:00+08:00",
"Remark": "The shipment easy to broke, please becareful.",
"InsuranceValue": 10.0,
"InsuranceCurrency": "MYR"
}
}
]
}