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

# Collegare Comtrex

> Punta storekit al tuo server Comtrex, carica i media type della cassa, mappa mance, sconti e pagamenti ai media della cassa e attiva l'integrazione.

Collegare Comtrex associa un locale storekit al server Comtrex di un sito. Inserisci l'indirizzo del server e il vendor ID, carichi i media type che la cassa riporta, indichi a storekit su quali media registrare mance, sconti e pagamenti, quindi abiliti l'integrazione.

## Prerequisiti

* Un'installazione EPOS Comtrex con l'interfaccia Real Time Ordering (RTO) abilitata
* L'indirizzo del server Comtrex (host o IP, più la porta se non è 80) e il vendor name che Zonal ha configurato per storekit — chiedi al tuo account manager Zonal se non li hai
* Il server Comtrex raggiungibile da Internet, o un percorso che Zonal ha concordato con storekit
* L'integrazione Comtrex abilitata sul tuo account storekit

> [!NOTE]
>
> Se **Comtrex** non compare nel tuo elenco **Integrations**, l'integrazione non è ancora abilitata per il tuo account — [contatta il supporto storekit](/docs/it/getting-started/contact-support).

## Collega la tua cassa

**1. Apri l'integrazione Comtrex**

Vai su **Stores** → il tuo locale → **Settings** → **Integrations**, poi seleziona **Comtrex**.

**2. Inserisci i dettagli del server**

Compila **Server IP Address** e **Vendor ID**. Inserisci l'indirizzo senza schema — storekit aggiunge `http://` per te — e includi la porta se l'interfaccia RTO non è sulla porta 80, per esempio `192.168.1.20:16700`. Clicca su **Save**.

**3. Carica i media type dalla cassa**

Clicca su **Load from till**. Il pulsante rimane disabilitato — con la nota *Save the connection details to load anything from the till.* — finché l'indirizzo e il vendor ID che vedi a schermo non sono stati salvati. storekit chiede al server Comtrex la sua lista di media; quando ha successo la riga di stato riporta *Connected — media types loaded from the till.* e il pulsante diventa **Reload**. Se fallisce, controlla l'indirizzo e che il server sia raggiungibile — vedi [Risoluzione dei problemi](/docs/it/guides/integrations/pos/comtrex/troubleshooting#load-from-till-fails).

**4. Mappa i media della cassa**

Scegli un **Tip ID**, **Discount ID** e **Payment Type ID** dalle liste restituite dalla cassa, e inserisci il **Sales Type Number** che gli ordini online devono usare (vedi sotto).

**5. Attiva l'integrazione**

Attiva **Integration Status**. L'etichetta accanto riporta *Enabled - sending orders to Comtrex* quando il locale è live.

**6. Salva**

Clicca su **Save**.

![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](https://mintcdn.com/storekit/ESLFABunh773fqh0/images/comtrex/connection.png?fit=max\&auto=format\&n=ESLFABunh773fqh0\&q=85\&s=442a585baf6a367855b13a909f681310)

> [!NOTE]
>
> Ogni locale storekit si collega a un singolo server Comtrex. Per gli account multi-sito, ripeti la procedura per ogni locale.

> [!WARNING]
>
> Un locale può avere una sola integrazione POS abilitata. Se un altro POS è già abilitato sul locale, attivare **Integration Status** fallisce con *This venue already has a POS integration. Please remove it before enabling Comtrex.* — disabilita prima l'altra integrazione.

## Mappatura dei media

Comtrex registra mance, sconti e pagamenti su *media type* configurati sulla cassa. storekit deve sapere quale media usare per ognuno, quindi creali prima sulla cassa (può farlo il tuo account manager Zonal), poi clicca su **Load from till** e selezionali qui.

![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](https://mintcdn.com/storekit/ESLFABunh773fqh0/images/comtrex/media-mapping.png?fit=max\&auto=format\&n=ESLFABunh773fqh0\&q=85\&s=34ced12d1bf8b36f4c3130de458c4368)

| Impostazione | A cosa serve |
| - | - |
| **Tip ID** | Il media type su cui vengono registrate le mance — sia le mance sugli ordini online (quando **Send Gratuity Amount** è attivo) sia quelle aggiunte ai pagamenti pay-at-table. |
| **Discount ID** | Il media type su cui vengono registrati gli sconti storekit (codici promo, ricompense fedeltà). Deve accettare un importo aperto, perché storekit invia lo sconto come valore anziché come percentuale. |
| **Payment Type ID** | Il media type con cui vengono finalizzati i pagamenti storekit. Gli ordini con carta e i pagamenti pay-at-table vengono registrati su di esso con il nome pagamento `storekit`. |
| **Sales Type Number** | Il sales type Comtrex inviato con ogni ordine online — gli ordini di delivery, pickup e in-store usano tutti questo stesso numero. Chiedi a Zonal quale sales type hanno configurato per gli ordini online. |

Ogni dropdown media ha sotto un link **Enter ID manually**. Usalo se il media type che ti serve non è nella lista restituita dalla cassa, o se stai configurando prima che la cassa sia raggiungibile.

> [!TIP]
>
> Mantieni **Payment Type ID** come un media type `storekit` dedicato sulla cassa invece di riutilizzare un media di carta o contanti. Rende molto più semplice la riconciliazione di fine giornata tra i payout storekit e la cassa.

## Altre impostazioni di connessione

* **Integration Status** — l'interruttore principale. Quando è disattivato le impostazioni vengono mantenute ma nulla viene inviato a Comtrex, e l'etichetta riporta *Disabled - not sending orders to Comtrex*. Attivarlo imposta anche il provider POS del locale su Comtrex.
* **Reload** — riscarica la lista dei media dalla cassa. Usalo dopo che Zonal aggiunge un nuovo media type.

> [!TIP]
>
> **Integration Status** viene salvato nel momento in cui lo attivi. Tutto il resto sulla pagina — indirizzi, mappature dei media, gestione degli ordini — ha effetto solo dopo aver cliccato su **Save**. **Load from till** e **Reload** non salvano nulla da soli.

## Prossimi passi

> **[Collegamento del menu e sync dei prezzi](/docs/it/guides/integrations/pos/comtrex/menu-sync)**
>
> Assegna a ogni prodotto e modificatore il numero di articolo della cassa

> **[Ordini](/docs/it/guides/integrations/pos/comtrex/orders)**
>
> Scegli cosa viene inviato insieme a ogni ordine


## Related topics

- [Comtrex (Zonal)](/docs/it/guides/integrations/pos/comtrex/overview.md)
- [Collegamento del menu e sync dei prezzi](/docs/it/guides/integrations/pos/comtrex/menu-sync.md)
- [Collegare Toast](/docs/it/guides/integrations/pos/toast/connect.md)
- [Collegare Syrve](/docs/it/guides/integrations/pos/syrve/connect.md)
- [Collegare Deliverect](/docs/it/guides/integrations/pos/deliverect/connect.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.