3.1 创建货件

描述

本节将向您展示如何使用此API创建货件。

开发/测试环境   : https://sandbox-apiv2.unixus.com.my/shipment/v2/Create
生产/正式环境   : https://apiv2.unixus.com.my/shipment/v2/Create
Method         : POST
Content-Type   : application/json
Accept-Language: en
Authorization  : Bearer {access_token}

请求

数据结构

CreateShipments

字段	类型	必填	备注
Shipments	CreateShipmentDetails[]	是	参考 CreateShipmentDetails

CreateShipmentDetails

字段	类型	必填	备注
Shipper	PersonInfo	是	参考 PersonInfo
Consignee	PersonInfo	是	参考 PersonInfo
Items	ItemInfo[]	是	参考 ItemInfo
Packages	PackageInfo[]	是	参考 Packages
ShipmentDate	DateTime	是	Example: `2018-07-01T00:00:00+08:00`
TOSMode	String	是	参考 TOS Mode
ProfitCentreCode	String	否
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

TOSMode代表服务类型。装运信息中TOSMode的值基于收货人国家/地区代码。以下代码是您如何分配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": " DEMO ACCOUNT", "ContactPerson": "DEMO ACCOUNT", "Address1": "Block C, 3A01 & 3A02,", "Address2": "Level 3A, Kelana Square,", "Address3": "No.17, Jalan SS7/26", "Postcode": "47301", "City": "Petaling Jaya", "State": "Selangor", "CountryCode": "MY", "Phone1": "+60378038830" }, "Consignee": { "ContactPerson": "LWE (AU) Ltd.", "Address1": "Test Address 1", "Address2": "Test Address 2", "Postcode": "70000", "City": "JOHOR BHARU", "State": "SELANGOR", "CountryCode": "MY", "Phone1": "03-8888888" }, "Items": [ { "Description": "item1", "Quantity": 10, "UnitValue": 20.0, "HSCode": "30", "SKU": "40", "Url": "50" } ], "Packages": [ { "PackageReference": "pkg1", "Length": 10.0, "Width": 20.0, "Height": 30.0, "ActualWeight": 40.0 } ], "PackageType": "SPX", "WeightType": "KG", "ShipmentDate": "2018-07-01T00:00:00+08:00", "TOSMode": "MY-E-EXPRESS", "CurrencyCode": "MYR" } ] }

响应

样品

{ "Summary": { "Total": 1, "Success": 1, "Failed": 0 }, "ShipmentsResponse": [ { "IsSuccess": true, "ShipmentDetails": { "Shipper": { "Name": " DEMO ACCOUNT", "ContactPerson": "DEMO ACCOUNT", "Address1": "Block C, 3A01 & 3A02,", "Address2": "Level 3A, Kelana Square,", "Address3": "No.17, Jalan SS7/26", "Postcode": "47301", "City": "Petaling Jaya", "State": "Selangor", "CountryCode": "MY", "Phone1": "+60378038830" }, "Consignee": { "ContactPerson": "LWE (AU) Ltd.", "Address1": "Test Address 1", "Address2": "Test Address 2", "Postcode": "70000", "City": "JOHOR BHARU", "State": "SELANGOR", "CountryCode": "MY", "Phone1": "03-8888888" }, "Items": [ { "Description": "item1", "Quantity": 10, "UnitValue": 20.0, "HSCode": "30", "SKU": "40", "Url": "50" } ], "Packages": [ { "PackageReference": "pkg1", "Length": 10.0, "Width": 20.0, "Height": 30.0, "ActualWeight": 40.0， "ChildHawb": "458040010409726PC001" } ], "ShipmentsReference": [ { "CarrierName": "POS-LAJU", "ReferenceNo": "458040010409726" } ], "HawbNo": "458040010409726", "TOSMode": "MY-E-EXPRESS", "CurrencyCode": "MYR", "PackageType": "SPX", "WeightType": "KG", "ShipmentDate": "2018-07-01T00:00:00+08:00" } } ] }