批量折扣商品管理

批量添加/更新/删除参加批量折扣活动的商品。

相关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 值:VOLUME_DISCOUNT_DATA

相关请求信息

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

请求文件主体

属性 是否必填? 格式 描述
DocumentVersion Decimal 固定值:1.0
MessageType String 固定值:VolumeDiscount
SellerPartNumber String 商品的seller part#。它将用于标识该商品加入/退出该项目。
NeweggItemNumber String 新蛋分配给每个商品的唯一标识符
VolumeActivation String 有效值:
True:添加批量折扣项目的商品或者更新项目中已存在的商品。
False:从批量折扣项目中移除商品
Priority Integer 为批量折扣设置阶梯
Quantity Integer 为当前阶梯的批量折扣设置商品订购数量
SellingPrice Decimal 为当前阶梯的批量折扣设置商品单价
EnableFreeShipping Integer 为当前阶梯的批量折扣设置运输方式。
有效值:
0:Default shipping 默认运费
1:Free shipping 免运费

Schema: VolumeDiscount.xsd

示例:XML,Request

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

<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>VolumeDiscount</MessageType>
    <Message>
        <VolumeDiscountList>
            <ItemVolumeDiscountInfo>
                <SellerPartNumber>Lisa123</SellerPartNumber>
                <NeweggItemNumber>9SIA0060004762</NeweggItemNumber>
                <VolumeActivation>True</VolumeActivation>
                <DiscountSetting>
                    <Tier>
                        <Priority>1</Priority>
                        <Quantity>10</Quantity>
                        <SellingPrice>9999.99</SellingPrice>
                        <EnableFreeShipping>0</EnableFreeShipping>
                    </Tier>
                    <Tier>
                        <Priority>2</Priority>
                        <Quantity>20</Quantity>
                        <SellingPrice>8888.99</SellingPrice>
                        <EnableFreeShipping>0</EnableFreeShipping>
                    </Tier>
                    <Tier>
                        <Priority>3</Priority>
                        <Quantity>30</Quantity>
                        <SellingPrice>7777.99</SellingPrice>
                        <EnableFreeShipping>0</EnableFreeShipping>
                    </Tier>
                </DiscountSetting>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <SellerPartNumber>789</SellerPartNumber>
                <NeweggItemNumber>012</NeweggItemNumber>
                <VolumeActivation>True</VolumeActivation>
                <DiscountSetting>
                    <Tier>
                        <Priority>1</Priority>
                        <Quantity>10</Quantity>
                        <SellingPrice>9999.99</SellingPrice>
                        <EnableFreeShipping>0</EnableFreeShipping>
                    </Tier>
                </DiscountSetting>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <SellerPartNumber>123</SellerPartNumber>
                <VolumeActivation>True</VolumeActivation>
                <DiscountSetting>
                    <Tier>
                        <Priority>1</Priority>
                        <Quantity>10</Quantity>
                        <SellingPrice>9999.99</SellingPrice>
                        <EnableFreeShipping>1</EnableFreeShipping>
                    </Tier>
                </DiscountSetting>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <NeweggItemNumber>456</NeweggItemNumber>
                <VolumeActivation>True</VolumeActivation>
                <DiscountSetting>
                    <Tier>
                        <Priority>1</Priority>
                        <Quantity>10</Quantity>
                        <SellingPrice>9999.99</SellingPrice>
                        <EnableFreeShipping>0</EnableFreeShipping>
                    </Tier>
                </DiscountSetting>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <SellerPartNumber>B0369008</SellerPartNumber>
                <NeweggItemNumber>9SIA0060002417</NeweggItemNumber>
                <VolumeActivation>False</VolumeActivation>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <SellerPartNumber>B0369008</SellerPartNumber>
                <VolumeActivation>False</VolumeActivation>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <NeweggItemNumber>9SIA0060002417</NeweggItemNumber>
                <VolumeActivation>False</VolumeActivation>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <SellerPartNumber>345</SellerPartNumber>
                <VolumeActivation>False</VolumeActivation>
            </ItemVolumeDiscountInfo>
            <ItemVolumeDiscountInfo>
                <NeweggItemNumber>678</NeweggItemNumber>
                <VolumeActivation>False</VolumeActivation>
            </ItemVolumeDiscountInfo>
        </VolumeDiscountList>
    </Message>
