商品价格保护设置

为商家提供价格保护选项，可设置规则来预防错误的定价行为。

相关URL

Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType} 
Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号
RequestType 是 值：ITEM_SAFEGUARD_SETTING_DATA

相关请求信息

HTTP方式 是否需要认证？ 请求格式 回复格式 频率限制
POST 需要 XML,Json XML,Json 1000 请求/小时

注：每个文件最多可有10,000 条请求记录。每小时最多30,000 条记录。

请求文件主体

属性 是否必填？ 格式 描述
DocumentVersion 是 Decimal 固定值：1.0
MessageType 是 String 固定值： ItemSafeguardSetting
SellerPartNumber 如果没有提供NeweggItem#，该项必填 String 商家为商品分配的编码。
NeweggItemNumber 如果没有提供seller part#，该项必填 String 新蛋为商家分配的编码。
LowestSellingPrice 是 Decimal 商品最低可允许售价
HighestSellingPrice 是 Decimal 商品最高可允许售价

Schema: ItemSafeguardSetting.xsd

示例：XML，Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_SAFEGUARD_SETTING_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
        <!--The identifier for the very of current feed; assigned by Newegg-->
    </Header>
    <MessageType>ItemSafeguardSetting</MessageType>
    <Message>
        <ItemSafeguard>
            <Item>
                <SellerPartNumber>a006-test-001</SellerPartNumber>
                <!--A seller-defined unique identifier for an item. An alphanumeric string, max 40 characters including space-->
                <NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
                <!--Newegg’s unique identifier for an item-->
                <LowestSellingPrice>23.00</LowestSellingPrice>
                <HighestSellingPrice>26.00</HighestSellingPrice>
            </Item>
        </ItemSafeguard>
    </Message>
</NeweggEnvelope>

示例：Json，Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_SAFEGUARD_SETTING_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "ItemSafeguardSetting",
        "Message": {
            "ItemSafeguard": {
                "Item": {
                    "SellerPartNumber": "a006-test-001",
                    "NeweggItemNumber": "9SIAWE50008504",
                    "LowestSellingPrice": "23.00",
                    "HighestSellingPrice": "26.00"
                }
            }
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取文件状态操作：
True: 成功
False: 失败
OperationType String 固定值：SubmitFeedResponse
SellerID String 商家编号
RequestType String 值：ITEM_SAFEGUARD_SETTING_DATA
RequestDate String 文件提交的时间（太平洋标准时间）
RequestStatus String 文件提交的状态：
SUBMITTED 已提交
Memo String 附加信息

Schema: SubmitFeedResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>SubmitFeedResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <ResponseList>
            <ResponseInfo>
                <RequestId>2291326430</RequestId>
                <RequestType>ITEM_SAFEGUARD_SETTING_DATA</RequestType>
                <RequestDate>2/16/2020 12:29:19</RequestDate>
                <RequestStatus>SUBMITTED</RequestStatus>
            </ResponseInfo>
        </ResponseList>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

示例：Json，Response

{
    "IsSuccess": true,
    "OperationType": "SubmitFeedResponse",
    "ResponseBody": {
        "ResponseList": [
            {
                "RequestDate": "2/22/2020 17:24:35",
                "RequestId": "2PQCX3CMQ82MK",
                "RequestStatus": "SUBMITTED",
                "RequestType": "ITEM_SAFEGUARD_SETTING_DATA"
            }
        ]
    },
    "SellerID": "A006"
}

请求失败错误信息

常规HTTP错误回复，请参考回复失败错误代码列表。

错误代码 描述
DF003 The MaxCount (maximum request records) CANNOT be over 30000.

最大请求数记录不能超过30000
DF004 Unfortunately, we are unable to process your request at this time. We apologize for the inconvenience. Please try again later.

很抱歉，目前我们无法处理您的请求。请您稍后再试。
DF011 Your data feed request will not be processed during the scheduled data feed processing restriction from [{begin timestamp: hh:mm:ss, MM/DD/YYYY}] to [{end timestamp: hh:mm:ss, MM/DD/YYYY}]). Please contact datafeeds@newegg.com if you have any question or concern. Thank you for your patience.

在已定的数据文件处理限制期内，从[{begin timestamp: hh:mm:ss, MM/DD/YYYY}] 到 [{end timestamp: hh:mm:ss, MM/DD/YYYY}]，您的数据请求将无法被处理。如您有任何问题或者疑问，请联系datafeeds@newegg.com。 感谢您的耐心等待。

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>DF003</Code>
        <Message>The MaxCount (maximum request records) CANNOT be over 30000</Message>
    </Error>
</Errors>

示例：Json，Response

[
    {
        "Code": "DF003",
        "Message": "The MaxCount (maximum request records) CANNOT be over 30000"
    }
]

更新日期：08/31/2020