获取入货计划建议

通过获取入货计划建议来确定您打算发往新蛋仓库的商品。通过提交该请求，新蛋将基于新蛋商业智能为您提供更为合理的运送安排。这将使您的商品在各仓库分配得更加合理从而在配送上更有竞争力。

相关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，Response

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，Request

<?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，Request

<?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