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

# Risoluzione dei problemi

> Risolvi i problemi comuni di Comtrex: cassa irraggiungibile, ordini con errore POS, articoli non emessi o pay at table che non trova un conto.

La maggior parte dei problemi Comtrex si riduce a tre cose: storekit non riesce a raggiungere il server Comtrex, un ID (articolo, tavolo o media) non corrisponde a ciò che la cassa si aspetta, o l'integrazione è disattivata. Segui la sezione che corrisponde a ciò che stai osservando.

## Problemi di connessione

> **Load from till fallisce — *Couldn't reach the till — enter the media IDs manually.***
>
> storekit non è riuscito a ottenere una risposta dal server Comtrex al **Server IP Address** che hai salvato.
>
> 1. Verifica l'indirizzo e la porta con Zonal. storekit chiama `http://<address>/v10/jrequest.cgi`, quindi il servizio web RTO deve essere in ascolto su quell'indirizzo e raggiungibile da Internet.
> 2. Verifica il **Vendor ID** — Comtrex rifiuta le richieste da un vendor sconosciuto.
> 3. Assicurati di aver cliccato su **Save** prima di **Load from till** — il pulsante usa i dettagli salvati, non ciò che è digitato nei campi.
>
> Se la cassa non è genuinamente raggiungibile da fuori il locale, chiedi a Zonal gli ID dei media e usa invece **Enter ID manually** sotto ciascun dropdown media.

> **Load from till è disabilitato**
>
> Rimane disabilitato con *Save the connection details to load anything from the till.* finché **Server IP Address** e **Vendor ID** che vedi a schermo non sono stati salvati. Clicca su **Save**, poi riprova.

> **Integration Status non si attiva — *This venue already has a POS integration…***
>
> Un locale può avere una sola integrazione POS abilitata. Apri **Stores** → il tuo locale → **Settings** → **Integrations**, trova l'altra integrazione marcata **Connected** e disabilitala prima lì. Poi attiva **Integration Status** per Comtrex.

> **Gli ordini non arrivano affatto alla cassa, senza errori in storekit**
>
> Verifica che **Integration Status** riporti *Enabled - sending orders to Comtrex*. Se riporta *Disabled - not sending orders to Comtrex*, gli ordini vengono accettati da storekit ma mai inviati. Attivalo — viene salvato immediatamente.

## Ordini falliti

Quando Comtrex rifiuta un ordine, o storekit non riesce a raggiungere il server, l'ordine appare come failed e la pagina dell'ordine mostra *Something went wrong sending this order to the POS:* seguito dal testo di errore della cassa (o *no reason provided*). L'indirizzo email del locale riceve anche un'email *Comtrex Issue* con la stessa motivazione.

> **Item / PLU not found o numero di articolo non valido**
>
> Il **POS ID** di un prodotto o modificatore non esiste sulla cassa. Apri l'articolo nell'editor del menu, confronta **POS ID** con il numero di articolo nel catalogo della cassa (**Comtrex** → **Load catalogue**) e correggilo. Poi usa **Resend order to POS** sull'ordine.
>
> Ricorda che i modificatori hanno bisogno dei propri POS ID, e che un override del PLU sull'articolo ha la precedenza su **POS ID** se ne usi uno.

> **Table not found / tavolo non valido**
>
> Il **POS ID** del tavolo in **Stores** → il tuo locale → **Settings** → **Tables** non è un numero di tavolo che la cassa conosce. Correggilo e reinvia l'ordine. Vedi [Dine-in: tavoli](/docs/it/guides/integrations/pos/comtrex/dine-in).

> **Errori di media / pagamento / sales type**
>
> Uno tra **Tip ID**, **Discount ID**, **Payment Type ID** o **Sales Type Number** è sbagliato o vuoto. Clicca su **Reload** sotto i dettagli di connessione per recuperare la lista dei media attuale della cassa, riseleziona i media type e clicca su **Save**. Gli ordini con uno sconto hanno bisogno di **Discount ID**; ogni ordine ha bisogno di **Payment Type ID** per chiudersi.

> **Network / timeout — *Unknown Comtrex error (network/timeout)***
>
> storekit non è riuscito a ottenere una risposta dal server Comtrex. Riprova la richiesta diverse volte nell'arco di qualche minuto prima di arrendersi. Verifica che il server sia acceso e che l'indirizzo/porta lo inoltri ancora, poi **Resend order to POS**.

