Usługa fiskalizacji RetailForce to middleware oparty na platformie .NET przeznaczony do fiskalizacji dla Niemiec i 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 (HTTPS) na serwerze localhost.

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 https://hub.docker.com/u/RetailForce, a także
• nuget-packages – prosimy pobrać je 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 podfolderze „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 umożliwiający proste księgowanie i podpisywanie w języku C#.

Aby skorzystać z przykładowej aplikacji, proszę użyć następującego identyfikatora klienta:

{c1062c55-57c4-4ed2-9c53-aff1762326a4}

Mogą Państwo bez problemu użyć tego identyfikatora klienta do pierwszych testów. W celu przeprowadzenia dalszych testów, w tym z integracją z Cloud, należy utworzyć własnego klienta testowego w RetailForce Cloud.

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 metodę programowania sterowanego 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 z pakietem nuget)

Zarządzanie klientami fiskalnymi

Z naszego doświadczenia wynika, że zarządzanie klientami podatkowymi 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
• Interfejs API do zarządzania chmurą RetailForce Cloud, 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 internetowej

• 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 na stronie http://docs.RetailForce Cloud.

Charakterystyka kraju (fiscalCountryProperties)

Ten artykuł został przetłumaczony automatycznie.