Only set for EXTERNAL labels, which have no Zonos shipment to read through. Null on ZONOS_GENERATED returns by design — a stored presigned URL expires. Read shipment { shipmentCartons { label { url } } } instead.
The Root this return was quoted against. Supplies the parties and cartons the shipment is built from, so the parcel ships against what was priced. Null until quoted.
The ServiceLevel accepted off that quote, as an ID or code. Required before a label can be created — otherwise the shipment inherits the outbound one's, often a carrier that cannot label.
The RETURN-direction Shipment this return produced. Resolves live, so tracking and status reflect the carrier rather than what was true when the label was bought. The label lives under it — shipment { shipmentCartons { label } } — rather than being duplicated here, so it survives a void-and-reissue and its url cannot expire.
Fields
attachments
[OrderReturnAttachment!]!
Required
carrier
String
createdAt
DateTime!
Required
createdBy
ID!
Required
customerNote
String
id
ID!
Required
labelSource
OrderReturnLabelSource!
Required
labelUrl
String
EXTERNALlabels, which have no Zonos shipment to read through. Null onZONOS_GENERATEDreturns by design — a stored presigned URL expires. Readshipment { shipmentCartons { label { url } } }instead.lines
[OrderReturnLine!]!
Required
linkedRefunds
[OrderRefund!]!
Required
merchantNote
String
order
Order!
Required
rootId
ID
Rootthis return was quoted against. Supplies the parties and cartons the shipment is built from, so the parcel ships against what was priced. Null until quoted.serviceLevel
String
ServiceLevelaccepted off that quote, as an ID or code. Required before a label can be created — otherwise the shipment inherits the outbound one's, often a carrier that cannot label.shipment
Shipment
RETURN-directionShipmentthis return produced. Resolves live, so tracking and status reflect the carrier rather than what was true when the label was bought. The label lives under it —shipment { shipmentCartons { label } }— rather than being duplicated here, so it survives a void-and-reissue and itsurlcannot expire.status
OrderReturnStatus!
Required
statusTransitions
[OrderReturnStatusTransition!]!
Required
trackingNumber
String
updatedAt
DateTime!
Required
updatedBy
ID!
Required