Cart types

The types the cart domain defines, with the fields other domains add to them.

Objects

`AddressSuggestion`

An address offered while the buyer types, to be resolved once chosen

Field	Type	Description
`id`	`ID!`	Opaque; pass it to addressResolve
`label`	`String!`	The address as the buyer reads it in a list
`city`	`String`
`country`	`CountryCode`
`streetNumber`	`String`
`streetNumberSuffix`	`String`
`postalCode`	`String`
`streetName`	`String`

`AddressValidationResult`

Field	Type	Description
`valid`	`Boolean!`
`suggestions`	`[AddressSuggestion]`

`AppliedDiscount`

A discount applied to a cart or one of its lines, by the name it is known by.

Field	Type	Description
`id`	`ID!`	Identifier of the discount
`name`	`String`	The discount's name in the store's language. Null where it has none.
`amount`	`Money!`	What the discount takes off, as a positive amount.
`validUntil`	`DateTime`	The last moment the discount applies, where it ends. Null where it does not end, or the engine does not tell.

`Cart`

Fields added by Delivery options, Multiple carts and Order approval

Shopping cart containing line items and checkout information

Field	Type	Description
`id`	`ID!`	Unique identifier of the cart. Stable for the cart's whole life, so a client may key a cache on it.
`version`	`String`	Opaque optimistic-concurrency token, present only for engines that version their resources. Pass it back verbatim; never parse or compare it.
`createdAt`	`DateTime!`	Creation date of the cart
`lastModifiedAt`	`DateTime!`	Last modified date of the cart
`currency`	`Currency!`	The currency used in the cart
`customerEmail`	`String`	Customer email
`isGuest`	`Boolean!`	Indicates if the cart is a guest cart
`lineItems`	`[CartLineItem!]!`	Line items in the cart
`totalQuantity`	`Int!`	Total quantity of all line items
`changes`	`[CartLineChange!]!`	What changed since the session last acknowledged the cart, oldest first: sold-out lines, price changes against the price at the time of adding, and lowered quantities. Listed until cartChangesAcknowledge, so a notice shows them once.
`unavailableLineItems`	`[CartLineItem!]!`	Lines that cannot be ordered now, such as sold out. They are kept out of the totals and out of the order. Empty where the engine cannot keep them: those are removed instead, and listed in changes as REMOVED.
`subTotal`	`TaxedTotalPrice!`	Sum of all line items (i.e. price excluding all shipping and payment costs)
`total`	`TaxedTotalPrice!`	Sum of all line items (i.e. price including all shipping and payment costs)
`discountTotal`	`TaxedPrice`	Discount applied to the cart total, on top of any discount already reflected in the line items. A positive magnitude: subtract it, never add it. Showing it as a negative amount is a presentation choice, not a property of the data. Taxed like the amounts it has to be arithmetic with, so a summary reconciles in one basis: subTotal minus this plus shippingCosts equals total. The rate is the effective rate over the discounted goods -- exact for a single-rate basket, a blend where the basket mixes rates.
`discountCodes`	`[CartDiscountCode!]!`	Discount codes that are applied to the cart
`appliedDiscounts`	`[AppliedDiscount!]`	Every discount the cart applies, on its total, its lines or its shipping, with what it takes off in all: the names a summary explains the price with. A reduced price the product itself carries is not one of them. A discount reached through a code is also in discountCodes; the rest are automaticDiscounts. Null where the engine does not report its discounts.
`automaticDiscounts`	`[AppliedDiscount!]`	The discounts the cart gets without a code, such as an automatic promotion, each with what it takes off: the entries of appliedDiscounts that no code brought, so adding the two lists counts these twice. Together with discountCodes they explain discountTotal row by row. Null where the engine does not report its discounts.
`billingAddress`	`Address`	Customer billing address
`shippingAddress`	`Address`	Customer shipping address
`shippingCosts`	`TaxedPrice`	Shipping costs, if any
`estimatedShippingCosts`	`TaxedPrice`	What shipping will likely cost while no shipping method is set, so a summary can show a total before checkout. An estimate: null once shippingCosts is known, and where the engine has nothing to base one on.
`freeDelivery`	`CartFreeDelivery`	How far the cart is from free delivery: the goods total at which shipping becomes free, and how much is still to add. Read from the chosen shipping method's rate, or the default method's for the store's country while none is chosen. Null where that rate has no free threshold, and where the cart ships outside the store's country without a method chosen.
`complementaryProducts`	`[ProductVariant!]!`	Products to suggest alongside what is in the cart, such as below its lines: the complementary products of its lines, the most recently added line's first, without those already in the cart, and only what can be sold in the store and is in stock. At most limit of them, and never more than 10.Arguments: `limit`
`selectedShippingMethod`	`ShippingMethod`	Selected shipping method for the cart
`preselectedShippingMethod`	`ShippingMethod`	The shipping method the delivery step starts on: the selected one once there is one, otherwise the default method for the shipping address's country or, before there is an address, the store's. Its price is what the cart is charged for it, after the rate's tiers and free threshold, and with the delivery options composed its carrier and deliveryEstimate say who brings it and when. Null when no method ships there.
`selectedPaymentMethod`	`PaymentMethod`	Selected payment method for the cart
`amountToPay`	`Money!`	What the buyer still has to pay: the gross total less everything the cart's payments have reserved or collected. Equal to the gross total while no payment holds anything. A partial payment such as a gift card lowers this and never total, subTotal, discountTotal or any tax: the price of the goods is the same whoever pays for it.
`payments`	`[CartPayment!]!`	The payments on the cart, oldest first. A cart can carry several: partial payments such as gift cards, and the payment that pays the rest.
`availableShippingMethods`	`[ShippingMethod!]!`	Shipping methods that are available for the cart
`deliveryRemarks`	`String`	Note for whoever delivers the goods, as the buyer typed it -- "please leave it under the shelter". Carried to the order. Null until someone records one.
`vatNumber`	`String`	The VAT number of the company the buyer orders for, as recorded at checkout. Carried to the order. Null until someone records one. A verified number can make the cart reverse-charged; see vatOutcome.
`vatShifting`	`Money`	The amount of a reverse-charge line, negative and already reflected in total, where one is carried. A reverse-charged cart is taxed at 0% and gets no such line, so this is null on it.Deprecated: A reverse-charged cart is taxed at 0%; read vatOutcome and the taxed totals.
`vatExemption`	`Money`	The amount of an export line, negative and already reflected in total, where one is carried. An exported cart is taxed at 0% and gets no such line, so this is null on it.Deprecated: An exported cart is taxed at 0%; read vatOutcome and the taxed totals.
`vatOutcome`	`VatOutcome`	Which VAT rule the cart's amounts follow, and why, so a checkout can explain them. Decided by the delivery country and the buyer's VAT number, or for a cart bought for a business unit, the company's VAT registrations; the billing country never counts. Null until the cart has a delivery address or a pickup at the seller, and where the engine does not decide VAT itself. The rules are the standard EU rules for goods and have not been reviewed by a tax advisor.
`purchaseOrderNumber`	`String`	The buyer's own reference for this purchase, usually a purchase order number. Carried to the resulting order so a finance team can match it against their own paperwork. Null until someone records one, which only an associate of the cart's business unit can, through cartSetPurchaseOrderNumber.
`minimumOrder`B2B	`CartMinimumOrder`	The business unit's minimum order value. Null when the unit has none, when it is set in another currency than the cart's, and for a cart that is not a business unit's. Below it orderPlace is refused; requesting a quote is not.
`availablePaymentMethods`	`[PaymentMethod!]!`	Payment methods that are available for the cartArguments: `device`
`deliveryDates`	`[DeliveryDate!]!`	The dates the cart can be delivered on, each with its time slots, starting at from (today when absent) and covering the given number of days. Every date in the range is listed, including those with nothing to offer, so a date picker can show them disabled with their reason. Empty while the cart has no shipping address to deliver to.Arguments: `from`, `days`
`deliverySlot`	`DeliverySlot`	The delivery slot chosen for the cart. Null until one is chosen.
`pickupPoints`	`[PickupPoint!]!`	Pickup points the cart can be collected from, nearest first, including those that cannot be chosen. Searched around near, or the shipping address when near is absent; empty when there is neither. carrierKeys narrows the list to those carriers.Arguments: `near`, `carrierKeys`, `limit`
`pickupPoint`	`PickupPoint`	The pickup point chosen for the cart. Null until one is chosen.
`deliverySplit`	`DeliverySplitType!`	Whether the cart ships once, when every line is in stock, or ships what is in stock now and the backordered rest later. COMPLETE until chosen.
`requestedDeliveryDate`	`Date`	The date the buyer asked to receive the delivery on. Null until asked.
`earliestCompleteDeliveryDate`	`Date`	The first date every line is in stock, which is when a complete delivery can leave at the earliest. Null when nothing is backordered, or when a backordered line has no expected date; the lines say which.
`name`	`String`	Buyer-given name, to tell one cart from another. Null until a cart is named.
`defaultName`	`String`	What to call the cart while it has no name: its first product, then a plus and the number of further products, such as "Accuboormachine + 2". Language-neutral, so a storefront needs no wording for it. Given whether or not the cart is named; null for an empty cart, where a storefront shows its own label.
`previewImages`	`[ProductImage!]!`	Images of the cart's first products, one per line in the order they were added and none repeated, so a cart list shows what each cart holds. Add-ons are left out, as is a line without an image. At most 10, whatever the limit asks for; empty for an empty cart.Arguments: `limit`
`owner`	`Customer`	The person whose cart this is. Null for a guest cart, which belongs to a session rather than to anyone.
`status`	`CartStatusType!`	Whether the cart is in use or archived. A cart nobody has touched for 60 days, or the period the service configures, is archived: it leaves the unit's cart list unless that is asked for. The caller's current cart is never archived, so choosing one with cartSetCurrent makes it read ACTIVE.
`approvalRequirement`	`CartApprovalRequirement`	What placing the cart now waits for. Null when it needs no approval, and for a cart that is not a business unit's.

