Usługa fiskalizacji RetailForce to middleware oparty na platformie .NET przeznaczony do fiskalizacji dla Niemiec oraz wszystkich innych krajów.
Instalacja
Kopię usługi fiskalnej dla systemu Windows można pobrać, korzystając z poniższego linku:
http://www.retailforce.cloud/downloads
Prosimy o pobranie najnowszej wersji oprogramowania.
Instalator można łatwo zainstalować; nie są potrzebne żadne dodatkowe informacje.
Po zakończeniu instalacji usługa działa jako usługa internetowa REST (JSON) na porcie nr 7678 (HTTP). Usługa nasłuchuje na wszystkich interfejsach sieciowych komputera, a nie tylko na localhost. W celu zapewnienia szyfrowanej komunikacji (HTTPS na porcie 7677) prosimy zapoznać się z sekcją „Aktywacja protokołu HTTPS w celu zapewnienia bezpieczniejszej komunikacji api”.
Alternatywy
Jako alternatywę dla instalacji usługi REST, oprogramowanie RetailForce Fiskal middleware jest również dostępne w postaci:
- kontener Docker — do pobrania na platformie Docker Hub pod adresem https://hub.docker.com/u/RetailForce, a także
- nuget-packages – prosimy pobrać pakiety pod adresem: https://www.nuget.org/profiles/RetailForceDevelopment
Informacje na temat tych wariantów instalacji / integracji można znaleźć w następujących artykułach:
- Kontener Docker: Linux – TrustedFiscalService jako kontener Docker
- nuget-packages: Pierwsze kroki we wdrażaniu nuget
Przykładowa aplikacja
W powyższym katalogu pobierania, w podkatalogu „Samples”, znajduje się również przykładowa aplikacja (Fiscal Service Client Sample). W tej przykładowej aplikacji zawarty jest cały kod źródłowy służący do prostego księgowania i podpisywania w języku C#.
Aby skorzystać z przykładowej aplikacji, proszę użyć następującego identyfikatora klienta:
{c1062c55-57c4-4ed2-9c53-aff1762326a4}
Może Pan/Pani bez problemu użyć tego identyfikatora klienta do pierwszych testów. W celu przeprowadzenia dalszych testów, w tym testów z integracją z Cloud, należy utworzyć własnego klienta testowego w Cloud RetailForce.
W przypadku problemów związanych z brakującymi plikami DLL prosimy o sprawdzenie folderu „bin/debug” projektu w aplikacji przykładowej.
Walidacja dokumentów
Aby ułatwić Państwu integrację oprogramowania, przygotowaliśmy funkcję służącą do walidacji modelu obiektowego dokumentu, który będą Państwo przesyłać do modułu fiskalizacji.
Po wywołaniu metody ValidateDocument na utworzonym module TrustedFiscalModule lub w usłudze internetowej fiskalizacji (w zależności od sposobu integracji) otrzymają Państwo natychmiast wszystkie błędy (i ostrzeżenia) dotyczące dokumentu. Dzięki temu znacznie łatwiej jest dostosować procedurę wywołania w celu zakończenia procesu integracji.
Dodatkowe informacje
Integrację middleware można przeprowadzić w następujący sposób
- Integracja za pośrednictwem usługi internetowej (Windows, REST)
- Integracja za pośrednictwem usługi internetowej (z wykorzystaniem biblioteki Fiskalclient w środowisku .NET Standard, nuget)
- Integracja za pośrednictwem usługi internetowej (z wykorzystaniem biblioteki Fiskalclient w środowisku .NET Framework 2.0, nuget)
- Integracja za pośrednictwem usługi internetowej (jako biblioteka COM-DLL/ActiveX, dostępna na żądanie)
- Integracja w postaci pakietu AAR na urządzeniach z systemem Android (dla języka Java) (dostępność zależy od planów firmy Microsoft)
Kilka dodatkowych informacji dotyczących aspektów technicznych
- Cały proces tworzenia oprogramowania odbywa się w oparciu o programowanie sterowane testami
- Wszystkie testy są uruchamiane podczas procesu kompilacji przy tworzeniu nowej wersji
- Wdrażanie rozwiązania za pośrednictwem pakietów nuget-packages lub poprzez pobranie instalatora dla systemu Windows.
Systemy operacyjne
Oprogramowanie RetailForce Middleware zostało dotychczas przetestowane na następujących systemach operacyjnych:
- Windows 7
- Windows 10
- Android (od wersji 8) (w ramach integracji z pakietem nuget)
- Linux (dla usługi)
Prosimy również zapoznać się z dokumentacją systemu bezpieczeństwa, aby sprawdzić, czy wybrany system bezpieczeństwa (TSE, HSM itp.) w danym kraju obsługuje Państwa system operacyjny.
Obecnie nie zostało to przetestowane ani nie jest obsługiwane, ale powinno działać:
- iOS (w ramach integracji pakietu nuget)
Zarządzanie klientami fiskalnymi
Z naszego doświadczenia wynika, że zarządzanie klientami fiskalnymi może czasami być czasochłonne i kłopotliwe.
W związku z tym stworzyliśmy następujące dodatkowe usługi:
- Automatyczna konfiguracja klienta za pośrednictwem RetailForce Cloud, eliminująca konieczność konserwacji zainstalowanego klienta fiskalnego
- RetailForce Cloud API do zarządzania chmurą RetailForce, umożliwiający zarządzanie dodatkowymi firmami, sklepami i terminalami oraz wszystkimi innymi danymi podstawowymi, których Państwo potrzebują.
Dodatkowa dokumentacja / dokumentacja usług
Dodatkową dokumentację znajdą Państwo tutaj:
Pełny opis usługi dla serwisu internetowego
- http://localhost:7678/swagger (po zainstalowaniu serwisu internetowego)
Pełna dokumentacja (model obiektowy) usługi fiskalnej
Dokumentacja w folderze „download” w podfolderze plików instalacyjnych (link w rozdziale „Instalacja”)
Dokumentacja ta będzie wkrótce dostępna pod adresem http://docs.retailforce.cloud.
Charakterystyka krajów (fiscalCountryProperties)
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.