商品库存和价格更新

批量更新商品价格信息，物流以及激活商品。

注：一旦某商品被下架，所有有关价格和库存的请求都将被忽略。只有当商品重新被激活，您才可以再次更新价格和库存信息。

相关URL

该功能只适用于NeweggBusiness.com和Newegg.ca：

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 是 值：INVENTORY_AND_PRICE_DATA

相关请求信息

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

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

请求文件主体

属性 是否必填？ 格式 描述
DocumentVersion 是 Decimal 固定值：1.0
MessageType 是 String 固定值：Inventory
Overwrite 否 String 有效值：
Yes：将未列于该文件中的商品全部从网页上下架。
No：如果您不愿意未列于该文件的商品被下架，请一直保持Overwrite选项为NO
SellerPartNumber 是 String 商家为商品定义的唯一的标识符。包含字母和数字的字符串，含空格最多 40个字符
注：一旦商品被创建，该信息是不能修改。
NeweggItemNumber 否 String 新蛋为商品分配的唯一标示符
Currency 否 String 所有价格相关的字段的货币形式。
有效值：
USD：NeweggBusiness.com平台
CAD：Newegg.ca平台
如果没有指定有效值，系统则默认在Newegg.ca使用CAD，在Newegg.com和NeweggBusiness.com使用USD。
MAP 否 Decimal 规定商品的“最低广告价格”。
格式：小数点左边允许最多有10位数，小数点后允许保留2位。请不要使用逗号或美元符号。
如果实际售价低于 MAP， 系统则会要求顾客把这个商品添加到购物车中查看最后价格。
输入“0.00”或者“0”可移除MAP。
如果为空，不会改当前设置。
CheckoutMAP 否 String 不管实际售价和输入的 MAP 是多少，如果 CheckoutMAP 被标记为“True”，那么系统会要求顾客将商品添加到购物车并进入支付页面后才能查看最后价格。
有效值：True或者False
SellingPrice 否 Decimal 商品的实际售价。
格式：小数点左边允许最多有10位数，小数点后允许保留2位。请不要使用逗号或美元符号。
Inventory 是 Integer 默认仓库位置的有效库存：

  • NeweggBusiness.com平台默认使用美国仓库
  • Newegg.ca平台默认使用加拿大仓库
LimitQuantity 否 Integer 每个顾客在48小时内能购买商品的最大数量，最大值为500。
注如果值为:
0：系统将删除现有设置
null: 无更新
FulfillmentOption 否 String 有效值：“Newegg”或“Seller”
Shipping 是 String 商品的运费设置。
有效值：Default或者Free
Default的运费设置是由卖家在新蛋Seller Portal > 账户信息 > 配送设置里的物流费率决定的。
ActivationMark 否 String 有效值：
True：上架商品，该商品会展示在新蛋网页上进行售卖
False：下架商品，该商品会被隐藏/下线，不会在新蛋网页上销售。
如果不填，系统将不会对该商品目前的状态做任何更改。
注：如果新蛋卖家账户状态为“Inactive”，所有商品将会被下线。因此，如果要激活商品，首先该卖家账户必须为“Active”。更多详情，请联系datafeeds@newegg.com

Schema: Inventory.xsd

示例：XML，Request

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

<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>Inventory</MessageType>
    <Overwrite>No</Overwrite>
    <Message>
        <Inventory>
            <Item>
                <SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
                <SellingPrice>127.92</SellingPrice>
                <Inventory>159</Inventory>
                <LimitQuantity>5</LimitQuantity>
                <FulfillmentOption>Seller</FulfillmentOption>
                <Shipping>free</Shipping>
                <ActivationMark>False</ActivationMark>
                <Currency>USD</Currency>
                <NeweggItemNumber>9SIawes01X1339</NeweggItemNumber>
            </Item>
            <Item>
                <SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
                <SellingPrice>119.22</SellingPrice>
                <Inventory>189</Inventory>
                <LimitQuantity>2</LimitQuantity>
                <FulfillmentOption>Seller</FulfillmentOption>
                <Shipping>free</Shipping>
                <ActivationMark>False</ActivationMark>
                <Currency>USD</Currency>
                <NeweggItemNumber>9SIawes01X1338</NeweggItemNumber>
            </Item>
        </Inventory>
    </Message>
</NeweggEnvelope>

示例：Json，Request

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

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "Inventory",
        "Overwrite": "No",
        "Message": {
            "Inventory": {
                "Item": [
                    {
                        "SellerPartNumber": "JACKETEST0921001004",
                        "SellingPrice": "127.92",
                        "Inventory": "159",
                        "LimitQuantity": "5",
                        "FulfillmentOption": "Seller",
                        "Shipping": "free",
                        "ActivationMark": "False",
                        "Currency": "USD",
                        "NeweggItemNumber": "9SIawes01X1339"
                    },
                    {
                        "SellerPartNumber": "JACKETEST0921001003",
                        "SellingPrice": "119.22",
                        "Inventory": "189",
                        "LimitQuantity": "2",
                        "FulfillmentOption": "Seller",
                        "Shipping": "free",
                        "ActivationMark": "False",
                        "Currency": "USD",
                        "NeweggItemNumber": "9SIawes01X1338"
                    }
                ]
            }
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取文件状态操作：
True: 成功
False: 失败
OperationType String 固定值：SubmitFeedResponse
SellerID String 商家编号
RequestType String 值：INVENTORY_AND_PRICE_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>INVENTORY_AND_PRICE_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": "INVENTORY_AND_PRICE_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/28/2020