`CartChangesAcknowledgeResponse`

Response for acknowledging a cart's changes

Field	Type	Description
`cart`	`Cart`	The cart, with no changes listed
`cartErrors`	`[CartChangesAcknowledgeError!]`	Error details if the changes could not be acknowledged

`CartCreateResponse`

Response for creating a cart

Field	Type	Description
`cart`	`Cart`	The cart that was created
`cartErrors`	`[CartCreateError!]`	Error details if the cart could not be created

`CartDiscountCode`

A CartDiscountCode represents a discount that is applied to the cart

Field	Type	Description
`id`	`ID!`	Unique identifier for the discount code
`code`	`String!`	The discount code string used
`amount`	`Money!`	The discount amount applied
`name`	`String`	What the code is called in the store's language, to label its row. Null where neither the code nor its discount is named, or the engine does not tell.
`validUntil`	`DateTime`	The last moment the code applies, where it ends. Null where it does not end, or the engine does not tell.

`CartDiscountCodeAddResponse`

Response for adding discount code to cart

Field	Type	Description
`cart`	`Cart`	Cart information after discount code is added
`cartErrors`	`[CartDiscountCodeAddError!]`	Error details if discount code addition failed

`CartDiscountCodeRemoveResponse`

Response for removing discount code from cart

Field	Type	Description
`cart`	`Cart`	Cart information after discount code is removed
`cartErrors`	`[CartDiscountCodeRemoveError!]`	Error details if discount code removal failed

