Requisiti minimi

Requisiti minimi necessari per il corretto funzionamento di Comarch POS e Comarch POS Agent (su dispositivi separati):

  • Sistema operativo Microsoft Windows 8.1/10
  • Processore Intel Core i3/i5/i7 4th Gen, AMD Ryzen 5 o di una classe simile (Risultato CPU benchmark almeno 3000 pt. per garantire una reazione accettabile)
  • 6 GB memoria RAM
  • Microsoft .NET Framework 4.7.2
  • Microsoft SQL Server 2014 in versione Express o superiore
  • Collation Latin1_General_CI_A

Per le installazioni dove Comarch POS e Comarch POS Agent si trovano sullo stesso dispositivo, bisogna garantire (rispetto ai suddetti requisiti)

  • Processore migliore, almeno Intel Core i5
  • 8 GB memoria RAM o di più

Nota
Bisogna includere:

  • requisiti minimi del sistema Microsoft Windows
  • requisiti minimi del sistema Microsoft SQL Server

a seconda di quanto la postazione sia caricata da altri programmi e del numero di operazioni eseguite

Durante l’installazione dell’applicazione Comarch POS, Comarch ERP Auto Update viene verificata la versione del componente Microsoft.NET Framework. In caso di mancanza o di una versione inferiore del componente, questo verrà installato nella versione richiesta.




Installazione

Lo scaricamento e l’installazione dei Comarch POS vengono effettuati tramite l’applicazione Comarch ERP Auto Update

La descrizione dell’applicazione e delle sue funzionalità sono disponibili nella categoria Comarch ERP Auto Update.




Comarch POS Agent

Informazioni di base

Il servizio Comarch POS Agent (POS Agent) fornisce informazioni aggiornate sugli stati delle scorte a ogni postazione POS durante il rilascio dei documenti. Le informazioni vengono presentate tenendo conto di ciascun magazzino. Uno dei vantaggi dell’utilizzo di questo servizio e la garanzia di un’autonomia completa di un negozio, grazie alla possibilità di eseguire i processi di magazzino con la centrale in modalità offline.

Il servizio POS Agent mantiene tutte le informazioni che dovrebbero essere disponibili per ciascuna postazione POS

  • documenti parcheggiati
  • statistiche dei contapersone
  • stati delle scorte insieme alle prenotazioni

Modalità di funzionamento

Il servizio POS Agent funziona come un servizio indipendente con il proprio database, sullo stesso computer su cui si trova il database Comarch Retail o su un altro computer.

Prima di approvare i documenti, il sistema POS Agent controlla la correttezza delle scorte di magazzino nei documenti:

  • commerciali
    • Scontrini (S) e le loro correzioni di quantità e manuali
    • Fatture di vendita (FV) e le loro correzioni di quantità e manuali
    • Ordini di vendita (ORV)
  • di magazzino:
    • Movimenti tra magazzini (MMI-/MMI+)
    • Ricezioni e rilasci interni (RI/RLI) e le loro correzioni di quantità
    • Entrate e uscite esterne (EM/UM) e le loro correzioni di quantità

Installazione e configurazione

L’installazione di POS Agent viene effettuata tramite Comarch ERP Auto Update.

Nota
È richiesta la versione più recente Comarch ERP Auto Update 2020.

Dopo l’avvio di Comarch ERP Auto Update bisogna effettuare le seguenti attività

1. Nella scheda Configuration aggiungere il prodotto Comarch Retail

2. Per il prodotto Comarch Retail POS aggiungere il componente Comarch Retail POS Agent.

Finestra di configurazione Auto Update con POS Agent

3. Configurare il componente Comarch Retail POS Agent. La finestra di configurazione viene aperta dopo la selezione del componente e del pulsante [Configuration]. Nella finestra bisogna inserire i dati necessari per stabilire la connessione al server Microsoft SQL Server Management Studio su cui verrà installa to il database POS Agent.

Configurazione della connessione al server SQL per POS Agent

  • Server Name – nome del server insieme all’istanza su cui verrà installato il database
  • Database Name – il nome BOSDB_[codice_profilo] viene suggerito per impostazione predefinita
  • Login Data – Login, Password

Il pulsante [Test Connection] consente di controllare la connessione al server indicato.

  1. 4. Poi, bisogna salvare le modifiche e chiudere la finestra di configurazione, utilizzando rispettivamente i pulsanti [Save] e [Close].

