商品库存更新

批量更新商品在当地仓库或者其他区域仓库的库存信息,一个区域只能有一个仓库。

注:卖家的仓库设置可在新蛋Seller Portal > 账户信息 > 配送设置中进行管理。

相关URL

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

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

参数

名称 是否必填? 描述
sellerid 您在新蛋商城的商家编号
RequestType 值:INVENTORY_DATA

相关请求信息

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

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

请求文件主体

属性 是否必填? 格式 描述
DocumentVersion Decimal 固定值:2.0
MessageType String 固定值:Inventory
SellerPartNumber String 商家为商品定义的唯一的标识符。包含字母和数字的字符串,含空格最多40个字符
注:一旦商品被创建,该信息是不能修改。
NeweggItemNumber String 新蛋为商品分配的唯一标识符
WarehouseLocation String 你仓库所在国家的国际标准3位国家编码。
完整国家代码列表,请通过以下链接下载:International Country Guide
注:提交的请求中若有错误值,将会报错。
FulfillmentOption String 有效值:
Seller 卖家配送
Inventory Integer 商品在卖家指定地点仓库的库存数量。

Schema: InventoryUpdate.xsd

示例:XML,Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=INVENTORY_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>2.0</DocumentVersion>
        <!--The identifier for the very of current feed; assigned by Newegg-->
    </Header>
    <MessageType>Inventory</MessageType>
    <Message>
        <Inventory>
            <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-->
                <WarehouseLocation>USA</WarehouseLocation>
                <!--The ISO standard 3-digit codes of the country where your warehouse is located. If left blank, default value will be All. -->
                <FulfillmentOption>Seller</FulfillmentOption>
                <!--The shipped by seller inventory in your [xxx] warehouse. -->
                <Inventory>200</Inventory>
                <!--The inventory in seller’s warehouse. -->
            </Item>
        </Inventory>
    </Message>
</NeweggEnvelope>

示例:Json,Request

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

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "2.0"
        },
        "MessageType": "Inventory",
        "Message": {
            "Inventory": {
                "Item": {
                    "SellerPartNumber": "a006-test-001",
                    "NeweggItemNumber": "9SIAWE50008504",
                    "WarehouseLocation": "USA",
                    "FulfillmentOption": "Seller",
                    "Inventory": "200"
                }
            }
        }
    }
}

回复文件主体

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