Ogólne informacje dotyczące konfiguracji – RetailForce

Niniejszy artykuł zawiera ogólne informacje dotyczące tworzenia obiektu konfiguracyjnego dla oprogramowania pośredniczącego RetailForce Fiscal Middleware w chmurze. Konfiguracje są pobierane i stosowane przez klientów fiskalnych podczas inicjalizacji za pośrednictwem ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Więcej informacji można znaleźć w artykule poświęconym inicjalizacji.

W RetailForce portalu konfiguracja może być dziedziczona w dół struktury organizacyjnej. Oznacza to, że jedna konfiguracja może być stosowana jednocześnie dla wielu terminali i nie ma konieczności tworzenia jej osobno dla każdego terminala. Możliwe jest również nadpisanie niektórych elementów konfiguracji w obiekcie dziedziczonym.

Przykład:

W poniższym przykładzie obiekt konfiguracyjny A jest przypisany do organizacji „XYZ Holding GmbH”. Konfiguracja ta jest dziedziczona przez wszystkie jednostki podległe w strukturze organizacyjnej. Kasa fiskalna „099” (terminal) ma przypisany obiekt konfiguracyjny B, co powoduje nadpisanie odziedziczonego obiektu konfiguracyjnego A.

Obiekt konfiguracyjny jest zawsze niezależny od obiektu danych podstawowych, takiego jak organizacja itp.

Obiekt konfiguracyjny można przenieść na dowolny poziom dziedziczenia. Obiekt konfiguracyjny można przenieść na każdym poziomie (organizacja, firma, sklepy i terminale).

Ważne: Nie ma możliwości współdzielenia obiektu konfiguracyjnego między różnymi organizacjami. Dla każdej organizacji należy utworzyć oddzielny obiekt konfiguracyjny. Wyjątek: Organizacja nadrzędna

Struktura dziedziczenia danych w Cloud:

Organizacja
- Firma – opcjonalnie
  - Sklep
    - Terminal

Przykład:

Państwa organizacja składa się z 13 sklepów w Niemczech i planuje obecnie otwarcie nowego oddziału w Austrii. Sprzęt systemu POS jest taki sam zarówno w Niemczech, jak i w Austrii.

Będą Państwo potrzebować:

Organizacji z siedzibą w Niemczech (fiscalCountry = Niemcy)
Dodatkowa, opcjonalna spółka z siedzibą w Austrii (fiscalCountry = Austria)
13 sklepów/oddziałów powiązanych z organizacją
1 oddział powiązany zarówno z organizacją, jak i ze spółką w Austrii

Należy zdefiniować 2 obiekty konfiguracyjne:

obiekt konfiguracyjny zawierający wszystkie konfiguracje wymagane dla Niemiec
- w obiekcie konfiguracyjnym dla Niemiec można zdefiniować całą konfigurację sprzętową
obiekt konfiguracyjny zawierający wszystkie konfiguracje niezbędne dla Austrii
- nie ma konieczności definiowania konfiguracji sprzętowej w obiekcie konfiguracyjnym dla Austrii
- należy nadpisać pole „fiscalCountry” oraz konfigurację specyficzną dla danego kraju w konfiguracji dla Austrii

Przypisywanie konfiguracji

Przypisanie obiektu konfiguracyjnego odbywa się w RetailForce portalu, poprzez szczegóły odpowiednich podmiotów (obiekty organizacyjne: Organizacja, Firma, Sklep, Terminal).

W tym celu należy wybrać odpowiednią konfigurację w obszarze „Konfiguracja” za pomocą menu rozwijanego, a następnie kliknąć „Zapisz”.

Uwaga: Jeśli w liście wyboru nie wyświetla się żaden obiekt konfiguracyjny, oznacza to, że albo nie utworzono jeszcze żadnej konfiguracji, albo utworzona konfiguracja nie odpowiada ustawionemu krajowi podatkowemu danego podmiotu. Konfiguracje można przypisywać wyłącznie wtedy, gdy kraj podatkowy podmiotu (np. spółki) jest zgodny z krajem podatkowym konfiguracji.

Za pomocą pozycji menu „Nowa konfiguracja” można określić, że nowa konfiguracja obowiązuje od określonej daty („Nowa konfiguracja obowiązuje od”).

Aktualizacja konfiguracji

Uwaga: Jeśli obiekt konfiguracyjny zostanie zmieniony w Cloud, zmiana ta NIE zostanie automatycznie przekazana do odpowiednich klientów (mandaty middleware’u)!

Konfiguracje poszczególnych klientów należy przesłać za pomocą:

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

należy zaktualizować.

Obsługa błędów

Błąd: Licencja

Jeśli podczas wywołania punktu końcowego GetConfiguration otrzyma Pan następujący komunikat o błędzie:

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

Brakuje opcji licencji umożliwiającej klientowi pobieranie danych konfiguracyjnych z chmury. Proszę sprawdzić w RetailForce Cloud Portal, czy przypisana licencja zawiera opcję „Dostęp do pobierania konfiguracji”.