获取补偿性退款信息

通过指定查询条件获取指定的补偿性退款信息。

相关URL

Newegg.com: https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/info?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/servicemgmt/courtesyrefund/info?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/servicemgmt/courtesyrefund/info?sellerid={sellerid}

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号

相关请求信息

HTTP方式 是否需要认证？ 请求格式 回复格式 频率限制
PUT 需要 XML,Json XML,Json 30 请求/分钟/商家

请求文件主体

属性 是否必填？ 格式 描述
IssueUser 否 String 请求发送者在Seller Portal上注册过的邮箱地址。

系统只接受商家注册过的Seller Portal邮箱地址。如果为空，默认值为商家编号。
OperationType 是 String 固定值: GetCourtesyRefundInfo
PageIndex 否 Integer 当前页索引
如果不填，默认为1
PageSize 否 Integer 一页中的记录数，每页最大记录数为100
如果不填，默认为100
KeywordsType 否 Integer 有效值：
0: All (default)（所有（默认））
1: CourtesyRefundID（补偿性退款请求编号）
2: OrderNumber（订单编号）
3: CustomerName（顾客姓名）
KeywordsValue 否 String 指定KeywordsType（关键词类型）的关键字的值
如果KeywordsType为0，系统将会忽略该字段
Status 否 Integer 有效值：
0: All (Default)（所有（默认））
1: Open（待收货）
2: Void（已作废）
3: Close（已关闭）
DateFrom 否 String 根据时间范围查找补偿性退款请求（太平洋标准时间）。请参考可接受时间格式
DateTo 否 String 根据时间范围查找补偿性退款请求（太平洋标准时间）。请参考可接受时间格式

Schema: GetCRInfoRequest.xsd

示例：XML，Request

PUT https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/info?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest >
    <OperationType>GetCourtesyRefundInfo</OperationType>
    <RequestBody>
        <PageInfo>
            <PageIndex>1</PageIndex>
            <PageSize>10</PageSize>
        </PageInfo>
        <KeywordsType>0</KeywordsType>
        <KeywordsValue />
        <Status>0</Status>
        <DateFrom>2001-12-17 09:30:47</DateFrom>
        <DateTo>2011-12-17 12:30:47</DateTo>
    </RequestBody>
</NeweggAPIRequest>

示例：Json，Request

PUT https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/info?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "GetCourtesyRefundInfo",
    "RequestBody": {
        "PageInfo": {
            "PageIndex": "1",
            "PageSize": "10"
        },
        "KeywordsType": "0",
        "Status": "0",
        "DateFrom": "2001-12-17 09:30:47",
        "DateTo": "2011-12-17 12:30:47"
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取数据状态操作：
True：成功
False：失败
OperationType String 固定值：GetCourtesyRefundResponse
SellerID String 商家编号
ResponseDate String 该请求提交的时间（太平洋标准时间）
TotalCount Integer 记录总条数
TotalPageCount Integer 返回总页数
PageSize Integer 每页记录条数
PageIndex Integer 当前页索引
CourtesyRefundID String 补偿性退款交易编号
SONumber Integer 订单编号
SOAmount Decimal 订单总金额

  • Newegg.com 和 Newggbusiness.com，所有金额都设置使用美元(USD)
  • Newegg.ca，所有金额都设置使用加元(CAD)
InvoiceNumber Integer 订单发票编号
RefundAmount Decimal 退款总额

  • Newegg.com 和 Newggbusiness.com，所有金额都设置使用美元(USD)
  • Newegg.ca，所有金额都设置使用加元(CAD)
ReasonCode Integer 有效值：
1. Negative customer feedback（顾客差评）
2. Pricing error（价格错误）
3. Wrong item information（错误的商品信息）
4. Shipping delay（发货延迟）
5. Package not received（没有收到包裹）
6. Customer Courtesy（顾客补偿）
Reason String 有效值：
Negative customer feedback（顾客差评）：如果ReasonCode的值为1
Pricing error（价格错误） ：如果ReasonCode的值为2
Wrong item information（错误的商品信息） ：如果ReasonCode的值为3
Shipping delay（发货延迟） ：如果ReasonCode的值为4
Package not received（没有收到包裹） ：如果ReasonCode的值为5
Customer Courtesy（顾客补偿）：如果ReasonCode的值为6
NoteToCustomer String 给顾客的备注信息
Status String 有效值：
1：Open（待收货）
2：Close（已关闭）
3：Void（已作废）
IsNeweggRefund String 指定新蛋客服代替处理退款。有效值：True或者False
InUserName String 补偿性退款请求的创建者
InDate String 补偿性退款请求创建时间（太平洋标准时间）
EditUserName String 最后编辑用户
EditDate String 最后编辑时间（太平洋标准时间）

Schema: GetCRInfoResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetCourtesyRefundResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseDate>2012-02-17 15:12:00</ResponseDate>
    <ResponseBody>
        <PageInfo>
            <TotalCount>1</TotalCount>
            <TotalPageCount>1</TotalPageCount>
            <PageSize>10</PageSize>
            <PageIndex>1</PageIndex>
        </PageInfo>
        <CourtesyRefundInfoList>
            <CourtesyrefundInfo>
                <CourtesyRefundID>8a9501f2-495a-4b4f-b921-966a40969aa8</CourtesyRefundID>
                <SONumber>88251262</SONumber>
                <SOAmount>890.40</SOAmount>
                <InvoiceNumber>48799955</InvoiceNumber>
                <RefundAmount>2.01</RefundAmount>
                <ReasonCode>1</ReasonCode>
                <Reason>Negative Customer Feedback</Reason>
                <NoteToCustomer>This is a test note</NoteToCustomer>
                <Status>Close</Status>
                <IsNeweggRefund>false</IsNeweggRefund>
                <InUserName>A006</InUserName>
                <InDate>2012-02-17 12:10:00</InDate>
                <EditUserName>A006</EditUserName>
                <EditDate>2012-02-17 12:10:00</EditDate>
            </CourtesyrefundInfo>
        </CourtesyRefundInfoList>
    </ResponseBody>
</NeweggAPIResponse>

示例：Json，Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "OperationType": "GetCourtesyRefundResponse",
        "SellerID": "A006",
        "ResponseDate": "2012-02-17 15:12:00",
        "ResponseBody": {
            "PageInfo": {
                "TotalCount": "1",
                "TotalPageCount": "1",
                "PageSize": "1",
                "PageIndex": "10"
            },
            "CourtesyRefundInfoList": {
                "CourtesyrefundInfo": {
                    "CourtesyRefundID": "8a9501f2-495a-4b4f-b921-966a40969aa8",
                    "SONumber": "88251262",
                    "SOAmount": "890.40",
                    "InvoiceNumber": "48799955",
                    "RefundAmount": "2.01",
                    "ReasonCode": "1",
                    "Reason": "Negative Customer Feedback",
                    "NoteToCustomer": "This is a test note",
                    "Status": "Close",
                    "IsNeweggRefund": "false",
                    "InUserName": "A006",
                    "InDate": "2012-02-17 12:10:00",
                    "EditUserName": "EDI",
                    "EditDate": "2012-02-17 12:10:00"
                }
            }
        }
    }
}

请求失败错误信息

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