獲取每日價格報表

獲取目標國家(包括美國)商品的價格資訊、運費以及啟動狀態。

相關URL

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

註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。

參數

名稱 是否必填? 描述
sellerid 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證? 請求格式 回覆格式 頻率限制
PUT 需要 XML,Json XML,Json 500 請求/小時

請求文件主體

屬性 是否必填? 格式 描述
IssueUser String 請求發送者在Seller Portal 註冊過的郵箱位址 。
系統只接受商家註冊過的Seller Portal郵箱位址。如果為空,預設值為商家編號
OperationType String 固定值:InternationalPriceReportRequest
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>InternationalPriceReportRequest</OperationType>
    <RequestBody>
        <RequestID>2PQBYWH4V68ZP</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": "InternationalPriceReportRequest",
    "RequestBody": {
        "RequestID": "2PQBYWH4V68ZP"
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 獲取資料狀態操作:
True:成功
False:失敗
SellerID String 你的商家編號
OperationType String 固定值:InternationalPriceReportResponse
RequestID String 你的請求編號
RequestType String INTERNATIONAL_PRICE_REPORT
RequestDate String 請求時間(太平洋標準時間)
ReportFileURL String 獲取報表處理的 ftp 文件路徑:例如
ftp://API52qNFlUQ:pKLgE2aE@ftp03.newegg.com/InternationalInventoryReport_2PN75DT8ZICH8.txt
文件各屬性資訊:

屬性名稱 定義
Seller Part # 商家制訂給商品的編碼
NE Item # 新蛋制訂給商品的編碼
CountryCode 您商品將要銷往的國家。只接受國際標準3位元國家編碼。
完整國家代碼清單,請通過以下連結下載:International Country Guide
註:有不正確的值得請求提交將報錯
Currency 你的商品將要銷往的國家的 Selling Price,MSRP,MAP欄位的貨幣單位,只能使用國際標準三位國家代碼。如果不填,系統預設為USD。
完整國家代碼清單,請通過以下連結下載:International Country Guide
註:在提交請求時,商品價格的貨幣代碼必須要與商品銷往國家的國家代碼相匹配。 否則,系統會報錯。
MSRP 廠商建議零售價或者為商品標價
MAP 最低廣告價格。
如果商品售價低於設置的最低廣告價格,網站會要求客戶將該商品加入購物車來查看價格。
如果您想要刪除MAP, 請在該欄位裡輸入“0.00”.
Checkout MAP 如果Checkout MAP標記為True,網站會要求客戶將該產品加入購物車並到支付頁面才能查看商品售價。MAP值將被忽略。
也就是說,只要Checkout MAP為True,不論實際售價是高於或是低於MAP,顧客始終需要加入商品到購物車並到支付頁面才能查看商品售價。
Selling Price 商品售價
Shipping 商品的運費,有default和free兩種選擇
Activation Mark 對所有上傳的商品,ActivationMark都默認設置為“True”,因為所有商品都必須被啟動才能展示在新蛋網頁。如果您想使您的商品在網頁不可見,您可設置該欄位為“False”
Memo String 附加資訊

Schema: InternationalPriceReportResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <sellerID>A006</sellerID>
    <OperationType>InternationalPriceReportResponse</OperationType>
    <ResponseBody>
        <RequestID>2PQC13C7UYDPQ</RequestID>
        <RequestType>INTERNATIONAL_PRICE_REPORT</RequestType>
        <RequestDate>2/21/2012 15:32:57</RequestDate>
        <ReportFileURL>ftp://APIe6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalInventoryReport_2PQC13C7UYDPQ.xls</ReportFileURL>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

示例: Json, Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "sellerID": "A006",
        "OperationType": "InternationalPriceReportResponse",
        "ResponseBody": {
            "RequestID": "2PQC13C7UYDPQ",
            "RequestType": "INTERNATIONAL_PRICE_REPORT",
            "RequestDate": "2/21/2012 15:32:57",
            "ReportFileURL": "ftp://APIe6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalInventoryReport_2PQC13C7UYDPQ.xls"
        },
        "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/15/2018