ИЗТРИЙ /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 “. В случай на чести анулирания на документи не можем да изключим възможността данъчните органи да зададат въпроси относно причините за анулиранията в хода на проверка на касовия апарат .

Резултат

Отворените транзакции в TSE се затварят колективно с POST /api/v1/transactions/cancelDocument, без да е необходимо да се затварят поотделно.

Употреба

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

При извикването първо се генерира запитване към TSE за това кои транзакции са отворени. Различните типове TSE (Cloud TSE, hardware TSE) не връщат пълен списък с отворените транзакции, а само „пакет по пакет“:

SWISSBIT HARDWARE TSE: по 8 транзакции,
fiskal Cloud TSE: по 100 транзакции

След като TSE е върнала пакета с отворените транзакции, съдържащите се в него транзакции се затварят чрез празен документ със следната информация:

DocumentId: GUID, генериран от услугата
DocumentNr: GUID, генериран от услугата
DocumentGuid: GUID, генериран от услугата
DocumentType: Разписка
documentTypeCaption: CancelTransaction

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

Всички приключени транзакции също се съхраняват съответно в данните по DSFinV-K.

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

На TSE има отворени (започнати), т.е. незатворени транзакции.

Ако се достигне определен брой отворени транзакции, на TSE не могат да се започват повече транзакции и TSE отчита грешка. Можете да намерите повече информация по този въпрос в статията „Грешка при свързване с TSE“.

Можете да извлечете броя на отворените транзакции чрез крайната точка:

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

Пример:

TSE връща броя на започнатите транзакции в полето „startedTransactions“.

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

Забележка: работи само за hardware TSE. Лимитът на едновременно отворените транзакции на Fiskaly Cloud TSE е 2 000.

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

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

Означение	Описание	Пример
clientId	Уникалният идентификатор (uniqueClientId) на касовия апарат (от RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Отговори

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

Код	Описание	Пример
200	fiscalResponse – отворените транзакции са успешно приключени (cancelDocument)	-
400	„TSE не е свързан“ – Няма TSE, свързан със системата или присвоен на съответния client. Отстраняване на проблема: Проверете дали TSE е свързана със системата , например: с GET /api/v1/management/germany/tse	-
404	„Клиентът не беше намерен“ – в тази система няма конфигурация под посочения clientId Отстраняване на проблема: Проверка на посочения clientId Проверете дали посоченият clientId е конфигуриран в middleware-то (във файла fiscalService.config.json в папката C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	„clientId е зададен като Guid.Empty“ Отстраняване на проблеми:	-
500	„Вътрешна грешка на сървъра“ – Друга грешка. Отстраняване на проблема: повторете заявката, рестартирайте услугата, ако е необходимо, изпълнете CloudConnect.	-

Внимание: Независимо от това как е била отстранена грешката, препоръчваме ви внимателно да анализирате причината, поради която транзакциите на TSE остават отворени. При обичайния процес на приключване на деня всички отворени транзакции трябва да бъдат затворени преди дневното приключване.

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

Резултат

Употреба

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

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

Отговори

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