获取商品基本信息报告

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

相关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