MobileCartItem
One item in the cart.
type MobileCartItem {
acceptAlternativeIfUnavailable: Boolean!
addedAt: DateTime!
blurhash: String
conversionFactor: Float
customFields: JSON
customerTier: String
discountLabel: String
effectiveDiscountPercentage: Float
id: ID!
imageUrl: String
inStock: Boolean!
lineDiscount: Float
lineGross: Float
lineTotal: Float!
listDiscountPercentage: Float
listLineTotal: Float
listSavings: Float
maxOrderQuantity: Float
minOrderQuantity: Float
notes: String
orderMultiple: Float
originalUnitPrice: Float
otherDiscountLabel: String
otherDiscountPercentage: Float
productId: ID!
productImageUrl: String
productName: String!
quantity: Float!
quantityTierUnitDiscount: Float
tierDiscountPercentage: Float
tierUnitDiscount: Float
unavailable: Boolean
unitLabel: String
unitPrice: Float!
uomId: ID
variantId: ID!
variantLabel: String
}
Fields
MobileCartItem.acceptAlternativeIfUnavailable ● Boolean! non-null scalar
Buyer consent that fulfilment may ship a manually-picked substitute if this line is unavailable. Consent + visibility only — no matching or suggestion logic exists behind it on any surface.
MobileCartItem.addedAt ● DateTime! non-null scalar
When the item was added.
MobileCartItem.blurhash ● String scalar
A placeholder for the image while it loads.
MobileCartItem.conversionFactor ● Float scalar
Base units contained in one of this line's UOM (e.g. 30 for a case of 30 pcs). 1/undefined for the base unit.
MobileCartItem.customFields ● JSON scalar
The organization's own fields on this cart line that the buyer may see, keyed by field key.
MobileCartItem.customerTier ● String scalar
Buyer's effective CUSTOMER/LOYALTY tier key for this line (e.g. GOLD).
MobileCartItem.discountLabel ● String scalar
The name of the discount that applied.
MobileCartItem.effectiveDiscountPercentage ● Float scalar
The ONE discount percent this line's badge shows: the customer-tier % plus the scheme %, exact, both taken off the line's gross (lineGross). It never adds the quantity-tier saving, which is already inside lineGross. 0 when nothing was discounted. Read it; never rebuild a percent from the rounded amounts or add quantityTierUnitDiscount to it.
MobileCartItem.id ● ID! non-null scalar
The unique ID of this record.
MobileCartItem.imageUrl ● String scalar
The URL of the product image.
MobileCartItem.inStock ● Boolean! non-null scalar
True when the item is in stock.
MobileCartItem.lineDiscount ● Float scalar
This line's discount — round(exact per-unit discount x quantity). lineGross - lineDiscount can sit one minor unit away from lineTotal on a half-cent line (833.50 - 375.08 = 458.42 against a true net of 458.43); that is the accepted per-line-accuracy trade-off the customer portal makes too, NOT a bug to 'fix' by re-deriving one row from the others.
MobileCartItem.lineGross ● Float scalar
This line's GROSS (pre-discount) amount — round(baseUnitPrice x quantity), computed server-side by the SAME expression the customer portal and admin use. Read it; never re-derive it as unitPrice x quantity on the client (the displayed unit price is rounded to cents and the charged one often is not).
MobileCartItem.lineTotal ● Float! non-null scalar
The line total.
MobileCartItem.listDiscountPercentage ● Float scalar
The saving against the list price as a percent, exact: listSavings / listLineTotal x 100. This is the percent the product page shows. Show it half-up to 2 dp; never rebuild it from rounded prices. Absent = 0.
MobileCartItem.listLineTotal ● Float scalar
The line at its LIST price: round(originalUnitPrice x quantity). The list price is the one the product page and the admin console strike, so a list-to-sale markdown is included. Absent when the line has no list price above what is charged: show nothing, i.e. 0.
MobileCartItem.listSavings ● Float scalar
listLineTotal minus the line's charged net total: the full saving against the list price. Absent = 0. Additive: lineGross, lineDiscount and the bill are unchanged.
MobileCartItem.maxOrderQuantity ● Float scalar
Largest orderable quantity for this line's UOM. Null/unset = unlimited.
MobileCartItem.minOrderQuantity ● Float scalar
Smallest orderable quantity for this line's UOM (1 = unrestricted).
MobileCartItem.notes ● String scalar
A note on the line.
MobileCartItem.orderMultiple ● Float scalar
Quantity step for this line's UOM (1 = no step restriction).
MobileCartItem.originalUnitPrice ● Float scalar
The price of one unit before a discount.
MobileCartItem.otherDiscountLabel ● String scalar
Joined name(s) of every applied non-tier discount scheme.
MobileCartItem.otherDiscountPercentage ● Float scalar
Combined % from every applied non-tier discount scheme.
MobileCartItem.productId ● ID! non-null scalar
The ID of the product.
MobileCartItem.productImageUrl ● String scalar
The PRODUCT's own image, for surfaces that group lines under a product header (the buyer-app basket does). imageUrl above is the LINE's image and is variant-first by design, so two variants of one product show different photos — but a product-level header showing the first variant's photo is simply the wrong picture next to the product name. Resolved server-side on every cart read/write, never stored on the line, so it is correct for carts that predate this field. Null when the product has no image of its own; callers fall back to imageUrl.
MobileCartItem.productName ● String! non-null scalar
The name of the product.
MobileCartItem.quantity ● Float! non-null scalar
Quantity in the line's pack units. Fractional only for non-count packs (e.g. 1.5 KG), which the portal can add to the shared cart.
MobileCartItem.quantityTierUnitDiscount ● Float scalar
Per-unit saving from a genuine QUANTITY/bulk-order pricing tier (a VariantPrice qty-break, e.g. "3-10 units @ 900") — listUnitPrice minus the tier-resolved baseUnitPrice, BEFORE any customer/scheme discount. Independent of tierUnitDiscount above (which is the customer-tier amount); both can be non-zero on the same line, and their sum plus any other-discount amount equals the total per-unit saving.
MobileCartItem.tierDiscountPercentage ● Float scalar
Effective CUSTOMER/LOYALTY tier discount % applied to this line (not the quantity-break tier).
MobileCartItem.tierUnitDiscount ● Float scalar
Exact per-unit CUSTOMER/LOYALTY tier discount amount (engine-accurate; the bill sums it).
MobileCartItem.unavailable ● Boolean scalar
True when this line can no longer be ordered: its product or variant was deleted, switched off, or set to any status other than ACTIVE. The same rule checkout refuses with PRODUCT_UNAVAILABLE, so show the line as unavailable and block placing the order until it is removed. Set on every cart read and write; null = the check could not run (the cart still loads, and checkout still refuses the line). Independent of inStock.
MobileCartItem.unitLabel ● String scalar
The unit of measure.
MobileCartItem.unitPrice ● Float! non-null scalar
The price of one unit.
MobileCartItem.uomId ● ID scalar
UOM the line is ordered in (each/case/carton). Drives the per-unit price resolution and the SalesOrder line UOM so displayed == charged.
MobileCartItem.variantId ● ID! non-null scalar
The ID of the product variant.
MobileCartItem.variantLabel ● String scalar
The label of the variant.
Member Of
MobileCart object