獲取商品檢索報表

請求獲取新蛋類目下有效商品列表。

相關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 固定值：ItemLookupRequest
RequestID 是 String 新蛋分配的已提交的請求的編號
PageIndex 是 Integer 當前頁索引
PageSize 是 Integer 單頁返回的記錄總數
每頁最多100條。

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>ItemLookupRequest</OperationType>
    <RequestBody>
        <RequestID>2PQBYWH4V68ZP</RequestID>
        <PageInfo>
            <PageIndex>1</PageIndex>
            <PageSize>10</PageSize>
        </PageInfo>
    </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": "ItemLookupRequest",
    "RequestBody": {
        "RequestID": "2PQBYWH4V68ZP",
        "PageInfo": {
            "PageSize": "10",
            "PageIndex": "1"
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 獲取資料狀態的操作：
True: 成功
False: 失敗
SellerID String 您的商家編號
OperationType String 固定值：ItemLookupResponse
RequestID String 已提交的請求編號
RequestDate String 請求提交時間（太平洋標準時間）
TotalCount Integer 總記錄數
TotalPageCount Integer 總頁數
PageIndex Integer 當前頁索引
PageSize Integer 單頁的記錄個數
SellerID String 您的商家編號
NeweggItemNumber String 新蛋商品編號
UPC String UPC 編碼
Condition String 有效值：
1. New（全新）
2. Refurbished（翻新）
3. Used – Like New（二手 – 類似新品）
4. Used – Very Good（二手 – 非常好）
5. Used – Good（二手 – 好）
6. Used – Acceptable（二手 – 尚可）
註：Used只適用於Newegg.com
PacksOrSets Integer 定義該商品的封裝數量
註：所有封裝商品都會有匹配的商品和狀態
ManufacturerName Integer 製造商名稱
ManufacturerPartNumber String 製造商商品編號
WebsiteShortTitle String 商品標題
Note String 請求的錯誤資訊（例如：未找到匹配記錄）
ResponseDate String 回覆日期（太平洋標準時間）

Schema: ItemLookupResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>ItemLookupResponse</OperationType>
    <SellerID>bfwk</SellerID>
    <ResponseBody>
        <PageInfo>
            <TotalCount>4</TotalCount>
            <TotalPageCount>1</TotalPageCount>
            <PageIndex>1</PageIndex>
            <PageSize>10</PageSize>
        </PageInfo>
        <RequestID>28292T8ASAL64</RequestID>
        <RequestDate>07/11/2014 18:14:04</RequestDate>
        <ItemList>
            <Item>
                <ParentItemNumber>01T-001Y-00004</ParentItemNumber>
                <UPC>20140711101111</UPC>
                <Condition>1</Condition>
                <PacksOrSets>1</PacksOrSets>
                <ManufacturerName>
                    <![CDATA[q-see ]]>
                </ManufacturerName>
                <ManufacturerPartNumber>
                    <![CDATA[canmfpn20140711101 ]]>
                </ManufacturerPartNumber>
                <WebShortTitle>
                    <![CDATA[b2b new item 201407111001 ]]>
                </WebShortTitle>
            </Item>
            <Item>
                <ParentItemNumber>01T-001Y-00004</ParentItemNumber>
                <UPC>20140711101111</UPC>
                <Condition>1</Condition>
                <PacksOrSets>1</PacksOrSets>
                <ManufacturerName>
                    <![CDATA[q-see ]]>
                </ManufacturerName>
                <ManufacturerPartNumber>
                    <![CDATA[canmfpn20140711101 ]]>
                </ManufacturerPartNumber>
                <WebShortTitle>
                    <![CDATA[b2b new item 201407111001 ]]>
                </WebShortTitle>
            </Item>
            <Item>
                <ParentItemNumber>01T-001Y-00004</ParentItemNumber>
                <UPC>20140711101111</UPC>
                <Condition>1</Condition>
                <PacksOrSets>1</PacksOrSets>
                <ManufacturerName>
                    <![CDATA[q-see ]]>
                </ManufacturerName>
                <ManufacturerPartNumber>
                    <![CDATA[canmfpn20140711101 ]]>
                </ManufacturerPartNumber>
                <WebShortTitle>
                    <![CDATA[b2b new item 201407111001 ]]>
                </WebShortTitle>
            </Item>
            <Item>
                <ParentItemNumber>01T-001Y-00007</ParentItemNumber>
                <UPC />
                <Condition>2</Condition>
                <PacksOrSets>1</PacksOrSets>
                <ManufacturerName>
                    <![CDATA[q-see ]]>
                </ManufacturerName>
                <ManufacturerPartNumber>
                    <![CDATA[canmfpn20140711101 ]]>
                </ManufacturerPartNumber>
                <WebShortTitle>
                    <![CDATA[456346 ]]>
                </WebShortTitle>
            </Item>
        </ItemList>
    </ResponseBody>
    <ResponseDate>07/11/2014 19:00:59</ResponseDate>
</NeweggAPIResponse>

示例: Json, Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "OperationType": "ItemLookupResponse",
        "SellerID": "bfwk",
        "ResponseBody": {
            "PageInfo": {
                "TotalCount": "4",
                "TotalPageCount": "1",
                "PageIndex": "1",
                "PageSize": "10"
            },
            "RequestID": "28292T8ASAL64",
            "RequestDate": "07/11/2014 18:14:04",
            "ItemList": {
                "Item": [
                    {
                        "ParentItemNumber": "01T-001Y-00004",
                        "UPC": "20140711101111",
                        "Condition": "1",
                        "PacksOrSets": "1",
                        "ManufacturerName": "q-see",
                        "ManufacturerPartNumber": "canmfpn20140711101",
                        "WebShortTitle": "b2b new item 201407111001"
                    },
                    {
                        "ParentItemNumber": "01T-001Y-00004",
                        "UPC": "20140711101111",
                        "Condition": "1",
                        "PacksOrSets": "1",
                        "ManufacturerName": "q-see",
                        "ManufacturerPartNumber": "canmfpn20140711101",
                        "WebShortTitle": "b2b new item 201407111001"
                    },
                    {
                        "ParentItemNumber": "01T-001Y-00004",
                        "UPC": "20140711101111",
                        "Condition": "1",
                        "PacksOrSets": "1",
                        "ManufacturerName": "q-see",
                        "ManufacturerPartNumber": "canmfpn20140711101",
                        "WebShortTitle": "b2b new item 201407111001"
                    },
                    {
                        "ParentItemNumber": "01T-001Y-00007",
                        "UPC": "",
                        "Condition": "2",
                        "PacksOrSets": "1",
                        "ManufacturerName": "q-see",
                        "ManufacturerPartNumber": "canmfpn20140711101",
                        "WebShortTitle": "456346"
                    }
                ]
            }
        },
        "ResponseDate": "07/11/2014 19:00:59"
    }
}

請求失敗錯誤資訊

常規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