Lavu POS

Supergood | Lavu POS API

Alex Klarfeld

Alex Klarfeld

— 6 min read

Programmatically access Lavu POS restaurant data, menus, orders, payments, and labor reporting with a stable REST API. Supergood builds and operates production-grade, unofficial Lavu integrations so your team can automate front-of-house and back-of-house workflows without heavy custom engineering.

Plain English: Lavu POS is iPad-based point-of-sale software for restaurants, bars, cafes, and quick service operations. An unofficial API lets you pull live menus and modifiers, table orders and checks, payments and tips, inventory counts, and employee time entries—and push new orders, menu updates, and payment records back into Lavu.

For a tech company integrating with Lavu, this means you can ingest real-time FOH/BOH data to power dashboards, sync sales and tips to accounting (e.g., QuickBooks, Xero), automate online ordering from your product, or enrich your platform with menu metadata, table routing, and kitchen statuses. You can also trigger guest updates, reconcile delivery orders, create payments from your e-commerce flow, attach receipts, and keep stakeholder systems (ERP, analytics, CRM, scheduling) in lockstep.

What is Lavu POS?

Lavu POS (https://lavu.com/) is a cloud point-of-sale platform built for hospitality businesses—full service restaurants, bars, cafes, and quick service—to manage ordering, payments, menus, inventory, and staff operations across one or multiple locations. Teams use Lavu to run table service, handle modifiers and coursing, route items to kitchen printers/KDS, process payments and tips, manage loyalty and discounts, track inventory and recipes, and report on sales, labor, and taxes.

Core product areas include:

  • Order Management (Tables, Tickets, Checks, Coursing, Modifiers, Discounts)
  • Menu Management (Categories, Items, Price Levels, Taxes, Printer/KDS Routing)
  • Payments & Tips (Card, Cash, Gift Cards, Split Checks, Refunds/Voids)
  • Inventory & Recipes (Stock Counts, Depletions, Purchase/Receiving)
  • Staff & Labor (Employees, Roles/Permissions, Time Clock, Shifts)
  • Reporting & Analytics (Sales, Taxes, Tips, Menu Performance, Labor)
  • Customer Experience (Loyalty, Online Ordering, Receipts)

Common data entities:

  • Companies and Locations (metadata, addresses, tax settings)
  • Terminals and Devices (registers, KDS, printers)
  • Users/Employees and Roles (manager, server, bartender, cashier)
  • Tables, Floor Plans, Service Areas
  • Menu Categories, Items, Modifiers, Combos, Taxes, Discounts
  • Orders/Tickets, Checks, Line Items, Coursing, Notes
  • Payments (tender type, tips, refunds), Receipts
  • Customers/Loyalty (profiles, balances, contact info)
  • Inventory Items and Movements (adjustments, depletions, receiving)
  • Time Entries/Timesheets and Shifts

The Lavu POS Integration Challenge

Restaurant teams depend on Lavu every shift, but turning POS-first workflows into reliable API-driven automation is non-trivial:

  • Role-aware workflows: Managers, servers, bartenders, and cashiers have different permissions, views, and device flows
  • Menu complexity: Modifiers, combo pricing, tax categories, price levels, and routing rules vary by location and service type
  • Order lifecycle: Tickets split/merge, voids/comps, and partial payments complicate stateful automation
  • Data exports: Operators often report limited or CSV-only exports for some reports and inventory, which hinders real-time integrations
  • API access and costs: Teams commonly cite paid API tiers or add-on licensing, throttling, and uneven webhook coverage for POS events
  • Device/session constraints: Multiple iPads, offline mode, and shift closures introduce synchronization edge cases

How Supergood Creates Lavu POS APIs

Supergood reverse-engineers authenticated browser and device flows to deliver a resilient API endpoint layer for your Lavu tenant.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh, change detection, and device-safe cookie management
  • Normalizes responses across menus, orders, payments, inventory, and labor so you integrate once
  • Aligns with customer entitlements and role-based permissions to ensure compliant access
  • Bridges gaps in reporting/export functionality with near real-time scraping and durable pagination

Use Cases

  • Mirror menu categories, items, modifiers, and pricing across web, mobile, and in-venue channels
  • Maintain tax mappings and printer/KDS routing consistency across locations
  • Automate limited-time offers and daypart availability windows

Order Processing & Delivery Integration

  • Create dine-in, takeout, and delivery tickets from your app
  • Attach modifiers, notes, and table routing; sync status to delivery partners
  • Reconcile splits, comps, and voids with order history

Payments & Accounting

  • Record card, cash, and gift card payments with tips
  • Export daily sales, tips, and taxes to ERP/accounting (e.g., QuickBooks, Xero)
  • Attach receipts and payment artifacts; trigger refunds programmatically

Labor & Scheduling

  • Pull time entries for payroll and labor analytics
  • Normalize roles, break compliance, and shift boundaries across locations
  • Trigger alerts for clock-ins/outs and overtime thresholds

Inventory & Recipe Costing

  • Adjust stock levels based on receiving, waste, and recipe depletions
  • Track theoretical vs. actual usage by menu item
  • Drive purchase recommendations and variance reporting

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "emp_lavu_7a19c2",
    "name": "General Manager",
    "entitlements": ["locations", "menus", "orders", "payments", "inventory", "employees", "reports"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

GET /locations/{locationId}/menus: List menu categories, items, modifiers, pricing, taxes, and routing metadata.

Query parameters

  • active: boolean
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • includeModifiers: boolean
  • daypart: breakfast | lunch | dinner | late_night
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "menuId": "mnu_41c9e8",
      "name": "Main Menu",
      "categories": [
        {
          "categoryId": "cat_appetizers",
          "name": "Appetizers",
          "items": [
            {
              "menuItemId": "itm_quesadilla",
              "name": "Chicken Quesadilla",
              "sku": "CHQSD-001",
              "price": 11.00,
              "taxCategory": "prepared_food",
              "priceLevels": [
                {"name": "Happy Hour", "price": 8.00, "start": "16:00", "end": "18:00"}
              ],
              "modifiers": [
                {"modifierId": "mod_sour_cream", "name": "Sour Cream", "price": 0.50},
                {"modifierId": "mod_extra_cheese", "name": "Extra Cheese", "price": 1.00}
              ],
              "routing": {"printer": "Kitchen Printer 1", "kdsStation": "Hot Line"},
              "availability": {"days": ["Mon","Tue","Wed","Thu","Fri"], "start": "11:00", "end": "22:00"},
              "updatedAt": "2026-01-20T13:45:00Z"
            }
          ]
        }
      ]
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Orders

POST /locations/{locationId}/orders: Create a ticket with line items, modifiers, service details, and routing.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/locations/loc_a1b2c3/orders \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "serviceType": "dine_in",
    "tableId": "tbl_12",
    "guestCount": 2,
    "items": [
      {
        "menuItemId": "itm_quesadilla",
        "quantity": 1,
        "notes": "No onions",
        "modifiers": [
          {"modifierId": "mod_extra_cheese"}
        ]
      },
      {
        "menuItemId": "itm_margarita",
        "quantity": 2,
        "modifiers": []
      }
    ],
    "discounts": [
      {"type": "percent", "value": 10, "reason": "Happy Hour"}
    ],
    "externalRef": "web-order-7842",
    "notifyKitchen": true
  }'

Example response

{
  "orderId": "ord_58fa71",
  "checks": [
    {"checkId": "chk_1", "subtotal": 27.00, "tax": 2.19, "total": 26.49, "status": "open"}
  ],
  "routing": {"sentToKitchenAt": "2026-01-21T10:03:11Z"},
  "createdAt": "2026-01-21T10:03:11Z"
}

Payments

PATCH /orders/{orderId}/checks/{checkId}/payments: Add a payment to a check with tender details and tips.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/orders/ord_58fa71/checks/chk_1/payments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "tenderType": "card",
    "amount": 26.49,
    "tipAmount": 5.00,
    "currency": "USD",
    "card": {
      "token": "tok_visa_28f1",
      "last4": "4242",
      "brand": "Visa"
    },
    "receipt": {
      "email": "[email protected]"
    },
    "referenceId": "ecom-psp-9912"
  }'

