ReturnPackageDetails

📘

Important

The Buy with Prime API is offered as a preview and might change as we receive feedback and iterate on the interfaces. We are sharing this early documentation to help you learn about the Buy with Prime API as we write and iterate on the content.

Overview

Represents delivery details for returned items.

Fields

FieldDescription
id (ID required)

Unique identifier for the return package.

packageTracker (PackageTracker)

Tracking information associated with the return package delivery, such as the tracking ID, carrier code, estimated delivery date and milestones

reason (String)

Reason associated to the return delivery state. Currently, the field is only present for failed delivery.

The value is constrained to one of the following

valuedescription
CARRIER_REJECTEDReturn delivery is rejected by Carrier
SHIPMENT_LOSTReturn delivery shipment is lost
UNDELIVERABLEFailure during Delivery
EXCEPTIONSome unknown error has been encountered
returnPackageFor (ReturnFor required)

Captures the association to entities against which this return package is created.

state (String required)

Current status of deliveryInformation.

The value is constrained to one of the following

valuedescription
CREATEDDelivery artifacts like Return Label are created and Delivery is currently pending.
DROPPED_OFFDelivery package dropped off by customer at drop off location
IN_TRANSITDelivery is currently in progress and tracking details have been added to the delivery.
DELIVEREDDelivery is successfully completed.
FAILEDDelivery has failed for one of the reasons mentioned in the reason.
instructions ([LocalizedString])

Instructions associated to return package.

labels ([ReturnLabel])

Return labels associated to return package.

packageTrackerIdentifier (PackageTrackerIdentifier)

Represents the unique identifier of a package tracker.

rma (String required)

RMA associated with the return package.