獲取商品基本資訊報表

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

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