> **L'ordine è fallito, ma Resend order to POS non appare**
>
> **Resend order to POS** appare solo quando l'ordine non ha un numero di check dalla cassa. Se l'ordine ne ha già uno, Comtrex l'ha accettato — verifica il check sulla cassa prima di fare qualsiasi altra cosa.

> **Articoli mancanti dal check**
>
> I prodotti o modificatori senza **POS ID** (e senza PLU) vengono saltati silenziosamente — il resto dell'ordine passa e il cliente viene addebitato per tutto. Guarda l'ordine in storekit, trova l'articolo senza POS ID, aggiungilo e batti l'articolo mancante sul check a mano.

> [!TIP]
>
> Reinviare è sicuro solo se l'ordine non è già sulla cassa. Cerca un check con il numero d'ordine storekit prima di reinviare, altrimenti creerai un duplicato.

## Problemi di Price sync

> **Articoli elencati sotto *Not found on the till***
>
> Il **POS ID** dell'articolo non corrisponde a nessun numero di articolo nel catalogo della cassa. storekit lascia il suo prezzo invariato. Correggi il **POS ID** sul prodotto o modificatore ed esegui di nuovo **Preview price sync**.

> **Articoli elencati sotto *Conflicting till prices***
>
> La cassa riporta più di un prezzo per quel numero di articolo (di solito appare in più liste con prezzi diversi). storekit applica il primo prezzo che trova. Se non è quello che vuoi, imposta il prezzo in storekit a mano dopo aver applicato.

> **L'anteprima mostra 0 to update ma i prezzi sono sbagliati sulla cassa**
>
> Price sync importa i prezzi solo *dalla* cassa *a* storekit. Non invia mai i prezzi storekit a Comtrex — cambia il prezzo sulla cassa, poi esegui la sync.

> **Load catalogue fallisce — *Failed to load the Comtrex catalogue***
>
> Il server Comtrex non ha risposto alla richiesta di item sync. È la stessa connessione di **Load from till**, quindi verifica l'indirizzo, la porta e il vendor ID, e che la cassa sia online. Clicca su **Refresh** per riprovare.

## Problemi di Pay at Table

> **L'ospite non vede alcun conto aperto per il tavolo**
>
> storekit ha chiesto alla cassa i check aperti sul **POS ID** del tavolo e non ne ha ricevuti. Il check non è stato ancora aperto sulla cassa, è su un numero di tavolo diverso, o il **POS ID** del tavolo in storekit è sbagliato. Verifica il numero di tavolo sulla cassa contro **Stores** → il tuo locale → **Settings** → **Tables**.

> **L'ospite ha pagato ma il check è ancora aperto sulla cassa**
>
> Apri **Tables** nel menu di sinistra, trova il conto e clicca su **View payments**. Se il pagamento è **Failed**, storekit non è riuscito a inviarlo alla cassa dopo ripetuti tentativi e ha annullato (rimborsato) il pagamento con carta dell'ospite — prendi di nuovo il pagamento sulla cassa o in storekit. Se il pagamento appare come riuscito ma non è sul check, contatta il supporto con il riferimento del conto in modo che possa essere reinviato alla cassa.

> **Il conto non è aggiornato**
>
> storekit rilegge il check ogni volta che l'ospite fa refresh. Chiedi all'ospite di aggiornare; se gli articoli aggiunti dallo staff continuano a non apparire, conferma che siano stati aggiunti allo stesso check (stesso numero di tavolo) e non a uno nuovo.

> **Le mance non appaiono sul check**
>
> Mappa **Tip ID** nelle impostazioni di connessione e clicca su **Save**. Senza di esso, la mancia viene addebitata all'ospite ma non inviata alla cassa.

## Ancora bloccato?

Contatta il supporto storekit con il nome del locale, il numero d'ordine o il riferimento del conto e il testo esatto dell'errore mostrato sulla pagina dell'ordine o nell'email *Comtrex Issue*. Zonal può confermare numeri di articolo, numeri di tavolo e ID dei media dal lato cassa.


## Related topics

- [Risoluzione dei problemi Deliverect](/docs/it/guides/integrations/pos/deliverect/troubleshooting.md)
- [Risoluzione dei problemi Syrve](/docs/it/guides/integrations/pos/syrve/troubleshooting.md)
- [Risoluzione dei problemi Toast](/docs/it/guides/integrations/pos/toast/troubleshooting.md)
- [Risoluzione dei problemi Stream](/docs/it/guides/integrations/pos/stream/troubleshooting.md)
- [Risoluzione dei problemi Lightspeed](/docs/it/guides/integrations/pos/lightspeed/troubleshooting.md)


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