`CartFreeDelivery`

How far a cart is from free delivery

Field	Type	Description
`threshold`	`Money!`	The goods total at which shipping becomes free
`remaining`	`Money!`	What is still to add to the goods total; zero once it is reached

`CartLineChange`

One change to a line since the buyer last acknowledged the cart

Field	Type	Description
`type`	`CartLineChangeType!`
`lineItem`	`CartLineItem`	The line as it is now; null for REMOVED, whose line is gone
`sku`	`String!`	The SKU when the change happened, for a REMOVED line that has none to read
`productName`	`String!`	The product name when the change happened, for a REMOVED line
`previousUnitPrice`	`TaxedPrice`	The unit price when the line was added, for PRICE_CHANGED
`unitPrice`	`TaxedPrice`	The unit price now, for PRICE_CHANGED
`previousQuantity`	`Int`	What the buyer had, for QUANTITY_REDUCED

`CartLineItemAddResult`

The outcome for one requested line.

Field	Type	Description
`sku`	`String!`	The SKU as requested.
`quantity`	`Int!`	The quantity as requested.
`failure`	`CartLineItemAddFailureType`	Why the line was not added. Null when it was.
`message`	`String`	Developer/debug description of the failure. Not localized and never shown to end users. Null when the line was added.

`CartLineItemBackorder`

The part of a cart line that cannot ship now.

