> ## 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.

# Connecting Comtrex

> Point storekit at your Comtrex server, load the till's media types, map tips, discounts and payments to till media, and turn the integration on.

Connecting Comtrex links one storekit store to the Comtrex server at one site. You enter the server address and vendor ID, load the media types the till reports, tell storekit which media to post tips, discounts and payments against, then enable the integration.

## Prerequisites

* A Comtrex EPOS installation with the Real Time Ordering (RTO) interface enabled
* The Comtrex server's address (host or IP, plus port if it isn't 80) and the vendor name Zonal has configured for storekit — ask your Zonal account manager if you don't have them
* The Comtrex server reachable from the internet, or a route Zonal has agreed with storekit
* The Comtrex integration enabled on your storekit account

<Note>
  If **Comtrex** does not appear in your **Integrations** list, the integration isn't enabled for your account yet — [contact storekit support](/docs/getting-started/contact-support).
</Note>

## Connect Your Till

<Steps>
  <Step title="Open the Comtrex integration">
    Go to **Stores** → your store → **Settings** → **Integrations**, then select **Comtrex**.
  </Step>

  <Step title="Enter the server details">
    Fill in **Server IP Address** and **Vendor ID**. Enter the address without a scheme — storekit adds `http://` for you — and include the port if the RTO interface isn't on port 80, for example `192.168.1.20:16700`. Click **Save**.
  </Step>

  <Step title="Load the media types from the till">
    Click **Load from till**. The button stays disabled — with the note *Save the connection details to load anything from the till.* — until the address and vendor ID you see on screen have been saved. storekit asks the Comtrex server for its media list; when it succeeds the status line reads *Connected — media types loaded from the till.* and the button changes to **Reload**. If it fails, check the address and that the server is reachable — see [Troubleshooting](/docs/guides/integrations/pos/comtrex/troubleshooting#load-from-till-fails).
  </Step>

  <Step title="Map the till media">
    Pick a **Tip ID**, **Discount ID** and **Payment Type ID** from the lists the till returned, and enter the **Sales Type Number** online orders should use (see below).
  </Step>

  <Step title="Turn the integration on">
    Switch **Integration Status** on. The label next to it reads *Enabled - sending orders to Comtrex* when the store is live.
  </Step>

  <Step title="Save">
    Click **Save**.
  </Step>
</Steps>

<Frame caption="The Connection section after a successful Load from till">
  <img src="https://mintcdn.com/storekit/ESLFABunh773fqh0/images/comtrex/connection.png?fit=max&auto=format&n=ESLFABunh773fqh0&q=85&s=442a585baf6a367855b13a909f681310" alt="The Connection section of the Comtrex settings page showing Server IP Address, Vendor ID, the Connected status line with a Reload button, and Integration Status enabled" width="992" height="366" data-path="images/comtrex/connection.png" />
</Frame>

<Info>
  Each storekit store connects to a single Comtrex server. For multi-site accounts, repeat this for every store.
</Info>

<Warning>
  A store can only have one POS integration enabled. If another POS is already enabled on the store, switching **Integration Status** on fails with *This venue already has a POS integration. Please remove it before enabling Comtrex.* — disable the other integration first.
</Warning>

## Media Mapping

Comtrex records tips, discounts and payments against *media types* configured on the till. storekit needs to know which media to use for each, so create them on the till first (your Zonal account manager can do this), then click **Load from till** and pick them here.

<Frame caption="Media mapping — options come straight from the till, shown as name and media number">
  <img src="https://mintcdn.com/storekit/ESLFABunh773fqh0/images/comtrex/media-mapping.png?fit=max&auto=format&n=ESLFABunh773fqh0&q=85&s=34ced12d1bf8b36f4c3130de458c4368" alt="The Media mapping section with Tip ID set to Gratuity #301, Discount ID set to Online Discount #410, Payment Type ID set to storekit #12, and Sales Type Number 3" width="992" height="543" data-path="images/comtrex/media-mapping.png" />
</Frame>

| Setting               | What it's for                                                                                                                                                                           |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tip ID**            | The media type tips are posted to — both tips on online orders (when **Send Gratuity Amount** is on) and tips added to pay-at-table payments.                                           |
| **Discount ID**       | The media type storekit discounts (promo codes, loyalty rewards) are posted to. It must accept an open amount, because storekit sends the discount as a value rather than a percentage. |
| **Payment Type ID**   | The media type storekit payments are finalised with. Card orders and pay-at-table payments are recorded against it with the payment name `storekit`.                                    |
| **Sales Type Number** | The Comtrex sales type sent with every online order — delivery, pickup and in-store orders all use this one number. Ask Zonal which sales type they've set up for online orders.        |

Each media dropdown has an **Enter ID manually** link beneath it. Use it if the media type you need isn't in the list the till returned, or if you're setting up before the till is reachable.

<Tip>
  Keep **Payment Type ID** as a dedicated `storekit` media type on the till rather than reusing a card or cash media. It makes end-of-day reconciliation between storekit payouts and the till far simpler.
</Tip>

## Other Connection Settings

* **Integration Status** — the master switch. When it's off the settings are kept but nothing is sent to Comtrex, and the label reads *Disabled - not sending orders to Comtrex*. Turning it on also sets the store's POS provider to Comtrex.
* **Reload** — re-fetches the media list from the till. Use it after Zonal adds a new media type.

<Tip>
  **Integration Status** saves the moment you switch it. Everything else on the page — addresses, media mappings, order handling — only takes effect once you click **Save**. **Load from till** and **Reload** don't save anything by themselves.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Menu Linking & Price Sync" icon="utensils" href="/docs/guides/integrations/pos/comtrex/menu-sync">
    Give every product and modifier the till's item number
  </Card>

  <Card title="Orders" icon="receipt" href="/docs/guides/integrations/pos/comtrex/orders">
    Choose what's sent alongside each order
  </Card>
</CardGroup>


## Related topics

- [Comtrex (Zonal)](/docs/guides/integrations/pos/comtrex/overview.md)
- [Menu Linking & Price Sync](/docs/guides/integrations/pos/comtrex/menu-sync.md)
- [Connecting Toast](/docs/guides/integrations/pos/toast/connect.md)
- [Connecting Deliverect](/docs/guides/integrations/pos/deliverect/connect.md)
- [Connecting Syrve](/docs/guides/integrations/pos/syrve/connect.md)
