Sale
The possible line types for a sale record. One of the possible order line types for a sale is an adjustment. Sales adjustments occur when a refund is issued for a line item that is either more or less than the total value of the line item. Examples are restocking fees and goodwill payments. When this happens, Shopify produces a sales agreement with sale records for each line item that is returned or refunded and an additional sale record for the adjustment (for example, a restocking fee). The sales records for the returned or refunded items represent the reversal of the original line item sale value. The additional adjustment sale record represents the difference between the original total value of all line items that were refunded, and the actual amount refunded.
Anchor to Valid valuesValid values
- Anchor to ADDITIONAL_FEEADDITIONAL_
FEE An additional fee.
- Anchor to ADJUSTMENTADJUSTMENT
A sale adjustment.
- Anchor to DUTYDUTY
A duty charge.
A fee charge.
- Anchor to GIFT_CARDGIFT_
CARD A gift card.
- Anchor to PRODUCTPRODUCT
A product purchased, returned or exchanged.
- Anchor to SHIPPINGSHIPPING
A shipping cost.
A tip added by the customer.
- Anchor to UNKNOWNUNKNOWN
An unknown sale line. Represents new types that may be added in future versions.
Anchor to FieldsFields
- •OBJECT
A sale associated with an additional fee charge.
- •OBJECT
A sale associated with an order price adjustment.
- •OBJECT
A sale associated with a duty charge.
- •OBJECT
A sale associated with a fee.
- •OBJECT
A sale associated with a gift card.
- •OBJECT
A sale associated with a product.
- •INTERFACE
An individual sale record associated with a sales agreement. Every money value in an order's sales data is represented in the currency's smallest unit. When amounts are divided across multiple line items, such as taxes or order discounts, the amounts might not divide evenly across all of the line items on the order. To address this, the remaining currency units that couldn't be divided evenly are allocated one at a time, starting with the first line item, until they are all accounted for. In aggregate, the values sum up correctly. In isolation, one line item might have a different tax or discount amount than another line item of the same price, before taxes and discounts. This is because the amount could not be divided evenly across the items. The allocation of currency units across line items is immutable. After they are allocated, currency units are never reallocated or redistributed among the line items.
- •OBJECT
A sale associated with a shipping charge.
- •OBJECT
A sale associated with a tip.
- •OBJECT
This is represents new sale types that have been added in future API versions. You may update to a more recent API version to receive additional details about this sale.