獲取結算交易報表

獲取指定結算期間交易明細報表。

相關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 固定值:SettlementTransactionReportRequest
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>SettlementTransactionReportRequest</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": "SettlementTransactionReportRequest",
    "RequestBody": {
        "RequestID": "2PQBYWH4V68ZP",
        "PageInfo": {
            "PageSize": "10",
            "PageIndex": "1"
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 用於獲取資料狀態的操作
True:成功
False:失敗
SellerID String 你的商家編號
OperationType String 固定值:GetSettlementTransactionInfoResponse
RequestID String 請求編號
RequestDate String 請求時間
TotalCount Integer 總記錄數
TotalPageCount Integer 總頁數
PageIndex Integer 當前頁索引
PageSize Integer 單頁的記錄數
TransactionDate String 交易日期
TransactionType Integer 交易類型
OrderID Integer 訂單編號
InvoiceID Integer 發票編號
SellerPartNumber String 商家自訂的商品編號
NeweggItemNumber String 新蛋分配的商品編號
ItemDescription String 商品描述
ItemCondition String 商品狀態:
New(全新)
Refurbished(翻新)
Used – Like New(二手 – 類似新品)
Used – Very Good(二手 – 非常好)
Used – Good(二手 – 好)
Used – Acceptable(二手 – 尚可)
Amount String 總數額

  • Newegg.com 和 Newggbusiness.com所有金額都設置使用美元(USD)
  • Newegg.ca所有金額都設置使用加幣(CAD)
Shipping String 訂單運費

  • Newegg.com 和 Newggbusiness.com所有金額都設置使用美元(USD)
  • Newegg.ca所有金額都設置使用加幣(CAD)
CommissionFee String 訂單傭金

  • Newegg.com 和 Newggbusiness.com所有金額都設置使用美元(USD)
  • Newegg.ca所有金額都設置使用加幣(CAD)
SettlementID String 結算編號
Memo String 附加資訊
ResponseDate String 回覆時間(太平洋標準時間)

Schema: SettlementTransactionResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <SellerID>A09D</SellerID>
    <OperationType>GetSettlementTransactionInfoResponse</OperationType>
    <ResponseBody>
        <PageInfo>
            <TotalCount>21</TotalCount>
            <TotalPageCount>21</TotalPageCount>
            <PageSize>10</PageSize>
            <PageIndex>1</PageIndex>
        </PageInfo>
        <RequestID>2PQDKCAQFHL3M</RequestID>
        <RequestDate>2/23/2012 11:39:00</RequestDate>
        <SettlementTransactionInfoList>
            <SettlementTransactionInfo>
                <TransactionDate>8/9/2011 12:00:00</TransactionDate>
                <TransactionType>Order</TransactionType>
                <OrderID>87123017</OrderID>
                <InvoiceID>75994476</InvoiceID>
                <SellerPartNumber>A09D77897686</SellerPartNumber>
                <NeweggItemNumber>9SIA00X0002HJ5</NeweggItemNumber>
                <ItemDescription>dfdfgsdfg</ItemDescription>
                <ItemCondition>New</ItemCondition>
                <Amount>10.00</Amount>
                <Shipping>2.00</Shipping>
                <CommissionFee>-0.75</CommissionFee>
                <SettlementID />
            </SettlementTransactionInfo>
        </SettlementTransactionInfoList>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

示例: Json, Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "SellerID": "A09D",
        "OperationType": "GetSettlementTransactionInfoResponse",
        "ResponseBody": {
            "PageInfo": {
                "TotalCount": "21",
                "TotalPageCount": "21",
                "PageSize": "10",
                "PageIndex": "1"
            },
            "RequestID": "2PQDKCAQFHL3M",
            "RequestDate": "2/23/2012 11:39:00",
            "SettlementTransactionInfoList": {
                "SettlementTransactionInfo": {
                    "TransactionDate": "8/9/2011 12:00:00",
                    "TransactionType": "Order",
                    "OrderID": "87123017 ",
                    "InvoiceID": "75994476 ",
                    "SellerPartNumber": "A09D77897686",
                    "NeweggItemNumber": "9SIA00X0002HJ5",
                    "ItemDescription": "dfdfgsdfg",
                    "ItemCondition": "New",
                    "Amount": "10.00",
                    "Shipping": "2.00",
                    "CommissionFee": "-0.75",
                    "SettlementID": null
                }
            }
        },
        "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