Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Loop Returns: Most-used fields

The table below gives information about most-used fields that you can import from Loop Returns. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

FieldAdverity UI nameType
BarcodeDimension

The barcode associated with the returned item, used for identification and tracking.

CarrierDimension

The carrier service used for the return.

Consolidation TrackingDimension

The tracking number for a consolidated shipment containing this return item, such as a Happy Returns Outbound Shipment tracking number.

CurrencyDimension

The currency code of the store's default currency.

Customer EmailDimension

The email address of the customer who initiated the return.

Destination IDDimension

The unique identifier for the return's destination.

Exchange VariantDimension

The variant of the product chosen as an exchange.

ExchangesDimension

A list of exchange orders associated with the return.

Label Last UpdatedDimension

The date and time (ISO 8601 format) when the return label was last updated.

Label RateMetric

The shipping rate that was paid for the return label.

Label StatusDimension

The current delivery status of the return label.

Label URLDimension

The URL link to the generated shipping label.

Line Item DiscountMetric

The total discount applied to the individual line item.

Line Item IDDimension

The unique identifier for a specific line item included in the return.

Line Item PriceMetric

The price of the individual line item.

Line Item RefundMetric

The total refund amount for the individual line item.

Line Item Refund NetMetric

This line item's portion of the refunded amount, excluding shipping costs.

Line Item Refund TaxMetric

The tax portion of the refund for the individual line item.

Line Item TaxMetric

The tax applied to the individual line item.

Multi CurrencyDimension

Indicates whether the original order was placed using a currency different from the store's default currency.

Order IDDimension

The internal Loop order identifier associated with the return.

Order NameDimension

The human-readable name of the order.

Order NumberDimension

The sequential number of the order.

OutcomeDimension

The chosen resolution for the return, such as an exchange, refund, or store credit.

Package ReferenceDimension

A reference number associated with the return package.

Parent ReasonDimension

The primary category or higher-level reason for the return.

Parent Return ReasonDimension

The main category of the reason for returning the line item.

Product IDDimension

The unique identifier of the product being returned.

Product NameDimension

The name of the product or line item.

Product TitleDimension

The title or name of the product being returned.

Provider Line Item IDDimension

The unique identifier for the line item as provided by the commerce platform (e.g., Shopify).

Provider Order IDDimension

The unique identifier for the order as provided by the commerce platform (e.g., Shopify).

Provider Order NumberDimension

The order number as provided by the commerce platform (e.g., Shopify).

Provider Restock Location IDDimension

The unique identifier of the location where the returned item is intended to be restocked by the commerce provider.

ReasonDimension

The specific reason provided for the return of an item.

Return CommentDimension

An internal comment or note associated with the entire return for communication and record-keeping purposes. These notes are visible on the return's timeline within the Loop admin interface.

Return Created DateDimension

The date and time when the return was initially created, in ISO 8601 format.

Return Created DatetimeDimension

The date and time when the return was initially created, in ISO 8601 format.

Return IDDimension

The unique identifier assigned to the return within Loop Returns.

Return MethodDimension

The method chosen for the return, such as mail-in or Happy Returns.

Return ReasonDimension

The specific reason provided by the customer for returning the line item.

Return Updated DatetimeDimension

The date and time (ISO 8601 format) when the return was last updated.

Returned At DatetimeDimension

The date and time (ISO 8601 format) when the individual line item was marked as returned.

SKUDimension

The Stock Keeping Unit (SKU) for the product variant.

StateDimension

The current status of the return (e.g., pending, cancelled, processed).

Status Page URLDimension

The URL link to the customer-facing status page for the return.

Tracking NumberDimension

The tracking number associated with the return shipment.

TypeDimension

The category or type of return submission, such as standard or warranty.

Variant IDDimension

The unique identifier of the specific product variant being returned.

Variant NameDimension

The name or title of the specific product variant returned. This helps distinguish between different versions of a product, such as size or color.