Documentation

Sign up at uwupos.com/signup. Enter your business name, choose a URL slug (e.g. my-store), and select a subscription tier. You'll get an admin account and can start adding products immediately.

Go to Products in the admin dashboard. Click 'Add Product' and fill in name, price, cost, SKU, and barcode. You can also bulk import products via CSV — download the template from Products > Import.

Navigate to Staff in the admin dashboard. Add staff members with email, role, and hourly rate. Staff can log in via the mobile app using their credentials.

Go to Settings > Payment. Enter your Marx IPG API key and merchant ID to accept card payments. Cash payments are enabled by default. Toggle test mode for development.

Go to Attendance > Location tab. Enter your store's latitude, longitude, and address. Set the geofence radius (default 100m). This is required for staff attendance check-in via the mobile app.

Staff open the POS tab on the mobile app. Scan product barcodes or enter them manually. Adjust quantities, then tap Checkout. Choose Cash or Card payment. Cash payments are recorded immediately; card payments go through Marx IPG.

The mobile app supports barcode scanning via the device camera. Tap 'Scan Barcode' on the POS screen. Products are automatically looked up by barcode and added to the cart.

In the admin dashboard, go to Orders, find the order, and click the refund option. Refunds for card payments are processed through Marx IPG. Cash refunds are recorded manually.

View current stock levels in the Inventory dashboard. Each product shows quantity, low stock threshold, and warehouse location. Quantities update automatically when orders are placed.

Set a low stock threshold per product (default configurable in Settings). When stock drops below the threshold, it appears in the Low Stock Alerts section on the dashboard.

Export your product catalog as CSV from Products > Export. Import products from CSV using Products > Import. Download the template first to see the required columns (name, sku, price, cost, barcode, category).

Staff check in via the mobile app. The app verifies their GPS location is within the store's geofence radius, then requires biometric authentication (fingerprint/face). Both checks must pass for attendance to be recorded. Admin can see all check-ins, distances, and violations in the Attendance dashboard.

Admins can manually check in/out staff from the Attendance dashboard for edge cases (GPS issues, device problems). Manual entries are marked as 'manual' method in reports.

Staff costs are automatically calculated: hours worked × hourly rate. View cost breakdowns per staff member in Attendance > Report tab with date range filtering.

Open AI Chat from the admin sidebar. Ask about inventory ('What should I restock?'), sales trends ('Show profit trends'), or product performance ('Which products are underperforming?'). Powered by OpenAI.

Customers can chat with the AI assistant in the mobile app. Ask about products ('What's in this product?', 'Is this gluten-free?'), get recommendations, and browse suggestions.

Auto-generate product descriptions, ingredients, allergen info, and nutritional data using AI. Go to a product in admin, click 'Generate AI Info', and select the type. Results are cached to avoid repeated API calls.

All API requests require a Bearer token in the Authorization header. Get tokens via POST /api/v1/auth/login. Tokens expire in 15 minutes; use POST /api/v1/auth/refresh with the refresh token to get new ones. Include X-Tenant-ID header for tenant-scoped requests.

GET /api/v1/products — List products (paginated, filterable by search, category, active status). POST /api/v1/products — Create product (admin). PUT /api/v1/products/:id — Update product. DELETE /api/v1/products/:id — Soft delete. Full OpenAPI spec available at /api/docs on your backend instance.

POST /api/v1/pos/cart — Create cart. POST /api/v1/pos/cart/:id/items — Add items. POST /api/v1/pos/orders — Create order from cart. POST /api/v1/pos/orders/:id/pay/cash — Record cash payment. POST /api/v1/pos/orders/:id/pay/card — Initiate card payment via Marx IPG.

Interactive Swagger UI available at /api/docs on your backend deployment. Static OpenAPI 3.0 spec at /docs/openapi.yaml in the backend repository. Covers all 60+ endpoints across auth, products, orders, staff, attendance, reports, AI, and more.