提交補償性退款

提交補償性質退款請求。

該功能是在不要求顧客將商品退還給商家,僅是向客戶做出補償性質退款。該功能是一個請求,需要使用者使用獲取補償性退款請求狀態來獲取關於補償性退款請求創建狀態的更新情況。

註:對於補償性退款的退款,佣金將不予退回。

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