Example response

{
  "paymentId": "pay_7f91a0",
  "status": "captured",
  "tipAmount": 5.00,
  "closeCheck": true,
  "closedAt": "2026-01-21T11:20:44Z"
}

Time Entries

GET /employees/time-entries: Pull timesheets for payroll and labor analytics.

Query parameters

  • locationId: string
  • startDate, endDate: ISO 8601 dates
  • role: server | bartender | cook | cashier | manager
  • page, pageSize: integers

Example response

{
  "items": [
    {
      "timeEntryId": "te_902a1b",
      "employeeId": "emp_lavu_7a19c2",
      "employeeName": "J. Rivera",
      "role": "server",
      "clockIn": "2026-01-20T16:02:10Z",
      "clockOut": "2026-01-20T23:10:41Z",
      "breakMinutes": 30,
      "locationId": "loc_a1b2c3",
      "approved": true
    }
  ],
  "page": 1,
  "pageSize": 100,
  "total": 1
}

Get full API Specs →

Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for hospitality throughput while honoring customer entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks across multi-device environments
  • Data freshness: Near real-time retrieval of menus, orders, payments, inventory, and labor objects
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Lavu role-based permissions
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., order status changes, shift closures)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume menu sync, order ingestion, and payment posting
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Lavu adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Lavu evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Lavu modules can this integration cover?

Supergood supports workflows across commonly used modules such as Order Management (Tables, Tickets, Checks), Menu Management (Categories, Items, Modifiers), Payments (Card, Cash, Gift Cards, Tips), Inventory (Adjustments, Depletions), and Labor (Time Clock, Shifts), subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you sync sales and tips to our accounting system?

Yes. We normalize payments, tips, and tax reporting to match your ERP/accounting schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and Xero.

Q: Do you support delivery orders and online ordering flows?

Yes. We can ingest and create takeout/delivery tickets, maintain menu availability by daypart, and reconcile third-party orders with POS checks and payments.

Ready to automate your Lavu POS workflows?

Supergood can have your Lavu integration live in days with no ongoing engineering maintenance.

Get Started →

Read more