OBRIŠI /api/v1/management/germany/ {clientId}/tse/listTransactions – RetailForce

The

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

krajnja točka može se koristiti za zatvaranje otvorenih TSE transakcija.

Kao opće pravilo, transakcije ne bi trebale ostajati otvorene. Preporučujemo da se sve otvorene transakcije zatvore prije dnevnog zatvaranja pomoću

POST /api/v1/transactions/storeDocument - ako je prodaja obavljena, ili
POST /api/v1/transactions/cancelDocument - ako prodaja nije obavljena.

Napomena: imajte na umu da se poništavanje dokumenata također (mora) evidentirati u TSE-u. Stoga je također potrebno završiti svaku transakciju započetu metodom PUT /api/v1/transactions/createDocument pomoću "storeDocument " ili "cancelDocument ". U slučaju čestih otkazivanja dokumenata, ne možemo isključiti mogućnost da porezne vlasti postave pitanja o razlozima otkazivanja tijekom inspekcije blagajne .

Rezultat

Otvorene TSE transakcije zatvaraju se zajedno putem POST /api/v1/transactions/cancelDocument, bez potrebe za njihovim pojedinačnim zatvaranjem.

Upotreba

Preporučujemo oprezno korištenje ove krajnje točke i to samo u slučaju pogreške.

Poziv prvo generira upit TSE-u o tome koje su transakcije otvorene. Različite vrste TSE-a (Cloud TSE, Hardware TSE) ne vraćaju potpuni popis otvorenih transakcija, već samo "paket po paket":

swissbit Hardware TSE: po 8 transakcija,
fiskal Cloud TSE: 100 transakcija svaki

Nakon što TSE vrati paket otvorenih transakcija, sadržane transakcije zatvaraju se putem praznog dokumenta, sa sljedećim informacijama:

ID dokumenta: Guid generiran od strane usluge
DocumentNr: Guid generiran od strane usluge
DocumentGuid: Guid generiran od strane usluge
Tip dokumenta: Potvrda
Opis vrste dokumenta: Otkaži transakciju

Ako je otvoreno više od navedenih transakcija, krajnja točka mora biti pozvana više puta.

Sve zatvorene transakcije također se odgovarajuće pohranjuju u podatke DSFinV-K.

Preduvjeti

Na TSE-u postoje otvorene (pokrenute), tj. nezatvorene transakcije.

Ako se dosegne određeni broj otvorenih transakcija, na TSE-u se više ne mogu pokretati nove transakcije i TSE prijavljuje pogrešku. Više informacija o tome možete pronaći u članku Tse connection error.

Možete dohvatiti broj otvorenih transakcija putem krajnje točke:

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

Primjer:

TSE vraća broj započetih transakcija u polju "startedTransactions".

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

Napomena: radi samo za hardverske TSE-ove. Ograničenje istovremeno otvorenih transakcija za fiskaly Cloud TSE je 2.000.

Polja obrasca

Sljedeće informacije moraju biti prenesene:

Naznaka	Opis	Primjer
clientId	uniqueClientId blagajne (iz sustava RetailForce).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Odgovori

Mogući odgovori:

Kôd	Opis	Primjer
200	fiscalResponse - otvorene transakcije su uspješno zatvorene (otkažiDokument)	-
400	"Tse nije povezan" - Nijedan TSE nije povezan sa sustavom ili dodijeljen odgovarajućem klijentu. Rješavanje problema: Provjera je li TSE povezan sa sustavom npr.: GET /api/v1/management/germany/tse	-
404	"Klijent nije pronađen" - na ovom sustavu ne postoji konfiguracija za navedeni clientId Rješavanje problema: Provjera navedenog clientId-a Provjerite je li navedeni clientId konfiguriran u middlewareu (u datoteci fiscalService.config.json u C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	"clientId je postavljen na Guid.Empty" Rješavanje problema:	-
500	"Interna greška poslužitelja" - Druga greška. Rješavanje problema: ponovite poziv, ponovno pokrenite uslugu ako je potrebno, izvršite cloudConnect.	-

Pažnja: Bez obzira na način rješavanja pogreške, preporučujemo da pažljivo analizirate razlog zašto TSE transakcije ostaju otvorene. U uobičajenom procesu naplate sve otvorene transakcije trebaju biti zatvorene prije dnevnog zatvaranja.

Ovaj je članak automatski preveden.

Rezultat

Upotreba

Preduvjeti

Polja obrasca

Odgovori

Povezani članci