Amazon Bulk Return Request Initiator

WHAT IT DOES

This tool helps you quickly initiate return requests for multiple Amazon orders that are still within the return window. It scans your order history, identifies orders where the delivery date falls within a user-specified number of days (default 30), and checks for the presence of a Return button. Eligible orders are presented in a scrollable list with order details and checkboxes. You can then select which orders to return and initiate the return process for all selected orders sequentially. The tool navigates to each order's return page and automatically starts the return workflow.

WHERE IT RUNS

The script runs directly inside the Amazon web page on your order history page. It does not require a separate extension popup, background process, or external server. Everything happens within the page context, interacting with Amazon's DOM components. It works on the desktop version of Amazon's order history page (amazon.com/your-orders).

HOW TO USE

1. Navigate to your Amazon order history page (Your Account > Your Orders).

2. Open the BotGentz panel.

3. Set "Max days since delivery" to define your return window (default is 30 days).

4. Click "Scan & Return" to start the process.

5. The script will scan your order history, identify return-eligible orders, and display them in a list.

6. Select the orders you want to return (all are checked by default).

7. Click "Initiate Returns" to begin. The script will process each selected order one at a time, clicking the Return button and navigating through the return workflow.

8. Use "Ignore Selected" to add orders to an ignore list so they are not shown in future scans.

TECHNICAL MECHANISM

Unlike Amazon's built-in return flow, this script operates purely on the public DOM of the order history page. It identifies order cards using selectors like `.order-card` or `.a-box-group .a-box` and extracts order numbers from `.order-id` elements. Delivery dates are parsed from text patterns like "delivered on Month DD, YYYY" or "arrived on Month DD, YYYY". The script calculates the age of each order and checks eligibility against the user-defined threshold. It also verifies the presence of a Return button using text content matching "return" or "replace". For initiating returns, it clicks the Return button, waits for the return page to load, automatically selects the first item using checkbox or radio button detection, and clicks the Continue button. All actions include retry logic with spacing to handle Amazon's dynamic loading and asynchronous rendering.

THE PANEL

The tool appears as a draggable, resizable panel on the side of your screen. You can drag it to any position by clicking and holding the header, resize it by dragging the bottom-right corner, and collapse it to a small bubble when not in use. Press the Escape key to close the panel. The panel remembers its position and size per site (amazon.com) so it stays where you left it on your next visit.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not store any personal data except for a list of ignored order IDs, which is saved locally in your browser using GM_setValue. No data is sent to any external server. Amazon frequently updates its website, which may break the script. If you encounter issues, check for updates or contact support. Please note that this tool assists with navigating to the return page; you may still need to complete return details (reason, shipping method, etc.) manually. Use responsibly and respect Amazon's return policies.