Skip to main content

MobileOrder

Order placed via the mobile BFF. v1 is COD only; persisted in Redis until SalesOrder wiring lands.

type MobileOrder {
  addressId: ID!
  amendment: MobileOrderAmendment
  bill: MobileCartBill!
  customerReferenceId: String
  deliverySelection: CustomerDeliverySelection
  directions: String
  id: ID!
  idempotencyKey: String!
  items: [MobileOrderItem!]!
  orderNumber: String!
  paidAmount: Float
  paidAt: DateTime
  paymentMethod: MobilePaymentMethod!
  paymentNumber: String
  paymentReference: String
  paymentStatus: MobilePaymentStatus!
  placedAt: DateTime!
  salesRepEmail: String
  salesRepName: String
  salesRepPhone: String
  shipmentTrackingLevel: CustomerTrackingLevel
  shipments: [CustomerShipment!]
  slotId: ID
  status: MobileOrderStatus!
}

Fields​

MobileOrder.addressId ● ID! non-null scalar​

The ID of the address.

MobileOrder.amendment ● MobileOrderAmendment object​

Buyer amendment capabilities. Resolved on the single mobileOrder detail query and on the amendment mutations; absent (null) on list rows and on cancel.

MobileOrder.bill ● MobileCartBill! non-null object​

The order's money.

MobileOrder.customerReferenceId ● String scalar​

Permanent contact reference of the customer this order was placed for (Contact.referenceId). Absent when unresolvable — clients hide the line rather than showing a placeholder.

MobileOrder.deliverySelection ● CustomerDeliverySelection object​

The live delivery option chosen at checkout (live-priced stores). Null for flat-fee orders. Detail query only.

MobileOrder.directions ● String scalar​

Delivery directions.

MobileOrder.id ● ID! non-null scalar​

The unique ID of this record.

MobileOrder.idempotencyKey ● String! non-null scalar​

The key sent when the order was placed.

MobileOrder.items ● [MobileOrderItem!]! non-null object​

The lines of the order.

MobileOrder.orderNumber ● String! non-null scalar​

The order number.

Amount captured by the online payment, in the order currency.

When the online payment was recorded as succeeded.

MobileOrder.paymentMethod ● MobilePaymentMethod! non-null enum​

How the order is paid.

MobileOrder.paymentNumber ● String scalar​

Our own receipt number (Payment.paymentNumber) for that online payment, when the Payment row exists.

MobileOrder.paymentReference ● String scalar​

Customer-facing payment reference: the PSP's payment id (falling back to its session id). Absent unless an online payment SUCCEEDED for this order.

MobileOrder.paymentStatus ● MobilePaymentStatus! non-null enum​

Where the payment stands.

MobileOrder.placedAt ● DateTime! non-null scalar​

When the order was placed.

MobileOrder.salesRepEmail ● String scalar​

Email of the customer's assigned sales rep — the buyer app renders it as a mailto: link. Absent when unassigned.

MobileOrder.salesRepName ● String scalar​

Name of the sales rep this customer is assigned to (Partner.assignedSalesRep). Absent when no rep is assigned — clients must hide the 'handled by' block rather than substituting anyone else.

MobileOrder.salesRepPhone ● String scalar​

Phone of the customer's assigned sales rep — the buyer app renders it as a tel: link. Absent when unassigned.

MobileOrder.shipmentTrackingLevel ● CustomerTrackingLevel enum​

How much shipment tracking this customer gets in the buyer app (FULL when the store's setting does not apply to it). STATUS: show no shipment section (and no 'tracking will appear' line) — the order status alone. Detail query only; null on list rows.

MobileOrder.shipments ● [CustomerShipment!] list object​

Live outbound shipments of this order (oldest first): carrier, tracking (https link only), ETA and timeline. Never carries the seller's cost. Resolved on the mobileOrder detail query; absent on list rows.

MobileOrder.slotId ● ID scalar​

The ID of the delivery slot.

MobileOrder.status ● MobileOrderStatus! non-null enum​

The status of the order.

Returned By​

cancelMobileOrder mutation ● changeMobileOrderAddress mutation ● changeMobileOrderPaymentMethod mutation ● mobileOrder query ● placeOrder mutation ● updateMobileOrderItems mutation

Member Of​

MobileOrderConnection object