Услугата за фискализация RetailForce е фискализационен middleware, базиран на .NET, за Германия и всички други държави.

Инсталиране

Можете да изтеглите копие на фискалната услуга за Windows от следния линк:

http://www.retailforce.cloud/downloads

Моля, изтеглете най-новата версия на софтуера.

Инсталацията е лесна и не се изисква допълнителна информация.

След инсталирането услугата е достъпна като REST-уеб услуга (JSON) на порт 7678 (HTTPS) на localhost.

Алтернативи

Като алтернатива на инсталирането на REST уеб услугата, RetailForce Fiskal middleware е достъпен и като:

• Docker-контейнер – като файл за изтегляне от Docker Hub https://hub.docker.com/u/RetailForce, както и
• nuget-packages – изтеглете пакетите от: https://www.nuget.org/profiles/RetailForceDevelopment

Информация за тези варианти на инсталиране/интеграция можете да намерите в следните статии:

• Docker-контейнер: Linux – TrustedFiscalService като Docker-контейнер
• nuget-packages: Първи стъпки при внедряването на nuget

Примерно приложение

В посочената по-горе директория за изтегляне, в подпапката Samples (Fiscal Service Client Sample), ще намерите и примерно приложение. В това примерно приложение е включен целият изходен код за просто записване и подписване в C#.

За да използвате приложението за пример, можете да използвате следния client GUID:

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

Можете да използвате този client GUID за първите си тестове без проблем. За по-нататъшни тестове, включително и с интеграция в облака, трябва да създадете свой собствен тестов клиент с RetailForce Cloud.

Ако срещнете проблеми с липсващи DLL файлове, моля, проверете папката „bin/debug“ на проекта в приложението за пример.

Валидиране на документи

За да ви помогнем при интегрирането на софтуера ви, досега сме разработили функция за валидиране на обектния модел на документа, който ще изпратите към модула за фискализация.

Когато извикате метода ValidateDocument върху създаден TrustedFiscalModule или към уеб услугата за фискализация (в зависимост от вашата интеграция), ще получите всички грешки (и предупреждения) за документа наведнъж. По този начин е много по-лесно да адаптирате процедурата за извикване, за да завършите процеса на интеграция.

Допълнителна информация

Интеграцията на middleware може да се осъществи по следните начини

• Интеграция чрез уеб услуга (Windows, REST)
• Интеграция чрез уеб услуга (с Fiskalclient в .NET Standard, nuget)
• Интеграция чрез уеб услуга (с Fiskalclient в .NET Framework 2.0, nuget)
• Интеграция чрез уеб услуга (като COM-DLL/Active X, налична при поискване)
• Интеграция като AAR пакет на устройство с Android (за Java) (наличността зависи от плановете на Microsoft)

Допълнителна информация за техническите аспекти

• Цялото разработване се извършва като разработка, ръководена от тестове
• Всички тестове се изпълняват по време на процеса на компилиране при създаването на нова версия
• Разгръщане на решението чрез nuget-packages или чрез изтегляне на инсталационния файл за Windows.

Операционни системи

RetailForce Fiscal Middleware е тестван досега на следните операционни системи:

• Windows 7
• Windows 10
• Android (от версия 8) (като интеграция на nuget пакет)
• Linux (за услугата)

Моля, вижте също документацията на системата за сигурност, за да проверите дали избраната система за сигурност (TSE, HSM и др.) в съответната страна поддържа вашата операционна система.

Към момента не е тествано и не се поддържа, но би трябвало да работи:

• iOS (като интеграция на nuget пакет)

Управление на фискални клиенти

От нашия опит управлението на фискални клиенти понякога може да отнема много време и да бъде досадно.

Ето защо създадохме следните допълнителни услуги:

• Автоматична конфигурация на клиента чрез RetailForce Cloud, без необходимост от поддръжка на инсталирания фискален клиент
• RetailForce Cloud API за управление на допълнителни фирми, магазини и терминали, както и на всички други основни данни, от които ще имате нужда.

Допълнителна документация / документация за услугата

Тук ще намерите допълнителна документация:

Пълно описание на уеб услугата

• http://localhost:7678/swagger (след инсталиране на уеб услугата)

Пълна документация (модел на обектите) на фискалната услуга

Документация в папката „download“ на инсталационните файлове (връзка към раздела „Инсталиране“)

Тази документация скоро ще бъде достъпна на http://docs.RetailForce Cloud.

Характеристики на държавите (fiscalCountryProperties)

Тази статия е преведена автоматично.