RetailForce разработва софтуер, който отговаря на нормативните изисквания относно фискализацията на електронните системи за записване в различни държави. Този софтуер се нарича „Fiscal Middleware“.
Настоящият документ предоставя обща информация за това как да се интегрира „Fiscal Middleware“ на RetailForce. Архитектурата на системата, която изпраща и получава данни от „Fiscal Middleware“, както и специфичните изисквания и функции на тази система, могат да наложат отклонение от настоящото описание.
1. Основни принципи
По-долу са изброени отделните стъпки, които трябва да бъдат изпълнени, преди да започнете интеграцията. Тези стъпки се обсъждат подробно и по време на сесията за въвеждане.
1.1 Общ преглед на вариантите за интеграция
Преди да започнете с интеграцията, запознайте се с различните налични варианти за интеграция. Тези варианти са описани в следната статия: Общ преглед на фискализацията с RetailForce – RetailForce Software GmbH (=статия с общ преглед).
Източниците, от които можете да изтеглите RetailForce Middleware в различните варианти, също могат да бъдат намерени в статията, към която има линк.
След като изтеглите Fiscal Middleware, изпълнете инсталацията. Описание на начина на инсталиране на различните варианти можете да намерите в статията с обзор.
1.1.1 Онлайн срещу офлайн
RetailForce Middleware по принцип е самостоятелна софтуерна система. Въпреки това, различни функции са достъпни само когато middleware-ът е свързан с RetailForce Cloud.
RetailForce Cloud предоставя различни функции за управление, като например автоматична дистанционна конфигурация на middleware-то, включително разпределяне на лицензи, както и функции за сигурно дългосрочно архивиране.
За да се използват функциите на RetailForce Cloud, фискалният middleware или конкретният клиент в рамките на инсталацията (клиент = отделен екземпляр на системата за електронно записване) трябва да бъде свързан с терминал в RetailForce Cloud.
Ако middleware-ът ще се използва без установяване на връзка с Cloud (офлайн система), следните стъпки могат да бъдат пропуснати. Продължете с точка 1.5.
1.2 Достъп до RetailForce portal
Всички функции на RetailForce Cloud се предоставят чрез
- RetailForce Cloud Portal (https://portal.retailforce.cloud), както и чрез
- Cloud API (https://api.retailforce.cloud/swagger)
Самостоятелната регистрация в RetailForce portal не е възможна по съображения за сигурност. За да получите достъп до портала, трябва да получите линк с покана от вече оторизиран потребител. Последващият процес на регистрация е описан в следната статия: Регистрация в RetailForce portal – RetailForce Software GmbH.
1.3 Организационна структура
Първо трябва да се създаде организационна структура в портала. Статията „Създаване на организационна структура в RetailForce Cloud – RetailForce Software GmbH“ предоставя обзор на функциите, които се предлагат за тази цел.
1.4 Конфигурация
След като са създадени организационната структура, поне една организация (=клиент), един магазин (=филиал) и един terminal (=каса), трябва да се подготви обект за конфигурация в облака и да се присвои на даден субект (организация, фирма, магазин или терминал). Описание на този процес можете да намерите в: Обща информация за конфигурацията – RetailForce Software GmbH.
1.5 Инициализация
Ако предходните стъпки са изпълнени успешно, Fiscal Middleware може да бъде пуснат в експлоатация. Стъпките, необходими за пускането в експлоатация (с и без установяване на връзка с облака), са обяснени по-подробно в статията „Инициализация (общо)“ – RetailForce Software GmbH.
В резултат на процеса на пускане в експлоатация/инициализация фискалният клиент трябва
- да бъде напълно конфигуриран,
- или чрез конфигурационен обект, подготвен в Cloud, или
- „ръчно“ от системата за електронно записване,
- и да разполага с уникален ID на клиент.
2. Интеграция
След като пускането в експлоатация на client („касов апарат“) е приключило успешно, може да се започне интеграцията.
В този раздел се дават указания относно процеса на прехвърляне на документи между касовия апарат (системата за електронно записване) и конкретния клиент.
2.1 REST уеб услуга
Следващата статия ви помага да започнете с интеграцията на REST уеб услугата, която се използва както за
- услугата за Windows, както и
- Docker контейнера.
Първи стъпки с фискалната услуга – RetailForce Software GmbH
2.2 Имплементация чрез NuGet
Помощ за имплементирането на middleware-то чрез nuget (DLL) е предоставена в следната статия: Първи стъпки при имплементирането чрез nuget – RetailForce Software GmbH.
2.3 Интерфейс към файловата система
В допълнение към двата споменати по-горе варианта за имплементиране – REST уеб услуга и nuget – middleware-ът може да бъде достъпен и чрез файлов интерфейс. Можете да намерите повече информация за това в статията: Интерфейс към файловата система – RetailForce Software GmbH.
2.4 Процес на предаване на документи
След като фискалното middleware, под формата на Windows услуга, е инсталирано на компютър, достъпът до описанието на api се осъществява чрез http://localhost:7678/swagger/index.html.
В случай на инсталиране на отдалечен компютър (например в LAN), използвайте IP адреса на системата, на която е инсталиран middleware-ът, вместо „localhost“.
Всички крайни точки на middleware-то са описани в swagger. Важни за предаването на документи (например касови бележки) са крайните точки от раздела „Транзакции“.
Предаването на документи винаги е двуетапен процес, който започва с
- „createDocument“ и завършва или с
- „storeDocument“, или с „cancelDocument“ – в случай на анулиране на документа.
Процесът на предаване на документи е обяснен подробно тук: Основен процес на предаване на документи – RetailForce Software GmbH.
2.5 Fiscal Service Client Sample
RetailForce предоставя примерна програма – „Fiscal Service Client Sample“. Тя дава указания за това как да се създаде JSON структурата, чрез която документите се изпращат към данъчната служба.
Fiscal Service Client Sample може да се използва за генериране на примери за различни типове документи и бизнес случаи.
Описание на програмата можете да намерите на: Fiscal Service Client Sample – RetailForce Software GmbH.
Можете също да намерите примери за различни документи и бизнес случаи в Центъра за решения на адрес: Бизнес транзакции – RetailForce Software GmbH.
2.6 Списък с крайни точки
По-долу са описани крайните точки, които трябва да бъдат имплементирани във всеки случай.
| Крайна точка | Описание |
| PUT /api/va/management/clients | необходимо само ако конфигурацията на клиента трябва да се извърши от POS софтуера, а не от облачната система. Алтернатива: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | необходимо, ако конфигурацията на клиента трябва да се извърши от облачната система. Алтернатива: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | установява облачната връзка на клиент. Трябва да се извършва след всяко рестартиране на компютъра (системата). Данните, необходими за установяване на облачната връзка (API ключ и API Secret), трябва да се съхраняват от електронната система за регистриране. |
| POST /api/v1/management/clients/initialize | Инициализира клиента или необходимия фискален хардуер (техническо устройство за сигурност, модул за създаване на подписи, принтер и др.). За инициализацията е необходим стартов документ. Той може да бъде генериран или от електронната система за регистриране, или автоматично чрез middleware чрез крайната точка GET /api/v1/transactions/document/{clientId}/start. |
| GET /api/v1/transactions/document/{clientId}/start | Препоръчително. Създава т.нар. стартов документ за конкретния клиент с цел инициализация. |
| PUT /api/v1/transactions/createDocument | Този метод не създава сам по себеси документ, а просто стартира процеса, например на TSE (техническо устройство за сигурност) в Германия. (Задължително във всяка страна!) |
| POST /api/v1/transactions/storeDocument | Запазва съответния документ |
| POST /api/v1/transactions/cancelDocument | Анулира документ във фискалната единица. |
Тази статия е преведена автоматично.
Коментари
0 коментара
Влезте в услугата, за да оставите коментар.