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

The

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

slúži na uzavretie otvorených transakcií TSE.

Všeobecne platí, že transakcie by nemali zostať otvorené. Odporúčame, aby boli všetky otvorené transakcie uzavreté pred denným uzávierkou buď pomocou

POST /api/v1/transactions/storeDocument – ak došlo k predaju, alebo
POST /api/v1/transactions/cancelDocument – ak k predaju nedošlo.

Upozornenie: vezmite prosím na vedomie, že zrušenia dokumentov sa (musia) zaznamenať aj v TSE. Preto je tiež potrebné ukončiť každú transakciu začatú pomocou PUT /api/v1/transactions/createDocument pomocou „storeDocument “ alebo „cancelDocument “. V prípade častých zrušení dokumentov nemožno vylúčiť, že daňové orgány môžu v priebehu kontroly pokladne klásť otázky týkajúce sa dôvodov týchto zrušení.

Výsledok

Otvorené transakcie v systéme TSE sa uzatvárajú hromadne pomocou príkazu POST /api/v1/transactions/cancelDocument, bez nutnosti ich individuálneho uzatvárania.

Použitie

Odporúčame používať tento koncový bod s opatrnosťou a len v prípade chyby.

Volanie najprv vygeneruje dotaz na TSE, ktoré transakcie sú otvorené. Rôzne typy TSE (Cloud TSE, hardware TSE) nevracajú kompletný zoznam otvorených transakcií, ale len „balík po balíku“:

SWISSBIT HARDWARE TSE: po 8 transakcií,
fiskal Cloud TSE: po 100 transakcií

Po tom, čo TSE vráti balík otvorených transakcií, sú obsiahnuté transakcie uzavreté prostredníctvom prázdneho dokumentu s nasledujúcimi informáciami:

DocumentId: GUID vygenerovaný službou
DocumentNr: GUID vygenerovaný službou
DocumentGuid: GUID vygenerovaný službou
DocumentType: Potvrdenie
documentTypeCaption: Zrušenie transakcie

Ak je otvorených viac transakcií, ako je uvedené vyššie, je potrebné volať koncový bod viac ako raz.

Všetky uzavreté transakcie sa tiež zodpovedajúcim spôsobom ukladajú do údajov DSFinV-K.

Predpoklady

Na burze TSE sú otvorené (začaté), t. j. neuzavreté, transakcie.

Ak sa dosiahne určitý počet otvorených transakcií, na TSE sa už nemôžu spúšťať žiadne ďalšie transakcie a TSE nahlási chybu. Viac informácií o tomto nájdete v článku Chyba pripojenia k TSE.

Počet otvorených transakcií môžete získať prostredníctvom koncového bodu:

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

Príklad:

TSE vráti počet začatých transakcií v poli „startedTransactions“.

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

Poznámka: funguje len pre hardware TSE. Limit súčasne otvorených transakcií pre Fiskaly Cloud TSE je 2 000.

Polia formulára

Je potrebné odoslať nasledujúce informácie:

Označenie	Popis	Príklad
clientId	UniqueClientId pokladne (z RetailForce systemu).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Odpovede

Možné odpovede:

Kód	Popis	Príklad
200	fiscalResponse – otvorené transakcie boli úspešne uzavreté (cancelDocument)	-
400	„Tse not connected“ – k systému nie je pripojená žiadna TSE ani nie je priradená k príslušnému klientovi. Riešenie problémov: Skontrolujte, či je TSE pripojená k systému , napr.: pomocou GET /api/v1/management/germany/tse	-
404	„Klient nebol nájdený“ – v tomto systéme neexistuje žiadna konfigurácia pod zadaným clientId Riešenie problému: Skontrolujte zadané clientId Skontrolujte, či je zadané clientId nakonfigurované v middleware (v súbore fiscalService.config.json v adresári C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	„clientId bolo nastavené na Guid.Empty“ Riešenie problémov:	-
500	„Interná chyba servera“ – Iná chyba. Riešenie problémov: opakujte volanie, v prípade potreby reštartujte službu, spustite CloudConnect.	-

Upozornenie: Bez ohľadu na to, ako bola chyba vyriešená, odporúčame dôkladne analyzovať dôvod, prečo transakcie TSE zostávajú otvorené. V bežnom procese uzávierky by mali byť všetky otvorené transakcie uzavreté pred dennou uzávierkou.

Tento článok bol preložený automaticky.

Výsledok

Použitie

Predpoklady

Polia formulára

Odpovede

Podobné články