提交RMA

為一個已完成的訂單提交一個退款或者換貨RMA。

相關URL

Newegg.com: https://api.newegg.com/marketplace/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}
Newegg.ca: https://api.newegg.com/marketplace/can/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}

註：請確保您的請求URL全都是小寫（除Seller ID）並且不能包含任何空格或者分行符號。

參數

相關請求資訊

請求文件主體

Schema: SubmitRMARequest.xsd

示例：XML, Request

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

<NeweggAPIRequest>
    <OperationType>IssueRMARequest</OperationType>
    <RequestBody>
        <IssueRMA>
            <RMAType>2</RMAType>
            <SourceSONumber>123456789</SourceSONumber>
            <SellerRMANumber>E12345678</SellerRMANumber>
            <AutoReceiveMark>1</AutoReceiveMark>
            <RMANote>This is a test RMA</RMANote>
            <RMATransactionList>
                <RMATransaction>
                    <SellerPartNumber>test001</SellerPartNumber>
                    <ReturnQuantity>1</ReturnQuantity>
                    <ReturnUnitPrice>1.00</ReturnUnitPrice>
                    <RefundShippingPrice>1.00</RefundShippingPrice>
                    <RMAReason>2</RMAReason>
                </RMATransaction>
            </RMATransactionList>
        </IssueRMA>
    </RequestBody>
</NeweggAPIRequest>

示例：Json, Request

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

{
    "OperationType": "IssueRMARequest",
    "RequestBody": {
        "IssueRMA": {
            "RMAType": "2",
            "SourceSONumber": "123456789",
            "SellerRMANumber": "E12345678",
            "AutoReceiveMark": "1",
            "RMANote": "This is a test RMA",
            "RMATransactionList": {
                "RMATransaction": {
                    "SellerPartNumber": "test001",
                    "ReturnQuantity": "1",
                    "ReturnUnitPrice": "1.00",
                    "RefundShippingPrice": "1.00",
                    "RMAReason": "2"
                }
            }
        }
    }
}

回覆文件主體

Schema: SubmitRMAResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>IssueRMAResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseDate>2012-02-22 20:59:50</ResponseDate>
    <Memo />
    <ResponseBody>
        <RMAInfo>
            <RMANumber>20103389</RMANumber>
            <RMAType>2</RMAType>
            <RMATypeDescription>Refund</RMATypeDescription>
            <IssueUser>A004</IssueUser>
            <RMADate>2012-02-22</RMADate>
            <RMAStatus>6</RMAStatus>
            <RMAStatusDescription>Processing</RMAStatusDescription>
            <RMAShipMethod />
            <RMAShipMethodDescription />
            <OrderNumber>41473422</OrderNumber>
            <OrderDate>2012-01-11</OrderDate>
            <InvoiceNumber>82868509</InvoiceNumber>
            <OrderAmount>15.00</OrderAmount>
            <AvailableRefundAmount>12000</AvailableRefundAmount>
            <RMAProcessedBy>newegg</RMAProcessedBy>
            <RMAReceiveDate />
            <RMANote>This is a test RMA</RMANote>
            <PriorRefundAmount>2.00</PriorRefundAmount>
            <CustomerName>abc Roosevelt</CustomerName>
            <CustomerPhoneNumber>626-271-9700</CustomerPhoneNumber>
            <CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
            <ShipToAddress1>1941 E. Cedar Loop Drive</ShipToAddress1>
            <ShipToAddress2>9A</ShipToAddress2>
            <ShipToCityName>South Weber</ShipToCityName>
            <ShipToStateCode>UT</ShipToStateCode>
            <ShipToZipCode>884405</ShipToZipCode>
            <ShipToLastName>Roosevelt</ShipToLastName>
            <ShipToFirstName>abc</ShipToFirstName>
            <ShipToCompany />
            <RMATransactionList>
                <RMATransaction>
                    <SellerPartNumber>201112310900</SellerPartNumber>
                    <MfrPartNumber>201112310900</MfrPartNumber>
                    <NeweggItemNumber>9SIA0040286987</NeweggItemNumber>
                    <Description>ICYTEST201112310900</Description>
                    <UnitPrice>600.00</UnitPrice>
                    <ReturnQuantity>1</ReturnQuantity>
                    <ReturnUnitPrice>1.00</ReturnUnitPrice>
                    <RefundShippingPrice>1.00</RefundShippingPrice>
                    <RMAReason>2</RMAReason>
                    <RMAReasonDescription>Defective</RMAReasonDescription>
                </RMATransaction>
            </RMATransactionList>
        </RMAInfo>
    </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
    "IsSuccess": "true",
    "OperationType": "IssueRMAResponse",
    "SellerID": "A006",
    "ResponseDate": "2012-02-22 20:59:50",
    "ResponseBody": {
        "RMAInfo": {
            "RMANumber": "20103389",
            "RMAType": "2",
            "RMATypeDescription": "Refund",
            "IssueUser": "A004",
            "RMADate": "2012-02-22",
            "RMAStatus": "6",
            "RMAStatusDescription": "Processing",
            "OrderNumber": "41473422",
            "OrderDate": "2012-01-11",
            "InvoiceNumber": "82868509",
            "OrderAmount": "15.00",
            "AvailableRefundAmount": "12000",
            "RMANote": "This is a test RMA",
            "PriorRefundAmount": "2.00",
            "CustomerName": "abc Roosevelt",
            "CustomerPhoneNumber": "626-271-9700",
            "CustomerEmailAddress": "gdv6l0viwo4l7j1d@marketplace.newegg.com",
            "ShipToAddress1": "1941 E. Cedar Loop Drive",
            "ShipToAddress2": "9A",
            "ShipToCityName": "South Weber",
            "ShipToStateCode": "UT",
            "ShipToZipCode": "884405",
            "ShipToLastName": "Roosevelt",
            "ShipToFirstName": "abc",
            "RMATransactionList": {
                "RMATransaction": {
                    "SellerPartNumber": "201112310900",
                    "MfrPartNumber": "201112310900",
                    "NeweggItemNumber": "9SIA0040286987",
                    "Description": "ICYTEST201112310900",
                    "UnitPrice": "600.00",
                    "ReturnQuantity": "1",
                    "ReturnUnitPrice": "1.00",
                    "RefundShippingPrice": "1.00",
                    "RMAReason": "2",
                    "RMAReasonDescription": "Defective"
                }
            }
        }
    }
}

請求失敗錯誤資訊

常規HTTP錯誤回應，請參考回覆失敗錯誤代碼清單。

示例: 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