Configurazione

  • Nel sistema ERP bisogna configurare la postazione POS Agent. L’istruzione dettagliata è disponibile nella documentazione del sistema ERP, negli articoli riguardanti l’aggiunta e la configurazione della postazione POS.
  • Nel passo successivo bisogna aprire la directory di installazione POS Agent e avviare l’applicazione POSAgentConfigurator.exe.
  • Compare un messaggio che informa che il servizio è disinstallato:

Errore riguardante il servizio disinstallato

 

  • Dopo la selezione del pulsante [OK] comincia il caricamento dei parametri:

Vista di caricamento dei parametri nello strumento di configurazione POS Agent

  • Dopo il caricamento dei parametri viene aperta la finestra dello strumento di configurazione:

Strumento di configurazione POS Agent

  • Nell’applicazione bisogna completare:
    • L’indirizzo IP del computer su cui il servizio POS Agent è verrà installato
    • Porta del servizio POS Agent: 8098 per impostazione predefinita
    • Indirizzo del server OMS: 8099 per impostazione predefinita 8099
    • Codice POS Agent: codice di POS Agent inserito nel sistema ERP. Dopo la corretta registrazione il campo diventa grigio.
    • GUID: valore assegnato automaticamente
  • Il servizio viene installato con l’utilizzo del pulsante [Installa]

Vista di avvio nello strumento di configurazione POS Agent

  • Il pulsante [Registra] serve a registrare il servizio POS Agent. La correttezza dei dati inseriti prima può essere controllata tramite il pulsante [Controlla], invece il pulsante [Registra] serve per registrare il servizio POS Agent.
  • Per controllare se il processo è stato completato in modo corretto bisogna aprire la scheda POS Agent in Comarch ERP Standard e verificare che le inserzioni nei campi Host, Porta GUID siano state aggiornate.

Nell’applicazione POS, dopo l’installazione del servizio, appare l’icona che fornisce informazioni sullo stato di connessione ai servizi:

Verde: tutti i servizi sono attivati

Giallo: uno dei servizi è disattivato

Rosso: tutti i servizi sono disattivati

Nota
Ciascuna postazione POS e mPOS nel negozio dovrebbe stabilire la connessione soltanto a POS Agent perché sia possibile confermare un documento di magazzino. Comunque, soltanto la connessione alla centrale garantisce che tale documento contenga la corretta quantità disponibile e verrà elaborato in modo adeguato.

Inoltre, l’icona consente di accedere al pulsante [Impostazioni dei servizi] che apre la finestra di configurazione dei servizi dell’applicazione Comarch Retail POS che è disponibile anche nel menu principale, sotto la piastrella Configurazione. [/alert]

Finestra di configurazione dei servizi per l’applicazione Comarch Retail POS

Registrazione del servizio POS Agent tramite lo strumento di riga di comando

Esiste la possibilità di registrare Comarch POS Asgent tramite lo strumento di riga di comando del sistema Windows. Comandi disponibili:

  • –register
  • –install
  • –uninstall
  • –setaddress –agentIP:127.0.0.1 –port:8098 (impostazione dell’indirizzo IP e della porta per il servizio POS Agent)
  • –seterpaddress –indirizzo:http://example.com (impostazione dell’indirizzo del server OMS)
  • –stop
  • –start
  • –help
  • –status
  • –waitforstatus

Per registrare il servizio Comarch POS Agent tramite la riga di comando bisogna:

  1. Aprire la riga di comando come amministratore dalla localizzazione:

C:\Users\nome.utente\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\System Tools

Finestra: Prompt dei comandi

  1. Trovare e copiare il percorso in cui si trova lo strumento di configurazione del servizio POS Agent (cartella Comarch POS Agent), esempio di percorso:

C:\2022_5\Comarch Retail\Comarch Retail POS Agent

  1. Nella riga di comando inserire: cd C:\2022_5\Comarch Retail\Comarch Retail POS Agent e premere il tasto [Enter]

Riga di comando per cd C:\2022_5\Comarch Retail\Comarch Retail POS Agent

4. Installare lo strumento di configurazione POS Agent, inserendo: POSAgentConfigurator.exe –install e premere il tasto [Enter]

Informazione nella riga di comando sulla corretta installazione del servizio Comarch POS Agent

