Преглед корака потребних за подешавање клијента:

1. Креирање организационе структуре
2. Конфигурација
3. Успостављање везе са облаком
4. Иницијализација клијента

1. Креирање организационе структуре

Као први корак ка пуштању у рад, организациона структура компаније која користи касу мора прво да се креира у RetailForce облаку. Детаљније информације о томе можете пронаћи у повезаном чланку.

Овај корак се може прескочити за системе који треба да раде потпуно офлајн и који ни у ком тренутку не успостављају везу са RetailForce облаком.

2. Конфигурација

Конфигурација Фискалног мидлвејр клијента у основи се може обавити на два различита начина (у зависности од подешавања и споразума које је донео произвођач софтвера за касу и компанија која управља касом):

1. Конфигурација преко RetailForce Cloud, или алтернативно
2. Конфигурација преко POS софтвера (систем касе, електронски систем евиденције)

1. Конфигурација преко RetailForce Cloud

У овој варијанти, клијент локално преузима објекат конфигурације припремљен у RetailForce облаку. Ово се може сматрати аутоматском конфигурацијом. Креирање објеката конфигурације описано је у повезаном чланку.

Приликом конфигурисања фискалне јединице преко облака, сви подаци које систем захтева су већ конфигурисани у облаку (упутства и опште информације о креирању конфигурације). Ови подаци се учитавају из облака позивом са фискалног клијента (CreateClientByCloud).

Параметри за позив су:

• Идентификација компаније (CompanyIdentification), обично број пореског идентификационог броја (VatNumber). У зависности од пореске земље, може бити потребно алтернативно или додатно унети друге идентификационе карактеристике (!). Међутим, препоручује се коришћење ПИБ-а за покретање.
• Број продавнице / филијале
• Број касе
• cloudApiKey
• cloudApiSecret

Ако се функција PUT api/v1/management/clients/byCloud заврши без грешке, конфигурација фискалног клијента је завршена. Гвид фискалног модула (=clientId) се шаље као повратна вредност.

2. Конфигурација преко POS софтвера

Као алтернатива аутоматској конфигурацији клијента преко система RetailForce Cloud, објекат конфигурације може бити припремљен и помоћу POS софтвера. Ова врста конфигурације се користи за системе који немају везу са RetailForce Cloud. За то се користи ендпоинт PUT /api/v1/management/clients.

Приликом конфигурисања софтвера касе, постоје два начина за исправно покретање модула:

1. Модул без везе са облаком са локалним складиштењем и извозом података
2. Модул са везом у облаку са локалним и облачним складиштењем и извозом података

У сваком случају, неопходно је да се потребни параметри конфигурације подесе исправно у складу са документацијом.

Верзија 2 (са везом у облаку) може се такође активирати касније, тј. могуће је креирати фискалну конфигурацију без везе у облаку, а затим је синхронизовати са облаком.

Треба напоменути да креирање клијента у облаку мора бити омогућено од стране произвођача ПОС софтвера и/или организације у подешавањима облака. Стандардни начин је да се прво креира објекат конфигурације у облаку.

3. Успостављање везе са облаком

Следећи корак је повезивање клијента са RetailForce облаком (за офлајн системе, без везе са облаком, овај корак се може прескочити). Ово се ради преко функције:

• POST /api/v1/management/cloud/connect .

Параметри за позив:

• clientId - јединствени ID клијента (Guid) враћен је каси када је конфигурисана преко RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Иницијализација клијента

Позивањем функције InitializeClient (POST /api/v1/management/clients/initialize), са параметром (почетни документ), позива се рутина за иницијализацију одговарајуће земље, а све безбедносне компоненте се такође иницирају у овом процесу (ако је потребно).
За питања специфична за земљу и/или хардвер, погледајте одговарајућу документацију.

Почетни документ може бити затражен од сервиса извршавањем функције:

• GET /api/v1/transactions/document/{clientId}/start
  (параметар: clientId, опционално: bookDate).

Ако се FiscalClient користи без фискализације (NoFiscalisation), на пример ако се клијенту преносе само дигитални потврдни документи или архивски подаци, иницијализација није неопходна.

• Позив функције за иницијализацију (InitializeClient - POST /api/v1/management/clients/initialize)

Иницијализација фискалне јединице се затим врши позивом функције InitializeClient.

Функцији InitializeClient се прослеђује NullReceipt, пример се налази у наставку:

{
    "modelVersion": "1.5.2",
    "uniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
    "additionalFields": {},
    "documentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
    "documentId": "1",
    "createDate": "2025-05-02T07:08:17.8334419+02:00",
    "bookDate": "2025-05-02T07:08:17.8335535+02:00",
    "documentNumber": "1",
    "documentType": 1000,
    "documentTypeCaption": "Startbeleg",
    "user": {
        "id": "1",
        "caption": "User 1",
        "firstName": "1",
        "lastName": "User",
        "dateOfEntry": "2025-05-02T07:08:17.833596+02:00"
    },
    "allocationGroups": [],
    "positionCount": 0,
    "fiscalDocumentNumber": 1,            
    "fiscalDocumentRevision": 1,          
    "positions": [],
    "Payments": [],
    "additionalHeader": [],
    "additionalFooter": [],
    "fiscalAdditionalFields": {}
}

Процес иницијализације је у основи специфичан за поједину земљу, али позив остаје исти за све земље. За детаље о земљи-специфичним иницијализацијама, погледајте документацију за одговарајућу земљу.

Комисионирање на први поглед

Следеће функције се позивају у овом редоследу за подешавање клијента:

Повезани чланци

Иницијализација Немачка

Обрада грешака

Грешка: GetConfiguration за клијента <ClientId> није пронађено

Овај чланак је аутоматски преведен.