Společnost RetailForce vyvíjí software, který splňuje předpisy týkající se fiskalizace elektronických záznamových systémů v různých zemích. Tento software se nazývá „Fiscal Middleware“.

Tento dokument poskytuje přehled o tom, jak integrovat Fiscal Middleware od společnosti RetailForce. Architektura nadřazeného systému, který odesílá data do Fiscal Middleware a přijímá data z něj, jakož i speciální požadavky a funkce tohoto systému, mohou vyžadovat odchylky od tohoto popisu.

1. Základy

Níže jsou uvedeny jednotlivé kroky, které je třeba provést před zahájením integrace. Tyto kroky jsou podrobně probrány také během úvodní školení.

1.1 Přehled variant integrace

Než začnete s integrací, seznamte se s různými dostupnými variantami integrace. Tyto varianty jsou popsány v následujícím článku: Přehled fiskalizace s RetailForce – RetailForce Software GmbH (= přehledový článek).

V odkazovaném článku také najdete zdroje, ze kterých si můžete stáhnout fiskální middleware RetailForce v různých variantách.

Po stažení Fiscal Middleware proveďte instalaci. Popis instalace jednotlivých variant najdete v přehledovém článku.

1.1.1 Online vs. offline

RetailForce Fiscal Middleware je v zásadě samostatný softwarový systém. Některé funkce jsou však k dispozici pouze v případě, že je middleware připojen k RetailForce Cloud.

RetailForce Cloud poskytuje různé funkce pro správu, jako je automatická vzdálená konfigurace middlewaru včetně přidělování licencí, a také funkce pro bezpečnou dlouhodobou archivaci.

Aby bylo možné využívat funkce RetailForce Cloud, musí být Fiscal Middleware nebo konkrétní klient v rámci instalace (klient = jednotlivá instance elektronického záznamového systému) připojen k terminálu v RetailForce Cloud.

Pokud má být middleware provozován bez navázání Cloudového připojení (offline systém), lze následující kroky přeskočit. Pokračujte bodem 1.5.

1.2 Přístup k portálu RetailForce

Všechny funkce RetailForce Cloud jsou k dispozici prostřednictvím

• portálu RetailForce Cloud (https://portal.retailforce.cloud) a také prostřednictvím
• Cloud-API (https://api.retailforce.cloud/swagger)

Z bezpečnostních důvodů není možná samostatná registrace v portálu RetailForce. Abyste získali přístup k portálu, musíte obdržet pozvánku od již autorizovaného uživatele. Následný proces registrace je popsán v následujícím článku: Registrace v portálu RetailForce – RetailForce Software GmbH.

1.3 Organizační struktura

V portálu je nejprve nutné vytvořit organizační strukturu. Článek Vytvoření organizační struktury v RetailForce Cloud – RetailForce Software GmbH poskytuje přehled funkcí, které jsou k tomuto účelu k dispozici.

1.4 Konfigurace

Po vytvoření organizační struktury, alespoň jedné organizace (= zákazník), jedné prodejny (= pobočka) a jednoho terminálu (= pokladna) je nutné v Cloudu připravit konfigurační objekt a přiřadit jej k entitě (organizace, společnost, prodejna nebo terminál). Popis tohoto procesu najdete v článku: Obecné informace o konfiguraci – RetailForce Software GmbH.

1.5 Inicializace

Pokud byly předchozí kroky úspěšně provedeny, lze Fiscal Middleware uvést do provozu. Kroky potřebné k uvedení do provozu (s navázáním Cloud připojení i bez něj) jsou podrobněji vysvětleny v článku Inicializace (obecně) – RetailForce Software GmbH.

V důsledku procesu uvedení do provozu/inicializace by měl být fiskální klient

• plně nakonfigurován,
  • a to buď prostřednictvím konfiguračního objektu připraveného v Cloudu, nebo
  • „ručně“ prostřednictvím systému elektronické evidence,
• a měl by mít jedinečné ID klienta.

2. Integrace

Po úspěšném dokončení uvedení klienta („pokladny“) do provozu lze zahájit integraci.

Tato část obsahuje pokyny k procesu přenosu dokumentů mezi pokladnou (systémem elektronického záznamu) a konkrétním klientem.

2.1 Webová služba REST

Následující článek vám pomůže začít s integrací rozhraní webové služby REST, které se používá pro

• službu Windows, stejně jako
• kontejneru Docker.

První kroky s fiskální službou – RetailForce Software GmbH

2.2 Implementace v NuGet

Nápovědu k implementaci middlewaru prostřednictvím NuGet (DLL) najdete v následujícím článku: První kroky při implementaci přes NuGet – RetailForce Software GmbH.

2.3 Rozhraní souborového systému

Kromě dvou výše zmíněných variant implementace, webové služby REST a NuGet, lze middleware oslovit také prostřednictvím rozhraní souborového systému. Více informací o tom najdete v článku: Rozhraní souborového systému – RetailForce Software GmbH.

2.4 Proces přenosu dokumentů

Poté, co byl na počítači nainstalován Fiscal Middleware, který funguje v podstatě jako služba Windows. Popis API je k dispozici na adrese http://localhost:7678/swagger/index.html.

V případě instalace na vzdáleném počítači (např. v síti LAN) použijte místo „localhost“ IP adresu systému, na kterém byl middleware nainstalován.

Všechny koncové body middlewaru jsou popsány v dokumentaci Swagger. Pro přenos dokumentů (např. pokladních dokladů) jsou důležité koncové body v sekci „Transactions“.

Přenos dokumentů je vždy dvoufázový proces, který se spouští příkazem

1. „createDocument“ a končí buď příkazem
2. „storeDocument“, nebo v případě zrušení dokumentu voláním „cancelDocument“.

Proces přenosu dokumentů je podrobně vysvětlen zde: Základní proces přenosu dokumentů – RetailForce Software GmbH.

2.5 Ukázka klienta Fiscal Service

Společnost RetailForce poskytuje ukázkový program s názvem „Fiscal Service Client Sample“. Ten slouží jako návod k vytvoření struktury JSON, ve které se dokumenty odesílají do služby Fiscal Service.

Fiscal Service Client Sample lze použít k generování příkladů různých typů dokumentů a obchodních případů.

Popis programu najdete na: Vzorový program Fiscal Service Client – RetailForce Software GmbH.

Příklady různých dokumentů a obchodních případů najdete také v Solution Center na adrese: Obchodní transakce – RetailForce Software GmbH.

2.6 Seznam koncových bodů

Následně jsou popsány koncové body, které by měly být v každém případě implementovány.

Tento článek byl přeložen automaticky.