獲取進貨計畫建議

通過獲取創建進貨計畫的建議來確定您打算發往新蛋倉庫的商品。通過提交該請求，新蛋將基於新蛋商業智慧提供更為合理的運送安排。這將使您的商品在各倉庫分配得更加合理從而在配送上更有競爭力。

相關URL

Newegg.com: https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/plansuggestion?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/sbnmgmt/inboundshipment/plansuggestion?sellerid={sellerid}

註：請確保您的請求URL全都是小寫（除Seller ID）並且不能包含任何空格或者分行符號。

參數

名稱 是否必填？ 描述
sellerid 是 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證？ 請求格式 回復格式 頻率限制
PUT 需要 XML,Json XML,Json 1000 請求/分鐘/商家

請求文件主體

屬性 是否必填？ 格式 描述
OperationType 是 String 固定值：GetPlanSuggestionRequest
SellerPartNumber 是 String 商家自訂的商品編號
PlannedQuantity 是 Integer 計畫發到新蛋倉庫的商品總數
QuantityPerCarton 否 Integer 每個包裝箱的商品數
如果提供有效值，我們將返回包裝箱的建議數量供你參考

Schema: GetInboundShipmentPlanRequest.xsd

示例：XML, Request

PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/plansuggestion?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest>
    <OperationType>GetPlanSuggestionRequest</OperationType>
    <RequestBody>
        <PlanSuggestion>
            <ItemList>
                <Item>
                    <SellerPartNumber>SS0120130516683100755</SellerPartNumber>
                    <PlannedQuantity>20</PlannedQuantity>
                    <QuantityPerCarton>10</QuantityPerCarton>
                </Item>
                <Item>
                    <SellerPartNumber>nz-tst-123</SellerPartNumber>
                    <PlannedQuantity>30</PlannedQuantity>
                    <QuantityPerCarton>10</QuantityPerCarton>
                </Item>
            </ItemList>
        </PlanSuggestion>
    </RequestBody>
</NeweggAPIRequest>

示例：Json, Request

PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/plansuggestion?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "GetPlanSuggestionRequest",
    "RequestBody": {
        "PlanSuggestion": {
            "ItemList": {
                "Item": [
                    {
                        "SellerPartNumber": "SS0120130516683100755",
                        "PlannedQuantity": 20,
                        "QuantityPerCarton": 10
                    },
                    {
                        "SellerPartNumber": "nz-tst-123",
                        "PlannedQuantity": 32,
                        "QuantityPerCarton": 10
                    }
                ]
            }
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 用於獲取資料狀態的操作
True：成功
False：失敗
OperationType String 固定值：GetPlanSuggestionResponse
SellerID 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 新蛋倉庫國家代碼
SellerPartNumber String 商家自訂的商品編號
NeweggItemNumber String 新蛋分配的商品編號
Quantity Integer 建議商品數
NumberofCartons Integer 所需要的包裝箱總數

Schema: GetInboundShipmentPlanResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetPlanSuggestionResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <ShipmentList>
            <Shipment>
                <ShipToWarehouseCode>07</ShipToWarehouseCode>
                <ShipToAddress1>17708 Rowland St.</ShipToAddress1>
                <ShipToCityName>City of Industry</ShipToCityName>
                <ShipToStateCode>CA</ShipToStateCode>
                <ShipToZipCode>91748</ShipToZipCode>
                <ShipToCountryCode>USA</ShipToCountryCode>
                <ItemList>
                    <Item>
                        <SellerPartNumber>nz-tst-123</SellerPartNumber>
                        <NeweggItemNumber>9SIA0060BB9157</NeweggItemNumber>
                        <Quantity>10</Quantity>
                        <NumberofCartons>1</NumberofCartons>
                    </Item>
                </ItemList>
            </Shipment>
            <Shipment>
                <ShipToWarehouseCode>12</ShipToWarehouseCode>
                <ShipToAddress1>4995 Citation Dr Suite 101,Dock 1-10</ShipToAddress1>
                <ShipToCityName>Memphis</ShipToCityName>
                <ShipToStateCode>TN</ShipToStateCode>
                <ShipToZipCode>38118</ShipToZipCode>
                <ShipToCountryCode>USA</ShipToCountryCode>
                <ItemList>
                    <Item>
                        <SellerPartNumber>SS0120130516683100755</SellerPartNumber>
                        <NeweggItemNumber>9SIA0060S01359</NeweggItemNumber>
                        <Quantity>10</Quantity>
                        <NumberofCartons>1</NumberofCartons>
                    </Item>
                    <Item>
                        <SellerPartNumber>nz-tst-123</SellerPartNumber>
                        <NeweggItemNumber>9SIA0060BB9157</NeweggItemNumber>
                        <Quantity>10</Quantity>
                        <NumberofCartons>1</NumberofCartons>
                    </Item>
                </ItemList>
            </Shipment>
            <Shipment>
                <ShipToWarehouseCode>14</ShipToWarehouseCode>
                <ShipToAddress1>45 Patrick Ave., Dock 9-17</ShipToAddress1>
                <ShipToCityName>Edison</ShipToCityName>
                <ShipToStateCode>NJ</ShipToStateCode>
                <ShipToZipCode>08837</ShipToZipCode>
                <ShipToCountryCode>USA</ShipToCountryCode>
                <ItemList>
                    <Item>
                        <SellerPartNumber>SS0120130516683100755</SellerPartNumber>
                        <NeweggItemNumber>9SIA0060S01359</NeweggItemNumber>
                        <Quantity>10</Quantity>
                        <NumberofCartons>1</NumberofCartons>
                    </Item>
                    <Item>
                        <SellerPartNumber>nz-tst-123</SellerPartNumber>
                        <NeweggItemNumber>9SIA0060BB9157</NeweggItemNumber>
                        <Quantity>10</Quantity>
                        <NumberofCartons>1</NumberofCartons>
                    </Item>
                </ItemList>
            </Shipment>
        </ShipmentList>
    </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
    "IsSuccess": true,
    "OperationType": "GetPlanSuggestionResponse",
    "SellerID": "A006",
    "ResponseBody": {
        "ShipmentList": [
            {
                "ShipToWarehouseCode": "07",
                "ShipToAddress1": "17708 Rowland St.",
                "ShipToCityName": "City of Industry",
                "ShipToStateCode": "CA",
                "ShipToZipCode": "91748",
                "ShipToCountryCode": "USA",
                "ItemList": [
                    {
                        "SellerPartNumber": "SS0120130516683100755",
                        "NeweggItemNumber": "9SIA0060S01359",
                        "Quantity": 0,
                        "NumberofCartons": 0
                    },
                    {
                        "SellerPartNumber": "nz-tst-123",
                        "NeweggItemNumber": "9SIA0060BB9157",
                        "Quantity": 13
                    }
                ]
            },
            {
                "ShipToWarehouseCode": "12",
                "ShipToAddress1": "4995 Citation Dr Suite 101,Dock 1-10",
                "ShipToCityName": "Memphis",
                "ShipToStateCode": "TN",
                "ShipToZipCode": "38118",
                "ShipToCountryCode": "USA",
                "ItemList": [
                    {
                        "SellerPartNumber": "SS0120130516683100755",
                        "NeweggItemNumber": "9SIA0060S01359",
                        "Quantity": 10,
                        "NumberofCartons": 1
                    },
                    {
                        "SellerPartNumber": "nz-tst-123",
                        "NeweggItemNumber": "9SIA0060BB9157",
                        "Quantity": 11
                    }
                ]
            },
            {
                "ShipToWarehouseCode": "14",
                "ShipToAddress1": "45 Patrick Ave., Dock 9-17",
                "ShipToCityName": "Edison",
                "ShipToStateCode": "NJ",
                "ShipToZipCode": "08837",
                "ShipToCountryCode": "USA",
                "ItemList": [
                    {
                        "SellerPartNumber": "SS0120130516683100755",
                        "NeweggItemNumber": "9SIA0060S01359",
                        "Quantity": 10,
                        "NumberofCartons": 1
                    },
                    {
                        "SellerPartNumber": "nz-tst-123",
                        "NeweggItemNumber": "9SIA0060BB9157",
                        "Quantity": 8
                    }
                ]
            }
        ]
    }
}

請求失敗錯誤資訊

常規HTTP錯誤回應，請參考回覆失敗錯誤代碼清單。

錯誤編碼 描述
SBN002 Invalid Seller Part # :{sellerpart#}.
無效的 Seller Part # :{sellerpart#}
SBN003 Seller Part # :{sellerpart#} is marked as Shipped by Seller now, please convert this item to Shipped by Newegg and try again.
Seller Part # :{sellerpart#}當前被標記為商家配送，請將該商品轉換為新蛋配送後再嘗試。

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>SBN002</Code>
        <Message>Invalid Seller Part # :XYZ.</Message>
    </Error>
</Errors>

示例: Json, Response

[
    {
        "Code": "SBN002",
        "Message": "Invalid Seller Part # :XYZ."
    }
]

更新日期：10/15/2018