获取结算交易报告

获取指定结算期间交易明细报表。

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