Skip to main content
object

Requires read_returns access scope.

A reverse delivery is a post-fulfillment object that represents a buyer sending a package to a merchant. For example, a buyer requests a return, and a merchant sends the buyer a shipping label. The reverse delivery contains the context of the items sent back, how they're being sent back (for example, a shipping label), and the current state of the delivery (tracking information).

Anchor to Fields and connectionsFields and connections

•ReverseDeliveryDeliverable

The deliverable associated with the reverse delivery.

•ID!non-null

The ID of the reverse delivery.

Anchor to reverseDeliveryLineItemsreverseDeliveryLineItems
•ReverseDeliveryLineItemConnection!non-null

The reverse delivery line items attached to the reverse delivery.

Anchor to reverseFulfillmentOrderreverseFulfillmentOrder
•ReverseFulfillmentOrder!non-null

The ReverseFulfillmentOrder associated with the reverse delivery.


Was this section helpful?

•query

Lookup a reverse delivery by ID.


Was this section helpful?

•mutation

Creates a new reverse delivery with associated external shipping information.

Arguments

•ReverseDeliveryLabelInputDefault:null

The return label file information for the reverse delivery.

•BooleanDefault:true

When true the customer is notified with delivery instructions if the ReverseFulfillmentOrder.order.email is present.

Anchor to reverseDeliveryLineItemsreverseDeliveryLineItems
•[ReverseDeliveryLineItemInput!]!required

The reverse delivery line items to be created. If an empty array is provided, then this mutation will create a reverse delivery line item for each reverse fulfillment order line item, with its quantity equal to the reverse fulfillment order line item total quantity.

Anchor to reverseFulfillmentOrderIdreverseFulfillmentOrderId
•ID!required

The ID of the reverse fulfillment order that's associated to the reverse delivery.

•ReverseDeliveryTrackingInputDefault:null

The tracking information for the reverse delivery.


Fields

•ReverseDelivery

The created reverse delivery.

•[ReturnUserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Updates a reverse delivery with associated external shipping information.

Arguments

•ReverseDeliveryLabelInputDefault:null

The return label file information for the reverse delivery.

•BooleanDefault:true

If true and an email address exists on the ReverseFulfillmentOrder.order, then the customer is notified with the updated delivery instructions.

•ID!required

The ID of the reverse delivery to update.

•ReverseDeliveryTrackingInputDefault:null

The tracking information for the reverse delivery.


Fields

•ReverseDelivery

The updated reverse delivery.

•[ReturnUserError!]!non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?

•interface

Was this section helpful?