Return

The date and time when the return was closed.

The date and time when the return was created.

Additional information about the declined return.

The exchange line items attached to the return.

A globally-unique ID.

The name of the return.

The order that the return belongs to.

The list of refunds associated with the return.

The date and time when the return was approved.

The return line items attached to the return.

The return shipping fees for the return.

The list of reverse fulfillment orders for the return.

The status of the return.

A suggested financial outcome for the return.

The sum of all return line item quantities for the return.

Retrieves a return by its ID. A return represents the intent of a buyer to ship one or more items from an order back to a merchant or a third-party fulfillment location.

Use the return query to retrieve information associated with the following workflows:

• Managing returns
• Processing exchanges
• Tracking reverse fulfillment orders

A return is associated with an order and can include multiple return line items. Each return has a status, which indicates the state of the return.

Removes return and/or exchange lines from a return.

Approves a customer's return request. If this mutation is successful, then the Return.status field of the approved return is set to OPEN.

Cancels a return and restores the items back to being fulfilled. Canceling a return is only available before any work has been done on the return (such as an inspection or refund).

Indicates a return is complete, either when a refund has been made and items restocked, or simply when it has been marked as returned in the system.

Creates a return from an existing order that has at least one fulfilled line item that hasn't yet been refunded. If you create a return on an archived order, then the order is automatically unarchived.

Use the returnCreate mutation when your workflow involves approving or declining requested returns outside of the Shopify platform.

The returnCreate mutation performs the following actions:

• Creates a return in the OPEN state, and assumes that the return request from the customer has already been approved
• Creates a reverse fulfillment order, and enables you to create a reverse delivery for the reverse fulfillment order
• Creates a sales agreement with a RETURN reason, which links to all sales created for the return or exchange
• Generates sales records that reverse the sales records for the items being returned
• Generates sales records for any exchange line items

After you've created a return, use the return query to retrieve the return by its ID. Learn more about providing a return management workflow for merchants.

Declines a return on an order. When a return is declined, each ReturnLineItem.fulfillmentLineItem can be associated to a new return. Use the ReturnCreate or ReturnRequest mutation to initiate a new return.

Process a return.

Reopens a closed return.

A customer's return request that hasn't been approved or declined. This mutation sets the value of the Return.status field to REQUESTED. To create a return that has the Return.status field set to OPEN, use the returnCreate mutation.