获取每日价格报告

获取目标国家(包括美国)商品的价格信息、运费以及激活状态。

相关URL

Newegg.com: https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}

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

参数

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

相关请求信息

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

请求文件主体

属性 是否必填? 格式 描述
IssueUser String 请求发送者在Seller Portal上注册过的邮箱地址 。
系统只接受商家注册过的Seller Portal邮箱地址。如果为空,默认值为商家编号
OperationType String 固定值:InternationalPriceReportRequest
RequestID String 新蛋分配的已提交的请求编号

Schema: GetReportRequest.xsd

示例:XML,Request

PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest >
    <OperationType>InternationalPriceReportRequest</OperationType>
    <RequestBody>
        <RequestID>2PQBYWH4V68ZP</RequestID>
    </RequestBody>
</NeweggAPIRequest>

示例:Json,Request

PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "InternationalPriceReportRequest",
    "RequestBody": {
        "RequestID": "2PQBYWH4V68ZP"
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取数据状态操作:
True:成功
False:失败
SellerID String 你的商家编号
OperationType String 固定值: InternationalPriceReportResponse
RequestID String 你的请求编号
RequestType String INTERNATIONAL_PRICE_REPORT
RequestDate String 请求时间(太平洋标准时间)
ReportFileURL String 获取报告处理文件的 ftp 文件路径:例如
ftp://API52qNFlUQ:pKLgE2aE@ftp03.newegg.com/InternationalInventoryReport_2PN75DT8ZICH8.txt
文件各属性信息:

属性名称 定义
Seller Part # 商家分配给商品的编码
NE Item # 新蛋分配给商品的编码
CountryCode 您商品将要销往的国家。只接受国际标准3位国家编码。
完整国家代码列表,请通过以下链接下载:International Country Guide
注:有不正确的值的提交请求将报错
Currency 你的商品将要销往的国家的 Selling Price, MSRP, MAP 字段的货币单位,只能使用国际标准三位国家代码。如果不填,系统默认为USD。
完整国家代码列表,请通过以下链接下载:International Country Guide
注:在提交请求时,商品价格的货币代码必须要与商品销往国家的国家代码相匹配。 否则,系统会报错。
MSRP 厂商建议零售价或者为商品标价
MAP 最低广告价格。
如果商品售价低于设置的最低广告价格,网站会要求客户将该商品加入购物车来查看价格。
如果您想要删除MAP, 请在该字段里输入“0.00”.
Checkout MAP 如果Checkout MAP标记为True,网站会要求客户将该产品加入购物车并到支付页面才能查看商品售价。MAP值将被忽略。
也就是说,只要Checkout MAP为True,不论实际售价是高于或是低于MAP,顾客始终需要加入商品到购物车并到支付页面才能查看商品售价。
Selling Price 商品售价
Shipping 商品的运费,有default和free两种选择
Activation Mark 对所有上传的商品,ActivationMark都默认设置为“True”,因为所有商品都必须被激活才能展示在新蛋网页。如果您想使您的商品在网页不可见,您可设置该字段为“False”
Memo String 附加信息

Schema: InternationalPriceReportResponse.xsd

示例:XML,Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <sellerID>A006</sellerID>
    <OperationType>InternationalPriceReportResponse</OperationType>
    <ResponseBody>
        <RequestID>2PQC13C7UYDPQ</RequestID>
        <RequestType>INTERNATIONAL_PRICE_REPORT</RequestType>
        <RequestDate>2/21/2012 15:32:57</RequestDate>
        <ReportFileURL>ftp://APIe6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalInventoryReport_2PQC13C7UYDPQ.xls</ReportFileURL>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

示例:Json,Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "sellerID": "A006",
        "OperationType": "InternationalPriceReportResponse",
        "ResponseBody": {
            "RequestID": "2PQC13C7UYDPQ",
            "RequestType": "INTERNATIONAL_PRICE_REPORT",
            "RequestDate": "2/21/2012 15:32:57",
            "ReportFileURL": "ftp://APIe6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalInventoryReport_2PQC13C7UYDPQ.xls"
        },
        "Memo": null
    }
}

请求失败错误信息

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

示例:XML,Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CE001</Code>
        <Message>SellerID cannot be null or empty</Message>
    </Error>
</Errors>

示例:Json,Response

[
    {
        "Code": "CE001",
        "Message": "SellerID cannot be null or empty"
    }
]

更新日期:10/15/2018