GET /api/v1/management/germany/ {clientId}/TSE/listTransactions – RetailForce

С крайната точка

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

се връщат отворените транзакции в TSE.

Отворени транзакции

Отворените транзакции са тези, които са били създадени/започнати с createDocument (PUT /api/v1/transactions/createDocument), но (все още) не са били затворени с storeDocument (POST /api/v1/transactions/storeDocument) или с cancelDocument (POST /api/v1/transactions/cancelDocument).

Тези транзакции са видими в DSFinV-K export. В случай на проверка на касовия апарат от данъчните органи отворените транзакции могат да доведат до допълнителни въпроси и проверяващият ще изисква обяснение за тях.

Внимание: броят на възможните отворени транзакции е ограничен! Hardware TSE на swissbit позволява 512, а Fiskaly Cloud TSE – 2 000 едновременно отворени транзакции. Ако бъде отворена 513-та или 2 001-ва транзакция, TSE връща грешка! Вижте също: Грешка при свързване с TSE .

Препоръчваме да затваряте отворените транзакции и да моделирате това в процеса на електронната система за регистриране така, че транзакциите да могат да бъдат „паркирани“, но трябва да бъдат затворени най-късно до края на деня.

Отворените транзакции могат да бъдат затворени и чрез

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

Резултати

Списък с отворени транзакции, които (все още) не са приключени

Начин на използване

ако е необходимо (опционална функция на касовия апарат)

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

Endpoint връща резултат само ако съответният client е конфигуриран за използване в рамките на KassenSichV в Германия

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

Трябва да бъде подадена следната информация:

Наименование	Описание	Пример
clientId	Уникален ID на клиента (uniqueClientId)	3fa85f64-5717-4562-b3fc-2c963f66afa6

Отговор

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

Код	Описание	Пример
200	The client returns a list of open transactions in the response. Върнатият номер е fiscalDocumentNumber на отворената транзакция Внимание: TSE ще връщат отворени транзакции само на пакети (SWISSBIT HARDWARE TSE: 8, Cloud TSE: 100 отворени транзакции на заявка)! Т.е. ако броят на отворените транзакции надвиши тази стойност, посочените транзакции трябва първо да бъдат затворени, преди да бъдат показани още.	[ 4, 5, 9, 8, 11, 12, 14, 15, 18, 24, 29, 57, 198, 220, 321, 525, 724 ]
422	В заявката не е посочен clientId. Отстраняване на проблема: Посочете правилния clientId	-
500	Вътрешна грешка – заявката не може да бъде обработена. Отстраняване на проблема: Свържете се с отдела за поддръжка на RetailForce	-

Swissbit Hardware TSE

Общият брой на отворените транзакции в SWISSBIT HARDWARE TSE може да бъде извлечен чрез крайната точка GET /api/v1/management/germany/tse.

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