W niniejszym artykule dowiedzą się Państwo, jakie kroki należy podjąć po ponownym nawiązaniu połączenia z usługą FiskalService.
Te same kroki należy wykonać w przypadku integracji z platformą .NET.;
Wymagania wstępne
- Usługa fiskalna jest zainstalowana, a adres URL jest znany / integracja biblioteki .NET została dotychczas zakończona
- Mają Państwo dostęp do RetailForce Cloud za pomocą ApiKey i sekretu API (cloud ApiKey/apiSecret)
- Korzystają Państwo z konfiguracji pobranej z Cloud
- Znają Państwo numer UID / numer podatkowy organizacji obsługującej system POS
- Znają Państwo numer sklepu i numer terminala
Sposób postępowania
Aby przechowywać jak najmniej danych w systemie kasowym, mogą Państwo postępować w następujący sposób. Mogą Państwo przechowywać te dane w systemie kasowym, jednak będą Państwo musieli je wielokrotnie aktualizować.
Należy sprawdzić, czy konfiguracja klienta w ogóle już istnieje
Po wykonaniu tego kroku otrzymają Państwo identyfikator uniqueClientId modułu fiskalnego dla żądanego terminala kasowego. (Identyfikator uniqueClientId odpowiada identyfikatorowi terminalId w RetailForce Cloud).
Usługa fiskalna
Aby ustalić, czy konfiguracja klienta już istnieje w usłudze FiskalService, należy uruchomić dwie metody:
- GET management/clients/LicenseConsumerId
- GET management/clients/ID
Szczegółowe informacje na temat funkcji można znaleźć w dokumentacji swagger dotyczącej klienta Fiscalservice.
Integracja z platformą .NET
Dzięki integracji z platformą .NET można skorzystać z klasy `FiscalModuleManagement` oraz metody `GetClients()`, aby uzyskać listę wszystkich klientów dostępnych w konfiguracji.
Client nie istnieje jeszcze w konfiguracji
Jeśli klient już istnieje w konfiguracji i otrzymał Pan/Pani identyfikator uniqueClientId, może Pan/Pani pominąć ten krok.
Pobierz konfigurację terminala z Cloud; instrukcje znajdują się w artykule:
Łączenie się z Cloud
Usługa fiskalna
Moduł fiskalny nie przechowuje danych dostępowych do Cloud (ApiKey/apiSecret). W związku z tym dane te należy przekazywać do serwisu lub modułu fiskalnego przy każdym nawiązaniu nowego połączenia.
Dane można przekazać za pomocą następującej metody:
Uwaga: Jeśli dane te nie zostaną podane, zwracany jest błąd HTTP o kodzie HttpStatusCode 424 – FailedDependency. Jeśli następnie wywoła się metodę management/Cloud/connect i ponownie spróbuje się wysłać nieprawidłowe żądanie, powinno to zadziałać.
Integracja z platformą .NET
W przypadku integracji z platformą .NET dane uwierzytelniające do Cloud należy przekazać podczas tworzenia modułu fiskalnego (jako parametr metody CreateFiscalModuleForClient).
Zaleca się zainicjowanie i załadowanie modułu fiskalnego na początku działania oprogramowania POS podczas integracji z platformą .NET, ponieważ w niektórych krajach konieczne jest wykonanie czynności inicjalizacyjnych, które trwają nieco dłużej.
Sprawdź, czy obiekt FiskalClient został już zainicjowany
Aby ustalić, czy obiekt FiskalClient został już zainicjowany, można sprawdzić jego status za pomocą następującego zapytania:
- GET /api/v1/information/client/{clientId}/status
- Integracja z platformą .NET: właściwość FiscalClientStatus w module fiskalnym
Właściwość „State” może przyjmować następujące wartości:
- NotInitialized
- Initialized
- Wycofany z eksploatacji
Inicjalizacja klienta fiskalnego
Jeśli klient fiskalny (FiskalClient) został już zainicjowany, można pominąć ten krok.
Opis sposobu inicjalizacji można znaleźć w poniższym artykule:
Zakończenie
Po wykonaniu powyższych kroków aplikacja FiskalClient jest gotowa do odbioru początkowych dowodów.
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.