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

The

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

se lahko uporabi za zaprtje odprtih transakcij TSE.

Praviloma transakcije ne smejo ostati odprte. Priporočamo, da se vse odprte transakcije zaprejo pred dnevnim zaključkom z

POST /api/v1/transactions/storeDocument – če je prišlo do prodaje, ali
POST /api/v1/transactions/cancelDocument – če prodaja ni potekala.

Pozor: upoštevajte, da se preklici dokumentov prav tako beležijo (morajo biti zabeleženi) v TSE. Zato je treba vsako transakcijo, ki se je začela s PUT /api/v1/transactions/createDocument , zaključiti s »storeDocument « ali »cancelDocument «. V primeru pogostih preklicov dokumentov ne moremo izključiti možnosti, da bi davčni organi med inšpekcijskim pregledom blagajne postavili vprašanja o razlogih za preklic.

Rezultat

Odprte transakcije v sistemu TSE se skupaj zaključijo s klicem POST /api/v1/transactions/cancelDocument, brez da bi jih bilo treba zaključevati posamično.

Uporaba

Priporočamo, da to končno točko uporabljate previdno in le v primeru napake.

Klic najprej ustvari poizvedbo do TSE, katere transakcije so odprte. Različni tipi TSE (Cloud TSE, hardware TSE) ne vrnejo popolnega seznama odprtih transakcij, temveč le »paket za paketom«:

SWISSBIT HARDWARE TSE: po 8 transakcij,
fiskal Cloud TSE: po 100 transakcij

Ko TSE vrne paket odprtih transakcij, se vsebovane transakcije zaprejo s praznim dokumentom, ki vsebuje naslednje informacije:

DocumentId: Guid, ki ga generira storitev
DocumentNr: GUID, ki ga generira storitev
DocumentGuid: GUID, ki ga generira storitev
DocumentType: Potrdilo
documentTypeCaption: CancelTransaction

Če je odprtih več transakcij, kot je navedeno zgoraj, je treba končno točko poklicati večkrat.

Vse zaključene transakcije so ustrezno shranjene tudi v podatkih DSFinV-K.

Predpogoji

Na borzi TSE so odprte (začete), tj. nezaprte transakcije.

Če je doseženo določeno število odprtih transakcij, na TSE ni mogoče začeti novih transakcij in TSE poroča o napaki. Več informacij o tem najdete v članku Napaka pri povezavi s TSE.

Število odprtih transakcij lahko pridobite prek končne točke:

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

Primer:

TSE vrne število začetih transakcij v polju »startedTransactions«.

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

Opomba: deluje le za hardware TSE-je. Omejitev hkrati odprtih transakcij za Fiskaly Cloud TSE je 2.000.

Polja obrazca

Posredovati je treba naslednje informacije:

Oznaka	Opis	Primer
clientId	UniqueClientId blagajne (iz RetailForce systema).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Odgovori

Možni odgovori:

Koda	Opis	Primer
200	fiscalResponse – odprte transakcije so bile uspešno zaključene (cancelDocument)	-
400	»Tse ni povezan« – noben TSE ni povezan s sistemom ali dodeljen ustreznemu clientu. Odpravljanje težav: Preverjanje, ali je TSE povezana s sistemom , npr.: z GET /api/v1/management/germany/tse	-
404	»Stranka ni bila najdena« – na tem sistemu pod navedenim clientId ni nobene konfiguracije Odpravljanje težav: Preverjanje navedenega clientId Preverite, ali je navedeni clientId konfiguriran v middleware (v datoteki fiscalService.config.json v mapi C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	»clientId je bil nastavljen na Guid.Empty« Odpravljanje težav:	-
500	»Notranja napaka strežnika« – Druga napaka. Odpravljanje težav: ponovite klic, po potrebi ponovno zaženite storitev, izvedite CloudConnect.	-

Pozor: Ne glede na to, kako je bila napaka odpravljena, priporočamo, da natančno analizirate razlog, zakaj transakcije TSE ostajajo odprte. V rednem postopku zaključevanja je treba vse odprte transakcije zapreti pred dnevnim zaključkom.

Ta članek je bil samodejno preveden.

Rezultat

Uporaba

Predpogoji

Polja obrazca

Odgovori

Sorodni sklopi