### Java Example: Get Order Information Source: https://developer.newegg.com/newegg_marketplace_api/create_your_own_client_library This Java example shows how to retrieve order information from the Newegg Marketplace API. It includes setup for SSL trust managers and hostname verification, and constructs a PUT request with XML payload. ```java /* * To change this template, choose Tools | Templates * And open the template in the editor. */ package marketplaceapi_java_demo; import java.io.BufferedReader; import java.io.InputStreamReader; import java.io.OutputStream; import java.net.MalformedURLException; import java.net.URL; import java.security.cert.X509Certificate; import java.util.Calendar; import javax.net.ssl.HostnameVerifier; import javax.net.ssl.HttpsURLConnection; import javax.net.ssl.SSLContext; import javax.net.ssl.SSLSession; import javax.net.ssl.TrustManager; import javax.net.ssl.X509TrustManager; public class MarketplaceAPI_Java_Demo { /** * @param args the command line arguments */ public static void main(String[] args) throws Exception{ GetOrderInfo(); } private static void GetOrderInfo() throws Exception{ System.out.println("[" + Calendar.getInstance().getTime() + "]Newegg Marketplace API - GetOrderInfo:"); System.out.println("-----------------------------------"); String requestUrl = "https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?sellerid=A006"; try { // Create a trust manager that does not validate certificate chains TrustManager[] trustAllCerts = new TrustManager[] {new X509TrustManager() { public java.security.cert.X509Certificate[] getAcceptedIssuers() { return null; } public void checkClientTrusted(X509Certificate[] certs, String authType) { } public void checkServerTrusted(X509Certificate[] certs, String authType) { } } }; // Install the all-trusting trust manager SSLContext sc = SSLContext.getInstance("SSL"); sc.init(null, trustAllCerts, new java.security.SecureRandom()); HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory()); // Create all-trusting host name verifier HostnameVerifier allHostsValid = new HostnameVerifier() { public boolean verify(String hostname, SSLSession session) { return true; } }; // Install the all-trusting host verifier HttpsURLConnection.setDefaultHostnameVerifier(allHostsValid); URL url = new URL(requestUrl); HttpsURLConnection httpsConnection = (HttpsURLConnection)url.openConnection(); //javax.net.ssl. = false; //Set accepted format in response message:application/xml|application/json httpsConnection.setRequestProperty("Accept", "application/xml"); //Set the accepted format in request body:application/xml|application/json httpsConnection.setRequestProperty("content-type", "application/xml"); //Set the request method:GET|PUT|POST httpsConnection.setRequestMethod("PUT"); //Set authorization key httpsConnection.setRequestProperty("Authorization", "720ddc067f4d115bd544aff46bc75634"); //Set secret-key httpsConnection.setRequestProperty("SecretKey", "21EC2020-3AEA-1069-A2DD-08002B30309D"); httpsConnection.setDoInput(true); httpsConnection.setDoOutput(true); String requestStr = "" + "GetOrderInfoRequest" + "" + "1" + "10" + "" + "" + "159243598" + "41473642" + "" + "1" + "1" + "2011-01-01 09:30:47" + "2011-12-17 09:30:47" + "0" + "" + "" + ""; byte[] requestBody = requestStr.getBytes(); //Set content-length httpsConnection.setRequestProperty("Content-Length", String.valueOf(requestBody.length)); OutputStream outStream = httpsConnection.getOutputStream(); outStream.write(requestBody); outStream.close(); InputStreamReader inputReader = new InputStreamReader(httpsConnection.getInputStream()); BufferedReader reader = new BufferedReader(inputReader); String responseBody = ""; while(reader.ready()){ responseBody += reader.readLine(); } reader.close(); inputReader.close(); System.out.println("[" + Calendar.getInstance().getTime() + "]Response Message:"); System.out.println("-----------------------------------"); System.out.println(responseBody); } catch (MalformedURLException ex) { System.out.println("Illegal request URI:" + ex.getMessage()); } catch(Exception e){ System.out.println("Exception:" + e.getMessage()); //Error Handling for Bad Request InputStreamReader errorReader = new InputStreamReader(httpsConnection.getErrorStream()); BufferedReader bufferReader = new BufferedReader(errorReader); String errorMsg = ""; while(bufferReader.ready()){ errorMsg += bufferReader.readLine(); } bufferReader.close(); errorReader.close(); System.out.println(errorMsg); } } } ``` -------------------------------- ### XML Request Example for Get Industry List Source: https://developer.newegg.com/newegg_marketplace_api/seller_management/get_industry_list This example shows how to construct an XML GET request to fetch the industry list. It includes necessary headers for authorization and content type. ```http GET https://api.newegg.com/marketplace/sellermgmt/seller/industry?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml ``` -------------------------------- ### JSON Request Example for Get Batch Price Source: https://developer.newegg.com/newegg_marketplace_api/item_management/get-batch-price-b2b-and-can This example shows how to make a POST request with a JSON payload to get batch pricing. Include the necessary headers for authentication and content type. ```json POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/pricelist?sellerid={SellerID} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/json Accept: application/json { "Type": "1", "Values": ["A006-TestItem-001","A006-TestItem-002","A006-TestItem-003"] } ``` -------------------------------- ### JSON Request Example for Get Industry List Source: https://developer.newegg.com/newegg_marketplace_api/seller_management/get_industry_list This example demonstrates how to make a JSON GET request to retrieve the industry list. Ensure the Content-Type and Accept headers are set to application/json. ```http GET https://api.newegg.com/marketplace/sellermgmt/seller/industry?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/json Accept: application/json ``` -------------------------------- ### Get Price Response Example Source: https://developer.newegg.com/newegg_marketplace_api/item_management/get_price This example demonstrates the structure of a successful response when retrieving price information. ```APIDOC ## Get Price Response ### Description This endpoint returns the pricing details for a given item, including various price points, shipping options, and promotion statuses across different countries. ### Response #### Success Response (200) - **SellerID** (string) - The unique identifier for the seller. - **ItemNumber** (string) - The unique identifier for the item. - **SellerPartNumber** (string) - The seller's part number for the item. - **PriceList** (object) - A list of price details for different countries. - **Price** (object) - Details for a specific country's pricing. - **CountryCode** (string) - The ISO 3-letter country code. - **Currency** (string) - The ISO 3-digit currency code. - **Active** (integer) - Indicates if the price is active (1) or inactive (0). - **MSRP** (decimal) - Manufacturer Suggested Retail Price. - **CheckoutMAP** (integer) - Indicates if Checkout MAP is enabled (1) or disabled (0). - **SellingPrice** (decimal) - The actual selling price of the item. - **EnableFreeShipping** (integer) - Indicates if free shipping is enabled (1) or disabled (0). - **OnPromotion** (string) - Comma-separated codes indicating active promotions. - **LimitQuantity** (integer) - The maximum quantity a customer can purchase within 48 hours. ### Response Example ```xml A006 9SIA0060884598 A006testitem201201021459 USA USD 0 25.99 0 20.92 1 1,5 2 IND INR 1 25.99 0 389.92 0 1,5 2 IRL EUR 0 25.99 0 19.92 0 2 ``` ``` -------------------------------- ### XML Request Example Source: https://developer.newegg.com/newegg_marketplace_api/sbn_shipped_by_newegg_management/get_inbound_shipment_request_result This example demonstrates how to make a GET request to retrieve inbound shipment results in XML format. Include your Authorization and SecretKey in the headers. ```http GET https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentresult/{requestid}?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml ``` -------------------------------- ### Get Order List Report Example Source: https://developer.newegg.com/newegg_marketplace_api/reports_management/get_report_result/get_order_list_report This example demonstrates how to retrieve a list of orders. The response includes pagination details and a list of orders, each with comprehensive information about the order and its items. ```APIDOC ## Get Order List Report ### Description Retrieves a list of orders with detailed information, including items, shipping, and customer details. Supports pagination. ### Method POST ### Endpoint /api/order/getorderlist ### Parameters #### Request Body - **SellerID** (string) - Required - The unique identifier for the seller. - **PageIndex** (integer) - Optional - The page number to retrieve. Defaults to 1. - **PageSize** (integer) - Optional - The number of records per page. Defaults to 10. - **QueryType** (string) - Optional - Specifies the type of query (e.g., 'ALL', 'UNPROCESSED'). - **OrderDateFrom** (string) - Optional - The start date for filtering orders (YYYY-MM-DD). - **OrderDateTo** (string) - Optional - The end date for filtering orders (YYYY-MM-DD). - **OrderStatus** (string) - Optional - Filters orders by their status. ### Request Example ```json { "SellerID": "V006", "PageIndex": 1, "PageSize": 10, "QueryType": "ALL", "OrderDateFrom": "2023-01-01", "OrderDateTo": "2023-01-31", "OrderStatus": "2" } ``` ### Response #### Success Response (200) - **NeweggAPIResponse** (object) - **IsSuccess** (string) - Indicates if the operation was successful. - **SellerID** (string) - The seller's unique identifier. - **OperationType** (string) - The type of operation performed. - **ResponseBody** (object) - **PageInfo** (object) - **TotalCount** (string) - Total number of orders matching the query. - **TotalPageCount** (string) - Total number of pages available. - **PageSize** (string) - Number of orders per page. - **PageIndex** (string) - Current page index. - **RequestID** (string) - Unique identifier for the request. - **RequestDate** (string) - Date and time the request was processed. - **OrderInfoList** (object) - **OrderInfo** (array of objects) - List of order details. - **SellerID** (string) - Seller's unique identifier for the order. - **OrderNumber** (string) - Newegg's order number. - **SellerOrderNumber** (string) - Seller's order number. - **InvoiceNumber** (string) - Invoice number associated with the order. - **OrderDownloaded** (string) - Indicates if the order has been downloaded. - **OrderDate** (string) - Date and time the order was placed. - **OrderStatus** (string) - Code representing the order status. - **OrderStatusDescription** (string) - Description of the order status. - **CustomerName** (string) - Name of the customer. - **CustomerPhoneNumber** (string) - Customer's phone number. - **ShipToAddress1** (string) - First line of the shipping address. - **ShipToAddress2** (string) - Second line of the shipping address. - **ShipToCityName** (string) - City of the shipping address. - **ShipToStateCode** (string) - State code of the shipping address. - **ShipToZipCode** (string) - Zip code of the shipping address. - **ShipToCountryCode** (string) - Country code of the shipping address. - **ShipService** (string) - Shipping service used for the order. - **ShipToFirstName** (string) - First name of the shipping recipient. - **ShipToLastName** (string) - Last name of the shipping recipient. - **ShipToCompany** (string) - Company name for shipping, if applicable. - **OrderItemAmount** (string) - Total amount for items in the order. - **ShippingAmount** (string) - Total shipping charges for the order. - **DiscountAmount** (string) - Total discount applied to the order. - **RefundAmount** (string) - Total refund amount for the order. - **RecyclingFeeAmount** (string) - Recycling fee, if applicable. - **OrderTotalAmount** (string) - Total amount of the order. - **OrderQty** (string) - Total quantity of items in the order. - **IsAutoVoid** (string) - Indicates if the order was automatically voided. - **SalesChannel** (integer) - The sales channel through which the order was placed. - **FulfillmentOption** (integer) - The fulfillment option for the order. - **ItemInfoList** (object) - **ItemInfo** (array of objects) - List of item details within the order. - **SellerPartNumber** (string) - Seller's part number for the item. - **NeweggItemNumber** (string) - Newegg's item number. - **MfrPartNumber** (string) - Manufacturer's part number. - **UPCCode** (string) - UPC code of the item. - **Description** (string) - Description of the item. - **OrderedQty** (string) - Quantity of the item ordered. - **ShippedQty** (string) - Quantity of the item shipped. - **UnitPrice** (string) - Unit price of the item. - **ExtendUnitPrice** (string) - Extended unit price. - **UnitShippingCharge** (string) - Unit shipping charge for the item. - **ExtendShippingCharge** (string) - Extended shipping charge for the item. - **Status** (string) - Item status code. - **StatusDescription** (string) - Description of the item status. - **AutoRegWarranty** (boolean) - Indicates if auto-registration warranty is applied. - **PackageInfoList** (null or object) - Information about packages, if available. - **Memo** (null) - Additional notes or memos. #### Response Example ```json { "NeweggAPIResponse": { "IsSuccess": "true", "SellerID": "V006", "OperationType": "GetOrderInfoResponse", "ResponseBody": { "PageInfo": { "TotalCount": "20", "TotalPageCount": "20", "PageSize": "10", "PageIndex": "1" }, "RequestID": "2PQBYWH4V68ZP", "RequestDate": "2/21/2012 14:38:17", "OrderInfoList": { "OrderInfo": [ { "SellerID": "V006", "OrderNumber": "155738158", "SellerOrderNumber": "2153930", "InvoiceNumber": "0", "OrderDownloaded": "false", "OrderDate": "12/21/2011 1:47:24", "OrderStatus": "4", "OrderStatusDescription": "Voided", "CustomerName": "Richard Chen", "CustomerPhoneNumber": "626-277-1420", "ShipToAddress1": "17708 Rowland St", "ShipToAddress2": null, "ShipToCityName": "Rowland Heights", "ShipToStateCode": "DC", "ShipToZipCode": "20001", "ShipToCountryCode": "USA", "ShipService": "Media Mail (7-14 business days)", "ShipToFirstName": "Richard", "ShipToLastName": "Chen", "ShipToCompany": null, "OrderItemAmount": "0.00", "ShippingAmount": "3.00", "DiscountAmount": "-5.00", "RefundAmount": "0.00", "RecyclingFeeAmount": "0.00", "OrderTotalAmount": "8.00", "OrderQty": "1", "IsAutoVoid": "false", "SalesChannel": 0, "FulfillmentOption": 1, "ItemInfoList": { "ItemInfo": [ { "SellerPartNumber": "Mike_A006_101478-151", "NeweggItemNumber": "9SIA00607Y6664", "MfrPartNumber": "Mike_A006_10114-151", "UPCCode": "410997000004", "Description": "Tungsten Ladies' Dome Ring w/ CZ", "OrderedQty": "1", "ShippedQty": "0", "UnitPrice": "5.00", "ExtendUnitPrice": "1.03", "UnitShippingCharge": "1.03", "ExtendShippingCharge": "1.03", "Status": "3", "StatusDescription": "Canceled", "AutoRegWarranty": false } ] }, "PackageInfoList": null } ] }, "Memo": null } } } ``` ### Error Handling Refer to the Failed Response Error Code List for common HTTP error responses. ``` -------------------------------- ### Get RMA Information Example Source: https://developer.newegg.com/newegg_marketplace_api/rma_management/get_rma_information This example demonstrates how to retrieve RMA information using the Newegg Marketplace API. ```APIDOC ## Get RMA Information ### Description Retrieves detailed information about a Return Merchandise Authorization (RMA), including item specifics, return reasons, shipping information, and refund status. ### Method GET ### Endpoint /rma/get ### Parameters #### Query Parameters - **rmaNumber** (string) - Required - The unique identifier for the RMA. - **rmaType** (string) - Optional - The type of RMA (e.g., Refund, Replacement). ### Request Example ```json { "NeweggAPIRequest": { "IsSuccess": "true", "OperationType": "GetRMAInfo", "SellerID": "A2GS", "RequestBody": { "RMANumber": "21964299" } } } ``` ### Response #### Success Response (200) - **RMAInfoList** (object) - Contains a list of RMA information objects. - **RMAInfo** (object) - Details of a single RMA. - **RMANumber** (string) - The unique RMA number. - **RMATypeDescription** (string) - Description of the RMA type. - **SellerRMANumber** (string) - The seller's RMA number. - **RMADate** (string) - The date the RMA was issued. - **RMAStatusDescription** (string) - Description of the RMA status. - **OrderNumber** (string) - The associated order number. - **OrderDate** (string) - The date of the associated order. - **InvoiceNumber** (string) - The invoice number for the order. - **OrderAmount** (string) - The total amount of the order. - **AvailableRefundAmount** (string) - The amount currently available for refund. - **CustomerName** (string) - The name of the customer. - **CustomerEmailAddress** (string) - The email address of the customer. - **ReturnShippingLabel** (object) - Information about the return shipping label. - **TrackingNumber** (string) - The tracking number for the return shipment. - **TrackingURL** (string) - The URL to track the return shipment. - **LabelEstimateCost** (string) - The estimated cost of the shipping label. - **PaidBy** (string) - Indicates who paid for the shipping label (Seller/Newegg). - **RMATransactionList** (object) - A list of transactions associated with the RMA. - **RMATransaction** (object) - Details of a single RMA transaction. - **SellerPartNumber** (string) - The seller's part number for the item. - **MfrPartNumber** (string) - The manufacturer's part number for the item. - **NeweggItemNumber** (string) - Newegg's item number. - **Description** (string) - Description of the item. - **UnitPrice** (string) - The unit price of the item. - **ReturnQuantity** (string) - The quantity of the item being returned. - **ReturnUnitPrice** (string) - The unit price for the return. - **RefundShippingPrice** (string) - The amount of shipping cost to be refunded. - **RMAReasonDescription** (string) - Description of the reason for the RMA. #### Response Example ```json { "NeweggAPIResponse": { "IsSuccess": "true", "OperationType": "GetRMAInfo", "SellerID": "A2GS", "ResponseBody": { "PageInfo": { "TotalCount": "1", "TotalPageCount": "1", "PageIndex": "1", "PageSize": "100" }, "RMAInfoList": { "RMAInfo": { "RMANumber": "21964299", "RMAType": "2", "RMATypeDescription": "Refund", "SellerRMANumber": "TestRMAA2GS20200305101", "IssueUser": "A2GS", "RMADate": "03/03/2020 17:16:49", "RMAStatus": "1", "RMAStatusDescription": "Open", "OrderNumber": "458765952", "OrderDate": "01/22/2020 19:03:37", "InvoiceNumber": "175154088", "OrderAmount": "0.81", "AvailableRefundAmount": "0.26", "RMAProcessedBy": "Newegg", "RMANote": "Test--This is a test RMA TestRMAA2GS20200305101 1001", "PriorRefundAmount": "0.40", "CustomerName": "Michael Liang", "CustomerPhoneNumber": "435-432-1431", "CustomerEmailAddress": "cusatest@marketplace.newegg.com", "ShipToAddress1": "17709 Rowland St", "ShipToAddress2": "", "ShipToCityName": "Rowland Heights", "ShipToStateCode": "CA", "ShipToZipCode": "91748-1108", "ShipToCountryCode": "UNITED STATES", "ShipToLastName": "Liang", "ShipToFirstName": "Michael", "ShipToCompany": "", "ReturnShippingLabel": { "Label": { "TrackingNumber": "1ZA813779092080471", "TrackingURL": "http://www.newegg.com/info/trackOrder.aspx?trackingnumber=1ZA813779092080471&Type=1", "LabelEstimateCost": "6.19", "PaidBy": "Seller" } }, "RMATransactionList": { "RMATransaction": { "SellerPartNumber": "Test_SP#AJST_201904090006", "MfrPartNumber": "Test_MP#201904090006", "NeweggItemNumber": "9SIA2GS9212178", "Description": "Test_Item Website Short Title 20190409_0006", "UnitPrice": "0.01", "ReturnQuantity": "1", "ReturnUnitPrice": "0.01", "RefundShippingPrice": "0.10", "RMAReason": "4", "RMAReasonDescription": "No longer needed" } } } } }, "ResponseDate": "03/06/2020 16:22:42" } } ``` ``` -------------------------------- ### Get Batch Inventory Response Example Source: https://developer.newegg.com/newegg_marketplace_api/item_management/get-batch-inventory This example demonstrates the structure of a successful response when retrieving batch inventory data. ```APIDOC ## Get Batch Inventory Response ### Description Returns a list of items with their corresponding inventory details. ### Response Body - **ItemList** (array) - A list of inventory items. - **ItemNumber** (string) - The unique identifier for the item. - **SellerPartNumber** (string) - The seller's part number for the item. - **Condition** (integer) - The condition of the item (e.g., 1 for New). - **InventoryAllocation** (array) - Details about inventory allocation per warehouse. - **WarehouseLocation** (string) - The location of the warehouse. - **FulfillmentOption** (string) - The fulfillment option (e.g., "0"). - **AvailableQuantity** (integer) - The number of available units. - **TotalCount** (integer) - The total number of items returned. - **IsSuccess** (boolean) - Indicates if the operation was successful. - **OperationType** (string) - The type of operation performed (e.g., "GetInventoryList"). - **SellerID** (string) - The seller's unique identifier. - **ResponseDate** (string) - The date and time the response was generated. ### Response Example ```json { "ResponseBody": { "ItemList": [ { "ItemNumber": "9SIA00603V5190", "SellerPartNumber": "A006-TestItem-001", "Condition": 1, "InventoryAllocation": [ { "WarehouseLocation": "USA", "FulfillmentOption": "0", "AvailableQuantity": 10 }, { "WarehouseLocation": "AUS", "FulfillmentOption": "0", "AvailableQuantity": 0 } ] }, { "ItemNumber": "9SIA00603V5191", "SellerPartNumber": "A006-TestItem-002", "Condition": 1, "InventoryAllocation": [ { "WarehouseLocation": "USA", "FulfillmentOption": "0", "AvailableQuantity": 5 }, { "WarehouseLocation": "AUS", "FulfillmentOption": "0", "AvailableQuantity": 10 } ] }, { "ItemNumber": "9SIA00603V5192", "SellerPartNumber": "A006-TestItem-003", "Condition": 1, "InventoryAllocation": [ { "WarehouseLocation": "USA", "FulfillmentOption": "0", "AvailableQuantity": 15 }, { "WarehouseLocation": "AUS", "FulfillmentOption": "0", "AvailableQuantity": 20 } ] } ], "TotalCount": 3 }, "IsSuccess": true, "OperationType": "GetInventoryList", "SellerID": "A006", "ResponseDate": "2022-04-20T23:46:41.7786361-07:00" } ``` ``` -------------------------------- ### Get RMA List Report Example Source: https://developer.newegg.com/newegg_marketplace_api/reports_management/get_report_result/get_rma_list_report This example demonstrates how to retrieve an RMA list report. It includes sample data for customer information, return shipping labels, and transaction details. ```APIDOC ## Get RMA List Report ### Description Retrieves a list of RMA (Return Merchandise Authorization) reports, including customer details, return shipping information, and itemized refund data. ### Method GET ### Endpoint /reports/rma/list ### Query Parameters - **SellerID** (string) - Required - The unique identifier for the seller. - **RMAStatus** (string) - Optional - The status of the RMA (e.g., 'Open', 'Closed'). - **StartDate** (string) - Optional - The start date for filtering reports (YYYY-MM-DD). - **EndDate** (string) - Optional - The end date for filtering reports (YYYY-MM-DD). ### Response #### Success Response (200) - **RmaList** (array) - A list of RMA report objects. - **RmaNumber** (string) - The RMA number. - **RmaDate** (string) - The date the RMA was created. - **CustomerName** (string) - The name of the customer. - **CustomerPhoneNumber** (string) - The customer's phone number. - **CustomerAddress** (string) - The customer's shipping address. - **RMANote** (string) - Notes associated with the RMA. - **ReturnShippingLabel** (array) - Details about the return shipping label. - **TrackingNumber** (string) - The tracking number for the return shipment. - **TrackingURL** (string) - The URL to track the return shipment. - **LabelEstimateCost** (number) - The estimated cost of the shipping label. - **PaidBy** (string) - Who paid for the return shipping. - **RMATransactionList** (array) - A list of items included in the RMA. - **SellerPartNumber** (string) - The seller's part number for the item. - **MfrPartNumber** (string) - The manufacturer's part number for the item. - **NeweggItemNumber** (string) - The Newegg item number. - **Description** (string) - A description of the item. - **UnitPrice** (number) - The unit price of the item. - **RefundInfo** (object) - Information about the refund for the item. - **ItemReturnQty** (integer) - The quantity of the item returned. - **ItemRefundPerQty** (number) - The refund amount per unit. - **ItemShippingRefund** (number) - The shipping refund amount for the item. - **RMATotalRefund** (number) - The total refund amount for the item. - **RefundReason** (integer) - The code for the refund reason. - **RefundReasonDescription** (string) - A description of the refund reason. ### Response Example ```json { "RmaList": [ { "RmaNumber": "RMA123456789", "RmaDate": "2023-10-27T10:00:00Z", "CustomerName": "Jian Qin", "CustomerPhoneNumber": "626-347-5618", "CustomerAddress": "17708 Rowland St, Rowland Heights, CA, 91748-1119, USA", "RMANote": "Test Test TestRMAA2GS202001231001 your note here", "ReturnShippingLabel": [ { "TrackingNumber": "1ZA813779097504156", "TrackingURL": "http://www.newegg.com/info/trackOrder.aspx?trackingnumber=1ZA813779097504156&Type=1", "LabelEstimateCost": 6.19, "PaidBy": "Customer" } ], "RMATransactionList": [ { "SellerPartNumber": "Test_SPA2GS_20190930_3002", "MfrPartNumber": "TestMP#A2GS190930_32", "NeweggItemNumber": "9SIA2GSAAK6919", "Description": "Test_Item Website Short Title A2GS 20190930 30002", "UnitPrice": 0.01, "RefundInfo": { "ItemReturnQty": 1, "ItemRefundPerQty": 0.01, "ItemShippingRefund": 0, "RMATotalRefund": 0.01, "RefundReason": 1, "RefundReasonDescription": "Carrier damage" } } ] } ] } ``` ### Error Handling Refer to the 'Failed Response Error Code List' for common HTTP error responses. Examples are provided for both XML and JSON error formats. ``` -------------------------------- ### Get RMA List Report Example Source: https://developer.newegg.com/newegg_marketplace_api/reports_management/get_report_result/get_rma_list_report This example demonstrates how to retrieve a list of RMA reports. It includes details about the RMA, associated order, customer, and transaction items. ```APIDOC ## Get RMA List Report ### Description Retrieves a list of RMA (Return Merchandise Authorization) reports for a seller, including details about each RMA, the associated order, customer information, and transaction items. ### Method GET (Assumed, as no method is explicitly provided, but typical for list retrieval) ### Endpoint /api/v1/rma/list ### Parameters #### Query Parameters - **sellerId** (string) - Required - The unique identifier for the seller. - **rmaNumber** (string) - Optional - Filter by a specific RMA number. - **orderNumber** (string) - Optional - Filter by a specific order number. - **rmaStatus** (string) - Optional - Filter by RMA status (e.g., 'Open', 'Closed'). - **startDate** (string) - Optional - Filter by start date for RMA creation (YYYY-MM-DD). - **endDate** (string) - Optional - Filter by end date for RMA creation (YYYY-MM-DD). - **pageIndex** (integer) - Optional - The page number for pagination. - **pageSize** (integer) - Optional - The number of items per page. ### Request Example ```json { "sellerId": "A2GS", "rmaNumber": "22187609", "orderNumber": "461654091" } ``` ### Response #### Success Response (200) - **RMAInfoList** (array) - A list of RMA information objects. - **SellerID** (string) - The seller's ID. - **RMANumber** (integer) - The RMA number. - **SellerRMANumber** (string) - The seller's custom RMA number. - **RMATypeDescription** (string) - Description of the RMA type (e.g., 'Refund'). - **RMADate** (string) - The date the RMA was created. - **RMAStatusDescription** (string) - Description of the current RMA status. - **OrderNumber** (integer) - The associated order number. - **OrderDate** (string) - The date the order was placed. - **InvoiceNumber** (integer) - The invoice number for the order. - **OrderAmount** (number) - The total amount of the order. - **CustomerName** (string) - The name of the customer. - **CustomerPhoneNumber** (string) - The customer's phone number. - **CustomerAddress** (string) - The customer's shipping address. - **RMANote** (string) - Any notes associated with the RMA. - **ReturnShippingLabel** (array) - Information about the return shipping label. - **TrackingNumber** (string) - The tracking number for the return shipment. - **TrackingURL** (string) - The URL to track the return shipment. - **RMATransactionList** (array) - A list of items included in the RMA transaction. - **SellerPartNumber** (string) - The seller's part number for the item. - **MfrPartNumber** (string) - The manufacturer's part number for the item. - **NeweggItemNumber** (string) - Newegg's item number. - **Description** (string) - Description of the item. - **UnitPrice** (number) - The unit price of the item. - **RefundInfo** (object) - Details about the refund for the item. - **ItemReturnQty** (integer) - The quantity of the item returned. - **ItemRefundPerQty** (number) - The refund amount per unit. - **ItemShippingRefund** (number) - The shipping refund amount for the item. - **RMATotalRefund** (number) - The total refund amount for the item. - **RefundReasonDescription** (string) - Description of the refund reason. #### Error Response (400) - **IsSuccess** (boolean) - False if the request failed. - **Message** (string) - Error message describing the failure. ### Response Example ```json { "ResponseDate": "03/05/2020 22:42:44", "IsSuccess": true, "OperationType": "GetRMAListInfoResponse", "SellerID": "A2GS", "ResponseBody": { "PageInfo": { "TotalCount": 1, "TotalPageCount": 1, "PageIndex": 1, "PageSize": 100 }, "RequestID": "237F788KK8LS0", "RequestDate": "03/05/2020 22:20:08", "RMAInfoList": [ { "SellerID": "A2GS", "RMANumber": 22187609, "SellerRMANumber": "TestRMAA2GS202001231001", "RMAType": 2, "RMATypeDescription": "Refund", "RMADate": "01/19/2020 19:24:46", "RMAStatus": 1, "RMAStatusDescription": "Open", "LastEditDate": "01/22/2020 17:30:39", "LastEditUser": "Seller", "OrderNumber": 461654091, "OrderDate": "11/01/2019 23:36:12", "InvoiceNumber": 172997652, "OrderAmount": 0.05, "RMAProcessedBy": "Seller", "CustomerName": "Jian Qin", "CustomerPhoneNumber": "626-347-5618", "CustomerAddress": "17708 Rowland St, Rowland Heights, CA, 91748-1119, USA", "RMANote": "Test Test TestRMAA2GS202001231001 your note here", "ReturnShippingLabel": [ { "TrackingNumber": "1ZA813779097504156", "TrackingURL": "http://www.newegg.com/info/trackOrder.aspx?trackingnumber=1ZA813779097504156&Type=1", "LabelEstimateCost": 6.19, "PaidBy": "Customer" } ], "RMATransactionList": [ { "SellerPartNumber": "Test_SPA2GS_20190930_3002", "MfrPartNumber": "TestMP#A2GS190930_32", "NeweggItemNumber": "9SIA2GSAAK6919", "Description": "Test_Item Website Short Title A2GS 20190930 30002", "UnitPrice": 0.01, "RefundInfo": { "ItemReturnQty": 1, "ItemRefundPerQty": 0.01, "ItemShippingRefund": 0, "RMATotalRefund": 0.01, "RefundReason": 1, "RefundReasonDescription": "Carrier damage" } } ] } ] } } ``` ``` -------------------------------- ### Get Order Information Request Example (XML) Source: https://developer.newegg.com/newegg_marketplace_api/order_management/get_order_information_can An example of an XML request to retrieve order information. This includes specifying order numbers, status, date ranges, and other criteria. ```xml PUT https://api.newegg.com/marketplace/can/ordermgmt/order/orderinfo?sellerid={sellerid}&version={version} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml GetOrderInfoRequest 1 10 159243598 41473642 SO159243598 SO41473642 1 1 2011-01-01 09:30:47 2011-12-17 09:30:47 0 ```