# Atlas Help Center

## Docs

- [Authentication](https://help.atlas.kitchen/connect/admin-api/authentication.md)
- [Create cart](https://help.atlas.kitchen/connect/admin-api/carts/create-cart.md): Creates a dine-in cart for a table with optional upfront payment. Always uses POS platform with DINE_IN fulfilment.
- [Menu Create or Update](https://help.atlas.kitchen/connect/admin-api/menus/menu-create-or-update.md): Upserts a menu by `identifier`. Creates a new menu if the identifier doesn't exist, or updates the existing one. The full hierarchy (sections, items, modifiers) is synced — orphaned records are removed.
- [Menu Details](https://help.atlas.kitchen/connect/admin-api/menus/menu-details.md): Returns full menu hierarchy with sections, items, modifier groups, and modifiers.
- [Menu List](https://help.atlas.kitchen/connect/admin-api/menus/menu-list.md)
- [Create Order](https://help.atlas.kitchen/connect/admin-api/orders/create-order.md): Creates a new order for the given outlet and channel. Requires a configured channel link. Supports 3-level item nesting, multiple payments, and admin overrides for payment breakdown fields.
- [Order Details](https://help.atlas.kitchen/connect/admin-api/orders/order-details.md)
- [Order Details (with Identifier)](https://help.atlas.kitchen/connect/admin-api/orders/order-details-identifier.md)
- [Update Order](https://help.atlas.kitchen/connect/admin-api/orders/update-order.md): Update order details including state, contact info, items, and payments. Supports `order_items_update_mode` and `order_payments_update_mode` for merge/replace behavior.
- [Outlet Stocks](https://help.atlas.kitchen/connect/admin-api/stocks/outlet-stocks.md): Returns available quantity per item for the outlet on the given date.
- [Tables](https://help.atlas.kitchen/connect/admin-api/tables/tables.md): Returns active tables for the outlet.
- [User Sync](https://help.atlas.kitchen/connect/admin-api/users/user-sync.md): Upserts a user by email or mobile number. For non-guests, creates an Account and UserAccount relationship. External user links are immutable once created.
- [Authentication](https://help.atlas.kitchen/connect/mcp/authentication.md)
- [Overview](https://help.atlas.kitchen/connect/mcp/overview.md)
- [Setup](https://help.atlas.kitchen/connect/mcp/setup.md)
- [Introducing Atlas Connect](https://help.atlas.kitchen/connect/overview.md)
- [Authentication](https://help.atlas.kitchen/connect/storefront-api/authentication.md)
- [Add item](https://help.atlas.kitchen/connect/storefront-api/cart/add-item.md): Add a menu item with optional modifiers (sub_items). Validates stock and modifier group constraints.
- [Apply promo](https://help.atlas.kitchen/connect/storefront-api/cart/apply-promo.md): Validates and applies a promotion to the cart. Only one promo per cart.
- [Clear promo](https://help.atlas.kitchen/connect/storefront-api/cart/clear-promo.md)
- [Create cart](https://help.atlas.kitchen/connect/storefront-api/cart/create-cart.md): Creates a new cart for the session or returns the existing active cart. Cart starts without outlet or items.
- [Delivery outlets](https://help.atlas.kitchen/connect/storefront-api/cart/delivery-outlets.md): Only available when cart fulfilment_type is delivery.
- [Payment breakdown](https://help.atlas.kitchen/connect/storefront-api/cart/payment-breakdown.md): Returns itemized charges including subtotal, tax, delivery fee, discounts, service charge, and points value.
- [Remove item](https://help.atlas.kitchen/connect/storefront-api/cart/remove-item.md)
- [Toggle points](https://help.atlas.kitchen/connect/storefront-api/cart/toggle-points.md)
- [Update cart](https://help.atlas.kitchen/connect/storefront-api/cart/update-cart.md): Set outlet, fulfilment type, timeslot, contact info, delivery address, gifting details.
- [Update item](https://help.atlas.kitchen/connect/storefront-api/cart/update-item.md): Update quantity or notes. Cannot set quantity to 0 — use DELETE instead.
- [Validate cart](https://help.atlas.kitchen/connect/storefront-api/cart/validate-cart.md): Validates stock, timeslots, minimum order value, etc. Returns a token for duplicate payment prevention.
- [Get channel](https://help.atlas.kitchen/connect/storefront-api/channel/get-channel.md): Returns merchant config, outlets with service hours, referral program, and point program. Creates a new session if `X-Session-Id` is not provided.
- [Checkout Flow](https://help.atlas.kitchen/connect/storefront-api/checkout-flow.md)
- [Get availabilities](https://help.atlas.kitchen/connect/storefront-api/menu/get-availabilities.md): Returns hidden/disabled state for sections and items based on timeslot and fulfilment type.
- [Get menus](https://help.atlas.kitchen/connect/storefront-api/menu/get-menus.md): Returns published menus with sections, products, and modifier groups.
- [Get stocks](https://help.atlas.kitchen/connect/storefront-api/menu/get-stocks.md): Returns available quantity per item for the outlet on the given date. Empty items object means unlimited stock.
- [Get timeslots](https://help.atlas.kitchen/connect/storefront-api/menu/get-timeslots.md)
- [Create order](https://help.atlas.kitchen/connect/storefront-api/order/create-order.md): **Call this after the diner completes payment and is redirected back.**
- [Create payment intent](https://help.atlas.kitchen/connect/storefront-api/payment/create-payment-intent.md): Validates the cart and creates a payment intent with the payment processor. Returns an `atlas_pay_url` — redirect the diner there to complete payment.
- [Update diners' phone number](https://help.atlas.kitchen/customer-guides/diners-phone-update.md): Guide for diners to update phone numbers on Atlas Online. Log in, recover access via email, update profile details, and verify changes.
- [Install Atlas Merchant Portal](https://help.atlas.kitchen/get-started/installing-atlas.md): Add Atlas Merchant Portal as a home screen shortcut on your tablet for faster access. Works on Chrome and Safari browsers.
- [Onboarding process](https://help.atlas.kitchen/get-started/onboarding.md): Get started with Atlas onboarding. Learn the setup process, hardware requirements, WiFi specs, and best practices for a smooth restaurant launch.
- [Set up Atlas to earn more](https://help.atlas.kitchen/get-started/sell-more.md): Boost restaurant revenue with aggregator integrations, loyalty rewards, cross-selling, and menu engineering best practices in Atlas.
- [Connect Atlas printer to WiFi](https://help.atlas.kitchen/hardware/printers.md): Connect Atlas receipt printers to WiFi network. Choose manual browser pairing or QR pairing with WeChat for wireless printer setup.
- [Set up Revel POS integration](https://help.atlas.kitchen/integrations/revel-setup.md): Integrate Atlas with Revel POS. Configure API keys, map menus and dining options, sync orders, and test the connection for seamless operations.
- [Create and configure menus](https://help.atlas.kitchen/menu-builder/create-menus.md): Build Atlas menus with sections, products, and modifiers. Configure pricing, images, and customisation options for POS, online, and kiosk ordering.
- [Set up POS layouts](https://help.atlas.kitchen/menu-builder/pos-layout.md): Create and customise Atlas POS layouts. Add pages, configure product and discount tiles, and assign layouts to specific outlets for efficient ordering.
- [Reporting categories](https://help.atlas.kitchen/menu-builder/reporting-categories.md): Group products into categories to organise reports and target pricing rules.
- [Discounts](https://help.atlas.kitchen/merchant-portal/add-discounts.md): Create and manage discounts in Atlas to run promotions, reward loyal customers, and drive sales across all your ordering channels.
- [How to create and charge Admin orders](https://help.atlas.kitchen/merchant-portal/admin-orders.md): Create and charge Admin orders in Atlas for delivery, pickup, or dine-in using payment links, terminals, or manual entry.
- [BCRS (Beverage Container Return Scheme)](https://help.atlas.kitchen/merchant-portal/bcrs.md): Set up the $0.10 beverage container deposit on Atlas for Singapore's BCRS regulation.
- [How to use customers' data](https://help.atlas.kitchen/merchant-portal/customers-data.md): Access and export customer data, understand registered vs guest users, and use customer information for marketing campaigns.
- [Discount use cases](https://help.atlas.kitchen/merchant-portal/discount-use-cases.md): Copy-and-use discount configs for 1-for-1 deals, happy hour, first-order promos, free delivery, loyalty rewards, and staff discounts.
- [Update order details](https://help.atlas.kitchen/merchant-portal/editing-order.md): Edit order items, customer info, delivery addresses, and fulfilment type. Make changes via Atlas POS or Orders page with automatic logistics rebooking.
- [Change the portal language](https://help.atlas.kitchen/merchant-portal/language-switcher.md): Switch the Atlas Merchant Portal interface between English and Chinese.
- [Add operating hours and special hours](https://help.atlas.kitchen/merchant-portal/operating-hours.md): Set up regular restaurant hours and special hours for holidays. Control when customers can order for dine-in, pickup, and delivery across Atlas channels.
- [Outlet shifts](https://help.atlas.kitchen/merchant-portal/outlet-shifts.md): Create shifts for your outlet to track sales by time period and filter reports by shift.
- [Process refunds on Atlas](https://help.atlas.kitchen/merchant-portal/refunds.md): Issue full or partial refunds for paid orders. Cancel orders, reopen for editing, or recharge with different payment methods via POS or Orders page.
- [How to use the Stocks page](https://help.atlas.kitchen/merchant-portal/stocks.md): Manage restaurant stock in Atlas by blocking items, setting quantities, and syncing availability across all channels including aggregators.
- [Billing report](https://help.atlas.kitchen/reports/finance/billing-report.md): View subscriptions, invoices, and manage payment methods.
- [Payout report](https://help.atlas.kitchen/reports/finance/payout-report.md): Reconcile sales to payouts and trace payouts back to transactions.
- [Legacy reports](https://help.atlas.kitchen/reports/legacy/overview.md): Reports being phased out by 1 June 2026 in favor of upgraded analytics-powered versions.
- [Customers report](https://help.atlas.kitchen/reports/marketing/customers-report.md): Track customer segments, lifetime value, and retention.
- [Discount report](https://help.atlas.kitchen/reports/marketing/discount-report.md): Track promo code usage, discount costs, and effectiveness.
- [Loyalty report](https://help.atlas.kitchen/reports/marketing/loyalty-report.md): Track loyalty program signups, points activity, and member value.
- [Daily outlet report](https://help.atlas.kitchen/reports/operations/daily-outlet-report.md): Quick overview of sales for a single day.
- [Logistics report](https://help.atlas.kitchen/reports/operations/logistics-report.md): Atlas Smart Logistics trips and costs.
- [Production efficiency report](https://help.atlas.kitchen/reports/operations/production-efficiency-report.md): Track how long kitchen tickets take to complete.
- [Reports overview](https://help.atlas.kitchen/reports/overview.md): Find the right report for sales, operations, marketing, and finance data.
- [Product mix report](https://help.atlas.kitchen/reports/product/product-mix-report.md): Analyse product sales, quantities, and performance by category.
- [Sales summary report](https://help.atlas.kitchen/reports/sales/sales-summary-report.md): Detailed breakdown of sales metrics including payments, discounts, and category performance.
- [Sales trends](https://help.atlas.kitchen/reports/sales/sales-trends.md): Track sales performance over time with period comparisons and breakdowns.
- [Using reports](https://help.atlas.kitchen/reports/using-reports.md): How to filter, export, and set up scheduled report deliveries.
- [Set up the customer-facing display](https://help.atlas.kitchen/stations/customer-facing-display.md): Show customers their order, let them log in for rewards, and choose how they get their receipt.
- [How to use POS for QSR](https://help.atlas.kitchen/stations/pos.md): Accept payments in-store and show customers their order details.
- [Welcome to Atlas](https://help.atlas.kitchen/welcome-to-atlas.md): Delightful and easy restaurant tech.

## OpenAPI Specs

- [storefront-v1](https://help.atlas.kitchen/specs/storefront-v1.yaml)
- [admin-v1](https://help.atlas.kitchen/specs/admin-v1.yaml)
- [openapi](https://help.atlas.kitchen/api-reference/openapi.json)