Reject RMA

Reject existing RMA.

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

Name Required? Description
sellerid Yes Your seller ID on Newegg Marketplace
version Yes Newegg.com

  • Available version number: 307

Neweggbusiness.com and Newegg.ca

  • Available version number: 305

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
POST Required XML, Json XML, Json 1000 request per hour

Request Body

Attribute Required? Format Description
IssueUser No String The RMA issuer’s registered Seller Portal email address.
System will only accept Seller’s registered Seller Portal email addresses. If left blank, default value will be Seller ID.
OperationType Yes String Fixed value: RejectRMARequest
RMANumber Yes Integer Newegg’s assigned number for RMA for order
RejectReason Yes Integer The reason you reject this RMA

Available values:

  • 1: Remove/Missing Serial Number/Graffiti (Deprecated)
  • 2: Warranty Expired (Deprecated)
  • 3: Physical Damage
  • 4: Item Missing/Parts Missing
  • 5: Wrong Item Returned
  • 6: CPU Pin Damage
  • 7: Missing Retail Box
  • 8: Missing UPC Code- MIR Item
  • 9: Missing/Tampered Serial Number
  • 10: Missing Accessories
  • 11: Consumable Item
  • 12: Motherboard Socket Pin Damage

Available values on Newegg.com and Neweggbusiness.com

  • 13: QA-Sent Wrong Item
  • 14: Unlocked Cellphone
  • 15: Used item Returned as New

Available values on Newegg.ca

  • 16: Customer Request
  • 17: Missing Serial Number
  • 18: Software
ShipCarrier Yes Integer Carrier you want to use.
Available values:
1: UPS
2: FedEx
3: DHL
4: USPS
5: Other
OtherShipCarrier Yes when ShipCarrier = Other String The actual ship carrier if the ship carrier type is specified as other.
Max 10 character(s).  Only apply on Other ShipCarrier.  Refer to other available carrier list at Newegg Integrated Carrier List.
ShipService Yes String Shipping service type, such as air, ground, etc. Please reference your shipping carrier directly.  Max 50 characters.
TrackingNumber Yes String The tracking number of shipment(s).
RejectReasonMemo Yes when RejectReason =  4, 6, 7, 8, 9, 10, 11, 12 String Memo of your rejection.

Max 1,000 characters.

ImageUrl Yes when RejectReason =  4, 6, 7, 8, 9, 10, 11, 12 String Attach files of rejected items.

Allowed file formats: *.JPG, *.JPEG, *.PNG, *.GIF, *.BMP, *.TIFF

Maximum size for each image is 5MB.

Maximum of 5 images is allowed.

Schema: UpdateRMARequest.xsd AND _RMAReject.xsd

Example: XML, Request

<NeweggAPIRequest>
    <OperationType>RejectRMARequest</OperationType>
    <RequestBody>
        <RejectRMAInfo>
            <RMANumber>38863380</RMANumber>
            <RejectReason>7</RejectReason>
            <ShipCarrier>5</ShipCarrier>
            <OtherShipCarrier>other</OtherShipCarrier>
            <ShipService>Ground</ShipService>
            <TrackingNumberList>
                <TrackingNumber>123123123123</TrackingNumber>
            </TrackingNumberList>
            <RejectReasonMemo>No CPU pin damage.</RejectReasonMemo>
            <RejectReasonDescriptionImages>
                <ImageUrl>https://10.1.24.143:4567/images/CPU1.jpg</ImageUrl>
                <ImageUrl>https://10.1.24.143:4567/images/CPU2.jpg</ImageUrl>
            </RejectReasonDescriptionImages>
        </RejectRMAInfo>
    </RequestBody>
</NeweggAPIRequest>

Example: Json, Request

{
    "OperationType": "RejectRMARequest",
    "RequestBody": {
        "RejectRMAInfo": {
            "RMANumber": "38863380",
            "RejectReason": "7",
            "ShipCarrier": "5",
            "OtherShipCarrier": "other",
            "ShipService": "Ground",
            "TrackingNumberList": {
                "TrackingNumber": "123123123123"
            },
            "RejectReasonMemo": "No CPU pin damage.",
            "RejectReasonDescriptionImages": {
                "ImageUrl": [
                    "https://10.1.24.143:4567/images/CPU1.jpg",
                    "https://10.1.24.143:4567/images/CPU2.jpg"
                ]
            }
        }
    }
}

Response Body

Attribute Format Description
IsSuccess String Get feed status operation:

True: Successful
False: Not successful

OperationType String Fixed value: RejectRMAResponse
SellerID String Your seller ID
Memo String Additional notes
ResponseDate String Response date (Pacific Standard Time)
RMANumber Integer Newgg’s assigned number for RMA
RMAType Integer Available values:

