獲取進貨列表

獲取指定請求編號或某時間段的進貨列表。

相關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