Skip to main content

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