Newegg Developer Portal

获取补偿性退款信息

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

相关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}
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}
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>
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>
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"
}
}
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" } }
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>
<?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>
<?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"
}
}
}
}
}
{ "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" } } } } }
{
    "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>
<?xml version="1.0" encoding="utf-8"?> <Errors> <Error> <Code>CE001</Code> <Message>SellerID cannot be null or empty</Message> </Error> </Errors>
<?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"
}
]
[ { "Code": "CE001", "Message": "SellerID cannot be null or empty" } ]
[
    {
        "Code": "CE001",
        "Message": "SellerID cannot be null or empty"
    }
]

更新日期:10/15/2018