RetailForce развија софтвер за усаглашавање са прописима о фискализацији електронског система евиденције у различитим земљама. Овај софтвер се зове "Fiscal Middleware".
Овај документ пружа преглед како да интегришете RetailForce фискални мидлвејр. Архитектура система извора који шаље и прима податке од фискалног мидлвејра, као и посебни захтеви и функције тог система, могу учинити неопходним одступање од овог описа.
1. Основе
У наставку су наведени појединачни кораци које је потребно извршити пре покретања интеграције. Ови кораци се такође детаљно разматрају током онбординг сесије.
1.1 Преглед варијанти интеграције
Пре него што започнете са интеграцијом, упознајте се са различитим варијантама интеграције које су доступне. Ове варијанте су описане у следећем чланку: Преглед фискализације са RetailForce – RetailForce Software GmbH (=чланак са прегледом).
Извори са којих можете преузети RetailForce Fiscal Middleware у различитим варијантама такође се налазе у повезаном чланку.
Након што преузмете Фискални мидлвејр, извршите инсталацију. Опис како инсталирати различите варијанте можете пронаћи у прегледном чланку.
1.1.1 Онлајн у односу на офлајн
RetailForce порески мидлвејр је у основи самосталан софтверски систем. Међутим, разне функције су доступне само када је мидлвејр повезан са RetailForce облаком.
RetailForce Cloud пружа разне функције управљања, као што су аутоматска даљинска конфигурација мидлвера, укључујући доделу лиценци, као и функције сигурног дугорочног архивирања.
Да бисте користили функције RetailForce Cloud-а, Fiscal Middleware или одређени клијент у оквиру инсталације (клијент = појединачни пример електронског система за евиденцију) мора бити повезан са терминалом у RetailForce Cloud-у.
Ако се мидлвеар користи без успостављања везе са облаком (офлајн систем), следећи кораци могу бити прескочени. Наставите са тачком 1.5.
1.2 Приступ RetailForce порталу
Све функције RetailForce Cloud-а се обезбеђују преко
- RetailForce Cloud Portal (https://portal.retailforce.cloud) као и преко
- Cloud-API (https://api.retailforce.cloud/swagger)
Саморегистрација на RetailForce порталу није могућа из безбедносних разлога. Да бисте добили приступ порталу, морате да добијете позивни линк од већ овлашћеног корисника. Накнадни процес регистрације описан је у следећем чланку: Registration in the RetailForce portal – RetailForce Software GmbH.
1.3 Организациона структура
Прво мора да се креира организациона структура у порталу. Чланак "Креирање организационе структуре у RetailForce Cloud – RetailForce Software GmbH" пружа преглед функција које су обезбеђене у ту сврху.
1.4 Конфигурација
Након што су креирани организациона структура, најмање једна организација (=купац), једна продавница (=филијала) и један терминал (=каса), мора да се припреми објекат конфигурације у облаку и додели ентитету (организација, компанија, продавница или терминал). Опис овог процеса можете пронаћи под: Опште информације о конфигурацији – RetailForce Software GmbH.
1.5 Иницијализација
Ако су претходни кораци успешно обављени, фискални мидлвејр може бити пуштен у рад. Кораци потребни за пуштање у рад (са и без успостављања везе са облаком) детаљније су објашњени у чланку Initialization (general) – RetailForce Software GmbH.
Као резултат процеса пуштања у рад/иницијализације, Фискални клијент треба да
- био у потпуности конфигурисан,
- или преко објекта конфигурације припремљеног у облаку, или
- "ручно" од стране система за електронско пословање,
- и имати јединствени ID клијента.
2. Интеграција
Након успешног пуштања у рад клијента ("благајне"), интеграција може да се покрене.
Овај одељак пружа смернице за процес преноса докумената између касе (система електронског евидентирања) и одређеног клијента.
2.1 REST веб сервис
Следећи чланак помаже у покретању интеграције интерфејса REST веб сервиса, који се користи за
- Windows сервис као и
- Docker контејнер.
Први кораци са фискалном службом – RetailForce Software GmbH
2.2 нугет имплементација
Упутство за nuget (DLL-) имплементацију middleware-а налази се у следећем чланку: Први кораци у nuget имплементацији – RetailForce Software GmbH.
2.3 Интерфејс датотечног система
Поред две горе поменуте варијанте имплементације, REST веб сервиса и nuget-а, middleware-у се може приступити и преко интерфејса датотека. Више информација о томе можете пронаћи у чланку: Интерфејс датотечног система – RetailForce Software GmbH.
2.4 Процес преноса докумената
Након што је Фискални мидлвејр, у виду Windows сервиса, инсталиран на рачунару. Опис API-ја је доступан на http://localhost:7678/swagger/index.html.
У случају инсталације на удаљеном рачунару (нпр. преко LAN мреже), користите IP адресу система на којем је инсталиран мидлвејр уместо "localhost".
Сви крајњи пунктови мидлвера описани су у swagger-у. Важни за пренос докумената (нпр. готовинских ваучера) су крајњи пунктови одељка "Трансакције".
Пренос докумената је увек дводневни процес, који се покреће са
- "createDocument" и завршава се једним од
- "storeDocument" или са "cancelDocument", у случају поништења документа.
Процес преноса докумената је детаљно објашњен овде: Basic document transfer process – RetailForce Software GmbH.
2.5 Узорка клијента пореске службе
RetailForce обезбеђује пример програма, Fiscal Service Client Sample. Овај пример пружа упутства о томе како креирати JSON структуру у којој се документи шаљу Фискалној служби.
Пример клијента Фискалне службе може се користити за генерисање примера различитих типова докумената и пословних случајева.
Опис програма можете пронаћи на: Fiscal Service Client Sample – RetailForce Software GmbH.
Такође можете пронаћи примере различитих докумената и пословних случајева у Центру решења на адреси: Пословне трансакције – RetailForce Software GmbH.
2.6 Листа крајњих тачака
Затим су описани ендпоинтови који се у сваком случају морају имплементирати.
| Крајња тачка | Опис |
| PUT /api/va/management/clients | потребно само ако се конфигурација клијента врши преко ПОС софтвера, а не преко облачног система. Алтернатива: 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 тајна) морају бити сачувани у систему електронског евидентирања. |
| POST /api/v1/management/clients/initialize | Иницијализује клијента или било који неопходни фискални хардвер (технички безбедносни уређај, јединица за креирање потписа, штампач итд.). За иницијализацију је потребан почетни документ. Он може бити генерисан или од стране система за електронско евидентирање или аутоматски преко мидлвера са крајњом тачком 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 | Отказује документ на јединици фискализације. |
Овај чланак је аутоматски преведен.
Komentari
Komentara: 0
Molimo prijavi se da biste komentarisali.