提交补偿性退款

提交补偿性退款请求。

该功能是在不要求顾客将商品退还给商家，仅是向客户做出补偿性质退款。该功能是一个请求，需要用户使用获取补偿性退款请求状态来获取关于补偿性退款请求创建状态的更新情况。

注：对于补偿性退款的退款，佣金将不予退还。

相关URL

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

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

参数

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

相关请求信息

HTTP方式 是否需要认证？ 请求格式 回复格式 频率限制
PUT 需要 XML,Json XML,Json 1000 请求/小时

请求文件主体

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

系统只接受商家注册过的Seller Portal邮箱地址。如果为空，默认值为商家编号。
OperationType 是 String 固定值：IssueCourtesyRefund
SourceSONumber 是 Integer 与当前的 RMA 相关联的订单编号
RefundReason 是 Integer 有效值：
1: Negative customer feedback 客户差评
2: Pricing error 价格错误
3: Wrong item information 商品信息错误
4: Shipping delay 发货延迟
5: Package not received 未收到包裹
6: Customer Courtesy 顾客优惠
TotalRefundAmount 是 Decimal 退款总额。退款总金额不能超过订单金额或者订单金额减去之前的退款金额。

  • Newegg.com 和 Newggbusiness.com，所有金额都设置使用美元(USD)
  • Newegg.ca，所有金额都设置使用加元(CAD)
NoteToCustomer 否 String 对此客户补偿性退款的说明，最大500个字符

Schema: IssueCRRequest.xsd

示例：XML，Request

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

<NeweggAPIRequest>
    <OperationType>IssueCourtesyRefund</OperationType>
    <RequestBody>
        <IssueCourtesyRefund>
            <SourceSONumber>11007735</SourceSONumber>
            <RefundReason>1</RefundReason>
            <TotalRefundAmount>2.01</TotalRefundAmount>
            <NoteToCustomer>this is a test note</NoteToCustomer>
        </IssueCourtesyRefund>
    </RequestBody>
</NeweggAPIRequest>

示例：Json，Request

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

{
    "OperationType": "IssueCourtesyRefund",
    "RequestBody": {
        "IssueCourtesyRefund": {
            "SourceSONumber": "11007735",
            "RefundReason": "1",
            "TotalRefundAmount": "2.01",
            "NoteToCustomer": "this is a test note"
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取数据状态操作：
True：成功
False：失败
OperationType String 固定值：CourtesyRefundResponse
SellerID String 商家编号
RequestId String 新蛋分配的请求编号
RequestDate String 提交请求的时间（太平洋标准时间）
RequestStatus String 请求提交的状态
有效值：
SUBMITTED：已提交
Memo String 附加信息

Schema: IssueCRResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>CourtesyRefundResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <ResponseList>
            <ResponseInfo>
                <RequestId>cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8</RequestId>
                <RequestDate>2/17/2012 19:15:00</RequestDate>
                <RequestStatus>SUBMITTED</RequestStatus>
            </ResponseInfo>
        </ResponseList>
    </ResponseBody>
</NeweggAPIResponse>

示例：Json，Response

{
    "IsSuccess": "true",
    "OperationType": "CourtesyRefundResponse",
    "SellerID": "A006",
    "ResponseBody": {
        "ResponseList": {
            "ResponseInfo": {
                "RequestId": "cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8",
                "RequestDate": "2/17/2012 19:15:00",
                "RequestStatus": "SUBMITTED"
            }
        }
    }
}

请求失败错误信息

常规HTTP错误回复，请参考回复失败错误代码列表。

错误代码 描述
SE004 Cannot issue RMA because the order has not been invoiced.

无法提交RMA，因为该订单尚未开具发票。
SE019 Item total refund amount must be greater than 0.

退款总金额必须大于0.
SE023 Total refund amount cannot exceed total order amount, which = {0.00}.

退款总金额不能超过订单总金额
SE025 Cannot issue RMA because the order type is invalid.

无法提交RMA，因为此订单类型无效
SE026 Cannot issue RMA because the order is a replacement order.

无法提交RMA， 因为此订单为换货订单
SE027 Cannot issue RMA because the order has been voided.

无法提交RMA，因为此订单已作废。
SE033 Invalid order number.

无效的订单号。

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>SE004</Code>
        <Message>Cannot issue RMA because the order has not been invoiced</Message>
    </Error>
</Errors>

示例：Json，Response

[
    {
        "Code": "SE004",
        "Message": "Cannot issue RMA because the order has not been invoiced"
    }
]

更新日期：10/15/2018