1:Replacement
2:Refund

RMATypeDescription String Available values:

Replacement:RMAType value 1
Refund:RMAType value 2

SourceSONumber Integer The order number of the requested RMA.
SellerRMANumber String Seller’s user defined RMA number

  • An alphanumeric string, max 50 characters
  • Newegg.com, if seller defined, only available for version: 307
  • Neweggbusiness.com and Newegg.ca, if seller defined, only available for version: 305
IssueUser String RMA Issue User or Seller ID (if RMA Issue User was not specified when RMA was created)
RMADate String Date of RMA (Pacific Standard Time)
RMAStatus Integer Available value:

6:Processing

RMAStatusDescription String Available value: Processing (default)
RMAShipMethod Integer The ship method if the RMA type = Replacement:

1: Super Saver(7-14 business days)
2: Standard Shipping(5-7 business days)
3: Expedited Shipping(3-5 business days)
4: Two-Day Shipping(2 business days)
5: One-Day Shipping(Next day)
6: International Economy Shipping(8-15 business days)
7: International Standard Shipping(5-7 business days)
8: International Expedited Shipping(3-5 business days)
9: International Two-Day Shipping(2 business days)
10: APO/FPO – Military ONLY
11: Newegg Premier 3 Days
12: Newegg Premier 2 Days
13: Newegg Premier Next Day

If RMA type = Refund, this element will be blank

Note: Newegg will apply the same ship method used in original order.

RMAShipMethodDescription String The ship method if the RMA type = Replacement:

Super Saver(7-14 business days): If RMAShipMethod value = 1
Standard Shipping(5-7 business days): If RMAShipMethod value = 2
Expedited Shipping(3-5 business days): If RMAShipMethod value = 3
Two-Day Shipping(2 business days): If RMAShipMethod value = 4
One-Day Shipping(Next day): If RMAShipMethod value = 5
International Economy Shipping(8-15 business days): If RMAShipMethod value = 6
International Standard Shipping(5-7 business days): If RMAShipMethod value = 7
International Expedited Shipping (3-5 business days): If RMAShipMethod value = 8
International Two-Day Shipping(2 business days): If RMAShipMethod value = 9
APO/FPO – Military: If RMAShipMethod value = 10
Newegg Premier 3 Days: If RMAShipMethod value = 11
Newegg Premier 2 Days: If RMAShipMethod value = 12
Newegg Premier Next Day: If RMAShipMethod value = 13

If RMA type = Refund, this element will be blank.

Note: Newegg will apply the same ship method used in original order.

RMANote String Comment in this RMA if any noted
SellerPartNumber String The seller part number to identify seller’s item
ReturnQuantity Integer The return quantity of each item in RMA
ReturnUnitPrice Decimal If RMA type = Refund:

  • The return unit price of each item in refund RMA. How much refund will be issued per unit of this item
  • Newegg.com and Newggbusiness.com, all amounts are set in U.S. Dollars (USD)
  • Newegg.ca, all amounts are set in Can Dollars (CAD)

If RMA type = replacement, this element will be blank

RefundShippingPrice Decimal If RMA type = Refund:

  • The shipping amount of refund of each item in this RMA
  • Newegg.com and Newggbusiness.com, all amounts are set in U.S. Dollars (USD)
  • Newegg.ca, all amounts are set in Can Dollars (CAD)

If RMA type = replacement, this element will be blank

RMAReason Integer The replacement/refund reason of each item’s in RMA

Available values:

1: Carrier damage
2: Defective
3: Incompatible
4: No longer needed
5: Not match what we show
6: Ordered wrong item
7: Sent wrong item
8: Unsatisfied
9: Other Reason {0}

RMAReasonDescription String The replacement/refund reason of each item’s in RMA

Available values:

Carrier damage: If RMAReason value = 1
Defective: If RMAReason value = 2
Incompatible: If RMAReason value = 3
No longer needed: If RMAReason value = 4
Not match what we show: If RMAReason value = 5
Ordered wrong item: If RMAReason value = 6
Sent wrong item: If RMAReason value = 7
Unsatisfied: If RMAReason value = 8
Other Reason {0}: If RMAReason value = 9

Schema: UpdateRMAResponse.xsd

Example: XML, Response

<?xml version=”1.0” encoding=”utf-8”?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>RejectRMAResponse</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": "RejectRMAResponse",
    "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.

Error Code Description
SE001 Invalid SellerPartNumber.
SE015 TrackingNumber is required.
SE016 TrackingNumber already exists.
SE017 RMANumber is required.
SE028 Can’t update because RMA was not open.
SE029 Can’t update because RMA type = advanced. Please contact Newegg Marketplace Support.
SE030 Can’t update because international seller processing by Newegg.

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: March 20, 2023