Calculated
Requires access scope.
A line item involved in order editing that may be newly added or have new changes applied.
Anchor to FieldsFields
- Anchor to calculatedDiscountAllocationscalculated•
Discount Allocations [CalculatedDiscount Allocation!]!non-null The discounts that have been allocated onto the line item by discount applications.
- Anchor to customAttributescustom•
Attributes [Attribute!]!non-null A list of attributes that represent custom features or special requests.
- Anchor to discountedUnitPriceSetdiscounted•
Unit Price Set MoneyBag!non-null The price of a single quantity of the line item with line item discounts applied, in shop and presentment currencies. Discounts applied to the entire order aren't included in this price.
- Anchor to editableQuantityeditable•
Quantity Int!non-null The total number of items that can be edited.
- Anchor to editableQuantityBeforeChangeseditable•
Quantity Before Changes Int!non-null The editable quantity prior to any changes made in the current edit.
- Anchor to editableSubtotalSeteditable•
Subtotal Set MoneyBag!non-null The total price of editable lines in shop and presentment currencies.
- Anchor to hasStagedLineItemDiscounthas•
Staged Line Item Discount Boolean!non-null Whether the calculated line item has a staged discount.
- •ID!non-null
A globally-unique ID.
- Anchor to imageimage•
The image object associated to the line item's variant.
- Anchor to originalUnitPriceSetoriginal•
Unit Price Set MoneyBag!non-null The variant unit price in shop and presentment currencies, without any discounts applied.
- Anchor to quantityquantity•Int!non-null
The total number of items.
- Anchor to restockablerestockable•Boolean!non-null
Whether the line item can be restocked or not.
- Anchor to restockingrestocking•Boolean!non-null
Whether the changes on the line item will result in a restock.
- •
The variant SKU number.
- Anchor to stagedChangesstaged•
Changes [OrderStaged Change!]!non-null A list of changes that affect this line item.
- Anchor to titletitle•String!non-null
The title of the product.
- Anchor to uneditableSubtotalSetuneditable•
Subtotal Set MoneyBag!non-null The total price of uneditable lines in shop and presentment currencies.
- Anchor to variantvariant•
The product variant associated with this line item. The value is null for custom line items and items where the variant has been deleted.
- Anchor to variantTitlevariant•
Title The title of the variant.
- Anchor to discountAllocationsdiscount•
Allocations [DiscountAllocation!]!non-null The discounts that have been allocated onto the line item by discount applications.
Anchor to MutationsMutations
- •mutation
Adds a custom line item to an existing order. For example, you could add a gift wrapping service as a custom line item. To learn how to edit existing orders, refer to Edit an existing order with Admin API.
- •ID!required
The ID of the calculated order to which the custom item is added.
- Anchor to locationIdlocation•
Id The ID of the retail location (if applicable) from which the custom item is sold. Used for tax calculations. A default location will be chosen automatically if none is provided.
- Anchor to priceprice•Money
Input!required The unit price of the custom item. This value can't be negative.
- Anchor to quantityquantity•Int!required
The quantity of the custom item. This value must be greater than zero.
- Anchor to requiresShippingrequires•
Shipping Whether the custom item requires shipping. Defaults to
false.- Anchor to taxabletaxable•
Whether the custom item is taxable. Defaults to
true.- Anchor to titletitle•String!required
The name of the custom item to add.
Arguments
- Anchor to calculatedLineItemcalculated•
Line Item The custom line item that will be added to the order based on the current edits.
- Anchor to calculatedOrdercalculated•
Order An order with the edits applied but not saved.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •
- •mutation
Adds a discount to a line item on the current order edit. For more information on how to use the GraphQL Admin API to edit an existing order, refer to Edit existing orders.
- Anchor to discountdiscount•Order
Edit Applied Discount Input!required The discount to add to the line item.
- •ID!required
The ID of the calculated order to update.
- Anchor to lineItemIdline•
Item Id ID!required The ID of the calculated line item to add the discount to.
Arguments
- Anchor to addedDiscountStagedChangeadded•
Discount Staged Change The discount applied to a line item during this order edit.
- Anchor to calculatedLineItemcalculated•
Line Item The line item with the edits applied but not saved.
- Anchor to calculatedOrdercalculated•
Order An order with the edits applied but not saved.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Adds a line item from an existing product variant. As of API version 2025-04, the orderEditAddVariant API will respect the contextual pricing of the variant.
- Anchor to allowDuplicatesallow•
Duplicates BooleanDefault:false Whether the mutation can create a line item for a variant that's already on the calculated order.
- •ID!required
The ID of the calculated order to edit.
- Anchor to locationIdlocation•
Id The ID of the location to check for inventory availability. A default location ID is chosen automatically if none is provided.
- Anchor to quantityquantity•Int!required
The quantity of the item to add to the order. Must be a positive value.
- Anchor to variantIdvariant•
Id ID!required The ID of the variant to add.
Arguments
- Anchor to calculatedLineItemcalculated•
Line Item The calculated line item that's added during this order edit.
- Anchor to calculatedOrdercalculated•
Order The calculated order with the edits applied but not saved.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Sets the quantity of a line item on an order that is being edited. For more information on how to use the GraphQL Admin API to edit an existing order, refer to Edit existing orders.
- •ID!required
The ID of the calculated order to edit. The edit changes the quantity on the line item.
- Anchor to lineItemIdline•
Item Id ID!required The ID of the calculated line item to edit.
- Anchor to locationIdlocation•
Id The ID of the location. If 'restock' is set to true, the restocked item will be made available at the specified location.
- Anchor to quantityquantity•Int!required
The new quantity to set for the line item. This value cannot be negative.
- Anchor to restockrestock•
Whether or not to restock the line item when the updated quantity is less than the original quantity.
Arguments
- Anchor to calculatedLineItemcalculated•
Line Item The calculated line item with the edits applied but not saved.
- Anchor to calculatedOrdercalculated•
Order The calculated order with the edits applied but not saved.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •
- •mutation
Removes a line item discount that was applied as part of an order edit.
- Anchor to discountApplicationIddiscount•
Application Id ID!required The ID of the calculated discount application to remove.
- •ID!required
The ID of the calculated order from which to remove the discount.
Arguments
- Anchor to calculatedLineItemcalculated•
Line Item The calculated line item after removal of the discount.
- Anchor to calculatedOrdercalculated•
Order An order with the edits applied but not saved.
- Anchor to userErrorsuser•
Errors [UserError!]!non-null The list of errors that occurred from executing the mutation.
Fields