Skip to main content

Requisiti Rete e Infrastruttura

Panoramica​

Una corretta configurazione di rete e fondamentale per il funzionamento affidabile della piattaforma POS. Questa guida elenca i requisiti di connettivita, le porte necessarie, le regole firewall e le raccomandazioni per la rete locale del punto vendita.

Porte e Protocolli​

Le seguenti porte devono essere accessibili in uscita dal punto vendita verso il cloud:

PortaProtocolloDestinazioneUso
443HTTPS/TLSAPI serverChiamate REST, sync, autenticazione
4222TCPNATS brokerComunicazione real-time cloud
8883TCP/TLSMQTT brokerNotifiche push (opzionale)

Porte sulla rete locale (LAN):

PortaProtocolloUso
8090WebSocketMaster LAN (comunicazione tra dispositivi)
9100TCPStampanti di rete (porta RAW standard)
631TCPStampanti IPP/CUPS (se utilizzato)
5353UDP multicastmDNS discovery del master LAN

Requisiti Bandwidth​

La larghezza di banda necessaria dipende dal numero di dispositivi e dal volume operativo:

ScenarioBandwidth minimaRaccomandata
1 cassa, nessun cameriere2 Mbps5 Mbps
1 cassa + 3 tablet cameriere5 Mbps10 Mbps
Multi-cassa + KDS + kiosk10 Mbps20 Mbps

La sincronizzazione iniziale (primo avvio) trasferisce l'intero catalogo e le configurazioni: per un ristorante con 500 prodotti, sono circa 10-20 MB. Le sincronizzazioni successive trasferiscono solo i delta (pochi KB per operazione).

Configurazione Firewall​

Regole in Uscita (Obbligatorie)​

Consentire il traffico in uscita verso:

  • *.pos-enterprise.com porta 443 (API e autenticazione)
  • Indirizzo IP del broker NATS, porta 4222
  • *.auth.pos-enterprise.com porta 443 (Keycloak SSO)

Regole LAN (Obbligatorie)​

Consentire il traffico tra i dispositivi POS sulla rete locale:

  • Porta 9100 TCP verso le stampanti di rete
  • Porta 8090 TCP verso il dispositivo master (se modalita LAN attiva)
  • Porta 5353 UDP multicast per il discovery mDNS

Regole in Ingresso​

Non sono richieste regole in ingresso dalla rete pubblica. Tutto il traffico e iniziato dal client verso il server.

Rete WiFi per Tablet​

I tablet camerieri e i kiosk richiedono una rete WiFi dedicata o con QoS configurato:

  • SSID dedicato: creare una rete separata per i dispositivi POS, non condivisa con i clienti
  • Banda 5 GHz: preferire la banda a 5 GHz per minori interferenze e maggiore throughput
  • Copertura: verificare la copertura in tutte le aree del locale, inclusa la cucina
  • DHCP: configurare reservation IP per i dispositivi POS (facilita la diagnostica)
  • Isolamento client: se il router lo supporta, isolare i dispositivi POS dai dispositivi ospiti

Modalita LAN-Only​

Per punti vendita senza connessione internet stabile, la piattaforma supporta la modalita LAN-only:

  • Un dispositivo (tipicamente la cassa principale) funge da master LAN
  • Gli altri dispositivi si connettono al master via WebSocket sulla rete locale
  • Tutte le operazioni (ordini, stampa, comunicazione cucina) funzionano senza internet
  • La sincronizzazione con il cloud avviene quando la connessione e disponibile

VPN (Opzionale)​

Per il supporto remoto e la manutenzione, e consigliabile predisporre un accesso VPN:

  • Consente ai tecnici di accedere ai dispositivi sulla rete locale per diagnostica
  • Protocolli supportati: WireGuard, OpenVPN, IPsec
  • Non necessario per il funzionamento ordinario della piattaforma

FAQ​

D: La piattaforma funziona con una connessione 4G/5G? R: Si, la piattaforma funziona su qualsiasi connessione internet. Un router 4G/5G con SIM dati e una soluzione valida come connessione primaria o di backup. Verificare che le porte NATS (4222) non siano bloccate dall'operatore.

D: Devo aprire porte in ingresso sul firewall del punto vendita? R: No, tutta la comunicazione e in uscita. Non sono necessarie regole NAT o port forwarding.

D: Come verifico che le porte siano raggiungibili? R: Utilizzare il test di connettivita integrato nell'app cassa: Impostazioni > Diagnostica > Test Rete. Il test verifica la raggiungibilita di API, NATS e servizi di autenticazione.

Vedi Anche​

Questa pagina ti è stata utile?