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	是
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	没有
Email	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", "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." } } ] }