БРИШИ /api/v1/management/germany/ {clientId}/tse/listTransactions – RetailForce

The

DELETE /api/v1/management/germany/{clientId}/tse/listTransactions

ендпоинт се може користити за затварање отворених TSE трансакција.

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

POST /api/v1/transactions/storeDocument - ако је продаја обављена, или
POST /api/v1/transactions/cancelDocument - ако продаја није обављена.

Пажња: имајте у виду да се поништавање докумената такође (мора) евидентира у TSE. Стога је такође неопходно завршити сваку трансакцију започету помоћу PUT /api/v1/transactions/createDocument са "storeDocument " или "cancelDocument ". У случају честих поништавања докумената, не можемо искључити могућност да пореске власти могу поставити питања о разлозима поништавања током инспекције касе .

Резултат

Отворене ТСЕ трансакције се колективно затварају помоћу POST /api/v1/transactions/cancelDocument, без потребе за појединачним затварањем.

Употреба

Препоручујемо да овај ендпоинт користите опрезно и само у случају грешке.

Позив прво генерише упит ка TSE-у о томе које су трансакције отворене. Различите врсте TSE-а (Cloud TSE, Hardware TSE) не враћају потпуну листу отворених трансакција, већ само "пакет по пакет":

swissbit хардверски TSE: по 8 трансакција,
fiskal Cloud TSE: по 100 трансакција

Након што TSE врати пакет отворених трансакција, садржане трансакције се затварају путем празног документа, са следећим информацијама:

ID документа: Guid генерисан од стране сервиса
DocumentNr: Guid генерисан од стране сервиса
DocumentGuid: Guid генерисан од стране сервиса
Тип документа: Потврда
Наслов типа документа: ПоништиТрансакцију

Ако је више од горе наведених трансакција отворено, крајња тачка мора бити позвана више пута.

Све затворене трансакције се такође одговарајуће чувају у DSFinV-K подацима.

Предуслови

На TSE постоје отворене (покренуте), односно не затворене трансакције.

Ако се достигне одређен број отворених трансакција, више се не могу покренути трансакције на TSE и TSE пријављује грешку. Више информација о томе можете пронаћи у чланку Tse connection error.

Можете добити број отворених трансакција преко ендпоинта:

GET /api/v1/management/germany/{clientId}/tse/listTransactions

Пример:

TSE враћа број покренутих трансакција у пољу "startedTransactions".

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}

Напомена: ради само за хардверске TSE уређаје. Ограничење истовремено отворених трансакција за fiskaly Cloud TSE је 2.000.

Поља обрасца

Следеће информације морају бити пренете:

Назив	Опис	Пример
clientId	uniqueClientId касе (из система RetailForce).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Одговори

Могући одговори:

Код	Опис	Пример
200	fiscalResponse - отворене трансакције су успешно затворене (откажиДокумент)	-
400	"Tse није повезан" - Ниједан TSE није повезан са системом или додељен одговарајућем клијенту. Отклањање проблема: Провера да ли је TSE повезан са системом , нпр.: помоћу GET /api/v1/management/germany/tse	-
404	"Клијент није пронађен" - на овом систему не постоји конфигурација за наведени clientId Отклањање проблема: Провера наведеног clientId Проверите да ли је наведени clientId конфигурисан у мидлверу (у фајлу fiscalService.config.json у C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	"clientId је подешен на Guid.Empty" Отклањање проблема:	-
500	"Унутрашња грешка сервера" - Друга грешка. Отклањање неисправности: поновите позив, поново покрените услугу ако је потребно, извршите cloudConnect.	-

Пажња: Без обзира на то како је грешка решена, препоручујемо да пажљиво анализирате разлог зашто TSE трансакције остају отворене. У редовном процесу наплате све отворене трансакције треба затворити пре дневног затварања.

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

Резултат

Употреба

Предуслови

Поља обрасца

Одговори

Povezani članci