Cart events - Atlas Help Center

Cart events describe a POS dine-in cart during service, before the bill is paid.

Cart event money fields are sent as decimal major currency units for most currencies. For example, Singapore dollars are sent as dollars, not cents.

Event types

Event type	Trigger
`cart.items_fired`	Staff send items to the kitchen on a POS dine-in cart.
`cart.archived`	A POS cart is archived.

`cart.items_fired` payload

Each payload carries the full current state of the cart, not a delta. The latest payload replaces everything you stored from earlier ones, so a missed delivery is healed by the next one. This event fires only for staff-attended POS carts. Self-service carts (QR ordering, kiosk, online) do not fire it. A cart whose order has closed stops firing.

{
  "id": 48213,
  "status": "open",
  "identifier": "P48213",
  "fulfilment_type": "dine_in",
  "notes": "Birthday table",
  "pax": 4,
  "subtotal": 44.5,
  "total_including_tax": 48.51,
  "reservation_id": "resv-8zk2fm",
  "outlet": {
    "id": 31,
    "name": "Atlas Cafe Raffles Place"
  },
  "user": null,
  "table": {
    "id": 512,
    "outlet_id": 31,
    "name": "A4",
    "created_at": 1749794130,
    "updated_at": 1749794130
  },
  "cart_items": [
    {
      "id": 991,
      "item_id": 1204,
      "item_sku": "laksa-classic",
      "name": "Laksa",
      "quantity": 2,
      "currency": "SGD",
      "unit_price": 18,
      "item_total": 36,
      "type": "Product",
      "status": "sent",
      "voided": false,
      "sub_items": [
        {
          "id": 992,
          "item_id": 1310,
          "item_sku": "extra-cockles",
          "name": "Extra cockles",
          "quantity": 1,
          "currency": "SGD",
          "unit_price": 2,
          "item_total": 2,
          "type": "Product",
          "status": "sent",
          "voided": false,
          "sub_items": []
        }
      ]
    },
    {
      "id": 995,
      "item_id": 1287,
      "item_sku": "kaya-toast",
      "name": "Kaya toast",
      "quantity": 1,
      "currency": "SGD",
      "unit_price": 6.5,
      "item_total": 6.5,
      "type": "Product",
      "status": "held",
      "voided": false,
      "sub_items": []
    }
  ]
}

Field	Type	Description
`id`	integer	Cart ID. Equals `cart_id` on the order payload for the same visit.
`status`	string	`open` while the bill is unpaid. Cart events stop once the order closes.
`identifier`	string	Human-readable check reference. Matches the order payload’s `identifier` once an order exists.
`fulfilment_type`	string	Fulfilment type of the cart, such as `dine_in`.
`notes`	string \| null	Cart notes entered by staff.
`pax`	integer \| null	Party size.
`subtotal`	number	Running subtotal of the current items.
`total_including_tax`	number	Running total including tax. Final amounts arrive on the closing order event.
`reservation_id`	string \| null	External reservation reference, when the cart came from a reservation.
`outlet`	object \| null	The outlet the cart belongs to: `id` and `name`.
`user`	object \| null	Customer identity when known: `id`, `name`, and `external_user_links`. Often `null` before payment — do not key on it.
`table`	object \| null	The table the cart is open on.
`cart_items`	array	Every current top-level item. See below.

cart_items[].status is sent once the item has been fired to the kitchen, or held while it waits. voided: true marks a removed item. sub_items nests modifiers, using the same fields as a top-level item.

Handling deliveries

Delivery is at-least-once and unordered. Payloads carry no ordering token. Apply these rules:

Match cart events and order events for the same visit on the cart id. It equals the order payload’s cart_id.
Treat each payload as the full cart state. Replace what you stored for that cart. A stale or duplicate delivery is corrected by the next kitchen send.
Discard status: "open" payloads for a cart whose closing order event you have already processed.

`cart.archived` payload

{
  "cart_id": 12345,
  "is_archived": true
}