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

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

végpont használható a nyitott TSE-tranzakciók lezárására.

Általános szabály, hogy a tranzakciókat nem szabad nyitott állapotban hagyni. Javasoljuk, hogy a napi zárás előtt minden nyitott tranzakciót zárjanak le a következő parancsokkal:

POST /api/v1/transactions/storeDocument – ha értékesítés történt, vagy
POST /api/v1/transactions/cancelDocument – ha nem történt értékesítés.

Figyelem: kérjük, vegye figyelembe, hogy a dokumentumok törléseit is rögzíteni kell a TSE-ben. Ezért minden , a PUT /api/v1/transactions/createDocument paranccsal indított tranzakciót „storeDocument ” vagy „cancelDocument ” paranccsal is le kell zárni. Gyakori dokumentum-törlések esetén nem zárható ki, hogy az adóhatóság egy pénztárgép-ellenőrzés során kérdéseket tegyen fel a törlések okairól.

Eredmény

A nyitott TSE-tranzakciókat a POST /api/v1/transactions/cancelDocument paranccsal együttesen lehet lezárni, nincs szükség azok egyenkénti lezárására.

Használat

Javasoljuk, hogy ezt a végpontot óvatosan és kizárólag hiba esetén használja.

A hívás először lekérdezi a TSE-t, hogy mely tranzakciók nyitottak. A különböző TSE-típusok (Cloud TSE, hardware TSE) nem adnak vissza teljes listát a nyitott tranzakciókról, hanem csak „csomagonként”:

SWISSBIT HARDWARE TSE: egyenként 8 tranzakció,
fiskal Cloud TSE: egyenként 100 tranzakció

Miután a TSE visszaküldte a nyitott tranzakciók csomagját, a benne lévő tranzakciókat egy üres dokumentummal zárják le, a következő információkkal:

DocumentId: a szolgáltatás által generált Guid
DocumentNr: a szolgáltatás által generált GUID
DocumentGuid: a szolgáltatás által generált GUID
DocumentType: Nyugta
documentTypeCaption: CancelTransaction

Ha a fenti tranzakcióknál több van nyitva, az endpointot többször is meg kell hívni.

Minden lezárt tranzakciót a DSFinV-K adatokban is megfelelően tárolnak.

Előfeltételek

Nyitott (elindított), azaz le nem zárt tranzakciók vannak a TSE-n.

Ha egy bizonyos számú nyitott tranzakciót elérnek, a TSE-n több tranzakciót nem lehet elindítani, és a TSE hibát jelez. Erről további információkat a „TSE-kapcsolati hiba” című cikkben talál.

A nyitott tranzakciók számát a következő végponton keresztül lehet lekérdezni:

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

Példa:

TSE adja vissza a „startedTransactions” mezőben a megkezdett tranzakciók számát.

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

Megjegyzés: csak hardware TSE-k esetén működik. A Fiskaly Cloud TSE egyidejűleg nyitott tranzakcióinak korlátja 2 000.

Űrlapmezők

A következő információkat kell továbbítani:

Megnevezés	Leírás	Példa
clientId	The uniqueClientId of the cash register (from the RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Válaszok

Lehetséges válaszok:

Kód	Leírás	Példa
200	fiscalResponse – a nyitott tranzakciók sikeresen lezárultak (cancelDocument)	-
400	„TSE nincs csatlakoztatva” – Nincs TSE csatlakoztatva a rendszerhez, vagy nincs hozzárendelve a megfelelő clienthez. Hibaelhárítás: Ellenőrizze, hogy a TSE csatlakozik-e a rendszerhez, pl.: a GET /api/v1/management/germany/tse paranccsal	-
404	„Client was not found” – a megadott clientId alatt nincs konfiguráció ezen a rendszeren Hibaelhárítás: A megadott clientId ellenőrzése Ellenőrizze, hogy a megadott clientId be van-e állítva a middleware-ben (a C:\Program Files\RetailForce\Fiscal Webservice\Config mappában található fiscalService.config.json fájlban)	-
422	„A clientId értéke Guid.Empty lett beállítva” Hibaelhárítás:	-
500	„Belső szerverhiba” – Egyéb hiba. Hibaelhárítás: ismételje meg a hívást, szükség esetén indítsa újra a szolgáltatást, futtassa CloudConnect parancsot.	-

Figyelem: Függetlenül attól, hogy a hiba hogyan került megoldásra, javasoljuk, hogy alaposan elemezze, miért maradnak nyitva a TSE-tranzakciók. A szokásos elszámolási folyamat során az összes nyitott tranzakciót le kell zárni a napi zárás előtt.

Ezt a cikket automatikusan lefordították.

Eredmény

Használat

Előfeltételek

Űrlapmezők

Válaszok

Kapcsolódó cikkek