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

Příkaz

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

slouží k uzavření otevřených transakcí TSE.

Obecně platí, že transakce by neměly zůstat otevřené. Doporučujeme uzavřít všechny otevřené transakce před denním uzávěrkou pomocí

POST /api/v1/transactions/storeDocument – pokud došlo k prodeji, nebo
POST /api/v1/transactions/cancelDocument – pokud k prodeji nedošlo.

Upozornění: Vezměte prosím na vědomí, že zrušení dokladů se (musí) zaznamenávat také v TSE. Proto je rovněž nutné každou transakci zahájenou příkazem PUT /api/v1/transactions/createDocument ukončit příkazem „storeDocument “ nebo „cancelDocument “. V případě častých zrušení dokladů nelze vyloučit, že se daňové úřady v rámci kontroly pokladny budou dotazovat na důvody těchto zrušení.

Výsledek

Otevřené transakce v systému TSE se uzavírají hromadně pomocí příkazu POST /api/v1/transactions/cancelDocument, aniž by bylo nutné je uzavírat jednotlivě.

Použití

Doporučujeme používat tento endpoint s opatrností a pouze v případě chyby.

Volání nejprve vygeneruje dotaz na TSE, které transakce jsou otevřené. Různé typy TSE (Cloud TSE, Hardware TSE) nevracejí kompletní seznam otevřených transakcí, ale pouze „balíček po balíčku“:

swissbit Hardware TSE: po 8 transakcích,
fiskal Cloud TSE: vždy 100 transakcí

Poté, co TSE vrátí balíček otevřených transakcí, jsou obsažené transakce uzavřeny pomocí prázdného dokumentu s následujícími informacemi:

DocumentId: GUID vygenerovaný službou
DocumentNr: GUID vygenerovaný službou
DocumentGuid: GUID vygenerovaný službou
DocumentType: Potvrzení
DocumentTypeCaption: Zrušení transakce

Pokud je otevřeno více než výše uvedené transakce, je nutné koncový bod vyvolat vícekrát.

Všechny uzavřené transakce jsou rovněž odpovídajícím způsobem uloženy v datech DSFinV-K.

Předpoklady

Na burze TSE existují otevřené (zahájené), tj. neuzavřené, transakce.

Pokud je dosaženo určitého počtu otevřených transakcí, nelze na TSE zahájit žádné další transakce a TSE nahlásí chybu. Více informací o tomto tématu najdete v článku Chyba připojení k TSE.

Počet otevřených transakcí můžete zjistit pomocí koncového bodu:

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

Příklad:

TSE vrátí počet zahájených transakcí v poli „startedTransactions“.

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

Poznámka: funguje pouze u hardwarových TSE. Limit současně otevřených transakcí u fiskaly Cloud TSE je 2 000.

Pole formuláře

Je nutné předat následující informace:

Označení	Popis	Příklad
clientId	Jedinečné ID pokladny (z systému RetailForce).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Odpovědi

Možné odpovědi:

Kód	Popis	Příklad
200	fiscalResponse – otevřené transakce byly úspěšně uzavřeny (cancelDocument)	-
400	„TSE není připojeno“ – k systému není připojeno žádné TSE ani není přiřazeno příslušnému klientovi. Řešení problémů: Zkontrolujte, zda je TSE připojena k systému , např. pomocí GET /api/v1/management/germany/tse	-
404	„Klient nebyl nalezen“ – v tomto systému neexistuje žádná konfigurace pod zadaným clientId Řešení problémů: Zkontrolujte zadané clientId Zkontrolujte, zda je zadané clientId nakonfigurováno v middlewaru (v souboru fiscalService.config.json v adresáři C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	„clientId bylo nastaveno na Guid.Empty“ Řešení problémů:	-
500	„Interní chyba serveru“ – Jiná chyba. Řešení problémů: opakujte volání, v případě potřeby restartujte službu, spusťte cloudConnect.	-

Upozornění: Bez ohledu na to, jak byla chyba vyřešena, doporučujeme pečlivě analyzovat důvod, proč transakce TSE zůstávají otevřené. V běžném procesu zúčtování by měly být všechny otevřené transakce uzavřeny před denním uzávěrkou.

Tento článek byl přeložen automaticky.

Výsledek

Použití

Předpoklady

Pole formuláře

Odpovědi

Související články