Field	Type	Description
`backorderedQuantity`	`Int!`	How many of the line's items are not in stock.
`expectedAvailableDate`	`Date`	When they are expected back in stock. Null when nobody knows.

`CartLineItemsAddResponse`

Response for adding line items to cart

Field	Type	Description
`cart`	`Cart`	Cart information after line items are added
`lineResults`	`[CartLineItemAddResult!]`	One result per requested line, in the order requested: added, or why not. Lines that can be added are added even when others cannot. Null when the request failed as a whole, which cartErrors then says.
`addedQuantity`	`Int`	How many items were added in total, counted by quantity.
`addedAmount`	`Money`	What the added lines add to the cart total. Null when the request failed as a whole.
`cartErrors`	`[CartLineItemsAddError!]`	Error details if line item addition failed

`CartLineItemsRemoveResponse`

Response for removing line items from cart

Field	Type	Description
`cart`	`Cart`	Cart information after line items are removed
`cartErrors`	`[CartLineItemsRemoveError!]`	Error details if line item removal failed

`CartLineItemsUpdateResponse`

Response for updating line items in cart

Field	Type	Description
`cart`	`Cart`	Cart information after line items are updated
`lineResults`	`[CartLineItemUpdateResult!]`	One result per requested change, in the order requested. The changes that can be made are, even when others are refused. Null when the request failed as a whole, which cartErrors then says, and where the engine reports no result per line.
`cartErrors`	`[CartLineItemsUpdateError!]`	Error details if line item update failed

`CartLineItemUpdateResult`

The outcome for one requested quantity change. A refused line keeps the quantity it had.

Field	Type	Description
`id`	`String!`	The line id as requested.
`quantity`	`Int!`	The quantity as requested.
`failure`	`CartLineItemUpdateFailureType`	Why the quantity was not changed. Null when it was.
`message`	`String`	Developer/debug description of the failure. Not localized and never shown to end users. Null when the quantity was changed.

`CartLineQuantityRule`

How many of a line can be ordered. The bounds are multiples of step, so a minimum of 1 in packs of 6 is 6.

Field	Type	Description
`minimum`	`Int!`	The least that can be ordered; step when the variant has no minimum.
`maximum`	`Int`	The most that can be ordered now: the variant's maximum per line or the stock that can ship, whichever is lower. Null when neither limits it.
`maximumReason`	`CartLineQuantityLimitType`	Why maximum is what it is. Null when maximum is.
`step`	`Int!`	Quantities go up in this step, the pack size; 1 when it is not sold in packs.

`CartMinimumOrder`

B2B only

How far a business unit's cart is from the unit's minimum order value

Field	Type	Description
`minimum`B2B	`Money!`	The unit's minimum, on the goods after discounts, before tax and shipping.
`missing`B2B	`Money!`	What the cart still lacks, on the same total: before tax and excluding shipping. Zero once it reaches the minimum.

`CartPayment`

A payment on a cart, as far as a buyer needs to see it.

Field	Type	Description
`id`	`ID!`	Identifier of the payment
`provider`	`String!`	The provider that handles the payment, such as the gift card provider
`method`	`String!`	The payment method within that provider
`amount`	`Money!`	What the payment covers of the amount to pay
`status`	`CartPaymentStatusType!`	How far the payment has got

`CartPaymentRemoveResponse`

Response for removing a payment from the cart

Field	Type	Description
`cart`	`Cart`	Cart information after the payment is removed
`cartErrors`	`[CartPaymentRemoveError!]`	Error details if the payment could not be removed

`CartSetDeliveryRemarksResponse`

Response for recording a delivery note on a cart

Field	Type	Description
`cart`	`Cart`	The cart carrying the note
`cartErrors`	`[CartSetDeliveryRemarksError!]`	Error details if the note could not be recorded

`CartSetPurchaseOrderNumberResponse`

B2B only

Response for recording the buyer's purchase reference on a cart

Field	Type	Description
`cart`B2B	`Cart`	The cart carrying the reference
`cartErrors`B2B	`[CartSetPurchaseOrderNumberError!]`	Error details if the reference could not be recorded

`CartSetVatNumberResponse`

Response for recording a VAT number on a cart

Field	Type	Description
`cart`	`Cart`	The cart carrying the VAT number
`cartErrors`	`[CartSetVatNumberError!]`	Error details if the VAT number could not be recorded

`CartSingleLineItem`

Implements CartLineItem

Individual line item in a cart

