Return Helper

By Return Helper

Overview

Manage your Return Helper returns — right from ChatGPT. Connect ChatGPT to your Return Helper account to check on cross-border returns without leaving the chat. This connector lets you: - Look up return requests and their current status - Search warehouse inventory for received goods across your warehouses - Track shipments by tracking number, shipment number, or seller reference - View shipment status definitions and handling fee calculation types - Retrieve return photos and warehouse details Built for merchants and marketplace operators managing cross-border e-commerce returns.

Tools

disconnect

ChatGPT

Disconnects this connector from Return Helper: revokes this connection's access and refresh tokens, so the next connection must log in again. Call it only when the user asks to disconnect, sign out, log out, or switch Return Helper accounts. Afterwards every tool call fails until the user reconnects the connector; reconnecting always asks for a Return Helper login, so the user can sign in with another account. Returns a signOutUrl that also ends the Return Helper login in the user's browser.

get_return_image

ChatGPT

Attaches one Return Helper return photo by its file key. Take an s3OriginalFileKey (preferred) or s3MediumFileKey from get_return_request.returnRequestLineItems[].returnRequestLineItemImages[], get_return_request.returnInventoryList[].returnRequestLineItemImages[], or get_return_inventory.returnRequestLineItemImages[]. Returns the photo inline plus a permanent unauthenticated public url to the file; images over 3 MiB and files that are not JPEG, PNG, GIF, or WebP are not attached, but the url still is. Do not share the url outside the account. The url lookup is cached for 7 days; the photo bytes are fetched fresh each call.

get_return_inventory

ChatGPT

Returns a detailed, PII-stripped view of one Return Helper warehouse inventory record by returnInventoryId: the received item with its SKU, RMA, dimensions, weight, value, handling code and status, stock age, warehouse remarks, and VAS list (code, quantity, status). Get a returnInventoryId from get_return_request.returnInventoryList[].returnInventoryId or search_return_inventory.returnInventoryList[].returnInventoryId. Omits VAS file keys, VAS results and notes, warehouse meta maps, custom-field maps, and audit user names. returnRequestLineItemImages[] carries each photo's filename and original and medium image file keys; pass one to get_return_image to attach the photo. Valid warehouseId values come from the list_warehouses tool. Responses are cached for 5 minutes.

get_return_request

ChatGPT

Returns a detailed, PII-stripped view of one Return Helper return request by returnRequestId: header fields, line items, every shipment with its label metadata and tracking number, and — once the goods reach the warehouse — the received inventory with its RMAs. Get a returnRequestId from search_shipments (shipments[].returnRequestId). returnInventoryList and returnRequestLineItems[].rma are populated only once returnStatusCode is arrive-whs or completed. Join returnInventoryList[].returnRequestLineItemId to returnRequestLineItems[].returnRequestLineItemId. Omits every consignee and label name, phone, fax, email, street, city, state, and postal code, the shipping-label and QR-code download URLs, and VAS results and notes; country codes are kept. Line items and inventory records carry returnRequestLineItemImages[] with each photo's filename and original and medium image file keys; pass one to get_return_image to attach the photo. Valid warehouseId values come from the list_warehouses tool and valid shipmentStatusCode values from the list_shipment_statuses tool. Responses are cached for 5 minutes.

list_handling_fee_calculation_types

ChatGPT

Lists Return Helper handling fee calculation types and their descriptions. Cached up to 7 days.

list_shipment_statuses

ChatGPT

Lists Return Helper shipment status codes, names, and stage descriptions. Cached up to 7 days.

list_warehouses

ChatGPT

Lists the warehouses available to the current Return Helper account (owned plus previously used). Cached up to 7 days.

search_return_inventory

ChatGPT

Searches Return Helper warehouse inventory for goods already received, by warehouseRma, trackingNumber, shipmentNumber, sku, returnRequestNumber (matched against the shipment sellerReferenceNumber upstream), returnRequestSellerReferenceNumber, returnRequestLineItemNumber, handlingCode, or handlingStatusCode. Filters combine with AND. Results are sorted newest first by inventory creation time. Each comma-list field accepts up to 10 values. Omitted create dates fall back to the upstream default: the most recent 92 days when no other filter is set, or full history (2000-01-01..2199-12-31) when any other filter is set; omitted receive dates cover full history. Responses are cached for 5 minutes. Valid warehouseId values come from the list_warehouses tool. Omits image file keys, VAS results and notes, warehouse meta maps, custom-field maps, and audit user names; use get_return_request or get_return_inventory for photo keys.

search_shipments

ChatGPT

Prefer searching by sellerReferenceNumber, shipmentNumber, or trackingNumber for full history. Any other search is limited to the most recent 92 days. Filters combine with AND. Results are sorted newest first. Each of sellerReferenceNumber, shipmentNumber, trackingNumber, and returnRequestSellerReferenceNumber accepts up to 10 values. Responses are cached for 5 minutes. Valid shipmentStatusCode values come from the list_shipment_statuses tool. Valid warehouseId values come from the list_warehouses tool.