获取商品基本信息报告

获取该商家可用物品基本信息列表。

相关URL

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

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

参数

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

相关请求信息

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

请求文件主体

属性 是否必填? 格式 描述
IssueUser String 请求发送者在Seller Portal上注册过的邮箱地址 。
系统只接受商家注册过的Seller Portal邮箱地址。如果为空,默认值为商家编号
OperationType String 固定值:ItemBasicInfoReportRequest
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>ItemBasicInfoReportRequest</OperationType>
    <RequestBody>
        <RequestID>245VV9QOCM6BK</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": "ItemBasicInfoReportRequest",
    "RequestBody": {
        "RequestID": "245VV9QOCM6BK"
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取数据状态操作:
True:成功
False:失败
SellerID String 你的商家编号
OperationType String 固定值:ItemBasicInfoReportRequest
RequestID String 你的请求编号
RequestType String ITEM_BASIC_INFO_REPORT
RequestDate String 请求时间(太平洋标准时间)
ReportFileURL String 获取报告处理文件的 ftp 文件路径:例如
ftp://KUXTMPPH:01250442@mktpftp.newegg.com/ApiItemBaseInfoReport_245VV9QOCM6BK.zip
文件各属性信息:注:Newegg.com平台只返回国家代码USA

属性名称 定义
Seller Part # 商家分配给商品的编码
NE Item # 新蛋分配给商品的编码
Website Short Title 简短,易于识别的商品名称
Manufacturer Part# 制造商给商品定义的唯一的标识符
注:一旦商品创建成功,该信息将无法更新
UPC 商品唯一的通用商品编码UPC(只有12个字符)或欧洲商品编号EAN(只有13个字符)。
注:一旦商品被创建,该信息是不能修改。
Industry 商品所在的主类目
SubCategory 商品所在的子类目
Bullet Description 商品关于特点或功能等简短的描述,将以列表形式显示在商品页面商品标题的下方
Item Length 商品包装长度,单位为英寸,仅为值
Item Width 商品包装宽度,单位为英寸,仅为值
Item Height 商品包装高度,单位为英寸,仅为值
Item Weight 商品包装重量,单位为磅,仅为值
Status 商品当前状态。有效值:默认USA和CAN列表
Active 激活状态
Inactive 未激活状态
Item Image 商品产品原图的图片地址,不超过7张
Date Created 商品创建时间。格式:MM/DD/YYYY
Platform 商品销售平台。有效值:
USA:Newegg.com
USB:Neweggbusiness.com
CAN:Newegg.ca

Schema: ItemBasicInfoReportResponse.xsd

示例:XML,Response

<NeweggAPIResponse>
   <IsSuccess>true</IsSuccess>
   <sellerID>A006</sellerID>
   <OperationType>ItemBasicInfoReportResponse</OperationType>
   <ResponseBody>
      <RequestID>245VV9QOCM6BK</RequestID>
      <RequestType>ITEM_BASIC_INFO_REPORT</RequestType>
      <RequestDate>2/21/2012 15:32:57</RequestDate>
      <ReportFileURL>ftp://KUXTMPPH:01250442@mktpftp.newegg.com/ApiItemBaseInfoReport_245VV9QOCM6BK.zip</ReportFileURL>
   </ResponseBody>
   <Memo />
</NeweggAPIResponse>

示例:Json,Response

{
  "NeweggAPIResponse": {
    "IsSuccess": "true",
    "sellerID": "A006",
    "OperationType": "ItemBasicInfoReportResponse",
    "ResponseBody": {
      "RequestID": "245VV9QOCM6BK",
      "RequestType": "ITEM_BASIC_INFO_REPORT",
      "RequestDate": "2/21/2012 15:32:57",
      "ReportFileURL": "ftp://KUXTMPPH:01250442@mktpftp.newegg.com/ApiItemBaseInfoReport_245VV9QOCM6BK.zip"
    },
    "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/28/2021