> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Centegra

> Connect Centegra POS to storekit for order injection and floor plan sync. Manual product linking via PLUs sends orders straight to your existing tills.

Centegra is an enterprise POS system commonly used in hospitality. The storekit integration enables automatic order injection and floor plan synchronisation. Menu management uses manual product linking - you build your menu in storekit and link products to their Centegra IDs.

## What You Get

* **Order injection** - Online orders sent directly to Centegra
* **Floor plan sync** - Import locations and tables from Centegra
* **Manual product linking** - Full control over your online menu presentation

## Getting Started

### What You'll Need

Contact your Centegra account manager to get:

* **Secure Key** - Your company-level API key
* **Site ID** - Identifies your specific location

You'll also need to configure venue-specific settings in the storekit dashboard after connecting.

### Connecting Centegra

1. Go to **Settings > Integrations** in your storekit dashboard
2. Select **Centegra**
3. Enter your **Secure Key**
4. Click **Connect**

### Selecting Your Site

After connecting at the account level:

1. Go to your venue's integration settings
2. Select your Centegra **Site** from the available options
3. The Site ID is saved for order routing

### Configuring Venue Settings

Each venue requires specific Centegra settings:

| Setting             | Description                                   |
| ------------------- | --------------------------------------------- |
| **Location**        | The area/location within your site for orders |
| **Till**            | Which till receives online orders             |
| **Till Secure Key** | Authentication key for the selected till      |
| **Clerk**           | The clerk ID used for online orders           |
| **Media**           | Payment media type for online payments        |
| **Source**          | Source identifier for online orders           |
| **Price Level**     | Which price level to use for order items      |

<Warning>
  All settings must match valid values in your Centegra system. Incorrect configuration will cause orders to fail.
</Warning>

## Linking Products

Centegra uses **manual product linking** - products aren't automatically synced from your POS.

### How It Works

1. Create your menu in storekit with categories, products, and modifiers
2. For each product, enter its **Centegra Product ID** in the POS ID field
3. For each modifier, enter its **Centegra Product ID**
4. When orders are placed, storekit sends the Product IDs to Centegra

### Finding Product IDs

Your Centegra Product IDs can be found in:

* The Centegra back office under Products
* Product export reports
* By contacting your Centegra support team

### Linking Modifiers

Modifiers also need Product IDs from Centegra:

1. Go to your modifier groups in storekit
2. For each modifier option, enter its Centegra Product ID
3. Modifiers are sent as child items linked to their parent product

## How Orders Work

### Order Flow

1. Customer places order on your storekit store
2. Order is validated with Centegra (`TransactionValidate`)
3. If valid, order is submitted (`Transaction`)
4. Order appears in Centegra on the configured till
5. Customer receives confirmation with transaction ID

<Info>
  If an order fails to sync to Centegra, you'll receive an email notification with the error details and a direct link to the order in your dashboard.
</Info>

### Order Types

| Online Order | Centegra Transaction Type |
| ------------ | ------------------------- |
| Pickup       | Type 2                    |
| Delivery     | Type 3                    |

### What Centegra Receives

Each order includes:

* External transaction ID (timestamp-based)
* Location, till, and clerk IDs
* All items with Product IDs, quantities, and prices
* Modifiers as child items linked to parents
* Calculated discounts distributed across items
* Payment details with media ID
* Customer name, email, phone
* Order reference number
* Preparation start time (for scheduling)
* Order notes

### Discounts

When a discount is applied:

* The discount amount is distributed proportionally across all items
* Each item shows its unit price, gross total, and discount amount
* Centegra receives the full discount breakdown

### Tips

Tips are handled as a negative payment line item, keeping the order total accurate while tracking gratuity separately.

## Floor Plan Sync

Import your table layout from Centegra:

1. Go to **Store Settings > Tables**
2. Click **Sync from Centegra**
3. Locations become areas, tables are imported with their numbers

### What Gets Synced

* **Locations** - Become venue areas in storekit
* **Tables** - Imported with table numbers as names and POS IDs
* Changes in Centegra sync when you trigger a refresh

## Troubleshooting

### Connection Issues

**"Secure Key not found"**

* Verify your Secure Key is entered correctly at the account level
* Contact Centegra support to confirm your API access

**"Site not found"**

* Check the Site ID matches your location in Centegra
* Ensure your Secure Key has access to this site

### Order Issues

**Orders failing validation**

* Check all venue settings are configured (location, till, clerk, etc.)
* Verify the Till Secure Key is correct
* Ensure all products have valid Centegra Product IDs

**"Product doesn't have posId"**

* The failing item is missing its Centegra Product ID
* Edit the product in storekit and add the POS ID

**"Modifier doesn't have posId"**

* A modifier option is missing its Product ID
* Edit the modifier and add the Centegra Product ID

### Wrong Items or Prices

* Verify Product IDs match between storekit and Centegra
* Check the Price Level setting is correct for your online menu
* Ensure tax rates are configured on products

### Tables Not Syncing

* Confirm your venue has a valid Site ID (posId)
* Check Locations exist in Centegra for your site
* Verify tables are configured within each location

## Go-Live Checklist

Before launching:

* [ ] Secure Key entered at account level
* [ ] Venue settings configured (location, till, clerk, media, source, price level)
* [ ] All products have Centegra Product IDs
* [ ] All modifiers have Centegra Product IDs
* [ ] Place a test pickup order
* [ ] Verify order appears on the correct till in Centegra
* [ ] Check items, modifiers, and prices are correct
* [ ] Test a delivery order with full address
* [ ] Sync floor plan (if using dine-in)

## Supported Features

<AccordionGroup>
  <Accordion title="Menu Sync">
    | Feature                | Supported |
    | ---------------------- | :-------: |
    | Automatic menu sync    |     ✗     |
    | Manual product linking |     ✓     |
    | Product images         |     ✗     |
    | Allergens              |     ✗     |
    | Nutrition info         |     ✗     |
    | Nested modifiers       |     ✗     |
    | Subcategories          |     ✗     |
    | Stock status           |     ✗     |

    Centegra uses manual product linking. Create your menu in storekit and enter the Centegra Product ID for each item.
  </Accordion>

  <Accordion title="Orders">
    | Feature                    | Supported |
    | -------------------------- | :-------: |
    | Order injection            |     ✓     |
    | Pre-orders                 |     ✓     |
    | Order buffering            |     ✗     |
    | Basket validation          |     ✗     |
    | Auto-snooze sold out items |     ✗     |
    | Discounts                  |     ✓     |
    | Tips                       |     ✓     |
    | Service charge             |     ✗     |
    | Custom order notes         |     ✓     |
    | Delivery details           |     ✓     |
  </Accordion>

  <Accordion title="Pay at Table">
    | Feature                     | Supported |
    | --------------------------- | :-------: |
    | Live bill sync              |     ✗     |
    | Apply payments to bill      |     ✗     |
    | Split payments              |     ✗     |
    | Track POS terminal payments |     ✗     |
    | Add to existing bill        |     ✗     |
  </Accordion>

  <Accordion title="Venue Setup">
    | Feature                 | Supported |
    | ----------------------- | :-------: |
    | Floor plan sync         |     ✓     |
    | Real-time stock updates |     ✗     |
    | Multi-site support      |     ✓     |
  </Accordion>
</AccordionGroup>

## Related

* [POS Integration Overview](/guides/integrations/pos/overview)
* [PLU Mapping Guide](/guides/integrations/pos/advanced/plu-mapping)
* [Troubleshooting POS Issues](/guides/integrations/pos/advanced/troubleshooting)
