Общ преглед на стъпките, необходими за въвеждане в експлоатация на client:

1. Създаване на организационна структура
2. Конфигурация
3. Установяване на връзка с Cloud
4. Инициализиране на клиента

1. Създаване на организационна структура

Като първа стъпка към пускането в експлоатация, първо трябва да се създаде организационната структура на компанията, която управлява касовите апарати, в RetailForce Cloud. Подробности за това можете да намерите в статията, към която има линк.

Тази стъпка може да бъде пропусната за системи, които трябва да работят изцяло офлайн и по никакъв начин не установяват връзка с RetailForce Cloud.

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

Конфигурацията на клиент на middleware може да се извърши по два различни начина (в зависимост от настройките и споразуменията, сключени между производителя на софтуера за касови апарати и компанията, която ги експлоатира):

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

1. Конфигурация чрез RetailForce Cloud

При този вариант клиентът изтегля локално конфигурационен обект, подготвен в RetailForce Cloud. Това може да се разглежда като автоматична конфигурация. Създаването на конфигурационни обекти е описано в статията, към която има линк.

При конфигуриране на фискална единица чрез Cloud всички данни, изисквани от системата, вече са конфигурирани в Cloud (инструкции и обща информация за създаване на конфигурация). Тези данни се зареждат от Cloud чрез извикване от фискалния клиент (CreateClientByCloud).

Параметрите за заявката са:

• Идентификация на фирмата (companyIdentification), обикновено идентификационният номер по ДДС (VatNumber). В зависимост от държавата, в която се плащат данъци, може да се наложи да въведете други идентификационни характеристики като алтернатива или в допълнение (!). Въпреки това за начало се препоръчва използването на идентификационния номер по ДДС.
• Номер на магазина/филиала
• Номер на касовия апарат
• cloudApiKey
• cloudApiSecret

Ако функцията PUT api/v1/management/clients/byCloud се изпълни без грешка, конфигурацията на фискалния клиент е завършена. GUID-ът на фискалния модул (=clientId) се предава като връщана стойност.

2. Конфигурация чрез POS софтуер

Като алтернатива на автоматичната конфигурация на клиента чрез RetailForce Cloud system, конфигурационният обект може да бъде подготвен и от POS софтуера. Този тип конфигурация се използва за системи, които нямат връзка с RetailForce Cloud. За целта се използва крайната точка PUT /api/v1/management/clients.

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

1. Модул без връзка с Cloud с локално съхранение и експортиране на данни
2. Модул с връзка към Cloud с локално и Cloud съхранение на данни и експортиране

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

Вариант 2 (с връзка с Cloud) може да бъде активиран и по-късно, т.е. възможно е да се създаде фискална конфигурация без връзка с Cloud и след това да се синхронизира с Cloud.

Трябва да се отбележи, че създаването на client в облака трябва да бъде разрешено от производителя на POS софтуера и/или от организацията в настройките на облака. Стандартният начин е първо да се създаде конфигурационен обект в облака.

3. Установяване на връзка с Cloud

Следващата стъпка е свързването на клиента с RetailForce Cloud (за офлайн системи, без връзка с облака, тази стъпка може да бъде пропусната). Това се извършва чрез функцията:

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

Параметри за извикването:

• clientId – уникалният ID на клиента (Guid), който е бил върнат на касовия апарат при конфигурирането чрез RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

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

Чрез извикване на функцията InitializeClient (POST /api/v1/management/clients/initialize) с параметър (start document) се извиква процедурата за инициализация за съответната държава, като в този процес се инициализират и всички компоненти за сигурност (ако е необходимо).
За въпроси, свързани с конкретна държава и/или хардуер, моля, вижте съответната документация.

Началният документ може да бъде поискан от услугата чрез изпълнение на функцията:

• GET /api/v1/transactions/document/{clientId}/start
  (parameter: clientId, optional: 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> не е намерен

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