Connecting StoreHub POS to Craveva

Overview

Prerequisites

• Active StoreHub merchant account
• StoreHub API access enabled
• StoreHub API credentials (API Key and Secret)
• Craveva AI account with appropriate permissions

Step 1: Enable StoreHub API Access

1. Log in to your StoreHub merchant dashboard
2. Navigate to Settings → Integrations → API Access
3. Click Enable API Access if not already enabled
4. Generate a new API key pair:
5. Note your Store ID (found in Settings → Store Information)

• - API Key: Your public API identifier
• - API Secret: Your private API secret (save this securely)

Step 2: Configure API Permissions

• Sales Data: Read transaction and order information
• Inventory: Read product and stock level data
• Customers: Read customer information (optional)
• Reports: Access to sales reports and analytics

Step 3: Connect StoreHub 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 StoreHub credentials:
7. Click Test Connection to verify
8. If successful, click Save Connection

• - Connection Name: "StoreHub POS" (or your preferred name)
• - Base URL: https://api.storehub.com/v1
• - Authentication Type: API Key
• - API Key: Your StoreHub API Key
• - API Secret: Your StoreHub API Secret (in password field)
• - Store ID: Your StoreHub Store ID

Step 4: Configure Endpoints

• Sales: /sales - Transaction data
• Products: /products - Product catalog
• Inventory: /inventory - Stock levels
• Orders: /orders - Order information
• Customers: /customers - Customer data

Step 5: Verify Connection

1. Go to Data Sources page
2. Find your StoreHub connection
3. Click on it to view details
4. Status should show Connected
5. Test data retrieval by clicking Preview Data

Step 6: Create Multi-Outlet Agents

Sales Analytics Agent

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

• - Daily/weekly/monthly sales reports
• - Product performance tracking
• - Peak hours analysis
• - Revenue trends

Inventory Management Agent

1. Create agent for inventory monitoring
2. Set up alerts for:

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

Multi-Outlet Dashboard

1. Connect multiple StoreHub outlets
2. Create unified analytics dashboard
3. Compare performance across outlets
4. Identify best-performing locations

Available Data

• Sales Transactions: All POS transactions with timestamps
• Products: Complete product catalog with pricing
• Inventory: Real-time stock levels per outlet
• Orders: Order details and status
• Customers: Customer profiles and purchase history
• Reports: Pre-built sales and inventory reports

Use Cases

Real-Time Sales Monitoring

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

Inventory Optimization

• Predict stockouts before they happen
• Optimize reorder points
• Reduce waste through better inventory management

Customer Insights

• Analyze customer purchase patterns
• Identify VIP customers
• Personalize marketing campaigns

Multi-Outlet Management

• Compare outlet performance
• Identify best practices
• Optimize staffing across locations

Webhook Configuration (Optional)

1. In StoreHub dashboard → Settings → Webhooks
2. Add webhook URL: https://api.craveva.ai/webhooks/storehub
3. Subscribe to events:
4. Verify webhook delivery

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

Troubleshooting

• Verify API key and secret are correct
• Check that API access is enabled in StoreHub
• Ensure Store ID matches your account
• Verify network connectivity

• Wait 2-3 minutes for initial data sync
• Check that your StoreHub account has recent transactions
• Verify API permissions include data read access
• Test endpoint manually using StoreHub API docs

• Regenerate API key pair if expired
• Ensure API secret is entered correctly (no extra spaces)
• Check API key hasn't been revoked

Best Practices

• Secure Credentials: Never share API keys publicly
• Rate Limiting: Be mindful of StoreHub 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

Next Steps

• Create your first sales analytics agent
• Set up inventory monitoring alerts
• Connect additional StoreHub outlets
• Build custom dashboards for your team