Прескачане към основното съдържание

POST /api/v1/management/clients/ initialize

Harald Krondorfer
  • Обновено

The

  • POST /api/v1/management/clients/initialize

се използва за

  • инициализиране на фискалното устройство (client),
  • всяка необходима фискална апаратура (устройство за създаване на подписи, техническо устройство за сигурност, контролно устройство, фискален принтер/кутия и др.) и
  • за регистриране на електронната система за записване (касов апарат) пред фискалните органи. (например процесът на регистрация в FinanzOnline – Австрия)

Резултат

При успешна обработка (200),

  • съответният фискален клиент и
  • всякакъв необходим фискален хардуер се пускат в експлоатация и се конфигурират, а 
  • (ако е необходимо / налично в съответната страна) касовият апарат се регистрира в данъчната служба.

Използване

  • Еднократно, като част от пускането в експлоатация на фискален клиент.

Предпоставки

  • Инсталиран е фискален middleware,
  • създаден и конфигуриран фискален client, чрез
  • CloudConnect е изпълнена успешно (само за системи, свързани с RetailForce Cloud).
  • Създаден е стартов документ; чрез GET /api/v1/transactions/document/{clientId}/start или от самата източна система.

Полета във формуляра

Към крайната точка трябва да бъде изпратен стартов документ.

Когато беше извикан GET /api/v1/transactions/document/{clientId}/start, като отговор към хост системата беше върнат стартов документ. Сега той може да бъде изпратен към крайната точка POST /api/v1/management/clients/initialize.

Алтернативно, необходимият стартов документ може да бъде създаден от самата система нагоре по веригата.

Отговори

Възможни отговори:

Код Описание Пример
200

Началният документ е предаден успешно и без грешки и е запазен в documentStore.

Освен това към системата нагоре по веригата се връща fiscalResponse. Този отговор трябва да бъде съхранен в дневника на системата нагоре по веригата за справка.

 fiscalResponse
204

Документът за стартиране беше предаден успешно и без грешки и е запазен в documentStore.

В някои държави при успешно пускане в експлоатация не се изпраща fiscalResponse.

 -
422

Стартиращият документ не отговаря на изискванията на съответната държава или в него липсва clientId.

Отстраняване на проблема: 

  • Изпълнете
    POST /api/v1/transactions/validateDocument или
    POST /api/v1/transactions/validateDocumentString
    за по-подробен анализ на грешката;
  • Използвайте GET /api/v1/transactions/document/{clientId}/start, за да създадете валиден стартов документ;
  • посочете съответния clientId.
 -
500

Грешка при валидирането на началния документ или clientId, предаден в началния документ, не е намерен в ConfigStore.

Отстраняване на проблема: 

  • Изпълнете
    POST /api/v1/transactions/validateDocument или
    POST /api/v1/transactions/validateDocumentString
    за по-подробен анализ на грешката;
  • Използвайте GET /api/v1/transactions/document/{clientId}/start, за да създадете валиден начален документ;
  • уверете се, че clientId също е създаден в системата (PUT /api/v1/management/clients или PUT /api/v1/management/clients/byCloud)
 -

 

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

Подобни статии

Коментари

0 коментара

Влезте в услугата, за да оставите коментар.

Powered by Zendesk