Setting Up Your First Integration

This guide walks you through connecting your first delivery platform with Grubtech. We’ll use a typical POS-to-aggregator setup as an example.

Prerequisites

Before you begin, make sure you have:

• A Grubtech account with admin access
• API credentials from your delivery platform (e.g., Deliveroo, Talabat, or Uber Eats)
• Your POS system’s integration details

Step 1: Access the Integration Hub

Navigate to Settings → Integrations in your Grubtech dashboard. You’ll see a list of available platforms organized by category:

• Delivery Aggregators — Deliveroo, Talabat, Uber Eats, Zomato
• POS Systems — Oracle MICROS, Lightspeed, Square
• Kitchen Management — Grubtech KDS, custom displays

Step 2: Select Your Platform

Click on the platform you want to connect. Each platform has its own authentication flow:

OAuth-based Platforms

For platforms like Uber Eats and Deliveroo:

1. Click Connect
2. You’ll be redirected to the platform’s authorization page
3. Grant Grubtech the required permissions
4. You’ll be redirected back with the connection active

API Key Platforms

For platforms that use API keys:

1. Enter your API Key and API Secret
2. Specify the Store ID or Branch ID
3. Click Verify & Connect

Step 3: Map Your Menu

Once connected, Grubtech will pull your existing menu from the platform. You’ll need to:

1. Review the imported menu items
2. Map categories between your POS and the delivery platform
3. Set pricing rules (if different from in-store pricing)
4. Configure availability schedules

Step 4: Test the Connection

Use the Test Order feature to verify everything works:

POST /api/v1/orders/test
{
  "platform": "deliveroo",
  "store_id": "store_123",
  "items": [
    { "name": "Margherita Pizza", "quantity": 1 }
  ]
}

You should see the test order appear in your POS system within seconds.

Troubleshooting