Field	Type	Description
`id`	`ID!`	Unique identifier for the line item
`productName`	`String!`	Product name for the line item
`productSlug`	`String`	Product slug for URL generation
`variant`	`ProductVariant!`	Product variant details
`quantity`	`Int!`	Number of items in the line item
`availableStock`	`Int!`	Available stock for the product variant
`priceWhenAdded`	`Money`	The unit price before discounts when the line was added. Null where it was not recorded, such as for a line added before the engine kept it.
`priceChanged`	`Boolean!`	Whether the unit price before discounts is not what it was when the line was added. A discount the buyer applied is not a change. False where the price when added is not known.
`quantityRule`	`CartLineQuantityRule!`	How many of this line can be ordered and in which steps, for the quantity stepper. cartLineItemsAdd and cartLineItemsUpdate refuse a quantity outside it, per line.
`role`	`CartLineItemRoleType`	What this line is to another line. Null for an ordinary line.
`addOns`	`[CartLineItem!]`	The lines that belong to this one, such as its add-ons. Empty when none do; null when the engine does not link lines.
`backorder`	`CartLineItemBackorder`	How much of the line cannot ship now, and when it can. Null when the whole quantity is in stock, or when no stock is tracked for the variant.
`appliedDiscounts`	`[AppliedDiscount!]`	The cart's discounts on this line, with what each takes off the whole line. A reduced price the product itself carries is not one of them. Null where the engine does not report its discounts.
`addedAt`	`DateTime`	When the line item was added to the cart
`price`	`TaxedPrice!`	The final price for the whole line, after discounts: the unit price multiplied by the quantity. This is not a unit price -- divide by quantity at the call site if you need one, as there is no rounding-safe per-unit field.
`regularPrice`	`TaxedPrice!`	The regular selling price for the whole line, before any additional discount. Same basis as the final price: unit price multiplied by quantity.
`listPrice`	`TaxedPrice!`	The list price (MSRP) for the whole line, on the same basis as the other two. An engine that carries no separate MSRP reports the regular price here, so the two can be equal.

`CartUpdateResponse`

Response for cart update operations

Field	Type	Description
`cart`	`Cart`	Cart information after update
`cartErrors`	`[CartUpdateError!]`	Error details if update failed

`ShippingMethod`

Fields added by Delivery options

A way the cart can be shipped, at the price it would be charged.

Field	Type	Description
`id`	`ID!`	Unique identifier of the shipping method
`key`	`String!`	Unique key of the shipping method
`name`	`String!`	Name of the shipping method
`description`	`String`	Description of the shipping method
`price`	`Money!`	Price of the shipping method.
`carrier`	`Carrier`	Who delivers with this method, for the delivery step to show by name and, through its key, by logo. Null when the delivery provider does not say.
`deliveryEstimate`	`DeliveryEstimate`	When an order placed now with this method arrives, if every line is in stock. Null when the delivery provider gives no estimate. A cart with backordered lines arrives no earlier than its earliestCompleteDeliveryDate.

Input objects

`CartAddOnInput`

An add-on to add with a line.

Field	Type	Description
`sku`	`String!`	SKU of the add-on
`quantity`	`Int!`	Quantity of the add-onDefault `1`

`CartLineItemAddInput`

Input for creating a new line item

Field	Type	Description
`sku`	`String!`	SKU of the product variant
`quantity`	`Int!`	Quantity to add
`addOns`	`[CartAddOnInput!]`	Add-ons for this line, such as an extra warranty: each its own line, linked to this one and removed with it.

`CartLineItemUpdateInput`

Input for updating an existing line item

Field	Type	Description
`id`	`String!`	Line item ID to update
`quantity`	`Int!`	New quantity for the line item

`CartSetBillingAddressInput`

Input for setting billing address on cart

Field	Type	Description
`address`	`AddressInput`	Customer billing address

`CartSetCustomerEmailInput`

Input for setting customer email on cart

Field	Type	Description
`email`	`String`	Customer email

`CartSetPaymentMethodInput`

Input for setting payment method on cart

Field	Type	Description
`paymentMethod`	`PaymentMethodInput`	Selected payment method for the cart

`CartSetShippingAddressInput`

Input for setting shipping address on cart

Field	Type	Description
`address`	`AddressInput`	Customer shipping address

`CartSetShippingMethodInput`

Input for setting shipping method on cart

