批量搜索海外仓包裹
通过此接口可以使用客单号、处理号或者跟踪号批量搜索包裹。
请求规格说明
请求方式
GET api/packages?processCodes={processCodes}&referenceIds={referenceIds}&trackingNumbers={trackingNumbers}
processCodes 为我司处理号，referenceIds为您的客单号，trackingNumbers为包裹跟踪号。批量查询多个值，用英文逗号(,)拼接。
系统按照processCodes、referenceIds、trackingNumbers的先后顺序查找。在优先级较高的参数有传值的情况下，优先级低的参数的值将被忽略。
返回数据格式说明
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| Elements | Package[] | 包裹信息，请参导按查询包裹接口中返回数据格式说明
注： 此接口不会返回包裹的SKU明细 |
|
| PageNumber | int | 页码 | |
| PageSize | int | 分页大小 | |
| TotalItemCount | int | 符合条件的总数目 |
返回数据格式示例
下面为请求 api/packages?referenceIds=REF160808002,REF160808001 接口返回的示例数据。
{
"Data": {
"Elements": [
{
"ProcessCode": "DEVGNA0000000126YQ",
"ReferenceId": "REF160808002",
"FinalTrackingNumber": "JD0002255030250928",
"TrackingNumberAllocation": {
"Code": "Success",
"Message": ""
},
"Status": "Cancelled",
"WarehouseCode": "BM",
"ShippingProductId": "UKWHS_TEST",
"IsRegister": true,
"ShippingAddress": {
"Company": "",
"Street1": "Baker Street 221A",
"Street2": "",
"Street3": "",
"District": "",
"City": "London",
"Province": "",
"Country": "United Kingdom",
"CountryCode": "GB",
"Postcode": "NW1 6XE",
"Contacter": "Sherlock Holmes",
"Tel": "07404202252",
"Email": ""
},
"WeightInKg": 0.32,
"Volume": {
"Length": 10,
"Width": 5,
"Height": 4,
"Unit": "CM"
},
"CheckWeightInKg": null,
"CheckVolume": null,
"VolumeWeightInKg": 0.03333,
"FeeWeightInKg": 0.32,
"DeclaredNameEn": "outdoor packbag & test 04",
"DeclaredValue": {
"Code": "USD",
"Value": 20.32
},
"WithBatteryType": "WithBattery",
"ShipAvailability": {
"Status": "Available",
"IsRemoteArea": false,
"Error": null
},
"PackFailure": null,
"CreateOn": "2016-08-08T04:19:15Z",
"ConfirmOn": "2016-08-08T05:27:43Z",
"PackOn": null,
"ShipOn": null,
"Cancellation": {
"Status": "Accepted",
"RequestOn": "2016-08-08T07:31:59Z",
"ResponseOn": "2016-08-08T07:33:14Z",
"Message": ""
}
},
{
"ProcessCode": "DEVGNA0000000124YQ",
"ReferenceId": "REF160808001",
"FinalTrackingNumber": "JD0002255030250717",
"TrackingNumberAllocation": {
"Code": "Success",
"Message": ""
},
"Status": "Confirmed",
"WarehouseCode": "BM",
"ShippingProductId": "UKWHS_TEST",
"IsRegister": true,
"ShippingAddress": {
"Company": "",
"Street1": "Baker Street 221B",
"Street2": "",
"Street3": "",
"District": "",
"City": "London",
"Province": "",
"Country": "United Kingdom",
"CountryCode": "GB",
"Postcode": "NW1 6XE",
"Contacter": "Sherlock Holmes",
"Tel": "07404202252",
"Email": ""
},
"WeightInKg": 0.48,
"Volume": {
"Length": 10,
"Width": 6,
"Height": 5,
"Unit": "CM"
},
"CheckWeightInKg": null,
"CheckVolume": null,
"VolumeWeightInKg": 0.05,
"FeeWeightInKg": 0.48,
"DeclaredNameEn": "outdoor packbag & test 04",
"DeclaredValue": {
"Code": "USD",
"Value": 32.32
},
"WithBatteryType": "WithBattery",
"ShipAvailability": {
"Status": "Available",
"IsRemoteArea": false,
"Error": null
},
"PackFailure": null,
"CreateOn": "2016-08-08T04:18:51Z",
"ConfirmOn": "2016-08-08T04:18:51Z",
"PackOn": null,
"ShipOn": null,
"Cancellation": {
"Status": "Requested",
"RequestOn": "2016-08-08T04:35:19Z",
"ResponseOn": null,
"Message": ""
}
}
],
"PageNumber": 1,
"PageSize": 2,
"TotalItemCount": 2
},
"Succeeded": true,
"Error": null
}