Przejdź do głównej zawartości

POST /api/v1/management/cloud/ connect

Harald Krondorfer
  • Zaktualizowano

Ten punkt końcowy łączy konkretnego klienta (dzierżawcę) z RetailForce Cloud i buforuje moduł fiskalny. Funkcję CloudConnect należy wywołać przed przesłaniem transakcji do serwisu fiskalnego.

Uwaga: w przypadku systemów z włączoną archiwizacją w chmurze („systemy online”) usługa fiskalna przyjmie transakcje wyłącznie wtedy, gdy wcześniej wykonano żądanie POST /api/v1/management/cloud/connect.

Funkcję tę należy wykonać co najmniej po ponownym uruchomieniu kasy fiskalnej lub po ponownym uruchomieniu systemu, na którym zainstalowano oprogramowanie pośredniczące middleware Fiscal. Zalecamy jednak regularne korzystanie z tego punktu końcowego w celu zapewnienia stałego połączenia z systemem w Cloud.

Wynik

Pomyślne wywołanie punktu końcowego (200)

  • nawiązuje połączenie między Fiscal Client a RetailForce Cloud oraz
  • ładuje moduł fiskalny do pamięci podręcznej.

Zastosowanie

  • podczas uruchamiania, po wykonaniu polecenia PUT /api/v1/management/clients/byCloud lub PUT /api/v1/management/clients;
  • regularnie, co najmniej po każdym ponownym uruchomieniu systemu hosta.

Na przykład żądanie POST /api/v1/management/cloud/connect można wykonać przed każdą transmisją transakcji.

Wymagania wstępne

Pola formularza

Należy podać następujące informacje:

Nazwa Opis Przykład
clientId

Unikalny identyfikator klienta (uniqueClientId) kasy fiskalnej (z RetailForce systemu).

 c1062c55-57c4-4ed2-9c53-aff1762326a4
cloudApiKey

Klucz API służący do uwierzytelniania komunikacji w chmurze

 RFC_4a2abc...
cloudApiSecret

API Secret służący do uwierzytelniania komunikacji z chmurą

Uwaga: API Secret należy zawsze umieścić w pojedynczych cudzysłowach, np. 'ypmqt7s5UVZOyY9mDFzOeVgdpRnJ8GrOsQ'
 ypts7u5OU...

Odpowiedź

Możliwe odpowiedzi:

Kod Opis Przykład
200

Połączenie z Cloud zostało pomyślnie nawiązane

 -
403

Dane dostępowe (poświadczenia = cloudApiKey i API Secret) są nieprawidłowe.

Rozwiązywanie problemów:

  • Proszę sprawdzić dane uwierzytelniające: cloudApiKey i cloudApiSecret
 -
422

Nie znaleziono podanego identyfikatora klienta (clientId) w systemie lokalnym lub nie podano danych dostępowych.

Rozwiązywanie problemów:

  • Proszę sprawdzić wprowadzone wartości clientId, cloudApiKey oraz cloudApiSecret
 -
424

Jeśli chcą Państwo korzystać z archiwum w chmurze, przed użyciem zaufanego modułu podatkowego należy wywołać funkcję „cloud connect”.

Rozwiązywanie problemów:

  • Należy regularnie wywoływać metodę POST /api/v1/management/Cloud/connect, zwłaszcza po każdym ponownym uruchomieniu systemu hosta.
 -

 

Ten artykuł został przetłumaczony automatycznie.

Powiązane artykuły

Komentarze

Komentarze: 0

Zaloguj się, aby dodać komentarz.

Oparte na technologii Zendesk