Process RMA

After submitting your return or replacement request to finalize the RMA submit this request.   Please note, process this request if the item(s) have been returned back to the seller.

Resource URL

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

Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.

Parameters

Resource Information

Request Body

Schema: UpdateRMARequest.xsd AND _RMAReceive.xsd

Example: XML, Request

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

<NeweggAPIRequest>
    <OperationType>ReceiveRMARequest</OperationType>
    <RequestBody>
        <ReceiveRMAInfo>
            <RMANumber>38873480</RMANumber>
        </ReceiveRMAInfo>
    </RequestBody>
</NeweggAPIRequest>

Example: Json, Request

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

{
    "OperationType": "ReceiveRMARequest",
    "RequestBody": {
        "ReceiveRMAInfo": {
            "RMANumber": "38873480"
        }
    }
}

Response Body

Schema: UpdateRMAResponse.xsd

Example: XML, Response

<?xml version=”1.0” encoding=”utf-8”?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>ReceiveRMAResponse</OperationType>
    <SellerID>A006</SellerID>
    <Memo />
    <ResponseDate>2011-09-28 09:02:00</ResponseDate>
    <ResponseBody>
        <RMAInfo>
            <RMANumber>38875640</RMANumber>
            <RMAType>2</RMAType>
            <RMATypeDescription>Refund</RMATypeDescription>
            <SourceSONumber>88219202</SourceSONumber>
            <SellerRMANumber>E12345678</SellerRMANumber>
            <RMAShipMethod />
            <RMAShipMethodDescription />
            <RMANote>your note here</RMANote>
            <IssueUser>test@newegg.com</IssueUser>
            <RMATransactionList>
                <RMATransaction>
                    <SellerPartNumber>Ben_item_12</SellerPartNumber>
                    <ReturnQuantity>1</ReturnQuantity>
                    <ReturnUnitPrice>200.00</ReturnUnitPrice>
                    <RefundShippingPrice>10.00</RefundShippingPrice>
                    <RMAReason>1</RMAReason>
                    <RMAReasonDescription>Carrier damage</RMAReasonDescription>
                </RMATransaction>
            </RMATransactionList>
        </RMAInfo>
    </ResponseBody>
</NeweggAPIResponse>

Example: Json, Reponse

{
    "IsSuccess": "true",
    "OperationType": "ReceiveRMAResponse",
    "SellerID": "A006",
    "ResponseDate": "2011-09-28 09:02:00",
    "ResponseBody": {
        "RMAInfo": {
            "RMANumber": "38875640",
            "RMAType": "2",
            "RMATypeDescription": "Refund",
            "SourceSONumber": "88219202",
            "SellerRMANumber": "E12345678",
            "RMANote": "your note here",
            "IssueUser": "test@newegg.com",
            "RMATransactionList": {
                "RMATransaction": {
                    "SellerPartNumber": "Ben_item_12",
                    "ReturnQuantity": "1",
                    "ReturnUnitPrice": "200.00",
                    "RefundShippingPrice": "10.00",
                    "RMAReason": "1",
                    "RMAReasonDescription": "Carrier damage"
                }
            }
        }
    }
}

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Example: 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>

Example: Json, Response

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

Last updated: October 15, 2018