</NeweggEnvelope>

示例:Json,Request

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

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "VolumeDiscount",
        "Message": {
            "VolumeDiscountList": {
                "ItemVolumeDiscountInfo": [
                    {
                        "SellerPartNumber": "Lisa123",
                        "NeweggItemNumber": "9SIA0060004762",
                        "VolumeActivation": "True",
                        "DiscountSetting": {
                            "Tier": [
                                {
                                    "Priority": "1",
                                    "Quantity": "10",
                                    "SellingPrice": "9999.99",
                                    "EnableFreeShipping": "0"
                                },
                                {
                                    "Priority": "2",
                                    "Quantity": "20",
                                    "SellingPrice": "8888.99",
                                    "EnableFreeShipping": "0"
                                },
                                {
                                    "Priority": "3",
                                    "Quantity": "30",
                                    "SellingPrice": "7777.99",
                                    "EnableFreeShipping": "0"
                                }
                            ]
                        }
                    },
                    {
                        "SellerPartNumber": "789",
                        "NeweggItemNumber": "012",
                        "VolumeActivation": "True",
                        "DiscountSetting": {
                            "Tier": {
                                "Priority": "1",
                                "Quantity": "10",
                                "SellingPrice": "9999.99",
                                "EnableFreeShipping": "0"
                            }
                        }
                    },
                    {
                        "SellerPartNumber": "123",
                        "VolumeActivation": "True",
                        "DiscountSetting": {
                            "Tier": {
                                "Priority": "1",
                                "Quantity": "10",
                                "SellingPrice": "9999.99",
                                "EnableFreeShipping": "1"
                            }
                        }
                    },
                    {
                        "NeweggItemNumber": "456",
                        "VolumeActivation": "True",
                        "DiscountSetting": {
                            "Tier": {
                                "Priority": "1",
                                "Quantity": "10",
                                "SellingPrice": "9999.99",
                                "EnableFreeShipping": "0"
                            }
                        }
                    },
                    {
                        "SellerPartNumber": "B0369008",
                        "NeweggItemNumber": "9SIA0060002417",
                        "VolumeActivation": "False"
                    },
                    {
                        "SellerPartNumber": "B0369008",
                        "VolumeActivation": "False"
                    },
                    {
                        "NeweggItemNumber": "9SIA0060002417",
                        "VolumeActivation": "False"
                    },
                    {
                        "SellerPartNumber": "345",
                        "VolumeActivation": "False"
                    },
                    {
                        "NeweggItemNumber": "678",
                        "VolumeActivation": "False"
                    }
                ]
            }
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取文件状态操作:
True: 成功
False: 失败
OperationType String 固定值:SubmitFeedResponse
SellerID String 商家编号
RequestType String 值:VOLUME_DISCOUNT_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>VOLUME_DISCOUNT_DATA</RequestType>
                <RequestDate>2/16/2012 12:29:19</RequestDate>
                <RequestStatus>SUBMITTED</RequestStatus>
            </ResponseInfo>
        </ResponseList>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

示例:Json,Response

{
    "IsSuccess": true,
    "OperationType": "SubmitFeedResponse",
    "ResponseBody": {
        "ResponseList": [
            {
                "RequestDate": "2/22/2012 17:24:35",
                "RequestId": "2PQCX3CMQ82MK",
                "RequestStatus": "SUBMITTED",
                "RequestType": "VOLUME_DISCOUNT_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"
    }
]

更新日期:10/15/2018