Този ендпойнт представлява първата стъпка в предаването на транзакции от електронната система за регистриране („касов апарат“) към Фискалната служба. Процесът винаги се състои от две стъпки. Този двуетапен процес на предаване на транзакции се основава на изискванията на Наредбата за защита на касовите апарати от манипулации в Германия и трябва да се извършва във всички страни с фискални изисквания в смисъла на стандартизиран интерфейс. В Германия, когато се извика PUT /api/v1/transactions/createDocument, транзакцията се регистрира в т.нар. техническо устройство за сигурност (TSE/TSS).
Регистрация на транзакция
Транзакцията/документът се регистрира във фискалното устройство:
- PUT /api/v1/transactions/createDocument и
- POST /api/v1/transactions/storeDocument
Прекратяване на транзакция
Това регистрира прекратяването на транзакция във фискалната единица:
- PUT /api/v1/transactions/createDocument и
- POST /api/v1/transactions/cancelDocument
Забележка: всички транзакции, започнати с PUT /api/v1/transactions/createDocument, трябва да бъдат приключени или с POST /api/v1/transactions/storeDocument, или с POST /api/v1/transactions/cancelDocument! Моля, обърнете внимание на listTransactions (DELETE).
Резултат
Успешното извикване на крайната точка (200)
- регистрира началото на транзакция във фискалната единица и
- връща fiscalResponse към системата нагоре по веригата (система за електронно записване).
Начин на използване
- всеки път, когато трябва да се изпрати нова транзакция към фискалното устройство, преди POST /api/v1/transactions/storeDocument или POST /api/v1/transactions/cancelDocument.
Предпоставки
- Инициализиран Fiskal Client
Полета във формуляра
Трябва да се изпрати следната информация:
| Наименование | Тип | Описание | Пример |
| clientId | M |
Уникалният идентификатор (uniqueClientId) на касовия апарат (от RetailForce system). | c1062c55-57c4-4ed2-9c53-aff1762326a4 |
| documentType | M |
Типът на документа, който ще бъде регистриран. Enum:
|
- |
| DocumentGuid | R |
GUID/UUID, присвоен на транзакцията от POS системата. Поведение на "DocumentGuid", включен в заявката:
Поведение БЕЗ „DocumentGuid“ в заявката:
Забележка: Същият „DocumentGuid“ трябва да се използва и при последващото извикване на POST /api/v1/transactions/storeDocument. |
b5744d8c-71ec-4ea0-a340-53070da8b5a1 |
Отговор
Възможни отговори:
| Код | Описание | Пример |
| 200 | Транзакцията е стартирана и към системата нагоре по веригата е върнат fiscalResponse | - |
Тази статия е преведена автоматично.
Коментари
0 коментара
Влезте в услугата, за да оставите коментар.