Informazioni generali sulla configurazione

Il presente articolo contiene informazioni generali su come creare un oggetto di configurazione per RetailForce Fiscal Middleware nel cloud. Le configurazioni vengono scaricate e applicate dai client fiscali durante l’inizializzazione, tramite ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Per ulteriori informazioni, si rimanda all’articolo sull’inizializzazione.

Nel RetailForce portal, la configurazione può essere ereditata verso il basso all’interno della struttura organizzativa. Ciò significa che una configurazione può essere utilizzata contemporaneamente per più terminali e non è necessario crearla per ciascun terminale. È inoltre possibile sovrascrivere alcune configurazioni nell’oggetto ereditato.

Esempio:

Nell’esempio seguente, l’oggetto di configurazione A è assegnato all’organizzazione «XYZ Holding GmbH». La configurazione viene ereditata da tutte le unità subordinate nella struttura organizzativa. Al registratore di cassa «099» (terminal) viene assegnato l’oggetto di configurazione B, che sovrascrive quindi l’oggetto di configurazione A ereditato.

L’oggetto di configurazione rimane sempre indipendente dall’oggetto dei dati anagrafici, come l’organizzazione, ecc.

È possibile trasferire un oggetto di configurazione a qualsiasi livello di ereditarietà. Un oggetto di configurazione può essere trasferito a ogni livello (organizzazione, azienda, punti vendita e terminali).

Importante: non è possibile condividere un oggetto di configurazione tra organizzazioni diverse. È necessario creare un oggetto di configurazione separato per ciascuna organizzazione. Eccezione: Organizzazione principale

Struttura di ereditarietà dei dati nel Cloud:

Organizzazione
- Società - facoltativo
  - Punto vendita
    - Terminal

Esempio:

La vostra organizzazione è composta da 13 punti vendita in Germania e sta ora pianificando l’apertura di una nuova filiale in Austria. L’hardware del sistema POS utilizzato è lo stesso sia in Germania che in Austria.

Le servirà:

Un'organizzazione con sede in Germania (fiscalCountry = Germania)
una società aggiuntiva facoltativa con sede in Austria (fiscalCountry = Austria)
13 negozi/filiali collegati all’organizzazione
1 filiale collegata all’organizzazione E alla società in Austria

È necessario definire 2 oggetti di configurazione:

un oggetto di configurazione contenente tutte le impostazioni necessarie per la Germania
- è possibile definire l’intera configurazione hardware nell’oggetto di configurazione per la Germania
un oggetto di configurazione contenente tutte le configurazioni necessarie per l’Austria
- non è necessario definire la configurazione hardware nell’oggetto di configurazione per l’Austria
- sovrascrivere il campo FiscalCountry e la configurazione specifica per paese nell’oggetto di configurazione relativo all’Austria

Assegnazione delle configurazioni

L’assegnazione di un oggetto di configurazione avviene nel RetailForce Portal, tramite i dettagli delle rispettive entità (oggetti organizzativi: Organizzazione, Società, Negozio, Terminal).

A tal fine, selezionare la configurazione pertinente nell’area Configurazione tramite il menu a tendina e fare clic su «Salva».

Nota: se nell’elenco di selezione non viene visualizzato alcun oggetto di configurazione, significa che non è stata ancora creata alcuna configurazione oppure che la configurazione creata non corrisponde al Paese fiscale impostato per l’entità. Le configurazioni possono essere assegnate solo se il Paese fiscale dell’entità (ad es. la società) corrisponde a quello della configurazione.

La voce di menu «Nuova configurazione» può essere utilizzata per specificare che una nuova configurazione sia valida a partire da una determinata data («Nuova valida a partire da»).

Aggiornamento della configurazione

Attenzione: se un oggetto di configurazione viene modificato nel Cloud, tale modifica NON viene distribuita automaticamente ai client interessati (mandati middleware)!

Le configurazioni dei singoli client devono essere trasmesse tramite:

PUT /api/v1/management/clients/byCloud/{clientId}

devono essere aggiornate.

Gestione degli errori

Errore: Licenza

Se riceve il seguente errore durante la chiamata all’endpoint GetConfiguration, il sistema restituisce:

[error] (exception): License 'GetConfiguration' for client '<ClientID>' not found.

Manca l’opzione di licenza che consente al client di recuperare i dati di configurazione dal cloud. Verifichi nel RetailForce Cloud Portal se la licenza assegnata contenga l’opzione “Accesso al download della configurazione”.

Assegnazione delle configurazioni

Aggiornamento della configurazione

Gestione degli errori

Errore: Licenza

Articoli correlati

Commenti