獲取商品基本資訊報表

獲取該商家可用物品基本資訊清單。

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