5. Dopo l’installazione corretta bisogna avviare il servizio, inserendo: POSAgentConfigurator.exe –start e premere il tasto [Enter]

Informazione nella riga di comando sull’avvio corretto del servizio Comarch POS Agent

6. Per registrare il servizio bisogna inserire: POSAgentConfigurator.exe –register e premere il tasto [Enter]

7.Per verificare lo stato della connessione del servizio bisogna inserire: POSAgentConfigurator.exe –status e premere il tasto [Enter]

Dopo la verifica dello stato vengono visualizzate le informazioni riguardanti:

  • lo stato del servizio
  • l’indirizzo del servizio Comarch POS Agent
  • l’indirizzo del servizio OMS
  • il codice del POS Agent
  • il GUID del POS Agent registrato

Necessità delle porte

Lo schema che si trova sotto presenta la comunicazione tra i componenti secondo le porte predefinite. Lo schema include anche la direzione della connessione tra i componenti.




Comarch POS Agent Broker

Informazioni di base

Nota
Il componente POS Agent Broker è necessario per stabilire la comunicazione tra il sistema ERP e Comarch POS Agent.

 

Il componente Comarch POS Agent Broker (POS Agent Broker) viene utilizzato per la comunicazione con il servizio Comarch POS Agent. Questo componente aggrega la coda dei messaggi e trasferisce l’aggiornamento degli stati delle scorte a POS Agent appropriato in un dato negozio.

L’aggiornamento è necessario perché durante l’emissione dei documenti nel sistema ERP bisogna:

  • controllare gli stati delle scorte attuali alla postazione POS prima di generare un documento che scarica le informazioni sugli stati delle scorte dal magazzino assegnato a una data postazione POS
  • inserire nella coda un messaggio riguardante, per esempio, l’incremento degli stati delle scorte, dopo l’emissione di un documento che causa tale incremento

Installazione e configurazione di POS Agent Broker

 Prima di cominciare l’installazione del componente POS Agent Broker bisogna attivare le funzioni aggiuntive del sistema Windows; Internet Information Services (IIS). Per farlo bisogna aprire Pannello di controllo → Programmi e funzionalità → Attiva o disattiva funzionalità di Windows → Internet Information Services (IIS) e selezionare per l’installazione Strumenti di gestione WEB e Servizi WEB. La procedura è necessaria per eseguire l’installazione corretta del componente.

Funzionalità Windows

L’installazione di POS Agent Broker viene eseguita tramite Comarch Auto Update dove bisogna selezionare il prodotto Comarch Retail e, in seguito, scegliere il componente Comarch POS Agent Broker.

Finestra di configurazione Auto Update con POS Agent Broker aggiunto

In questo modello viene utilizzato il broker dei messaggi Apache Kafka che consente di gestire un elevato numero di messaggi.

La configurazione in collaborazione con Comarch ERP Standard è stata descritta nelle Novità e modifiche in Comarch ERP Standard 20201.0.




Installazione e configurazione del componente BI Point

L’installazione tramite Comarch ERP Auto Update del componente appropriato consente di utilizzare l’applicazione BI Point alla postazione POS.

Dopo l’avvio dell’applicazione Comarch ERP Auto Update bisogne effettuare i seguenti passi:

  1. Selezionare il prodotto Comarch Retail nella scheda Configuration
  2. Aggiungere il componente Comarch Retail BI Point al prodotto Comarch Retail.

Aggiunta del componente Comarch POS BI Point

  1. Salvare le modifiche e chiudere la finestra di configurazione dei prodotti premendo rispettivamente i pulsanti [Save] e [Close].
  2. Nella finestra principale dell’applicazione bisogna selezionare una delle opzioni disponibili:
  • [Download] – il prodotto verrà salvato nella cartella indicata durante la configurazione. Percorso predefinito: C:\Comarch ERP Auto Update\Downloads. Dopo lo scaricamento sarà disponibile il pulsante [Installa].
  • [Download and Install] – il prodotto viene automaticamente installato dopo lo scaricamento.

Aggiunta del componente Comarch POS BI Point

L’indirizzo predefinito presentato alla postazione POS per BI Point è: http://bipoint.comarch.pl. L’indirizzo può essere cambiato nella tabella della postazione POS Configuration Settings nella riga BIPointURL.

L’installazione dei prodotti è stata descritta in modo dettagliato nella sezione Comarch ERP Auto Update.