Field	Type	Description
`shippingMethod`	`ShippingMethodInput`	Selected shipping method for the cart

`CartUpdateAction`

Union of all cart update actions

Field	Type	Description
`setCustomerEmail`	`CartSetCustomerEmailInput`	Set customer email
`setBillingAddress`	`CartSetBillingAddressInput`	Set billing address
`setShippingAddress`	`CartSetShippingAddressInput`	Set shipping address
`setShippingMethod`	`CartSetShippingMethodInput`	Set shipping method
`setPaymentMethod`	`CartSetPaymentMethodInput`	Set payment method

`ShippingMethodInput`

Input for selecting a shipping method

Field	Type	Description
`id`	`String!`	ID of the shipping method

Enums

`CartLineChangeType`

What happened to a line since the buyer last acknowledged the cart

`SOLD_OUT`	Sold out since; the line is now in Cart.unavailableLineItems
`PRICE_CHANGED`	Its unit price before discounts is not what it was when the line was added; a discount the buyer applied is not a change
`QUANTITY_REDUCED`	Its quantity was lowered to what can still be ordered
`REMOVED`	It was taken out of the cart, by an engine that cannot keep an unavailable line

`CartLineItemAddFailureType`

Why a requested line was not added.

`NOT_FOUND`	No variant has the SKU.
`NOT_FOR_SALE`	The variant has no price for this store, currency and customer.
`OUT_OF_STOCK`	There is not enough stock for the quantity.
`BELOW_MINIMUM_QUANTITY`	The quantity is below the variant's minimum order quantity.
`ABOVE_MAXIMUM_QUANTITY`	The line's quantity would be above the variant's maximum per line.
`NOT_A_MULTIPLE_OF_PACK_SIZE`	The line's quantity would not be a whole number of packs.
`OTHER`	Something else refused the line. See the message.

`CartLineItemRoleType`

What a line is to another line in the cart.

`ADD_ON`	An add-on to its main line, such as an extra warranty, removed with it.
`BUNDLE_EXTRA`	An extra bought with its main line as a bundle, at the bundle's discount. It stays when the main line goes, without the discount.

`CartLineItemUpdateFailureType`

Why a line's quantity was not changed.

`NOT_FOUND`	No line of the cart has the id.
`BELOW_MINIMUM_QUANTITY`	The quantity is below the variant's minimum order quantity.
`ABOVE_MAXIMUM_QUANTITY`	The quantity is above the line's maximum: see CartLineQuantityRule.
`NOT_A_MULTIPLE_OF_PACK_SIZE`	The quantity is not a whole number of packs.

`CartLineQuantityLimitType`

What limits the quantity of a line.

`LINE_MAXIMUM`	The variant's maximum per line.
`STOCK`	The stock that can ship; the variant takes no backorders.

`CartPaymentStatusType`

How far a payment on a cart has got.

`RESERVED`	The money is held for the cart and has not been taken
`PENDING`	The provider has not yet reported an outcome
`COLLECTED`	The money has been taken
`FAILED`	The payment failed or was cancelled and holds nothing

Interfaces

`CartLineItem`

Interface for cart line items

Field	Type	Description
`id`	`ID!`	Unique identifier for the line item
`quantity`	`Int!`	Number of items in the line item
`role`	`CartLineItemRoleType`	What this line is to another line. Null for an ordinary line.
`addOns`	`[CartLineItem!]`	The lines that belong to this one, such as its add-ons. Empty when none do; null when the engine does not link lines.
`backorder`	`CartLineItemBackorder`	How much of the line cannot ship now, and when it can. Null when the whole quantity is in stock, or when no stock is tracked for the variant.
`appliedDiscounts`	`[AppliedDiscount!]`	The cart's discounts on this line, with what each takes off the whole line. A reduced price the product itself carries is not one of them. Null where the engine does not report its discounts.
`price`	`TaxedPrice!`	The final price for the whole line, after discounts: the unit price multiplied by the quantity. This is not a unit price -- divide by quantity at the call site if you need one, as there is no rounding-safe per-unit field.
`regularPrice`	`TaxedPrice!`	The regular selling price for the whole line, before any additional discount. Same basis as the final price: unit price multiplied by quantity.
`listPrice`	`TaxedPrice!`	The list price (MSRP) for the whole line, on the same basis as the other two. An engine that carries no separate MSRP reports the regular price here, so the two can be equal.