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.

API name	Adverity UI name	Description	Use in Adverity
Barcode	Barcode	The barcode associated with the returned item, used for identification and tracking.	dimension
Carrier	Carrier	The shipping carrier responsible for handling the return.	dimension
Consolidation Tracking	Consolidation Tracking	This field represents a tracking identifier used for consolidating multiple return items into a single shipment.	dimension
Currency	Currency	The ISO 4217 currency code representing the store’s default currency for the return.	dimension
Customer Email	Customer Email	The email address of the customer who initiated the return.	dimension
Destination ID	Destination ID	The unique identifier for the shipping destination of the returned items.	metric
Exchange Variant	Exchange Variant	The variant selected by the customer as an exchange for a returned item.	dimension
Exchanges	Exchanges	A collection of details about items chosen as exchanges within the return.	dimension
Label Last Updated	Label Last Updated	The date and time when the return shipping label information was last updated, in ISO 8601 format.	dimension
Label Rate	Label Rate	The shipping cost incurred for the return label.	metric
Label Status	Label Status	The current status of the return shipping label, indicating its delivery progress.	dimension
Label URL	Label URL	The URL providing access to the return shipping label.	dimension
Line Item Discount	Line Item Discount	The discount amount applied to the specific line item within the return.	metric
Line Item ID	Line Item ID	The unique identifier for a specific line item included in the return.	metric
Line Item Price	Line Item Price	The price of the product associated with this line item.	metric
Line Item Refund	Line Item Refund	The refund amount allocated to this specific line item.	metric
Line Item Refund Net	Line Item Refund Net	The net refund amount for the individual line item after considering taxes and discounts.	metric
Line Item Refund Tax	Line Item Refund Tax	The tax amount included in the refund for this specific line item.	metric
Line Item Tax	Line Item Tax	The tax amount applied to the specific line item within the return.	metric
Multi Currency	Multi Currency	Indicates if the original order was processed using a currency different from the store’s default currency via Shopify Payments.	dimension
Order ID	Order ID	The unique identifier for the order as recognized by Loop Returns.	metric
Order Name	Order Name	The name assigned to the order.	dimension
Order Number	Order Number	The unique number identifying the order.	metric
Outcome	Outcome	The final resolution of the return process, as chosen by the customer and configured by the merchant (e.g., exchange, refund, store credit).	dimension
Package Reference	Package Reference	The reference data used to look up package details, often in a Warehouse Management System (WMS) software.	dimension
Parent Reason	Parent Reason	The primary category or higher-level reason for the return.	dimension
Parent Return Reason	Parent Return Reason	The primary category or higher-level reason for the return of a specific item.	dimension
Product ID	Product ID	The unique identifier for the product associated with this line item.	metric
Product Name	Product Name	The name of the product or line item.	dimension
Product Title	Product Title	The title or name of the product as it appears in the e-commerce store.	dimension
Provider Line Item ID	Provider Line Item ID	The unique identifier for the line item as provided by the e-commerce platform or external system.	metric
Provider Order ID	Provider Order ID	The unique identifier for the order as provided by Shopify.	metric
Provider Order Number	Provider Order Number	The order number as provided by Shopify.	metric
Provider Restock Location ID	Provider Restock Location ID	The identifier for the location where the returned item is intended to be restocked, as provided by the external system.	dimension
Reason	Reason	The specific reason provided for the return of an item.	dimension
Return Comment	Return Comment	Any additional comments provided by the customer regarding the reason for the return of a specific item.	dimension
Return Created Date	Return Created Date	The date and time when the return was initially created, in ISO 8601 format.	dimension
Return Created Datetime	Return Created Datetime	The date and time when the return was initially created, in ISO 8601 format.	dimension
Return ID	Return ID	The unique identifier for the return.	metric
Return Method	Return Method	The method used by the customer to send back the returned item (e.g., Happy Returns, mail).	dimension
Return Reason	Return Reason	The specific reason provided by the customer for returning the item.	dimension
Return Updated Datetime	Return Updated Datetime	The date and time when the return was last updated, in ISO 8601 format.	dimension
Returned At Datetime	Returned At Datetime	The date and time when the individual line item was marked as returned, in ISO 8601 format.	dimension
SKU	SKU	The Stock Keeping Unit (SKU) for the product variant.	dimension
State	State	The current status or lifecycle stage of the return (e.g., open, closed, cancelled, expired, review).	dimension
Status Page URL	Status Page URL	The URL for the customer-facing status page where the return’s progress can be tracked.	dimension
Tracking Number	Tracking Number	The tracking number assigned to the return shipment.	dimension
Type	Type	The classification of the return submission (e.g., standard, warranty).	dimension
Variant ID	Variant ID	The unique identifier for the specific product variant being returned.	metric