Connecting Koomi POS to Craveva

Overview

Prerequisites

• Active Koomi POS account
• Koomi API access (contact Koomi support)
• API credentials (API Key and Secret)
• Craveva AI account with appropriate permissions

Step 1: Request Koomi API Access

1. Contact Koomi support team via their website or support portal
2. Request API access for Craveva AI integration
3. Provide your business information:
4. Once approved, you'll receive:

• - Company name
• - Koomi account details
• - Integration use case
• - API Key: Your authentication key
• - API Secret: Your secret key
• - API Documentation: Access to Koomi API documentation
• - Base URL: Your Koomi API endpoint

Step 2: Connect Koomi POS in Craveva

1. Log in to your Craveva AI dashboard
2. Navigate to Data Sources from the main menu
3. Click Connect New Data Source
4. Select REST API as the connection type
5. Choose POS System category
6. Enter your Koomi credentials:
7. Click Test Connection to verify
8. If successful, click Save Connection

• - Connection Name: "Koomi POS" (or your preferred name)
• - Base URL: Your Koomi API base URL (provided by Koomi)
• - Authentication Type: API Key or OAuth (as provided by Koomi)
• - API Key: Your Koomi API Key
• - API Secret: Your Koomi API Secret (if required)
• - Store ID: Your Koomi store/outlet identifier

Step 3: Configure Koomi Endpoints

• Sales: /api/sales - Transaction and sales data
• Products: /api/products - Product catalog and menu items
• Inventory: /api/inventory - Stock levels and inventory
• Orders: /api/orders - Order information
• Customers: /api/customers - Customer data
• Reports: /api/reports - Sales and performance reports
• Outlets: /api/outlets - Multi-outlet information

Step 4: Verify Connection

1. Go to Data Sources page
2. You should see your Koomi POS connection listed
3. Click on it to view connection details
4. Status should show Connected
5. Test data retrieval by clicking Preview Data
6. Verify you can see sales transactions and product data

Step 5: Create Koomi POS Agents

Sales Analytics Agent

1. Navigate to Agent Builder
2. Create new agent with Koomi POS data source
3. Configure for sales analysis:

• - Real-time sales monitoring
• - Daily/weekly/monthly sales reports
• - Product performance tracking
• - Peak hours analysis
• - Revenue trends across outlets

Inventory Management Agent

1. Create agent for inventory monitoring
2. Set up alerts for:
3. Track inventory across multiple outlets

• - Low stock levels
• - Out-of-stock items
• - Slow-moving products
• - Reorder recommendations

Multi-Outlet Dashboard

1. Connect multiple Koomi POS outlets
2. Create unified analytics dashboard
3. Compare performance across outlets
4. Identify best-performing locations
5. Optimize operations across all outlets

Available Data

• Sales Transactions: All POS transactions with timestamps, amounts, and payment methods
• Products: Complete product catalog with pricing, categories, and variants
• Inventory: Real-time stock levels per outlet and location
• Orders: Order details, status, and timing information
• Customers: Customer profiles and purchase history
• Reports: Pre-built sales, inventory, and performance reports
• Outlets: Multi-outlet information and configuration

Use Cases

Real-Time Sales Monitoring

• Track sales in real-time across all outlets
• Monitor daily revenue goals
• Alert on unusual sales patterns
• Compare performance across time periods

Inventory Optimization

• Predict stockouts before they happen
• Optimize reorder points
• Reduce waste through better inventory management
• Track inventory costs and turnover

Multi-Outlet Management

• Compare outlet performance
• Identify best practices
• Optimize staffing across locations
• Unified reporting across all outlets

Customer Insights

• Analyze customer purchase patterns
• Identify VIP customers
• Personalize marketing campaigns
• Track customer lifetime value

GrabFood Integration

• Koomi POS integrates with GrabFood
• Automatically receive GrabFood orders in POS
• Unified order management
• Track delivery vs. dine-in sales

Koomi POS Features

• iPad POS Ready: Portable POS system for table service
• Cloud-Based: Access data from anywhere, anytime
• Zero Downtime: Seamless online-offline functionality
• Franchise-Ready: Multi-outlet management capabilities
• Real-Time Data: Instant access to business insights

Webhook Configuration (Optional)

1. Contact Koomi support to enable webhooks
2. Provide webhook URL: https://api.craveva.ai/webhooks/koomi
3. Subscribe to events:
4. Verify webhook delivery

• - New sale
• - Inventory update
• - Order status change
• - Product updates

Troubleshooting

• Contact Koomi support to request API access
• Provide business justification for integration
• Wait for approval (typically 1-2 business days)
• Follow up if no response

• Verify API key and secret are correct
• Check that API access is enabled in your Koomi account
• Ensure store ID matches your account
• Verify network connectivity
• Check API base URL is correct

• Wait 2-3 minutes for initial data sync
• Check that your Koomi POS has recent transactions
• Verify API permissions include data read access
• Test endpoint manually using Koomi API docs
• Contact Koomi support if issues persist

• Regenerate API key pair if expired
• Ensure API secret is entered correctly (no extra spaces)
• Check API key hasn't been revoked
• Verify authentication method (API Key vs OAuth)

Best Practices

• Secure Credentials: Never share API keys publicly
• Rate Limiting: Be mindful of Koomi API rate limits
• Data Sync: Allow time for initial data synchronization
• Monitoring: Set up alerts for connection issues
• Backup: Keep API credentials in secure password manager
• Multi-Outlet: Connect all outlets for comprehensive analytics

Government Grants

Next Steps

• Create your first sales analytics agent
• Set up inventory monitoring alerts
• Connect additional Koomi POS outlets
• Build custom dashboards for your team
• Integrate with other Koomi solutions (KoomiOrder, KoomiQR, etc.)