獲取進貨列表
獲取指定請求編號或某時間段的進貨列表。
相關URL
Newegg.com: https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。
參數
| 名稱 | 是否必填? | 描述 |
| sellerid | 是 | 您在新蛋商城的商家編號 |
相關請求資訊
| HTTP方式 | 是否需要認證? | 請求格式 | 回復格式 | 頻率限制 |
| PUT | 需要 | XML,Json | XML,Json | 500 請求/小時 |
請求文件主體
| 屬性 | 是否必填? | 格式 | 描述 |
| OperationType | 是 | String | 固定值: GetShipmentListRequest |
| PageIndex | 是 | Integer | 當前頁索引,預設為 1 |
| PageSize | 是 | Integer | 一頁中的記錄數 (最大值為每頁 100 條記錄) |
| KeywordsType | 否 | Integer | 有效值: 0. All (Default) 所有(默認) 1. Shipment ID 運單號 2. Newegg Item Number 新蛋商品編號 3. Seller Part Number 商家商品編號 |
| KeywordsValue | 否 | String | 指定類型的關鍵字 |
| Status | 否 | Integer | 有效值: 0. All (Default) 所有(默認) 1. Preparing 準備中 2. Shipped 已發貨 3. Received 已接收 4. Partially Received 部分接收 5. Manually closed 已手動關閉 6. Voide 已作廢 |
| LastUpdateDateFrom | 否 | String | 最新更新時間起始時間(太平洋標準時間)。請參考可接受時間格式 註:最新更新時間起始時間和最新更新時間截止時間都為空時,系統將使用最近 30天代替 |
| LastUpdateDateTo | 否 | String | 最新更新時間截止時間(太平洋標準時間)。請參考可接受時間格式 |
Schema: GetShipmentListRequest.xsd
示例:XML, Request
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetShipmentListRequest</OperationType>
<RequestBody>
<PageInfo>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
</PageInfo>
<KeywordsType>1</KeywordsType>
<KeywordsValue>2740139</KeywordsValue>
<Status>0</Status>
<LastUpdateDateFrom>06/01/2013</LastUpdateDateFrom>
<LastUpdateDateTo>06/07/2013</LastUpdateDateTo>
</RequestBody>
</NeweggAPIRequest>
示例:Json, Request
GET https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetShipmentListRequest",
"RequestBody": {
"PageInfo": {
"PageIndex": 1,
"PageSize": 10
},
"KeywordsType": 1,
"KeywordsValue": "2740139",
"Status": 0,
"LastUpdateDateFrom": "01/01/2013",
"LastUpdateDateTo": "07/07/2013"
}
}
回覆文件主體
| 屬性 | 格式 | 描述 |
| IsSuccess | String | 用來確認獲取請求狀態的操作是否成功 True:成功 False:失敗 |
| OperationType | String | 固定值:GetShipmentListResponse |
| SellerID | String | 商家編號 |
| ShipmentID | String | 運單號 |
| Status | String | 運單狀態: Creating – shipment is creating at backend. 創建中—運單正在後台創建 Preparing – user can work on shipment. 準備中—用戶可進行貨運 Ready to ship – shipment is ready to ship. 準備發貨—運單準備發貨 Shipped – shipment has been shipped out. 已發貨—運單已運出 Partially Received – warehouse received a part of shipment. 部分接收—倉庫已接收部分運單商品 Received – warehouse received whole shipment already. 全部接收—倉庫已接收全部運單商品 Void – shipment has been voided. 已作廢—運單已作廢 Manually closed – shipment is manually closed which is over 3 month and still unreceived. 已手動關閉—超過3個月並仍未收到貨運單已手動關閉 |
| CreateDate | String | 運單創建時間 |
| LastEditDate | String | 最後編輯時間 |
| ShipFrom | String | 發貨人。預設值:商家店鋪名 |
| ShipToWarehouseCode | String | 當前可用美國新蛋倉庫代碼 06: Tennessee Bulk Warehouse 田納西大型倉庫 07: California Small Warehouse 加利福尼亞小型倉庫 08: California Bulk Item Warehouse 加利福尼亞大型倉庫 10: New Jersey Bulk Warehouse 新澤西大型倉庫 14: New Jersey Small Warehouse 新澤西小型倉庫 |
| ShipToAddress1 | String | 收貨地址 1 |
| ShipToAddress2 | String | 收貨地址 2 |
| ShipToCityName | String | 收貨地所在城市 |
| ShipToStateCode | String | 收貨州代碼 |
| ShipToZipCode | String | 收貨地郵編 |
| ShipToCountryCode | String | 收貨國家代碼 |
| ShippingMethodCode | Integer | 此運單指定的運送方式 1.小包裹運送(單個盒子:包括單個盒子的包裝單位和單獨的標籤) 2.拼箱裝載(零擔,託盤,裝運至少 150 磅:裝運時將小包裹合併在貨盤上) |
| ShippingCarrierCode | Integer | 此運單運輸商,如果 ShippingMethodCode = 1: 101.DHL 102.FedEx 103.UPS 104.USPS 105. 新蛋合作運輸商 – UPS 99.Other 如果 ShippingMethodCode = 2: 99.Other |
| OtherCarrierName | String | 如果 ShippingCarrierCode = 99,填寫你所提供的運輸商名稱 |
| TrackingNumber | String | 包裹的追蹤號碼 |
| PackageWeight | Decimal | 包裹重量 |
| PackageLength | Decimal | 包裹長度 |
| PackageHeight | Decimal | 包裹高度 |
| PackageWidth | Decimal | 包裹寬度 |
| SellerPartNumber | String | 商家商品編號 |
| Quantity | Integer | 商品數量 |
| NumberofPackage | Integer | 包裹標籤號 |
Schema: GetShipmentListResponse.xsd
示例:XML, Request
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetShipmentListResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ShipmentList>
<Shipment>
<ShipmentID>2740139</ShipmentID>
<Status>Ready to ship</Status>
<CreateDate>06/06/2013 17:02:31</CreateDate>
<LastEditDate>06/07/2013 11:31:00</LastEditDate>
<ShipFrom>Test_MKTPLS'K_</ShipFrom>
<ShipToWarehouseCode>14</ShipToWarehouseCode>
<ShipToAddress1>45 Patrick Ave., Dock 9-17</ShipToAddress1>
<ShipToCityName>Edison</ShipToCityName>
<ShipToStateCode>NJ</ShipToStateCode>
<ShipToZipCode>08837</ShipToZipCode>
<ShipToCountryCode>USA</ShipToCountryCode>
<ShippingMethodCode>1</ShippingMethodCode>
<ShippingCarrierCode>99</ShippingCarrierCode>
<OtherCarrierName>1</OtherCarrierName>
<PackageList>
<Package>
<TrackingNumber>1</TrackingNumber>
<PackageWeight>0</PackageWeight>
<PackageLength>0</PackageLength>
<PackageHeight>0</PackageHeight>
<PackageWidth>0</PackageWidth>
</Package>
</PackageList>
<ItemList>
<Item>
<SellerPartNumber>Ss0120121228065937386</SellerPartNumber>
<Quantity>36</Quantity>
<NumberofPackage>2</NumberofPackage>
</Item>
<Item>
<SellerPartNumber>SS0120130516683100755</SellerPartNumber>
<Quantity>9</Quantity>
<NumberofPackage>3</NumberofPackage>
</Item>
</ItemList>
</Shipment>
</ShipmentList>
</ResponseBody>
</NeweggAPIResponse>
示例:Json, Request
{
"IsSuccess": true,
"OperationType": "GetShipmentListResponse",
"SellerID": "A006",
"ResponseBody": {
"ShipmentList": [
{
"ShipmentID": "2740139",
"Status": "Ready to ship",
"CreateDate": "06/06/2013 17:02:31",
"LastEditDate": "06/07/2013 11:31:00",
"ShipFrom": "Test_MKTPLS'K_",
"ShipToWarehouseCode": "14",
"ShipToAddress1": "45 Patrick Ave., Dock 9-17",
"ShipToCityName": "Edison",
"ShipToStateCode": "NJ",
"ShipToZipCode": "08837",
"ShipToCountryCode": "USA",
"ShippingMethodCode": 0,
"ShippingCarrierCode": 99,
"OtherCarrierName": "1",
"PackageList": [
{
"TrackingNumber": "1",
"PackageWeight": 0,
"PackageLength": 0,
"PackageHeight": 0,
"PackageWidth": 0
}
],
"ItemList": [
{
"SellerPartNumber": "Ss0120121228065937386",
"Quantity": 36,
"NumberofPackage": 2
},
{
"SellerPartNumber": "SS0120130516683100755",
"Quantity": 9,
"NumberofPackage": 3
}
]
}
]
}
}
請求失敗錯誤資訊
常規HTTP錯誤回應,請參考回覆失敗錯誤代碼清單。
更新日期:10/15/2018